@21st-sdk/node

Server-side Node.js SDK for 21st Agents. Manage sandboxes, threads, and tokens programmatically.

Install

npm install @21st-sdk/node

Quick Start

import { AgentClient } from "@21st-sdk/node"

const client = new AgentClient({
  apiKey: process.env.API_KEY_21ST!, // 21st_sk_...
})

// Create a sandbox for your agent
const sandbox = await client.sandboxes.create({ agent: "my-agent" })

// Create a thread
const thread = await client.threads.create({
  sandboxId: sandbox.sandboxId,
  name: "Review PR #42",
})

// Generate a short-lived token for browser clients
const { token, expiresAt } = await client.tokens.create({
  agent: "my-agent",
  expiresIn: "1h",
})

API

new AgentClient(config)

new AgentClient({
  apiKey: string     // Your 21st_sk_ API key
  baseUrl?: string   // Default: "https://relay.an.dev"
})

client.sandboxes

| Method | Description | |--------|-------------| | create({ agent }) | Create a new sandbox for an agent | | get(sandboxId) | Get sandbox details (status, threads, agent info) | | delete(sandboxId) | Delete a sandbox | | exec({ sandboxId, command, cwd?, envs?, timeoutMs? }) | Run a command inside a sandbox | | git.clone({ sandboxId, url, path?, token?, depth? }) | Clone a repository into a sandbox |

client.sandboxes.files

| Method | Description | |--------|-------------| | write({ sandboxId, files }) | Write one or more text files into a sandbox | | read({ sandboxId, path }) | Read one file from a sandbox | | list({ sandboxId, path, depth? }) | List files and directories under a path | | getInfo({ sandboxId, path }) | Get metadata for one file or directory | | exists({ sandboxId, path }) | Check whether a file or directory exists | | makeDir({ sandboxId, path }) | Create a directory path, returning whether it was newly created | | rename({ sandboxId, oldPath, newPath }) | Rename or move a file or directory | | remove({ sandboxId, path }) | Remove a file or directory |

client.threads

| Method | Description | |--------|-------------| | list({ sandboxId }) | List all threads in a sandbox | | create({ sandboxId, name? }) | Create a new thread | | get({ sandboxId, threadId }) | Get thread with messages | | delete({ sandboxId, threadId }) | Delete a thread |

client.tokens

| Method | Description | |--------|-------------| | create({ agent?, userId?, expiresIn? }) | Create a short-lived JWT (default: 1h) |

License

MIT