@voxagent/bridge 0.1.0

package/README.md

@@ -0,0 +1,74 @@
+# @voxagent/bridge
+
+Local bridge process that pairs the host's Claude Code or Codex agent with a VoxAgent meeting room.
+
+## What it does
+
+When a host pairs from the VoxAgent web app, this process:
+
+1. Joins the LiveKit room as a real participant (identity `agent:<roomId>`).
+2. Publishes a synthesized voice track via ElevenLabs (or stays silent in `--text-only`).
+3. Listens on a LiveKit data channel for `prompt.user_turn` events from any participant.
+4. Drives the host's local Claude Code (`@anthropic-ai/claude-agent-sdk`) or Codex CLI (`codex exec --json`) agent with the prompt.
+5. Streams text deltas, tool calls, and run lifecycle events back to the room — UI gets subtitles + activity timeline, audio track gets the spoken response.
+
+Trust mode by default: the agent runs under the host's existing CLI permission settings, no in-room approval gate.
+
+## Quickstart
+
+From the monorepo root:
+
+```bash
+# 1. Make sure your local agent is installed and logged in
+#    Claude:  npm i -g @anthropic-ai/claude-code   &&  claude
+#    Codex:   npm i -g @openai/codex                &&  codex login
+
+# 2. In one terminal, run the web app
+pnpm --dir apps/web dev
+
+# 3. In a browser, open the room and click "Pair local agent" — copy the 6-digit code
+
+# 4. In another terminal, run the bridge
+export VOXAGENT_ELEVENLABS_API_KEY=...        # required for voice; --text-only to skip
+pnpm --filter @voxagent/bridge dev -- --code 123456 --agent claude
+```
+
+Or after a `pnpm --filter @voxagent/bridge build`:
+
+```bash
+node packages/bridge/dist/cli.js --code 123456 --agent claude
+```
+
+## Flags
+
+| Flag | Env | Default | Notes |
+|------|-----|---------|-------|
+| `--code <CODE>` | `VOXAGENT_PAIR_CODE` | (interactive prompt) | 6-digit code from the room UI |
+| `--api-url <URL>` | `VOXAGENT_API_URL` | `http://localhost:3000` | VoxAgent web app base URL |
+| `--agent <BACKEND>` | `VOXAGENT_AGENT` | `claude` | `claude` or `codex` |
+| `--cwd <PATH>` | `VOXAGENT_CWD` | `process.cwd()` | Working directory the agent runs inside |
+| `--voice <VOICE_ID>` | `VOXAGENT_VOICE_ID` | `21m00Tcm4TlvDq8ikWAM` | ElevenLabs voice ID |
+| `--model <MODEL_ID>` | `VOXAGENT_MODEL_ID` | `eleven_turbo_v2_5` | ElevenLabs model ID |
+| `--text-only` | `VOXAGENT_TEXT_ONLY=1` | `false` | Skip TTS — text-only mode (subtitles in UI, no voice) |
+| `--verbose` | — | `false` | Debug logs |
+
+`VOXAGENT_ELEVENLABS_API_KEY` (or `ELEVENLABS_API_KEY`) is required unless `--text-only` is set.
+
+## Architecture
+
+See [`/docs/learning-reviews/`](../../docs/learning-reviews) and the refactor plan at `/Users/tanmay/.claude/plans/ok-i-want-you-refactored-wadler.md` for full background.
+
+```
+Browser  ──LiveKit data channel──▶  Bridge  ──@anthropic-ai/claude-agent-sdk──▶ Claude Code
+   ▲                                  │                                       (or `codex exec --json`)
+   │                                  ▼
+   └────agent voice track────  AudioSource ◀── ElevenLabs PCM ◀── text deltas
+```
+
+## Testing
+
+```bash
+pnpm --filter @voxagent/bridge test
+```
+
+Unit tests mock the SDK and subprocess so they run offline.

