@fabric-harness/sdk 1.11.0 → 1.12.1

package/dist/voice-pipeline.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Pipeline voice mode: composes a streaming `SttProvider`, a text
+ * `ModelProvider`, and a streaming `TtsProvider` into a `VoiceSession`.
+ * Use this for ElevenLabs / Cartesia / Deepgram and any future
+ * single-modality vendor combo.
+ *
+ * For monolithic realtime models (OpenAI Realtime), use
+ * `OpenAIRealtimeVoiceProvider` directly — that path is lower-latency and
+ * includes server-side VAD.
+ *
+ * Conversation flow:
+ *   user speech → STT → final transcript → LLM → text chunks → TTS →
+ *   audio bytes back to caller. Tool calls relay through the existing
+ *   `tool_call` / `submitToolResult` contract on `VoiceSession`.
+ *
+ * Barge-in: when the STT emits `speech_started` while we're speaking,
+ * the in-flight TTS stream is aborted and the LLM call cancelled. The
+ * caller should also stop playback in their UI.
+ *
+ * Cost: rolled up across STT seconds, LLM tokens, TTS characters into a
+ * single `usage` object on `response_done`. `costBudget` observes the
+ * total — same `cost_limit` event semantics as realtime mode.
+ */
+import type { ModelProvider } from './model.js';
+import type { SttProvider } from './voice-stt.js';
+import type { TtsProvider } from './voice-tts.js';
+import type { VoiceConnectOptions, VoiceProvider, VoiceSession } from './voice.js';
+export interface PipelineVoiceProviderOptions {
+    /** STT provider (e.g. Deepgram). Default model + format come from the provider. */
+    stt: SttProvider;
+    /** TTS provider (e.g. ElevenLabs). */
+    tts: TtsProvider;
+    /** LLM provider. Reuses any existing `ModelProvider` — Anthropic, OpenAI, Gemini, gateways. */
+    llm: ModelProvider;
+    /** Model id to forward in `ModelRequest`. */
+    model: string;
+    /** Provider name override for telemetry. Default `pipeline:<stt>+<tts>`. */
+    name?: string;
+}
+export declare class PipelineVoiceProvider implements VoiceProvider {
+    readonly name: string;
+    private readonly stt;
+    private readonly tts;
+    private readonly llm;
+    private readonly model;
+    constructor(options: PipelineVoiceProviderOptions);
+    connect(options?: VoiceConnectOptions): Promise<VoiceSession>;
+}
+//# sourceMappingURL=voice-pipeline.d.ts.map

package/dist/voice-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-pipeline.d.ts","sourceRoot":"","sources":["../src/voice-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,OAAO,KAAK,EAAgB,aAAa,EAA6B,MAAM,YAAY,CAAC;AAEzF,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,gBAAgB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,KAAK,EACV,mBAAmB,EAEnB,aAAa,EACb,YAAY,EAEb,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,4BAA4B;IAC3C,mFAAmF;IACnF,GAAG,EAAE,WAAW,CAAC;IACjB,sCAAsC;IACtC,GAAG,EAAE,WAAW,CAAC;IACjB,+FAA+F;IAC/F,GAAG,EAAE,aAAa,CAAC;IACnB,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,qBAAsB,YAAW,aAAa;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;IAClC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;IAClC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAgB;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,OAAO,EAAE,4BAA4B;IAQ3C,OAAO,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,YAAY,CAAC;CAexE"}

package/dist/voice-pipeline.js

