TypeScript SDK

@chatai/sdk is a private workspace package (not on npm yet). Use it inside this monorepo with workspace:*.

{
  "dependencies": {
    "@chatai/sdk": "workspace:*"
  }
}

It wraps Bearer REST + SSE chat. OpenAPI for the same surface: REST API.

Setup

Run ChatAI (pnpm dev or Docker)
Create an assistant and knowledge (or pnpm seed:demo)
In Account, create an API key with at least the chat scope; copy sk_live_…
Note the assistant public id (asst_…)

Streaming chat

import { ChatAI } from "@chatai/sdk";

const client = new ChatAI({
  apiKey: process.env.CHATAI_API_KEY!,
  baseUrl: process.env.CHATAI_API_URL ?? "http://localhost:3000",
});

const result = await client.chat({
  assistantId: process.env.CHATAI_ASSISTANT_ID!,
  message: "What is your refund policy?",
  onToken: (text) => process.stdout.write(text),
});

console.log("\n", result.outcome, result.sources);

Owner REST helpers

Method	Scope (typical)
`listAssistants` / `getAssistant` / `createAssistant` / `updateAssistant` / `deleteAssistant`	`assistants:*`
`listDocuments` / `getDocument` / `deleteDocument` / `reprocessDocument`	`documents:*`
`listConversations` / `getConversation`	`conversations:read`
`getAnalytics`	`analytics:read`

Document upload remains dashboard-only (no multipart REST yet).

Example script

cd examples/node-sdk-chat
CHATAI_API_KEY=sk_live_... \
CHATAI_ASSISTANT_ID=asst_... \
pnpm start -- "What is your refund policy?"

Optional: CHATAI_API_URL (default http://localhost:3000).

Errors

ChatAIError exposes HTTP status and body message for 4xx/5xx. Respect 429 Retry-After when rate limited.