codai-sdk 0.8.0 → 0.13.0

package/dist/index.js

@@ -415,6 +415,12 @@ var Agents = class {
 };
 
 // src/resources/audio.ts
+function base64ToBytes(b64) {
+  const bin = atob(b64);
+  const out = new Uint8Array(bin.length);
+  for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);
+  return out;
+}
 var Audio = class {
   constructor(http) {
     this.http = http;
@@ -466,6 +472,29 @@ var Audio = class {
       headers: res.headers
     };
   }
+  /**
+   * Streaming neural TTS with visemes + word boundaries (`codai-tts-ro`, Azure AI Speech).
+   * Yields `start`, then `audio` / `viseme` / `word` in synthesis order, then `done` (or `error`).
+   * Voices: `alina` (default), `emil`, or any Azure neural voice name. Default format `pcm`
+   * (PCM16 mono 24 kHz). Works with an ephemeral token of scope `audio` or `live`.
+   */
+  async *speechStream(body, opts = {}) {
+    const frames = this.http.sse("/v1/audio/speech/stream", {
+      body: { ...body, model: body.model ?? "codai-tts-ro" },
+      ext: opts.ext,
+      signal: opts.signal
+    });
+    for await (const frame of frames) {
+      const data = frameJson(frame);
+      if (!data || typeof data.type !== "string") continue;
+      if (data.type === "audio" && typeof data.delta === "string") {
+        yield { type: "audio", delta: data.delta, audio: base64ToBytes(data.delta) };
+        continue;
+      }
+      yield data;
+      if (data.type === "done" || data.type === "error") return;
+    }
+  }
 };
 
 // src/resources/chat.ts
@@ -633,6 +662,17 @@ var Devices = class {
       signal: opts.signal
     });
   }
