@voicethere/client 0.3.0

package/dist/browser/session-provision.js

@@ -0,0 +1,92 @@
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function pollSessionStatus(input) {
+    const started = Date.now();
+    const url = `${input.apiBase.replace(/\/$/, "")}/api/v1/sessions/${input.jobId}`;
+    while (Date.now() - started < input.pollTimeoutMs) {
+        const res = await fetch(url, { headers: input.headers });
+        if (!res.ok) {
+            const body = await res.text().catch(() => "");
+            return {
+                ok: false,
+                code: "HTTP_ERROR",
+                message: `GET session status failed (${res.status}): ${body}`,
+            };
+        }
+        const status = (await res.json());
+        input.onStatus?.(status);
+        input.debug?.info("provision", status.status, status.failure_message ?? undefined, status);
+        if (status.status === "ready" && status.credentials) {
+            return { ok: true, credentials: status.credentials, jobId: input.jobId };
+        }
+        if (status.status === "failed") {
+            return {
+                ok: false,
+                code: status.failure_code ?? "ORCHESTRATOR_ERROR",
+                message: status.failure_message ?? "Session provisioning failed",
+            };
+        }
+        await sleep(input.pollIntervalMs);
+    }
+    return {
+        ok: false,
+        code: "TIMEOUT",
+        message: "Session provisioning timed out",
+    };
+}
+/**
+ * POST /api/v1/sessions with async=true and poll GET until ready or failed.
+ */
+export async function startSession(options) {
+    const apiBase = options.apiBase.replace(/\/$/, "");
+    const headers = {
+        "Content-Type": "application/json",
+        ...options.headers,
+    };
+    const body = {
+        project_id: options.projectId,
+        build_id: options.buildId,
+        async: options.async ?? true,
+    };
+    options.debug?.info("provision", "post_sessions", JSON.stringify(body));
+    const res = await fetch(`${apiBase}/api/v1/sessions`, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(body),
+    });
+    if (res.status === 200) {
+        const sync = (await res.json());
+        return {
+            ok: true,
+            credentials: {
+                session_id: sync.session_id,
+                join_token: sync.join_token,
+                signaling_url: sync.signaling_url,
+                room_id: sync.room_id,
+                ice_servers: sync.ice_servers,
+                expires_at: sync.expires_at,
+            },
+            jobId: sync.session_id,
+        };
+    }
+    if (res.status !== 202) {
+        const text = await res.text().catch(() => "");
+        return {
+            ok: false,
+            code: "HTTP_ERROR",
+            message: `POST /sessions failed (${res.status}): ${text}`,
+        };
+    }
+    const accepted = (await res.json());
+    return pollSessionStatus({
+        apiBase,
+        jobId: accepted.session_id,
+        headers,
+        pollIntervalMs: options.pollIntervalMs ?? 1000,
+        pollTimeoutMs: options.pollTimeoutMs ?? 120_000,
+        onStatus: options.onStatus,
+        debug: options.debug,
+    });
+}
+//# sourceMappingURL=session-provision.js.map

package/dist/browser/session-provision.js.map

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

package/dist/embed/index.d.ts

@@ -0,0 +1,21 @@
+import { type BrowserSessionMode } from "../browser/browser-session.js";
+export type VoiceThereWidgetTheme = {
+    primary?: string;
+    background?: string;
+    text?: string;
+};
+export type VoiceThereWidgetOptions = {
+    projectId: string;
+    apiBase: string;
+    clientKey: string;
+    mode?: BrowserSessionMode;
+    theme?: VoiceThereWidgetTheme;
+    mount?: HTMLElement;
+};
+export type VoiceThereWidget = {
+    open: () => void;
+    close: () => void;
+    destroy: () => void;
+};
+export declare function createVoiceThereWidget(options: VoiceThereWidgetOptions): VoiceThereWidget;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/embed/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,+BAA+B,CAAC;AAEvC,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAEF,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,uBAAuB,GAC/B,gBAAgB,CAiJlB"}