@@ -0,0 +1,312 @@
+/**
+ * Pipeline voice mode: composes a streaming `SttProvider`, a text
+ * `ModelProvider`, and a streaming `TtsProvider` into a `VoiceSession`.
+ * Use this for ElevenLabs / Cartesia / Deepgram and any future
+ * single-modality vendor combo.
+ *
+ * For monolithic realtime models (OpenAI Realtime), use
+ * `OpenAIRealtimeVoiceProvider` directly — that path is lower-latency and
+ * includes server-side VAD.
+ *
+ * Conversation flow:
+ *   user speech → STT → final transcript → LLM → text chunks → TTS →
+ *   audio bytes back to caller. Tool calls relay through the existing
+ *   `tool_call` / `submitToolResult` contract on `VoiceSession`.
+ *
+ * Barge-in: when the STT emits `speech_started` while we're speaking,
+ * the in-flight TTS stream is aborted and the LLM call cancelled. The
+ * caller should also stop playback in their UI.
+ *
+ * Cost: rolled up across STT seconds, LLM tokens, TTS characters into a
+ * single `usage` object on `response_done`. `costBudget` observes the
+ * total — same `cost_limit` event semantics as realtime mode.
+ */
+import { CostLimitExceededError } from './cost-budget.js';
+import { applyEstimatedCost } from './model-pricing.js';
+import { toolsToModelSchemas } from './model.js';
+export class PipelineVoiceProvider {
+    name;
+    stt;
+    tts;
+    llm;
+    model;
+    constructor(options) {
+        this.stt = options.stt;
+        this.tts = options.tts;
+        this.llm = options.llm;
+        this.model = options.model;
+        this.name = options.name ?? `pipeline:${options.stt.name}+${options.tts.name}`;
+    }
+    async connect(options = {}) {
+        const sttSession = await this.stt.open({
+            ...(options.audioFormat ? { audioFormat: options.audioFormat } : {}),
+            ...(options.sampleRate ? { sampleRate: options.sampleRate } : {}),
+            ...(options.signal ? { signal: options.signal } : {}),
+        });
+        return new PipelineVoiceSession({
+            stt: sttSession,
+            sttProviderName: this.stt.name,
+            tts: this.tts,
+            llm: this.llm,
+            model: this.model,
+            options,
+        });
+    }
+}
+class PipelineVoiceSession {
+    stt;
+    sttProviderName;
+    tts;
+    llm;
+    modelId;
+    tools;
+    instructions;
+    costBudget;
+    requestCostLimitApproval;
+    queue = [];
+    waiters = [];
+    closed = false;
+    messages = [];
+    state = 'listening';
+    currentTurnAbort;
+    pendingToolCalls = [];
+    // Per-turn rollup for cost telemetry.
+    turnUsage = {};
+    constructor(init) {
+        this.stt = init.stt;
+        this.sttProviderName = init.sttProviderName;
+        this.tts = init.tts;
+        this.llm = init.llm;
+        this.modelId = init.model;
+        this.tools = init.options.tools ?? [];
+        this.instructions = init.options.instructions;
+        this.costBudget = init.options.costBudget;
+        this.requestCostLimitApproval = init.options.requestCostLimitApproval;
+        if (this.instructions)
+            this.messages.push({ role: 'system', content: this.instructions });
+        this.push({ type: 'session_open' });
+        // Pump STT events.
+        void this.consumeStt();
+        init.options.signal?.addEventListener('abort', () => void this.close(), { once: true });
+    }
+    async sendAudio(frame) {
+        if (this.closed)
+            throw new Error('Voice session closed');
+        this.stt.send(frame);
+    }
+    async sendText(text) {
+        if (this.closed)
+            throw new Error('Voice session closed');
+        if (!text)
+            return;
+        this.push({ type: 'transcript', text, role: 'user' });
+        this.messages.push({ role: 'user', content: text });
+        void this.runLlmTurn();
+    }
+    async submitToolResult(input) {
+        if (this.closed)
+            throw new Error('Voice session closed');
+        const output = typeof input.output === 'string' ? input.output : JSON.stringify(input.output);
+        this.messages.push({ role: 'tool', content: output, toolCallId: input.id });
+        // Remove the matching pending tool call. When all are resolved, continue.
+        this.pendingToolCalls = this.pendingToolCalls.filter((c) => c.id !== input.id);
+        if (this.pendingToolCalls.length === 0) {
+            // Reset state so runLlmTurn() doesn't early-return on the thinking guard.
+            this.state = 'listening';
+            void this.runLlmTurn();
+        }
+    }
+    async cancelResponse() {
+        this.currentTurnAbort?.abort();
+        this.currentTurnAbort = undefined;
+        if (this.state !== 'await_tool')
+            this.state = 'listening';
+    }
+    events() {
+        return {
+            [Symbol.asyncIterator]: () => ({
+                next: () => this.next(),
+                return: async () => { await this.close(); return { value: undefined, done: true }; },
+            }),
+        };
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.currentTurnAbort?.abort();
+        try {
+            await this.stt.close();
+        }
+        catch { }
+        while (this.waiters.length > 0) {
+            this.waiters.shift()({ value: undefined, done: true });
+        }
+    }
+    next() {
+        if (this.queue.length > 0)
+            return Promise.resolve({ value: this.queue.shift(), done: false });
+        if (this.closed)
+            return Promise.resolve({ value: undefined, done: true });
+        return new Promise((resolve) => this.waiters.push(resolve));
+    }
+    push(event) {
+        if (this.closed)
+            return;
+        const w = this.waiters.shift();
+        if (w)
+            w({ value: event, done: false });
+        else
+            this.queue.push(event);
+    }
+    async consumeStt() {
+        try {
+            for await (const event of this.stt.events()) {
+                if (this.closed)
+                    break;
+                switch (event.type) {
+                    case 'transcript': {
+                        this.push({ type: 'transcript', text: event.text, role: 'user' });
+                        this.messages.push({ role: 'user', content: event.text });
+                        void this.runLlmTurn();
+                        break;
+                    }
+                    case 'partial': {
+                        // Don't surface partials as transcripts — they're not LLM-safe.
+                        // Callers that want live caption can use a separate STT session.
+                        break;
+                    }
+                    case 'speech_started': {
+                        // Barge-in: cancel in-flight TTS + LLM if we were speaking.
+                        if (this.state === 'speaking' || this.state === 'thinking') {
+                            this.currentTurnAbort?.abort();
+                            this.currentTurnAbort = undefined;
+                            this.state = 'listening';
+                        }
+                        break;
+                    }
+                    case 'speech_ended':
+                        break;
+                    case 'error':
+                        this.push({ type: 'error', message: event.message });
+                        break;
+                }
+            }
+        }
+        catch (err) {
+            this.push({ type: 'error', message: err.message });
+        }
+    }
+    async runLlmTurn() {
+        if (this.closed)
+            return;
+        if (this.state === 'thinking' || this.state === 'speaking')
+            return; // already running
+        this.state = 'thinking';
+        const abort = new AbortController();
+        this.currentTurnAbort = abort;
+        this.turnUsage = {};
+        try {
+            const response = await this.llm.generate({
+                model: this.modelId,
+                messages: this.messages,
+                ...(this.tools.length > 0 ? { tools: toolsToModelSchemas(this.tools) } : {}),
+                signal: abort.signal,
+            });
+            if (abort.signal.aborted)
+                return;
+            const assistantMessage = response.message;
+            const toolCalls = response.toolCalls ?? assistantMessage?.toolCalls ?? [];
+            const llmUsage = response.usage;
+            // Record assistant turn for next iteration.
+            if (assistantMessage)
+                this.messages.push(assistantMessage);
+            // Surface text content via TTS + text_delta events.
+            const text = assistantMessage?.content ?? '';
+            if (text) {
+                this.state = 'speaking';
+                this.push({ type: 'text_delta', delta: text, role: 'assistant' });
+                this.push({ type: 'transcript', text, role: 'assistant' });
+                await this.streamTts(text, abort.signal);
+            }
+            // Tool-call relay: emit and pause until results submitted.
+            if (toolCalls.length > 0) {
+                this.pendingToolCalls = [...toolCalls];
+                this.state = 'await_tool';
+                for (const call of toolCalls) {
+                    this.push({ type: 'tool_call', id: call.id, name: call.name, input: call.input });
+                }
+            }
+            else {
+                this.state = 'listening';
+            }
+            // Roll up usage and emit response_done.
+            const usage = this.rollupUsage(llmUsage);
+            if (usage)
+                applyEstimatedCost(this.modelKey(), usage);
+            this.push({ type: 'response_done', ...(usage ? { usage } : {}) });
+            if (usage && this.costBudget?.enabled() && typeof usage.costUsd === 'number' && usage.costUsd > 0) {
+                void this.handleCostBudget(usage.costUsd);
+            }
+        }
+        catch (err) {
+            if (abort.signal.aborted)
+                return;
+            this.push({ type: 'error', message: err.message });
+            this.state = 'listening';
+        }
+        finally {
+            if (this.currentTurnAbort === abort)
+                this.currentTurnAbort = undefined;
+        }
+    }
+    async streamTts(text, signal) {
+        if (this.closed || signal.aborted)
+            return;
+        const stream = this.tts.synthesize(text, { signal });
+        for await (const frame of stream) {
+            if (this.closed || signal.aborted)
+                break;
+            this.push({ type: 'audio_delta', audio: frame });
+        }
+    }
+    rollupUsage(llmUsage) {
+        const stt = this.stt.usage();
+        const ttsLast = this.tts.lastUsage();
+        const usage = { ...(llmUsage ?? {}) };
+        if (stt.seconds > 0)
+            usage.sttSeconds = (usage.sttSeconds ?? 0) + stt.seconds;
+        if (ttsLast?.characters && ttsLast.characters > 0) {
+            usage.ttsCharacters = (usage.ttsCharacters ?? 0) + ttsLast.characters;
+        }
+        return Object.keys(usage).length > 0 ? usage : undefined;
+    }
+    modelKey() {
+        // Use the LLM provider's model id so `lookupModelPrice` finds the row.
+        return this.modelId;
+    }
+    async handleCostBudget(callCost) {
+        if (!this.costBudget)
+            return;
+        const handle = async (violation) => {
+            this.push({ type: 'cost_limit', scope: violation.scope, observedUsd: violation.observedUsd, limitUsd: violation.limitUsd, ...(violation.scopeKey ? { scopeKey: violation.scopeKey } : {}) });
+            const mode = this.costBudget.onExceed();
+            if (mode === 'approve' && this.requestCostLimitApproval) {
+                const approved = await this.requestCostLimitApproval(violation);
+                if (approved)
+                    return;
+            }
+            this.push({ type: 'error', message: new CostLimitExceededError(violation).message });
+            void this.close();
+        };
+        const local = this.costBudget.observe(callCost);
+        if (local) {
+            await handle(local);
+            return;
+        }
+        const remote = await this.costBudget.observeScopeAsync(callCost);
+        if (remote)
+            await handle(remote);
+    }
+}
+//# sourceMappingURL=voice-pipeline.js.map

