initial release

AN SDK — the open-source framework for building, deploying, and embedding AI coding agents.

Packages:
- @an-sdk/agent — type-safe agent definitions
- @an-sdk/react — drop-in React chat UI
- @an-sdk/node — Node.js API client
- @an-sdk/nextjs — Next.js integration
- @an-sdk/cli — deploy CLI

Author: bunasQ

.github/workflows/ci.yml

@@ -0,0 +1,25 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 9
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: pnpm
+
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm build

.gitignore

@@ -0,0 +1,8 @@
+node_modules/
+dist/
+.turbo/
+.env
+.env.*
+.DS_Store
+*.tgz
+CLAUDE.md

CONTRIBUTING.md

@@ -0,0 +1,44 @@
+# Contributing to AN SDK
+
+Thanks for your interest in contributing to AN SDK!
+
+## Reporting Issues
+
+Found a bug or have a feature request? [Open an issue](https://github.com/21st-dev/an-sdk/issues/new) with:
+
+- A clear description of the problem or feature
+- Steps to reproduce (for bugs)
+- Which package is affected (`@an-sdk/agent`, `@an-sdk/react`, etc.)
+
+## Pull Requests
+
+We welcome PRs for bug fixes, documentation improvements, and new features.
+
+1. Fork the repo and create your branch from `main`
+2. Install dependencies: `pnpm install`
+3. Make your changes
+4. Run the build to verify: `pnpm build`
+5. Open a PR with a clear description
+
+### Development Setup
+
+```bash
+git clone https://github.com/21st-dev/an-sdk.git
+cd an-sdk
+pnpm install
+pnpm build
+```
+
+### Code Style
+
+- TypeScript throughout
+- Follow existing patterns in the codebase
+- Keep changes focused — one feature or fix per PR
+
+## How This Repo Works
+
+This repo contains the open-source SDK packages for the AN platform. The source of truth is maintained internally, and this repo is synced periodically. We review and merge community PRs, then sync them back.
+
+## Questions?
+
+Join the discussion in [GitHub Issues](https://github.com/21st-dev/an-sdk/issues) or reach out at [an.dev](https://an.dev).

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 21st.dev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,85 @@
+# AN SDK
+
+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.
+
+## Packages
+
+| Package | Description | npm |
+|---|---|---|
+| [`@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}!` }],
+      }),
+    }),
+  },
+})
+```
+
+### 2. Deploy
+
+```bash
+npx @an-sdk/cli login
+npx @an-sdk/cli deploy
+```
+
+### 3. Embed in your app
+
+```tsx
+import { AnAgentChat } from "@an-sdk/react"
+
+export default function Page() {
+  return <AnAgentChat agent="your-agent-slug" />
+}
+```
+
+## Architecture
+
+```
+Developer → CLI → AN Platform → E2B Sandbox (agent runs here)
+                                     ↕
+Client → @an-sdk/react → AN Relay → SSE Streaming
+```
+
+- **SDK packages** (this repo): Open-source. Define agents, build UIs, deploy.
+- **AN Platform**: Managed infrastructure. Runs agents in sandboxes, handles billing, auth, scaling.
+
+Same model as Next.js (open-source) + Vercel (managed platform).
+
+## Documentation
+
+See the [`docs/`](./packages/docs) directory or visit [an.dev/docs](https://an.dev/docs).
+
+## Examples
+
+- [`examples/basic-agent`](./examples/basic-agent) — Minimal agent with a custom tool
+
+## Contributing
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md).
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

examples/basic-agent/README.md

@@ -0,0 +1,28 @@
+# Basic Agent Example
+
+A minimal AN agent that reviews code using ESLint.
+
+## Setup
+
+```bash
+npm install
+```
+
+## Deploy
+
+```bash
+# Login with your API key (get one at https://an.dev/api-keys)
+npx @an-sdk/cli login
+
+# Deploy the agent
+npx @an-sdk/cli deploy
+```
+
+The CLI will detect your agent in `agents/code-reviewer.ts`, bundle it, and deploy to the AN platform.
+
+## What's happening
+
+1. `agents/code-reviewer.ts` defines the agent using `@an-sdk/agent`
+2. `an deploy` bundles the code and uploads it to AN
+3. AN runs the agent in an isolated sandbox
+4. You can interact with it via the AN dashboard or embed it in your app with `@an-sdk/react`

examples/basic-agent/agents/code-reviewer.ts

@@ -0,0 +1,22 @@
+import { agent, tool } from "@an-sdk/agent"
+import { z } from "zod"
+
+export default agent({
+  model: "claude-sonnet-4-6",
+  systemPrompt: "You are a code reviewer. Review files for bugs, style issues, and improvements.",
+  tools: {
+    lint: tool({
+      description: "Run ESLint on a file",
+      inputSchema: z.object({ path: z.string().describe("File path to lint") }),
+      execute: async ({ path }) => {
+        const { execSync } = await import("child_process")
+        try {
+          const output = execSync(`npx eslint ${path}`, { encoding: "utf-8" })
+          return { content: [{ type: "text", text: output || "No issues found." }] }
+        } catch (error: any) {
+          return { content: [{ type: "text", text: error.stdout || error.message }] }
+        }
+      },
+    }),
+  },
+})

examples/basic-agent/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "basic-agent-example",
+  "private": true,
+  "type": "module",
+  "dependencies": {
+    "@an-sdk/agent": "latest",
+    "zod": "^3.24"
+  }
+}

package.json

@@ -0,0 +1,19 @@
+{
+  "name": "an-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"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "turbo run build",
+    "dev": "turbo run dev",
+    "ts:check": "turbo run ts:check"
+  },
+  "devDependencies": {
+    "turbo": "^2.3.0"
+  },
+  "packageManager": "pnpm@9.15.4"
+}

packages/agent/AGENTS.md

@@ -0,0 +1,39 @@
+# @an-sdk/agent
+
+Config layer for defining AI agents and tools with full type inference.
+
+## Docs
+
+Full documentation: `./docs/` directory (8 guides covering the entire AN platform).
+
+## Source
+
+Source code: `./src/` directory.
+
+## Key Entry Points
+
+- `src/index.ts` — Barrel exports (`agent`, `tool`, all types)
+- `src/agent.ts` — `agent()` factory function (sets defaults, returns `AgentConfig`)
+- `src/tool.ts` — `tool()` factory function (returns `ToolDefinition<TInput>`)
+- `src/types.ts` — All type definitions (`AgentConfig`, `ToolDefinition`, `ToolSet`, hooks)
+
+## Quick Example
+
+```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 assistant.",
+  tools: {
+    greet: tool({
+      description: "Greet a user",
+      inputSchema: z.object({ name: z.string() }),
+      execute: async ({ name }) => ({
+        content: [{ type: "text", text: `Hello, ${name}!` }],
+      }),
+    }),
+  },
+})
+```