@baobox/sdk 0.1.0 → 0.1.1

package/README.md

@@ -1,8 +1,8 @@
 # @baobox/sdk
 
-TypeScript HTTP client for [Baobox](https://baobox.au) — an AI integration platform providing an agent runtime, eval engine, and observability trail.
+TypeScript HTTP client for [BaoBox](https://baobox.ai) — 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.
+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
 
@@ -17,14 +17,14 @@ Requires Node.js 18+ (relies on native `fetch`).
 ## Quick start
 
 ```typescript
-import { BaoboxClient } from "@baobox/sdk";
+import { BaoBoxClient } from "@baobox/sdk";
 
-const sb = new BaoboxClient({
-  endpoint: "https://baobox-jv1.example.workers.dev",
+const bb = new BaoBoxClient({
+  endpoint: "https://api.baobox.ai",
   apiKey: process.env.BAOBOX_API_KEY!,
 });
 
-const res = await sb.chat({
+const res = await bb.chat({
   skillId: "sk_document_chaser",
   message: "Review cli_01 and take whatever action is needed.",
   sessionId: "ses_cli_01",
@@ -40,7 +40,7 @@ console.log(res.meta.trace);        // [{ toolName, input, output, latencyMs },
 ### Chat
 
 ```typescript
-const res = await sb.chat({
+const res = await bb.chat({
   skillId: "sk_chase",
   message: "...",
   sessionId: "ses_1",                         // optional
@@ -53,22 +53,22 @@ Returns `{ response, usage: { inputTokens, outputTokens }, sessionId, meta }` wh
 ### Sessions
 
 ```typescript
-const session = await sb.sessions.create({ skillId: "sk_chase" });
-const history = await sb.sessions.messages(session.id);
+const session = await bb.sessions.create({ skillId: "sk_chase" });
+const history = await bb.sessions.messages(session.id);
 ```
 
 ### Admin (requires admin token)
 
 ```typescript
-await sb.admin.skills.upsert({
+await bb.admin.skills.upsert({
   id: "sk_chase",
   name: "Document Chaser",
   systemPrompt: "...",
-  model: "MiniMax-M2.7",
+  model: "gpt-5",
   tools: ["lookup_client_docs", "send_client_email"],
 });
 
-await sb.admin.tools.upsert({
+await bb.admin.tools.upsert({
   name: "lookup_client_docs",
   description: "...",
   inputSchema: { type: "object", properties: { /* ... */ } },
@@ -80,20 +80,20 @@ await sb.admin.tools.upsert({
 ### Events (trace)
 
 ```typescript
-const events = await sb.events.list({ sessionId: "ses_1", limit: 50 });
+const events = await bb.events.list({ sessionId: "ses_1", limit: 50 });
 ```
 
 ## Error handling
 
-Every non-2xx response throws `BaoboxError`:
+Every non-2xx response throws `BaoBoxError`:
 
 ```typescript
-import { BaoboxError } from "@baobox/sdk";
+import { BaoBoxError } from "@baobox/sdk";
 
 try {
-  await sb.chat({ skillId: "sk_missing", message: "..." });
+  await bb.chat({ skillId: "sk_missing", message: "..." });
 } catch (err) {
-  if (err instanceof BaoboxError) {
+  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
@@ -101,13 +101,13 @@ try {
 }
 ```
 
-Network failures surface as `BaoboxError` with `status: 0` and `code: "NETWORK"`; timeouts as `code: "TIMEOUT"`.
+Network failures surface as `BaoBoxError` with `status: 0` and `code: "NETWORK"`; timeouts as `code: "TIMEOUT"`.
 
 ## Configuration
 
 ```typescript
-new BaoboxClient({
-  endpoint: "...",     // required — Baobox worker URL
+new BaoBoxClient({
+  endpoint: "...",     // required — BaoBox API base URL
   apiKey: "...",       // required
   orgId: "firm_a",     // optional, observability tag
   fetch: myFetch,      // optional, injects custom fetch (tests / edge runtimes)
@@ -121,5 +121,5 @@ 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
+- [BaoBox](https://baobox.ai) — product homepage
+- [Adoptive Co](https://adoptive.co) — consultancy using BaoBox as a delivery tool

package/dist/errors.d.ts

@@ -1,4 +1,4 @@
-export declare class BaoboxError extends Error {
+export declare class BaoBoxError extends Error {
     readonly status: number;
     readonly code: string;
     readonly requestId: string | null;

package/dist/errors.js

@@ -1,14 +1,14 @@
 // 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 {
+// 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.name = "BaoBoxError";
         this.status = status;
         this.code = code;
         this.requestId = requestId;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import type { ChatRequest, ChatResponse, Event, EventListRequest, Session, SessionMessage, Skill, BaoboxClientOptions, SkillUpsertRequest, Tool, ToolUpsertRequest } from "./types.js";
-export { BaoboxError } from "./errors.js";
+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 {
+export declare class BaoBoxClient {
     private readonly endpoint;
     private readonly apiKey;
     private readonly fetch;
@@ -23,7 +23,7 @@ export declare class BaoboxClient {
     readonly events: {
         list: (req: EventListRequest) => Promise<Event[]>;
     };
-    constructor(opts: BaoboxClientOptions);
+    constructor(opts: BaoBoxClientOptions);
     chat(req: ChatRequest): Promise<ChatResponse>;
     private createSession;
     private listMessages;

package/dist/index.js

@@ -1,25 +1,25 @@
-// @baobox/sdk — thin HTTP client for the Baobox runtime.
+// @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 {
+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.
+    // call sites read as `bb.admin.skills.upsert(...)` rather than a flat
+    // `bb.upsertSkill(...)`. Matches Tech Arch §4.2.
     admin;
     sessions;
     events;
     constructor(opts) {
         if (!opts.endpoint)
-            throw new Error("BaoboxClient: endpoint required");
+            throw new Error("BaoBoxClient: endpoint required");
         if (!opts.apiKey)
-            throw new Error("BaoboxClient: apiKey required");
+            throw new Error("BaoBoxClient: apiKey required");
         this.endpoint = opts.endpoint.replace(/\/+$/, "");
         this.apiKey = opts.apiKey;
         this.fetch = opts.fetch ?? globalThis.fetch;
@@ -166,7 +166,7 @@ export class BaoboxClient {
         }
         catch (err) {
             const isAbort = err instanceof DOMException && err.name === "AbortError";
-            throw new BaoboxError(0, isAbort ? "TIMEOUT" : "NETWORK", isAbort
+            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);
         }
@@ -178,7 +178,7 @@ export class BaoboxClient {
         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);
+            throw new BaoBoxError(res.status, errObj?.code ?? "HTTP_ERROR", errObj?.message ?? res.statusText, errObj?.request_id ?? null, parsed);
         }
         const envelope = parsed;
         return {

package/dist/types.d.ts

@@ -1,7 +1,7 @@
-export type BaoboxClientOptions = {
-    /** Full URL to the Baobox worker, e.g. "https://baobox-jv1.brightq.workers.dev" */
+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. */
+    /** 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;
@@ -27,7 +27,7 @@ export type ChatResponse = {
         outputTokens: number;
     };
     sessionId?: string;
-    /** Full Baobox metadata envelope: request_id, latency, tool trace. */
+    /** Full BaoBox metadata envelope: request_id, latency, tool trace. */
     meta: ResponseMeta;
 };
 export type ResponseMeta = {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@baobox/sdk",
-  "version": "0.1.0",
-  "description": "TypeScript HTTP client for Baobox — agent runtime + eval + observability.",
+  "version": "0.1.1",
+  "description": "TypeScript HTTP client for BaoBox — agent runtime + eval + observability.",
   "license": "MIT",
   "author": "Bright Qi <bright@adoptive.co>",
   "repository": {