package/dist/voice-pipeline.js.map

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

package/dist/voice-stt-cartesia.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Cartesia streaming STT provider — single-vendor alternative when
+ * pairing with `CartesiaTtsProvider`. Connects to
+ * `wss://api.cartesia.ai/stt/websocket`.
+ *
+ * Pricing: per audio second. Rates registered under provider `cartesia`.
+ */
+import type { SttProvider, SttSession, SttSessionOptions } from './voice-stt.js';
+export interface CartesiaSttProviderOptions {
+    apiKey: string;
+    /** Default model id. Default `ink-whisper`. */
+    model?: string;
+    /** Cartesia API version. */
+    apiVersion?: string;
+    /** Override base URL. */
+    baseUrl?: string;
+    /** Provider name override. Default `cartesia`. */
+    name?: string;
+}
+export declare class CartesiaSttProvider implements SttProvider {
+    readonly name: string;
+    private readonly apiKey;
+    private readonly defaultModel;
+    private readonly apiVersion;
+    private readonly baseUrl;
+    constructor(options: CartesiaSttProviderOptions);
+    open(opts?: SttSessionOptions): Promise<SttSession>;
+}
+//# sourceMappingURL=voice-stt-cartesia.d.ts.map

package/dist/voice-stt-cartesia.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-stt-cartesia.d.ts","sourceRoot":"","sources":["../src/voice-stt-cartesia.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAY,WAAW,EAAE,UAAU,EAAE,iBAAiB,EAAmB,MAAM,gBAAgB,CAAC;AAG5G,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAMD,qBAAa,mBAAoB,YAAW,WAAW;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,0BAA0B;IASzC,IAAI,CAAC,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC;CAe9D"}

