@cana-ai/sdk 0.2.0

package/dist/index.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Cana Apps SDK — programmatic access.
+ *
+ *   import { Cana } from "@cana-ai/sdk";
+ *   const app = Cana.app("app_abc123");
+ *   const session = await app.start({ token: "eyJhbGc…" });
+ *   session.send("Hello");
+ *   session.on("delta", ({ text }) => process.stdout.write(text));
+ *   session.on("done", () => console.log("\\n[done]"));
+ *
+ * The SDK is intentionally framework-agnostic — no React, no DOM
+ * dependencies. It's the same wire protocol the embed.js widget
+ * speaks; if a customer wants to drive their own UI they import this.
+ */
+export interface AppOptions {
+    /** Override the API base. Defaults to https://cana.build (api is path-routed under the same host). */
+    apiBase?: string;
+    /** When the token expires (401), call this to mint a fresh one. */
+    refreshToken?: () => Promise<string>;
+}
+export interface StartOptions {
+    token: string;
+    /** Resume an existing session (skips POST /sessions). */
+    sessionId?: string;
+    /** Pre-emitted attachments — server may reject if file uploads disabled. */
+    attachments?: unknown[];
+}
+export interface SessionConfig {
+    sessionId: string;
+    variantId: string | null;
+    experimentId?: string;
+}
+export type SessionEvent = {
+    type: "delta";
+    text: string;
+} | {
+    type: "tool_use";
+    toolCallId: string;
+    toolName: string;
+    input: unknown;
+} | {
+    type: "tool_result";
+    toolCallId: string;
+    content: string;
+    isError?: boolean;
+} | {
+    type: "done";
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+    pausedNow: boolean;
+} | {
+    type: "error";
+    reason: string;
+    message?: string;
+};
+type EventHandler<E extends SessionEvent["type"]> = (ev: Extract<SessionEvent, {
+    type: E;
+}>) => void;
+declare class Session {
+    readonly sessionId: string;
+    readonly variantId: string | null;
+    readonly experimentId: string | undefined;
+    private app;
+    private listeners;
+    private abort;
+    constructor(app: App, cfg: SessionConfig);
+    on<E extends SessionEvent["type"]>(event: E, handler: EventHandler<E>): this;
+    off<E extends SessionEvent["type"]>(event: E, handler: EventHandler<E>): this;
+    private emit;
+    /** Send a user message + stream the model's reply. */
+    send(content: string, opts?: {
+        idempotencyKey?: string;
+    }): Promise<void>;
+    /** Abort an in-flight send. */
+    end(): void;
+    private consumeStream;
+    private parseEventBlock;
+}
+export declare class App {
+    readonly id: string;
+    readonly apiBase: string;
+    private token;
+    private refreshToken?;
+    constructor(id: string, opts?: AppOptions);
+    getToken(): string;
+    setToken(token: string): void;
+    /** Public-safe app config (branding + welcome + suggested prompts). */
+    config(): Promise<Record<string, unknown>>;
+    /** Start a session (or resume if `sessionId` provided). */
+    start(opts: StartOptions): Promise<Session>;
+    /** Internal — try the configured refresh callback and re-set the token. */
+    refreshIfPossible(): Promise<boolean>;
+}
+/** Namespace export — matches `Cana.app(id)` documented in the spec. */
+export declare const Cana: {
+    app(id: string, opts?: AppOptions): App;
+};
+export type { Session };
+//# 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":"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"}

package/dist/index.js

