@cogitator-ai/voice 0.1.0 → 0.1.4

package/dist/realtime/openai-realtime.js

@@ -0,0 +1,138 @@
+import { EventEmitter } from 'node:events';
+import { WebSocket } from 'ws';
+const DEFAULT_MODEL = 'gpt-4o-mini-realtime-preview';
+const BASE_URL = 'wss://api.openai.com/v1/realtime';
+export class OpenAIRealtimeAdapter extends EventEmitter {
+    config;
+    model;
+    ws = null;
+    constructor(config) {
+        super();
+        this.config = config;
+        this.model = config.model ?? DEFAULT_MODEL;
+    }
+    async connect() {
+        const url = `${BASE_URL}?model=${this.model}`;
+        return new Promise((resolve, reject) => {
+            this.ws = new WebSocket(url, {
+                headers: {
+                    Authorization: `Bearer ${this.config.apiKey}`,
+                    'OpenAI-Beta': 'realtime=v1',
+                },
+            });
+            this.ws.on('open', () => {
+                this.sendSessionUpdate();
+                this.emit('connected');
+                resolve();
+            });
+            this.ws.on('message', (data) => {
+                this.handleMessage(typeof data === 'string' ? data : data.toString());
+            });
+            this.ws.on('error', (err) => {
+                reject(err);
+            });
+        });
+    }
+    pushAudio(chunk) {
+        this.send({
+            type: 'input_audio_buffer.append',
+            audio: chunk.toString('base64'),
+        });
+    }
+    sendText(text) {
+        this.send({
+            type: 'conversation.item.create',
+            item: {
+                type: 'message',
+                role: 'user',
+                content: [{ type: 'input_text', text }],
+            },
+        });
+        this.send({ type: 'response.create' });
+    }
+    interrupt() {
+        this.send({ type: 'response.cancel' });
+    }
+    close() {
+        this.ws?.close();
+        this.ws = null;
+    }
+    sendSessionUpdate() {
+        const session = {
+            voice: this.config.voice ?? 'coral',
+            input_audio_format: 'pcm16',
+            output_audio_format: 'pcm16',
+            turn_detection: { type: 'server_vad' },
+        };
+        if (this.config.instructions) {
+            session.instructions = this.config.instructions;
+        }
+        if (this.config.tools?.length) {
+            session.tools = this.config.tools.map((t) => ({
+                type: 'function',
+                name: t.name,
+                description: t.description,
+                parameters: t.parameters,
+            }));
+        }
+        this.send({ type: 'session.update', session });
+    }
+    handleMessage(raw) {
+        const event = JSON.parse(raw);
+        const type = event.type;
+        switch (type) {
+            case 'response.audio.delta':
+                this.emit('audio', Buffer.from(event.delta, 'base64'));
+                break;
+            case 'conversation.item.input_audio_transcription.completed':
+                this.emit('transcript', event.transcript, 'user');
+                break;
+            case 'response.audio_transcript.done':
+                this.emit('transcript', event.transcript, 'assistant');
+                break;
+            case 'input_audio_buffer.speech_started':
+                this.emit('speech_start');
+                break;
+            case 'response.function_call_arguments.done':
+                void this.handleToolCall(event);
+                break;
+            case 'error': {
+                const errObj = event.error;
+                this.emit('error', new Error(errObj.message));
+                break;
+            }
+        }
+    }
+    async handleToolCall(event) {
+        const name = event.name;
+        const callId = event.call_id;
+        const args = JSON.parse(event.arguments);
+        this.emit('tool_call', name, args);
+        const tool = this.config.tools?.find((t) => t.name === name);
+        if (!tool)
+            return;
+        let output;
+        try {
+            const result = await tool.execute(args);
+            output = JSON.stringify(result);
+        }
+        catch (err) {
+            output = JSON.stringify({ error: err instanceof Error ? err.message : String(err) });
+        }
+        this.send({
+            type: 'conversation.item.create',
+            item: {
+                type: 'function_call_output',
+                call_id: callId,
+                output,
+            },
+        });
+        this.send({ type: 'response.create' });
+    }
+    send(data) {
+        if (this.ws?.readyState === this.ws?.OPEN) {
+            this.ws.send(JSON.stringify(data));
+        }
+    }
+}
+//# sourceMappingURL=openai-realtime.js.map