package/dist/voice-stt-cartesia.js

@@ -0,0 +1,160 @@
+/**
+ * Cartesia streaming STT provider — single-vendor alternative when
+ * pairing with `CartesiaTtsProvider`. Connects to
+ * `wss://api.cartesia.ai/stt/websocket`.
+ *
+ * Pricing: per audio second. Rates registered under provider `cartesia`.
+ */
+import { openVoiceWs, toError } from './voice-ws-shared.js';
+const DEFAULT_BASE = 'wss://api.cartesia.ai';
+const DEFAULT_MODEL = 'ink-whisper';
+const DEFAULT_API_VERSION = '2024-11-13';
+export class CartesiaSttProvider {
+    name;
+    apiKey;
+    defaultModel;
+    apiVersion;
+    baseUrl;
+    constructor(options) {
+        if (!options.apiKey)
+            throw new Error('CartesiaSttProvider: apiKey is required.');
+        this.apiKey = options.apiKey;
+        this.defaultModel = options.model ?? DEFAULT_MODEL;
+        this.apiVersion = options.apiVersion ?? DEFAULT_API_VERSION;
+        this.baseUrl = options.baseUrl ?? DEFAULT_BASE;
+        this.name = options.name ?? 'cartesia';
+    }
+    async open(opts = {}) {
+        const format = opts.audioFormat ?? 'pcm16';
+        const sampleRate = opts.sampleRate ?? defaultSampleRate(format);
+        const params = new URLSearchParams({
+            api_key: this.apiKey,
+            cartesia_version: this.apiVersion,
+            model: opts.model ?? this.defaultModel,
+            encoding: cartesiaEncoding(format),
+            sample_rate: String(sampleRate),
+        });
+        if (opts.language)
+            params.set('language', opts.language);
+        const url = `${this.baseUrl}/stt/websocket?${params.toString()}`;
+        const ws = await openVoiceWs(url, {});
+        return new CartesiaSttSession(ws, opts.signal);
+    }
+}
+class CartesiaSttSession {
+    ws;
+    queue = [];
+    waiters = [];
+    closed = false;
+    secondsSent = 0;
+    startedAt = Date.now();
+    constructor(ws, signal) {
+        this.ws = ws;
+        ws.addEventListener('message', (ev) => this.onMessage(ev.data));
+        ws.addEventListener('error', (ev) => this.push({ type: 'error', message: toError(ev, 'Cartesia STT WS error').message }));
+        ws.addEventListener('close', () => this.terminate());
+        signal?.addEventListener('abort', () => void this.close(), { once: true });
+    }
+    send(frame) {
+        if (this.closed)
+            return;
+        this.ws.send(frame);
+        this.secondsSent += frame.byteLength / 32_000;
+    }
+    events() {
+        return {
+            [Symbol.asyncIterator]: () => ({
+                next: () => this.next(),
+                return: async () => { await this.close(); return { value: undefined, done: true }; },
+            }),
+        };
+    }
+    async close() {
+        if (this.closed)
+            return;
+        try {
+            this.ws.send(JSON.stringify({ type: 'finalize' }));
+        }
+        catch { }
+        try {
+            this.ws.close();
+        }
+        catch { }
+        this.terminate();
+    }
+    usage() {
+        return { seconds: this.secondsSent, durationMs: Date.now() - this.startedAt };
+    }
+    terminate() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        while (this.waiters.length > 0)
+            this.waiters.shift()({ value: undefined, done: true });
+    }
+    next() {
+        if (this.queue.length > 0)
+            return Promise.resolve({ value: this.queue.shift(), done: false });
+        if (this.closed)
+            return Promise.resolve({ value: undefined, done: true });
+        return new Promise((resolve) => this.waiters.push(resolve));
+    }
+    push(event) {
+        if (this.closed)
+            return;
+        const w = this.waiters.shift();
+        if (w)
+            w({ value: event, done: false });
+        else
+            this.queue.push(event);
+    }
+    onMessage(raw) {
+        const text = typeof raw === 'string' ? raw : (raw && typeof raw === 'object' && 'toString' in raw)
+            ? String(raw)
+            : '';
+        let payload;
+        try {
+            payload = JSON.parse(text);
+        }
+        catch {
+            return;
+        }
+        const type = String(payload.type ?? '');
+        switch (type) {
+            case 'transcript': {
+                const t = String(payload.text ?? '');
+                const isFinal = payload.is_final === true;
+                if (!t)
+                    return;
+                if (isFinal)
+                    this.push({ type: 'transcript', text: t, isFinal: true });
+                else
+                    this.push({ type: 'partial', text: t, isFinal: false });
+                return;
+            }
+            case 'speech_started':
+                this.push({ type: 'speech_started' });
+                return;
+            case 'speech_ended':
+                this.push({ type: 'speech_ended' });
+                return;
+            case 'error':
+                this.push({ type: 'error', message: String(payload.message ?? 'cartesia stt error') });
+                return;
+            default: return;
+        }
+    }
+}
+function cartesiaEncoding(format) {
+    if (format === 'g711_ulaw')
+        return 'pcm_mulaw';
+    if (format === 'g711_alaw')
+        return 'pcm_alaw';
+    return 'pcm_s16le';
+}
+function defaultSampleRate(format) {
+    if (format === 'g711_ulaw' || format === 'g711_alaw')
+        return 8000;
+    return 16000;
+}
+//# sourceMappingURL=voice-stt-cartesia.js.map