@@ -0,0 +1,244 @@
+/**
+ * Cana Apps SDK — programmatic access.
+ *
+ *   import { Cana } from "@cana-ai/sdk";
+ *   const app = Cana.app("app_abc123");
+ *   const session = await app.start({ token: "eyJhbGc…" });
+ *   session.send("Hello");
+ *   session.on("delta", ({ text }) => process.stdout.write(text));
+ *   session.on("done", () => console.log("\\n[done]"));
+ *
+ * The SDK is intentionally framework-agnostic — no React, no DOM
+ * dependencies. It's the same wire protocol the embed.js widget
+ * speaks; if a customer wants to drive their own UI they import this.
+ */
+// Default to the production cana host. The api is path-routed at
+// `${origin}/api/v1/...` via ingress — there is no separate
+// `api.cana.build` subdomain. Override via `apiBase` for staging /
+// self-hosted deployments.
+const DEFAULT_API_BASE = "https://cana.build";
+class Session {
+    sessionId;
+    variantId;
+    experimentId;
+    app;
+    listeners = new Map();
+    abort = null;
+    constructor(app, cfg) {
+        this.app = app;
+        this.sessionId = cfg.sessionId;
+        this.variantId = cfg.variantId;
+        this.experimentId = cfg.experimentId;
+    }
+    on(event, handler) {
+        const arr = this.listeners.get(event) ?? [];
+        arr.push(handler);
+        this.listeners.set(event, arr);
+        return this;
+    }
+    off(event, handler) {
+        const arr = this.listeners.get(event);
+        if (arr) {
+            const i = arr.indexOf(handler);
+            if (i >= 0)
+                arr.splice(i, 1);
+        }
+        return this;
+    }
+    emit(ev) {
+        const arr = this.listeners.get(ev.type);
+        if (!arr)
+            return;
+        for (const h of arr) {
+            try {
+                h(ev);
+            }
+            catch (err) {
+                console.error("[cana-sdk] handler threw:", err);
+            }
+        }
+    }
+    /** Send a user message + stream the model's reply. */
+    async send(content, opts) {
+        const ctrl = new AbortController();
+        this.abort = ctrl;
+        const headers = {
+            "Authorization": `Bearer ${this.app.getToken()}`,
+            "Content-Type": "application/json",
+            "Cana-Client": "sdk@0.1.0",
+        };
+        if (opts?.idempotencyKey)
+            headers["Idempotency-Key"] = opts.idempotencyKey;
+        let res;
+        try {
+            res = await fetch(`${this.app.apiBase}/api/v1/apps/${this.app.id}/messages`, {
+                method: "POST",
+                headers,
+                body: JSON.stringify({ sessionId: this.sessionId, content }),
+                signal: ctrl.signal,
+            });
+        }
+        catch (err) {
+            this.emit({ type: "error", reason: "network", message: err.message });
+            return;
+        }
+        if (res.status === 401) {
+            // Token expired/invalid — try a refresh + retry once.
+            const ok = await this.app.refreshIfPossible();
+            if (ok)
+                return this.send(content, opts);
+            this.emit({ type: "error", reason: res.headers.get("Cana-Reason") ?? "token_invalid" });
+            return;
+        }
+        if (!res.ok) {
+            let body = {};
+            try {
+                body = await res.json();
+            }
+            catch { /* not JSON */ }
+            this.emit({
+                type: "error",
+                reason: res.headers.get("Cana-Reason") ?? body.error ?? `http_${res.status}`,
+                message: body.message,
+            });
+            return;
+        }
+        if (!res.body) {
+            this.emit({ type: "error", reason: "empty_stream" });
+            return;
+        }
+        await this.consumeStream(res.body);
+    }
+    /** Abort an in-flight send. */
+    end() {
+        if (this.abort) {
+            this.abort.abort();
+            this.abort = null;
+        }
+    }
+    async consumeStream(body) {
+        const reader = body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = "";
+        while (true) {
+            const { value, done } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            let idx;
+            while ((idx = buffer.indexOf("\n\n")) !== -1) {
+                const raw = buffer.slice(0, idx);
+                buffer = buffer.slice(idx + 2);
+                this.parseEventBlock(raw);
+            }
+        }
+    }
+    parseEventBlock(block) {
+        if (!block.trim() || block.startsWith(":"))
+            return; // heartbeat / comment
+        let event = "message";
+        let data = "";
+        for (const line of block.split("\n")) {
+            if (line.startsWith("event:"))
+                event = line.slice(6).trim();
+            else if (line.startsWith("data:"))
+                data += line.slice(5).trim();
+        }
+        if (!data)
+            return;
+        let parsed;
+        try {
+            parsed = JSON.parse(data);
+        }
+        catch {
+            return;
+        }
+        switch (event) {
+            case "cana.app.delta":
+                this.emit({ type: "delta", text: parsed.text ?? "" });
+                break;
+            case "cana.app.tool_use":
+                this.emit({ type: "tool_use", toolCallId: parsed.toolCallId, toolName: parsed.toolName, input: parsed.input });
+                break;
+            case "cana.app.tool_result":
+                this.emit({ type: "tool_result", toolCallId: parsed.toolCallId, content: parsed.content, isError: parsed.isError });
+                break;
+            case "cana.app.done":
+                this.emit({ type: "done", usage: parsed.usage ?? { inputTokens: 0, outputTokens: 0 }, pausedNow: !!parsed.pausedNow });
+                break;
+            case "cana.app.error":
+                this.emit({ type: "error", reason: parsed.reason ?? "unknown_error", message: parsed.message });
+                break;
+        }
+    }
+}
+export class App {
+    id;
+    apiBase;
+    token = null;
+    refreshToken;
+    constructor(id, opts = {}) {
+        this.id = id;
+        this.apiBase = opts.apiBase ?? DEFAULT_API_BASE;
+        this.refreshToken = opts.refreshToken;
+    }
+    getToken() {
+        if (!this.token)
+            throw new Error("Call app.start({ token }) first.");
+        return this.token;
+    }
+    setToken(token) {
+        this.token = token;
+    }
+    /** Public-safe app config (branding + welcome + suggested prompts). */
+    async config() {
+        const res = await fetch(`${this.apiBase}/api/v1/apps/${this.id}/config`);
+        if (!res.ok)
+            throw new Error(`Failed to load app config (${res.status})`);
+        return res.json();
+    }
+    /** Start a session (or resume if `sessionId` provided). */
+    async start(opts) {
+        this.token = opts.token;
+        if (opts.sessionId) {
+            return new Session(this, {
+                sessionId: opts.sessionId,
+                variantId: null,
+            });
+        }
+        const res = await fetch(`${this.apiBase}/api/v1/apps/${this.id}/sessions`, {
+            method: "POST",
+            headers: {
+                "Authorization": `Bearer ${this.token}`,
+                "Content-Type": "application/json",
+                "Cana-Client": "sdk@0.1.0",
+            },
+            body: JSON.stringify({}),
+        });
+        if (!res.ok) {
+            const reason = res.headers.get("Cana-Reason") ?? "session_start_failed";
+            throw new Error(`Cana session failed: ${reason}`);
+        }
+        const data = (await res.json());
+        return new Session(this, data);
+    }
+    /** Internal — try the configured refresh callback and re-set the token. */
+    async refreshIfPossible() {
+        if (!this.refreshToken)
+            return false;
+        try {
+            this.token = await this.refreshToken();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+/** Namespace export — matches `Cana.app(id)` documented in the spec. */
+export const Cana = {
+    app(id, opts) {
+        return new App(id, opts);
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/openai/client.d.ts

@@ -0,0 +1,122 @@
+/**
+ * `CanaClient` — the OpenAI-compat SDK's main entry point.
+ *
+ *   import { CanaClient } from "@cana-ai/sdk/openai";
+ *
+ *   const client = new CanaClient({
+ *     appId: "app_abc",
+ *     signingKey: process.env.CANA_APP_KEY!,
+ *     apiBase: "https://cana.build",   // optional
+ *   });
+ *
+ *   // 1. Plain chat completion
+ *   const c = await client.chat.completions.create({
+ *     model: "openai/gpt-4o",
+ *     messages: [{ role: "user", content: "Hello" }],
+ *   });
+ *
+ *   // 2. Streaming
+ *   const s = await client.chat.completions.create({ ..., stream: true });
+ *   for await (const chunk of s) {
+ *     process.stdout.write(chunk.choices[0]?.delta.content ?? "");
+ *   }
+ *
+ *   // 3. Server-hosted MCP tools — discover + auto-dispatch
+ *   const mcpTools = await client.mcp.tools(["search", "shopify"]);
+ *   const r = await client.runWithMcp({
+ *     model: "anthropic/claude-haiku-4-5-20251001",
+ *     messages: […],
+ *     mcp: ["search", "shopify"],
+ *     maxRounds: 5,
+ *   });
+ *
+ *   // 4. Zod helper for typed structured output via response_format
+ *   const Person = z.object({ name: z.string(), age: z.number() });
+ *   const { result } = await client.chat.completions.generate({
+ *     model: "openai/gpt-4o",
+ *     messages: […],
+ *     schema: Person,
+ *   });
+ *   // result: { name: string; age: number }
+ */
+import { type ChatCompletion, type ChatCompletionChunk, type ChatCompletionRequest, type ChatMessage, type ChatTool } from "./types.js";
+export interface CanaClientOptions {
+    appId: string;
+    /** App signing key — `csk_live_…`. Never log this. */
+    signingKey: string;
+    /** Override the API base. Defaults to https://cana.build. */
+    apiBase?: string;
+    /** Override the global fetch (test injection). */
+    fetch?: typeof fetch;
+}
+export declare class CanaClient {
+    private readonly appId;
+    private readonly signingKey;
+    private readonly apiBase;
+    private readonly fetchImpl;
+    readonly chat: {
+        completions: {
+            create<T extends ChatCompletionRequest>(request: T): Promise<T extends {
+                stream: true;
+            } ? AsyncIterable<ChatCompletionChunk> : ChatCompletion>;
+            /** Convenience: structured output via `response_format` + Zod
+             *  parser. The schema is converted to JSON Schema via the
+             *  optional `zod-to-json-schema` peer dep; if unavailable,
+             *  caller must pre-convert. Returns the typed parsed object. */
+            generate<T>(args: {
+                model: string;
+                messages: ChatMessage[];
+                schema: {
+                    parse(value: unknown): T;
+                } & {
+                    _def?: any;
+                };
+                schemaName?: string;
+                temperature?: number;
+                max_tokens?: number;
+            }): Promise<{
+                result: T;
+                raw: ChatCompletion;
+            }>;
+        };
+    };
+    readonly mcp: {
+        tools(connectors: string[]): Promise<{
+            tools: ChatTool[];
+            dropped: string[];
+        }>;
+        execute(args: {
+            name: string;
+            arguments?: Record<string, unknown>;
+        }): Promise<{
+            result: unknown;
+            isError: boolean;
+            durationMs: number;
+        }>;
+    };
+    constructor(options: CanaClientOptions);
+    private chatCompletionsCreate;
+    private chatCompletionsGenerate;
+    private mcpToolsFetch;
+    private mcpExecuteOne;
+    runWithMcp(args: {
+        model: string;
+        messages: ChatMessage[];
+        /** Server-hosted MCP connector names to expose. */
+        mcp?: string[];
+        /** Additional client-defined tools to pass through to the
+         *  model alongside the MCP tools. The loop EXITS as soon as the
+         *  model calls one of these — the caller is responsible for
+         *  dispatching them and continuing the loop on their side. */
+        extraTools?: ChatTool[];
+        maxRounds?: number;
+        temperature?: number;
+        max_tokens?: number;
+    }): Promise<{
+        message: ChatMessage;
+        messages: ChatMessage[];
+        rounds: number;
+    }>;
+    private signedFetch;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/openai/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/openai/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAIH,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAChB,KAAK,QAAQ,EACd,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAID,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IAEzC,SAAgB,IAAI,EAAE;QACpB,WAAW,EAAE;YACX,MAAM,CAAC,CAAC,SAAS,qBAAqB,EACpC,OAAO,EAAE,CAAC,GACT,OAAO,CAAC,CAAC,SAAS;gBAAE,MAAM,EAAE,IAAI,CAAA;aAAE,GAAG,aAAa,CAAC,mBAAmB,CAAC,GAAG,cAAc,CAAC,CAAC;YAC7F;;;4EAGgE;YAChE,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE;gBAChB,KAAK,EAAE,MAAM,CAAC;gBACd,QAAQ,EAAE,WAAW,EAAE,CAAC;gBAExB,MAAM,EAAE;oBAAE,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,CAAA;iBAAE,GAAG;oBAAE,IAAI,CAAC,EAAE,GAAG,CAAA;iBAAE,CAAC;gBACtD,UAAU,CAAC,EAAE,MAAM,CAAC;gBACpB,WAAW,CAAC,EAAE,MAAM,CAAC;gBACrB,UAAU,CAAC,EAAE,MAAM,CAAC;aACrB,GAAG,OAAO,CAAC;gBAAE,MAAM,EAAE,CAAC,CAAC;gBAAC,GAAG,EAAE,cAAc,CAAA;aAAE,CAAC,CAAC;SACjD,CAAC;KACH,CAAC;IAEF,SAAgB,GAAG,EAAE;QACnB,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;YAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;YAAC,OAAO,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC,CAAC;QAC/E,OAAO,CAAC,IAAI,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;SAAE,GAAG,OAAO,CAAC;YAC5E,MAAM,EAAE,OAAO,CAAC;YAChB,OAAO,EAAE,OAAO,CAAC;YACjB,UAAU,EAAE,MAAM,CAAC;SACpB,CAAC,CAAC;KACJ,CAAC;gBAEU,OAAO,EAAE,iBAAiB;YAuBxB,qBAAqB;YAiBrB,uBAAuB;YAiCvB,aAAa;YAOb,aAAa;IAkBrB,UAAU,CAAC,IAAI,EAAE;QACrB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,WAAW,EAAE,CAAC;QACxB,mDAAmD;QACnD,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;QACf;;;sEAG8D;QAC9D,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAC;QACxB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,WAAW,CAAC;QAAC,QAAQ,EAAE,WAAW,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;YAgEhE,WAAW;CAqB1B"}

package/dist/openai/client.js

@@ -0,0 +1,264 @@
+/**
+ * `CanaClient` — the OpenAI-compat SDK's main entry point.
+ *
+ *   import { CanaClient } from "@cana-ai/sdk/openai";
+ *
+ *   const client = new CanaClient({
+ *     appId: "app_abc",
+ *     signingKey: process.env.CANA_APP_KEY!,
+ *     apiBase: "https://cana.build",   // optional
+ *   });
+ *
+ *   // 1. Plain chat completion
+ *   const c = await client.chat.completions.create({
+ *     model: "openai/gpt-4o",
+ *     messages: [{ role: "user", content: "Hello" }],
+ *   });
+ *
+ *   // 2. Streaming
+ *   const s = await client.chat.completions.create({ ..., stream: true });
+ *   for await (const chunk of s) {
+ *     process.stdout.write(chunk.choices[0]?.delta.content ?? "");
+ *   }
+ *
+ *   // 3. Server-hosted MCP tools — discover + auto-dispatch
+ *   const mcpTools = await client.mcp.tools(["search", "shopify"]);
+ *   const r = await client.runWithMcp({
+ *     model: "anthropic/claude-haiku-4-5-20251001",
+ *     messages: […],
+ *     mcp: ["search", "shopify"],
+ *     maxRounds: 5,
+ *   });
+ *
+ *   // 4. Zod helper for typed structured output via response_format
+ *   const Person = z.object({ name: z.string(), age: z.number() });
+ *   const { result } = await client.chat.completions.generate({
+ *     model: "openai/gpt-4o",
+ *     messages: […],
+ *     schema: Person,
+ *   });
+ *   // result: { name: string; age: number }
+ */
+import { signRequest } from "./sign.js";
+import { parseChunkStream } from "./streaming.js";
+import { CanaApiError, } from "./types.js";
+const DEFAULT_BASE = "https://cana.build";
+export class CanaClient {
+    appId;
+    signingKey;
+    apiBase;
+    fetchImpl;
+    chat;
+    mcp;
+    constructor(options) {
+        if (!options.appId)
+            throw new Error("CanaClient: appId is required");
+        if (!options.signingKey)
+            throw new Error("CanaClient: signingKey is required");
+        this.appId = options.appId;
+        this.signingKey = options.signingKey;
+        this.apiBase = (options.apiBase ?? DEFAULT_BASE).replace(/\/$/, "");
+        this.fetchImpl = options.fetch ?? globalThis.fetch;
+        this.chat = {
+            completions: {
+                create: (req) => this.chatCompletionsCreate(req),
+                generate: (args) => this.chatCompletionsGenerate(args),
+            },
+        };
+        this.mcp = {
+            tools: (connectors) => this.mcpToolsFetch(connectors),
+            execute: (args) => this.mcpExecuteOne(args),
+        };
+    }
+    // ─── chat/completions ───────────────────────────────────────
+    async chatCompletionsCreate(req) {
+        const body = JSON.stringify(req);
+        const res = await this.signedFetch({
+            path: "/openai/chat/completions",
+            body,
+            accept: req.stream ? "text/event-stream" : "application/json",
+        });
+        if (!res.ok)
+            await throwApiError(res);
+        if (req.stream) {
+            if (!res.body)
+                throw new Error("streaming response has no body");
+            return parseChunkStream(res.body);
+        }
+        return (await res.json());
+    }
+    async chatCompletionsGenerate(args) {
+        const jsonSchema = await zodLikeToJsonSchema(args.schema);
+        const raw = (await this.chatCompletionsCreate({
+            model: args.model,
+            messages: args.messages,
+            response_format: {
+                type: "json_schema",
+                json_schema: { name: args.schemaName ?? "Result", strict: true, schema: jsonSchema },
+            },
+            stream: false,
+            temperature: args.temperature,
+            max_tokens: args.max_tokens,
+        }));
+        const content = raw.choices[0]?.message.content;
+        if (typeof content !== "string")
+            throw new Error("generate(): no string content in response");
+        let parsed;
+        try {
+            parsed = JSON.parse(content);
+        }
+        catch {
+            throw new Error("generate(): model returned non-JSON content despite response_format");
+        }
+        const result = args.schema.parse(parsed);
+        return { result, raw };
+    }
+    // ─── mcp.* ──────────────────────────────────────────────────
+    async mcpToolsFetch(connectors) {
+        const body = JSON.stringify({ connectors });
+        const res = await this.signedFetch({ path: "/openai/mcp/tools", body });
+        if (!res.ok)
+            await throwApiError(res);
+        return (await res.json());
+    }
+    async mcpExecuteOne(args) {
+        const body = JSON.stringify(args);
+        const res = await this.signedFetch({ path: "/openai/mcp/execute", body });
+        if (!res.ok)
+            await throwApiError(res);
+        return (await res.json());
+    }
+    // ─── runWithMcp convenience loop ────────────────────────────
+    //
+    // Discovers MCP tools, runs chat/completions, on `tool_calls`
+    // dispatches any `mcp__*` named call via /openai/mcp/execute,
+    // appends as a `role:"tool"` message, and continues. Non-MCP
+    // tool_calls are surfaced to the caller by exiting the loop with
+    // the assistant message carrying those tool_calls.
+    //
+    // maxRounds caps the loop (default 5). Returns the final assistant
+    // message + the cumulative conversation.
+    async runWithMcp(args) {
+        const maxRounds = args.maxRounds ?? 5;
+        let { tools: mcpTools } = args.mcp && args.mcp.length > 0
+            ? await this.mcpToolsFetch(args.mcp)
+            : { tools: [] };
+        const tools = [...mcpTools, ...(args.extraTools ?? [])];
+        const convo = [...args.messages];
+        let round = 0;
+        while (round < maxRounds) {
+            round++;
+            const completion = (await this.chatCompletionsCreate({
+                model: args.model,
+                messages: convo,
+                tools: tools.length > 0 ? tools : undefined,
+                stream: false,
+                temperature: args.temperature,
+                max_tokens: args.max_tokens,
+            }));
+            const choice = completion.choices[0];
+            if (!choice) {
+                throw new Error("runWithMcp: upstream returned no choices");
+            }
+            const message = choice.message;
+            convo.push(message);
+            // No tool_calls — final answer. Exit.
+            if (!message.tool_calls || message.tool_calls.length === 0) {
+                return { message, messages: convo, rounds: round };
+            }
+            // Any non-mcp tool call → exit and hand back to caller. The
+            // caller dispatches in their own loop.
+            const hasNonMcp = message.tool_calls.some((tc) => !tc.function.name.startsWith("mcp__"));
+            if (hasNonMcp) {
+                return { message, messages: convo, rounds: round };
+            }
+            // All MCP — dispatch sequentially. Append each tool_result.
+            for (const tc of message.tool_calls) {
+                let parsedArgs;
+                try {
+                    parsedArgs = JSON.parse(tc.function.arguments);
+                }
+                catch {
+                    parsedArgs = {};
+                }
+                const result = await this.mcpExecuteOne({
+                    name: tc.function.name,
+                    arguments: parsedArgs,
+                });
+                convo.push({
+                    role: "tool",
+                    tool_call_id: tc.id,
+                    content: typeof result.result === "string" ? result.result : JSON.stringify(result.result),
+                });
+            }
+        }
+        // Loop cap reached → return the latest assistant message.
+        const last = convo[convo.length - 1] ?? convo[0];
+        if (!last)
+            throw new Error("runWithMcp: no messages in conversation");
+        return { message: last, messages: convo, rounds: round };
+    }
+    // ─── lower-level: signed fetch ──────────────────────────────
+    async signedFetch(args) {
+        const url = `${this.apiBase}/api/v1/apps/${this.appId}${args.path}`;
+        const { signatureHeader } = await signRequest({
+            signingKey: this.signingKey,
+            rawBody: args.body,
+        });
+        return this.fetchImpl(url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "X-Cana-App-Signature": signatureHeader,
+                Accept: args.accept ?? "application/json",
+            },
+            body: args.body,
+        });
+    }
+}
+// ─── helpers ──────────────────────────────────────────────────
+async function throwApiError(res) {
+    const text = await res.text();
+    let code = "internal";
+    let message = `request failed with HTTP ${res.status}`;
+    let retryable = res.status >= 500;
+    try {
+        const parsed = JSON.parse(text);
+        if (parsed.error) {
+            code = parsed.error.code ?? code;
+            message = parsed.error.message ?? message;
+            retryable = parsed.error.retryable ?? retryable;
+        }
+    }
+    catch { /* keep defaults */ }
+    const retryAfter = res.headers.get("retry-after");
+    throw new CanaApiError({
+        code,
+        message,
+        status: res.status,
+        retryable,
+        retryAfterSec: retryAfter ? Number(retryAfter) : undefined,
+    });
+}
+/**
+ * Best-effort Zod → JSON Schema bridge. Uses the optional peer-dep
+ * `zod-to-json-schema` if installed; throws a clear error if not.
+ * Allows consumers that DON'T use structured output to skip the dep.
+ */
+async function zodLikeToJsonSchema(schema) {
+    try {
+        const mod = await import(
+        /* @vite-ignore */
+        /* webpackIgnore: true */
+        "zod-to-json-schema");
+        const convert = mod.default
+            ?? mod.zodToJsonSchema;
+        if (!convert)
+            throw new Error("zod-to-json-schema exported an unexpected shape");
+        return convert(schema);
+    }
+    catch (err) {
+        throw new Error(`generate() requires \`zod-to-json-schema\` to be installed (peer dep). Original error: ${err.message}`);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/openai/client.js.map

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

package/dist/openai/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `@cana-ai/sdk/openai` — OpenAI-compatible proxy client for `/apps`.
+ *
+ * Distribution:
+ *   - npm:  `import { CanaClient } from "@cana-ai/sdk/openai"`
+ *   - browser script tag:
+ *       <script src="https://cana.build/sdk/openai.js"></script>
+ *       <script>
+ *         const c = new CanaOpenAI.CanaClient({ appId, signingKey });
+ *         c.chat.completions.create({...}).then(console.log);
+ *       </script>
+ *
+ * Web Crypto only — works on Node 18+, Cloudflare Workers, Deno,
+ * modern browsers. Zero `node:crypto` dependency at compile time.
+ *
+ * See ./client.ts for usage examples.
+ */
+export { CanaClient, type CanaClientOptions } from "./client.js";
+export { signRequest } from "./sign.js";
+export { parseChunkStream } from "./streaming.js";
+export { CanaApiError, type ChatMessage, type ChatToolCall, type ChatTool, type ChatToolChoice, type ChatCompletion, type ChatCompletionChunk, type ChatCompletionRequest, type ResponseFormat, type ResponseFormatJsonSchema, type CanaErrorBody, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/openai/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/openai/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EACL,YAAY,EACZ,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,wBAAwB,EAC7B,KAAK,aAAa,GACnB,MAAM,YAAY,CAAC"}

package/dist/openai/index.js

@@ -0,0 +1,22 @@
+/**
+ * `@cana-ai/sdk/openai` — OpenAI-compatible proxy client for `/apps`.
+ *
+ * Distribution:
+ *   - npm:  `import { CanaClient } from "@cana-ai/sdk/openai"`
+ *   - browser script tag:
+ *       <script src="https://cana.build/sdk/openai.js"></script>
+ *       <script>
+ *         const c = new CanaOpenAI.CanaClient({ appId, signingKey });
+ *         c.chat.completions.create({...}).then(console.log);
+ *       </script>
+ *
+ * Web Crypto only — works on Node 18+, Cloudflare Workers, Deno,
+ * modern browsers. Zero `node:crypto` dependency at compile time.
+ *
+ * See ./client.ts for usage examples.
+ */
+export { CanaClient } from "./client.js";
+export { signRequest } from "./sign.js";
+export { parseChunkStream } from "./streaming.js";
+export { CanaApiError, } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/openai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/openai/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,UAAU,EAA0B,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EACL,YAAY,GAWb,MAAM,YAAY,CAAC"}

package/dist/openai/sign.d.ts

@@ -0,0 +1,27 @@
+/**
+ * HMAC-SHA256 signing helper for the OpenAI-compat proxy.
+ *
+ * Uses Web Crypto only — works natively on Node 18+, Cloudflare
+ * Workers, Deno, modern browsers. No `node:crypto` import, so the SDK
+ * has zero Node-typings dependency at compile time.
+ *
+ * Canonical signed string (matches the route's `verifyIssuerSignature`):
+ *
+ *   `${unixMs}.${rawBodyUtf8}`
+ *
+ * Header format (matches the route's parser):
+ *
+ *   `X-Cana-App-Signature: t=<unix-ms>,v1=<hex>`
+ */
+/** Returns the signed string + header value for a given raw body. */
+export declare function signRequest(args: {
+    signingKey: string;
+    rawBody: string;
+    /** Override clock for tests. Defaults to Date.now(). */
+    timestampMs?: number;
+}): Promise<{
+    signatureHeader: string;
+    timestamp: number;
+    signatureHex: string;
+}>;
+//# sourceMappingURL=sign.d.ts.map

package/dist/openai/sign.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sign.d.ts","sourceRoot":"","sources":["../../src/openai/sign.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAsBH,qEAAqE;AACrE,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,CAQhF"}

package/dist/openai/sign.js

@@ -0,0 +1,37 @@
+/**
+ * HMAC-SHA256 signing helper for the OpenAI-compat proxy.
+ *
+ * Uses Web Crypto only — works natively on Node 18+, Cloudflare
+ * Workers, Deno, modern browsers. No `node:crypto` import, so the SDK
+ * has zero Node-typings dependency at compile time.
+ *
+ * Canonical signed string (matches the route's `verifyIssuerSignature`):
+ *
+ *   `${unixMs}.${rawBodyUtf8}`
+ *
+ * Header format (matches the route's parser):
+ *
+ *   `X-Cana-App-Signature: t=<unix-ms>,v1=<hex>`
+ */
+/** Compute the HMAC-SHA256 hex digest of `data` keyed by `secret`. */
+async function hmacSha256Hex(secret, data) {
+    const subtle = globalThis.crypto?.subtle;
+    if (!subtle) {
+        throw new Error("@cana-ai/sdk/openai requires Web Crypto (globalThis.crypto.subtle). Supported on Node 18+, Workers, Deno, modern browsers.");
+    }
+    const enc = new TextEncoder();
+    const key = await subtle.importKey("raw", enc.encode(secret), { name: "HMAC", hash: "SHA-256" }, false, ["sign"]);
+    const buf = await subtle.sign("HMAC", key, enc.encode(data));
+    return Array.from(new Uint8Array(buf), (b) => b.toString(16).padStart(2, "0")).join("");
+}
+/** Returns the signed string + header value for a given raw body. */
+export async function signRequest(args) {
+    const t = args.timestampMs ?? Date.now();
+    const sig = await hmacSha256Hex(args.signingKey, `${t}.${args.rawBody}`);
+    return {
+        signatureHeader: `t=${t},v1=${sig}`,
+        timestamp: t,
+        signatureHex: sig,
+    };
+}
+//# sourceMappingURL=sign.js.map

package/dist/openai/sign.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sign.js","sourceRoot":"","sources":["../../src/openai/sign.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,sEAAsE;AACtE,KAAK,UAAU,aAAa,CAAC,MAAc,EAAE,IAAY;IACvD,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC;IACzC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,4HAA4H,CAC7H,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,WAAW,EAAE,CAAC;IAC9B,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,SAAS,CAChC,KAAK,EACL,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,EAClB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,EACjC,KAAK,EACL,CAAC,MAAM,CAAC,CACT,CAAC;IACF,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAClG,CAAC;AAED,qEAAqE;AACrE,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAKjC;IACC,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;IACzC,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IACzE,OAAO;QACL,eAAe,EAAE,KAAK,CAAC,OAAO,GAAG,EAAE;QACnC,SAAS,EAAE,CAAC;QACZ,YAAY,EAAE,GAAG;KAClB,CAAC;AACJ,CAAC"}

package/dist/openai/streaming.d.ts

@@ -0,0 +1,18 @@
+/**
+ * SSE parser for the OpenAI Chat Completions chunk stream.
+ *
+ * The route emits verbatim `data: { ... }\n\n` chunks terminated by
+ * `data: [DONE]\n\n` — the OpenAI Chat Completions spec. This parser
+ * is intentionally minimal: it pulls `data:` payloads out of the
+ * `\n\n`-delimited frames, JSON-parses each one (skipping `[DONE]`),
+ * and yields them as OpenAI ChatCompletionChunk objects.
+ *
+ * Handles SSE comment lines (`: ping`) by ignoring them.
+ *
+ * The reader is a `ReadableStreamDefaultReader<Uint8Array>` from
+ * `Response.body.getReader()` so it works in any modern fetch env
+ * (Node 18+ / Workers / Deno / browser).
+ */
+import type { ChatCompletionChunk } from "./types.js";
+export declare function parseChunkStream(body: ReadableStream<Uint8Array>): AsyncGenerator<ChatCompletionChunk>;
+//# sourceMappingURL=streaming.d.ts.map

package/dist/openai/streaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../../src/openai/streaming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,wBAAuB,gBAAgB,CACrC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,GAC/B,cAAc,CAAC,mBAAmB,CAAC,CAgCrC"}

package/dist/openai/streaming.js

@@ -0,0 +1,55 @@
+/**
+ * SSE parser for the OpenAI Chat Completions chunk stream.
+ *
+ * The route emits verbatim `data: { ... }\n\n` chunks terminated by
+ * `data: [DONE]\n\n` — the OpenAI Chat Completions spec. This parser
+ * is intentionally minimal: it pulls `data:` payloads out of the
+ * `\n\n`-delimited frames, JSON-parses each one (skipping `[DONE]`),
+ * and yields them as OpenAI ChatCompletionChunk objects.
+ *
+ * Handles SSE comment lines (`: ping`) by ignoring them.
+ *
+ * The reader is a `ReadableStreamDefaultReader<Uint8Array>` from
+ * `Response.body.getReader()` so it works in any modern fetch env
+ * (Node 18+ / Workers / Deno / browser).
+ */
+export async function* parseChunkStream(body) {
+    const reader = body.getReader();
+    const dec = new TextDecoder();
+    let buffer = "";
+    for (;;) {
+        const { value, done } = await reader.read();
+        if (done)
+            break;
+        buffer += dec.decode(value, { stream: true });
+        let idx;
+        while ((idx = buffer.indexOf("\n\n")) >= 0) {
+            const frame = buffer.slice(0, idx);
+            buffer = buffer.slice(idx + 2);
+            // SSE comment-only frame (heartbeat) → skip.
+            if (frame.startsWith(":"))
+                continue;
+            const dataLines = [];
+            for (const line of frame.split("\n")) {
+                if (line.startsWith("data:"))
+                    dataLines.push(line.slice(5).trimStart());
+                // `event:` and `id:` are ignored — OpenAI chat completions
+                // doesn't use them on chunks.
+            }
+            if (dataLines.length === 0)
+                continue;
+            const data = dataLines.join("\n");
+            if (data === "[DONE]")
+                return;
+            try {
+                yield JSON.parse(data);
+            }
+            catch {
+                // Malformed JSON in a `data:` frame — skip and continue.
+                // The upstream provider's bug shouldn't kill the loop.
+                continue;
+            }
+        }
+    }
+}
+//# sourceMappingURL=streaming.js.map

package/dist/openai/streaming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.js","sourceRoot":"","sources":["../../src/openai/streaming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,gBAAgB,CACrC,IAAgC;IAEhC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IAChC,MAAM,GAAG,GAAG,IAAI,WAAW,EAAE,CAAC;IAC9B,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,SAAS,CAAC;QACR,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,IAAI;YAAE,MAAM;QAChB,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,IAAI,GAAW,CAAC;QAChB,OAAO,CAAC,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YACnC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;YAC/B,6CAA6C;YAC7C,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,SAAS;YACpC,MAAM,SAAS,GAAa,EAAE,CAAC;YAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrC,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;oBAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;gBACxE,2DAA2D;gBAC3D,8BAA8B;YAChC,CAAC;YACD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YACrC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClC,IAAI,IAAI,KAAK,QAAQ;gBAAE,OAAO;YAC9B,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAwB,CAAC;YAChD,CAAC;YAAC,MAAM,CAAC;gBACP,yDAAyD;gBACzD,uDAAuD;gBACvD,SAAS;YACX,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/openai/types.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Minimal OpenAI Chat Completions type surface — the SDK doesn't
+ * re-implement OpenAI's full schema, just enough for typed
+ * convenience. Callers using their own OpenAI types are free to
+ * cast.
+ */
+export interface ChatMessage {
+    role: "system" | "user" | "assistant" | "tool";
+    content: string | null | Array<{
+        type: "text";
+        text: string;
+    } | {
+        type: "image_url";
+        image_url: {
+            url: string;
+        };
+    }>;
+    tool_calls?: ChatToolCall[];
+    tool_call_id?: string;
+    name?: string;
+}
+export interface ChatToolCall {
+    id: string;
+    type: "function";
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+export interface ChatTool {
+    type: "function";
+    function: {
+        name: string;
+        description?: string;
+        parameters: Record<string, unknown>;
+    };
+}
+export type ChatToolChoice = "auto" | "none" | "required" | {
+    type: "function";
+    function: {
+        name: string;
+    };
+};
+export interface ResponseFormatJsonSchema {
+    type: "json_schema";
+    json_schema: {
+        name: string;
+        strict?: boolean;
+        schema: Record<string, unknown>;
+    };
+}
+export type ResponseFormat = {
+    type: "text";
+} | {
+    type: "json_object";
+} | ResponseFormatJsonSchema;
+export interface ChatCompletionRequest {
+    model: string;
+    messages: ChatMessage[];
+    tools?: ChatTool[];
+    tool_choice?: ChatToolChoice;
+    response_format?: ResponseFormat;
+    stream?: boolean;
+    max_tokens?: number;
+    temperature?: number;
+    top_p?: number;
+    stop?: string | string[];
+}
+export interface ChatCompletion {
+    id: string;
+    object: "chat.completion";
+    created: number;
+    model: string;
+    choices: Array<{
+        index: number;
+        message: ChatMessage;
+        finish_reason: "stop" | "length" | "tool_calls" | "content_filter" | null;
+    }>;
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+}
+export interface ChatCompletionChunk {
+    id: string;
+    object: "chat.completion.chunk";
+    created: number;
+    model: string;
+    choices: Array<{
+        index: number;
+        delta: Partial<ChatMessage>;
+        finish_reason: "stop" | "length" | "tool_calls" | "content_filter" | null;
+    }>;
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+}
+/** Server-side error shape — matches the route's `makeErrorBody`. */
+export interface CanaErrorBody {
+    error: {
+        code: string;
+        message: string;
+        retryable: boolean;
+    };
+}
+export declare class CanaApiError extends Error {
+    readonly code: string;
+    readonly status: number;
+    readonly retryable: boolean;
+    readonly retryAfterSec: number | undefined;
+    constructor(args: {
+        code: string;
+        message: string;
+        status: number;
+        retryable: boolean;
+        retryAfterSec?: number;
+    });
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/openai/types.d.ts.map

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

package/dist/openai/types.js

@@ -0,0 +1,21 @@
+/**
+ * Minimal OpenAI Chat Completions type surface — the SDK doesn't
+ * re-implement OpenAI's full schema, just enough for typed
+ * convenience. Callers using their own OpenAI types are free to
+ * cast.
+ */
+export class CanaApiError extends Error {
+    code;
+    status;
+    retryable;
+    retryAfterSec;
+    constructor(args) {
+        super(args.message);
+        this.name = "CanaApiError";
+        this.code = args.code;
+        this.status = args.status;
+        this.retryable = args.retryable;
+        this.retryAfterSec = args.retryAfterSec;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/openai/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/openai/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkFH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrB,IAAI,CAAS;IACb,MAAM,CAAS;IACf,SAAS,CAAU;IACnB,aAAa,CAAqB;IAClD,YAAY,IAAmG;QAC7G,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;IAC1C,CAAC;CACF"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@cana-ai/sdk",
+  "version": "0.2.0",
+  "description": "Cana Apps SDK — programmatic access for embedders who drive their own UI.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./openai": {
+      "types": "./dist/openai/index.d.ts",
+      "import": "./dist/openai/index.js"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "prepublishOnly": "pnpm run build",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "peerDependencies": {
+    "zod-to-json-schema": "^3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "zod-to-json-schema": { "optional": true }
+  },
+  "devDependencies": {
+    "typescript": "^5.8.3",
+    "vitest": "^3.0.0",
+    "zod": "^3.24.1",
+    "zod-to-json-schema": "^3.24.0"
+  }
+}