@ariaflowagents/gemini-native-audio 0.9.0

package/dist/GeminiLiveSession.js

@@ -0,0 +1,297 @@
+import { GoogleGenAI } from '@google/genai';
+import { toolSetToGeminiDeclarations } from './schema-bridge.js';
+const DEFAULT_MODEL = 'gemini-3.1-flash-live-preview';
+const SAMPLE_RATE = 24000;
+/**
+ * Thin wrapper around @google/genai ai.live.connect().
+ *
+ * Manages:
+ * - Connection lifecycle (connect/disconnect)
+ * - Audio input/output encoding (base64 PCM ↔ Uint8Array)
+ * - Tool call dispatch → onEvent callback
+ * - Session resumption via newHandle
+ */
+export class GeminiLiveSession {
+    ai;
+    session = null;
+    config;
+    resumptionHandle;
+    _connected = false;
+    /** True during updateConfig() reconnect cycle — suppresses 'disconnected' event. */
+    _reconfiguring = false;
+    /** Mutable overrides updated by updateConfig(). Merged with config.overrides. */
+    runtimeOverrides;
+    /** Typed event listener registry for the RealtimeAudioClient interface. */
+    listeners = new Map();
+    constructor(config) {
+        this.config = config;
+        this.ai = new GoogleGenAI({ apiKey: config.gemini.apiKey });
+    }
+    get connected() {
+        return this._connected;
+    }
+    // ─── RealtimeAudioClient: on / off / ping ───────────────────────────────────
+    on(event, handler) {
+        if (!this.listeners.has(event)) {
+            this.listeners.set(event, new Set());
+        }
+        this.listeners.get(event).add(handler);
+    }
+    off(event, handler) {
+        this.listeners.get(event)?.delete(handler);
+    }
+    emitEvent(event, ...args) {
+        const handlers = this.listeners.get(event);
+        if (!handlers)
+            return;
+        for (const handler of handlers) {
+            handler(...args);
+        }
+    }
+    /**
+     * Gemini Live wraps the underlying WebSocket via @google/genai SDK.
+     * There is no direct ping API, so we return connection state as a health check.
+     */
+    async ping() {
+        return Promise.resolve(this._connected);
+    }
+    /**
+     * Connect to Gemini Live.
+     *
+     * @param config Optional RealtimeSessionConfig. When provided, systemInstruction
+     *   and tools are applied as runtimeOverrides (takes precedence over constructor
+     *   config.overrides and agent config). This satisfies the RealtimeAudioClient
+     *   interface while preserving backward compatibility with CapabilityCallWorker,
+     *   which calls connect() with no arguments.
+     */
+    async connect(config) {
+        // If a RealtimeSessionConfig is provided (RealtimeAudioClient interface call),
+        // store its fields as runtimeOverrides so they win over constructor config.
+        if (config) {
+            this.runtimeOverrides = {
+                systemInstruction: config.systemInstruction,
+                tools: config.tools,
+            };
+        }
+        const { agent, gemini } = this.config;
+        const model = (config?.model ?? gemini.model) ?? DEFAULT_MODEL;
+        // Merge overrides: runtimeOverrides (from updateConfig) take priority over
+        // config.overrides (from constructor), which take priority over agent config.
+        const activeOverrides = { ...this.config.overrides, ...this.runtimeOverrides };
+        // Gemini 3.1 rejects empty tools arrays — only send when declarations exist.
+        const declarations = activeOverrides.tools
+            ?? (agent.tools ? toolSetToGeminiDeclarations(agent.tools) : undefined);
+        const tools = declarations && declarations.length > 0
+            ? [{ functionDeclarations: declarations }]
+            : undefined;
+        // Resolve prompt — active overrides win, then fall back to agent config.
+        const promptText = activeOverrides.systemInstruction ?? (() => {
+            const agentPrompt = agent.prompt;
+            if (!agentPrompt)
+                return '';
+            if (typeof agentPrompt === 'string')
+                return agentPrompt;
+            // PromptTemplate / AgentPrompt: join sections
+            return agentPrompt.sections
+                .map(s => s.content)
+                .join('\n\n');
+        })();
+        const liveConfig = {
+            responseModalities: ['AUDIO'],
+            systemInstruction: { parts: [{ text: promptText }] },
+            tools,
+            outputAudioTranscription: {},
+        };
+        if (agent.voice) {
+            liveConfig.speechConfig = {
+                voiceConfig: { prebuiltVoiceConfig: { voiceName: agent.voice } },
+            };
+        }
+        if (this.resumptionHandle) {
+            liveConfig.sessionResumption = { handle: this.resumptionHandle };
+        }
+        console.log('[GeminiLiveSession] Connecting with config:', {
+            model,
+            promptLength: promptText.length,
+            toolCount: tools?.length ?? 0,
+            toolNames: tools?.[0]?.functionDeclarations?.map((d) => d.name) ?? [],
+            voice: agent.voice,
+            hasResumption: !!this.resumptionHandle,
+        });
+        this.session = await this.ai.live.connect({
+            model,
+            config: liveConfig,
+            callbacks: {
+                onopen: () => {
+                    this._connected = true;
+                    console.log('[GeminiLiveSession] Connection opened');
+                },
+                onmessage: (message) => {
+                    this.handleServerMessage(message);
+                },
+                onerror: (error) => {
+                    const errMsg = String(error);
+                    this.config.onEvent({ type: 'error', error: errMsg });
+                    this.emitEvent('error', errMsg);
+                },
+                onclose: () => {
+                    this._connected = false;
+                    console.log(`[GeminiLiveSession] Connection closed (reconfiguring=${this._reconfiguring})`);
+                    // Don't emit 'disconnected' during a reconfigure cycle — the session
+                    // will reconnect immediately. Only emit for genuine connection loss.
+                    if (!this._reconfiguring) {
+                        this.emitEvent('disconnected');
+                    }
+                },
+            },
+        });
+    }
+    async disconnect() {
+        if (this.session) {
+            try {
+                await this.session.close();
+            }
+            catch {
+                // Ignore close errors
+            }
+            this._connected = false;
+            this.session = null;
+        }
+    }
+    /**
+     * Send a raw PCM audio frame to Gemini Live.
+     * Input: Uint8Array of 16-bit PCM samples at 24kHz.
+     */
+    sendAudio(frame) {
+        if (!this.session || !this._connected)
+            return;
+        const base64 = Buffer.from(frame).toString('base64');
+        this.session.sendRealtimeInput({
+            audio: {
+                data: base64,
+                mimeType: `audio/pcm;rate=${SAMPLE_RATE}`,
+            },
+        });
+    }
+    /**
+     * Send a tool response back to Gemini Live.
+     */
+    sendToolResponse(responses) {
+        if (!this.session)
+            return;
+        this.session.sendToolResponse({
+            functionResponses: responses.map(r => ({
+                id: r.id,
+                name: r.name,
+                response: { output: r.output },
+            })),
+        });
+    }
+    /**
+     * Update the session config (system prompt and/or tools) by disconnecting
+     * and reconnecting with the new overrides. The existing resumption handle is
+     * preserved so the conversation context is not lost.
+     *
+     * Accepts Partial<RealtimeSessionConfig> to satisfy the RealtimeAudioClient
+     * interface. Only systemInstruction and tools fields are applied; other fields
+     * (voice, model, audio) require a full reconnect via connect().
+     */
+    async updateConfig(config) {
+        this.runtimeOverrides = {
+            systemInstruction: config.systemInstruction,
+            tools: config.tools,
+        };
+        // Set reconfiguring flag to suppress the 'disconnected' event during
+        // the reconnect cycle. Without this, RealtimeRuntime would interpret the
+        // disconnect as a connection loss and terminate the session.
+        this._reconfiguring = true;
+        try {
+            await this.disconnect();
+            await this.connect();
+        }
+        finally {
+            this._reconfiguring = false;
+        }
+    }
+    /**
+     * Nudge the model to speak after reconfigure. Tries sendClientContent first;
+     * falls back to sendRealtimeInput with text for models that restrict client content.
+     */
+    requestResponse(instruction) {
+        if (!this.session || !this._connected)
+            return;
+        const text = instruction ?? 'Continue from the current flow state now.';
+        try {
+            if (typeof this.session.sendClientContent === 'function') {
+                this.session.sendClientContent({
+                    turns: [{ role: 'user', parts: [{ text }] }],
+                });
+                return;
+            }
+        }
+        catch (err) {
+            console.error('[GeminiLiveSession] sendClientContent failed, falling back to sendRealtimeInput:', err);
+        }
+        try {
+            this.session.sendRealtimeInput({ text });
+        }
+        catch (err) {
+            console.error('[GeminiLiveSession] requestResponse failed:', err);
+        }
+    }
+    // --- Private ---
+    handleServerMessage(message) {
+        // Audio output
+        if (message.serverContent?.modelTurn?.parts) {
+            for (const part of message.serverContent.modelTurn.parts) {
+                if (part.inlineData?.data) {
+                    const audioData = new Uint8Array(Buffer.from(part.inlineData.data, 'base64'));
+                    this.config.onEvent({ type: 'audio', data: audioData });
+                    this.emitEvent('audio', audioData);
+                }
+                if (part.text) {
+                    this.config.onEvent({ type: 'transcript', text: part.text, role: 'assistant' });
+                    this.emitEvent('transcript', part.text, 'assistant');
+                }
+            }
+        }
+        // Output audio transcription
+        if (message.serverContent?.outputTranscription?.text) {
+            const text = message.serverContent.outputTranscription.text;
+            this.config.onEvent({ type: 'transcript', text, role: 'assistant' });
+            this.emitEvent('transcript', text, 'assistant');
+        }
+        // Input transcription
+        if (message.serverContent?.inputTranscription?.text) {
+            const text = message.serverContent.inputTranscription.text;
+            this.config.onEvent({ type: 'transcript', text, role: 'user' });
+            this.emitEvent('transcript', text, 'user');
+        }
+        // Turn complete
+        if (message.serverContent?.turnComplete) {
+            this.config.onEvent({ type: 'turn-complete' });
+            this.emitEvent('turn-complete');
+        }
+        // Interrupted
+        if (message.serverContent?.interrupted) {
+            this.config.onEvent({ type: 'interrupted' });
+            this.emitEvent('interrupted');
+        }
+        // Tool calls
+        if (message.toolCall?.functionCalls) {
+            for (const fc of message.toolCall.functionCalls) {
+                this.config.onEvent({ type: 'tool-call', id: fc.id, name: fc.name, args: fc.args });
+                this.emitEvent('tool-call', fc.id, fc.name, fc.args);
+            }
+        }
+        // Session resumption — internal only, no RealtimeEventMap equivalent
+        if (message.sessionResumptionUpdate?.newHandle) {
+            this.resumptionHandle = message.sessionResumptionUpdate.newHandle;
+            this.config.onEvent({
+                type: 'session-resumed',
+                newHandle: this.resumptionHandle,
+            });
+        }
+    }
+}
+//# sourceMappingURL=GeminiLiveSession.js.map

