chore: sync SDK packages with monorepo

Full sync of all 6 SDK packages (agent, cli, docs, nextjs, node, react)
from monorepo source of truth. Updates repo name references from an-sdk
to 21st-sdk. Fixes workspace:* dep in nextjs package.json.

Author: bunasQ

README.md

@@ -1,85 +1,95 @@
-# AN SDK
+# 21st SDK — Internal Dev Guide
 
-The open-source SDK for building, deploying, and embedding AI coding agents.
-
-**AN** is the "Vercel for agents" — a framework + hosting platform for AI agents. Define agents in code, deploy with one command, embed anywhere.
+This directory contains the 21st SDK packages. Source of truth lives here in the monorepo. The public open-source repo is at [github.com/21st-dev/21st-sdk](https://github.com/21st-dev/21st-sdk).
 
 ## Packages
 
-| Package | Description | npm |
+| Directory | npm package | What it does |
 |---|---|---|
-| [`@an-sdk/agent`](./packages/agent) | Define agents with full type safety | [![npm](https://img.shields.io/npm/v/@an-sdk/agent)](https://www.npmjs.com/package/@an-sdk/agent) |
-| [`@an-sdk/react`](./packages/react) | Drop-in React chat UI for agents | [![npm](https://img.shields.io/npm/v/@an-sdk/react)](https://www.npmjs.com/package/@an-sdk/react) |
-| [`@an-sdk/node`](./packages/node) | Node.js client for the AN API | [![npm](https://img.shields.io/npm/v/@an-sdk/node)](https://www.npmjs.com/package/@an-sdk/node) |
-| [`@an-sdk/nextjs`](./packages/nextjs) | Next.js integration (server + client) | [![npm](https://img.shields.io/npm/v/@an-sdk/nextjs)](https://www.npmjs.com/package/@an-sdk/nextjs) |
-| [`@an-sdk/cli`](./packages/cli) | CLI for deploying agents | [![npm](https://img.shields.io/npm/v/@an-sdk/cli)](https://www.npmjs.com/package/@an-sdk/cli) |
-
-## Quickstart
-
-### 1. Define an agent
-
-```ts
-// agents/my-agent.ts
-import { agent, tool } from "@an-sdk/agent"
-import { z } from "zod"
-
-export default agent({
-  model: "claude-sonnet-4-6",
-  systemPrompt: "You are a helpful coding assistant.",
-  tools: {
-    greet: tool({
-      description: "Greet the user",
-      inputSchema: z.object({ name: z.string() }),
-      execute: async ({ name }) => ({
-        content: [{ type: "text", text: `Hello, ${name}!` }],
-      }),
-    }),
-  },
-})
-```
+| `agent/` | `@21st-sdk/agent` | Agent + tool definition (types only) |
+| `react/` | `@21st-sdk/react` | React chat UI components |
+| `node/` | `@21st-sdk/node` | Node.js API client |
+| `nextjs/` | `@21st-sdk/nextjs` | Next.js integration (server + client) |
+| `cli/` | `@21st-sdk/cli` | `an login` + `an deploy` CLI |
+| `docs/` | — | Documentation (bundled into each package on publish) |
+
+> **Note:** `agent-runtime` used to be here but was moved to `packages/agent-runtime/` — it's private and should never be in the public repo.
 
-### 2. Deploy
+## Day-to-day development
+
+Just work in the monorepo as normal. Edit files, run builds, test locally.
 
 ```bash
-npx @an-sdk/cli login
-npx @an-sdk/cli deploy
+# Build all SDK packages
+pnpm --filter "@21st-sdk/*" build
+
+# Build a specific package
+pnpm --filter @21st-sdk/react build
 ```
 
-### 3. Embed in your app
+## Publishing to the open-source repo
 
-```tsx
-import { AnAgentChat } from "@an-sdk/react"
+When you're ready to push changes to the public [github.com/21st-dev/21st-sdk](https://github.com/21st-dev/21st-sdk):
 
-export default function Page() {
-  return <AnAgentChat agent="your-agent-slug" />
-}
+### Prerequisites (one-time setup)
+
+Clone the public repo as a sibling of the monorepo:
+
+```bash
+cd /Users/sergeybunas/Develop/21/
+git clone git@github.com:21st-dev/21st-sdk.git
 ```
 
-## Architecture
+So your directory structure looks like:
 
 ```
-Developer → CLI → AN Platform → E2B Sandbox (agent runs here)
-                                     ↕
-Client → @an-sdk/react → AN Relay → SSE Streaming
+Develop/21/
+├── 21st/       ← monorepo (this repo)
+└── an-sdk/       ← public repo
 ```
 
-- **SDK packages** (this repo): Open-source. Define agents, build UIs, deploy.
-- **AN Platform**: Managed infrastructure. Runs agents in sandboxes, handles billing, auth, scaling.
+### Releasing
 
-Same model as Next.js (open-source) + Vercel (managed platform).
+From the monorepo root:
 
-## Documentation
+```bash
+# Option 1: Auto-generate commit message from recent monorepo commits
+./scripts/release-sdk.sh
 
-See the [`docs/`](./packages/docs) directory or visit [an.dev/docs](https://an.dev/docs).
+# Option 2: Custom commit message
+./scripts/release-sdk.sh -m "feat: add theme customization API to @21st-sdk/react"
 
-## Examples
+# Option 3: Tagged release (creates a git tag)
+./scripts/release-sdk.sh -t v0.2.0 -m "v0.2.0 — streaming improvements and new tool renderers"
+```
 
-- [`examples/basic-agent`](./examples/basic-agent) — Minimal agent with a custom tool
+Then push:
 
-## Contributing
+```bash
+cd ../an-sdk && git push        # regular release
+cd ../an-sdk && git push --tags # if you created a tag
+```
+
+### What the script does
+
+1. Copies `agent/`, `react/`, `node/`, `nextjs/`, `cli/`, `docs/` to the public repo
+2. Excludes `node_modules/`, `dist/`, `.turbo/`, `CLAUDE.md` (private dev notes)
+3. If no `-m` flag, pulls recent commit messages from the monorepo that touched `packages/an-sdk/` and uses them as the commit message
+4. Creates a commit in the public repo (skips if nothing changed)
+5. Optionally tags the commit with `-t`
+
+### What NOT to do
 
-See [CONTRIBUTING.md](./CONTRIBUTING.md).
+- Don't develop directly in the public repo — always work in the monorepo
+- Don't manually copy files — always use the release script
+- Don't include `agent-runtime` — the script only copies the 6 listed packages
 
-## License
+## Publishing to npm
+
+npm publishing still happens from the monorepo, not the public repo:
+
+```bash
+pnpm --filter @21st-sdk/agent build && npm publish --access public
+```
 
-MIT — see [LICENSE](./LICENSE).
+See the [NPM Publishing notes](../../.claude/projects/-Users-sergeybunas-Develop-21-21st/memory/MEMORY.md) for auth details.

package.json

@@ -1,10 +1,10 @@
 {
-  "name": "an-sdk",
+  "name": "21st-sdk",
   "private": true,
   "description": "The open-source SDK for building, deploying, and embedding AI coding agents.",
   "repository": {
     "type": "git",
-    "url": "https://github.com/21st-dev/an-sdk.git"
+    "url": "https://github.com/21st-dev/21st-sdk.git"
   },
   "license": "MIT",
   "scripts": {

packages/agent/README.md

@@ -1,19 +1,19 @@
-# @an-sdk/agent
+# @21st-sdk/agent
 
-Define AI agents with full type inference. The config layer for [AN](https://an.dev).
+Define AI agents with full type inference. The config layer for [21st Agents](https://21st.dev/agents).
 
 ## Install
 
 ```bash
-npm install @an-sdk/agent zod
+npm install @21st-sdk/agent zod
 ```
 
 ## Quick Start
 
 Create `src/agent.ts`:
 
 ```ts
-import { agent, tool } from "@an-sdk/agent"
+import { agent, tool } from "@21st-sdk/agent"
 import { z } from "zod"
 
 export default agent({
@@ -31,11 +31,11 @@ export default agent({
 })
 ```
 
-Then deploy with the [AN CLI](https://www.npmjs.com/package/@an-sdk/cli):
+Then deploy with the [21st SDK CLI](https://www.npmjs.com/package/@21st-sdk/cli):
 
 ```bash
-npx @an-sdk/cli login
-npx @an-sdk/cli deploy
+npx @21st-sdk/cli login
+npx @21st-sdk/cli deploy
 ```
 
 ## API
@@ -85,7 +85,7 @@ export default agent({
 Creates a tool definition with Zod schema validation.
 
 ```ts
-import { tool } from "@an-sdk/agent"
+import { tool } from "@21st-sdk/agent"
 import { z } from "zod"
 
 const myTool = tool({
@@ -132,7 +132,7 @@ onFinish: async ({ result }) => {
 
 ## How It Works
 
-`agent()` and `tool()` are identity functions — they return exactly what you pass in, with type inference added. The actual execution happens in the AN runtime (E2B sandbox) using the Claude Agent SDK.
+`agent()` and `tool()` are identity functions — they return exactly what you pass in, with type inference added. The actual execution happens in the 21st Agents runtime (E2B sandbox) using the Claude Agent SDK.
 
 Your code runs in a secure cloud sandbox with full access to Node.js, git, and system tools.
 

packages/agent/package.json

@@ -1,9 +1,9 @@
 {
-  "name": "@an-sdk/agent",
-  "version": "0.0.4",
+  "name": "@21st-sdk/agent",
+  "version": "0.0.6",
   "license": "MIT",
-  "description": "Define AI agents and tools with full type inference — the config layer for AN",
-  "homepage": "https://an.dev",
+  "description": "Define AI agents and tools with full type inference for 21st Agents",
+  "homepage": "https://21st.dev/agents",
   "publishConfig": {
     "access": "public"
   },
@@ -39,8 +39,8 @@
     "ai",
     "agent",
     "tools",
-    "an",
-    "an.dev",
+    "21st",
+    "21st.dev",
     "sdk",
     "claude",
     "codex"

packages/cli/README.md

@@ -1,21 +1,21 @@
-# @an-sdk/cli
+# @21st-sdk/cli
 
-Deploy AI agents to [AN](https://an.dev) from your terminal.
+Deploy AI agents to [21st Agents](https://21st.dev/agents) from your terminal.
 
 ## Quick Start
 
 ```bash
-# 1. Login with your API key (get one at an.dev)
-npx @an-sdk/cli login
+# 1. Login with your API key (get one at https://21st.dev/agents/api-keys)
+npx @21st-sdk/cli login
 
 # 2. Create your agent
-npm init -y && npm install @an-sdk/agent zod
+npm init -y && npm install @21st-sdk/agent zod
 ```
 
 Create `src/agent.ts`:
 
 ```ts
-import { agent, tool } from "@an-sdk/agent"
+import { agent, tool } from "@21st-sdk/agent"
 import { z } from "zod"
 
 export default agent({
@@ -35,7 +35,7 @@ export default agent({
 
 ```bash
 # 3. Deploy
-npx @an-sdk/cli deploy
+npx @21st-sdk/cli deploy
 ```
 
 That's it. Your agent is live.
@@ -44,10 +44,10 @@ That's it. Your agent is live.
 
 ### `an login`
 
-Authenticate with the AN platform.
+Authenticate with your API key.
 
 ```bash
-npx @an-sdk/cli login
+npx @21st-sdk/cli login
 # Enter your API key: an_sk_...
 # Authenticated as John (team: my-team)
 ```
@@ -59,7 +59,7 @@ Your key is saved to `~/.an/credentials`.
 Bundle and deploy your agent.
 
 ```bash
-npx @an-sdk/cli deploy
+npx @21st-sdk/cli deploy
 # Bundling src/agent.ts...
 # Bundled (12.3kb)
 # Deploying my-agent...
@@ -89,7 +89,7 @@ After first deploy, the CLI saves `.an/project.json` in your project directory.
 
 ## Environment Variables
 
-`AN_API_URL` — Override the API endpoint (default: `https://an.dev/api/v1`)
+`API_URL_21ST` — Override the API endpoint (default: `https://an.dev/api/v1`)
 
 ## License
 

packages/cli/package.json

@@ -1,7 +1,10 @@
 {
-  "name": "@an-sdk/cli",
-  "version": "0.0.11",
-  "description": "AN CLI — deploy AI agents",
+  "name": "@21st-sdk/cli",
+  "version": "0.0.15",
+  "description": "CLI for deploying AI agents to 21st Agents",
+  "publishConfig": {
+    "access": "public"
+  },
   "type": "module",
   "bin": {
     "an": "dist/index.js"

packages/cli/src/bundler.ts

@@ -7,7 +7,7 @@ export async function findAgentEntryPoints(): Promise<AgentEntryPoint[]> {
   const { join, basename, extname } = await import("path")
 
   if (!existsSync("agents") || !statSync("agents").isDirectory()) {
-    throw new Error("No agents/ directory found. See https://an.dev/docs to get started.")
+    throw new Error("No agents/ directory found. See https://21st.dev/agents/docs to get started.")
   }
 
   const entries: AgentEntryPoint[] = []
@@ -34,7 +34,7 @@ export async function findAgentEntryPoints(): Promise<AgentEntryPoint[]> {
   }
 
   if (entries.length === 0) {
-    throw new Error("No agents found in agents/ directory. See https://an.dev/docs to get started.")
+    throw new Error("No agents found in agents/ directory. See https://21st.dev/agents/docs to get started.")
   }
 
   return entries
@@ -48,7 +48,7 @@ export async function bundleAgent(entryPoint: string): Promise<Buffer> {
     target: "node22",
     format: "esm",
     write: false,
-    external: ["@an-sdk/agent"],
+    external: ["@21st-sdk/agent"],
     minify: true,
     sourcemap: false,
   })
@@ -66,7 +66,7 @@ async function importBundle(bundle: Buffer): Promise<Record<string, unknown> | n
   const { writeFileSync, unlinkSync, mkdirSync } = await import("fs")
   const { join } = await import("path")
 
-  // Write to .an-tmp/ in cwd so ESM can resolve @an-sdk/agent from node_modules
+  // Write to .an-tmp/ in cwd so ESM can resolve @21st-sdk/agent from node_modules
   const tmpDir = join(process.cwd(), ".an-tmp")
   mkdirSync(tmpDir, { recursive: true })
   const tmpPath = join(tmpDir, `an-bundle-${Date.now()}.mjs`)