@baobox/sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bright Qi
+
+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,125 @@
+# @baobox/sdk
+
+TypeScript HTTP client for [Baobox](https://baobox.au) — an AI integration platform providing an agent runtime, eval engine, and observability trail.
+
+This package is a thin wrapper around Baobox's REST API. It has zero business logic — all intelligence lives server-side. Making it public removes friction for partners and third-party users while keeping the runtime closed.
+
+## Installation
+
+```bash
+npm install @baobox/sdk
+# or
+pnpm add @baobox/sdk
+```
+
+Requires Node.js 18+ (relies on native `fetch`).
+
+## Quick start
+
+```typescript
+import { BaoboxClient } from "@baobox/sdk";
+
+const sb = new BaoboxClient({
+  endpoint: "https://baobox-jv1.example.workers.dev",
+  apiKey: process.env.BAOBOX_API_KEY!,
+});
+
+const res = await sb.chat({
+  skillId: "sk_document_chaser",
+  message: "Review cli_01 and take whatever action is needed.",
+  sessionId: "ses_cli_01",
+});
+
+console.log(res.response);          // "Sent chase email for bank_statement, payroll..."
+console.log(res.meta.requestId);    // "req_abc123" — matches server log
+console.log(res.meta.trace);        // [{ toolName, input, output, latencyMs }, ...]
+```
+
+## API surface
+
+### Chat
+
+```typescript
+const res = await sb.chat({
+  skillId: "sk_chase",
+  message: "...",
+  sessionId: "ses_1",                         // optional
+  metadata: { source: "kanban" },             // optional, forwarded to trace
+});
+```
+
+Returns `{ response, usage: { inputTokens, outputTokens }, sessionId, meta }` where `meta` carries `requestId`, `latencyMs`, `model`, and an optional `trace` array.
+
+### Sessions
+
+```typescript
+const session = await sb.sessions.create({ skillId: "sk_chase" });
+const history = await sb.sessions.messages(session.id);
+```
+
+### Admin (requires admin token)
+
+```typescript
+await sb.admin.skills.upsert({
+  id: "sk_chase",
+  name: "Document Chaser",
+  systemPrompt: "...",
+  model: "MiniMax-M2.7",
+  tools: ["lookup_client_docs", "send_client_email"],
+});
+
+await sb.admin.tools.upsert({
+  name: "lookup_client_docs",
+  description: "...",
+  inputSchema: { type: "object", properties: { /* ... */ } },
+  handlerType: "http",
+  handlerConfig: { url: "https://backend.example.com/tools/lookup", /* ... */ },
+});
+```
+
+### Events (trace)
+
+```typescript
+const events = await sb.events.list({ sessionId: "ses_1", limit: 50 });
+```
+
+## Error handling
+
+Every non-2xx response throws `BaoboxError`:
+
+```typescript
+import { BaoboxError } from "@baobox/sdk";
+
+try {
+  await sb.chat({ skillId: "sk_missing", message: "..." });
+} catch (err) {
+  if (err instanceof BaoboxError) {
+    console.error(err.status);       // 404
+    console.error(err.code);         // "SKILL_NOT_FOUND"
+    console.error(err.requestId);    // server-side request id for log correlation
+  }
+}
+```
+
+Network failures surface as `BaoboxError` with `status: 0` and `code: "NETWORK"`; timeouts as `code: "TIMEOUT"`.
+
+## Configuration
+
+```typescript
+new BaoboxClient({
+  endpoint: "...",     // required — Baobox worker URL
+  apiKey: "...",       // required
+  orgId: "firm_a",     // optional, observability tag
+  fetch: myFetch,      // optional, injects custom fetch (tests / edge runtimes)
+  timeoutMs: 30_000,   // optional, default 30s. Set 0 to disable.
+});
+```
+
+## License
+
+MIT. See [LICENSE](./LICENSE).
+
+## Related
+
+- Tech Arch §4 — full SDK design rationale (Baobox internal doc)
+- [Adoptive Co](https://adoptive.co) — consultancy using Baobox as a delivery tool

package/dist/errors.d.ts

@@ -0,0 +1,8 @@
+export declare class BaoboxError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly requestId: string | null;
+    readonly body: unknown;
+    constructor(status: number, code: string, message: string, requestId: string | null, body: unknown);
+}
+//# 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":"AAGA,qBAAa,WAAY,SAAQ,KAAK;IACpC,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,SAAgB,IAAI,EAAE,OAAO,CAAC;gBAG5B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,IAAI,EAAE,OAAO;CAShB"}

package/dist/errors.js

@@ -0,0 +1,18 @@
+// SDK-specific error class. Thrown for any non-2xx response; carries the
+// HTTP status, the server's error code + message when available, and the
+// Baobox request_id so callers can correlate with server logs.
+export class BaoboxError extends Error {
+    status;
+    code;
+    requestId;
+    body;
+    constructor(status, code, message, requestId, body) {
+        super(message);
+        this.name = "BaoboxError";
+        this.status = status;
+        this.code = code;
+        this.requestId = requestId;
+        this.body = body;
+    }
+}
+//# 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,yEAAyE;AACzE,yEAAyE;AACzE,+DAA+D;AAC/D,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpB,MAAM,CAAS;IACf,IAAI,CAAS;IACb,SAAS,CAAgB;IACzB,IAAI,CAAU;IAE9B,YACE,MAAc,EACd,IAAY,EACZ,OAAe,EACf,SAAwB,EACxB,IAAa;QAEb,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+import type { ChatRequest, ChatResponse, Event, EventListRequest, Session, SessionMessage, Skill, BaoboxClientOptions, SkillUpsertRequest, Tool, ToolUpsertRequest } from "./types.js";
+export { BaoboxError } from "./errors.js";
+export type * from "./types.js";
+export declare class BaoboxClient {
+    private readonly endpoint;
+    private readonly apiKey;
+    private readonly fetch;
+    private readonly timeoutMs;
+    readonly admin: {
+        skills: {
+            upsert: (req: SkillUpsertRequest) => Promise<Skill>;
+        };
+        tools: {
+            upsert: (req: ToolUpsertRequest) => Promise<Tool>;
+        };
+    };
+    readonly sessions: {
+        create: (req: {
+            skillId: string;
+        }) => Promise<Session>;
+        messages: (sessionId: string) => Promise<SessionMessage[]>;
+    };
+    readonly events: {
+        list: (req: EventListRequest) => Promise<Event[]>;
+    };
+    constructor(opts: BaoboxClientOptions);
+    chat(req: ChatRequest): Promise<ChatResponse>;
+    private createSession;
+    private listMessages;
+    private upsertSkill;
+    private upsertTool;
+    private listEvents;
+    private request;
+}
+//# 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":"AAMA,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,KAAK,EACL,gBAAgB,EAEhB,OAAO,EACP,cAAc,EACd,KAAK,EACL,mBAAmB,EACnB,kBAAkB,EAClB,IAAI,EACJ,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,mBAAmB,YAAY,CAAC;AAIhC,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAKnC,SAAgB,KAAK,EAAE;QACrB,MAAM,EAAE;YAAE,MAAM,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,OAAO,CAAC,KAAK,CAAC,CAAA;SAAE,CAAC;QAChE,KAAK,EAAE;YAAE,MAAM,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;SAAE,CAAC;KAC9D,CAAC;IACF,SAAgB,QAAQ,EAAE;QACxB,MAAM,EAAE,CAAC,GAAG,EAAE;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;QACvD,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;KAC5D,CAAC;IACF,SAAgB,MAAM,EAAE;QACtB,IAAI,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;KACnD,CAAC;gBAEU,IAAI,EAAE,mBAAmB;IA2B/B,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;YAwBrC,aAAa;YAiBb,YAAY;YAuBZ,WAAW;YAsCX,UAAU;YA6BV,UAAU;YAkCV,OAAO;CAoFtB"}

package/dist/index.js

@@ -0,0 +1,210 @@
+// @baobox/sdk — thin HTTP client for the Baobox runtime.
+// No business logic here — everything smart lives server-side. This file
+// is ~300 lines on purpose; if it grows past ~500, something that belongs
+// in the runtime has leaked out.
+import { BaoboxError } from "./errors.js";
+export { BaoboxError } from "./errors.js";
+export class BaoboxClient {
+    endpoint;
+    apiKey;
+    fetch;
+    timeoutMs;
+    // `admin` and `events` are pseudo-namespaces — just method bundles so
+    // call sites read as `sb.admin.skills.upsert(...)` rather than a flat
+    // `sb.upsertSkill(...)`. Matches Tech Arch §4.2.
+    admin;
+    sessions;
+    events;
+    constructor(opts) {
+        if (!opts.endpoint)
+            throw new Error("BaoboxClient: endpoint required");
+        if (!opts.apiKey)
+            throw new Error("BaoboxClient: apiKey required");
+        this.endpoint = opts.endpoint.replace(/\/+$/, "");
+        this.apiKey = opts.apiKey;
+        this.fetch = opts.fetch ?? globalThis.fetch;
+        this.timeoutMs = opts.timeoutMs ?? 30_000;
+        this.admin = {
+            skills: {
+                upsert: (req) => this.upsertSkill(req),
+            },
+            tools: {
+                upsert: (req) => this.upsertTool(req),
+            },
+        };
+        this.sessions = {
+            create: (req) => this.createSession(req),
+            messages: (id) => this.listMessages(id),
+        };
+        this.events = {
+            list: (req) => this.listEvents(req),
+        };
+    }
+    // --- Chat (core) ---
+    async chat(req) {
+        const body = await this.request("POST", "/api/v1/chat", {
+            skill_id: req.skillId,
+            message: req.message,
+            session_id: req.sessionId,
+            metadata: req.metadata,
+        });
+        return {
+            response: body.data.response,
+            usage: {
+                inputTokens: body.data.usage.input_tokens,
+                outputTokens: body.data.usage.output_tokens,
+            },
+            sessionId: body.data.session_id,
+            meta: body.meta,
+        };
+    }
+    // --- Sessions ---
+    async createSession(req) {
+        const body = await this.request("POST", "/api/v1/sessions", { skill_id: req.skillId });
+        return {
+            id: body.data.id,
+            skillId: body.data.skill_id,
+            tenantId: body.data.tenant_id,
+            createdAt: body.data.created_at,
+            updatedAt: body.data.updated_at,
+        };
+    }
+    async listMessages(sessionId) {
+        const body = await this.request("GET", `/api/v1/sessions/${encodeURIComponent(sessionId)}/messages`);
+        return body.data.map((m) => ({
+            id: m.id,
+            sessionId: m.session_id,
+            role: m.role,
+            content: m.content,
+            tokenCount: m.token_count,
+            createdAt: m.created_at,
+        }));
+    }
+    // --- Admin: skills ---
+    async upsertSkill(req) {
+        const body = await this.request("POST", "/api/v1/admin/skills", {
+            id: req.id,
+            name: req.name,
+            description: req.description,
+            system_prompt: req.systemPrompt,
+            model: req.model,
+            temperature: req.temperature,
+            max_tokens: req.maxTokens,
+            tools: req.tools,
+        });
+        return {
+            id: body.data.id,
+            name: body.data.name,
+            description: body.data.description,
+            systemPrompt: body.data.system_prompt,
+            model: body.data.model,
+            temperature: body.data.temperature,
+            maxTokens: body.data.max_tokens,
+            tenantId: body.data.tenant_id,
+            createdAt: body.data.created_at,
+            updatedAt: body.data.updated_at,
+        };
+    }
+    // --- Admin: tools ---
+    async upsertTool(req) {
+        const body = await this.request("POST", "/api/v1/admin/tools", {
+            name: req.name,
+            description: req.description,
+            input_schema: req.inputSchema,
+            handler_type: req.handlerType,
+            handler_config: req.handlerConfig,
+        });
+        return {
+            id: body.data.id,
+            name: body.data.name,
+            description: body.data.description,
+            inputSchema: body.data.input_schema,
+            handlerType: body.data.handler_type,
+            handlerConfig: body.data.handler_config,
+            createdAt: body.data.created_at,
+        };
+    }
+    // --- Events ---
+    async listEvents(req) {
+        const qs = new URLSearchParams({ session_id: req.sessionId });
+        if (req.limit !== undefined)
+            qs.set("limit", String(req.limit));
+        if (req.after !== undefined)
+            qs.set("after", req.after);
+        const body = await this.request("GET", `/api/v1/events?${qs.toString()}`);
+        return body.data.map((e) => ({
+            id: e.id,
+            sessionId: e.session_id,
+            requestId: e.request_id,
+            eventType: e.event_type,
+            content: e.content,
+            metadata: safeParseJson(e.metadata),
+            tokenCount: e.token_count,
+            latencyMs: e.latency_ms,
+            parentEventId: e.parent_event_id,
+            createdAt: e.created_at,
+        }));
+    }
+    // --- core request plumbing ---
+    async request(method, path, body) {
+        const url = `${this.endpoint}${path}`;
+        const controller = new AbortController();
+        const timer = this.timeoutMs > 0
+            ? setTimeout(() => controller.abort(), this.timeoutMs)
+            : null;
+        let res;
+        try {
+            res = await this.fetch(url, {
+                method,
+                headers: {
+                    authorization: `Bearer ${this.apiKey}`,
+                    ...(body !== undefined ? { "content-type": "application/json" } : {}),
+                },
+                body: body !== undefined ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+        }
+        catch (err) {
+            const isAbort = err instanceof DOMException && err.name === "AbortError";
+            throw new BaoboxError(0, isAbort ? "TIMEOUT" : "NETWORK", isAbort
+                ? `Request to ${path} timed out after ${this.timeoutMs}ms`
+                : `Network error calling ${path}: ${String(err)}`, null, null);
+        }
+        finally {
+            if (timer)
+                clearTimeout(timer);
+        }
+        const text = await res.text();
+        const parsed = text.length ? safeParseJson(text) : {};
+        if (!res.ok) {
+            const errObj = parsed.error;
+            throw new BaoboxError(res.status, errObj?.code ?? "HTTP_ERROR", errObj?.message ?? res.statusText, errObj?.request_id ?? null, parsed);
+        }
+        const envelope = parsed;
+        return {
+            data: envelope.data,
+            meta: envelope.metadata
+                ? {
+                    requestId: envelope.metadata.request_id,
+                    latencyMs: envelope.metadata.latency_ms,
+                    model: envelope.metadata.model,
+                    trace: envelope.metadata.trace?.map((t) => ({
+                        toolName: t.tool_name,
+                        input: t.input,
+                        output: t.output,
+                        latencyMs: t.latency_ms,
+                    })),
+                }
+                : { requestId: "", latencyMs: 0 },
+        };
+    }
+}
+function safeParseJson(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return {};
+    }
+}
+//# 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,yDAAyD;AACzD,yEAAyE;AACzE,0EAA0E;AAC1E,iCAAiC;AAEjC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAgB1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK1C,MAAM,OAAO,YAAY;IACN,QAAQ,CAAS;IACjB,MAAM,CAAS;IACf,KAAK,CAAU;IACf,SAAS,CAAS;IAEnC,sEAAsE;IACtE,sEAAsE;IACtE,iDAAiD;IACjC,KAAK,CAGnB;IACc,QAAQ,CAGtB;IACc,MAAM,CAEpB;IAEF,YAAY,IAAyB;QACnC,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACvE,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC;QAC5C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC;QAE1C,IAAI,CAAC,KAAK,GAAG;YACX,MAAM,EAAE;gBACN,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC;aACvC;YACD,KAAK,EAAE;gBACL,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;aACtC;SACF,CAAC;QACF,IAAI,CAAC,QAAQ,GAAG;YACd,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC;YACxC,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;SACxC,CAAC;QACF,IAAI,CAAC,MAAM,GAAG;YACZ,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;SACpC,CAAC;IACJ,CAAC;IAED,sBAAsB;IAEtB,KAAK,CAAC,IAAI,CAAC,GAAgB;QACzB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAI5B,MAAM,EAAE,cAAc,EAAE;YACzB,QAAQ,EAAE,GAAG,CAAC,OAAO;YACrB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,UAAU,EAAE,GAAG,CAAC,SAAS;YACzB,QAAQ,EAAE,GAAG,CAAC,QAAQ;SACvB,CAAC,CAAC;QACH,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ;YAC5B,KAAK,EAAE;gBACL,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY;gBACzC,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa;aAC5C;YACD,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU;YAC/B,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC;IACJ,CAAC;IAED,mBAAmB;IAEX,KAAK,CAAC,aAAa,CAAC,GAAwB;QAClD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAM5B,MAAM,EAAE,kBAAkB,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1D,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;YAChB,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ;YAC3B,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS;YAC7B,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU;YAC/B,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU;SAChC,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,SAAiB;QAC1C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAS7B,KAAK,EAAE,oBAAoB,kBAAkB,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QACvE,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3B,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,SAAS,EAAE,CAAC,CAAC,UAAU;YACvB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,UAAU,EAAE,CAAC,CAAC,WAAW;YACzB,SAAS,EAAE,CAAC,CAAC,UAAU;SACxB,CAAC,CAAC,CAAC;IACN,CAAC;IAED,wBAAwB;IAEhB,KAAK,CAAC,WAAW,CAAC,GAAuB;QAC/C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAW5B,MAAM,EAAE,sBAAsB,EAAE;YACjC,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,aAAa,EAAE,GAAG,CAAC,YAAY;YAC/B,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,UAAU,EAAE,GAAG,CAAC,SAAS;YACzB,KAAK,EAAE,GAAG,CAAC,KAAK;SACjB,CAAC,CAAC;QACH,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;YAChB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;YACpB,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW;YAClC,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa;YACrC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK;YACtB,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW;YAClC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU;YAC/B,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS;YAC7B,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU;YAC/B,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU;SAChC,CAAC;IACJ,CAAC;IAED,uBAAuB;IAEf,KAAK,CAAC,UAAU,CAAC,GAAsB;QAC7C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAQ5B,MAAM,EAAE,qBAAqB,EAAE;YAChC,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,YAAY,EAAE,GAAG,CAAC,WAAW;YAC7B,YAAY,EAAE,GAAG,CAAC,WAAW;YAC7B,cAAc,EAAE,GAAG,CAAC,aAAa;SAClC,CAAC,CAAC;QACH,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;YAChB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;YACpB,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW;YAClC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY;YACnC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY;YACnC,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc;YACvC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU;SAChC,CAAC;IACJ,CAAC;IAED,iBAAiB;IAET,KAAK,CAAC,UAAU,CAAC,GAAqB;QAC5C,MAAM,EAAE,GAAG,IAAI,eAAe,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;QAC9D,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS;YAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;QAChE,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS;YAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;QACxD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAa7B,KAAK,EAAE,kBAAkB,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3B,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,SAAS,EAAE,CAAC,CAAC,UAAU;YACvB,SAAS,EAAE,CAAC,CAAC,UAAU;YACvB,SAAS,EAAE,CAAC,CAAC,UAAU;YACvB,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,QAAQ,CAA4B;YAC9D,UAAU,EAAE,CAAC,CAAC,WAAW;YACzB,SAAS,EAAE,CAAC,CAAC,UAAU;YACvB,aAAa,EAAE,CAAC,CAAC,eAAe;YAChC,SAAS,EAAE,CAAC,CAAC,UAAU;SACxB,CAAC,CAAC,CAAC;IACN,CAAC;IAED,gCAAgC;IAExB,KAAK,CAAC,OAAO,CACnB,MAAyC,EACzC,IAAY,EACZ,IAAc;QAEd,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,QAAQ,GAAG,IAAI,EAAE,CAAC;QACtC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,KAAK,GACT,IAAI,CAAC,SAAS,GAAG,CAAC;YAChB,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC;YACtD,CAAC,CAAC,IAAI,CAAC;QAEX,IAAI,GAAa,CAAC;QAClB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE;gBAC1B,MAAM;gBACN,OAAO,EAAE;oBACP,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;oBACtC,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACtE;gBACD,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;gBAC3D,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GACX,GAAG,YAAY,YAAY,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,CAAC;YAC3D,MAAM,IAAI,WAAW,CACnB,CAAC,EACD,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAC/B,OAAO;gBACL,CAAC,CAAC,cAAc,IAAI,oBAAoB,IAAI,CAAC,SAAS,IAAI;gBAC1D,CAAC,CAAC,yBAAyB,IAAI,KAAK,MAAM,CAAC,GAAG,CAAC,EAAE,EACnD,IAAI,EACJ,IAAI,CACL,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,IAAI,KAAK;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAEtD,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,MAAM,GAAI,MAA+E,CAAC,KAAK,CAAC;YACtG,MAAM,IAAI,WAAW,CACnB,GAAG,CAAC,MAAM,EACV,MAAM,EAAE,IAAI,IAAI,YAAY,EAC5B,MAAM,EAAE,OAAO,IAAI,GAAG,CAAC,UAAU,EACjC,MAAM,EAAE,UAAU,IAAI,IAAI,EAC1B,MAAM,CACP,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,MAahB,CAAC;QACF,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,IAAI,EAAE,QAAQ,CAAC,QAAQ;gBACrB,CAAC,CAAC;oBACE,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,UAAU;oBACvC,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,UAAU;oBACvC,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,KAAK;oBAC9B,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;wBAC1C,QAAQ,EAAE,CAAC,CAAC,SAAS;wBACrB,KAAK,EAAE,CAAC,CAAC,KAAK;wBACd,MAAM,EAAE,CAAC,CAAC,MAAM;wBAChB,SAAS,EAAE,CAAC,CAAC,UAAU;qBACxB,CAAC,CAAC;iBACJ;gBACH,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE;SACpC,CAAC;IACJ,CAAC;CACF;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,116 @@
+export type BaoboxClientOptions = {
+    /** Full URL to the Baobox worker, e.g. "https://baobox-jv1.brightq.workers.dev" */
+    endpoint: string;
+    /** API key issued by Baobox admin. Hashes to one `api_keys` row. */
+    apiKey: string;
+    /** Optional tag for observability — not sent over the wire yet. */
+    orgId?: string;
+    /**
+     * Optional `fetch` override. Use this in tests to inject a mock, or in
+     * edge runtimes that ship a non-global fetch (old Node, workerd variants).
+     * Defaults to globalThis.fetch.
+     */
+    fetch?: typeof globalThis.fetch;
+    /** Request timeout in ms. Default 30 000. Set to 0 to disable. */
+    timeoutMs?: number;
+};
+export type ChatRequest = {
+    skillId: string;
+    message: string;
+    sessionId?: string;
+    metadata?: Record<string, unknown>;
+};
+export type ChatResponse = {
+    response: string;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+    sessionId?: string;
+    /** Full Baobox metadata envelope: request_id, latency, tool trace. */
+    meta: ResponseMeta;
+};
+export type ResponseMeta = {
+    requestId: string;
+    latencyMs: number;
+    model?: string;
+    trace?: ToolTrace[];
+};
+export type ToolTrace = {
+    toolName: string;
+    input: Record<string, unknown>;
+    output: unknown;
+    latencyMs: number;
+};
+export type Session = {
+    id: string;
+    skillId: string;
+    tenantId: string | null;
+    createdAt: string;
+    updatedAt: string;
+};
+export type SessionMessage = {
+    id: number;
+    sessionId: string;
+    role: "user" | "assistant";
+    content: string;
+    tokenCount: number;
+    createdAt: string;
+};
+export type SkillUpsertRequest = {
+    id?: string;
+    name: string;
+    description?: string;
+    systemPrompt: string;
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    tools?: string[];
+};
+export type Skill = {
+    id: string;
+    name: string;
+    description: string;
+    systemPrompt: string;
+    model: string;
+    temperature: number;
+    maxTokens: number;
+    tenantId: string | null;
+    createdAt: string;
+    updatedAt: string;
+};
+export type ToolUpsertRequest = {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    handlerType: "builtin" | "http";
+    handlerConfig: Record<string, unknown>;
+};
+export type Tool = {
+    id: string;
+    name: string;
+    description: string;
+    inputSchema: string;
+    handlerType: "builtin" | "http";
+    handlerConfig: string;
+    createdAt: string;
+};
+export type EventType = "user_message" | "assistant_message" | "system_message" | "llm_call_start" | "llm_call_end" | "tool_call" | "tool_result" | "error";
+export type Event = {
+    id: string;
+    sessionId: string;
+    requestId: string | null;
+    eventType: EventType;
+    content: string | null;
+    metadata: Record<string, unknown>;
+    tokenCount: number;
+    latencyMs: number;
+    parentEventId: string | null;
+    createdAt: string;
+};
+export type EventListRequest = {
+    sessionId: string;
+    limit?: number;
+    after?: 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":"AAIA,MAAM,MAAM,mBAAmB,GAAG;IAChC,mFAAmF;IACnF,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAIF,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,IAAI,EAAE,YAAY,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAIF,MAAM,MAAM,OAAO,GAAG;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAIF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAIF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,WAAW,EAAE,SAAS,GAAG,MAAM,CAAC;IAChC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,IAAI,GAAG;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,SAAS,GAAG,MAAM,CAAC;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAIF,MAAM,MAAM,SAAS,GACjB,cAAc,GACd,mBAAmB,GACnB,gBAAgB,GAChB,gBAAgB,GAChB,cAAc,GACd,WAAW,GACX,aAAa,GACb,OAAO,CAAC;AAEZ,MAAM,MAAM,KAAK,GAAG;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC"}

package/dist/types.js

@@ -0,0 +1,5 @@
+// Request/response shapes sent over the wire. Kept intentionally minimal —
+// Phase 1 covers the fields both the backend and the demo UI actually use.
+// Adding a field later is a non-breaking change; removing one is breaking.
+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":"AAAA,2EAA2E;AAC3E,2EAA2E;AAC3E,2EAA2E"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@baobox/sdk",
+  "version": "0.1.0",
+  "description": "TypeScript HTTP client for Baobox — agent runtime + eval + observability.",
+  "license": "MIT",
+  "author": "Bright Qi <bright@adoptive.co>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/baobox-ai/baobox-sdk.git"
+  },
+  "homepage": "https://github.com/baobox-ai/baobox-sdk#readme",
+  "bugs": { "url": "https://github.com/baobox-ai/baobox-sdk/issues" },
+  "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"
+    }
+  },
+  "files": ["dist", "README.md", "LICENSE"],
+  "engines": { "node": ">=18" },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build && npm test"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "typescript": "^5.5.4",
+    "vitest": "^2.1.4"
+  },
+  "keywords": ["baobox", "ai", "agent", "llm", "tool-calling", "sdk"],
+  "publishConfig": { "access": "public" }
+}