package/dist/GeminiLiveSession.js.map

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

package/dist/RealtimeCallWorker.d.ts

@@ -0,0 +1,47 @@
+import type { RealtimeAudioClient } from '@ariaflowagents/core/realtime';
+import type { WorkerLike, TransportSession, VoiceAgentConfig } from './types.js';
+import type { RealtimeRuntime } from '@ariaflowagents/core/realtime';
+/**
+ * Factory function that creates a RealtimeAudioClient for a given agent.
+ * This is the provider abstraction point: Gemini, OpenAI, or any future
+ * provider just needs a factory that returns a valid RealtimeAudioClient.
+ */
+export type ModelClientFactory = (agent: VoiceAgentConfig) => RealtimeAudioClient;
+export interface RealtimeCallWorkerConfig {
+    callId: string;
+    sessionId: string;
+    userId?: string;
+    agent: VoiceAgentConfig;
+    transport: TransportSession;
+    runtime: RealtimeRuntime;
+    /** Factory that creates the provider model client (Gemini, OpenAI, etc.). */
+    createModelClient: ModelClientFactory;
+}
+/**
+ * Thin, provider-agnostic wrapper that bridges VoiceEngine's WorkerLike
+ * interface with the core RealtimeRuntime.
+ *
+ * This worker owns ZERO orchestration logic. All semantic behavior
+ * (hooks, persistence, extraction, memory, capability routing) is
+ * handled by the OrchestrationAuthority composed inside RealtimeRuntime.
+ *
+ * The worker only owns:
+ * 1. Creating a model client via the injected factory
+ * 2. Calling runtime.startSession() with the client + transport
+ * 3. Exposing start()/stop() for VoiceEngine lifecycle
+ */
+export declare class RealtimeCallWorker implements WorkerLike {
+    private config;
+    private sessionHandle;
+    constructor(config: RealtimeCallWorkerConfig);
+    get callId(): string;
+    /**
+     * Start the call: create model client via factory, delegate to RealtimeRuntime.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the call: delegate to RealtimeRuntime.
+     */
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=RealtimeCallWorker.d.ts.map

package/dist/RealtimeCallWorker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RealtimeCallWorker.d.ts","sourceRoot":"","sources":["../src/RealtimeCallWorker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAyB,MAAM,+BAA+B,CAAC;AAChG,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,gBAAgB,KAAK,mBAAmB,CAAC;AAElF,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,gBAAgB,CAAC;IACxB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,OAAO,EAAE,eAAe,CAAC;IACzB,6EAA6E;IAC7E,iBAAiB,EAAE,kBAAkB,CAAC;CACvC;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,kBAAmB,YAAW,UAAU;IACnD,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,aAAa,CAAsC;gBAE/C,MAAM,EAAE,wBAAwB;IAI5C,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAM5B"}

package/dist/RealtimeCallWorker.js

@@ -0,0 +1,55 @@
+/**
+ * Thin, provider-agnostic wrapper that bridges VoiceEngine's WorkerLike
+ * interface with the core RealtimeRuntime.
+ *
+ * This worker owns ZERO orchestration logic. All semantic behavior
+ * (hooks, persistence, extraction, memory, capability routing) is
+ * handled by the OrchestrationAuthority composed inside RealtimeRuntime.
+ *
+ * The worker only owns:
+ * 1. Creating a model client via the injected factory
+ * 2. Calling runtime.startSession() with the client + transport
+ * 3. Exposing start()/stop() for VoiceEngine lifecycle
+ */
+export class RealtimeCallWorker {
+    config;
+    sessionHandle = null;
+    constructor(config) {
+        this.config = config;
+    }
+    get callId() {
+        return this.config.callId;
+    }
+    /**
+     * Start the call: create model client via factory, delegate to RealtimeRuntime.
+     */
+    async start() {
+        const { runtime, transport, agent, sessionId, userId, createModelClient } = this.config;
+        // Create the provider model client via the injected factory.
+        // The factory returns a RealtimeAudioClient (Gemini, OpenAI, etc.).
+        const modelClient = createModelClient(agent);
+        // Delegate to RealtimeRuntime — this is where all orchestration happens.
+        this.sessionHandle = await runtime.startSession({
+            modelClient,
+            transport: {
+                sendAudio: (data) => transport.sendAudio(data),
+                onAudio: (handler) => transport.onAudio(handler),
+                onClose: (handler) => transport.onClose(handler),
+                close: () => transport.close(),
+            },
+            sessionId,
+            userId,
+            agentId: agent.id,
+        });
+    }
+    /**
+     * Stop the call: delegate to RealtimeRuntime.
+     */
+    async stop() {
+        if (this.sessionHandle) {
+            await this.sessionHandle.stop();
+            this.sessionHandle = null;
+        }
+    }
+}
+//# sourceMappingURL=RealtimeCallWorker.js.map

package/dist/RealtimeCallWorker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RealtimeCallWorker.js","sourceRoot":"","sources":["../src/RealtimeCallWorker.ts"],"names":[],"mappings":"AAsBA;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,kBAAkB;IACrB,MAAM,CAA2B;IACjC,aAAa,GAAiC,IAAI,CAAC;IAE3D,YAAY,MAAgC;QAC1C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QAExF,6DAA6D;QAC7D,oEAAoE;QACpE,MAAM,WAAW,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAE7C,yEAAyE;QACzE,IAAI,CAAC,aAAa,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC;YAC9C,WAAW;YACX,SAAS,EAAE;gBACT,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC;gBAC9C,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC;gBAChD,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC;gBAChD,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE;aAC/B;YACD,SAAS;YACT,MAAM;YACN,OAAO,EAAE,KAAK,CAAC,EAAE;SAClB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;YAChC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC5B,CAAC;IACH,CAAC;CACF"}

package/dist/VoiceEngine.d.ts

@@ -0,0 +1,67 @@
+import type { AgentConfig } from '@ariaflowagents/core/types';
+import type { VoiceEngineConfig, VoiceAgentConfig, AcceptCallParams, WorkerLike } from './types.js';
+/**
+ * VoiceEngine — provider-agnostic call acceptor backed by the core
+ * RealtimeRuntime and OrchestrationAuthority.
+ *
+ * Supports any realtime provider (Gemini, OpenAI, custom) through the
+ * `createModelClient` factory config. Defaults to Gemini when `gemini`
+ * config is provided and no custom factory is set.
+ *
+ * Architecture:
+ * 1. VoiceEngine constructs a DefaultOrchestrationAuthority (core's brain)
+ * 2. VoiceEngine constructs a RealtimeRuntime (core's realtime facade)
+ * 3. acceptCall() creates a thin RealtimeCallWorker that delegates
+ *    to RealtimeRuntime.startSession()
+ *
+ * All voice sessions get the FULL set of core semantics:
+ * - Hook lifecycle (onStart, onEnd, onToolResult, onHandoff, etc.)
+ * - Persistence with retry and onPersistenceError hook
+ * - Post-turn extraction
+ * - Memory ingestion
+ * - CapabilityHost routing (flows, handoffs, extraction, guardrails)
+ *
+ * Usage (Gemini — default):
+ * ```typescript
+ * const engine = new VoiceEngine({ foundation, agents, defaultAgentId, gemini });
+ * ```
+ *
+ * Usage (OpenAI Realtime):
+ * ```typescript
+ * const engine = new VoiceEngine({
+ *   foundation, agents, defaultAgentId,
+ *   createModelClient: () => new OpenAIRealtimeClient({ apiKey: '...' }),
+ * });
+ * ```
+ */
+export declare class VoiceEngine {
+    private agents;
+    private foundation;
+    private config;
+    private activeWorkers;
+    private realtimeRuntime;
+    private modelClientFactory;
+    constructor(config: VoiceEngineConfig);
+    /**
+     * Accept an incoming call and create a RealtimeCallWorker.
+     * The worker is NOT started automatically — call `worker.start()`.
+     */
+    acceptCall(params: AcceptCallParams): Promise<WorkerLike>;
+    /**
+     * Get an active call worker by call ID.
+     */
+    getWorker(callId: string): WorkerLike | undefined;
+    /**
+     * Stop and remove a call worker.
+     */
+    endCall(callId: string): Promise<void>;
+    /**
+     * Stop all active calls.
+     */
+    shutdown(): Promise<void>;
+}
+/**
+ * Convert VoiceAgentConfig to a shape compatible with core AgentConfig.
+ */
+export declare function voiceAgentToCoreAgent(agent: VoiceAgentConfig): AgentConfig;
+//# sourceMappingURL=VoiceEngine.d.ts.map

package/dist/VoiceEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VoiceEngine.d.ts","sourceRoot":"","sources":["../src/VoiceEngine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAQpG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,aAAa,CAAiC;IACtD,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,kBAAkB,CAAmD;gBAEjE,MAAM,EAAE,iBAAiB;IAgDrC;;;OAGG;IACG,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IA4B/D;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIjD;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ5C;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAIhC;AAID;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,gBAAgB,GAAG,WAAW,CAU1E"}

package/dist/VoiceEngine.js

@@ -0,0 +1,156 @@
+import crypto from 'node:crypto';
+import { DefaultOrchestrationAuthority } from '@ariaflowagents/core/orchestration';
+import { RealtimeRuntime } from '@ariaflowagents/core/realtime';
+import { RealtimeCallWorker } from './RealtimeCallWorker.js';
+import { GeminiLiveSession } from './GeminiLiveSession.js';
+/**
+ * VoiceEngine — provider-agnostic call acceptor backed by the core
+ * RealtimeRuntime and OrchestrationAuthority.
+ *
+ * Supports any realtime provider (Gemini, OpenAI, custom) through the
+ * `createModelClient` factory config. Defaults to Gemini when `gemini`
+ * config is provided and no custom factory is set.
+ *
+ * Architecture:
+ * 1. VoiceEngine constructs a DefaultOrchestrationAuthority (core's brain)
+ * 2. VoiceEngine constructs a RealtimeRuntime (core's realtime facade)
+ * 3. acceptCall() creates a thin RealtimeCallWorker that delegates
+ *    to RealtimeRuntime.startSession()
+ *
+ * All voice sessions get the FULL set of core semantics:
+ * - Hook lifecycle (onStart, onEnd, onToolResult, onHandoff, etc.)
+ * - Persistence with retry and onPersistenceError hook
+ * - Post-turn extraction
+ * - Memory ingestion
+ * - CapabilityHost routing (flows, handoffs, extraction, guardrails)
+ *
+ * Usage (Gemini — default):
+ * ```typescript
+ * const engine = new VoiceEngine({ foundation, agents, defaultAgentId, gemini });
+ * ```
+ *
+ * Usage (OpenAI Realtime):
+ * ```typescript
+ * const engine = new VoiceEngine({
+ *   foundation, agents, defaultAgentId,
+ *   createModelClient: () => new OpenAIRealtimeClient({ apiKey: '...' }),
+ * });
+ * ```
+ */
+export class VoiceEngine {
+    agents = new Map();
+    foundation;
+    config;
+    activeWorkers = new Map();
+    realtimeRuntime;
+    modelClientFactory;
+    constructor(config) {
+        this.config = config;
+        this.foundation = config.foundation;
+        for (const agent of config.agents) {
+            this.agents.set(agent.id, agent);
+        }
+        // Resolve the model client factory:
+        // 1. Custom factory takes priority (OpenAI, custom providers)
+        // 2. Fall back to Gemini factory when gemini config is provided
+        // 3. Error if neither is provided
+        if (config.createModelClient) {
+            this.modelClientFactory = config.createModelClient;
+        }
+        else if (config.gemini) {
+            const geminiConfig = config.gemini;
+            this.modelClientFactory = (agent) => {
+                return new GeminiLiveSession({
+                    gemini: geminiConfig,
+                    agent,
+                    onEvent: () => { }, // Events go through the on() interface
+                });
+            };
+        }
+        else {
+            throw new Error('VoiceEngine: either "gemini" config or "createModelClient" factory is required');
+        }
+        // Build the core authority — this is the single brain for all voice sessions.
+        const authority = new DefaultOrchestrationAuthority({
+            agents: config.agents.map(voiceAgentToCoreAgent),
+            defaultAgentId: config.defaultAgentId,
+            hooks: config.hooks,
+            memoryService: config.memoryService,
+            memoryIngestion: config.memoryIngestion,
+            extractionModel: config.extractionModel,
+            autoRetrieveProvider: config.autoRetrieveProvider,
+        });
+        // Build the realtime facade — provider-agnostic event loop over authority.
+        this.realtimeRuntime = new RealtimeRuntime({
+            agents: config.agents.map(voiceAgentToCoreAgent),
+            defaultAgentId: config.defaultAgentId,
+            authority,
+        });
+    }
+    /**
+     * Accept an incoming call and create a RealtimeCallWorker.
+     * The worker is NOT started automatically — call `worker.start()`.
+     */
+    async acceptCall(params) {
+        const agentId = params.agentId ?? this.config.defaultAgentId;
+        const agent = this.agents.get(agentId);
+        if (!agent) {
+            throw new Error(`VoiceEngine: agent "${agentId}" not found`);
+        }
+        const callId = params.callId ?? crypto.randomUUID();
+        const sessionId = params.sessionId ?? `voice-${callId}`;
+        // Create a thin worker that delegates to RealtimeRuntime.
+        // The model client factory is provider-agnostic — same worker
+        // works for Gemini, OpenAI, or any future provider.
+        const worker = new RealtimeCallWorker({
+            callId,
+            sessionId,
+            userId: params.userId,
+            agent,
+            transport: params.transport,
+            runtime: this.realtimeRuntime,
+            createModelClient: this.modelClientFactory,
+        });
+        this.activeWorkers.set(callId, worker);
+        return worker;
+    }
+    /**
+     * Get an active call worker by call ID.
+     */
+    getWorker(callId) {
+        return this.activeWorkers.get(callId);
+    }
+    /**
+     * Stop and remove a call worker.
+     */
+    async endCall(callId) {
+        const worker = this.activeWorkers.get(callId);
+        if (worker) {
+            await worker.stop();
+            this.activeWorkers.delete(callId);
+        }
+    }
+    /**
+     * Stop all active calls.
+     */
+    async shutdown() {
+        const promises = Array.from(this.activeWorkers.keys()).map(id => this.endCall(id));
+        await Promise.allSettled(promises);
+    }
+}
+// ─── Helpers ────────────────────────────────────────────────────────────────
+/**
+ * Convert VoiceAgentConfig to a shape compatible with core AgentConfig.
+ */
+export function voiceAgentToCoreAgent(agent) {
+    return {
+        id: agent.id,
+        name: agent.name,
+        description: agent.description,
+        prompt: agent.prompt,
+        type: agent.flow ? 'flow' : 'llm',
+        tools: agent.tools,
+        ...(agent.flow ? { flow: agent.flow, initialNode: agent.initialNode ?? agent.flow.nodes[0]?.id } : {}),
+    };
+}
+//# sourceMappingURL=VoiceEngine.js.map

package/dist/VoiceEngine.js.map

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