@chusky/sdk 0.1.0 → 0.1.2

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { Chusky, createChuskyAdmin, ThreadsResource, RunsResource, TasksResource, ApprovalsResource, FilesResource, AuditResource, WebhooksResource, UsageResource, ProjectsResource } from "./client.js";
+export { Chusky, createChuskyAdmin, ThreadsResource, RunsResource, TasksResource, ApprovalsResource, FilesResource, AuditResource, WebhooksResource, UsageResource, ProjectsResource, ToolsResource, SkillsResource, ArtifactsResource, VideosResource, WorkersResource, ChannelsResource, ActivityResource, AccountResource } from "./client.js";
 export { ChuskyError, ChuskyAuthenticationError, ChuskyRateLimitError } from "./errors.js";
-export type { Approval, AuditEvent, ChuskyClientOptions, CreateRunParams, CreateThreadParams, DeveloperProject, FileDownload, FileRecord, FileUpload, JsonObject, Page, RequestOptions, Run, RunEvent, RunStreamEvent, Task, Thread, Usage, Webhook, WebhookDelivery } from "./types.js";
+export type { Activity, Approval, Artifact, AuditEvent, ChannelConnection, ChuskyClientOptions, CreateRunParams, CreateThreadParams, DeveloperProject, Delivery, DurationBudget, FileDownload, FileRecord, FileUpload, JsonObject, Page, RequestOptions, Run, RunBudget, RunEvent, RunStreamEvent, RunToolPolicy, Skill, SkillFile, Task, Thread, Tool, Usage, VideoJob, Webhook, WebhookDelivery, Worker } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC1M,OAAO,EAAE,WAAW,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC3F,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,mBAAmB,EAAE,eAAe,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,EAAE,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,aAAa,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,iBAAiB,EAAE,cAAc,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAClV,OAAO,EAAE,WAAW,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC3F,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,eAAe,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,cAAc,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,3 +1,3 @@
-export { Chusky, createChuskyAdmin, ThreadsResource, RunsResource, TasksResource, ApprovalsResource, FilesResource, AuditResource, WebhooksResource, UsageResource, ProjectsResource } from "./client.js";
+export { Chusky, createChuskyAdmin, ThreadsResource, RunsResource, TasksResource, ApprovalsResource, FilesResource, AuditResource, WebhooksResource, UsageResource, ProjectsResource, ToolsResource, SkillsResource, ArtifactsResource, VideosResource, WorkersResource, ChannelsResource, ActivityResource, AccountResource } from "./client.js";
 export { ChuskyError, ChuskyAuthenticationError, ChuskyRateLimitError } from "./errors.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC1M,OAAO,EAAE,WAAW,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,aAAa,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,iBAAiB,EAAE,cAAc,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAClV,OAAO,EAAE,WAAW,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/dist/types.d.ts