package/dist/embed/index.js

@@ -0,0 +1,131 @@
+import { createDebugConsole, startSession, } from "../browser/browser-session.js";
+import { connectBrowserSession, } from "../browser/browser-session.js";
+export function createVoiceThereWidget(options) {
+    const mount = options.mount ?? document.body;
+    const mode = options.mode ?? "chat";
+    const theme = options.theme ?? {};
+    const root = document.createElement("div");
+    root.style.position = "fixed";
+    root.style.bottom = "16px";
+    root.style.right = "16px";
+    root.style.zIndex = "99999";
+    root.style.fontFamily = "system-ui, sans-serif";
+    const launcher = document.createElement("button");
+    launcher.textContent = "Chat";
+    launcher.style.background = theme.primary ?? "#06b6d4";
+    launcher.style.color = theme.text ?? "#0f172a";
+    launcher.style.border = "none";
+    launcher.style.borderRadius = "999px";
+    launcher.style.padding = "12px 16px";
+    launcher.style.cursor = "pointer";
+    const panel = document.createElement("div");
+    panel.style.display = "none";
+    panel.style.width = "320px";
+    panel.style.height = "420px";
+    panel.style.background = theme.background ?? "#0b1220";
+    panel.style.color = theme.text ?? "#e2e8f0";
+    panel.style.border = "1px solid rgba(255,255,255,0.1)";
+    panel.style.borderRadius = "12px";
+    panel.style.padding = "12px";
+    panel.style.boxShadow = "0 8px 30px rgba(0,0,0,0.35)";
+    const status = document.createElement("div");
+    status.style.fontSize = "12px";
+    status.style.marginBottom = "8px";
+    status.textContent = "Disconnected";
+    const log = document.createElement("pre");
+    log.style.flex = "1";
+    log.style.overflow = "auto";
+    log.style.fontSize = "11px";
+    log.style.background = "rgba(0,0,0,0.25)";
+    log.style.padding = "8px";
+    log.style.borderRadius = "8px";
+    log.style.height = "260px";
+    log.style.whiteSpace = "pre-wrap";
+    const input = document.createElement("input");
+    input.placeholder = "Type a message…";
+    input.style.width = "100%";
+    input.style.marginTop = "8px";
+    input.style.padding = "8px";
+    input.style.borderRadius = "8px";
+    input.style.border = "1px solid rgba(255,255,255,0.15)";
+    input.style.background = "#111827";
+    input.style.color = "#e2e8f0";
+    const connectBtn = document.createElement("button");
+    connectBtn.textContent = "Connect";
+    connectBtn.style.marginTop = "8px";
+    connectBtn.style.width = "100%";
+    connectBtn.style.padding = "8px";
+    connectBtn.style.borderRadius = "8px";
+    connectBtn.style.border = "none";
+    connectBtn.style.background = theme.primary ?? "#06b6d4";
+    connectBtn.style.color = theme.text ?? "#0f172a";
+    connectBtn.style.cursor = "pointer";
+    panel.append(status, log, input, connectBtn);
+    root.append(launcher, panel);
+    mount.append(root);
+    let session = null;
+    const renderLog = () => {
+        log.textContent = debug.exportText();
+    };
+    const debug = createDebugConsole(() => renderLog());
+    connectBtn.onclick = () => {
+        void (async () => {
+            if (session) {
+                session.disconnect();
+                session = null;
+                status.textContent = "Disconnected";
+                connectBtn.textContent = "Connect";
+                return;
+            }
+            status.textContent = "Provisioning…";
+            const started = await startSession({
+                apiBase: options.apiBase,
+                projectId: options.projectId,
+                headers: { Authorization: `Bearer ${options.clientKey}` },
+                onStatus: (s) => {
+                    status.textContent = `Status: ${s.status}`;
+                },
+                debug,
+            });
+            renderLog();
+            if (!started.ok) {
+                status.textContent = started.message;
+                return;
+            }
+            session = await connectBrowserSession({
+                mode,
+                credentials: started.credentials,
+                onDebugEvent: debug,
+            });
+            status.textContent = "Connected";
+            connectBtn.textContent = "Disconnect";
+            renderLog();
+        })();
+    };
+    input.addEventListener("keydown", (event) => {
+        if (event.key !== "Enter" || !session)
+            return;
+        const text = input.value.trim();
+        if (!text)
+            return;
+        session.sendChat(text);
+        input.value = "";
+        renderLog();
+    });
+    launcher.onclick = () => {
+        panel.style.display = panel.style.display === "none" ? "block" : "none";
+    };
+    return {
+        open: () => {
+            panel.style.display = "block";
+        },
+        close: () => {
+            panel.style.display = "none";
+        },
+        destroy: () => {
+            session?.disconnect();
+            root.remove();
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/embed/index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+import type { ConnectedClient, VoiceThereClientOptions } from "./types.js";
+/**
+ * Connect to VoiceThere signaling — local runner (plain ws) or cloud gateway (JWT).
+ * Returns a thin wrapper around {@link SignalingClient} for WebRTC negotiation.
+ */
+export declare function connectVoiceSession(options: VoiceThereClientOptions): Promise<ConnectedClient>;
+export { appendJoinToken, resolveConnection } from "./resolve-connection.js";
+export type { CloudSessionCredentials, VoiceThereClientOptions, ConnectedClient, } from "./types.js";
+//# 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":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE3E;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,eAAe,CAAC,CAmB1B;AAED,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC7E,YAAY,EACV,uBAAuB,EACvB,uBAAuB,EACvB,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,26 @@
+import { SignalingClient } from "@node-webrtc-rust/signaling";
+import { resolveConnection } from "./resolve-connection.js";
+/**
+ * Connect to VoiceThere signaling — local runner (plain ws) or cloud gateway (JWT).
+ * Returns a thin wrapper around {@link SignalingClient} for WebRTC negotiation.
+ */
+export async function connectVoiceSession(options) {
+    const { signalingUrl, roomId, peerId } = resolveConnection(options);
+    const client = new SignalingClient({
+        url: signalingUrl,
+        room: roomId,
+        peerId,
+    });
+    await client.connect();
+    return {
+        peerId: client.peerId,
+        roomId: client.room,
+        signalingUrl,
+        disconnect: () => client.disconnect(),
+        on: (event, listener) => {
+            client.on(event, listener);
+        },
+    };
+}
+export { appendJoinToken, resolveConnection } from "./resolve-connection.js";
+//# 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,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAgC;IAEhC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;QACjC,GAAG,EAAE,YAAY;QACjB,IAAI,EAAE,MAAM;QACZ,MAAM;KACP,CAAC,CAAC;IAEH,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;IAEvB,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,MAAM,CAAC,IAAI;QACnB,YAAY;QACZ,UAAU,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE;QACrC,EAAE,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;YACtB,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC7B,CAAC;KACF,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/resolve-connection.d.ts

@@ -0,0 +1,9 @@
+import type { CloudSessionCredentials, VoiceThereClientOptions } from "./types.js";
+export declare function appendJoinToken(signalingUrl: string, joinToken: string): string;
+export declare function resolveConnection(options: VoiceThereClientOptions): {
+    signalingUrl: string;
+    roomId: string;
+    peerId?: string;
+};
+export type { CloudSessionCredentials };
+//# sourceMappingURL=resolve-connection.d.ts.map

package/dist/resolve-connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-connection.d.ts","sourceRoot":"","sources":["../src/resolve-connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAEnF,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAM/E;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,uBAAuB,GAAG;IACnE,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAeA;AAED,YAAY,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/resolve-connection.js

@@ -0,0 +1,23 @@
+export function appendJoinToken(signalingUrl, joinToken) {
+    const url = new URL(signalingUrl);
+    if (!url.searchParams.has("token")) {
+        url.searchParams.set("token", joinToken);
+    }
+    return url.toString();
+}
+export function resolveConnection(options) {
+    if (options.mode === "local") {
+        return {
+            signalingUrl: options.signalingUrl,
+            roomId: options.sessionId,
+            peerId: options.peerId,
+        };
+    }
+    const creds = options.credentials;
+    return {
+        signalingUrl: appendJoinToken(creds.signalingUrl, creds.joinToken),
+        roomId: creds.roomId,
+        peerId: options.peerId,
+    };
+}
+//# sourceMappingURL=resolve-connection.js.map

package/dist/resolve-connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-connection.js","sourceRoot":"","sources":["../src/resolve-connection.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,eAAe,CAAC,YAAoB,EAAE,SAAiB;IACrE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;IAClC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QACnC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAgC;IAKhE,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC7B,OAAO;YACL,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,MAAM,EAAE,OAAO,CAAC,SAAS;YACzB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,CAAC;IAClC,OAAO;QACL,YAAY,EAAE,eAAe,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC;QAClE,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,36 @@
+export type IceServerConfig = {
+    urls: string | string[];
+    username?: string;
+    credential?: string;
+};
+/** Credentials from platform POST /api/v1/sessions (cloud mode). */
+export type CloudSessionCredentials = {
+    sessionId: string;
+    joinToken: string;
+    signalingUrl: string;
+    roomId: string;
+    iceServers?: IceServerConfig[];
+    expiresAt?: string;
+};
+/** Direct runner signaling (M1 local dev). */
+export type LocalSessionOptions = {
+    mode: "local";
+    signalingUrl: string;
+    sessionId: string;
+    peerId?: string;
+};
+/** Gateway join via orchestrator-minted JWT (M4). */
+export type CloudSessionOptions = {
+    mode: "cloud";
+    credentials: CloudSessionCredentials;
+    peerId?: string;
+};
+export type VoiceThereClientOptions = LocalSessionOptions | CloudSessionOptions;
+export type ConnectedClient = {
+    peerId: string;
+    roomId: string;
+    signalingUrl: string;
+    disconnect: () => void;
+    on: (event: string, listener: (...args: unknown[]) => void) => void;
+};
+//# 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":"AAAA,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,oEAAoE;AACpE,MAAM,MAAM,uBAAuB,GAAG;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,8CAA8C;AAC9C,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,qDAAqD;AACrD,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,uBAAuB,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,mBAAmB,GAAG,mBAAmB,CAAC;AAEhF,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,IAAI,CAAC;CACrE,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+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":""}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@voicethere/client",
+  "version": "0.3.0",
+  "description": "VoiceThere browser/Node client — cloud gateway, browser voice/chat, embed widget",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./browser": {
+      "types": "./dist/browser/browser-session.d.ts",
+      "import": "./dist/browser/browser-session.js"
+    },
+    "./embed": {
+      "types": "./dist/embed/index.d.ts",
+      "import": "./dist/embed/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run",
+    "test:ci": "npm run typecheck && npm run test && npm run build",
+    "demo:local": "tsx examples/local-connect.ts",
+    "demo:cloud": "tsx examples/cloud-connect.ts",
+    "demo:browser": "vite --config examples/browser-test/vite.config.ts"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/voicethere/client.git"
+  },
+  "bugs": {
+    "url": "https://github.com/voicethere/client/issues"
+  },
+  "homepage": "https://github.com/voicethere/client#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "voicethere",
+    "webrtc",
+    "voice-agent",
+    "signaling"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@node-webrtc-rust/signaling": "0.5.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.0",
+    "vite": "^6.0.3",
+    "vitest": "^2.1.8"
+  }
+}