package/dist/realtime/openai-realtime.js.map

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

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

@@ -0,0 +1,23 @@
+import { EventEmitter } from 'node:events';
+import type { RealtimeSessionConfig } from '../types.js';
+interface RealtimeSessionEvents {
+    connected: [];
+    audio: [chunk: Buffer];
+    transcript: [text: string, role: 'user' | 'assistant'];
+    tool_call: [name: string, args: unknown];
+    speech_start: [];
+    error: [error: Error];
+}
+export declare class RealtimeSession extends EventEmitter<RealtimeSessionEvents> {
+    private readonly adapter;
+    private readonly _provider;
+    constructor(config: RealtimeSessionConfig);
+    get provider(): RealtimeSessionConfig['provider'];
+    connect(): Promise<void>;
+    pushAudio(chunk: Buffer): void;
+    sendText(text: string): void;
+    interrupt(): void;
+    close(): void;
+}
+export {};
+//# sourceMappingURL=realtime-session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-session.d.ts","sourceRoot":"","sources":["../../src/realtime/realtime-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAezD,UAAU,qBAAqB;IAC7B,SAAS,EAAE,EAAE,CAAC;IACd,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACvB,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC;IACvD,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACzC,YAAY,EAAE,EAAE,CAAC;IACjB,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;CACvB;AAED,qBAAa,eAAgB,SAAQ,YAAY,CAAC,qBAAqB,CAAC;IACtE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;gBAElD,MAAM,EAAE,qBAAqB;IAezC,IAAI,QAAQ,IAAI,qBAAqB,CAAC,UAAU,CAAC,CAEhD;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI9B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5B,SAAS,IAAI,IAAI;IAIjB,KAAK,IAAI,IAAI;CAGd"}

package/dist/realtime/realtime-session.js

@@ -0,0 +1,47 @@
+import { EventEmitter } from 'node:events';
+import { OpenAIRealtimeAdapter } from './openai-realtime.js';
+import { GeminiRealtimeAdapter } from './gemini-realtime.js';
+const FORWARDED_EVENTS = [
+    'connected',
+    'speech_start',
+    'transcript',
+    'audio',
+    'tool_call',
+    'error',
+];
+export class RealtimeSession extends EventEmitter {
+    adapter;
+    _provider;
+    constructor(config) {
+        super();
+        this._provider = config.provider;
+        this.adapter =
+            config.provider === 'openai'
+                ? new OpenAIRealtimeAdapter(config)
+                : new GeminiRealtimeAdapter(config);
+        for (const event of FORWARDED_EVENTS) {
+            this.adapter.on(event, (...args) => {
+                this.emit(event, ...args);
+            });
+        }
+    }
+    get provider() {
+        return this._provider;
+    }
+    async connect() {
+        return this.adapter.connect();
+    }
+    pushAudio(chunk) {
+        this.adapter.pushAudio(chunk);
+    }
+    sendText(text) {
+        this.adapter.sendText(text);
+    }
+    interrupt() {
+        this.adapter.interrupt();
+    }
+    close() {
+        this.adapter.close();
+    }
+}
+//# sourceMappingURL=realtime-session.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-session.js","sourceRoot":"","sources":["../../src/realtime/realtime-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAI7D,MAAM,gBAAgB,GAAG;IACvB,WAAW;IACX,cAAc;IACd,YAAY;IACZ,OAAO;IACP,WAAW;IACX,OAAO;CACC,CAAC;AAWX,MAAM,OAAO,eAAgB,SAAQ,YAAmC;IACrD,OAAO,CAAkB;IACzB,SAAS,CAAoC;IAE9D,YAAY,MAA6B;QACvC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,OAAO;YACV,MAAM,CAAC,QAAQ,KAAK,QAAQ;gBAC1B,CAAC,CAAC,IAAI,qBAAqB,CAAC,MAAM,CAAC;gBACnC,CAAC,CAAC,IAAI,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAExC,KAAK,MAAM,KAAK,IAAI,gBAAgB,EAAE,CAAC;YACrC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE;gBAC5C,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,GAAI,IAAc,CAAC,CAAC;YACvC,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,OAAO;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IAChC,CAAC;IAED,SAAS,CAAC,KAAa;QACrB,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAED,QAAQ,CAAC,IAAY;QACnB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,SAAS;QACP,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;IAC3B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF"}

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