package/dist/audio/source.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @file Wraps a LiveKit AudioSource so we can push TTS frames + flush on interrupt.
+ */
+import type { Room } from '@livekit/rtc-node';
+import type { TtsFrame } from '../tts/types.js';
+export declare class AgentAudioPublisher {
+    private source;
+    private track;
+    private published;
+    constructor(sampleRate: number, numChannels: number);
+    publish(room: Room): Promise<void>;
+    pushFrame(frame: TtsFrame): Promise<void>;
+    waitForPlayout(): Promise<void>;
+    /**
+     * Best-effort flush — clears anything in-flight inside the source's queue.
+     *
+     * @livekit/rtc-node's AudioSource exposes `clearQueue()` in newer versions.
+     * We optionally call it; falls back to a noop when unavailable.
+     */
+    flush(): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=source.d.ts.map

package/dist/audio/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../src/audio/source.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAKhD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,SAAS,CAAS;gBAEd,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAK7C,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAalC,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAWzC,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAQrC;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAatB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B"}

package/dist/audio/source.js

@@ -0,0 +1,69 @@
+/**
+ * @file Wraps a LiveKit AudioSource so we can push TTS frames + flush on interrupt.
+ */
+import { AudioFrame, AudioSource, LocalAudioTrack, TrackPublishOptions, TrackSource } from '@livekit/rtc-node';
+import { log } from '../logging.js';
+const TRACK_NAME = 'voxagent-agent-voice';
+export class AgentAudioPublisher {
+    source;
+    track;
+    published = false;
+    constructor(sampleRate, numChannels) {
+        this.source = new AudioSource(sampleRate, numChannels);
+        this.track = LocalAudioTrack.createAudioTrack(TRACK_NAME, this.source);
+    }
+    async publish(room) {
+        if (this.published)
+            return;
+        const local = room.localParticipant;
+        if (!local) {
+            throw new Error('Cannot publish agent audio: room has no local participant.');
+        }
+        const opts = new TrackPublishOptions();
+        opts.source = TrackSource.SOURCE_MICROPHONE;
+        await local.publishTrack(this.track, opts);
+        this.published = true;
+        log.info('agent_audio_track_published', { name: TRACK_NAME });
+    }
+    async pushFrame(frame) {
+        const samplesPerChannel = frame.samples.length / frame.numChannels;
+        const audioFrame = new AudioFrame(frame.samples, frame.sampleRate, frame.numChannels, samplesPerChannel);
+        await this.source.captureFrame(audioFrame);
+    }
+    async waitForPlayout() {
+        try {
+            await this.source.waitForPlayout();
+        }
+        catch {
+            // ignore — happens during interrupt
+        }
+    }
+    /**
+     * Best-effort flush — clears anything in-flight inside the source's queue.
+     *
+     * @livekit/rtc-node's AudioSource exposes `clearQueue()` in newer versions.
+     * We optionally call it; falls back to a noop when unavailable.
+     */
+    async flush() {
+        const maybeClear = this.source.clearQueue;
+        if (typeof maybeClear === 'function') {
+            try {
+                await Promise.resolve(maybeClear.call(this.source));
+            }
+            catch (error) {
+                log.debug('agent_audio_flush_failed', {
+                    message: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+    }
+    async close() {
+        try {
+            await this.source.close();
+        }
+        catch {
+            // ignore
+        }
+    }
+}
+//# sourceMappingURL=source.js.map

package/dist/audio/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../src/audio/source.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAG/G,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEpC,MAAM,UAAU,GAAG,sBAAsB,CAAC;AAE1C,MAAM,OAAO,mBAAmB;IACtB,MAAM,CAAc;IACpB,KAAK,CAAkB;IACvB,SAAS,GAAG,KAAK,CAAC;IAE1B,YAAY,UAAkB,EAAE,WAAmB;QACjD,IAAI,CAAC,MAAM,GAAG,IAAI,WAAW,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QACvD,IAAI,CAAC,KAAK,GAAG,eAAe,CAAC,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAU;QACtB,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC;QACpC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAChF,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,mBAAmB,EAAE,CAAC;QACvC,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC,iBAAiB,CAAC;QAC5C,MAAM,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,GAAG,CAAC,IAAI,CAAC,6BAA6B,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAe;QAC7B,MAAM,iBAAiB,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC;QACnE,MAAM,UAAU,GAAG,IAAI,UAAU,CAC/B,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,WAAW,EACjB,iBAAiB,CAClB,CAAC;QACF,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QACrC,CAAC;QAAC,MAAM,CAAC;YACP,oCAAoC;QACtC,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,UAAU,GAAI,IAAI,CAAC,MAAiE,CAAC,UAAU,CAAC;QACtG,IAAI,OAAO,UAAU,KAAK,UAAU,EAAE,CAAC;YACrC,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;YACtD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,GAAG,CAAC,KAAK,CAAC,0BAA0B,EAAE;oBACpC,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;iBAChE,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;CACF"}

package/dist/cli.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * @file Bridge CLI entry point.
+ *
+ * Pair flow:
+ *   1. Read pair code (CLI arg / env / interactive prompt).
+ *   2. Discover capabilities for the selected backend.
+ *   3. POST capabilities + code → /api/bridge/pair to get LiveKit credentials.
+ *   4. Start the room runtime.
+ *   5. Handle SIGINT cleanly.
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG"}

package/dist/cli.js

@@ -0,0 +1,171 @@
+#!/usr/bin/env node
+/**
+ * @file Bridge CLI entry point.
+ *
+ * Pair flow:
+ *   1. Read pair code (CLI arg / env / interactive prompt).
+ *   2. Discover capabilities for the selected backend.
+ *   3. POST capabilities + code → /api/bridge/pair to get LiveKit credentials.
+ *   4. Start the room runtime.
+ *   5. Handle SIGINT cleanly.
+ */
+import { Command } from 'commander';
+import { dispose } from '@livekit/rtc-node';
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { stdin as input, stdout as output } from 'node:process';
+import { createInterface } from 'node:readline/promises';
+import { buildBridgeConfig } from './config.js';
+import { createDriver } from './drivers/index.js';
+import { exchangePairCode } from './pair.js';
+import { PermissionBroker } from './permissions.js';
+import { BridgeRoomRuntime } from './room.js';
+import { log, setLogLevel } from './logging.js';
+/**
+ * Loads `.env.local` (or `.env`) from the bridge's cwd, walking up one
+ * directory at a time until it finds one or hits the filesystem root.
+ *
+ * Designed so a host who keeps secrets in the VoxAgent repo's
+ * `.env.local` (Next.js convention) gets the same env in the bridge
+ * process without having to `source` the file by hand. Existing
+ * environment values win — sourced files don't override what the user
+ * already exported.
+ */
+function loadDotenv() {
+    const filenames = ['.env.local', '.env'];
+    let dir = process.cwd();
+    for (let depth = 0; depth < 8; depth++) {
+        for (const name of filenames) {
+            const path = join(dir, name);
+            if (existsSync(path)) {
+                try {
+                    const text = readFileSync(path, 'utf-8');
+                    for (const line of text.split('\n')) {
+                        const trimmed = line.trim();
+                        if (!trimmed || trimmed.startsWith('#'))
+                            continue;
+                        const eq = trimmed.indexOf('=');
+                        if (eq < 0)
+                            continue;
+                        const key = trimmed.slice(0, eq).trim();
+                        if (!key || key in process.env)
+                            continue;
+                        let value = trimmed.slice(eq + 1).trim();
+                        if ((value.startsWith('"') && value.endsWith('"')) ||
+                            (value.startsWith("'") && value.endsWith("'"))) {
+                            value = value.slice(1, -1);
+                        }
+                        process.env[key] = value;
+                    }
+                    return { loaded: path };
+                }
+                catch {
+                    // ignore — fall through to next candidate
+                }
+            }
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return { loaded: null };
+}
+async function main() {
+    const dotenv = loadDotenv();
+    if (dotenv.loaded) {
+        log.info('bridge_dotenv_loaded', { path: dotenv.loaded });
+    }
+    const program = new Command();
+    // pnpm and some script runners forward a literal `--` separator into argv.
+    // Commander treats `--` as end-of-options, so stripping it lets users invoke
+    // either `pnpm ... dev -- --code 123` or `pnpm ... dev --code 123` reliably.
+    const cleanedArgv = process.argv.filter((arg, index) => !(index >= 2 && arg === '--'));
+    program
+        .name('voxagent-bridge')
+        .description('Pair the host\'s local Claude Code or Codex agent with a VoxAgent meeting.')
+        .option('-c, --code <CODE>', '6-digit pair code shown in the meeting room')
+        .option('-u, --api-url <URL>', 'VoxAgent web app base URL (default: http://localhost:3000)')
+        .option('-a, --agent <BACKEND>', 'Agent backend: claude | codex')
+        .option('--cwd <PATH>', 'Working directory the agent should run in (default: cwd)')
+        .option('--tts <PROVIDER>', 'TTS provider: elevenlabs (default) | openai (uses OPENAI_API_KEY)')
+        .option('--voice <VOICE_ID>', 'Voice ID — ElevenLabs voice ID, or OpenAI voice name (alloy, nova, shimmer, ...)')
+        .option('--model <MODEL_ID>', 'TTS model — ElevenLabs model ID, or OpenAI tts-1 / tts-1-hd / gpt-4o-mini-tts')
+        .option('--audio-format <FORMAT>', 'ElevenLabs PCM format: pcm_16000 (default, Starter+) | pcm_22050 (Creator+) | pcm_24000 (Pro+) | pcm_44100 (Pro+)')
+        .option('--text-only', 'Skip TTS — for environments without ElevenLabs credentials')
+        .option('--llm-model <ID>', 'Agent LLM model (e.g. claude-opus-4-7, claude-sonnet-4-6, gpt-5-codex)')
+        .option('--full-access', 'Disable the workspace sandbox so the agent can read/write anywhere on this machine')
+        .option('-v, --verbose', 'Enable debug logging')
+        .parse(cleanedArgv);
+    const flags = program.opts();
+    if (flags.verbose)
+        setLogLevel('debug');
+    if (!flags.code) {
+        const envCode = process.env.VOXAGENT_PAIR_CODE;
+        if (!envCode) {
+            const rl = createInterface({ input, output });
+            const entered = (await rl.question('Pair code: ')).trim();
+            rl.close();
+            flags.code = entered;
+        }
+    }
+    const config = buildBridgeConfig(flags);
+    log.info('bridge_config_resolved', {
+        backend: config.backend,
+        apiBaseUrl: config.apiBaseUrl,
+        cwd: config.cwd,
+        llmModel: config.llmModel,
+        fullAccess: config.fullAccess,
+        textOnly: config.textOnly,
+    });
+    const permissionBroker = new PermissionBroker({
+        workspaceCwd: config.cwd,
+        fullAccess: config.fullAccess,
+    });
+    const driver = createDriver(config.backend, {
+        ...(config.llmModel ? { model: config.llmModel } : {}),
+        fullAccess: config.fullAccess,
+        permissionResolver: permissionBroker,
+    });
+    const capabilities = await driver.capabilities(config.cwd);
+    log.info('bridge_capabilities', {
+        backend: capabilities.backend,
+        skills: capabilities.skills.length,
+        plugins: capabilities.plugins.length,
+        mcpServers: capabilities.mcpServers.length,
+    });
+    log.info('bridge_pairing', { apiBaseUrl: config.apiBaseUrl });
+    const pair = await exchangePairCode({
+        apiBaseUrl: config.apiBaseUrl,
+        pairCode: config.pairCode,
+        capabilities,
+    });
+    log.info('bridge_paired', { roomId: pair.roomId, roomName: pair.roomName, hostName: pair.hostName });
+    const runtime = new BridgeRoomRuntime({ config, pair, driver, capabilities, permissionBroker });
+    await runtime.start();
+    log.info('bridge_ready');
+    const shutdown = async (signal) => {
+        log.info('bridge_shutdown_signal', { signal });
+        try {
+            await runtime.shutdown('shutdown');
+        }
+        finally {
+            try {
+                await dispose();
+            }
+            catch {
+                // ignore
+            }
+            process.exit(0);
+        }
+    };
+    process.once('SIGINT', () => void shutdown('SIGINT'));
+    process.once('SIGTERM', () => void shutdown('SIGTERM'));
+}
+main().catch((error) => {
+    log.error('bridge_fatal', {
+        message: error instanceof Error ? error.message : String(error),
+    });
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @file Bridge runtime configuration resolved from CLI args + environment.
+ */
+import type { AgentBackend } from './protocol.js';
+import type { ElevenLabsAudioFormat, TtsProvider } from './tts/index.js';
+export interface BridgeConfig {
+    /** VoxAgent web app base URL — where the pair endpoint lives. */
+    apiBaseUrl: string;
+    /** 6-digit pair code obtained from the host's browser. */
+    pairCode: string;
+    /** Agent backend driver selection. */
+    backend: AgentBackend;
+    /** Working directory the agent will operate inside. */
+    cwd: string;
+    /** TTS provider selection. */
+    ttsProvider: TtsProvider;
+    /** ElevenLabs API key (required for ElevenLabs provider). */
+    elevenLabsApiKey: string | null;
+    /** OpenAI API key (required for OpenAI provider). */
+    openAiApiKey: string | null;
+    /** Voice ID — ElevenLabs voice ID or OpenAI voice name (alloy, nova, etc.). */
+    ttsVoiceId: string;
+    /** Model ID — ElevenLabs model ID or OpenAI TTS model (tts-1, tts-1-hd, gpt-4o-mini-tts). */
+    ttsModelId: string;
+    /**
+     * ElevenLabs output format. Defaults to `pcm_16000` (Starter+ tier);
+     * upgrade to `pcm_22050` (Creator+) or `pcm_44100` (Pro+) if your
+     * subscription tier allows. Ignored for the OpenAI provider.
+     */
+    elevenLabsAudioFormat: ElevenLabsAudioFormat;
+    /** When set, skip TTS entirely (text-only mode). */
+    textOnly: boolean;
+    /** LLM model override for the agent backend. */
+    llmModel: string | null;
+    /**
+     * When true, the agent runs without its native workspace sandbox
+     * (Codex `--dangerously-bypass-approvals-and-sandbox`, Claude
+     * `permissionMode: bypassPermissions`). Default is false — agents stay
+     * within their workspace.
+     */
+    fullAccess: boolean;
+}
+interface CliFlags {
+    code?: string;
+    apiUrl?: string;
+    agent?: string;
+    cwd?: string;
+    voice?: string;
+    model?: string;
+    llmModel?: string;
+    audioFormat?: string;
+    textOnly?: boolean;
+    fullAccess?: boolean;
+    tts?: string;
+}
+/**
+ * Detects which CLI agent is available on PATH so `--agent` can default sensibly.
+ */
+export declare function autoDetectBackend(): AgentBackend;
+export declare function buildBridgeConfig(flags: CliFlags): BridgeConfig;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEzE,MAAM,WAAW,YAAY;IAC3B,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,OAAO,EAAE,YAAY,CAAC;IACtB,uDAAuD;IACvD,GAAG,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,WAAW,EAAE,WAAW,CAAC;IACzB,6DAA6D;IAC7D,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,qDAAqD;IACrD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,+EAA+E;IAC/E,UAAU,EAAE,MAAM,CAAC;IACnB,6FAA6F;IAC7F,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,qBAAqB,EAAE,qBAAqB,CAAC;IAC7C,oDAAoD;IACpD,QAAQ,EAAE,OAAO,CAAC;IAClB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB;;;;;OAKG;IACH,UAAU,EAAE,OAAO,CAAC;CACrB;AAiBD,UAAU,QAAQ;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,YAAY,CAMhD;AAoCD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,GAAG,YAAY,CAsD/D"}

package/dist/config.js

@@ -0,0 +1,102 @@
+/**
+ * @file Bridge runtime configuration resolved from CLI args + environment.
+ */
+const DEFAULT_API_BASE_URL = 'http://localhost:3000';
+const DEFAULT_ELEVENLABS_VOICE_ID = '21m00Tcm4TlvDq8ikWAM'; // Rachel
+const DEFAULT_ELEVENLABS_MODEL_ID = 'eleven_turbo_v2_5';
+const DEFAULT_OPENAI_VOICE = 'alloy';
+const DEFAULT_OPENAI_MODEL = 'tts-1';
+const DEFAULT_TTS_PROVIDER = 'elevenlabs';
+const VALID_TTS_PROVIDERS = new Set(['elevenlabs', 'openai']);
+const DEFAULT_AUDIO_FORMAT = 'pcm_16000';
+const VALID_AUDIO_FORMATS = new Set([
+    'pcm_16000',
+    'pcm_22050',
+    'pcm_24000',
+    'pcm_44100',
+]);
+/**
+ * Detects which CLI agent is available on PATH so `--agent` can default sensibly.
+ */
+export function autoDetectBackend() {
+    // Defer to env if user prefers one but didn't pass --agent
+    const envBackend = process.env.VOXAGENT_AGENT?.toLowerCase();
+    if (envBackend === 'claude' || envBackend === 'codex')
+        return envBackend;
+    // Default to claude — Anthropic SDK is bundled.
+    return 'claude';
+}
+function resolveTtsProvider(raw) {
+    if (!raw)
+        return DEFAULT_TTS_PROVIDER;
+    const normalized = raw.trim().toLowerCase();
+    if (VALID_TTS_PROVIDERS.has(normalized))
+        return normalized;
+    throw new Error(`Unknown --tts "${raw}". Use "elevenlabs" or "openai".`);
+}
+function resolveAudioFormat(raw) {
+    if (!raw)
+        return DEFAULT_AUDIO_FORMAT;
+    const normalized = raw.trim().toLowerCase();
+    if (VALID_AUDIO_FORMATS.has(normalized)) {
+        return normalized;
+    }
+    throw new Error(`Unknown --audio-format "${raw}". Use one of: pcm_16000, pcm_22050, pcm_24000, pcm_44100.`);
+}
+/**
+ * Strips a single matching pair of surrounding quotes from a path. Useful when
+ * shell-quoting leaks through (e.g. macOS "Copy as Pathname" wraps paths with
+ * spaces in single quotes) or when a user pastes `'$HOME/proj'` literally.
+ */
+function unquotePath(value) {
+    const trimmed = value.trim();
+    if (trimmed.length < 2)
+        return trimmed;
+    const first = trimmed[0];
+    const last = trimmed[trimmed.length - 1];
+    if ((first === "'" && last === "'") || (first === '"' && last === '"')) {
+        return trimmed.slice(1, -1);
+    }
+    return trimmed;
+}
+export function buildBridgeConfig(flags) {
+    const pairCode = (flags.code ?? process.env.VOXAGENT_PAIR_CODE ?? '').trim();
+    if (!pairCode) {
+        throw new Error('A pair code is required. Pass --code <CODE> or set VOXAGENT_PAIR_CODE.');
+    }
+    const requestedBackend = (flags.agent ?? process.env.VOXAGENT_AGENT ?? '').toLowerCase();
+    let backend;
+    if (requestedBackend === 'claude' || requestedBackend === 'codex') {
+        backend = requestedBackend;
+    }
+    else if (requestedBackend === '') {
+        backend = autoDetectBackend();
+    }
+    else {
+        throw new Error(`Unknown --agent "${requestedBackend}". Use "claude" or "codex".`);
+    }
+    const apiBaseUrl = (flags.apiUrl ??
+        process.env.VOXAGENT_API_URL ??
+        DEFAULT_API_BASE_URL).replace(/\/+$/, '');
+    const rawCwd = flags.cwd ?? process.env.VOXAGENT_CWD;
+    const cwd = rawCwd ? unquotePath(rawCwd) : process.cwd();
+    const ttsProvider = resolveTtsProvider(flags.tts ?? process.env.VOXAGENT_TTS);
+    const providerVoiceDefault = ttsProvider === 'openai' ? DEFAULT_OPENAI_VOICE : DEFAULT_ELEVENLABS_VOICE_ID;
+    const providerModelDefault = ttsProvider === 'openai' ? DEFAULT_OPENAI_MODEL : DEFAULT_ELEVENLABS_MODEL_ID;
+    return {
+        apiBaseUrl,
+        pairCode,
+        backend,
+        cwd,
+        ttsProvider,
+        elevenLabsApiKey: process.env.VOXAGENT_ELEVENLABS_API_KEY ?? process.env.ELEVENLABS_API_KEY ?? null,
+        openAiApiKey: process.env.VOXAGENT_OPENAI_API_KEY ?? process.env.OPENAI_API_KEY ?? null,
+        ttsVoiceId: flags.voice ?? process.env.VOXAGENT_VOICE_ID ?? providerVoiceDefault,
+        ttsModelId: flags.model ?? process.env.VOXAGENT_MODEL_ID ?? providerModelDefault,
+        elevenLabsAudioFormat: resolveAudioFormat(flags.audioFormat ?? process.env.VOXAGENT_AUDIO_FORMAT),
+        textOnly: flags.textOnly === true || process.env.VOXAGENT_TEXT_ONLY === '1',
+        llmModel: (flags.llmModel ?? process.env.VOXAGENT_LLM_MODEL ?? '').trim() || null,
+        fullAccess: flags.fullAccess === true || process.env.VOXAGENT_FULL_ACCESS === '1',
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/drivers/claude.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @file Claude Code driver — drives `@anthropic-ai/claude-agent-sdk`.
+ *
+ * Translates the SDK's `SDKMessage` and `SDKStreamEvent` outputs into our
+ * normalized `DriverEvent` stream.
+ *
+ * Streaming details (per SDK reference):
+ *   - With `includePartialMessages: true`, every Anthropic API event is
+ *     emitted as a `stream_event` SDKMessage.
+ *   - Text deltas: `content_block_delta` with `delta.type === 'text_delta'`.
+ *   - Tool start: `content_block_start` where `content_block.type === 'tool_use'`.
+ *   - Tool input streaming: `content_block_delta` with `input_json_delta`.
+ *   - Tool end: `content_block_stop`.
+ *   - Tool results / progress: surface via `user` messages with tool_result
+ *     blocks (post-execution); we use these to flag success/error + payload.
+ *   - Run end: `result` SDKMessage; subtype `success` / `error_*` / `interrupted`.
+ */
+import type { CapabilitiesInfo } from '../protocol.js';
+import type { DriverOptions } from './index.js';
+import type { AgentDriver, DriverEvent, DriverRunInput } from './types.js';
+export declare class ClaudeDriver implements AgentDriver {
+    private readonly options;
+    readonly backend: "claude";
+    /** Most recent Claude Code session ID, used to keep room context across turns. */
+    private sessionId;
+    /** Currently active query handle, used for `interrupt()`. */
+    private activeQuery;
+    constructor(options?: DriverOptions);
+    capabilities(cwd: string): Promise<CapabilitiesInfo>;
+    run(input: DriverRunInput, signal: AbortSignal): AsyncIterable<DriverEvent>;
+    close(): Promise<void>;
+    private discoverSkills;
+    private discoverPlugins;
+    private discoverMcpServers;
+}
+//# sourceMappingURL=claude.d.ts.map

package/dist/drivers/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/drivers/claude.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAQH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAiB3E,qBAAa,YAAa,YAAW,WAAW;IASlC,OAAO,CAAC,QAAQ,CAAC,OAAO;IARpC,QAAQ,CAAC,OAAO,EAAG,QAAQ,CAAU;IAErC,kFAAkF;IAClF,OAAO,CAAC,SAAS,CAAuB;IAExC,6DAA6D;IAC7D,OAAO,CAAC,WAAW,CAAsB;gBAEZ,OAAO,GAAE,aAAkB;IAElD,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAiBnD,GAAG,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,GAAG,aAAa,CAAC,WAAW,CAAC;IAwM5E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAWd,cAAc;YA4Bd,eAAe;YAiBf,kBAAkB;CAajC"}