package/dist/voice-stt-cartesia.js.map

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

package/dist/voice-stt-deepgram.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Deepgram streaming STT provider. Default STT for `PipelineVoiceProvider`.
+ *
+ * Connects to `wss://api.deepgram.com/v1/listen` with WS subprotocol
+ * `Token <api_key>`. Emits final + interim transcripts plus VAD
+ * `speech_started` / `UtteranceEnd` events for barge-in handling.
+ *
+ * Pricing: per audio second. Rates registered under provider `deepgram`.
+ */
+import type { SttProvider, SttSession, SttSessionOptions } from './voice-stt.js';
+export interface DeepgramSttProviderOptions {
+    apiKey: string;
+    /** Default model. `nova-3` is the v1.12 default (best latency/accuracy). */
+    model?: string;
+    /** Override base URL. */
+    baseUrl?: string;
+    /** Provider name override. Default `deepgram`. */
+    name?: string;
+}
+export declare class DeepgramSttProvider implements SttProvider {
+    readonly name: string;
+    private readonly apiKey;
+    private readonly defaultModel;
+    private readonly baseUrl;
+    constructor(options: DeepgramSttProviderOptions);
+    open(opts?: SttSessionOptions): Promise<SttSession>;
+}
+//# sourceMappingURL=voice-stt-deepgram.d.ts.map

package/dist/voice-stt-deepgram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-stt-deepgram.d.ts","sourceRoot":"","sources":["../src/voice-stt-deepgram.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAY,WAAW,EAAE,UAAU,EAAE,iBAAiB,EAAmB,MAAM,gBAAgB,CAAC;AAG5G,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAKD,qBAAa,mBAAoB,YAAW,WAAW;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,0BAA0B;IAQzC,IAAI,CAAC,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC;CAoB9D"}