@@ -0,0 +1,17 @@
+import type { STTProvider, STTOptions, STTStreamOptions, STTStream, TranscribeResult } from '../types.js';
+export interface DeepgramSTTConfig {
+    apiKey: string;
+    model?: string;
+    language?: string;
+}
+export declare class DeepgramSTT implements STTProvider {
+    readonly name = "deepgram";
+    private readonly apiKey;
+    private readonly model;
+    private readonly language?;
+    constructor(config: DeepgramSTTConfig);
+    transcribe(audio: Buffer, options?: STTOptions): Promise<TranscribeResult>;
+    createStream(options?: STTStreamOptions): STTStream;
+    private mapBatchResponse;
+}
+//# sourceMappingURL=deepgram-stt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deepgram-stt.d.ts","sourceRoot":"","sources":["../../src/stt/deepgram-stt.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAkCD,qBAAa,WAAY,YAAW,WAAW;IAC7C,QAAQ,CAAC,IAAI,cAAc;IAE3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAS;gBAEvB,MAAM,EAAE,iBAAiB;IAM/B,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA2BhF,YAAY,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS;IAInD,OAAO,CAAC,gBAAgB;CAsBzB"}

package/dist/stt/deepgram-stt.js

@@ -0,0 +1,138 @@
+import { EventEmitter } from 'node:events';
+import { WebSocket } from 'ws';
+const DEFAULT_MODEL = 'nova-3';
+const BASE_URL = 'https://api.deepgram.com/v1/listen';
+const WS_URL = 'wss://api.deepgram.com/v1/listen';
+export class DeepgramSTT {
+    name = 'deepgram';
+    apiKey;
+    model;
+    language;
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.model = config.model ?? DEFAULT_MODEL;
+        this.language = config.language;
+    }
+    async transcribe(audio, options) {
+        const params = new URLSearchParams({
+            model: this.model,
+            punctuate: 'true',
+        });
+        const lang = options?.language ?? this.language;
+        if (lang)
+            params.set('language', lang);
+        const response = await fetch(`${BASE_URL}?${params}`, {
+            method: 'POST',
+            headers: {
+                Authorization: `Token ${this.apiKey}`,
+                'Content-Type': 'audio/wav',
+            },
+            body: new Uint8Array(audio).buffer,
+        });
+        if (!response.ok) {
+            const body = await response.text();
+            throw new Error(`Deepgram API error ${response.status}: ${body}`);
+        }
+        const data = (await response.json());
+        return this.mapBatchResponse(data);
+    }
+    createStream(options) {
+        return new DeepgramSTTStream(this.apiKey, this.model, this.language, options);
+    }
+    mapBatchResponse(data) {
+        const alt = data.results.channels[0]?.alternatives[0];
+        const result = {
+            text: alt?.transcript ?? '',
+        };
+        if (data.metadata?.duration !== undefined) {
+            result.duration = data.metadata.duration;
+        }
+        if (alt?.words && alt.words.length > 0) {
+            result.words = alt.words.map((w) => ({
+                word: w.word,
+                start: w.start,
+                end: w.end,
+                confidence: w.confidence,
+            }));
+        }
+        return result;
+    }
+}
+class DeepgramSTTStream extends EventEmitter {
+    ws;
+    ready = false;
+    pendingChunks = [];
+    lastResult = { text: '' };
+    constructor(apiKey, model, language, options) {
+        super();
+        const params = new URLSearchParams({
+            model,
+            punctuate: 'true',
+            interim_results: 'true',
+        });
+        const lang = options?.language ?? language;
+        if (lang)
+            params.set('language', lang);
+        if (options?.endpointing !== undefined) {
+            params.set('endpointing', String(options.endpointing));
+        }
+        this.ws = new WebSocket(`${WS_URL}?${params}`, [`token:${apiKey}`]);
+        this.ws.on('open', () => {
+            this.ready = true;
+            for (const chunk of this.pendingChunks) {
+                this.ws.send(chunk);
+            }
+            this.pendingChunks = [];
+        });
+        this.ws.on('message', (raw) => {
+            const msg = JSON.parse(String(raw));
+            const alt = msg.channel?.alternatives[0];
+            if (!alt?.transcript)
+                return;
+            if (msg.is_final) {
+                const result = this.mapStreamResult(msg);
+                this.lastResult = result;
+                this.emit('final', result);
+            }
+            else {
+                this.emit('partial', alt.transcript);
+            }
+        });
+        this.ws.on('error', (err) => {
+            this.emit('error', err);
+        });
+    }
+    write(chunk) {
+        if (this.ready) {
+            this.ws.send(chunk);
+        }
+        else {
+            this.pendingChunks.push(chunk);
+        }
+    }
+    async close() {
+        if (this.ready) {
+            this.ws.send(JSON.stringify({ type: 'CloseStream' }));
+        }
+        return this.lastResult;
+    }
+    mapStreamResult(msg) {
+        const alt = msg.channel.alternatives[0];
+        const result = {
+            text: alt.transcript,
+        };
+        if (msg.metadata?.duration !== undefined) {
+            result.duration = msg.metadata.duration;
+        }
+        if (alt.words && alt.words.length > 0) {
+            result.words = alt.words.map((w) => ({
+                word: w.word,
+                start: w.start,
+                end: w.end,
+                confidence: w.confidence,
+            }));
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=deepgram-stt.js.map

package/dist/stt/deepgram-stt.js.map

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

package/dist/stt/index.d.ts

@@ -0,0 +1,3 @@
+export { OpenAISTT, type OpenAISTTConfig } from './openai-stt.js';
+export { DeepgramSTT, type DeepgramSTTConfig } from './deepgram-stt.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/stt/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/stt/index.js

@@ -0,0 +1,3 @@
+export { OpenAISTT } from './openai-stt.js';
+export { DeepgramSTT } from './deepgram-stt.js';
+//# sourceMappingURL=index.js.map

package/dist/stt/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/stt/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAwB,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,WAAW,EAA0B,MAAM,mBAAmB,CAAC"}

package/dist/stt/openai-stt.d.ts

@@ -0,0 +1,17 @@
+import type { STTProvider, STTOptions, STTStreamOptions, STTStream, TranscribeResult } from '../types.js';
+export interface OpenAISTTConfig {
+    apiKey: string;
+    model?: string;
+    baseURL?: string;
+}
+export declare class OpenAISTT implements STTProvider {
+    readonly name = "openai";
+    private readonly client;
+    private readonly model;
+    constructor(config: OpenAISTTConfig);
+    transcribe(audio: Buffer, options?: STTOptions): Promise<TranscribeResult>;
+    createStream(options?: STTStreamOptions): STTStream;
+    _transcribeBuffer(audio: Buffer, options?: STTOptions): Promise<TranscribeResult>;
+    private mapResponse;
+}
+//# sourceMappingURL=openai-stt.d.ts.map

package/dist/stt/openai-stt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-stt.d.ts","sourceRoot":"","sources":["../../src/stt/openai-stt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,qBAAa,SAAU,YAAW,WAAW;IAC3C,QAAQ,CAAC,IAAI,YAAY;IAEzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,MAAM,EAAE,eAAe;IAQ7B,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAehF,YAAY,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS;IAInD,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIjF,OAAO,CAAC,WAAW;CAwBpB"}

package/dist/stt/openai-stt.js

@@ -0,0 +1,80 @@
+import { EventEmitter } from 'node:events';
+import OpenAI from 'openai';
+const DEFAULT_MODEL = 'gpt-4o-mini-transcribe';
+export class OpenAISTT {
+    name = 'openai';
+    client;
+    model;
+    constructor(config) {
+        this.client = new OpenAI({
+            apiKey: config.apiKey,
+            ...(config.baseURL && { baseURL: config.baseURL }),
+        });
+        this.model = config.model ?? DEFAULT_MODEL;
+    }
+    async transcribe(audio, options) {
+        const file = new File([new Uint8Array(audio)], 'audio.wav', { type: 'audio/wav' });
+        const response = await this.client.audio.transcriptions.create({
+            file,
+            model: this.model,
+            response_format: 'verbose_json',
+            timestamp_granularities: ['word'],
+            ...(options?.language && { language: options.language }),
+            ...(options?.prompt && { prompt: options.prompt }),
+        });
+        return this.mapResponse(response);
+    }
+    createStream(options) {
+        return new OpenAISTTStream(this, options);
+    }
+    _transcribeBuffer(audio, options) {
+        return this.transcribe(audio, options);
+    }
+    mapResponse(response) {
+        const result = {
+            text: response.text,
+        };
+        if (response.language) {
+            result.language = response.language;
+        }
+        if (response.duration !== undefined) {
+            result.duration = response.duration;
+        }
+        if (response.words && response.words.length > 0) {
+            result.words = response.words.map((w) => ({
+                word: w.word,
+                start: w.start,
+                end: w.end,
+                confidence: 1,
+            }));
+        }
+        return result;
+    }
+}
+class OpenAISTTStream extends EventEmitter {
+    chunks = [];
+    provider;
+    options;
+    constructor(provider, options) {
+        super();
+        this.provider = provider;
+        this.options = options;
+    }
+    write(chunk) {
+        this.chunks.push(chunk);
+    }
+    async close() {
+        const combined = Buffer.concat(this.chunks);
+        try {
+            const result = await this.provider._transcribeBuffer(combined, this.options);
+            this.emit('final', result);
+            return result;
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            this.emit('error', error);
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=openai-stt.js.map

package/dist/stt/openai-stt.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+import type { STTProvider, TTSProvider } from './types.js';
+export interface VoiceTool<TParams = unknown> {
+    name: string;
+    description: string;
+    parameters: z.ZodType<TParams>;
+    execute: (params: TParams) => Promise<unknown>;
+}
+declare const TranscribeParamsSchema: z.ZodObject<{
+    audioBase64: z.ZodString;
+    language: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type TranscribeParams = z.infer<typeof TranscribeParamsSchema>;
+declare const SpeakParamsSchema: z.ZodObject<{
+    text: z.ZodString;
+    voice: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type SpeakParams = z.infer<typeof SpeakParamsSchema>;
+export declare function transcribeTool(stt: STTProvider): VoiceTool<TranscribeParams>;
+export declare function speakTool(tts: TTSProvider): VoiceTool<SpeakParams>;
+export declare function voiceTools(config: {
+    stt: STTProvider;
+    tts: TTSProvider;
+}): [VoiceTool<TranscribeParams>, VoiceTool<SpeakParams>];
+export {};
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE3D,MAAM,WAAW,SAAS,CAAC,OAAO,GAAG,OAAO;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/B,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAChD;AAED,QAAA,MAAM,sBAAsB;;;iBAG1B,CAAC;AAEH,KAAK,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE/D,QAAA,MAAM,iBAAiB;;;iBAGrB,CAAC;AAEH,KAAK,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAErD,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAW5E;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,WAAW,GAAG,SAAS,CAAC,WAAW,CAAC,CAUlE;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE;IACjC,GAAG,EAAE,WAAW,CAAC;IACjB,GAAG,EAAE,WAAW,CAAC;CAClB,GAAG,CAAC,SAAS,CAAC,gBAAgB,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC,CAExD"}

package/dist/tools.js

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+const TranscribeParamsSchema = z.object({
+    audioBase64: z.string().describe('Base64-encoded audio data'),
+    language: z.string().optional().describe('Language code (e.g., "en", "es")'),
+});
+const SpeakParamsSchema = z.object({
+    text: z.string().describe('Text to convert to speech'),
+    voice: z.string().optional().describe('Voice to use'),
+});
+export function transcribeTool(stt) {
+    return {
+        name: 'transcribe_audio',
+        description: 'Transcribe audio input to text using speech recognition',
+        parameters: TranscribeParamsSchema,
+        execute: async ({ audioBase64, language }) => {
+            const audio = Buffer.from(audioBase64, 'base64');
+            const result = await stt.transcribe(audio, { language });
+            return { text: result.text, language: result.language, duration: result.duration };
+        },
+    };
+}
+export function speakTool(tts) {
+    return {
+        name: 'speak_text',
+        description: 'Convert text to speech audio',
+        parameters: SpeakParamsSchema,
+        execute: async ({ text, voice }) => {
+            const audio = await tts.synthesize(text, { voice });
+            return { audioBase64: audio.toString('base64'), format: 'mp3' };
+        },
+    };
+}
+export function voiceTools(config) {
+    return [transcribeTool(config.stt), speakTool(config.tts)];
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IAC7D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;CAC7E,CAAC,CAAC;AAIH,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IACtD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;CACtD,CAAC,CAAC;AAIH,MAAM,UAAU,cAAc,CAAC,GAAgB;IAC7C,OAAO;QACL,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,yDAAyD;QACtE,UAAU,EAAE,sBAAsB;QAClC,OAAO,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE,EAAE;YAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;YACjD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;YACzD,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrF,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAgB;IACxC,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,8BAA8B;QAC3C,UAAU,EAAE,iBAAiB;QAC7B,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;YACjC,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YACpD,OAAO,EAAE,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAClE,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAG1B;IACC,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AAC7D,CAAC"}

package/dist/transport/index.d.ts

@@ -0,0 +1,2 @@
+export { WebSocketTransport, VoiceClient } from './ws-transport.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/transport/index.js

@@ -0,0 +1,2 @@
+export { WebSocketTransport, VoiceClient } from './ws-transport.js';
+//# sourceMappingURL=index.js.map

package/dist/transport/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/transport/ws-transport.d.ts

@@ -0,0 +1,37 @@
+import { EventEmitter } from 'node:events';
+import http from 'node:http';
+import { WebSocket } from 'ws';
+import type { WebSocketTransportConfig } from '../types.js';
+interface VoiceClientEvents {
+    audio: [chunk: Buffer];
+    message: [msg: Record<string, unknown>];
+    close: [];
+    error: [error: Error];
+}
+export declare class VoiceClient extends EventEmitter<VoiceClientEvents> {
+    private readonly ws;
+    readonly id: string;
+    constructor(ws: WebSocket);
+    sendAudio(chunk: Buffer): void;
+    sendMessage(msg: Record<string, unknown>): void;
+    close(code?: number, reason?: string): void;
+}
+interface TransportEvents {
+    connection: [client: VoiceClient];
+}
+export declare class WebSocketTransport extends EventEmitter<TransportEvents> {
+    private readonly path;
+    private readonly maxConnections;
+    private wss;
+    private server;
+    private ownsServer;
+    private clients;
+    constructor(config?: WebSocketTransportConfig);
+    listen(port: number): Promise<void>;
+    attachToServer(server: http.Server): void;
+    get port(): number | undefined;
+    close(): Promise<void>;
+    private setupWss;
+}
+export {};
+//# sourceMappingURL=ws-transport.d.ts.map