@oneinbox/web-sdk 0.1.0-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OneInbox
+
+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,67 @@
+# @oneinbox/web-sdk
+
+Browser SDK for talking to a [OneInbox](https://oneinbox.ai) voice agent over WebRTC. Vapi-style: create a client with a **publishable key**, call `start(agentId)`, and the call just works — the mic publishes, the agent answers, transcripts stream as typed events.
+
+Using React? See [`@oneinbox/web-sdk-react`](https://www.npmjs.com/package/@oneinbox/web-sdk-react).
+
+## Install
+
+```bash
+npm install @oneinbox/web-sdk livekit-client
+```
+
+`livekit-client` is a peer dependency.
+
+## Auth
+
+The SDK runs fully client-side with a **publishable key** (`oi_pk_…`) — safe to embed in browser JS. Keys are locked to the origins you register (requests from other domains get `403 ORIGIN_NOT_ALLOWED`), rate-limited, and scoped to web calls only. Never put a secret key (`oi_sk_…`) in front-end code.
+
+## Quick start
+
+```ts
+import { OneInbox } from "@oneinbox/web-sdk";
+
+const oi = new OneInbox("oi_pk_live_…"); // optionally { baseUrl: "https://api.oneinbox.ai" }
+
+oi.on("transcript", (t) => console.log(`[${t.role}]`, t.text, t.final ? "(final)" : "…"));
+oi.on("call-start", () => console.log("connected"));
+oi.on("call-end", (reason) => console.log("ended", reason));
+oi.on("error", (e) => console.error(e.code, e.message));
+
+await oi.start("agt_…", { variables: { customer_name: "Suman" } });
+
+oi.setMuted(true);   // mute mic
+oi.setMuted(false);
+await oi.stop();     // hang up; the backend marks the call completed
+```
+
+### Bring-your-own-token
+
+Minting the token on your own backend (e.g. with a secret key via `POST /v1/calls/web`)? Pass it straight in:
+
+```ts
+await oi.start({ token, serverUrl }); // from your backend
+```
+
+## API
+
+| Member | Description |
+| --- | --- |
+| `new OneInbox(publishableKey, { baseUrl? })` | Create a client. |
+| `start(agentId, { variables?, metadata?, autoPublishMicrophone? })` | Fetch a token and connect. |
+| `start({ token, serverUrl })` | Connect with a token you minted server-side. |
+| `stop()` | End the call. |
+| `setMuted(muted)` / `isMuted()` | Toggle / read mic state. |
+| `status` | `"idle" \| "connecting" \| "active" \| "ending"`. |
+| `underlyingRoom` | Escape hatch to the raw `livekit-client` `Room`. |
+| `on(event, cb)` / `once` / `off` | Typed event subscription; `on` returns an unsubscribe fn. |
+
+### Events
+
+`call-start`, `call-end` (`reason?`), `status` (`CallStatus`), `connection-state` (LiveKit `ConnectionState`), `transcript` (`{ role, text, final, language? }`), `speech-start` / `speech-end` (`"user" | "agent"`), `volume-level` (`number`, 0..1), `error` (`{ code, message, cause? }`).
+
+Error codes: `TOKEN_FETCH_FAILED`, `ORIGIN_NOT_ALLOWED`, `INVALID_PUBLISHABLE_KEY`, `CONNECT_FAILED`, `MIC_PUBLISH_FAILED`, `MIC_TOGGLE_FAILED`, `DISCONNECTED` (plus server `error_code`s passed through from the token endpoint).
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,263 @@
+'use strict';
+
+var livekitClient = require('livekit-client');
+
+// src/index.ts
+
+// src/emitter.ts
+var TypedEmitter = class {
+  listeners = {};
+  /** Subscribe to `event`. Returns an unsubscribe function. */
+  on(event, fn) {
+    (this.listeners[event] ??= /* @__PURE__ */ new Set()).add(fn);
+    return () => this.off(event, fn);
+  }
+  /** Subscribe once; auto-unsubscribes after the first emission. */
+  once(event, fn) {
+    const wrapper = ((...args) => {
+      this.off(event, wrapper);
+      fn(...args);
+    });
+    return this.on(event, wrapper);
+  }
+  /** Remove a specific listener. */
+  off(event, fn) {
+    this.listeners[event]?.delete(fn);
+  }
+  /** Remove all listeners (all events, or just `event`). */
+  removeAllListeners(event) {
+    if (event) this.listeners[event]?.clear();
+    else Object.keys(this.listeners).forEach((k) => this.listeners[k]?.clear());
+  }
+  emit(event, ...args) {
+    const set = this.listeners[event];
+    if (!set) return;
+    for (const fn of [...set]) fn(...args);
+  }
+};
+
+// src/index.ts
+var VOLUME_SAMPLE_MS = 100;
+var OneInbox = class extends TypedEmitter {
+  constructor(publishableKey, config = {}) {
+    super();
+    this.publishableKey = publishableKey;
+    this.config = config;
+  }
+  publishableKey;
+  config;
+  room = null;
+  _status = "idle";
+  _muted = false;
+  volumeTimer = null;
+  speaking = /* @__PURE__ */ new Set();
+  /** Current high-level call status. */
+  get status() {
+    return this._status;
+  }
+  /** Whether the local microphone is currently muted. */
+  isMuted() {
+    return this._muted;
+  }
+  /** Underlying LiveKit room (escape hatch for advanced use). */
+  get underlyingRoom() {
+    return this.room;
+  }
+  async start(arg, opts) {
+    if (this._status !== "idle") {
+      throw new Error("A call is already in progress \u2014 call stop() first.");
+    }
+    this.setStatus("connecting");
+    try {
+      let serverUrl;
+      let token;
+      let autoMic;
+      if (typeof arg === "string") {
+        const res = await this.fetchToken(arg, opts);
+        serverUrl = res.server_url;
+        token = res.participant_token;
+        autoMic = opts?.autoPublishMicrophone !== false;
+      } else {
+        serverUrl = arg.serverUrl;
+        token = arg.token;
+        autoMic = arg.autoPublishMicrophone !== false;
+      }
+      await this.connectRoom(serverUrl, token, autoMic);
+    } catch (err) {
+      this.setStatus("idle");
+      throw err;
+    }
+  }
+  /** End the call and release resources. The backend marks the call completed. */
+  async stop() {
+    if (!this.room) {
+      this.setStatus("idle");
+      return;
+    }
+    this.setStatus("ending");
+    await this.room.disconnect();
+  }
+  /** Mute/unmute the local microphone (fire-and-forget, like Vapi's setMuted). */
+  setMuted(muted) {
+    this._muted = muted;
+    const lp = this.room?.localParticipant;
+    if (!lp) return;
+    void lp.setMicrophoneEnabled(!muted).catch((err) => {
+      this.emit("error", {
+        code: "MIC_TOGGLE_FAILED",
+        message: err?.message ?? "Failed to toggle microphone",
+        cause: err
+      });
+    });
+  }
+  // ---- internals -------------------------------------------------------
+  async fetchToken(agentId, opts) {
+    const base = (this.config.baseUrl ?? "https://api.oneinbox.ai").replace(/\/+$/, "");
+    let res;
+    try {
+      res = await fetch(`${base}/v1/web-calls/token`, {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${this.publishableKey}`,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({
+          agent_id: agentId,
+          variables: opts?.variables ?? {},
+          metadata: opts?.metadata ?? {}
+        })
+      });
+    } catch (err) {
+      throw this.fail("TOKEN_FETCH_FAILED", err?.message ?? "Network error", err);
+    }
+    if (!res.ok) {
+      let code = `HTTP_${res.status}`;
+      let detail = res.statusText;
+      try {
+        const body = await res.json();
+        code = body.error_code ?? code;
+        detail = body.detail ?? detail;
+      } catch {
+      }
+      throw this.fail(code, detail);
+    }
+    return res.json();
+  }
+  async connectRoom(serverUrl, token, autoMic) {
+    const room = new livekitClient.Room({ adaptiveStream: true, dynacast: true });
+    this.room = room;
+    this.bindRoomEvents(room);
+    try {
+      await room.connect(serverUrl, token);
+    } catch (err) {
+      this.room = null;
+      throw this.fail("CONNECT_FAILED", err?.message ?? "Connection failed", err);
+    }
+    this.setStatus("active");
+    this.emit("call-start");
+    this.startVolumeSampling();
+    if (autoMic) {
+      try {
+        await room.localParticipant.setMicrophoneEnabled(true);
+        this._muted = false;
+      } catch (err) {
+        this.emit("error", {
+          code: "MIC_PUBLISH_FAILED",
+          message: err?.message ?? "Failed to publish microphone",
+          cause: err
+        });
+      }
+    }
+  }
+  bindRoomEvents(room) {
+    room.on(livekitClient.RoomEvent.ConnectionStateChanged, (state) => {
+      this.emit("connection-state", state);
+    });
+    room.on(livekitClient.RoomEvent.TranscriptionReceived, (segments, participant) => {
+      const role = roleFor(participant);
+      for (const seg of segments) {
+        this.emit("transcript", {
+          role,
+          text: seg.text,
+          final: seg.final,
+          language: seg.language
+        });
+      }
+    });
+    room.on(livekitClient.RoomEvent.ActiveSpeakersChanged, (speakers) => {
+      const now = new Set(speakers.map(roleFor));
+      for (const role of now) {
+        if (!this.speaking.has(role)) this.emit("speech-start", role);
+      }
+      for (const role of this.speaking) {
+        if (!now.has(role)) this.emit("speech-end", role);
+      }
+      this.speaking = now;
+    });
+    room.on(livekitClient.RoomEvent.Disconnected, (reason) => {
+      const clientInitiated = reason === void 0 || reason === livekitClient.DisconnectReason.CLIENT_INITIATED;
+      if (!clientInitiated) {
+        this.emit("error", {
+          code: "DISCONNECTED",
+          message: `Room disconnected: ${livekitClient.DisconnectReason[reason] ?? reason}`
+        });
+      }
+      this.teardown(reason !== void 0 ? livekitClient.DisconnectReason[reason] : void 0);
+    });
+  }
+  startVolumeSampling() {
+    this.stopVolumeSampling();
+    this.volumeTimer = setInterval(() => {
+      const lp = this.room?.localParticipant;
+      if (lp) this.emit("volume-level", lp.audioLevel);
+    }, VOLUME_SAMPLE_MS);
+  }
+  stopVolumeSampling() {
+    if (this.volumeTimer !== null) {
+      clearInterval(this.volumeTimer);
+      this.volumeTimer = null;
+    }
+  }
+  teardown(reason) {
+    this.stopVolumeSampling();
+    this.speaking.clear();
+    this.room = null;
+    this.setStatus("idle");
+    this.emit("call-end", reason);
+  }
+  setStatus(status) {
+    if (this._status === status) return;
+    this._status = status;
+    this.emit("status", status);
+  }
+  fail(code, message, cause) {
+    const err = { code, message, cause };
+    this.emit("error", err);
+    return err;
+  }
+};
+function roleFor(participant) {
+  if (!participant) return "agent";
+  return participant.isLocal ? "user" : "agent";
+}
+
+Object.defineProperty(exports, "ConnectionState", {
+  enumerable: true,
+  get: function () { return livekitClient.ConnectionState; }
+});
+Object.defineProperty(exports, "DisconnectReason", {
+  enumerable: true,
+  get: function () { return livekitClient.DisconnectReason; }
+});
+Object.defineProperty(exports, "RoomEvent", {
+  enumerable: true,
+  get: function () { return livekitClient.RoomEvent; }
+});
+Object.defineProperty(exports, "Track", {
+  enumerable: true,
+  get: function () { return livekitClient.Track; }
+});
+exports.OneInbox = OneInbox;
+exports.TypedEmitter = TypedEmitter;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/emitter.ts","../src/index.ts"],"names":["Room","RoomEvent","DisconnectReason"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Tiny strongly-typed event emitter. Zero runtime deps so the SDK stays\n * tree-shakeable and installs without pulling `events`/`eventemitter3`.\n *\n * `E` maps event name → listener signature, e.g.\n *   { \"call-start\": () => void; \"volume-level\": (v: number) => void }\n */\nexport type EventMap = Record<string, (...args: never[]) => void>;\n\nexport class TypedEmitter<E extends EventMap> {\n  private readonly listeners: { [K in keyof E]?: Set<E[K]> } = {};\n\n  /** Subscribe to `event`. Returns an unsubscribe function. */\n  on<K extends keyof E>(event: K, fn: E[K]): () => void {\n    (this.listeners[event] ??= new Set<E[K]>()).add(fn);\n    return () => this.off(event, fn);\n  }\n\n  /** Subscribe once; auto-unsubscribes after the first emission. */\n  once<K extends keyof E>(event: K, fn: E[K]): () => void {\n    const wrapper = ((...args: Parameters<E[K]>) => {\n      this.off(event, wrapper);\n      (fn as (...a: Parameters<E[K]>) => void)(...args);\n    }) as E[K];\n    return this.on(event, wrapper);\n  }\n\n  /** Remove a specific listener. */\n  off<K extends keyof E>(event: K, fn: E[K]): void {\n    this.listeners[event]?.delete(fn);\n  }\n\n  /** Remove all listeners (all events, or just `event`). */\n  removeAllListeners<K extends keyof E>(event?: K): void {\n    if (event) this.listeners[event]?.clear();\n    else (Object.keys(this.listeners) as K[]).forEach((k) => this.listeners[k]?.clear());\n  }\n\n  protected emit<K extends keyof E>(event: K, ...args: Parameters<E[K]>): void {\n    const set = this.listeners[event];\n    if (!set) return;\n    // Copy so a listener that unsubscribes mid-emit doesn't skip the next one.\n    for (const fn of [...set]) (fn as (...a: Parameters<E[K]>) => void)(...args);\n  }\n}\n","import {\n  ConnectionState,\n  DisconnectReason,\n  type LocalParticipant,\n  type Participant,\n  type RemoteParticipant,\n  Room,\n  RoomEvent,\n  Track,\n  type TranscriptionSegment,\n} from \"livekit-client\";\n\nimport { TypedEmitter } from \"./emitter\";\n\nexport type TranscriptRole = \"user\" | \"agent\";\n\nexport interface TranscriptEvent {\n  role: TranscriptRole;\n  text: string;\n  final: boolean;\n  language?: string;\n}\n\nexport interface OneInboxError {\n  /** Stable machine code, e.g. CONNECT_FAILED, ORIGIN_NOT_ALLOWED, MIC_PUBLISH_FAILED. */\n  code: string;\n  message: string;\n  cause?: unknown;\n}\n\n/** High-level call lifecycle, mirrored to the `status` event. */\nexport type CallStatus = \"idle\" | \"connecting\" | \"active\" | \"ending\";\n\n/**\n * Typed event map. Listen with `oi.on(\"transcript\", cb)` — the callback type\n * is inferred per event (Vapi/LiveKit style).\n */\nexport type OneInboxEvents = {\n  /** Connected to the room; the agent is joining. */\n  \"call-start\": () => void;\n  /** Call ended (locally or remotely). `reason` is the LiveKit disconnect reason when known. */\n  \"call-end\": (reason?: string) => void;\n  /** Underlying LiveKit connection state changed. */\n  \"connection-state\": (state: ConnectionState) => void;\n  /** High-level status changed. */\n  status: (status: CallStatus) => void;\n  /** Incremental transcript chunk for the caller or the agent (`final` marks end-of-utterance). */\n  transcript: (ev: TranscriptEvent) => void;\n  /** Someone started speaking (best-effort, from active-speaker detection). */\n  \"speech-start\": (who: TranscriptRole) => void;\n  /** Someone stopped speaking. */\n  \"speech-end\": (who: TranscriptRole) => void;\n  /** Local microphone level, 0..1, sampled ~10x/sec while active (for mic UIs). */\n  \"volume-level\": (level: number) => void;\n  /** Any error (connection, token fetch, mic publish, server disconnect). */\n  error: (err: OneInboxError) => void;\n};\n\nexport interface OneInboxConfig {\n  /** OneInbox API base URL. Default `https://api.oneinbox.ai`. */\n  baseUrl?: string;\n}\n\nexport interface StartOptions {\n  /** Per-call template variables interpolated into the agent prompt. */\n  variables?: Record<string, unknown>;\n  /** Free-form metadata stored on the call record. */\n  metadata?: Record<string, unknown>;\n  /** Auto-publish the user's microphone on connect. Default `true`. */\n  autoPublishMicrophone?: boolean;\n}\n\n/** Bring-your-own-token escape hatch: connect with a token your backend minted. */\nexport interface TokenStartOptions {\n  /** From `POST /v1/web-calls/token` (or `/v1/calls/web`) → `participant_token`. */\n  token: string;\n  /** → `server_url`. */\n  serverUrl: string;\n  autoPublishMicrophone?: boolean;\n}\n\nconst VOLUME_SAMPLE_MS = 100;\n\n/**\n * Browser client for OneInbox voice agents over WebRTC.\n *\n * ```ts\n * const oi = new OneInbox(\"oi_pk_…\");\n * oi.on(\"transcript\", (t) => console.log(t.role, t.text));\n * await oi.start(agentId);   // mic publishes, the agent answers\n * // …\n * await oi.stop();\n * ```\n */\nexport class OneInbox extends TypedEmitter<OneInboxEvents> {\n  private room: Room | null = null;\n  private _status: CallStatus = \"idle\";\n  private _muted = false;\n  private volumeTimer: ReturnType<typeof setInterval> | null = null;\n  private speaking = new Set<TranscriptRole>();\n\n  constructor(\n    private readonly publishableKey: string,\n    private readonly config: OneInboxConfig = {},\n  ) {\n    super();\n  }\n\n  /** Current high-level call status. */\n  get status(): CallStatus {\n    return this._status;\n  }\n\n  /** Whether the local microphone is currently muted. */\n  isMuted(): boolean {\n    return this._muted;\n  }\n\n  /** Underlying LiveKit room (escape hatch for advanced use). */\n  get underlyingRoom(): Room | null {\n    return this.room;\n  }\n\n  /**\n   * Start a call.\n   *\n   * - `start(agentId, opts?)` — publishable-key path: fetches a short-lived\n   *   token from the OneInbox API, then connects.\n   * - `start({ token, serverUrl })` — connect with a token your backend minted.\n   */\n  async start(agentId: string, opts?: StartOptions): Promise<void>;\n  async start(opts: TokenStartOptions): Promise<void>;\n  async start(arg: string | TokenStartOptions, opts?: StartOptions): Promise<void> {\n    if (this._status !== \"idle\") {\n      throw new Error(\"A call is already in progress — call stop() first.\");\n    }\n    this.setStatus(\"connecting\");\n    try {\n      let serverUrl: string;\n      let token: string;\n      let autoMic: boolean;\n      if (typeof arg === \"string\") {\n        const res = await this.fetchToken(arg, opts);\n        serverUrl = res.server_url;\n        token = res.participant_token;\n        autoMic = opts?.autoPublishMicrophone !== false;\n      } else {\n        serverUrl = arg.serverUrl;\n        token = arg.token;\n        autoMic = arg.autoPublishMicrophone !== false;\n      }\n      await this.connectRoom(serverUrl, token, autoMic);\n    } catch (err) {\n      this.setStatus(\"idle\");\n      throw err;\n    }\n  }\n\n  /** End the call and release resources. The backend marks the call completed. */\n  async stop(): Promise<void> {\n    if (!this.room) {\n      this.setStatus(\"idle\");\n      return;\n    }\n    this.setStatus(\"ending\");\n    await this.room.disconnect();\n    // teardown is finalized in the Disconnected handler\n  }\n\n  /** Mute/unmute the local microphone (fire-and-forget, like Vapi's setMuted). */\n  setMuted(muted: boolean): void {\n    this._muted = muted;\n    const lp = this.room?.localParticipant;\n    if (!lp) return;\n    void lp.setMicrophoneEnabled(!muted).catch((err: unknown) => {\n      this.emit(\"error\", {\n        code: \"MIC_TOGGLE_FAILED\",\n        message: (err as Error)?.message ?? \"Failed to toggle microphone\",\n        cause: err,\n      });\n    });\n  }\n\n  // ---- internals -------------------------------------------------------\n\n  private async fetchToken(\n    agentId: string,\n    opts?: StartOptions,\n  ): Promise<{ server_url: string; participant_token: string }> {\n    const base = (this.config.baseUrl ?? \"https://api.oneinbox.ai\").replace(/\\/+$/, \"\");\n    let res: Response;\n    try {\n      res = await fetch(`${base}/v1/web-calls/token`, {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${this.publishableKey}`,\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify({\n          agent_id: agentId,\n          variables: opts?.variables ?? {},\n          metadata: opts?.metadata ?? {},\n        }),\n      });\n    } catch (err) {\n      throw this.fail(\"TOKEN_FETCH_FAILED\", (err as Error)?.message ?? \"Network error\", err);\n    }\n    if (!res.ok) {\n      let code = `HTTP_${res.status}`;\n      let detail = res.statusText;\n      try {\n        const body = (await res.json()) as { error_code?: string; detail?: string };\n        code = body.error_code ?? code;\n        detail = body.detail ?? detail;\n      } catch {\n        /* non-JSON error body */\n      }\n      throw this.fail(code, detail);\n    }\n    return res.json() as Promise<{ server_url: string; participant_token: string }>;\n  }\n\n  private async connectRoom(serverUrl: string, token: string, autoMic: boolean): Promise<void> {\n    const room = new Room({ adaptiveStream: true, dynacast: true });\n    this.room = room;\n    this.bindRoomEvents(room);\n\n    try {\n      await room.connect(serverUrl, token);\n    } catch (err) {\n      this.room = null;\n      throw this.fail(\"CONNECT_FAILED\", (err as Error)?.message ?? \"Connection failed\", err);\n    }\n\n    this.setStatus(\"active\");\n    this.emit(\"call-start\");\n    this.startVolumeSampling();\n\n    if (autoMic) {\n      try {\n        await room.localParticipant.setMicrophoneEnabled(true);\n        this._muted = false;\n      } catch (err) {\n        this.emit(\"error\", {\n          code: \"MIC_PUBLISH_FAILED\",\n          message: (err as Error)?.message ?? \"Failed to publish microphone\",\n          cause: err,\n        });\n      }\n    }\n  }\n\n  private bindRoomEvents(room: Room): void {\n    room.on(RoomEvent.ConnectionStateChanged, (state) => {\n      this.emit(\"connection-state\", state);\n    });\n\n    room.on(RoomEvent.TranscriptionReceived, (segments, participant) => {\n      const role = roleFor(participant);\n      for (const seg of segments) {\n        this.emit(\"transcript\", {\n          role,\n          text: seg.text,\n          final: seg.final,\n          language: seg.language,\n        });\n      }\n    });\n\n    room.on(RoomEvent.ActiveSpeakersChanged, (speakers) => {\n      const now = new Set<TranscriptRole>(speakers.map(roleFor));\n      for (const role of now) {\n        if (!this.speaking.has(role)) this.emit(\"speech-start\", role);\n      }\n      for (const role of this.speaking) {\n        if (!now.has(role)) this.emit(\"speech-end\", role);\n      }\n      this.speaking = now;\n    });\n\n    room.on(RoomEvent.Disconnected, (reason?: DisconnectReason) => {\n      const clientInitiated =\n        reason === undefined || reason === DisconnectReason.CLIENT_INITIATED;\n      if (!clientInitiated) {\n        this.emit(\"error\", {\n          code: \"DISCONNECTED\",\n          message: `Room disconnected: ${DisconnectReason[reason] ?? reason}`,\n        });\n      }\n      this.teardown(reason !== undefined ? DisconnectReason[reason] : undefined);\n    });\n  }\n\n  private startVolumeSampling(): void {\n    this.stopVolumeSampling();\n    this.volumeTimer = setInterval(() => {\n      const lp = this.room?.localParticipant;\n      if (lp) this.emit(\"volume-level\", lp.audioLevel);\n    }, VOLUME_SAMPLE_MS);\n  }\n\n  private stopVolumeSampling(): void {\n    if (this.volumeTimer !== null) {\n      clearInterval(this.volumeTimer);\n      this.volumeTimer = null;\n    }\n  }\n\n  private teardown(reason?: string): void {\n    this.stopVolumeSampling();\n    this.speaking.clear();\n    this.room = null;\n    this.setStatus(\"idle\");\n    this.emit(\"call-end\", reason);\n  }\n\n  private setStatus(status: CallStatus): void {\n    if (this._status === status) return;\n    this._status = status;\n    this.emit(\"status\", status);\n  }\n\n  private fail(code: string, message: string, cause?: unknown): OneInboxError {\n    const err: OneInboxError = { code, message, cause };\n    this.emit(\"error\", err);\n    return err;\n  }\n}\n\nfunction roleFor(participant: Participant | undefined): TranscriptRole {\n  // The human is the local participant; the agent joins as a remote participant.\n  if (!participant) return \"agent\";\n  return participant.isLocal ? \"user\" : \"agent\";\n}\n\n// Re-export upstream types callers commonly need so they don't have to add a\n// direct livekit-client import just for types.\nexport { ConnectionState, DisconnectReason, RoomEvent, Track };\nexport type { LocalParticipant, Participant, RemoteParticipant, Room, TranscriptionSegment };\nexport { TypedEmitter } from \"./emitter\";\n"]}

package/dist/index.d.cts

@@ -0,0 +1,133 @@
+import { ConnectionState, Room } from 'livekit-client';
+export { ConnectionState, DisconnectReason, LocalParticipant, Participant, RemoteParticipant, Room, RoomEvent, Track, TranscriptionSegment } from 'livekit-client';
+
+/**
+ * Tiny strongly-typed event emitter. Zero runtime deps so the SDK stays
+ * tree-shakeable and installs without pulling `events`/`eventemitter3`.
+ *
+ * `E` maps event name → listener signature, e.g.
+ *   { "call-start": () => void; "volume-level": (v: number) => void }
+ */
+type EventMap = Record<string, (...args: never[]) => void>;
+declare class TypedEmitter<E extends EventMap> {
+    private readonly listeners;
+    /** Subscribe to `event`. Returns an unsubscribe function. */
+    on<K extends keyof E>(event: K, fn: E[K]): () => void;
+    /** Subscribe once; auto-unsubscribes after the first emission. */
+    once<K extends keyof E>(event: K, fn: E[K]): () => void;
+    /** Remove a specific listener. */
+    off<K extends keyof E>(event: K, fn: E[K]): void;
+    /** Remove all listeners (all events, or just `event`). */
+    removeAllListeners<K extends keyof E>(event?: K): void;
+    protected emit<K extends keyof E>(event: K, ...args: Parameters<E[K]>): void;
+}
+
+type TranscriptRole = "user" | "agent";
+interface TranscriptEvent {
+    role: TranscriptRole;
+    text: string;
+    final: boolean;
+    language?: string;
+}
+interface OneInboxError {
+    /** Stable machine code, e.g. CONNECT_FAILED, ORIGIN_NOT_ALLOWED, MIC_PUBLISH_FAILED. */
+    code: string;
+    message: string;
+    cause?: unknown;
+}
+/** High-level call lifecycle, mirrored to the `status` event. */
+type CallStatus = "idle" | "connecting" | "active" | "ending";
+/**
+ * Typed event map. Listen with `oi.on("transcript", cb)` — the callback type
+ * is inferred per event (Vapi/LiveKit style).
+ */
+type OneInboxEvents = {
+    /** Connected to the room; the agent is joining. */
+    "call-start": () => void;
+    /** Call ended (locally or remotely). `reason` is the LiveKit disconnect reason when known. */
+    "call-end": (reason?: string) => void;
+    /** Underlying LiveKit connection state changed. */
+    "connection-state": (state: ConnectionState) => void;
+    /** High-level status changed. */
+    status: (status: CallStatus) => void;
+    /** Incremental transcript chunk for the caller or the agent (`final` marks end-of-utterance). */
+    transcript: (ev: TranscriptEvent) => void;
+    /** Someone started speaking (best-effort, from active-speaker detection). */
+    "speech-start": (who: TranscriptRole) => void;
+    /** Someone stopped speaking. */
+    "speech-end": (who: TranscriptRole) => void;
+    /** Local microphone level, 0..1, sampled ~10x/sec while active (for mic UIs). */
+    "volume-level": (level: number) => void;
+    /** Any error (connection, token fetch, mic publish, server disconnect). */
+    error: (err: OneInboxError) => void;
+};
+interface OneInboxConfig {
+    /** OneInbox API base URL. Default `https://api.oneinbox.ai`. */
+    baseUrl?: string;
+}
+interface StartOptions {
+    /** Per-call template variables interpolated into the agent prompt. */
+    variables?: Record<string, unknown>;
+    /** Free-form metadata stored on the call record. */
+    metadata?: Record<string, unknown>;
+    /** Auto-publish the user's microphone on connect. Default `true`. */
+    autoPublishMicrophone?: boolean;
+}
+/** Bring-your-own-token escape hatch: connect with a token your backend minted. */
+interface TokenStartOptions {
+    /** From `POST /v1/web-calls/token` (or `/v1/calls/web`) → `participant_token`. */
+    token: string;
+    /** → `server_url`. */
+    serverUrl: string;
+    autoPublishMicrophone?: boolean;
+}
+/**
+ * Browser client for OneInbox voice agents over WebRTC.
+ *
+ * ```ts
+ * const oi = new OneInbox("oi_pk_…");
+ * oi.on("transcript", (t) => console.log(t.role, t.text));
+ * await oi.start(agentId);   // mic publishes, the agent answers
+ * // …
+ * await oi.stop();
+ * ```
+ */
+declare class OneInbox extends TypedEmitter<OneInboxEvents> {
+    private readonly publishableKey;
+    private readonly config;
+    private room;
+    private _status;
+    private _muted;
+    private volumeTimer;
+    private speaking;
+    constructor(publishableKey: string, config?: OneInboxConfig);
+    /** Current high-level call status. */
+    get status(): CallStatus;
+    /** Whether the local microphone is currently muted. */
+    isMuted(): boolean;
+    /** Underlying LiveKit room (escape hatch for advanced use). */
+    get underlyingRoom(): Room | null;
+    /**
+     * Start a call.
+     *
+     * - `start(agentId, opts?)` — publishable-key path: fetches a short-lived
+     *   token from the OneInbox API, then connects.
+     * - `start({ token, serverUrl })` — connect with a token your backend minted.
+     */
+    start(agentId: string, opts?: StartOptions): Promise<void>;
+    start(opts: TokenStartOptions): Promise<void>;
+    /** End the call and release resources. The backend marks the call completed. */
+    stop(): Promise<void>;
+    /** Mute/unmute the local microphone (fire-and-forget, like Vapi's setMuted). */
+    setMuted(muted: boolean): void;
+    private fetchToken;
+    private connectRoom;
+    private bindRoomEvents;
+    private startVolumeSampling;
+    private stopVolumeSampling;
+    private teardown;
+    private setStatus;
+    private fail;
+}
+
+export { type CallStatus, OneInbox, type OneInboxConfig, type OneInboxError, type OneInboxEvents, type StartOptions, type TokenStartOptions, type TranscriptEvent, type TranscriptRole, TypedEmitter };

package/dist/index.d.ts

@@ -0,0 +1,133 @@
+import { ConnectionState, Room } from 'livekit-client';
+export { ConnectionState, DisconnectReason, LocalParticipant, Participant, RemoteParticipant, Room, RoomEvent, Track, TranscriptionSegment } from 'livekit-client';
+
+/**
+ * Tiny strongly-typed event emitter. Zero runtime deps so the SDK stays
+ * tree-shakeable and installs without pulling `events`/`eventemitter3`.
+ *
+ * `E` maps event name → listener signature, e.g.
+ *   { "call-start": () => void; "volume-level": (v: number) => void }
+ */
+type EventMap = Record<string, (...args: never[]) => void>;
+declare class TypedEmitter<E extends EventMap> {
+    private readonly listeners;
+    /** Subscribe to `event`. Returns an unsubscribe function. */
+    on<K extends keyof E>(event: K, fn: E[K]): () => void;
+    /** Subscribe once; auto-unsubscribes after the first emission. */
+    once<K extends keyof E>(event: K, fn: E[K]): () => void;
+    /** Remove a specific listener. */
+    off<K extends keyof E>(event: K, fn: E[K]): void;
+    /** Remove all listeners (all events, or just `event`). */
+    removeAllListeners<K extends keyof E>(event?: K): void;
+    protected emit<K extends keyof E>(event: K, ...args: Parameters<E[K]>): void;
+}
+
+type TranscriptRole = "user" | "agent";
+interface TranscriptEvent {
+    role: TranscriptRole;
+    text: string;
+    final: boolean;
+    language?: string;
+}
+interface OneInboxError {
+    /** Stable machine code, e.g. CONNECT_FAILED, ORIGIN_NOT_ALLOWED, MIC_PUBLISH_FAILED. */
+    code: string;
+    message: string;
+    cause?: unknown;
+}
+/** High-level call lifecycle, mirrored to the `status` event. */
+type CallStatus = "idle" | "connecting" | "active" | "ending";
+/**
+ * Typed event map. Listen with `oi.on("transcript", cb)` — the callback type
+ * is inferred per event (Vapi/LiveKit style).
+ */
+type OneInboxEvents = {
+    /** Connected to the room; the agent is joining. */
+    "call-start": () => void;
+    /** Call ended (locally or remotely). `reason` is the LiveKit disconnect reason when known. */
+    "call-end": (reason?: string) => void;
+    /** Underlying LiveKit connection state changed. */
+    "connection-state": (state: ConnectionState) => void;
+    /** High-level status changed. */
+    status: (status: CallStatus) => void;
+    /** Incremental transcript chunk for the caller or the agent (`final` marks end-of-utterance). */
+    transcript: (ev: TranscriptEvent) => void;
+    /** Someone started speaking (best-effort, from active-speaker detection). */
+    "speech-start": (who: TranscriptRole) => void;
+    /** Someone stopped speaking. */
+    "speech-end": (who: TranscriptRole) => void;
+    /** Local microphone level, 0..1, sampled ~10x/sec while active (for mic UIs). */
+    "volume-level": (level: number) => void;
+    /** Any error (connection, token fetch, mic publish, server disconnect). */
+    error: (err: OneInboxError) => void;
+};
+interface OneInboxConfig {
+    /** OneInbox API base URL. Default `https://api.oneinbox.ai`. */
+    baseUrl?: string;
+}
+interface StartOptions {
+    /** Per-call template variables interpolated into the agent prompt. */
+    variables?: Record<string, unknown>;
+    /** Free-form metadata stored on the call record. */
+    metadata?: Record<string, unknown>;
+    /** Auto-publish the user's microphone on connect. Default `true`. */
+    autoPublishMicrophone?: boolean;
+}
+/** Bring-your-own-token escape hatch: connect with a token your backend minted. */
+interface TokenStartOptions {
+    /** From `POST /v1/web-calls/token` (or `/v1/calls/web`) → `participant_token`. */
+    token: string;
+    /** → `server_url`. */
+    serverUrl: string;
+    autoPublishMicrophone?: boolean;
+}
+/**
+ * Browser client for OneInbox voice agents over WebRTC.
+ *
+ * ```ts
+ * const oi = new OneInbox("oi_pk_…");
+ * oi.on("transcript", (t) => console.log(t.role, t.text));
+ * await oi.start(agentId);   // mic publishes, the agent answers
+ * // …
+ * await oi.stop();
+ * ```
+ */
+declare class OneInbox extends TypedEmitter<OneInboxEvents> {
+    private readonly publishableKey;
+    private readonly config;
+    private room;
+    private _status;
+    private _muted;
+    private volumeTimer;
+    private speaking;
+    constructor(publishableKey: string, config?: OneInboxConfig);
+    /** Current high-level call status. */
+    get status(): CallStatus;
+    /** Whether the local microphone is currently muted. */
+    isMuted(): boolean;
+    /** Underlying LiveKit room (escape hatch for advanced use). */
+    get underlyingRoom(): Room | null;
+    /**
+     * Start a call.
+     *
+     * - `start(agentId, opts?)` — publishable-key path: fetches a short-lived
+     *   token from the OneInbox API, then connects.
+     * - `start({ token, serverUrl })` — connect with a token your backend minted.
+     */
+    start(agentId: string, opts?: StartOptions): Promise<void>;
+    start(opts: TokenStartOptions): Promise<void>;
+    /** End the call and release resources. The backend marks the call completed. */
+    stop(): Promise<void>;
+    /** Mute/unmute the local microphone (fire-and-forget, like Vapi's setMuted). */
+    setMuted(muted: boolean): void;
+    private fetchToken;
+    private connectRoom;
+    private bindRoomEvents;
+    private startVolumeSampling;
+    private stopVolumeSampling;
+    private teardown;
+    private setStatus;
+    private fail;
+}
+
+export { type CallStatus, OneInbox, type OneInboxConfig, type OneInboxError, type OneInboxEvents, type StartOptions, type TokenStartOptions, type TranscriptEvent, type TranscriptRole, TypedEmitter };

package/dist/index.js

@@ -0,0 +1,245 @@
+import { Room, RoomEvent, DisconnectReason } from 'livekit-client';
+export { ConnectionState, DisconnectReason, RoomEvent, Track } from 'livekit-client';
+
+// src/index.ts
+
+// src/emitter.ts
+var TypedEmitter = class {
+  listeners = {};
+  /** Subscribe to `event`. Returns an unsubscribe function. */
+  on(event, fn) {
+    (this.listeners[event] ??= /* @__PURE__ */ new Set()).add(fn);
+    return () => this.off(event, fn);
+  }
+  /** Subscribe once; auto-unsubscribes after the first emission. */
+  once(event, fn) {
+    const wrapper = ((...args) => {
+      this.off(event, wrapper);
+      fn(...args);
+    });
+    return this.on(event, wrapper);
+  }
+  /** Remove a specific listener. */
+  off(event, fn) {
+    this.listeners[event]?.delete(fn);
+  }
+  /** Remove all listeners (all events, or just `event`). */
+  removeAllListeners(event) {
+    if (event) this.listeners[event]?.clear();
+    else Object.keys(this.listeners).forEach((k) => this.listeners[k]?.clear());
+  }
+  emit(event, ...args) {
+    const set = this.listeners[event];
+    if (!set) return;
+    for (const fn of [...set]) fn(...args);
+  }
+};
+
+// src/index.ts
+var VOLUME_SAMPLE_MS = 100;
+var OneInbox = class extends TypedEmitter {
+  constructor(publishableKey, config = {}) {
+    super();
+    this.publishableKey = publishableKey;
+    this.config = config;
+  }
+  publishableKey;
+  config;
+  room = null;
+  _status = "idle";
+  _muted = false;
+  volumeTimer = null;
+  speaking = /* @__PURE__ */ new Set();
+  /** Current high-level call status. */
+  get status() {
+    return this._status;
+  }
+  /** Whether the local microphone is currently muted. */
+  isMuted() {
+    return this._muted;
+  }
+  /** Underlying LiveKit room (escape hatch for advanced use). */
+  get underlyingRoom() {
+    return this.room;
+  }
+  async start(arg, opts) {
+    if (this._status !== "idle") {
+      throw new Error("A call is already in progress \u2014 call stop() first.");
+    }
+    this.setStatus("connecting");
+    try {
+      let serverUrl;
+      let token;
+      let autoMic;
+      if (typeof arg === "string") {
+        const res = await this.fetchToken(arg, opts);
+        serverUrl = res.server_url;
+        token = res.participant_token;
+        autoMic = opts?.autoPublishMicrophone !== false;
+      } else {
+        serverUrl = arg.serverUrl;
+        token = arg.token;
+        autoMic = arg.autoPublishMicrophone !== false;
+      }
+      await this.connectRoom(serverUrl, token, autoMic);
+    } catch (err) {
+      this.setStatus("idle");
+      throw err;
+    }
+  }
+  /** End the call and release resources. The backend marks the call completed. */
+  async stop() {
+    if (!this.room) {
+      this.setStatus("idle");
+      return;
+    }
+    this.setStatus("ending");
+    await this.room.disconnect();
+  }
+  /** Mute/unmute the local microphone (fire-and-forget, like Vapi's setMuted). */
+  setMuted(muted) {
+    this._muted = muted;
+    const lp = this.room?.localParticipant;
+    if (!lp) return;
+    void lp.setMicrophoneEnabled(!muted).catch((err) => {
+      this.emit("error", {
+        code: "MIC_TOGGLE_FAILED",
+        message: err?.message ?? "Failed to toggle microphone",
+        cause: err
+      });
+    });
+  }
+  // ---- internals -------------------------------------------------------
+  async fetchToken(agentId, opts) {
+    const base = (this.config.baseUrl ?? "https://api.oneinbox.ai").replace(/\/+$/, "");
+    let res;
+    try {
+      res = await fetch(`${base}/v1/web-calls/token`, {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${this.publishableKey}`,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({
+          agent_id: agentId,
+          variables: opts?.variables ?? {},
+          metadata: opts?.metadata ?? {}
+        })
+      });
+    } catch (err) {
+      throw this.fail("TOKEN_FETCH_FAILED", err?.message ?? "Network error", err);
+    }
+    if (!res.ok) {
+      let code = `HTTP_${res.status}`;
+      let detail = res.statusText;
+      try {
+        const body = await res.json();
+        code = body.error_code ?? code;
+        detail = body.detail ?? detail;
+      } catch {
+      }
+      throw this.fail(code, detail);
+    }
+    return res.json();
+  }
+  async connectRoom(serverUrl, token, autoMic) {
+    const room = new Room({ adaptiveStream: true, dynacast: true });
+    this.room = room;
+    this.bindRoomEvents(room);
+    try {
+      await room.connect(serverUrl, token);
+    } catch (err) {
+      this.room = null;
+      throw this.fail("CONNECT_FAILED", err?.message ?? "Connection failed", err);
+    }
+    this.setStatus("active");
+    this.emit("call-start");
+    this.startVolumeSampling();
+    if (autoMic) {
+      try {
+        await room.localParticipant.setMicrophoneEnabled(true);
+        this._muted = false;
+      } catch (err) {
+        this.emit("error", {
+          code: "MIC_PUBLISH_FAILED",
+          message: err?.message ?? "Failed to publish microphone",
+          cause: err
+        });
+      }
+    }
+  }
+  bindRoomEvents(room) {
+    room.on(RoomEvent.ConnectionStateChanged, (state) => {
+      this.emit("connection-state", state);
+    });
+    room.on(RoomEvent.TranscriptionReceived, (segments, participant) => {
+      const role = roleFor(participant);
+      for (const seg of segments) {
+        this.emit("transcript", {
+          role,
+          text: seg.text,
+          final: seg.final,
+          language: seg.language
+        });
+      }
+    });
+    room.on(RoomEvent.ActiveSpeakersChanged, (speakers) => {
+      const now = new Set(speakers.map(roleFor));
+      for (const role of now) {
+        if (!this.speaking.has(role)) this.emit("speech-start", role);
+      }
+      for (const role of this.speaking) {
+        if (!now.has(role)) this.emit("speech-end", role);
+      }
+      this.speaking = now;
+    });
+    room.on(RoomEvent.Disconnected, (reason) => {
+      const clientInitiated = reason === void 0 || reason === DisconnectReason.CLIENT_INITIATED;
+      if (!clientInitiated) {
+        this.emit("error", {
+          code: "DISCONNECTED",
+          message: `Room disconnected: ${DisconnectReason[reason] ?? reason}`
+        });
+      }
+      this.teardown(reason !== void 0 ? DisconnectReason[reason] : void 0);
+    });
+  }
+  startVolumeSampling() {
+    this.stopVolumeSampling();
+    this.volumeTimer = setInterval(() => {
+      const lp = this.room?.localParticipant;
+      if (lp) this.emit("volume-level", lp.audioLevel);
+    }, VOLUME_SAMPLE_MS);
+  }
+  stopVolumeSampling() {
+    if (this.volumeTimer !== null) {
+      clearInterval(this.volumeTimer);
+      this.volumeTimer = null;
+    }
+  }
+  teardown(reason) {
+    this.stopVolumeSampling();
+    this.speaking.clear();
+    this.room = null;
+    this.setStatus("idle");
+    this.emit("call-end", reason);
+  }
+  setStatus(status) {
+    if (this._status === status) return;
+    this._status = status;
+    this.emit("status", status);
+  }
+  fail(code, message, cause) {
+    const err = { code, message, cause };
+    this.emit("error", err);
+    return err;
+  }
+};
+function roleFor(participant) {
+  if (!participant) return "agent";
+  return participant.isLocal ? "user" : "agent";
+}
+
+export { OneInbox, TypedEmitter };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/emitter.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Tiny strongly-typed event emitter. Zero runtime deps so the SDK stays\n * tree-shakeable and installs without pulling `events`/`eventemitter3`.\n *\n * `E` maps event name → listener signature, e.g.\n *   { \"call-start\": () => void; \"volume-level\": (v: number) => void }\n */\nexport type EventMap = Record<string, (...args: never[]) => void>;\n\nexport class TypedEmitter<E extends EventMap> {\n  private readonly listeners: { [K in keyof E]?: Set<E[K]> } = {};\n\n  /** Subscribe to `event`. Returns an unsubscribe function. */\n  on<K extends keyof E>(event: K, fn: E[K]): () => void {\n    (this.listeners[event] ??= new Set<E[K]>()).add(fn);\n    return () => this.off(event, fn);\n  }\n\n  /** Subscribe once; auto-unsubscribes after the first emission. */\n  once<K extends keyof E>(event: K, fn: E[K]): () => void {\n    const wrapper = ((...args: Parameters<E[K]>) => {\n      this.off(event, wrapper);\n      (fn as (...a: Parameters<E[K]>) => void)(...args);\n    }) as E[K];\n    return this.on(event, wrapper);\n  }\n\n  /** Remove a specific listener. */\n  off<K extends keyof E>(event: K, fn: E[K]): void {\n    this.listeners[event]?.delete(fn);\n  }\n\n  /** Remove all listeners (all events, or just `event`). */\n  removeAllListeners<K extends keyof E>(event?: K): void {\n    if (event) this.listeners[event]?.clear();\n    else (Object.keys(this.listeners) as K[]).forEach((k) => this.listeners[k]?.clear());\n  }\n\n  protected emit<K extends keyof E>(event: K, ...args: Parameters<E[K]>): void {\n    const set = this.listeners[event];\n    if (!set) return;\n    // Copy so a listener that unsubscribes mid-emit doesn't skip the next one.\n    for (const fn of [...set]) (fn as (...a: Parameters<E[K]>) => void)(...args);\n  }\n}\n","import {\n  ConnectionState,\n  DisconnectReason,\n  type LocalParticipant,\n  type Participant,\n  type RemoteParticipant,\n  Room,\n  RoomEvent,\n  Track,\n  type TranscriptionSegment,\n} from \"livekit-client\";\n\nimport { TypedEmitter } from \"./emitter\";\n\nexport type TranscriptRole = \"user\" | \"agent\";\n\nexport interface TranscriptEvent {\n  role: TranscriptRole;\n  text: string;\n  final: boolean;\n  language?: string;\n}\n\nexport interface OneInboxError {\n  /** Stable machine code, e.g. CONNECT_FAILED, ORIGIN_NOT_ALLOWED, MIC_PUBLISH_FAILED. */\n  code: string;\n  message: string;\n  cause?: unknown;\n}\n\n/** High-level call lifecycle, mirrored to the `status` event. */\nexport type CallStatus = \"idle\" | \"connecting\" | \"active\" | \"ending\";\n\n/**\n * Typed event map. Listen with `oi.on(\"transcript\", cb)` — the callback type\n * is inferred per event (Vapi/LiveKit style).\n */\nexport type OneInboxEvents = {\n  /** Connected to the room; the agent is joining. */\n  \"call-start\": () => void;\n  /** Call ended (locally or remotely). `reason` is the LiveKit disconnect reason when known. */\n  \"call-end\": (reason?: string) => void;\n  /** Underlying LiveKit connection state changed. */\n  \"connection-state\": (state: ConnectionState) => void;\n  /** High-level status changed. */\n  status: (status: CallStatus) => void;\n  /** Incremental transcript chunk for the caller or the agent (`final` marks end-of-utterance). */\n  transcript: (ev: TranscriptEvent) => void;\n  /** Someone started speaking (best-effort, from active-speaker detection). */\n  \"speech-start\": (who: TranscriptRole) => void;\n  /** Someone stopped speaking. */\n  \"speech-end\": (who: TranscriptRole) => void;\n  /** Local microphone level, 0..1, sampled ~10x/sec while active (for mic UIs). */\n  \"volume-level\": (level: number) => void;\n  /** Any error (connection, token fetch, mic publish, server disconnect). */\n  error: (err: OneInboxError) => void;\n};\n\nexport interface OneInboxConfig {\n  /** OneInbox API base URL. Default `https://api.oneinbox.ai`. */\n  baseUrl?: string;\n}\n\nexport interface StartOptions {\n  /** Per-call template variables interpolated into the agent prompt. */\n  variables?: Record<string, unknown>;\n  /** Free-form metadata stored on the call record. */\n  metadata?: Record<string, unknown>;\n  /** Auto-publish the user's microphone on connect. Default `true`. */\n  autoPublishMicrophone?: boolean;\n}\n\n/** Bring-your-own-token escape hatch: connect with a token your backend minted. */\nexport interface TokenStartOptions {\n  /** From `POST /v1/web-calls/token` (or `/v1/calls/web`) → `participant_token`. */\n  token: string;\n  /** → `server_url`. */\n  serverUrl: string;\n  autoPublishMicrophone?: boolean;\n}\n\nconst VOLUME_SAMPLE_MS = 100;\n\n/**\n * Browser client for OneInbox voice agents over WebRTC.\n *\n * ```ts\n * const oi = new OneInbox(\"oi_pk_…\");\n * oi.on(\"transcript\", (t) => console.log(t.role, t.text));\n * await oi.start(agentId);   // mic publishes, the agent answers\n * // …\n * await oi.stop();\n * ```\n */\nexport class OneInbox extends TypedEmitter<OneInboxEvents> {\n  private room: Room | null = null;\n  private _status: CallStatus = \"idle\";\n  private _muted = false;\n  private volumeTimer: ReturnType<typeof setInterval> | null = null;\n  private speaking = new Set<TranscriptRole>();\n\n  constructor(\n    private readonly publishableKey: string,\n    private readonly config: OneInboxConfig = {},\n  ) {\n    super();\n  }\n\n  /** Current high-level call status. */\n  get status(): CallStatus {\n    return this._status;\n  }\n\n  /** Whether the local microphone is currently muted. */\n  isMuted(): boolean {\n    return this._muted;\n  }\n\n  /** Underlying LiveKit room (escape hatch for advanced use). */\n  get underlyingRoom(): Room | null {\n    return this.room;\n  }\n\n  /**\n   * Start a call.\n   *\n   * - `start(agentId, opts?)` — publishable-key path: fetches a short-lived\n   *   token from the OneInbox API, then connects.\n   * - `start({ token, serverUrl })` — connect with a token your backend minted.\n   */\n  async start(agentId: string, opts?: StartOptions): Promise<void>;\n  async start(opts: TokenStartOptions): Promise<void>;\n  async start(arg: string | TokenStartOptions, opts?: StartOptions): Promise<void> {\n    if (this._status !== \"idle\") {\n      throw new Error(\"A call is already in progress — call stop() first.\");\n    }\n    this.setStatus(\"connecting\");\n    try {\n      let serverUrl: string;\n      let token: string;\n      let autoMic: boolean;\n      if (typeof arg === \"string\") {\n        const res = await this.fetchToken(arg, opts);\n        serverUrl = res.server_url;\n        token = res.participant_token;\n        autoMic = opts?.autoPublishMicrophone !== false;\n      } else {\n        serverUrl = arg.serverUrl;\n        token = arg.token;\n        autoMic = arg.autoPublishMicrophone !== false;\n      }\n      await this.connectRoom(serverUrl, token, autoMic);\n    } catch (err) {\n      this.setStatus(\"idle\");\n      throw err;\n    }\n  }\n\n  /** End the call and release resources. The backend marks the call completed. */\n  async stop(): Promise<void> {\n    if (!this.room) {\n      this.setStatus(\"idle\");\n      return;\n    }\n    this.setStatus(\"ending\");\n    await this.room.disconnect();\n    // teardown is finalized in the Disconnected handler\n  }\n\n  /** Mute/unmute the local microphone (fire-and-forget, like Vapi's setMuted). */\n  setMuted(muted: boolean): void {\n    this._muted = muted;\n    const lp = this.room?.localParticipant;\n    if (!lp) return;\n    void lp.setMicrophoneEnabled(!muted).catch((err: unknown) => {\n      this.emit(\"error\", {\n        code: \"MIC_TOGGLE_FAILED\",\n        message: (err as Error)?.message ?? \"Failed to toggle microphone\",\n        cause: err,\n      });\n    });\n  }\n\n  // ---- internals -------------------------------------------------------\n\n  private async fetchToken(\n    agentId: string,\n    opts?: StartOptions,\n  ): Promise<{ server_url: string; participant_token: string }> {\n    const base = (this.config.baseUrl ?? \"https://api.oneinbox.ai\").replace(/\\/+$/, \"\");\n    let res: Response;\n    try {\n      res = await fetch(`${base}/v1/web-calls/token`, {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${this.publishableKey}`,\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify({\n          agent_id: agentId,\n          variables: opts?.variables ?? {},\n          metadata: opts?.metadata ?? {},\n        }),\n      });\n    } catch (err) {\n      throw this.fail(\"TOKEN_FETCH_FAILED\", (err as Error)?.message ?? \"Network error\", err);\n    }\n    if (!res.ok) {\n      let code = `HTTP_${res.status}`;\n      let detail = res.statusText;\n      try {\n        const body = (await res.json()) as { error_code?: string; detail?: string };\n        code = body.error_code ?? code;\n        detail = body.detail ?? detail;\n      } catch {\n        /* non-JSON error body */\n      }\n      throw this.fail(code, detail);\n    }\n    return res.json() as Promise<{ server_url: string; participant_token: string }>;\n  }\n\n  private async connectRoom(serverUrl: string, token: string, autoMic: boolean): Promise<void> {\n    const room = new Room({ adaptiveStream: true, dynacast: true });\n    this.room = room;\n    this.bindRoomEvents(room);\n\n    try {\n      await room.connect(serverUrl, token);\n    } catch (err) {\n      this.room = null;\n      throw this.fail(\"CONNECT_FAILED\", (err as Error)?.message ?? \"Connection failed\", err);\n    }\n\n    this.setStatus(\"active\");\n    this.emit(\"call-start\");\n    this.startVolumeSampling();\n\n    if (autoMic) {\n      try {\n        await room.localParticipant.setMicrophoneEnabled(true);\n        this._muted = false;\n      } catch (err) {\n        this.emit(\"error\", {\n          code: \"MIC_PUBLISH_FAILED\",\n          message: (err as Error)?.message ?? \"Failed to publish microphone\",\n          cause: err,\n        });\n      }\n    }\n  }\n\n  private bindRoomEvents(room: Room): void {\n    room.on(RoomEvent.ConnectionStateChanged, (state) => {\n      this.emit(\"connection-state\", state);\n    });\n\n    room.on(RoomEvent.TranscriptionReceived, (segments, participant) => {\n      const role = roleFor(participant);\n      for (const seg of segments) {\n        this.emit(\"transcript\", {\n          role,\n          text: seg.text,\n          final: seg.final,\n          language: seg.language,\n        });\n      }\n    });\n\n    room.on(RoomEvent.ActiveSpeakersChanged, (speakers) => {\n      const now = new Set<TranscriptRole>(speakers.map(roleFor));\n      for (const role of now) {\n        if (!this.speaking.has(role)) this.emit(\"speech-start\", role);\n      }\n      for (const role of this.speaking) {\n        if (!now.has(role)) this.emit(\"speech-end\", role);\n      }\n      this.speaking = now;\n    });\n\n    room.on(RoomEvent.Disconnected, (reason?: DisconnectReason) => {\n      const clientInitiated =\n        reason === undefined || reason === DisconnectReason.CLIENT_INITIATED;\n      if (!clientInitiated) {\n        this.emit(\"error\", {\n          code: \"DISCONNECTED\",\n          message: `Room disconnected: ${DisconnectReason[reason] ?? reason}`,\n        });\n      }\n      this.teardown(reason !== undefined ? DisconnectReason[reason] : undefined);\n    });\n  }\n\n  private startVolumeSampling(): void {\n    this.stopVolumeSampling();\n    this.volumeTimer = setInterval(() => {\n      const lp = this.room?.localParticipant;\n      if (lp) this.emit(\"volume-level\", lp.audioLevel);\n    }, VOLUME_SAMPLE_MS);\n  }\n\n  private stopVolumeSampling(): void {\n    if (this.volumeTimer !== null) {\n      clearInterval(this.volumeTimer);\n      this.volumeTimer = null;\n    }\n  }\n\n  private teardown(reason?: string): void {\n    this.stopVolumeSampling();\n    this.speaking.clear();\n    this.room = null;\n    this.setStatus(\"idle\");\n    this.emit(\"call-end\", reason);\n  }\n\n  private setStatus(status: CallStatus): void {\n    if (this._status === status) return;\n    this._status = status;\n    this.emit(\"status\", status);\n  }\n\n  private fail(code: string, message: string, cause?: unknown): OneInboxError {\n    const err: OneInboxError = { code, message, cause };\n    this.emit(\"error\", err);\n    return err;\n  }\n}\n\nfunction roleFor(participant: Participant | undefined): TranscriptRole {\n  // The human is the local participant; the agent joins as a remote participant.\n  if (!participant) return \"agent\";\n  return participant.isLocal ? \"user\" : \"agent\";\n}\n\n// Re-export upstream types callers commonly need so they don't have to add a\n// direct livekit-client import just for types.\nexport { ConnectionState, DisconnectReason, RoomEvent, Track };\nexport type { LocalParticipant, Participant, RemoteParticipant, Room, TranscriptionSegment };\nexport { TypedEmitter } from \"./emitter\";\n"]}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@oneinbox/web-sdk",
+  "version": "0.1.0-beta.1",
+  "description": "OneInbox browser SDK — connect to a voice agent over WebRTC with a publishable key.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "tsup"
+  },
+  "peerDependencies": {
+    "livekit-client": "^2.0.0"
+  },
+  "devDependencies": {
+    "livekit-client": "^2.5.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0"
+  },
+  "keywords": ["voice", "ai", "agents", "webrtc", "livekit", "vapi"],
+  "author": "OneInbox",
+  "homepage": "https://www.npmjs.com/package/@oneinbox/web-sdk",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}