@voicethere/client 0.3.0

package/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog
+
+## 0.3.0 — 2026-06-15
+
+### Added
+
+- `@voicethere/client/browser` — voice + DC text chat, async session provisioning poll, debug console, mic visualizer
+- `@voicethere/client/embed` — `createVoiceThereWidget` floating chat launcher
+- `templates/` — React hook, embed HTML, debug page starters
+- CI workflow and release tag publish (mirror `@voicethere/cli`)
+
+## 0.1.0
+
+- Initial `connectVoiceSession` cloud/local signaling helper

package/README.md

@@ -0,0 +1,74 @@
+# @voicethere/client
+
+Browser and Node client for VoiceThere voice sessions.
+
+## Modes
+
+| Mode | When | Signaling URL |
+|------|------|---------------|
+| **local** | M1 dev — runner on localhost | `ws://127.0.0.1:8080/ws` |
+| **cloud** | M4 — platform session mint | `wss://signaling…/ws?token=<joinToken>` |
+
+Wire protocol: [`@node-webrtc-rust/signaling`](https://www.npmjs.com/package/@node-webrtc-rust/signaling).
+
+## Local (runner direct)
+
+```typescript
+import { connectVoiceSession } from "@voicethere/client";
+
+const client = await connectVoiceSession({
+  mode: "local",
+  signalingUrl: "ws://127.0.0.1:8080/ws",
+  sessionId: "local-dev",
+});
+
+client.on("peer-joined", (peerId) => console.log("peer", peerId));
+```
+
+## Cloud (platform + gateway)
+
+```typescript
+// Use a **client** API key (prefix vthc_) — safe to embed in web/mobile apps.
+// Create one in the dashboard (/api-keys) or: voicethere api-keys create --kind client --project-id <uuid> --name "Web app"
+const res = await fetch("https://app.voicethere.dev/api/v1/sessions", {
+  method: "POST",
+  headers: {
+    Authorization: "Bearer vthc_…",
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify({ project_id: "<uuid>" }),
+});
+
+const credentials = await res.json();
+
+const client = await connectVoiceSession({
+  mode: "cloud",
+  credentials: {
+    sessionId: credentials.session_id,
+    joinToken: credentials.join_token,
+    signalingUrl: credentials.signaling_url,
+    roomId: credentials.room_id,
+    iceServers: credentials.ice_servers,
+  },
+});
+```
+
+## Local stack verify
+
+From workspace root (after M4 smoke infra is up):
+
+```bash
+cd client && npm run demo:cloud
+```
+
+npm publish via GitHub Actions on `release/*` tags — see [`scripts/RELEASE.md`](scripts/RELEASE.md).
+
+## Browser test page
+
+For manual cloud testing with a client API key in the browser:
+
+```bash
+npm run demo:browser
+```
+
+See [`examples/browser-test/README.md`](examples/browser-test/README.md).

package/dist/browser/audio-visualizer.d.ts

@@ -0,0 +1,13 @@
+export type AudioVisualizerOptions = {
+    canvas: HTMLCanvasElement;
+    audioElement?: HTMLAudioElement;
+    mediaStream?: MediaStream;
+    waveColor?: string;
+    barColor?: string;
+};
+export type AudioVisualizer = {
+    stop: () => void;
+    resume: () => void;
+};
+export declare function attachAudioVisualizer(options: AudioVisualizerOptions): AudioVisualizer;
+//# sourceMappingURL=audio-visualizer.d.ts.map

package/dist/browser/audio-visualizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-visualizer.d.ts","sourceRoot":"","sources":["../../src/browser/audio-visualizer.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB,CAAC;AAEF,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,sBAAsB,GAC9B,eAAe,CAwGjB"}

package/dist/browser/audio-visualizer.js

@@ -0,0 +1,86 @@
+export function attachAudioVisualizer(options) {
+    const { canvas, audioElement, mediaStream, waveColor = "#38bdf8", barColor = "#818cf8", } = options;
+    if (!audioElement && !mediaStream) {
+        throw new Error("attachAudioVisualizer requires audioElement or mediaStream");
+    }
+    const ctx = canvas.getContext("2d");
+    if (!ctx) {
+        throw new Error("canvas 2d context unavailable");
+    }
+    const audioCtx = new AudioContext();
+    const analyser = audioCtx.createAnalyser();
+    analyser.fftSize = 2048;
+    analyser.smoothingTimeConstant = 0.75;
+    const streamSource = mediaStream ??
+        (audioElement?.srcObject instanceof MediaStream
+            ? audioElement.srcObject
+            : null);
+    if (streamSource) {
+        audioCtx.createMediaStreamSource(streamSource).connect(analyser);
+    }
+    else if (audioElement) {
+        const source = audioCtx.createMediaElementSource(audioElement);
+        source.connect(analyser);
+        analyser.connect(audioCtx.destination);
+    }
+    else {
+        throw new Error("attachAudioVisualizer requires audioElement or mediaStream");
+    }
+    const ensureRunning = () => {
+        if (audioCtx.state === "suspended") {
+            void audioCtx.resume();
+        }
+    };
+    if (audioElement) {
+        audioElement.addEventListener("playing", ensureRunning);
+    }
+    for (const track of streamSource?.getAudioTracks() ?? []) {
+        track.addEventListener("unmute", ensureRunning);
+    }
+    const timeData = new Uint8Array(analyser.fftSize);
+    const freqData = new Uint8Array(analyser.frequencyBinCount);
+    let rafId = 0;
+    let stopped = false;
+    const draw = () => {
+        if (stopped)
+            return;
+        rafId = requestAnimationFrame(draw);
+        const width = canvas.width;
+        const height = canvas.height;
+        ctx.clearRect(0, 0, width, height);
+        analyser.getByteTimeDomainData(timeData);
+        ctx.lineWidth = 2;
+        ctx.strokeStyle = waveColor;
+        ctx.beginPath();
+        const sliceWidth = width / timeData.length;
+        let x = 0;
+        for (let i = 0; i < timeData.length; i++) {
+            const v = timeData[i] / 128.0;
+            const y = (v * height) / 2;
+            if (i === 0)
+                ctx.moveTo(x, y);
+            else
+                ctx.lineTo(x, y);
+            x += sliceWidth;
+        }
+        ctx.lineTo(width, height / 2);
+        ctx.stroke();
+        analyser.getByteFrequencyData(freqData);
+        const barWidth = width / freqData.length;
+        for (let i = 0; i < freqData.length; i++) {
+            const barHeight = (freqData[i] / 255) * (height * 0.45);
+            ctx.fillStyle = barColor;
+            ctx.fillRect(i * barWidth, height - barHeight, barWidth - 1, barHeight);
+        }
+    };
+    draw();
+    return {
+        stop: () => {
+            stopped = true;
+            cancelAnimationFrame(rafId);
+            void audioCtx.close();
+        },
+        resume: ensureRunning,
+    };
+}
+//# sourceMappingURL=audio-visualizer.js.map

package/dist/browser/audio-visualizer.js.map

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

package/dist/browser/browser-chat-session.d.ts

@@ -0,0 +1,14 @@
+import type { SessionCredentials } from "./session-provision.js";
+import type { DebugConsole } from "./debug-console.js";
+import { type BrowserVoiceSession } from "./browser-voice-session.js";
+export declare const VOICETHERE_CHAT_CHANNEL_LABEL = "voicethere";
+export type BrowserChatSessionOptions = {
+    credentials: SessionCredentials;
+    peerId?: string;
+    onDebugEvent?: DebugConsole;
+};
+/**
+ * DC-only session — connects WebRTC without microphone for text chat debugging.
+ */
+export declare function connectBrowserChatSession(options: BrowserChatSessionOptions): Promise<BrowserVoiceSession>;
+//# sourceMappingURL=browser-chat-session.d.ts.map

package/dist/browser/browser-chat-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-chat-session.d.ts","sourceRoot":"","sources":["../../src/browser/browser-chat-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,4BAA4B,CAAC;AAEpC,eAAO,MAAM,6BAA6B,eAAe,CAAC;AAE1D,MAAM,MAAM,yBAAyB,GAAG;IACtC,WAAW,EAAE,kBAAkB,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B,CAAC;AAEF;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAK9B"}

package/dist/browser/browser-chat-session.js

@@ -0,0 +1,12 @@
+import { connectBrowserVoiceSession, } from "./browser-voice-session.js";
+export const VOICETHERE_CHAT_CHANNEL_LABEL = "voicethere";
+/**
+ * DC-only session — connects WebRTC without microphone for text chat debugging.
+ */
+export async function connectBrowserChatSession(options) {
+    return connectBrowserVoiceSession({
+        ...options,
+        requestMic: false,
+    });
+}
+//# sourceMappingURL=browser-chat-session.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser-chat-session.js","sourceRoot":"","sources":["../../src/browser/browser-chat-session.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,0BAA0B,GAE3B,MAAM,4BAA4B,CAAC;AAEpC,MAAM,CAAC,MAAM,6BAA6B,GAAG,YAAY,CAAC;AAQ1D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,OAAkC;IAElC,OAAO,0BAA0B,CAAC;QAChC,GAAG,OAAO;QACV,UAAU,EAAE,KAAK;KAClB,CAAC,CAAC;AACL,CAAC"}

package/dist/browser/browser-session.d.ts

@@ -0,0 +1,23 @@
+import type { DebugConsole } from "./debug-console.js";
+import type { SessionCredentials } from "./session-provision.js";
+import { type BrowserVoiceSession } from "./browser-voice-session.js";
+export type BrowserSessionMode = "voice" | "chat" | "both";
+export type ConnectBrowserSessionOptions = {
+    mode: BrowserSessionMode;
+    credentials: SessionCredentials;
+    peerId?: string;
+    audioElement?: HTMLAudioElement;
+    onDebugEvent?: DebugConsole;
+};
+export type BrowserSession = BrowserVoiceSession & {
+    mode: BrowserSessionMode;
+};
+export declare function connectBrowserSession(options: ConnectBrowserSessionOptions): Promise<BrowserSession>;
+export { connectBrowserChatSession } from "./browser-chat-session.js";
+export { connectBrowserVoiceSession } from "./browser-voice-session.js";
+export { startSession } from "./session-provision.js";
+export { attachAudioVisualizer } from "./audio-visualizer.js";
+export { createDebugConsole } from "./debug-console.js";
+export type { SessionCredentials, SessionStatusResponse, StartSessionOptions, StartSessionResult, } from "./session-provision.js";
+export type { DebugConsole, DebugEvent } from "./debug-console.js";
+//# sourceMappingURL=browser-session.d.ts.map

package/dist/browser/browser-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-session.d.ts","sourceRoot":"","sources":["../../src/browser/browser-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,4BAA4B,CAAC;AAEpC,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAE3D,MAAM,MAAM,4BAA4B,GAAG;IACzC,IAAI,EAAE,kBAAkB,CAAC;IACzB,WAAW,EAAE,kBAAkB,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,mBAAmB,GAAG;IACjD,IAAI,EAAE,kBAAkB,CAAC;CAC1B,CAAC;AAEF,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,cAAc,CAAC,CAWzB;AAED,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/browser/browser-session.js

@@ -0,0 +1,18 @@
+import { connectBrowserVoiceSession, } from "./browser-voice-session.js";
+export async function connectBrowserSession(options) {
+    const requestMic = options.mode === "voice" || options.mode === "both";
+    const session = await connectBrowserVoiceSession({
+        credentials: options.credentials,
+        peerId: options.peerId,
+        requestMic,
+        audioElement: options.audioElement,
+        onDebugEvent: options.onDebugEvent,
+    });
+    return { ...session, mode: options.mode };
+}
+export { connectBrowserChatSession } from "./browser-chat-session.js";
+export { connectBrowserVoiceSession } from "./browser-voice-session.js";
+export { startSession } from "./session-provision.js";
+export { attachAudioVisualizer } from "./audio-visualizer.js";
+export { createDebugConsole } from "./debug-console.js";
+//# sourceMappingURL=browser-session.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser-session.js","sourceRoot":"","sources":["../../src/browser/browser-session.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,0BAA0B,GAE3B,MAAM,4BAA4B,CAAC;AAgBpC,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAqC;IAErC,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,KAAK,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC;IACvE,MAAM,OAAO,GAAG,MAAM,0BAA0B,CAAC;QAC/C,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,UAAU;QACV,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,YAAY,EAAE,OAAO,CAAC,YAAY;KACnC,CAAC,CAAC;IAEH,OAAO,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;AAC5C,CAAC;AAED,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/browser/browser-voice-session.d.ts

@@ -0,0 +1,20 @@
+import type { SessionCredentials } from "./session-provision.js";
+import type { DebugConsole } from "./debug-console.js";
+export declare const VOICE_AGENT_SERVER_PEER_ID = "voice-agent-server";
+export declare const VOICE_CONTROL_CHANNEL_LABEL = "voice-control";
+export type BrowserVoiceSessionOptions = {
+    credentials: SessionCredentials;
+    peerId?: string;
+    requestMic?: boolean;
+    audioElement?: HTMLAudioElement;
+    onDebugEvent?: DebugConsole;
+};
+export type BrowserVoiceSession = {
+    peerId: string;
+    disconnect: () => void;
+    sendSpeak: (text: string) => void;
+    sendChat: (text: string) => void;
+    getMicStream: () => MediaStream | null;
+};
+export declare function connectBrowserVoiceSession(options: BrowserVoiceSessionOptions): Promise<BrowserVoiceSession>;
+//# sourceMappingURL=browser-voice-session.d.ts.map

package/dist/browser/browser-voice-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-voice-session.d.ts","sourceRoot":"","sources":["../../src/browser/browser-voice-session.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,eAAO,MAAM,0BAA0B,uBAAuB,CAAC;AAC/D,eAAO,MAAM,2BAA2B,kBAAkB,CAAC;AAE3D,MAAM,MAAM,0BAA0B,GAAG;IACvC,WAAW,EAAE,kBAAkB,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,YAAY,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;CACxC,CAAC;AAMF,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,mBAAmB,CAAC,CAkM9B"}

package/dist/browser/browser-voice-session.js

@@ -0,0 +1,174 @@
+import { appendJoinToken } from "../resolve-connection.js";
+export const VOICE_AGENT_SERVER_PEER_ID = "voice-agent-server";
+export const VOICE_CONTROL_CHANNEL_LABEL = "voice-control";
+function defaultPeerId() {
+    return `client-${Math.random().toString(36).slice(2, 10)}`;
+}
+export async function connectBrowserVoiceSession(options) {
+    const debug = options.onDebugEvent;
+    const peerId = options.peerId ?? defaultPeerId();
+    const roomId = options.credentials.room_id;
+    const signalingUrl = appendJoinToken(options.credentials.signaling_url, options.credentials.join_token);
+    const iceServers = options.credentials.ice_servers?.length
+        ? options.credentials.ice_servers
+        : [{ urls: "stun:stun.l.google.com:19302" }];
+    let ws = null;
+    let pc = null;
+    let controlChannel = null;
+    let micStream = null;
+    const pendingIce = [];
+    const sendSignal = (message) => {
+        if (ws?.readyState === WebSocket.OPEN) {
+            ws.send(JSON.stringify(message));
+        }
+    };
+    const sendToServer = (payload) => {
+        sendSignal({ room: roomId, peerId, ...payload });
+    };
+    if (options.requestMic !== false) {
+        micStream = await navigator.mediaDevices.getUserMedia({
+            audio: true,
+            video: false,
+        });
+        debug?.info("voice", "mic_granted");
+    }
+    ws = new WebSocket(signalingUrl);
+    await new Promise((resolve, reject) => {
+        if (!ws)
+            return reject(new Error("WebSocket missing"));
+        ws.onopen = () => {
+            sendSignal({ type: "join", room: roomId, peerId });
+            debug?.info("signaling", "joined", roomId);
+            resolve();
+        };
+        ws.onerror = () => reject(new Error("WebSocket error"));
+    });
+    const wireControl = (channel) => {
+        controlChannel = channel;
+        channel.onopen = () => debug?.info("dc", "open", VOICE_CONTROL_CHANNEL_LABEL);
+        channel.onclose = () => {
+            debug?.info("dc", "close", VOICE_CONTROL_CHANNEL_LABEL);
+            controlChannel = null;
+        };
+        channel.onmessage = (event) => {
+            debug?.debug("dc", "message", String(event.data));
+            try {
+                const message = JSON.parse(String(event.data));
+                if (message.type === "speech_event") {
+                    debug?.info("speech", message.event ?? "event", message.text);
+                }
+                else {
+                    debug?.info("dc", message.type ?? "json", message.text);
+                }
+            }
+            catch {
+                debug?.warn("dc", "malformed", String(event.data));
+            }
+        };
+    };
+    const onServerOffer = async (sdp) => {
+        if (pc) {
+            pc.close();
+            pc = null;
+            pendingIce.length = 0;
+        }
+        pc = new RTCPeerConnection({ iceServers });
+        pc.ontrack = (event) => {
+            if (event.track.kind !== "audio")
+                return;
+            const stream = event.streams[0] ?? new MediaStream([event.track]);
+            if (options.audioElement) {
+                options.audioElement.srcObject = stream;
+                void options.audioElement.play().catch(() => undefined);
+            }
+            debug?.info("webrtc", "agent_audio_track");
+        };
+        pc.ondatachannel = (event) => {
+            if (event.channel.label === VOICE_CONTROL_CHANNEL_LABEL) {
+                wireControl(event.channel);
+            }
+        };
+        pc.onicecandidate = (event) => {
+            if (event.candidate) {
+                sendToServer({
+                    type: "ice-candidate",
+                    targetPeerId: VOICE_AGENT_SERVER_PEER_ID,
+                    candidate: event.candidate.toJSON(),
+                });
+            }
+        };
+        pc.onconnectionstatechange = () => {
+            debug?.info("webrtc", "connection_state", pc?.connectionState);
+        };
+        await pc.setRemoteDescription(sdp);
+        for (const candidate of pendingIce.splice(0)) {
+            await pc.addIceCandidate(candidate);
+        }
+        if (micStream) {
+            for (const track of micStream.getAudioTracks()) {
+                pc.addTrack(track, micStream);
+            }
+        }
+        const answer = await pc.createAnswer();
+        await pc.setLocalDescription(answer);
+        sendToServer({
+            type: "answer",
+            targetPeerId: VOICE_AGENT_SERVER_PEER_ID,
+            sdp: pc.localDescription,
+        });
+        debug?.info("signaling", "answer_sent");
+    };
+    ws.onmessage = (event) => {
+        const message = JSON.parse(String(event.data));
+        debug?.debug("signaling", message.type, message.peerId);
+        switch (message.type) {
+            case "offer":
+                if (message.peerId === VOICE_AGENT_SERVER_PEER_ID && message.sdp) {
+                    void onServerOffer(message.sdp);
+                }
+                break;
+            case "ice-candidate":
+                if (message.peerId === VOICE_AGENT_SERVER_PEER_ID &&
+                    message.candidate &&
+                    pc) {
+                    if (!pc.remoteDescription) {
+                        pendingIce.push(message.candidate);
+                    }
+                    else {
+                        void pc.addIceCandidate(message.candidate);
+                    }
+                }
+                break;
+            default:
+                break;
+        }
+    };
+    return {
+        peerId,
+        getMicStream: () => micStream,
+        sendSpeak: (text) => {
+            if (!controlChannel || controlChannel.readyState !== "open") {
+                debug?.error("dc", "speak_failed", "control channel not open");
+                return;
+            }
+            controlChannel.send(JSON.stringify({ type: "speak", text }));
+            debug?.info("dc", "speak", text);
+        },
+        sendChat: (text) => {
+            if (!controlChannel || controlChannel.readyState !== "open") {
+                debug?.error("dc", "chat_failed", "control channel not open");
+                return;
+            }
+            controlChannel.send(JSON.stringify({ type: "chat", text }));
+            debug?.info("dc", "chat", text);
+        },
+        disconnect: () => {
+            controlChannel?.close();
+            pc?.close();
+            micStream?.getTracks().forEach((track) => track.stop());
+            ws?.close();
+            debug?.info("session", "disconnected");
+        },
+    };
+}
+//# sourceMappingURL=browser-voice-session.js.map

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

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

package/dist/browser/debug-console.d.ts

@@ -0,0 +1,21 @@
+export type DebugEventLevel = "info" | "warn" | "error" | "debug";
+export type DebugEvent = {
+    level: DebugEventLevel;
+    source: string;
+    name: string;
+    detail?: string;
+    raw?: unknown;
+    ts: string;
+};
+export type DebugEventSink = (event: DebugEvent) => void;
+export declare function createDebugConsole(onEvent?: DebugEventSink): {
+    events: () => DebugEvent[];
+    clear: () => void;
+    info: (source: string, name: string, detail?: string, raw?: unknown) => DebugEvent;
+    warn: (source: string, name: string, detail?: string, raw?: unknown) => DebugEvent;
+    error: (source: string, name: string, detail?: string, raw?: unknown) => DebugEvent;
+    debug: (source: string, name: string, detail?: string, raw?: unknown) => DebugEvent;
+    exportText: () => string;
+};
+export type DebugConsole = ReturnType<typeof createDebugConsole>;
+//# sourceMappingURL=debug-console.d.ts.map

package/dist/browser/debug-console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-console.d.ts","sourceRoot":"","sources":["../../src/browser/debug-console.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAElE,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,eAAe,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;AAEzD,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,cAAc;;;mBAkBxC,MAAM,QAAQ,MAAM,WAAW,MAAM,QAAQ,OAAO;mBAEpD,MAAM,QAAQ,MAAM,WAAW,MAAM,QAAQ,OAAO;oBAEnD,MAAM,QAAQ,MAAM,WAAW,MAAM,QAAQ,OAAO;oBAEpD,MAAM,QAAQ,MAAM,WAAW,MAAM,QAAQ,OAAO;;EAUvE;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/browser/debug-console.js

@@ -0,0 +1,29 @@
+export function createDebugConsole(onEvent) {
+    const events = [];
+    const emit = (partial) => {
+        const event = {
+            ...partial,
+            ts: new Date().toISOString(),
+        };
+        events.push(event);
+        onEvent?.(event);
+        return event;
+    };
+    return {
+        events: () => [...events],
+        clear: () => {
+            events.length = 0;
+        },
+        info: (source, name, detail, raw) => emit({ level: "info", source, name, detail, raw }),
+        warn: (source, name, detail, raw) => emit({ level: "warn", source, name, detail, raw }),
+        error: (source, name, detail, raw) => emit({ level: "error", source, name, detail, raw }),
+        debug: (source, name, detail, raw) => emit({ level: "debug", source, name, detail, raw }),
+        exportText: () => events
+            .map((event) => {
+            const detail = event.detail ? `: ${event.detail}` : "";
+            return `${event.ts} [${event.level}] ${event.source}/${event.name}${detail}`;
+        })
+            .join("\n"),
+    };
+}
+//# sourceMappingURL=debug-console.js.map

package/dist/browser/debug-console.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-console.js","sourceRoot":"","sources":["../../src/browser/debug-console.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,kBAAkB,CAAC,OAAwB;IACzD,MAAM,MAAM,GAAiB,EAAE,CAAC;IAEhC,MAAM,IAAI,GAAG,CAAC,OAA+B,EAAE,EAAE;QAC/C,MAAM,KAAK,GAAe;YACxB,GAAG,OAAO;YACV,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SAC7B,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnB,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;QACjB,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,OAAO;QACL,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC;QACzB,KAAK,EAAE,GAAG,EAAE;YACV,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QACpB,CAAC;QACD,IAAI,EAAE,CAAC,MAAc,EAAE,IAAY,EAAE,MAAe,EAAE,GAAa,EAAE,EAAE,CACrE,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;QACpD,IAAI,EAAE,CAAC,MAAc,EAAE,IAAY,EAAE,MAAe,EAAE,GAAa,EAAE,EAAE,CACrE,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;QACpD,KAAK,EAAE,CAAC,MAAc,EAAE,IAAY,EAAE,MAAe,EAAE,GAAa,EAAE,EAAE,CACtE,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;QACrD,KAAK,EAAE,CAAC,MAAc,EAAE,IAAY,EAAE,MAAe,EAAE,GAAa,EAAE,EAAE,CACtE,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;QACrD,UAAU,EAAE,GAAG,EAAE,CACf,MAAM;aACH,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YACb,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvD,OAAO,GAAG,KAAK,CAAC,EAAE,KAAK,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,GAAG,MAAM,EAAE,CAAC;QAC/E,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC;KAChB,CAAC;AACJ,CAAC"}

package/dist/browser/session-provision.d.ts

@@ -0,0 +1,52 @@
+import type { DebugConsole } from "./debug-console.js";
+export type SessionFailureCode = "NOT_DEPLOYED" | "RUNNER_UNAVAILABLE" | "ORCHESTRATOR_ERROR" | "JOIN_TOKEN_ERROR" | "TIMEOUT";
+export type SessionJobStatus = "queued" | "provisioning" | "ready" | "failed";
+export type SessionCredentials = {
+    session_id: string;
+    join_token: string;
+    signaling_url: string;
+    room_id: string;
+    ice_servers: Array<{
+        urls: string | string[];
+        username?: string;
+        credential?: string;
+    }>;
+    expires_at: string;
+};
+export type SessionStatusResponse = {
+    session_id: string;
+    status: SessionJobStatus;
+    project_id: string;
+    build_id: string | null;
+    failure_code?: SessionFailureCode | null;
+    failure_message?: string | null;
+    credentials?: SessionCredentials | null;
+    created_at: string;
+    updated_at: string;
+    completed_at?: string | null;
+};
+export type StartSessionOptions = {
+    apiBase: string;
+    projectId: string;
+    buildId?: string;
+    async?: boolean;
+    headers?: Record<string, string>;
+    pollIntervalMs?: number;
+    pollTimeoutMs?: number;
+    onStatus?: (status: SessionStatusResponse) => void;
+    debug?: DebugConsole;
+};
+export type StartSessionResult = {
+    ok: true;
+    credentials: SessionCredentials;
+    jobId: string;
+} | {
+    ok: false;
+    code: SessionFailureCode | "TIMEOUT" | "HTTP_ERROR";
+    message: string;
+};
+/**
+ * POST /api/v1/sessions with async=true and poll GET until ready or failed.
+ */
+export declare function startSession(options: StartSessionOptions): Promise<StartSessionResult>;
+//# sourceMappingURL=session-provision.d.ts.map

package/dist/browser/session-provision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-provision.d.ts","sourceRoot":"","sources":["../../src/browser/session-provision.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,MAAM,kBAAkB,GAC1B,cAAc,GACd,oBAAoB,GACpB,oBAAoB,GACpB,kBAAkB,GAClB,SAAS,CAAC;AAEd,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,cAAc,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE9E,MAAM,MAAM,kBAAkB,GAAG;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,KAAK,CAAC;QACjB,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,gBAAgB,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACzC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,WAAW,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACnD,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAC1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,WAAW,EAAE,kBAAkB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC5D;IACE,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,kBAAkB,GAAG,SAAS,GAAG,YAAY,CAAC;IACpD,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AA4DN;;GAEG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CA2D7B"}