@chusky/sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Chusky contributors
+
+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.

package/README.md

@@ -0,0 +1,59 @@
+# Chusky TypeScript SDK
+
+This package is the public developer boundary for Chusky. It is intentionally separate from the Telegram bot, Redis store, Composio credentials, and internal `CHUCK_*` tool names. Developers place their scoped `chsk_` project key in `CHUSKY_API_KEY`. On the self-hosted Oracle server only, `CHUSKY_PROJECT_KEY` is the private root/bootstrap credential used to provision those project keys.
+
+```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();
+
+for await (const event of chusky.threads.runs(thread.id).stream(
+  { input: "Prepare a concise renewal brief." },
+  { idempotencyKey: crypto.randomUUID() },
+)) {
+  if (event.type === "run.delta") process.stdout.write(event.text);
+  if (event.type === "run.approval_required") {
+    // Present the exact approval to an authenticated human.
+  }
+}
+```
+
+## Provisioning a project key
+
+Run this only on a trusted backend or operator machine. Never expose the root
+`CHUSKY_PROJECT_KEY` to a browser, developer, or end user.
+
+```ts
+import { createChuskyAdmin } from "@chusky/sdk";
+const admin = createChuskyAdmin({ apiKey: process.env.CHUSKY_PROJECT_KEY!, baseUrl: process.env.CHUSKY_BASE_URL });
+const project = await admin.projects.create({ name: "My App", scopes: ["*"] });
+console.log(project.key); // save once; list() never returns it
+```
+
+## Dashboard self-service keys
+
+A verified Chusky dashboard user can create up to 10 project keys from
+**Developer API** in the dashboard. The raw `chsk_` secret appears only when a
+key is created or rotated. Put that scoped value in the application's trusted
+server environment:
+
+```env
+CHUSKY_API_KEY=chsk_...
+```
+
+The dashboard never exposes `CHUSKY_PROJECT_KEY`; that Oracle-only root secret
+remains solely for trusted operator `/v1/admin/*` provisioning.
+
+## Contract and security
+
+- The SDK targets the versioned `/v1` Developer API described in [`docs/api-contract.md`](docs/api-contract.md). Do not point it at private `/cli/*` endpoints or use CLI device tokens as developer API keys.
+- `CHUSKY_PROJECT_KEY` is root-only: use it with `chusky.projects.create()` to provision a scoped `chsk_` project key. A developer stores that scoped key as `CHUSKY_API_KEY` in their own server environment. Project secrets are returned once, persisted only as hashes, may be rotated or revoked, and must never be exposed in browser code.
+- Durable POST operations should receive an `idempotencyKey`; retries only reuse a key for the exact same operation. Streaming run connections are intentionally not replayed: recover their persisted state through `get()` or `events()`.
+- Approval decisions always require an authenticated end-user context in the server. The SDK must never auto-approve a tool call.
+- `stream()` yields NDJSON events and supports `AbortSignal`, so consumers can stop a particular run without cancelling unrelated durable work.
+- The machine-readable API contract is [`openapi.yaml`](openapi.yaml).
+
+## Available resources
+
+`projects`, `threads`, `runs`, `tasks`, `approvals`, `files`, `webhooks`, `audit`, and `usage` are available today. Files use short-lived, direct Cloudflare R2 URLs: create an upload intent, upload with the returned URL, call `files.complete()`, then request a download URL. Webhook subscriptions are stored encrypted and return their signing secret exactly once; delivery retries and dead-letter administration remain a server-operations concern.

package/dist/client.d.ts

