docs: add sub-readmes

2025-06-30 12:49:00 -05:00 · 2025-06-30 12:49:00 -05:00 · c52accbc30
commit c52accbc30
--- a/packages/api-client/readme.md
+++ b/packages/api-client/readme.md
@ -0,0 +1,45 @@
+<p align="center">
+  <a href="https://agentic.so/publishing">
+    <img alt="Agentic" src="/apps/web/public/agentic-publishing-social-image-dark-github.jpg" width="640">
+  </a>
+</p>
+
+<p>
+  <a href="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml"><img alt="Build Status" src="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml/badge.svg" /></a>
+  <a href="https://www.npmjs.com/package/@agentic/platform-api-client"><img alt="NPM" src="https://img.shields.io/npm/v/@agentic/platform-api-client.svg" /></a>
+  <a href="https://prettier.io"><img alt="Prettier Code Formatting" src="https://img.shields.io/badge/code_style-prettier-brightgreen.svg" /></a>
+</p>
+
+# @agentic/platform-api-client <!-- omit from toc -->
+
+> TypeScript API client for the Agentic platform.
+
+- [Website](https://agentic.so/publishing)
+- [Docs](https://docs.agentic.so)
+
+> [!TIP]
+> You likely don't need this package directly. See [@agentic/cli](https://github.com/transitive-bullshit/agentic/tree/main/packages/cli), [@agentic/platform](https://github.com/transitive-bullshit/agentic/tree/main/packages/platform), and [@agentic/platform-tool-client](https://github.com/transitive-bullshit/agentic/tree/main/packages/platform-tool-client) for more public-facing packages.
+
+## Install
+
+```bash
+npm i @agentic/platform-api-client
+```
+
+## Usage
+
+```ts
+import { AgenticApiClient } from '@agentic/platform-api-client'
+
+// Takes an optional `apiKey`
+const agenticApiClient = new AgenticApiClient()
+
+const searchProject = await agenticApiClient.getPublicProjectByIdentifier({
+  projectIdentifier: '@agentic/search'
+})
+console.log(searchProject)
+```
+
+## License
+
+[GNU AGPL 3.0](https://choosealicense.com/licenses/agpl-3.0/)
--- a/packages/cli/readme.md
+++ b/packages/cli/readme.md
@ -0,0 +1,54 @@
+<p align="center">
+  <a href="https://agentic.so/publishing">
+    <img alt="Agentic" src="/apps/web/public/agentic-publishing-social-image-dark-github.jpg" width="640">
+  </a>
+</p>
+
+<p>
+  <a href="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml"><img alt="Build Status" src="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml/badge.svg" /></a>
+  <a href="https://www.npmjs.com/package/@agentic/cli"><img alt="NPM" src="https://img.shields.io/npm/v/@agentic/cli.svg" /></a>
+  <a href="https://prettier.io"><img alt="Prettier Code Formatting" src="https://img.shields.io/badge/code_style-prettier-brightgreen.svg" /></a>
+</p>
+
+# @agentic/cli <!-- omit from toc -->
+
+> CLI for the Agentic platform.
+
+- [Website](https://agentic.so/publishing)
+- [Docs](https://docs.agentic.so/publishing)
+
+## Install
+
+```bash
+npm i -g @agentic/cli
+```
+
+## Usage
+
+```sh
+Usage: agentic [options] [command]
+
+Options:
+  -j, --json                                Print output as JSON
+  -V, --version                             output the version number
+  -h, --help                                display help for command
+
+Commands:
+  login|signin [options]                    Signs in to Agentic. If no credentials are provided, uses GitHub auth.
+  signup [options]                          Creates a new account for Agentic. If no credentials are provided, uses
+                                            GitHub auth.
+  whoami                                    Displays info about the current user.
+  logout|signout                            Signs the current user out.
+  deploy [options]                          Creates a new deployment.
+  publish [options] [deploymentIdentifier]  Publishes a deployment. Defaults to the most recent deployment for the
+                                            project in the target directory. If a deployment identifier is provided, it
+                                            will be used instead.
+  get <deploymentIdentifier>                Gets details for a specific deployment.
+  list|ls [options] [identifier]            Lists deployments.
+  debug [options]                           Prints config for a local project.
+  help [command]                            display help for command
+```
+
+## License
+
+[GNU AGPL 3.0](https://choosealicense.com/licenses/agpl-3.0/)
--- a/packages/emails/readme.md
+++ b/packages/emails/readme.md
@ -0,0 +1,24 @@
+<p align="center">
+  <a href="https://agentic.so/publishing">
+    <img alt="Agentic" src="/apps/web/public/agentic-publishing-social-image-dark-github.jpg" width="640">
+  </a>
+</p>
+
+<p>
+  <a href="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml"><img alt="Build Status" src="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml/badge.svg" /></a>
+  <a href="https://prettier.io"><img alt="Prettier Code Formatting" src="https://img.shields.io/badge/code_style-prettier-brightgreen.svg" /></a>
+</p>
+
+# @agentic/platform-emails <!-- omit from toc -->
+
+> Internal email templates for the Agentic platform.
+
+- [Website](https://agentic.so/publishing)
+- [Docs](https://docs.agentic.so)
+
+> [!TIP]
+> You likely don't need this **private** package unless you are contributing to Agentic directly.
+
+## License
+
+[GNU AGPL 3.0](https://choosealicense.com/licenses/agpl-3.0/)
--- a/packages/hono/readme.md
+++ b/packages/hono/readme.md
@ -0,0 +1,24 @@
+<p align="center">
+  <a href="https://agentic.so/publishing">
+    <img alt="Agentic" src="/apps/web/public/agentic-publishing-social-image-dark-github.jpg" width="640">
+  </a>
+</p>
+
+<p>
+  <a href="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml"><img alt="Build Status" src="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml/badge.svg" /></a>
+  <a href="https://prettier.io"><img alt="Prettier Code Formatting" src="https://img.shields.io/badge/code_style-prettier-brightgreen.svg" /></a>
+</p>
+
+# @agentic/platform-hono <!-- omit from toc -->
+
+> Internal Hono utilities for the Agentic platform.
+
+- [Website](https://agentic.so/publishing)
+- [Docs](https://docs.agentic.so)
+
+> [!TIP]
+> You likely don't need this **private** package unless you are contributing to Agentic directly.
+
+## License
+
+[GNU AGPL 3.0](https://choosealicense.com/licenses/agpl-3.0/)
--- a/packages/json-schema/readme.md
+++ b/packages/json-schema/readme.md
@ -1,5 +1,17 @@
+<p align="center">
+  <a href="https://agentic.so/publishing">
+    <img alt="Agentic" src="/apps/web/public/agentic-publishing-social-image-dark-github.jpg" width="640">
+  </a>
+</p>
+
+<p>
+  <a href="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml"><img alt="Build Status" src="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml/badge.svg" /></a>
+  <a href="https://www.npmjs.com/package/@agentic/json-schema"><img alt="NPM" src="https://img.shields.io/npm/v/@agentic/platform-api-client.svg" /></a>
+  <a href="https://prettier.io"><img alt="Prettier Code Formatting" src="https://img.shields.io/badge/code_style-prettier-brightgreen.svg" /></a>
+</p>
+
 > [!NOTE]
-> This package is a fork of [@cfworker/json-schema](https://github.com/cfworker/cfworker) which adds [ajv-style coercion](https://ajv.js.org/coercion.html). Coercion can be enabled with a boolean flag.
+> This package is a fork of [@cfworker/json-schema](https://github.com/cfworker/cfworker) which adds support for [ajv-style type coercion](https://ajv.js.org/coercion.html). Coercion is disabled by default, but can be enabled with a boolean flag.

 # @agentic/json-schema

--- a/packages/openapi-utils/readme.md
+++ b/packages/openapi-utils/readme.md
@ -0,0 +1,31 @@
+<p align="center">
+  <a href="https://agentic.so/publishing">
+    <img alt="Agentic" src="/apps/web/public/agentic-publishing-social-image-dark-github.jpg" width="640">
+  </a>
+</p>
+
+<p>
+  <a href="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml"><img alt="Build Status" src="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml/badge.svg" /></a>
+  <a href="https://www.npmjs.com/package/@agentic/platform-openapi-utils"><img alt="NPM" src="https://img.shields.io/npm/v/@agentic/platform-openapi-utils.svg" /></a>
+  <a href="https://prettier.io"><img alt="Prettier Code Formatting" src="https://img.shields.io/badge/code_style-prettier-brightgreen.svg" /></a>
+</p>
+
+# @agentic/platform-openapi-utils <!-- omit from toc -->
+
+> OpenAPI utilities used by the Agentic platform.
+
+- [Website](https://agentic.so/publishing)
+- [Docs](https://docs.agentic.so)
+
+> [!TIP]
+> You likely don't need this package directly. See [@agentic/cli](https://github.com/transitive-bullshit/agentic/tree/main/packages/cli), [@agentic/platform](https://github.com/transitive-bullshit/agentic/tree/main/packages/platform), and [@agentic/platform-tool-client](https://github.com/transitive-bullshit/agentic/tree/main/packages/platform-tool-client) for more public-facing packages.
+
+## Install
+
+```bash
+npm i @agentic/platform-openapi-utils
+```
+
+## License
+
+[GNU AGPL 3.0](https://choosealicense.com/licenses/agpl-3.0/)
--- a/packages/platform-core/package.json
+++ b/packages/platform-core/package.json
@ -1,7 +1,7 @@
 {
  "name": "@agentic/platform-core",
  "version": "8.1.1",
-  "description": "Core utilities for the Agentic platform.",
+  "description": "Core utilities shared across the Agentic platform.",
  "author": "Travis Fischer <travis@transitivebullsh.it>",
  "license": "AGPL-3.0",
  "repository": {
--- a/packages/platform-core/readme.md
+++ b/packages/platform-core/readme.md
@ -0,0 +1,49 @@
+<p align="center">
+  <a href="https://agentic.so/publishing">
+    <img alt="Agentic" src="/apps/web/public/agentic-publishing-social-image-dark-github.jpg" width="640">
+  </a>
+</p>
+
+<p>
+  <a href="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml"><img alt="Build Status" src="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml/badge.svg" /></a>
+  <a href="https://www.npmjs.com/package/@agentic/platform-core"><img alt="NPM" src="https://img.shields.io/npm/v/@agentic/platform-core.svg" /></a>
+  <a href="https://prettier.io"><img alt="Prettier Code Formatting" src="https://img.shields.io/badge/code_style-prettier-brightgreen.svg" /></a>
+</p>
+
+# @agentic/platform-core <!-- omit from toc -->
+
+> Core utilities shared across the Agentic platform.
+
+- [Website](https://agentic.so/publishing)
+- [Docs](https://docs.agentic.so)
+
+> [!TIP]
+> You likely don't need this package directly. See [@agentic/cli](https://github.com/transitive-bullshit/agentic/tree/main/packages/cli), [@agentic/platform](https://github.com/transitive-bullshit/agentic/tree/main/packages/platform), and [@agentic/platform-tool-client](https://github.com/transitive-bullshit/agentic/tree/main/packages/platform-tool-client) for more public-facing packages.
+
+## Install
+
+```bash
+npm i @agentic/platform-core
+```
+
+## Usage
+
+```ts
+import {
+  assert,
+  omit,
+  pick,
+  parseJson,
+  parseZodSchema,
+  sha256,
+  getEnv,
+  sanitizeSearchParams,
+  pruneUndefined,
+  slugify
+  // etc...
+} from '@agentic/platform-core'
+```
+
+## License
+
+[GNU AGPL 3.0](https://choosealicense.com/licenses/agpl-3.0/)
--- a/packages/tool-client/package.json
+++ b/packages/tool-client/package.json
@ -1,7 +1,7 @@
 {
  "name": "@agentic/platform-tool-client",
  "version": "8.1.1",
-  "description": "Client for working with LLM tools hosted on the Agentic platform.",
+  "description": "Main client for working with LLM tools hosted on the Agentic platform.",
  "author": "Travis Fischer <travis@transitivebullsh.it>",
  "license": "AGPL-3.0",
  "repository": {
--- a/packages/tool-client/readme.md
+++ b/packages/tool-client/readme.md
@ -1,23 +1,75 @@
-## Project Identifier
+<p align="center">
+  <a href="https://agentic.so/publishing">
+    <img alt="Agentic" src="/apps/web/public/agentic-publishing-social-image-dark-github.jpg" width="640">
+  </a>
+</p>

-`@namespace/project-slug`
+<p>
+  <a href="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml"><img alt="Build Status" src="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml/badge.svg" /></a>
+  <a href="https://www.npmjs.com/package/@agentic/platform-tool-client"><img alt="NPM" src="https://img.shields.io/npm/v/@agentic/platform-tool-client.svg" /></a>
+  <a href="https://prettier.io"><img alt="Prettier Code Formatting" src="https://img.shields.io/badge/code_style-prettier-brightgreen.svg" /></a>
+</p>

-## Deployment Identifier
+# @agentic/platform-tool-client <!-- omit from toc -->

-`${projectIdentifier}` => `${projectIdentifier}@latest`
-`${projectIdentifier}@latest`
-`${projectIdentifier}@dev`
-`${projectIdentifier}@deploymentHash`
-`${projectIdentifier}@version`
+> Main client for working with LLM tools hosted on the Agentic platform.

-## Tool Identifier
+The purpose of this package is to connect TypeScript LLM SDKs to Agentic's hosted tools via the `AgenticToolClient.fromIdentifier(...)` method.

-`${deploymentIdentifier}/tool_name`
+- [Website](https://agentic.so/publishing)
+- [Docs](https://docs.agentic.so)

-## Tool Names
+## Install

- Must start with a letter or underscore
- Can include only letters, numbers, and underscores
- Use either camelCase or snake_case consistently across all tools
+```bash
+npm i @agentic/platform-tool-client
+```

-[OpenAI vs Anthropic vs Google vs MCP tool name restrictions](https://chatgpt.com/share/68419382-73a0-8007-afce-0ded7d9f05e7)
+## Usage
+
+This example uses the [Vercel AI SDK](https://ai-sdk.dev) and the [`@agentic/search`](https://agentic.so/marketplace/projects/@agentic/search) tool.
+
+```ts
+import 'dotenv/config'
+
+import { createAISDKTools } from '@agentic/ai-sdk'
+import { AgenticToolClient } from '@agentic/platform-tool-client'
+import { createOpenAI } from '@ai-sdk/openai'
+import { generateText } from 'ai'
+
+async function main() {
+  const searchTool = await AgenticToolClient.fromIdentifier('@agentic/search')
+  const openai = createOpenAI({ compatibility: 'strict' })
+
+  const result = await generateText({
+    model: openai('gpt-4o-mini'),
+    tools: createAISDKTools(searchTool),
+    toolChoice: 'required',
+    temperature: 0,
+    system: 'You are a helpful assistant. Be as concise as possible.',
+    prompt: 'What is the weather in San Francisco?'
+  })
+
+  console.log(JSON.stringify(result.toolResults[0], null, 2))
+}
+
+await main()
+```
+
+If you have a subscription to the Agentic project, you can specify your API key either by using the `AGENTIC_API_KEY` environment variable, or by passing it explicitly:
+
+```ts
+const searchTool = await AgenticToolClient.fromIdentifier('@agentic/search', {
+  apiKey: process.env.AGENTIC_API_KEY
+})
+```
+
+Now all tool calls will be associated with your subscription for usage-tracking and billing purposes.
+
+## Docs
+
+See the [Agentic Quick Start](https://docs.agentic.so/marketplace) for more details on how to use Agentic tools with other TS LLM SDKs, MCP clients, and simple HTTP usage.
+
+## License
+
+[GNU AGPL 3.0](https://choosealicense.com/licenses/agpl-3.0/)
--- a/packages/types/readme.md
+++ b/packages/types/readme.md
@ -0,0 +1,52 @@
+<p align="center">
+  <a href="https://agentic.so/publishing">
+    <img alt="Agentic" src="/apps/web/public/agentic-publishing-social-image-dark-github.jpg" width="640">
+  </a>
+</p>
+
+<p>
+  <a href="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml"><img alt="Build Status" src="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml/badge.svg" /></a>
+  <a href="https://www.npmjs.com/package/@agentic/platform-types"><img alt="NPM" src="https://img.shields.io/npm/v/@agentic/platform-types.svg" /></a>
+  <a href="https://prettier.io"><img alt="Prettier Code Formatting" src="https://img.shields.io/badge/code_style-prettier-brightgreen.svg" /></a>
+</p>
+
+# @agentic/platform-types <!-- omit from toc -->
+
+> Core schemas and types shared across the Agentic platform.
+
+- [Website](https://agentic.so/publishing)
+- [Docs](https://docs.agentic.so)
+
+> [!TIP]
+> You likely don't need this package directly. See [@agentic/cli](https://github.com/transitive-bullshit/agentic/tree/main/packages/cli), [@agentic/platform](https://github.com/transitive-bullshit/agentic/tree/main/packages/platform), and [@agentic/platform-tool-client](https://github.com/transitive-bullshit/agentic/tree/main/packages/platform-tool-client) for more public-facing packages.
+
+## Install
+
+```bash
+npm i @agentic/platform-types
+```
+
+## Usage
+
+```ts
+import {
+  agenticProjectConfigSchema,
+  type AgenticProjectConfigInput,
+  resolvedAgenticProjectConfigSchema,
+  type ResolvedAgenticProjectConfig,
+  type User,
+  type Project,
+  type Deployment,
+  type Consumer,
+  type AdminMcpRequestMetadata
+  // etc...
+} from '@agentic/platform-types'
+```
+
+## Notes
+
+Some types are raw TS, some are derived from zod schemas, and most of the core database models are inferred from a generated OpenAPI spec exposed by Agentic's backend API.
+
+## License
+
+[GNU AGPL 3.0](https://choosealicense.com/licenses/agpl-3.0/)
--- a/packages/validators/readme.md
+++ b/packages/validators/readme.md
@ -1,23 +1,82 @@
-## Project Identifier
+<p align="center">
+  <a href="https://agentic.so/publishing">
+    <img alt="Agentic" src="/apps/web/public/agentic-publishing-social-image-dark-github.jpg" width="640">
+  </a>
+</p>

-`@namespace/project-slug`
+<p>
+  <a href="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml"><img alt="Build Status" src="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml/badge.svg" /></a>
+  <a href="https://www.npmjs.com/package/@agentic/platform-validators"><img alt="NPM" src="https://img.shields.io/npm/v/@agentic/platform-validators.svg" /></a>
+  <a href="https://prettier.io"><img alt="Prettier Code Formatting" src="https://img.shields.io/badge/code_style-prettier-brightgreen.svg" /></a>
+</p>

-## Deployment Identifier
+# @agentic/platform-validators <!-- omit from toc -->

-`${projectIdentifier}` => `${projectIdentifier}@latest`
-`${projectIdentifier}@latest`
-`${projectIdentifier}@dev`
-`${projectIdentifier}@deploymentHash`
-`${projectIdentifier}@version`
+> Core schemas and validators shared across the Agentic platform.

-## Tool Identifier
+- [Website](https://agentic.so/publishing)
+- [Docs](https://docs.agentic.so)

-`${deploymentIdentifier}/tool_name`
+> [!TIP]
+> You likely don't need this package directly. See [@agentic/cli](https://github.com/transitive-bullshit/agentic/tree/main/packages/cli), [@agentic/platform](https://github.com/transitive-bullshit/agentic/tree/main/packages/platform), and [@agentic/platform-tool-client](https://github.com/transitive-bullshit/agentic/tree/main/packages/platform-tool-client) for more public-facing packages.

-## Tool Names
+## Install
+
+```bash
+npm i @agentic/platform-validators
+```
+
+## Usage
+
+```ts
+import { parseProjectIdentifier } from '@agentic/platform-validators'
+
+const parsedProjectIdentifier = parseProjectIdentifier('@agentic/search')
+```
+
+## Identifiers
+
+### Project Identifier
+
+- `@username/project-slug`
+- `@team-slug/project-slug`
+
+**Examples:**
+
+- `@agentic/search`
+
+### Deployment Identifier
+
+- `${projectIdentifier}` will implicitly use `${projectIdentifier}@latest`
+- `${projectIdentifier}@latest` (the most recently published deployment)
+- `${projectIdentifier}@dev` (the most recently pushed deployment)
+- `${projectIdentifier}@deploymentHash` (a specific deployment)
+- `${projectIdentifier}@version` (a specific published deployment specified via `semver`)
+
+**Examples:**
+
+- `@agentic/search`
+- `@agentic/search@latest`
+- `@agentic/search@1.0.0`
+
+### Tool Identifier
+
+- `${deploymentIdentifier}/tool_name`
+
+**Examples:**
+
+- `@agentic/search/search`
+- `@agentic/search@latest/search`
+- `@agentic/search@1.0.0/search`
+
+### Tool Names

 - Must start with a letter or underscore
 - Can include only letters, numbers, and underscores
 - Use either camelCase or snake_case consistently across all tools

 [OpenAI vs Anthropic vs Google vs MCP tool name restrictions](https://chatgpt.com/share/68419382-73a0-8007-afce-0ded7d9f05e7)
+
+## License
+
+[GNU AGPL 3.0](https://choosealicense.com/licenses/agpl-3.0/)
--- a/stdlib/ai-sdk/readme.md
+++ b/stdlib/ai-sdk/readme.md
@ -0,0 +1,32 @@
+<p align="center">
+  <a href="https://agentic.so">
+    <img alt="Agentic" src="/apps/web/public/agentic-social-image-light.jpg" width="640">
+  </a>
+</p>
+
+<p>
+  <a href="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml"><img alt="Build Status" src="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml/badge.svg" /></a>
+  <a href="https://www.npmjs.com/package/@agentic/ai-sdk"><img alt="NPM" src="https://img.shields.io/npm/v/@agentic/ai-sdk.svg" /></a>
+  <a href="https://prettier.io"><img alt="Prettier Code Formatting" src="https://img.shields.io/badge/code_style-prettier-brightgreen.svg" /></a>
+</p>
+
+# @agentic/ai-sdk <!-- omit from toc -->
+
+> Agentic adapter for the Vercel AI SDK.
+
+- [Website](https://agentic.so)
+- [Docs](https://docs.agentic.so/marketplace/ts-sdks/ai-sdk)
+
+## Install
+
+```bash
+npm i @agentic/ai-sdk zod ai
+```
+
+## Usage
+
+See https://docs.agentic.so/marketplace/ts-sdks/ai-sdk
+
+## License
+
+[GNU AGPL 3.0](https://choosealicense.com/licenses/agpl-3.0/)
--- a/stdlib/core/openai-zod-to-json-schema
+++ b/stdlib/core/openai-zod-to-json-schema
@ -1,2 +0,0 @@
-../..                                    |  WARN  `node_modules` is present. Lockfile only installation will make it out-of-date
-../..                                    | Progress: resolved 1, reused 0, downloaded 0, added 0
--- a/stdlib/core/readme.md
+++ b/stdlib/core/readme.md
@ -0,0 +1,28 @@
+<p align="center">
+  <a href="https://agentic.so">
+    <img alt="Agentic" src="/apps/web/public/agentic-social-image-light.jpg" width="640">
+  </a>
+</p>
+
+<p>
+  <a href="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml"><img alt="Build Status" src="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml/badge.svg" /></a>
+  <a href="https://www.npmjs.com/package/@agentic/core"><img alt="NPM" src="https://img.shields.io/npm/v/@agentic/core.svg" /></a>
+  <a href="https://prettier.io"><img alt="Prettier Code Formatting" src="https://img.shields.io/badge/code_style-prettier-brightgreen.svg" /></a>
+</p>
+
+# @agentic/core <!-- omit from toc -->
+
+> Agentic AI utils which work with any LLM and TypeScript AI SDK.
+
+- [Website](https://agentic.so)
+- [Docs](https://docs.agentic.so)
+
+## Install
+
+```bash
+npm i @agentic/core zod
+```
+
+## License
+
+[GNU AGPL 3.0](https://choosealicense.com/licenses/agpl-3.0/)
--- a/stdlib/genkit/readme.md
+++ b/stdlib/genkit/readme.md
@ -0,0 +1,32 @@
+<p align="center">
+  <a href="https://agentic.so">
+    <img alt="Agentic" src="/apps/web/public/agentic-social-image-light.jpg" width="640">
+  </a>
+</p>
+
+<p>
+  <a href="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml"><img alt="Build Status" src="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml/badge.svg" /></a>
+  <a href="https://www.npmjs.com/package/@agentic/genkit"><img alt="NPM" src="https://img.shields.io/npm/v/@agentic/genkit.svg" /></a>
+  <a href="https://prettier.io"><img alt="Prettier Code Formatting" src="https://img.shields.io/badge/code_style-prettier-brightgreen.svg" /></a>
+</p>
+
+# @agentic/genkit <!-- omit from toc -->
+
+> Agentic adapter for the Firebase Genkit AI SDK.
+
+- [Website](https://agentic.so)
+- [Docs](https://docs.agentic.so/marketplace/ts-sdks/genkit)
+
+## Install
+
+```bash
+npm i @agentic/genkit zod
+```
+
+## Usage
+
+See https://docs.agentic.so/marketplace/ts-sdks/genkit
+
+## License
+
+[GNU AGPL 3.0](https://choosealicense.com/licenses/agpl-3.0/)
--- a/stdlib/langchain/package.json
+++ b/stdlib/langchain/package.json
@ -1,7 +1,7 @@
 {
  "name": "@agentic/langchain",
  "version": "8.1.1",
-  "description": "Agentic adapter for the LangChain AI SDK.",
+  "description": "Agentic adapter for the LangChain TS SDK.",
  "author": "Travis Fischer <travis@transitivebullsh.it>",
  "license": "MIT",
  "repository": {
--- a/stdlib/langchain/readme.md
+++ b/stdlib/langchain/readme.md
@ -0,0 +1,32 @@
+<p align="center">
+  <a href="https://agentic.so">
+    <img alt="Agentic" src="/apps/web/public/agentic-social-image-light.jpg" width="640">
+  </a>
+</p>
+
+<p>
+  <a href="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml"><img alt="Build Status" src="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml/badge.svg" /></a>
+  <a href="https://www.npmjs.com/package/@agentic/langchain"><img alt="NPM" src="https://img.shields.io/npm/v/@agentic/langchain.svg" /></a>
+  <a href="https://prettier.io"><img alt="Prettier Code Formatting" src="https://img.shields.io/badge/code_style-prettier-brightgreen.svg" /></a>
+</p>
+
+# @agentic/langchain <!-- omit from toc -->
+
+> Agentic adapter for the LangChain TS SDK.
+
+- [Website](https://agentic.so)
+- [Docs](https://docs.agentic.so/marketplace/ts-sdks/llamaindex)
+
+## Install
+
+```bash
+npm i @agentic/langchain zod @langchain/core
+```
+
+## Usage
+
+See https://docs.agentic.so/marketplace/ts-sdks/llamaindex
+
+## License
+
+[GNU AGPL 3.0](https://choosealicense.com/licenses/agpl-3.0/)
--- a/stdlib/llamaindex/readme.md
+++ b/stdlib/llamaindex/readme.md
@ -0,0 +1,32 @@
+<p align="center">
+  <a href="https://agentic.so">
+    <img alt="Agentic" src="/apps/web/public/agentic-social-image-light.jpg" width="640">
+  </a>
+</p>
+
+<p>
+  <a href="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml"><img alt="Build Status" src="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml/badge.svg" /></a>
+  <a href="https://www.npmjs.com/package/@agentic/llamaindex"><img alt="NPM" src="https://img.shields.io/npm/v/@agentic/llamaindex.svg" /></a>
+  <a href="https://prettier.io"><img alt="Prettier Code Formatting" src="https://img.shields.io/badge/code_style-prettier-brightgreen.svg" /></a>
+</p>
+
+# @agentic/llamaindex <!-- omit from toc -->
+
+> Agentic adapter for the LlamaIndex TS SDK.
+
+- [Website](https://agentic.so)
+- [Docs](https://docs.agentic.so/marketplace/ts-sdks/llamaindex)
+
+## Install
+
+```bash
+npm i @agentic/llamaindex zod llamaindex
+```
+
+## Usage
+
+See https://docs.agentic.so/marketplace/ts-sdks/llamaindex
+
+## License
+
+[GNU AGPL 3.0](https://choosealicense.com/licenses/agpl-3.0/)
--- a/stdlib/mastra/readme.md
+++ b/stdlib/mastra/readme.md
@ -0,0 +1,32 @@
+<p align="center">
+  <a href="https://agentic.so">
+    <img alt="Agentic" src="/apps/web/public/agentic-social-image-light.jpg" width="640">
+  </a>
+</p>
+
+<p>
+  <a href="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml"><img alt="Build Status" src="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml/badge.svg" /></a>
+  <a href="https://www.npmjs.com/package/@agentic/mastra"><img alt="NPM" src="https://img.shields.io/npm/v/@agentic/mastra.svg" /></a>
+  <a href="https://prettier.io"><img alt="Prettier Code Formatting" src="https://img.shields.io/badge/code_style-prettier-brightgreen.svg" /></a>
+</p>
+
+# @agentic/mastra <!-- omit from toc -->
+
+> Agentic adapter for the Mastra AI Agent SDK.
+
+- [Website](https://agentic.so)
+- [Docs](https://docs.agentic.so/marketplace/ts-sdks/mastra)
+
+## Install
+
+```bash
+npm i @agentic/mastra zod @mastra/core
+```
+
+## Usage
+
+See https://docs.agentic.so/marketplace/ts-sdks/mastra
+
+## License
+
+[GNU AGPL 3.0](https://choosealicense.com/licenses/agpl-3.0/)
--- a/stdlib/serpapi/readme.md
+++ b/stdlib/serpapi/readme.md
@ -0,0 +1,28 @@
+<p align="center">
+  <a href="https://agentic.so">
+    <img alt="Agentic" src="/apps/web/public/agentic-social-image-light.jpg" width="640">
+  </a>
+</p>
+
+<p>
+  <a href="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml"><img alt="Build Status" src="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml/badge.svg" /></a>
+  <a href="https://www.npmjs.com/package/@agentic/serpapi"><img alt="NPM" src="https://img.shields.io/npm/v/@agentic/serpapi.svg" /></a>
+  <a href="https://prettier.io"><img alt="Prettier Code Formatting" src="https://img.shields.io/badge/code_style-prettier-brightgreen.svg" /></a>
+</p>
+
+# @agentic/serpapi <!-- omit from toc -->
+
+> Agentic SDK for [SerpAPI](https://serpapi.com) Google Search.
+
+- [Website](https://agentic.so)
+- [Docs](https://docs.agentic.so)
+
+## Install
+
+```bash
+npm i @agentic/serpapi zod
+```
+
+## License
+
+[GNU AGPL 3.0](https://choosealicense.com/licenses/agpl-3.0/)
--- a/stdlib/serper/package.json
+++ b/stdlib/serper/package.json
@ -1,7 +1,7 @@
 {
  "name": "@agentic/serper",
  "version": "8.1.1",
-  "description": "Agentic SDK for Serper Google Search.",
+  "description": "Agentic SDK for the Serper Google Search API.",
  "author": "Travis Fischer <travis@transitivebullsh.it>",
  "license": "MIT",
  "repository": {
--- a/stdlib/serper/readme.md
+++ b/stdlib/serper/readme.md
@ -0,0 +1,28 @@
+<p align="center">
+  <a href="https://agentic.so">
+    <img alt="Agentic" src="/apps/web/public/agentic-social-image-light.jpg" width="640">
+  </a>
+</p>
+
+<p>
+  <a href="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml"><img alt="Build Status" src="https://github.com/transitive-bullshit/agentic/actions/workflows/main.yml/badge.svg" /></a>
+  <a href="https://www.npmjs.com/package/@agentic/serper"><img alt="NPM" src="https://img.shields.io/npm/v/@agentic/serper.svg" /></a>
+  <a href="https://prettier.io"><img alt="Prettier Code Formatting" src="https://img.shields.io/badge/code_style-prettier-brightgreen.svg" /></a>
+</p>
+
+# @agentic/serper <!-- omit from toc -->
+
+> Agentic SDK for the [Serper](https://serper.dev) Google Search API.
+
+- [Website](https://agentic.so)
+- [Docs](https://docs.agentic.so)
+
+## Install
+
+```bash
+npm i @agentic/serper zod
+```
+
+## License
+
+[GNU AGPL 3.0](https://choosealicense.com/licenses/agpl-3.0/)
--- a/todo.md
+++ b/todo.md
@ -15,14 +15,10 @@
    - add example usage to project detail pages
    - import react example usage component into docs
  - replace json project and components with actual designs
- docs
-  - sub readmes (https://www.npmjs.com/package/@agentic/cli)
 - double-check free-tier rate-limits for `@agentic/search`
 - create agentic products for select legacy tools
- add support for [`@google/genai`](https://github.com/googleapis/js-genai) tools adapter
 - add feature about optimized context to docs
 - add ts sdk examples to e2e tests
- fix weird git state and github actions marked as failing
 - add scroll appearance motion to hero animation
 - replace how-it-works diagram with better version

@ -115,3 +111,5 @@
  - mcp tool inputSchemas may not support openai strict mode either
  - maybe default `strict` to `false` in `createAIFunction` for now?
  - also add `@agentic/json-schema` to `createJsonSchema` parsing instead of current no-op
+- add support for [`@google/genai`](https://github.com/googleapis/js-genai) tools adapter
+  - currently difficult due to their use of non-standard json schemas