+  /**
+   * `POST /v1/keys/self/revoke` — the API key this client uses revokes ITSELF (sign out).
+   * Every later call with it fails with 401.
+   */
+  revokeSelfKey(opts = {}) {
+    return this.http.json("/v1/keys/self/revoke", {
+      method: "POST",
+      ext: opts.ext,
+      signal: opts.signal
+    });
+  }
   /**
    * `GET /v1/devices/me/dispatch?limit=` — pending controls dispatched at the
    * calling device (`x-codai-device` required) across all owned sessions.
@@ -1012,6 +1052,60 @@ var Hosts = class {
   }
 };
 
+// src/resources/images.ts
+var MIN_IMAGE_TIMEOUT_MS = 15e4;
+function decodeBase64(b64) {
+  const bin = atob(b64);
+  const out = new Uint8Array(bin.length);
+  for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);
+  return out;
+}
+var Images = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * Generate images. Needs a real API key (ephemeral tokens are rejected).
+   * Pass `reference_images` to keep a logo/palette/product consistent.
+   */
+  async generate(body, opts = {}) {
+    return this.post(
+      "/v1/images/generations",
+      { ...body, model: body.model ?? "codai-image" },
+      opts
+    );
+  }
+  /**
+   * Edit one or more input images (`image`: one `{ b64_json, mime_type }` or an array of up to 14)
+   * from a text instruction. JSON body; `mask` is not supported — describe the region in `prompt`.
+   */
+  async edit(body, opts = {}) {
+    return this.post("/v1/images/edits", { ...body, model: body.model ?? "codai-image" }, opts);
+  }
+  async post(path, body, opts) {
+    const res = await this.http.request(path, {
+      body,
+      ext: opts.ext,
+      signal: opts.signal,
+      // 0 = timeout disabled on the client; otherwise never cap below the image floor.
+      timeoutMs: this.http.timeoutMs === 0 ? 0 : Math.max(this.http.timeoutMs, MIN_IMAGE_TIMEOUT_MS)
+    });
+    const raw = await res.json();
+    const cost = res.headers.get("x-codai-cost-micro-usd");
+    const data = raw.data ?? [];
+    return {
+      images: data.map((d) => decodeBase64(d.b64_json)),
+      mimeTypes: data.map((d) => d.mime_type ?? "image/png"),
+      raw,
+      routedTo: res.headers.get("x-codai-routed-to"),
+      dataRegion: res.headers.get("x-codai-data-region"),
+      costMicroUsd: cost === null ? null : Number(cost),
+      headers: res.headers
+    };
+  }
+};
+
 // src/resources/messages.ts
 var Messages = class {
   constructor(http) {
@@ -1219,6 +1313,167 @@ var Projects = class {
   }
 };
 
+// src/resources/realtime.ts
+var OPEN = 1;
+function toBytes(audio) {
+  if (audio instanceof ArrayBuffer) return new Uint8Array(audio);
+  return new Uint8Array(audio.buffer, audio.byteOffset, audio.byteLength);
+}
+function bytesToBase64(bytes) {
+  let bin = "";
+  const CHUNK = 32768;
+  for (let i = 0; i < bytes.length; i += CHUNK) {
+    bin += String.fromCharCode(...bytes.subarray(i, i + CHUNK));
+  }
+  return btoa(bin);
+}
+var RealtimeSession = class {
+  constructor(socket, firstFrame) {
+    this.socket = socket;
+    let resolveReady;
+    let rejectReady;
+    this.ready = new Promise((res, rej) => {
+      resolveReady = res;
+      rejectReady = rej;
+    });
+    this.ready.catch(() => void 0);
+    socket.onopen = () => {
+      if (firstFrame) socket.send(JSON.stringify(firstFrame));
+      for (const f of this.outbox.splice(0)) socket.send(f);
+      resolveReady();
+    };
+    socket.onmessage = (ev) => {
+      if (typeof ev.data !== "string") return;
+      let parsed;
+      try {
+        parsed = JSON.parse(ev.data);
+      } catch {
+        return;
+      }
+      if (parsed && typeof parsed === "object" && typeof parsed.type === "string") {
+        this.emit(parsed);
+      }
+    };
+    socket.onerror = () => {
+    };
+    socket.onclose = (ev) => {
+      rejectReady(
+        new Error(`realtime socket closed before open (${String(ev.code)} ${ev.reason})`)
+      );
+      this.emit({ type: "close", code: ev.code, reason: ev.reason });
+      this.closed = true;
+      for (const w of this.waiters.splice(0)) w({ value: void 0, done: true });
+    };
+  }
+  socket;
+  listeners = /* @__PURE__ */ new Map();
+  queue = [];
+  waiters = [];
+  outbox = [];
+  closed = false;
+  /** Resolves when the socket is open (rejects if it closes first). */
+  ready;
+  /** Listen for one event type (`'*'` = every event). Returns an unsubscribe function. */
+  on(type, fn) {
+    let set = this.listeners.get(type);
+    if (!set) this.listeners.set(type, set = /* @__PURE__ */ new Set());
+    set.add(fn);
+    return () => set.delete(fn);
+  }
+  /** Send any client event (JSON). Queued until the socket opens. */
+  send(event) {
+    if (this.closed) throw new Error("realtime session is closed");
+    const frame = JSON.stringify(event);
+    if (this.socket.readyState === OPEN) this.socket.send(frame);
+    else this.outbox.push(frame);
+  }
+  /** Append PCM16 little-endian mono audio (24 kHz for `codai-transcribe-live`). */
+  appendAudio(audio) {
+    const bytes = toBytes(audio);
+    if (bytes.byteLength === 0) return;
+    this.send({ type: "input_audio_buffer.append", audio: bytesToBase64(bytes) });
+  }
+  /** Close the current utterance: the server answers with one `...transcription.completed`. */
+  commit() {
+    this.send({ type: "input_audio_buffer.commit" });
+  }
+  /** Drop audio the server holds for the current utterance. */
+  clear() {
+    this.send({ type: "input_audio_buffer.clear" });
+  }
+  close(code = 1e3, reason = "client closed") {
+    if (this.closed) return;
+    this.socket.close(code, reason);
+  }
+  [Symbol.asyncIterator]() {
+    return {
+      next: () => {
+        const ev = this.queue.shift();
+        if (ev) return Promise.resolve({ value: ev, done: false });
+        if (this.closed) return Promise.resolve({ value: void 0, done: true });
+        return new Promise((resolve) => this.waiters.push(resolve));
+      },
+      return: () => {
+        this.close();
+        return Promise.resolve({ value: void 0, done: true });
+      }
+    };
+  }
+  emit(ev) {
+    for (const fn of this.listeners.get(ev.type) ?? []) fn(ev);
+    for (const fn of this.listeners.get("*") ?? []) fn(ev);
+    const w = this.waiters.shift();
+    if (w) w({ value: ev, done: false });
+    else this.queue.push(ev);
+  }
+};
+function realtimeUrl(baseUrl, opts) {
+  const url = new URL(`${baseUrl.replace(/\/$/, "").replace(/^http/, "ws")}/v1/realtime`);
+  url.searchParams.set("model", opts.model ?? "codai-transcribe-live");
+  if (opts.language) url.searchParams.set("language", opts.language);
+  if (opts.sessionId) url.searchParams.set("session_id", opts.sessionId);
+  if (opts.token) url.searchParams.set("key", opts.token);
+  return url.toString();
+}
+var Realtime = class {
+  constructor(defaults) {
+    this.defaults = defaults;
+  }
+  defaults;
+  /** Open a realtime session. Returns immediately; `await session.ready` to wait for the socket. */
+  connect(opts = {}) {
+    const Ctor = opts.WebSocket ?? globalThis.WebSocket;
+    if (!Ctor) throw new Error("codai.realtime: no WebSocket available \u2014 pass options.WebSocket");
+    const model = opts.model ?? "codai-transcribe-live";
+    let token = opts.token;
+    let apiKey = token ? void 0 : opts.apiKey ?? this.defaults.apiKey;
+    if (apiKey?.startsWith("codai_eph_v1.")) {
+      token = apiKey;
+      apiKey = void 0;
+    }
+    if (!token && !apiKey) throw new Error("codai.realtime: pass `token` (browser) or `apiKey`");
+    const url = realtimeUrl(opts.baseUrl ?? this.defaults.baseUrl, { ...opts, model, token });
+    const socket = apiKey ? new Ctor(url, void 0, { headers: { Authorization: `Bearer ${apiKey}` } }) : new Ctor(url);
+    if ("binaryType" in socket) socket.binaryType = "arraybuffer";
+    const first = opts.sessionUpdate !== void 0 ? opts.sessionUpdate : model === "codai-transcribe-live" ? {
+      type: "session.update",
+      session: {
+        type: "transcription",
+        audio: {
+          input: {
+            format: { type: "audio/pcm", rate: 24e3 },
+            transcription: {
+              model,
+              ...opts.language ? { language: opts.language } : {}
+            }
+          }
+        }
+      }
+    } : null;
+    return new RealtimeSession(socket, first);
+  }
+};
+
 // src/resources/resolve.ts
 function verifyResolveWebhook(secret, rawBody, signatureHeader, opts = {}) {
   if (!secret || !signatureHeader) return false;
@@ -1277,7 +1532,7 @@ function canonicalJson(v) {
   const o = v;
   return `{${Object.keys(o).filter((k) => o[k] !== void 0).sort().map((k) => `${JSON.stringify(k)}:${canonicalJson(o[k])}`).join(",")}}`;
 }
-function base64ToBytes(b64) {
+function base64ToBytes2(b64) {
   const bin = atob(b64);
   const out = new Uint8Array(bin.length);
   for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);
@@ -1322,7 +1577,7 @@ function verifyAttestationWithKeys(att, keys) {
   const { createVerify } = verifyCrypto();
   let body;
   try {
-    body = base64ToBytes(env.payload);
+    body = base64ToBytes2(env.payload);
   } catch {
     return { ok: false, reason: "BAD_SIGNATURE" };
   }
@@ -1331,7 +1586,7 @@ function verifyAttestationWithKeys(att, keys) {
   outer: for (const s of env.signatures) {
     let sig;
     try {
-      sig = base64ToBytes(s.sig);
+      sig = base64ToBytes2(s.sig);
     } catch {
       continue;
     }
@@ -1816,7 +2071,10 @@ var Sessions = class {
       signal: opts.signal
     });
   }
-  /** `POST /v1/sessions/{id}/dispatch` — queue a `send` for one device and wake it over FCM. */
+  /**
+   * `POST /v1/sessions/{id}/dispatch` — queue a `send` for one device and wake it over FCM.
+   * `{ mode: 'open' }` hands the session off instead: the target just opens it (no user turn).
+   */
   dispatch(sessionId, body, opts = {}) {
     return this.http.json(`/v1/sessions/${enc(sessionId)}/dispatch`, {
       body,
@@ -1849,10 +2107,6 @@ var SystemOne = class {
     this.http = http;
   }
   http;
-  /**
-   * Ask one or more typed questions about `state`. Throws on 503 `s1_unavailable` like any other
-   * error — keep a local fallback and catch it: the gateway never substitutes a generative model.
-   */
   async create(body, opts = {}) {
     const res = await this.http.request("/v1/systemone", {
       body,
@@ -1861,6 +2115,10 @@ var SystemOne = class {
     });
     return await res.json();
   }
+  /** Same questions about up to 16 states in one call; results come back in `items` order. */
+  batch(body, opts = {}) {
+    return this.create(body, opts);
+  }
 };
 
 // src/resources/tasks.ts
@@ -2003,6 +2261,63 @@ var Notifications = class {
   }
 };
 
+// src/resources/prompts.ts
+var one = (id, suffix = "") => `/v1/prompts/${encodeURIComponent(id)}${suffix}`;
+var Prompts = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /** `GET /v1/prompts?status=&limit=` — default `open`; `due` = open and `not_before` empty or passed. */
+  list(query = {}, opts = {}) {
+    return this.http.json("/v1/prompts", {
+      query: { status: query.status, limit: query.limit },
+      ext: opts.ext,
+      signal: opts.signal
+    });
+  }
+  /** `POST /v1/prompts` — idempotent on the text (`created: false` for a duplicate); `goal_key` supersedes older open ones. */
+  create(body, opts = {}) {
+    return this.http.json("/v1/prompts", {
+      method: "POST",
+      body,
+      ext: opts.ext,
+      signal: opts.signal
+    });
+  }
+  /** `GET /v1/prompts/{id}`. */
+  get(id, opts = {}) {
+    return this.http.json(one(id), { ext: opts.ext, signal: opts.signal });
+  }
+  /** `PATCH /v1/prompts/{id}` — edit, snooze (`not_before`), close (`status: 'done' | 'dismissed'`). */
+  update(id, body, opts = {}) {
+    return this.http.json(one(id), {
+      method: "PATCH",
+      body,
+      ext: opts.ext,
+      signal: opts.signal
+    });
+  }
+  /** `DELETE /v1/prompts/{id}` — `{ deleted: 0 }` when the id is missing or not yours. */
+  delete(id, opts = {}) {
+    return this.http.json(one(id), {
+      method: "DELETE",
+      ext: opts.ext,
+      signal: opts.signal
+    });
+  }
+  /** `POST /v1/prompts/{id}/launch` — new shared session + `send` control on a device; the prompt becomes `launched`. */
+  launch(id, deviceId, opts = {}) {
+    return this.http.json(one(id, "/launch"), {
+      method: "POST",
+      body: deviceId ? { device_id: deviceId } : {},
+      ext: opts.ext,
+      signal: opts.signal,
+      noRetry: true
+    });
+  }
+};
+
 // src/resources/tokens.ts
 var Tokens = class {
   constructor(http) {
@@ -2047,6 +2362,28 @@ var Tools = class {
   }
 };
 
+// src/resources/verify.ts
+var Verify = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /** `GET /v1/verify/agent-output/key` — `{ enabled: false }` when signing is off. */
+  agentOutputKey(opts = {}) {
+    return this.http.json("/v1/verify/agent-output/key", { signal: opts.signal });
+  }
+  /** `POST /v1/verify/agent-output` — 503 `signing_disabled` when signing is off. */
+  agentOutput(body, opts = {}) {
+    return this.http.json("/v1/verify/agent-output", {
+      method: "POST",
+      body,
+      signal: opts.signal,
+      // 503 here means `signing_disabled`, not a transient outage.
+      noRetry: true
+    });
+  }
+};
+
 // src/operations.ts
 var OPERATION_METHODS = {
   // Chat & Completions
@@ -2055,9 +2392,12 @@ var OPERATION_METHODS = {
   createMessage: "messages.create",
   // Embeddings & Audio
   createEmbeddings: "embeddings.create",
+  createImage: "images.generate",
+  editImage: "images.edit",
   createSystemOne: "systemOne.create",
   createTranscription: "audio.transcribe",
   createSpeech: "audio.speech",
+  createSpeechStream: "audio.speechStream",
   createEphemeralToken: "tokens.create",
   // Models
   listModels: "models.list",
@@ -2096,6 +2436,13 @@ var OPERATION_METHODS = {
   markNotificationsRead: "notifications.markRead",
   deleteNotification: "notifications.delete",
   deleteNotifications: "notifications.deleteMany",
+  // Pending prompts
+  listPrompts: "prompts.list",
+  createPrompt: "prompts.create",
+  getPrompt: "prompts.get",
+  updatePrompt: "prompts.update",
+  deletePrompt: "prompts.delete",
+  launchPrompt: "prompts.launch",
   // Sessions
   createSession: "sessions.create",
   listSessions: "sessions.list",
@@ -2117,6 +2464,7 @@ var OPERATION_METHODS = {
   listDevices: "devices.list",
   updateDevice: "devices.update",
   deleteDevice: "devices.delete",
+  revokeSelfKey: "devices.revokeSelfKey",
   // Hosts
   listHosts: "hosts.list",
   streamHost: "hosts.stream",
@@ -2159,6 +2507,9 @@ var OPERATION_METHODS = {
   listEnvironmentTasks: "environments.tasks.list",
   createEnvironmentTask: "environments.tasks.create",
   getEnvironmentTask: "environments.tasks.get",
+  // Agent-output signatures (EXPERIMENTAL, HIDE)
+  getAgentOutputKey: "verify.agentOutputKey",
+  verifyAgentOutput: "verify.agentOutput",
   listEnvironmentPorts: "environments.ports.list",
   setEnvironmentPort: "environments.ports.set",
   removeEnvironmentPort: "environments.ports.remove",
@@ -2175,7 +2526,8 @@ var OPERATION_METHODS = {
 var STREAMING_OPERATIONS = /* @__PURE__ */ new Set([
   "streamAgentRun",
   "streamSession",
-  "streamHost"
+  "streamHost",
+  "createSpeechStream"
 ]);
 var RESOLVE_OPERATION_METHODS = {
   resolveHealth: "resolve.health",
@@ -2195,10 +2547,14 @@ var Codai = class {
   messages;
   responses;
   embeddings;
+  /** Image generation and editing (`images.generate({ prompt })`, `images.edit({ prompt, image })`; codai-image = gemini-3.1-flash-image, EU). */
+  images;
   audio;
   /** Typed decisions from codai-s1 (`systemOne.create({ state, questions })`). */
   systemOne;
   tokens;
+  /** WebSocket realtime sessions (`realtime.connect({ model, language, token })`) — live STT and voice. */
+  realtime;
   models;
   health;
   agents;
@@ -2208,12 +2564,16 @@ var Codai = class {
   triggers;
   /** Inbox of trigger / cloud-task notifications. */
   notifications;
+  /** Pending prompts — ready-to-paste prompts left for a future chat (handoffs, dated follow-ups). */
+  prompts;
   sessions;
   devices;
   hosts;
   orgs;
   projects;
   environments;
+  /** EXPERIMENTAL (HIDE, unaudited): verify signed agent outputs. Provenance only. */
+  verify;
   account;
   receipt;
   feedback;
@@ -2240,21 +2600,25 @@ var Codai = class {
     const http = this.http;
     this.messages = new Messages(http);
     this.responses = new Responses(http);
+    this.images = new Images(http);
     this.audio = new Audio(http);
     this.systemOne = new SystemOne(http);
     this.tokens = new Tokens(http);
+    this.realtime = new Realtime({ baseUrl: http.baseUrl, apiKey: opts.apiKey });
     this.health = new Health(http);
     this.agents = new Agents(http);
     this.tools = new Tools(http);
     this.tasks = new Tasks(http);
     this.triggers = new Triggers(http);
     this.notifications = new Notifications(http);
+    this.prompts = new Prompts(http);
     this.sessions = new Sessions(http);
     this.devices = new Devices(http);
     this.hosts = new Hosts(http);
     this.orgs = new Orgs(http);
     this.projects = new Projects(http);
     this.environments = new Environments(http);
+    this.verify = new Verify(http);
     this.account = new Account(http);
     this.receipt = new Receipts(http);
     this.phoneModels = new PhoneModels(http);
@@ -2352,6 +2716,6 @@ function allKeys(obj) {
 }
 var index_default = Codai;
 
-export { Account, AgentRuns, Agents, Audio, Chat, ChatCompletions, Codai, CodaiError, Devices, Embeddings, EnvironmentMembers, EnvironmentPorts, EnvironmentSecrets, EnvironmentTasks, Environments, Feedback, Health, Hosts, HttpClient, Messages, Models, Notifications, OPERATION_METHODS, OrgMembers, Orgs, PhoneModels, Projects, RESOLVE_ATTESTATION_PAYLOAD_TYPE, RESOLVE_OPERATION_METHODS, RESOLVE_TERMINAL_STATUSES, Receipts, Resolve, ResolveError, ResolveInsufficientFundsError, Responses, STREAMING_OPERATIONS, SessionControls, SessionEvents, SessionLease, SessionShares, Sessions, Tasks, Tokens, Tools, Triggers, index_default as default, extensionHeaders, frameJson, mergeToolCall, readSse, resolveAttestationStatement, verifyAttestationWithKeys, verifyResolveWebhook };
+export { Account, AgentRuns, Agents, Audio, Chat, ChatCompletions, Codai, CodaiError, Devices, Embeddings, EnvironmentMembers, EnvironmentPorts, EnvironmentSecrets, EnvironmentTasks, Environments, Feedback, Health, Hosts, HttpClient, Images, Messages, Models, Notifications, OPERATION_METHODS, OrgMembers, Orgs, PhoneModels, Projects, Prompts, RESOLVE_ATTESTATION_PAYLOAD_TYPE, RESOLVE_OPERATION_METHODS, RESOLVE_TERMINAL_STATUSES, Realtime, RealtimeSession, Receipts, Resolve, ResolveError, ResolveInsufficientFundsError, Responses, STREAMING_OPERATIONS, SessionControls, SessionEvents, SessionLease, SessionShares, Sessions, SystemOne, Tasks, Tokens, Tools, Triggers, Verify, index_default as default, extensionHeaders, frameJson, mergeToolCall, readSse, realtimeUrl, resolveAttestationStatement, verifyAttestationWithKeys, verifyResolveWebhook };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map