@@ -0,0 +1,113 @@
+import type { Approval, AuditEvent, ChuskyClientOptions, CreateRunParams, CreateThreadParams, DeveloperProject, FileDownload, FileRecord, FileUpload, Page, RequestOptions, Run, RunEvent, RunStreamEvent, Task, Thread, Usage, Webhook, WebhookDelivery } from "./types.js";
+export declare class Chusky {
+    readonly threads: ThreadsResource;
+    readonly tasks: TasksResource;
+    readonly approvals: ApprovalsResource;
+    readonly files: FilesResource;
+    readonly audit: AuditResource;
+    readonly webhooks: WebhooksResource;
+    readonly usage: UsageResource;
+    readonly projects: ProjectsResource;
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly userId;
+    private readonly fetchImpl;
+    private readonly timeoutMs;
+    private readonly userAgent;
+    constructor(options: ChuskyClientOptions);
+    request<T>(path: string, init?: RequestInit, options?: RequestOptions): Promise<T>;
+    /** @internal Shared transport for resource streams. */
+    streamRequest(path: string, init: RequestInit, options?: RequestOptions): Promise<{
+        response: Response;
+        dispose: () => void;
+    }>;
+}
+/** Trusted-server client for provisioning project keys. */
+export declare function createChuskyAdmin(options: Omit<ChuskyClientOptions, "userId"> & {
+    userId?: string;
+}): Chusky;
+export declare class ThreadsResource {
+    private readonly client;
+    constructor(client: Chusky);
+    create(params?: CreateThreadParams, options?: RequestOptions): Promise<Thread>;
+    get(threadId: string, options?: RequestOptions): Promise<Thread>;
+    list(params?: {
+        cursor?: string;
+        limit?: number;
+    }, options?: RequestOptions): Promise<Page<Thread>>;
+    runs(threadId: string): RunsResource;
+}
+export declare class RunsResource {
+    private readonly client;
+    private readonly threadId;
+    constructor(client: Chusky, threadId: string);
+    create(params: CreateRunParams, options?: RequestOptions): Promise<Run>;
+    get(runId: string, options?: RequestOptions): Promise<Run>;
+    list(params?: {
+        cursor?: string;
+        limit?: number;
+    }, options?: RequestOptions): Promise<Page<Run>>;
+    cancel(runId: string, options?: RequestOptions): Promise<Run>;
+    events(runId: string, after?: number, options?: RequestOptions): Promise<Page<RunEvent>>;
+    stream(params: Omit<CreateRunParams, "wait">, options?: RequestOptions): AsyncIterable<RunStreamEvent>;
+}
+export declare class TasksResource {
+    private readonly client;
+    constructor(client: Chusky);
+    get(taskId: string, options?: RequestOptions): Promise<Task>;
+    list(params?: {
+        cursor?: string;
+        limit?: number;
+    }, options?: RequestOptions): Promise<Page<Task>>;
+}
+export declare class ApprovalsResource {
+    private readonly client;
+    constructor(client: Chusky);
+    get(approvalId: string, options?: RequestOptions): Promise<Approval>;
+    decide(approvalId: string, decision: "approve" | "deny", options?: RequestOptions): Promise<Run>;
+}
+export declare class FilesResource {
+    private readonly client;
+    constructor(client: Chusky);
+    create(params: {
+        name: string;
+        contentType: string;
+        size: number;
+    }, options?: RequestOptions): Promise<FileUpload>;
+    complete(fileId: string, options?: RequestOptions): Promise<FileRecord>;
+    get(fileId: string, options?: RequestOptions): Promise<FileDownload>;
+    delete(fileId: string, options?: RequestOptions): Promise<void>;
+}
+export declare class AuditResource {
+    private readonly client;
+    constructor(client: Chusky);
+    list(after?: number, options?: RequestOptions): Promise<Page<AuditEvent>>;
+}
+export declare class WebhooksResource {
+    private readonly client;
+    constructor(client: Chusky);
+    create(url: string, options?: RequestOptions): Promise<Webhook>;
+    list(options?: RequestOptions): Promise<Page<Webhook>>;
+    deliveries(webhookId: string, options?: RequestOptions): Promise<Page<WebhookDelivery>>;
+    delete(webhookId: string, options?: RequestOptions): Promise<void>;
+}
+export declare class UsageResource {
+    private readonly client;
+    constructor(client: Chusky);
+    get(options?: RequestOptions): Promise<Usage>;
+}
+/** Root-key-only control plane for provisioning developer projects. */
+export declare class ProjectsResource {
+    private readonly client;
+    constructor(client: Chusky);
+    create(params: {
+        name: string;
+        scopes?: string[];
+    }, options?: RequestOptions): Promise<DeveloperProject>;
+    list(options?: RequestOptions): Promise<Page<DeveloperProject>>;
+    audit(after?: number, options?: RequestOptions): Promise<Page<AuditEvent>>;
+    updateScopes(projectId: string, scopes: string[], options?: RequestOptions): Promise<DeveloperProject>;
+    rotateKey(projectId: string, options?: RequestOptions): Promise<DeveloperProject>;
+    revoke(projectId: string, options?: RequestOptions): Promise<void>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,223 @@
+import { ChuskyAuthenticationError, ChuskyError, ChuskyRateLimitError } from "./errors.js";
+import { readNdjson } from "./stream.js";
+const DEFAULT_BASE_URL = "https://api.chusky.ai";
+export class Chusky {
+    threads;
+    tasks;
+    approvals;
+    files;
+    audit;
+    webhooks;
+    usage;
+    projects;
+    baseUrl;
+    apiKey;
+    userId;
+    fetchImpl;
+    timeoutMs;
+    userAgent;
+    constructor(options) {
+        if (!options.apiKey.trim())
+            throw new ChuskyError("apiKey is required");
+        if (!options.userId.trim())
+            throw new ChuskyError("userId is required");
+        this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+        this.apiKey = options.apiKey;
+        this.userId = options.userId;
+        this.fetchImpl = options.fetch ?? globalThis.fetch;
+        this.timeoutMs = options.timeoutMs ?? 30_000;
+        this.userAgent = options.userAgent ?? "chusky-typescript/0.1.0";
+        this.threads = new ThreadsResource(this);
+        this.tasks = new TasksResource(this);
+        this.approvals = new ApprovalsResource(this);
+        this.files = new FilesResource(this);
+        this.audit = new AuditResource(this);
+        this.webhooks = new WebhooksResource(this);
+        this.usage = new UsageResource(this);
+        this.projects = new ProjectsResource(this);
+    }
+    async request(path, init = {}, options = {}) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(new ChuskyError("Chusky request timed out")), this.timeoutMs);
+        const relayAbort = () => controller.abort(options.signal?.reason);
+        options.signal?.addEventListener("abort", relayAbort, { once: true });
+        try {
+            const headers = new Headers(init.headers);
+            headers.set("Authorization", `Bearer ${this.apiKey}`);
+            headers.set("X-Chusky-User-Id", this.userId);
+            headers.set("Accept", "application/json");
+            headers.set("User-Agent", this.userAgent);
+            if (init.body && !headers.has("Content-Type"))
+                headers.set("Content-Type", "application/json");
+            if (options.idempotencyKey)
+                headers.set("Idempotency-Key", options.idempotencyKey);
+            for (const [key, value] of new Headers(options.headers))
+                headers.set(key, value);
+            const response = await this.fetchImpl(`${this.baseUrl}/v1${path}`, { ...init, headers, signal: controller.signal });
+            if (!response.ok)
+                throw await toError(response);
+            if (response.status === 204)
+                return undefined;
+            return await response.json();
+        }
+        finally {
+            clearTimeout(timer);
+            options.signal?.removeEventListener("abort", relayAbort);
+        }
+    }
+    /** @internal Shared transport for resource streams. */
+    async streamRequest(path, init, options = {}) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(new ChuskyError("Chusky stream request timed out")), this.timeoutMs);
+        const relayAbort = () => controller.abort(options.signal?.reason);
+        options.signal?.addEventListener("abort", relayAbort, { once: true });
+        try {
+            const headers = new Headers(init.headers);
+            headers.set("Authorization", `Bearer ${this.apiKey}`);
+            headers.set("X-Chusky-User-Id", this.userId);
+            headers.set("Accept", "application/x-ndjson");
+            headers.set("User-Agent", this.userAgent);
+            headers.set("Content-Type", "application/json");
+            if (options.idempotencyKey)
+                headers.set("Idempotency-Key", options.idempotencyKey);
+            const response = await this.fetchImpl(`${this.baseUrl}/v1${path}`, { ...init, headers, signal: controller.signal });
+            if (!response.ok)
+                throw await toError(response);
+            return { response, dispose: () => options.signal?.removeEventListener("abort", relayAbort) };
+        }
+        catch (error) {
+            options.signal?.removeEventListener("abort", relayAbort);
+            throw error;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+/** Trusted-server client for provisioning project keys. */
+export function createChuskyAdmin(options) {
+    return new Chusky({ ...options, userId: options.userId ?? "operator" });
+}
+export class ThreadsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    create(params = {}, options) { return this.client.request("/threads", { method: "POST", body: JSON.stringify(params) }, options); }
+    get(threadId, options) { return this.client.request(`/threads/${encodeURIComponent(threadId)}`, {}, options); }
+    list(params = {}, options) {
+        const query = new URLSearchParams();
+        if (params.cursor)
+            query.set("cursor", params.cursor);
+        if (params.limit)
+            query.set("limit", String(params.limit));
+        return this.client.request(`/threads${query.size ? `?${query}` : ""}`, {}, options);
+    }
+    runs(threadId) { return new RunsResource(this.client, threadId); }
+}
+export class RunsResource {
+    client;
+    threadId;
+    constructor(client, threadId) {
+        this.client = client;
+        this.threadId = threadId;
+    }
+    create(params, options) { return this.client.request(`/threads/${encodeURIComponent(this.threadId)}/runs`, { method: "POST", body: JSON.stringify(params) }, options); }
+    get(runId, options) { return this.client.request(`/threads/${encodeURIComponent(this.threadId)}/runs/${encodeURIComponent(runId)}`, {}, options); }
+    list(params = {}, options) { const query = new URLSearchParams(); if (params.cursor)
+        query.set("cursor", params.cursor); if (params.limit)
+        query.set("limit", String(params.limit)); return this.client.request(`/threads/${encodeURIComponent(this.threadId)}/runs${query.size ? `?${query}` : ""}`, {}, options); }
+    cancel(runId, options) { return this.client.request(`/threads/${encodeURIComponent(this.threadId)}/runs/${encodeURIComponent(runId)}/cancel`, { method: "POST", body: "{}" }, options); }
+    events(runId, after, options) { return this.client.request(`/threads/${encodeURIComponent(this.threadId)}/runs/${encodeURIComponent(runId)}/events${after ? `?after=${after}` : ""}`, {}, options); }
+    async *stream(params, options = {}) {
+        const { response, dispose } = await this.client.streamRequest(`/threads/${encodeURIComponent(this.threadId)}/runs/stream`, { method: "POST", body: JSON.stringify(params) }, options);
+        try {
+            yield* readNdjson(response.body);
+        }
+        finally {
+            dispose();
+        }
+    }
+}
+export class TasksResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    get(taskId, options) { return this.client.request(`/tasks/${encodeURIComponent(taskId)}`, {}, options); }
+    list(params = {}, options) { const q = new URLSearchParams(); if (params.cursor)
+        q.set("cursor", params.cursor); if (params.limit)
+        q.set("limit", String(params.limit)); return this.client.request(`/tasks${q.size ? `?${q}` : ""}`, {}, options); }
+}
+export class ApprovalsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    get(approvalId, options) { return this.client.request(`/approvals/${encodeURIComponent(approvalId)}`, {}, options); }
+    decide(approvalId, decision, options) { return this.client.request(`/approvals/${encodeURIComponent(approvalId)}`, { method: "POST", body: JSON.stringify({ decision }) }, options); }
+}
+export class FilesResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    create(params, options) { return this.client.request("/files", { method: "POST", body: JSON.stringify(params) }, options); }
+    complete(fileId, options) { return this.client.request(`/files/${encodeURIComponent(fileId)}/complete`, { method: "POST", body: "{}" }, options); }
+    get(fileId, options) { return this.client.request(`/files/${encodeURIComponent(fileId)}`, {}, options); }
+    delete(fileId, options) { return this.client.request(`/files/${encodeURIComponent(fileId)}`, { method: "DELETE" }, options); }
+}
+export class AuditResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    list(after, options) { return this.client.request(`/audit-events${after ? `?after=${after}` : ""}`, {}, options); }
+}
+export class WebhooksResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    create(url, options) { return this.client.request("/webhooks", { method: "POST", body: JSON.stringify({ url }) }, options); }
+    list(options) { return this.client.request("/webhooks", {}, options); }
+    deliveries(webhookId, options) { return this.client.request(`/webhooks/${encodeURIComponent(webhookId)}/deliveries`, {}, options); }
+    delete(webhookId, options) { return this.client.request(`/webhooks/${encodeURIComponent(webhookId)}`, { method: "DELETE" }, options); }
+}
+export class UsageResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    get(options) { return this.client.request("/usage", {}, options); }
+}
+/** Root-key-only control plane for provisioning developer projects. */
+export class ProjectsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    create(params, options) { return this.client.request("/admin/projects", { method: "POST", body: JSON.stringify(params) }, options); }
+    list(options) { return this.client.request("/admin/projects", {}, options); }
+    audit(after, options) { return this.client.request(`/admin/audit-events${after ? `?after=${after}` : ""}`, {}, options); }
+    updateScopes(projectId, scopes, options) { return this.client.request(`/admin/projects/${encodeURIComponent(projectId)}`, { method: "PATCH", body: JSON.stringify({ scopes }) }, options); }
+    rotateKey(projectId, options) { return this.client.request(`/admin/projects/${encodeURIComponent(projectId)}/rotate-key`, { method: "POST", body: "{}" }, options); }
+    revoke(projectId, options) { return this.client.request(`/admin/projects/${encodeURIComponent(projectId)}`, { method: "DELETE" }, options); }
+}
+async function toError(response) {
+    const requestId = response.headers.get("x-request-id") ?? undefined;
+    const retryAfter = Number(response.headers.get("retry-after") ?? "") || undefined;
+    let body;
+    try {
+        body = await response.json();
+    }
+    catch { /* non-JSON error response */ }
+    const message = body?.error?.message ?? `Chusky API returned HTTP ${response.status}`;
+    const details = { status: response.status, code: body?.error?.code, requestId };
+    if (response.status === 401 || response.status === 403)
+        return new ChuskyAuthenticationError(message, details);
+    if (response.status === 429)
+        return new ChuskyRateLimitError(message, { ...details, retryAfter });
+    return new ChuskyError(message, details);
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,21 @@
+export declare class ChuskyError extends Error {
+    readonly status?: number;
+    readonly code?: string;
+    readonly requestId?: string;
+    constructor(message: string, options?: {
+        status?: number;
+        code?: string;
+        requestId?: string;
+        cause?: unknown;
+    });
+}
+export declare class ChuskyAuthenticationError extends ChuskyError {
+    constructor(message: string, options?: ConstructorParameters<typeof ChuskyError>[1]);
+}
+export declare class ChuskyRateLimitError extends ChuskyError {
+    readonly retryAfter?: number;
+    constructor(message: string, options?: ConstructorParameters<typeof ChuskyError>[1] & {
+        retryAfter?: number;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEhB,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAOnH;AAED,qBAAa,yBAA0B,SAAQ,WAAW;gBAC5C,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,qBAAqB,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAM;CACxF;AAED,qBAAa,oBAAqB,SAAQ,WAAW;IACnD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBACjB,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,qBAAqB,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO;CAClH"}

package/dist/errors.js

@@ -0,0 +1,20 @@
+export class ChuskyError extends Error {
+    status;
+    code;
+    requestId;
+    constructor(message, options = {}) {
+        super(message, { cause: options.cause });
+        this.name = "ChuskyError";
+        this.status = options.status;
+        this.code = options.code;
+        this.requestId = options.requestId;
+    }
+}
+export class ChuskyAuthenticationError extends ChuskyError {
+    constructor(message, options = {}) { super(message, options); this.name = "ChuskyAuthenticationError"; }
+}
+export class ChuskyRateLimitError extends ChuskyError {
+    retryAfter;
+    constructor(message, options = {}) { super(message, options); this.name = "ChuskyRateLimitError"; this.retryAfter = options.retryAfter; }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,MAAM,CAAU;IAChB,IAAI,CAAU;IACd,SAAS,CAAU;IAE5B,YAAY,OAAe,EAAE,UAAmF,EAAE;QAChH,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACrC,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,WAAW;IACxD,YAAY,OAAe,EAAE,UAAwD,EAAE,IAAI,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC,CAAC,CAAC;CAC/J;AAED,MAAM,OAAO,oBAAqB,SAAQ,WAAW;IAC1C,UAAU,CAAU;IAC7B,YAAY,OAAe,EAAE,UAAkF,EAAE,IAAI,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC,CAAC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;CAC1N"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { Chusky, createChuskyAdmin, ThreadsResource, RunsResource, TasksResource, ApprovalsResource, FilesResource, AuditResource, WebhooksResource, UsageResource, ProjectsResource } 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";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

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

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/stream.d.ts

@@ -0,0 +1,3 @@
+/** Parses NDJSON so a stream works in Node, browsers, workers, and edge runtimes. */
+export declare function readNdjson<T>(body: ReadableStream<Uint8Array> | null): AsyncIterable<T>;
+//# sourceMappingURL=stream.d.ts.map

package/dist/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"AAEA,qFAAqF;AACrF,wBAAuB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,CAoB9F"}

package/dist/stream.js

@@ -0,0 +1,31 @@
+import { ChuskyError } from "./errors.js";
+/** Parses NDJSON so a stream works in Node, browsers, workers, and edge runtimes. */
+export async function* readNdjson(body) {
+    if (!body)
+        throw new ChuskyError("Chusky returned an empty stream response");
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    let pending = "";
+    try {
+        while (true) {
+            const { value, done } = await reader.read();
+            pending += decoder.decode(value, { stream: !done });
+            let newline;
+            while ((newline = pending.indexOf("\n")) >= 0) {
+                const line = pending.slice(0, newline).trim();
+                pending = pending.slice(newline + 1);
+                if (line)
+                    yield JSON.parse(line);
+            }
+            if (done)
+                break;
+        }
+        const finalLine = pending.trim();
+        if (finalLine)
+            yield JSON.parse(finalLine);
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+//# sourceMappingURL=stream.js.map

package/dist/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,qFAAqF;AACrF,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,UAAU,CAAI,IAAuC;IAC1E,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,WAAW,CAAC,0CAA0C,CAAC,CAAC;IAC7E,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IAChC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5C,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;YACpD,IAAI,OAAe,CAAC;YACpB,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC9C,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;gBACrC,IAAI,IAAI;oBAAE,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;YACxC,CAAC;YACD,IAAI,IAAI;gBAAE,MAAM;QAClB,CAAC;QACD,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QACjC,IAAI,SAAS;YAAE,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAM,CAAC;IAClD,CAAC;YAAS,CAAC;QAAC,MAAM,CAAC,WAAW,EAAE,CAAC;IAAC,CAAC;AACrC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,180 @@
+export type JsonObject = Record<string, unknown>;
+export interface RequestOptions {
+    /** Cancels this request without cancelling other Chusky work. */
+    signal?: AbortSignal | null;
+    /** Required for POST operations that create or change durable state. */
+    idempotencyKey?: string;
+    /** Additional headers, useful for tracing or a staged API version. */
+    headers?: HeadersInit;
+}
+export interface Page<T> {
+    data: T[];
+    nextCursor?: string;
+}
+export interface FileUpload {
+    id: string;
+    name: string;
+    contentType: string;
+    size: number;
+    status: "pending" | "available" | "rejected";
+    uploadUrl: string;
+    expiresAt: string;
+}
+export interface FileDownload {
+    id: string;
+    name: string;
+    contentType: string;
+    size: number;
+    status: "pending" | "available" | "rejected";
+    downloadUrl: string;
+    expiresAt: string;
+}
+export interface FileRecord {
+    id: string;
+    name: string;
+    contentType: string;
+    size: number;
+    status: "pending" | "available" | "rejected";
+}
+export interface AuditEvent {
+    id: string;
+    action: string;
+    requestId: string;
+    status: number;
+    at: number;
+}
+export interface Webhook {
+    id: string;
+    url: string;
+    createdAt: string;
+    secret?: string;
+}
+export interface WebhookDelivery {
+    id: string;
+    status: "queued" | "delivering" | "delivered" | "failed";
+    attempts: number;
+    lastError?: string;
+    createdAt: string;
+    deliveredAt?: string;
+}
+export interface DeveloperProject {
+    id: string;
+    name: string;
+    keyPrefix: string;
+    scopes: string[];
+    createdAt: string;
+    revokedAt?: string;
+    key?: string;
+}
+export interface Usage {
+    messages: number;
+    cost: number;
+    files: {
+        count: number;
+        declaredBytes: number;
+        available: number;
+    };
+    runs: {
+        count: number;
+        active: number;
+    };
+    tasks: {
+        count: number;
+    };
+}
+export interface Thread {
+    id: string;
+    externalId?: string;
+    metadata: JsonObject;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateThreadParams {
+    externalId?: string;
+    metadata?: JsonObject;
+}
+export interface Run {
+    id: string;
+    threadId: string;
+    status: "queued" | "running" | "requires_approval" | "completed" | "failed" | "cancelled";
+    input: string;
+    output?: string;
+    taskId?: string;
+    approvalId?: string;
+    error?: {
+        code: string;
+        message: string;
+    };
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateRunParams {
+    input: string;
+    metadata?: JsonObject;
+    /** Wait for a terminal result. Use stream() for token-level progress. */
+    wait?: boolean;
+}
+export interface Task {
+    id: string;
+    status: "queued" | "running" | "blocked" | "completed" | "failed" | "cancelled";
+    title: string;
+    objective: string;
+    checkpoint?: string;
+    nextAction?: string;
+    result?: string;
+    error?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface Approval {
+    id: string;
+    status: "pending" | "approved" | "denied" | "consumed";
+    toolSlug: string;
+    args: JsonObject;
+    expiresAt: string;
+}
+export type RunStreamEvent = {
+    type: "run.started";
+    run: Run;
+} | {
+    type: "run.delta";
+    runId: string;
+    text: string;
+} | {
+    type: "run.tool_started";
+    runId: string;
+    toolSlug: string;
+} | {
+    type: "run.approval_required";
+    run: Run;
+    approval: Approval;
+} | {
+    type: "run.completed";
+    run: Run;
+} | {
+    type: "run.failed";
+    run: Run;
+    error: {
+        code: string;
+        message: string;
+    };
+} | {
+    type: "run.cancelled";
+    run: Run;
+};
+export interface RunEvent {
+    id: string;
+    type: string;
+    at: number;
+    text?: string;
+}
+export interface ChuskyClientOptions {
+    apiKey: string;
+    /** Stable developer-owned identifier for the end user whose Chusky state is used. */
+    userId: string;
+    baseUrl?: string;
+    fetch?: typeof globalThis.fetch;
+    timeoutMs?: number;
+    userAgent?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/docs/api-contract.md

@@ -0,0 +1,58 @@
+# Chusky Developer API v1 contract
+
+This document is the implementation contract for the SDK. It prevents the existing CLI service protocol from becoming an accidental public API.
+
+## Principles
+
+1. `/v1` is the only public prefix. Existing `/cli`, Telegram, channel, and workflow routes remain private transport endpoints.
+2. `CHUSKY_PROJECT_KEY` is the root bootstrap/admin key on the Oracle server. It creates project-scoped `chsk_` keys, returned once and persisted as hashes only. A developer puts their scoped key in `CHUSKY_API_KEY` in their own server environment. An end-user identifier is supplied in `X-Chusky-User-Id` and is never inferred from a phone number, display name, or channel identity. The first-party web dashboard may use its Better Auth session cookie for user-scoped `/v1` resources; API keys remain server-side credentials.
+3. Project keys are revocable and scope-enforced (`resource:read`, `resource:write`, `resource:*`, or `*`). Never use CLI device tokens for the SDK.
+4. Durable mutations accept `Idempotency-Key`; persist method, normalized path, body digest, response status/body, and a 24-hour replay window. A reused key with a different body returns `409 idempotency_mismatch`. Live streaming is not replayable; reconnect through persisted run state and events.
+5. Every response has `X-Request-Id`. Errors use `{ "error": { "code", "message", "requestId" } }`.
+6. Runs may require approval. The server persists the exact pending action and binds a decision to its end user; neither the SDK nor a webhook payload is authorization.
+
+## Dashboard API-key management
+
+Verified Better Auth users may manage only their own projects through
+`/v1/account/projects`. These cookie-authenticated routes create, list, update
+scopes, rotate, and revoke project keys. They never accept or return
+`CHUSKY_PROJECT_KEY`; raw `chsk_` keys are returned only by create and rotation.
+Each verified account may have at most 10 active projects. Root-created projects
+remain ownerless operator records and are not visible through account routes.
+
+## Resources
+
+| Resource | Endpoint | Notes |
+| --- | --- | --- |
+| Threads | `POST /v1/threads`, `GET /v1/threads/:threadId` | Conversation/memory boundary for one explicit SDK end user. |
+| Projects | `GET/POST /v1/admin/projects`, `DELETE /v1/admin/projects/:id` | Root-key-only project provisioning and key revocation. |
+| Dashboard projects | `GET/POST /v1/account/projects`, `PATCH /v1/account/projects/:id`, `POST .../rotate-key`, `DELETE .../:id` | Better-Auth-cookie-only, verified-user project management. |
+| Runs | `POST /v1/threads/:threadId/runs` | Executes durable Chusky work. `wait` is bounded. |
+| Run stream | `POST /v1/threads/:threadId/runs/stream` | `application/x-ndjson`; emits typed run events. |
+| Runs | `GET /v1/threads/:threadId/runs/:runId`, `POST .../cancel` | Cancellation is request-specific; durable task results stay queryable. |
+| Tasks | `GET /v1/tasks`, `GET /v1/tasks/:taskId` | Cursor pagination, project and end-user authorized. |
+| Approvals | `GET /v1/approvals/:approvalId`, `POST /v1/approvals/:approvalId` | Decision body is `{ decision: "approve" | "deny" }`. |
+| Files | `POST /v1/files`, `POST /v1/files/:fileId/complete`, `GET/DELETE /v1/files/:fileId` | Direct R2 upload URLs are short-lived; a `HEAD` verification must succeed before download; deletion is owner-scoped. |
+| Webhooks | `POST /v1/webhooks`, `GET /v1/webhooks`, `DELETE /v1/webhooks/:id` | HTTPS-only subscription; secret is encrypted at rest and returned only on creation. |
+| Delivery history | `GET /v1/webhooks/:id/deliveries` | Bounded, safe delivery status for operational diagnosis; delete disables future deliveries. |
+| Observability | `GET /v1/audit-events`, `GET /v1/usage` | Bounded per-user audit trail and current usage snapshot. |
+
+## Event stream
+
+The stream contains one JSON object per line and may emit:
+
+`run.started`, `run.delta`, `run.tool_started`, `run.approval_required`, `run.completed`, `run.failed`.
+
+Events are append-only for a single run. The terminal `completed` or `failed` event includes the canonical run record. Connections can be retried by querying the run; do not assume an interrupted stream means work failed.
+
+## Required test cases before enabling `/v1`
+
+- API-key malformed, revoked, expired, wrong-project, wrong-scope, and hash-only storage.
+- Idempotency replay and mismatch; retry after a lost response.
+- Cross-tenant thread/task/approval denial, including guessed IDs.
+- Stream ordering, client cancellation, backend failure, and reconnect-to-run status.
+- Approval expiry, exact-action binding, double-click race, and user/project mismatch.
+- Cursor tampering and stable pagination under new writes.
+- Per-project/end-user rate and spend limits, `429`/`Retry-After`, audit records, and request IDs.
+- R2 intent expiry, content-type/size verification, pending-file download denial, and tenant isolation.
+- Webhook signature verification, retry/backoff, endpoint disablement, and dead-letter replay.

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@chusky/sdk",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for Chusky's developer API.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist", "README.md", "docs", "LICENSE"],
+  "engines": { "node": ">=18" },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "tsx --test --test-concurrency=1 tests/*.test.ts",
+    "prepublishOnly": "npm run typecheck && npm run build && npm test"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0"
+  }
+}