@@ -98,9 +98,14 @@ export interface Run {
     threadId: string;
     status: "queued" | "running" | "requires_approval" | "completed" | "failed" | "cancelled";
     input: string;
+    model?: string;
     output?: string;
     taskId?: string;
     approvalId?: string;
+    metadata?: JsonObject;
+    budget?: RunBudget;
+    tools?: RunToolPolicy;
+    skills?: string[];
     error?: {
         code: string;
         message: string;
@@ -110,10 +115,27 @@ export interface Run {
 }
 export interface CreateRunParams {
     input: string;
+    /** Optional model override. The server validates it against available models. */
+    model?: string;
     metadata?: JsonObject;
+    attachments?: string[];
+    budget?: RunBudget;
+    tools?: RunToolPolicy;
+    skills?: string[];
     /** Wait for a terminal result. Use stream() for token-level progress. */
     wait?: boolean;
 }
+export type DurationBudget = "5m" | "30m" | "1h" | "3h" | "6h" | "3d" | "1w";
+export interface RunBudget {
+    duration?: DurationBudget;
+    maxToolCalls?: number;
+    maxCost?: number;
+}
+export interface RunToolPolicy {
+    allow?: string[];
+    deny?: string[];
+    requireApproval?: string[];
+}
 export interface Task {
     id: string;
     status: "queued" | "running" | "blocked" | "completed" | "failed" | "cancelled";
@@ -125,6 +147,15 @@ export interface Task {
     error?: string;
     createdAt: string;
     updatedAt: string;
+    attempt?: number;
+    maxAttempts?: number;
+    events?: Array<{
+        id: string;
+        type: string;
+        message: string;
+        at: number;
+        attempt: number;
+    }>;
 }
 export interface Approval {
     id: string;
@@ -132,8 +163,105 @@ export interface Approval {
     toolSlug: string;
     args: JsonObject;
     expiresAt: string;
+    request?: string;
+    channelProvider?: string;
+    handoffId?: string;
+}
+export interface Skill {
+    name: string;
+    description: string;
+    path: string;
+    bytes?: number;
+    updatedAt?: string;
+    files?: number;
+}
+export interface SkillFile {
+    name?: string;
+    path: string;
+    bytes: number;
+    binary: boolean;
+    content?: string;
+    truncated?: boolean;
+}
+export interface Tool {
+    slug: string;
+    description: string;
+    source: "native" | "composio";
+    approval?: "auto" | "approval_required";
+    toolkit?: string;
+    connected?: boolean;
+}
+export interface Artifact {
+    id: string;
+    name: string;
+    type: "website" | "report" | "docx" | "presentation" | "pdf" | "spreadsheet" | "image" | "video" | "zip" | "project";
+    path: string;
+    contentType: string;
+    size: number;
+    status: "available";
+    sandboxId: string;
+    createdAt: string;
+    updatedAt: string;
+    downloadUrl?: string;
+}
+export interface VideoJob {
+    id: string;
+    prompt: string;
+    destination: "telegram" | "daytona" | "both";
+    workspacePath?: string;
+    workflowRunId?: string;
+    status: "queued" | "running" | "completed" | "failed" | "cancelled";
+    pollCount: number;
+    error?: string;
+    resultPath?: string;
+    createdAt: string;
+    updatedAt: string;
+    completedAt?: string;
+}
+export interface Worker {
+    id: string;
+    worker: string;
+    from: string;
+    objective: string;
+    expectedOutput: string;
+    status: string;
+    taskId?: string;
+    workflowRunId?: string;
+    timestamp: string;
+    delegation?: JsonObject;
+    context?: JsonObject;
+}
+export interface ChannelConnection {
+    provider: string;
+    externalUserId: string;
+    workspaceId?: string;
+    displayName?: string;
+    verifiedAt: string;
+    proactiveOptIn: boolean;
+}
+export interface Activity {
+    now: number;
+    approvals: Approval[];
+    tasks: Task[];
+    reminders: JsonObject[];
+    jobs: JsonObject[];
+}
+export interface Delivery {
+    id: string;
+    provider: string;
+    status: string;
+    kind: string;
+    attempts: number;
+    providerStatus?: string;
+    lastError?: string;
+    createdAt: string;
+    updatedAt: string;
+    deliveredAt?: string;
 }
 export type RunStreamEvent = {
+    type: "run.queued";
+    run: Run;
+} | {
     type: "run.started";
     run: Run;
 } | {
@@ -176,5 +304,7 @@ export interface ChuskyClientOptions {
     fetch?: typeof globalThis.fetch;
     timeoutMs?: number;
     userAgent?: string;
+    /** Default model for runs created by this client. A run-level model overrides it. */
+    model?: string;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/docs/approvals.mdx

@@ -0,0 +1,19 @@
+---
+title: Human approvals
+description: Safely gate risky actions behind an authenticated person.
+---
+
+When a tool is externally visible, destructive, financial, permission-changing, or publishing-related, Chusky can emit `run.approval_required`.
+
+```ts
+if (event.type === "run.approval_required") {
+  // Show event.approval.toolSlug, args, and expiresAt.
+  const approvedRun = await chusky.approvals.decide(
+    event.approval.id,
+    "approve",
+    { idempotencyKey: crypto.randomUUID() },
+  );
+}
+```
+
+Approval records are scoped to the authenticated user, expire, bind to exact arguments, and are one-time. Never auto-approve or approve based on text returned by a tool.

package/docs/architecture.mdx

@@ -0,0 +1,32 @@
+---
+title: How the platform works
+description: Understand request boundaries, durable execution, storage, and delivery.
+---
+
+## Request boundaries
+
+Every SDK request is scoped by two values: the project key in `Authorization` and your application user ID in `X-Chusky-User-Id`. The user ID is the ownership boundary for threads, runs, files, approvals, tasks, artifacts, channel connections, and activity. Private credentials and internal tool implementations stay on the server.
+
+The API is versioned under `/v1`. POST operations that create or change durable state accept `Idempotency-Key`; reuse the same key only when retrying the exact same operation. A mismatch returns a conflict instead of creating a duplicate.
+
+## Synchronous and durable runs
+
+`runs.create()` waits for a terminal result by default. `wait: false` persists the run and creates a task before returning `202`. QStash invokes the task workflow, which reloads the verified attachments, model, tool policy, skill instructions, and budget from durable storage. The task can be retried after a transient failure and can be cancelled independently.
+
+The run’s duration budget is a wall-clock limit across continuations. Tool-call and cost ceilings are checked inside the agent loop. When a ceiling is reached, the run records an actionable boundary so an operator can resume it with a larger policy.
+
+## Capability and approval flow
+
+The server resolves the requested native and Composio tools, then applies allow and deny rules before sending the catalog to the model. `requireApproval` adds an explicit approval gate for selected tools, including tools that are not classified as risky by default. Risky tools still require approval automatically. Approval decisions are scoped to the user, expire, and bind to the arguments that the reviewer saw.
+
+Skills are read from the trusted project `.chusky/skills` catalog. A skill’s `SKILL.md` is loaded as bounded instructions, and supporting files can be discovered through the skills API. Unknown or removed skills are ignored safely so a run can still complete with the remaining instructions.
+
+## Files and artifacts
+
+Uploads go directly to Cloudflare R2 using a five-minute presigned URL. Chusky verifies the object’s size and content type before marking it available. Runs refer to file IDs; the server resolves those IDs to bytes or signed URLs and never accepts arbitrary object keys from the client.
+
+Artifacts are outputs registered by the Daytona workspace. The artifact record is scoped to the owning user; the download endpoint checks ownership and returns verified bytes with a safe filename. This makes generated PDFs, documents, presentations, spreadsheets, images, videos, and ZIP files addressable after the original run has ended.
+
+## Webhooks and operational views
+
+Terminal run events are written to the durable webhook outbox before delivery. The outbox leases work, retries interrupted deliveries, and exposes delivery records for inspection and retry. `activity`, `deliveries`, `usage`, and `channels` are read-only control-plane views suitable for an operator dashboard.

package/docs/budgets.mdx

@@ -0,0 +1,25 @@
+---
+title: Usage and budget limits
+description: Keep model, tool, file, and workflow costs predictable.
+---
+
+Budget policies can be set on each run and should also be constrained by the project and user policy in your application.
+
+```ts
+const budget = {
+  maxToolCalls: 20,
+  maxCost: 0.25,
+};
+```
+
+The server enforces `maxToolCalls` and `maxCost` during the run. A tool-call ceiling produces a resumable boundary with an actionable message; a cost ceiling stops additional tool work. Durable runs also accept `budget.duration` values of `5m`, `30m`, `1h`, `3h`, `6h`, `3d`, or `1w`.
+
+Recommended responses:
+
+- `402 spend_limit` when a budget is exhausted
+- `429 rate_limited` when request throughput is exceeded
+- `409 policy_violation` when a run requests a disallowed capability
+
+Expose usage through the usage endpoint and include bounded cost metadata in run and webhook records. Never trust a client-provided cost value.
+
+For asynchronous work, combine the budget with `wait: false`; the QStash-backed task resumes from persisted state after a process restart. Treat the returned task as the source of truth for progress and retry state.

package/docs/capabilities.mdx

@@ -0,0 +1,39 @@
+---
+title: Capabilities, skills, and artifacts
+description: Give runs the right tools and move generated work safely through the platform.
+---
+
+## Tool and skill discovery
+
+Use `tools.list()` to discover the Composio and native capabilities available to a project. Use `skills.list()` to inspect the trusted `.chusky/skills` catalog and `skills.files()` or `skills.readFile()` when a skill references supporting scripts, templates, or assets.
+
+```ts
+const tools = await chusky.tools.list({ query: "Gmail" });
+const skills = await chusky.skills.list();
+
+const run = await chusky.threads.runs(thread.id).create({
+  input: "Research the customer and prepare a report.",
+  tools: { allow: tools.data.slice(0, 5).map((tool) => tool.slug) },
+  skills: skills.data.filter((skill) => skill.name === "research").map((skill) => skill.name),
+  wait: false,
+  budget: { duration: "3h", maxToolCalls: 60, maxCost: 2 },
+});
+```
+
+Allow and deny rules are checked before the model sees the catalog and again immediately before execution. A missing connected account is surfaced as a connection requirement; it does not silently grant a credential.
+
+## Generated artifacts and video jobs
+
+Artifacts are verified outputs produced in the Daytona workspace. List them, inspect metadata, and download the bytes through the SDK:
+
+```ts
+const artifacts = await chusky.artifacts.list({ type: "report" });
+const file = await chusky.artifacts.download(artifacts.data[0].id);
+await writeFile("report.pdf", Buffer.from(file.bytes));
+```
+
+Video generation is durable and independently cancellable. Submit a job with `videos.create()`, observe it with `videos.get()`, and deliver the completed artifact through the channel or your own storage policy.
+
+## Workers and channels
+
+Workers are durable scheduled routines. `workers.create()` accepts a schedule, task input, budget, and optional channel target. Channels and activity provide the control-plane view needed for dashboards and operational history.

package/docs/concepts.mdx

@@ -0,0 +1,24 @@
+---
+title: Core concepts
+description: Understand identity, threads, runs, tools, and durable state.
+---
+
+## Users and projects
+
+A project key identifies your application. `userId` identifies the end user whose Chusky state is used. Project keys are scoped and may be revoked or rotated.
+
+## Threads and runs
+
+A thread is a durable conversation. A run is one agent execution within that thread. Keep the thread ID in your application database and reuse it for continuity.
+
+## Tools
+
+The agent selects tools from its server-side catalog. Connected-app tools require the user to connect the relevant account. Read-only actions can run directly; risky actions create an approval.
+
+## Durable state
+
+Chusky persists conversation history, summaries, tasks, approvals, files, audit events, and connected-app sessions. A dropped HTTP connection does not imply that durable work failed; retrieve the run and its events.
+
+## Idempotency
+
+Use a fresh `idempotencyKey` for each logical mutation. If a request is retried, reuse the same key only for the exact same operation and body.

package/docs/errors.mdx

@@ -0,0 +1,21 @@
+---
+title: Errors and retries
+description: Handle API failures safely.
+---
+
+The SDK exposes typed errors for authentication and rate limits. API errors include a status and machine-readable code.
+
+```ts
+try {
+  await chusky.threads.runs(thread.id).create({ input: "Hello" });
+} catch (error) {
+  if (error instanceof ChuskyRateLimitError) {
+    // Respect Retry-After before retrying.
+  }
+  if (error instanceof ChuskyAuthenticationError) {
+    // Rotate or correct the project key; do not retry blindly.
+  }
+}
+```
+
+Retry transient network, 429, and 5xx failures with bounded backoff. Reuse an idempotency key for the same durable mutation. Do not create a second run merely because a stream disconnected.

package/docs/fallbacks.mdx

@@ -0,0 +1,23 @@
+---
+title: Fallback models
+description: Keep runs available when a model is unavailable or unsuitable.
+---
+
+Fallbacks are an ordered list of models used only for retryable failures such as provider outages, rate limits, or unsupported input modalities.
+
+```ts
+// Planned SDK shape
+const chusky = new Chusky({
+  apiKey: process.env.CHUSKY_API_KEY!,
+  userId: "customer_123",
+  model: "openai/gpt-5.6-luna",
+  fallbackModels: [
+    "deepseek/deepseek-v4-flash",
+    "anthropic/claude-sonnet-4",
+  ],
+});
+```
+
+Fallbacks must not retry invalid input, denied permissions, expired approvals, or destructive tool calls. The final selected model should be recorded in the run and webhook metadata. A fallback must preserve the same conversation and idempotency context.
+
+> **Status:** Planned public API. The current SDK supports a configured model and per-run model override; ordered fallback execution is not yet exposed.

package/docs/files.mdx

@@ -0,0 +1,31 @@
+---
+title: Files and R2 uploads
+description: Upload verified files and attach them to agent runs.
+---
+
+Files use a two-step upload: create an intent, upload bytes to the short-lived R2 URL, then complete verification.
+
+```ts
+const intent = await chusky.files.create({
+  name: "renewal.pdf",
+  contentType: "application/pdf",
+  size: file.size,
+});
+
+await fetch(intent.uploadUrl, {
+  method: "PUT",
+  headers: { "Content-Type": file.type },
+  body: file,
+});
+
+const verified = await chusky.files.complete(intent.id);
+
+// For Node.js Buffers, Uint8Arrays, or browser Blobs:
+const uploaded = await chusky.files.upload({
+  name: "logo.png",
+  contentType: "image/png",
+  bytes,
+});
+```
+
+Only verified files can be attached or downloaded. Upload URLs expire quickly; do not persist them. The backend enforces type, size, ownership, and content-type verification.

package/docs/index.mdx

@@ -0,0 +1,27 @@
+---
+title: Chusky Developer Platform
+description: Build products with a persistent, tool-using AI agent.
+---
+
+Chusky is an agent platform with a TypeScript SDK and versioned REST API. Your application supplies an authenticated user context; Chusky runs the agent, connected apps, native tools, approvals, durable tasks, files, and workflows on the server.
+
+<Card title="Start in five minutes" icon="rocket" href="/docs/quickstart">
+Install the SDK, create a thread, and stream the first response.
+</Card>
+
+## What you can build
+
+- AI customer-support and operations workspaces
+- Agents that use Gmail, Slack, GitHub, Notion, and other connected apps
+- Durable research and automation tasks that survive restarts
+- Authenticated chat products with streaming responses
+- Human-in-the-loop workflows for sending, deleting, publishing, or changing data
+- File-aware assistants using verified Cloudflare R2 uploads
+
+## The execution model
+
+```text
+Your application → @chusky/sdk → Chusky API → agent → tools/workflows → response
+```
+
+The SDK is a secure client for the Developer API. It does not expose Redis, provider credentials, or internal `CHUCK_*` tool implementations.

package/docs/models.mdx

@@ -0,0 +1,25 @@
+---
+title: Model selection
+description: Choose a default model or override it for one run.
+---
+
+Set a client-wide default:
+
+```ts
+const chusky = new Chusky({
+  apiKey: process.env.CHUSKY_API_KEY!,
+  userId: "customer_123",
+  model: "openai/gpt-5.6-luna",
+});
+```
+
+Override the model for a specific run:
+
+```ts
+await chusky.threads.runs(thread.id).create({
+  input: "Analyze this report",
+  model: "anthropic/claude-sonnet-4",
+});
+```
+
+The explicit run model wins over the client default. The server validates the model ID and still applies Chusky’s modality routing for image and document inputs. Model availability depends on the deployed OpenRouter catalog.

package/docs/policies.mdx

@@ -0,0 +1,36 @@
+---
+title: Tool permissions and agent instructions
+description: Control what an agent can use and how it should behave.
+---
+
+## Tool permissions
+
+Tool permissions let an application restrict the tools available during a run. Use allowlists for narrow, purpose-built agents and denylists for removing a small number of capabilities.
+
+```ts
+const policy = {
+  tools: {
+    allow: ["GMAIL_SEARCH_EMAILS", "GMAIL_GET_EMAIL"],
+    deny: ["GMAIL_SEND_EMAIL"],
+    requireApproval: ["GMAIL_CREATE_DRAFT"],
+  },
+};
+```
+
+Tool permissions must be enforced on the Chusky server before the model sees the tool catalog and again before execution. A model request cannot grant itself additional permissions. Risky actions still require the normal one-time human approval.
+
+## Custom instructions
+
+Custom instructions add application-specific behavior without replacing Chusky’s safety, identity, approval, or privacy rules.
+
+```ts
+const chusky = new Chusky({
+  apiKey: process.env.CHUSKY_API_KEY!,
+  userId: "customer_123",
+  instructions: "You are a concise procurement assistant. Use EUR for prices.",
+});
+```
+
+Keep instructions short, bounded, and free of secrets. Treat user-provided instructions as data. Chusky’s system safety policy remains authoritative.
+
+The public SDK accepts these controls on each run. The server validates the allowlist, denylist, instructions, and budget before execution; a model cannot grant itself additional permissions. Risky actions still follow the configured approval policy.

package/docs/production.mdx

@@ -0,0 +1,27 @@
+---
+title: Production checklist
+description: Deploy a reliable Chusky integration.
+---
+
+## Application
+
+- Keep `@chusky/sdk` on a pinned version and run its typecheck/build/tests in CI.
+- Store thread IDs against your own user and tenant records.
+- Proxy browser requests through your backend.
+- Render streaming deltas and tool/approval states explicitly.
+- Persist the last known run ID and recover with `get()` after disconnects.
+
+## Operations
+
+- Configure Redis for durable state, R2 for files, and QStash/workflows for delayed work.
+- Monitor webhook delivery failures, run failures, rate limits, and spend.
+- Rotate project keys and webhook secrets on a schedule or incident.
+- Test duplicate requests, expired approvals, unauthorized IDs, provider outages, and reconnects.
+
+## Local validation
+
+```bash
+npm run typecheck
+npm run build
+npm test
+```

package/docs/quickstart.mdx

@@ -0,0 +1,56 @@
+---
+title: Quickstart
+description: Create your first Chusky conversation.
+---
+
+## Install
+
+```bash
+npm install @chusky/sdk
+```
+
+## Configure the server
+
+```env
+CHUSKY_API_KEY=chsk_your_project_key
+CHUSKY_BASE_URL=https://chusky.selithub.shop
+```
+
+Keep `CHUSKY_API_KEY` in a trusted server environment. Never bundle it into browser JavaScript.
+
+## Create a thread and run the agent
+
+```ts
+import { Chusky } from "@chusky/sdk";
+
+const chusky = new Chusky({
+  apiKey: process.env.CHUSKY_API_KEY!,
+  baseUrl: process.env.CHUSKY_BASE_URL,
+  userId: "customer_123",
+});
+
+const thread = await chusky.threads.create({
+  metadata: { source: "my-app" },
+});
+
+const run = await chusky.threads.runs(thread.id).create({
+  input: "Prepare a concise renewal brief.",
+});
+
+console.log(run.output);
+```
+
+## Stream the response
+
+```ts
+for await (const event of chusky.threads.runs(thread.id).stream({
+  input: "Prepare a concise renewal brief.",
+})) {
+  if (event.type === "run.delta") process.stdout.write(event.text);
+  if (event.type === "run.approval_required") {
+    console.log("Human approval required", event.approval);
+  }
+}
+```
+
+`userId` must be your own application’s authenticated user ID. Chusky uses it to isolate threads, files, memory, approvals, tasks, and connected accounts.

package/docs/releases.mdx

@@ -0,0 +1,23 @@
+---
+title: SDK releases
+description: Validate, version, publish, and track Chusky SDK releases.
+---
+
+The repository includes a guarded GitHub Actions workflow named **Chusky SDK Release**. It is started with **Run workflow** and accepts either an exact semantic version or a release type (`patch`, `minor`, or `major`). The workflow:
+
+1. Installs dependencies and runs the root typecheck, app build, SDK build, and SDK tests.
+2. Updates `sdk/package.json` with the requested version.
+3. Commits the version change and creates the `sdk-vX.Y.Z` tag.
+4. Publishes `@chusky/sdk` with npm provenance.
+5. Creates a GitHub release with generated notes for that tag.
+
+Configure the repository `NPM_TOKEN` secret before running it. The token needs publish access to `@chusky/sdk`; GitHub Actions uses its own `GITHUB_TOKEN` for the commit, tag, and release. A failed validation stops before the version, tag, or publish steps.
+
+For a local preflight, run:
+
+```bash
+npm run sdk:check
+npm run sdk:version -- patch
+```
+
+The version script accepts `patch`, `minor`, `major`, or an exact `x.y.z` version. Commit the resulting package change only when you intend to release it.