package/templates/debug-page.html

@@ -0,0 +1,56 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <title>VoiceThere debug page</title>
+    <style>
+      body { font-family: system-ui, sans-serif; background: #0b1220; color: #e2e8f0; padding: 24px; }
+      pre { background: #111827; padding: 12px; border-radius: 8px; max-height: 320px; overflow: auto; }
+      button, input { margin-right: 8px; margin-top: 8px; }
+    </style>
+  </head>
+  <body>
+    <h1>VoiceThere debug client</h1>
+    <p>Polls <code>POST /api/v1/sessions?async=true</code> then connects WebRTC.</p>
+    <label>Project ID <input id="projectId" size="40" /></label>
+    <button id="connect">Connect</button>
+    <button id="copy">Copy log</button>
+    <pre id="log"></pre>
+    <script type="module">
+      import {
+        connectBrowserSession,
+        createDebugConsole,
+        startSession,
+      } from "@voicethere/client/browser";
+
+      const logEl = document.getElementById("log");
+      const debug = createDebugConsole(() => {
+        logEl.textContent = debug.exportText();
+      });
+
+      let session;
+      document.getElementById("connect").onclick = async () => {
+        const projectId = document.getElementById("projectId").value.trim();
+        const started = await startSession({
+          apiBase: window.location.origin,
+          projectId,
+          debug,
+          onStatus: (s) => debug.info("provision", s.status),
+        });
+        if (!started.ok) {
+          debug.error("provision", "failed", started.message);
+          return;
+        }
+        session = await connectBrowserSession({
+          mode: "both",
+          credentials: started.credentials,
+          onDebugEvent: debug,
+        });
+      };
+
+      document.getElementById("copy").onclick = () => {
+        navigator.clipboard.writeText(debug.exportText());
+      };
+    </script>
+  </body>
+</html>

package/templates/embed.html

@@ -0,0 +1,25 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <title>VoiceThere embed</title>
+  </head>
+  <body>
+    <!-- Replace data attributes with your project + client API key -->
+    <script type="module">
+      import { createVoiceThereWidget } from "@voicethere/client/embed";
+
+      createVoiceThereWidget({
+        projectId: document.body.dataset.projectId,
+        apiBase: document.body.dataset.apiBase ?? "https://app.voicethere.dev",
+        clientKey: document.body.dataset.clientKey,
+        mode: "chat",
+      });
+    </script>
+    <div
+      data-project-id="YOUR_PROJECT_UUID"
+      data-client-key="vthc_…"
+      data-api-base="https://app.voicethere.dev"
+    ></div>
+  </body>
+</html>

package/templates/react-use-voicethere.ts

@@ -0,0 +1,52 @@
+/**
+ * React hook starter — copy into your dashboard app.
+ *
+ * Requires `@voicethere/client@^0.3.0` and a deployed project.
+ */
+import { useCallback, useRef, useState } from "react";
+
+import {
+  connectBrowserSession,
+  createDebugConsole,
+  startSession,
+  type BrowserSessionMode,
+} from "@voicethere/client/browser";
+
+export function useVoiceThereSession(
+  projectId: string,
+  mode: BrowserSessionMode = "chat",
+) {
+  const [status, setStatus] = useState("idle");
+  const sessionRef = useRef<Awaited<
+    ReturnType<typeof connectBrowserSession>
+  > | null>(null);
+  const debug = useRef(createDebugConsole()).current;
+
+  const connect = useCallback(async () => {
+    setStatus("provisioning");
+    const provision = await startSession({
+      apiBase: window.location.origin,
+      projectId,
+      onStatus: (s) => setStatus(s.status),
+      debug,
+    });
+    if (!provision.ok) {
+      setStatus(provision.message);
+      return;
+    }
+    sessionRef.current = await connectBrowserSession({
+      mode,
+      credentials: provision.credentials,
+      onDebugEvent: debug,
+    });
+    setStatus("connected");
+  }, [debug, mode, projectId]);
+
+  const disconnect = useCallback(() => {
+    sessionRef.current?.disconnect();
+    sessionRef.current = null;
+    setStatus("idle");
+  }, []);
+
+  return { status, connect, disconnect, debug };
+}