@talk2view/sdk 0.22.0 → 0.23.0

package/dist/voice-facade.js

@@ -10,7 +10,7 @@ import { TypedEventEmitter } from './event-emitter.js';
 import { VoiceStartError } from './voice-error.js';
 const loadVoiceController = async () => (await import('./voice.js')).T2VVoiceController;
 /** Every event the controller emits; the facade forwards each one. */
-const FORWARDED = ['transcript', 'toolCall', 'agentState', 'approvalChange', 'error', 'ended'];
+const FORWARDED = ['transcript', 'toolCall', 'agentState', 'approvalChange', 'error', 'ended', 'note', 'callStarted'];
 export class T2VVoice {
     options;
     emitter = new TypedEventEmitter();

package/dist/voice-facade.js.map

@@ -1 +1 @@
-{"version":3,"file":"voice-facade.js","sourceRoot":"","sources":["../src/voice-facade.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"voice-facade.js","sourceRoot":"","sources":["../src/voice-facade.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAWnD,MAAM,mBAAmB,GAA0B,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,kBAAkB,CAAC;AAE/G,sEAAsE;AACtE,MAAM,SAAS,GAAG,CAAC,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,CAAU,CAAC;AAE/H,MAAM,OAAO,QAAQ;IAUU;IATZ,OAAO,GAAG,IAAI,iBAAiB,EAAiB,CAAC;IAC1D,MAAM,GAAe,MAAM,CAAC;IAC5B,UAAU,GAA8B,IAAI,CAAC;IAC7C,OAAO,GAAuC,IAAI,CAAC;IAC3D,4EAA4E;IACpE,KAAK,GAAG,CAAC,CAAC;IAClB,2DAA2D;IACnD,YAAY,GAAG,KAAK,CAAC;IAE7B,YAA6B,OAAwB;QAAxB,YAAO,GAAP,OAAO,CAAiB;IAAG,CAAC;IAEzD,gEAAgE;IAChE,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,EAAE,CACA,KAAQ,EACR,QAA6C;QAE7C,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED,GAAG,CAAyC,KAAQ,EAAE,QAA6C;QACjG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,uFAAuF;IACvF,KAAK,CAAC,KAAK,CAAC,UAA6B,EAAE;QACzC,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,YAAY;YAAE,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACjF,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO;QAC9B,MAAM,KAAK,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QAC5B,IAAI,UAA8B,CAAC;QACnC,IAAI,CAAC;YACH,UAAU,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACjC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,yEAAyE;YACzE,sEAAsE;YACtE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,qCAAqC;YAC1D,IAAI,KAAK,KAAK,IAAI,CAAC,KAAK;gBAAE,OAAO;YACjC,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;YAC1B,MAAM,OAAO,GAAG,4DAA4D,CAAC;YAC7E,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,CAAC;YACzD,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACvB,MAAM,IAAI,eAAe,CAAC,aAAa,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QACpE,CAAC;QACD,wEAAwE;QACxE,IAAI,KAAK,KAAK,IAAI,CAAC,KAAK;YAAE,OAAO;QACjC,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC1B,OAAO,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACH,OAAO;QACL,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CACP,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EACpC,GAAG,EAAE;YACH,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI;gBAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACjD,CAAC,CACF,CAAC;IACJ,CAAC;IAED,kFAAkF;IAClF,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;QAChB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;YAC1B,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACvB,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAClC,OAAO;QACT,CAAC;QACD,MAAM,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC;IAChC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM;QACV,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;QAChB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;YAC1B,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,sDAAsD,EAAE,CAAC,CAAC;YAClH,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACvB,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;YACvC,OAAO;QACT,CAAC;QACD,MAAM,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAClC,CAAC;IAEO,QAAQ,CAAC,KAAiB;QAChC,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK;YAAE,OAAO;QAClC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;IAED;;;OAGG;IACK,QAAQ,CAAyC,KAAQ,EAAE,GAAG,IAAsB;QAC1F,IAAI,CAAC;YACH,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,KAAK,CAAC,wBAAwB,KAAK,kBAAkB,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAEO,IAAI;QACV,IAAI,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,IAAI,mBAAmB,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE;YAC1F,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;YAC1D,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;YACxC,UAAU,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;YAC9D,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;gBAC9B,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CACzC,IAAI,CAAC,QAAiD,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,CACnF,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;YAC7B,OAAO,UAAU,CAAC;QACpB,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF"}

package/dist/voice-fence.d.ts

@@ -0,0 +1,37 @@
+/**
+ * The fence guard for an ElevenLabs call's instructions.
+ *
+ * The engine puts the partner prompt, the page prompt and the app's
+ * capabilities between two delimiters in the agent's instructions. An
+ * ElevenLabs call's page prompt and capabilities reach the agent as dynamic
+ * variables inside that fence, so the SDK guards them as the engine does:
+ * nothing from the page or a tool can close the fence early. Each function
+ * gives the engine's text for the same input (`t2v/core/voice_rules.py`), so
+ * the instructions read the same whichever voice model takes the call, with
+ * one difference: `formatCapabilities([])` gives `(none)` where the engine's
+ * `format_capabilities` gives `""`, because the dynamic variable needs a
+ * value and the agent's placeholder is `(none)`.
+ */
+import type { VoiceCapability } from './types.js';
+/** The delimiter that opens the fence. */
+export declare const PARTNER_PROMPT_BEGIN = "<<<BEGIN APP DESCRIPTION>>>";
+/** The delimiter that closes the fence. */
+export declare const PARTNER_PROMPT_END = "<<<END APP DESCRIPTION>>>";
+/** What a delimiter inside the fenced text is replaced with. */
+export declare const DELIMITER_REMOVED = "[delimiter removed]";
+/** What an empty page prompt or capability list reads as: a dynamic variable needs a value. */
+export declare const NONE_PLACEHOLDER = "(none)";
+/**
+ * `text` with each delimiter replaced by {@link DELIMITER_REMOVED}: every
+ * occurrence, left to right, as the engine's `str.replace` does. Replaced,
+ * never deleted: deleting lets nested fragments such as
+ * `<<<END APP<<<END APP DESCRIPTION>>> DESCRIPTION>>>` rejoin into a real fence.
+ */
+export declare function unfence(text: string): string;
+/**
+ * The app's capabilities as `- name: description` lines (`- name` when the
+ * description is empty), every name and description unfenced; or
+ * {@link NONE_PLACEHOLDER} when there are none.
+ */
+export declare function formatCapabilities(capabilities: VoiceCapability[]): string;
+//# sourceMappingURL=voice-fence.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"voice-fence.d.ts","sourceRoot":"","sources":["../src/voice-fence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,0CAA0C;AAC1C,eAAO,MAAM,oBAAoB,gCAAgC,CAAC;AAClE,2CAA2C;AAC3C,eAAO,MAAM,kBAAkB,8BAA8B,CAAC;AAC9D,gEAAgE;AAChE,eAAO,MAAM,iBAAiB,wBAAwB,CAAC;AACvD,+FAA+F;AAC/F,eAAO,MAAM,gBAAgB,WAAW,CAAC;AAEzC;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,eAAe,EAAE,GAAG,MAAM,CAO1E"}

package/dist/voice-fence.js

@@ -0,0 +1,44 @@
+/**
+ * The fence guard for an ElevenLabs call's instructions.
+ *
+ * The engine puts the partner prompt, the page prompt and the app's
+ * capabilities between two delimiters in the agent's instructions. An
+ * ElevenLabs call's page prompt and capabilities reach the agent as dynamic
+ * variables inside that fence, so the SDK guards them as the engine does:
+ * nothing from the page or a tool can close the fence early. Each function
+ * gives the engine's text for the same input (`t2v/core/voice_rules.py`), so
+ * the instructions read the same whichever voice model takes the call, with
+ * one difference: `formatCapabilities([])` gives `(none)` where the engine's
+ * `format_capabilities` gives `""`, because the dynamic variable needs a
+ * value and the agent's placeholder is `(none)`.
+ */
+/** The delimiter that opens the fence. */
+export const PARTNER_PROMPT_BEGIN = '<<<BEGIN APP DESCRIPTION>>>';
+/** The delimiter that closes the fence. */
+export const PARTNER_PROMPT_END = '<<<END APP DESCRIPTION>>>';
+/** What a delimiter inside the fenced text is replaced with. */
+export const DELIMITER_REMOVED = '[delimiter removed]';
+/** What an empty page prompt or capability list reads as: a dynamic variable needs a value. */
+export const NONE_PLACEHOLDER = '(none)';
+/**
+ * `text` with each delimiter replaced by {@link DELIMITER_REMOVED}: every
+ * occurrence, left to right, as the engine's `str.replace` does. Replaced,
+ * never deleted: deleting lets nested fragments such as
+ * `<<<END APP<<<END APP DESCRIPTION>>> DESCRIPTION>>>` rejoin into a real fence.
+ */
+export function unfence(text) {
+    return text.split(PARTNER_PROMPT_BEGIN).join(DELIMITER_REMOVED).split(PARTNER_PROMPT_END).join(DELIMITER_REMOVED);
+}
+/**
+ * The app's capabilities as `- name: description` lines (`- name` when the
+ * description is empty), every name and description unfenced; or
+ * {@link NONE_PLACEHOLDER} when there are none.
+ */
+export function formatCapabilities(capabilities) {
+    if (capabilities.length === 0)
+        return NONE_PLACEHOLDER;
+    return capabilities
+        .map(({ name, description }) => description ? `- ${unfence(name)}: ${unfence(description)}` : `- ${unfence(name)}`)
+        .join('\n');
+}
+//# sourceMappingURL=voice-fence.js.map

package/dist/voice-fence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-fence.js","sourceRoot":"","sources":["../src/voice-fence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,0CAA0C;AAC1C,MAAM,CAAC,MAAM,oBAAoB,GAAG,6BAA6B,CAAC;AAClE,2CAA2C;AAC3C,MAAM,CAAC,MAAM,kBAAkB,GAAG,2BAA2B,CAAC;AAC9D,gEAAgE;AAChE,MAAM,CAAC,MAAM,iBAAiB,GAAG,qBAAqB,CAAC;AACvD,+FAA+F;AAC/F,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;AACpH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,YAA+B;IAChE,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,gBAAgB,CAAC;IACvD,OAAO,YAAY;SAChB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,CAC7B,WAAW,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,CACnF;SACA,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/voice-turn.d.ts

@@ -0,0 +1,119 @@
+/**
+ * The voice turn runner: each `ask_talk2view` request of an ElevenLabs voice
+ * call becomes an engine turn on the end-user's chat session, one at a time,
+ * as the voice service's handoff does for Gemini Live (`va/handoff.py`).
+ *
+ * An identical request already in flight or queued is merged
+ * ({@link ALREADY_WORKING}); a different one waits its turn. Every `ask()`
+ * resolves with plain text for the agent to speak.
+ *
+ * Keep this module out of core's up-front bundle: only the voice controller,
+ * which core loads with `import()`, may import it.
+ */
+import type { T2VSession, TurnOptions } from './sessions.js';
+import type { HumanDecision } from './types.js';
+/** The answer to a request identical to one already in flight or queued. */
+export declare const ALREADY_WORKING = "status: already_working (still on the previous request)";
+/** The answer when a turn ends without any text. */
+export declare const NO_TEXT = "(the agent returned no text)";
+/** The answer when a turn could not be run, or ran past its limit. */
+export declare const TURN_FAILED = "error: I couldn\u2019t reach the assistant just now.";
+/**
+ * How long a turn may run, its resumes and any wait on a card included,
+ * before it is ended with {@link TURN_FAILED}. It is the voice service's
+ * `engine_turn_timeout_s` (`va/engine_bridge.py`), and the agent's
+ * `ask_talk2view` tool stops waiting for an answer at the same 120 seconds
+ * (`response_timeout_secs`).
+ */
+export declare const TURN_TIMEOUT_MS = 120000;
+/**
+ * What the engine is told about a voice turn: the reply is spoken, and the
+ * call collects no approvals and shows no platform-tool activity.
+ */
+export declare const VOICE_TURN: TurnOptions;
+/**
+ * What makes two requests the same: lower-cased, whitespace collapsed to
+ * single spaces, and trailing `?`, `.`, `!` and spaces dropped, as the voice
+ * service's `normalise_request` (`va/handoff.py`).
+ */
+export declare function normaliseRequest(text: string): string;
+export interface VoiceTurnDeps {
+    /** The end-user's chat session the mint names: every turn runs on it. */
+    session: T2VSession;
+    /** The page prompt, sent as each turn's system message. */
+    pagePrompt?: string;
+    /**
+     * Shows the card for a client tool call that needs the end-user's go-ahead,
+     * and resolves with their decision, or with `endedBecause` when the card
+     * closed unanswered. The caller remembers an `always`.
+     */
+    onApproval: (toolCallId: string, toolName: string, args: Record<string, unknown>) => Promise<{
+        decision: HumanDecision;
+        endedBecause?: string;
+    }>;
+    /** Whether the end-user has said `always` to this tool: it runs without a card. */
+    isAlwaysAllowed: (toolName: string) => boolean;
+    /** `working` as a turn starts, `idle` once it settles. */
+    onState: (state: 'working' | 'idle') => void;
+    /** A turn found the end-user's budget spent: the call says goodbye. */
+    onBudgetExceeded: () => void;
+    /** How long a turn may run before it is ended. Default: {@link TURN_TIMEOUT_MS}. */
+    turnTimeoutMs?: number;
+}
+/**
+ * Runs a voice call's requests as engine turns, one at a time. `abort()`
+ * answers every pending `ask()` at once, as the call ends.
+ */
+export declare class VoiceTurnRunner {
+    private readonly deps;
+    /** Normalised requests in flight or queued. */
+    private readonly inFlight;
+    /** The last turn queued: the next one starts when it settles. */
+    private last;
+    /** The controller of the turn in flight. */
+    private controller;
+    /** Set by {@link abort}: from then on every `ask()` resolves with it. */
+    private reason;
+    /** Resolves with the reason on {@link abort}; every `ask()` races it. */
+    private readonly aborted;
+    private resolveAborted;
+    constructor(deps: VoiceTurnDeps);
+    /** A turn is in flight or queued. */
+    get busy(): boolean;
+    /**
+     * Run `request` as an engine turn. Resolves with the turn's text, trimmed,
+     * or {@link NO_TEXT}; `error: <message>` when the engine reports an error;
+     * {@link TURN_FAILED} when the turn could not be run or ran past its limit;
+     * {@link ALREADY_WORKING} when the same request is already in flight or
+     * queued; once aborted, the abort reason.
+     */
+    ask(request: string): Promise<string>;
+    /**
+     * End the runner for good: abort the turn in flight, resolve its `ask()`
+     * and every queued one with `reason`, and resolve later ones with it at once.
+     */
+    abort(reason: string): void;
+    /**
+     * One turn, unless the runner was aborted while it waited. A turn still
+     * running at its limit is aborted and answers {@link TURN_FAILED}, whether
+     * or not its stream has noticed, and the runner moves on: the request
+     * leaves the in-flight set and the next turn starts.
+     */
+    private run;
+    /**
+     * Tell the caller the runner's state. A throw from `onState` is swallowed,
+     * and nothing is logged: it must not lose the turn's answer, nor stop the
+     * turns queued behind it.
+     */
+    private reportState;
+    /** The turn's answer, from its stream and the stream of each resume. */
+    private turn;
+    /**
+     * The resume of a client tool call that needs the end-user's go-ahead. A
+     * tool they always allow runs at once. Otherwise the card decides: the
+     * resume carries their decision, or the reason the card closed without one.
+     * Nothing runs until the resume is read.
+     */
+    private resume;
+}
+//# sourceMappingURL=voice-turn.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"voice-turn.d.ts","sourceRoot":"","sources":["../src/voice-turn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,KAAK,EAAa,aAAa,EAAmB,MAAM,YAAY,CAAC;AAE5E,4EAA4E;AAC5E,eAAO,MAAM,eAAe,4DAA4D,CAAC;AAEzF,oDAAoD;AACpD,eAAO,MAAM,OAAO,iCAAiC,CAAC;AAEtD,sEAAsE;AACtE,eAAO,MAAM,WAAW,yDAAoD,CAAC;AAE7E;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,SAAU,CAAC;AAEvC;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,WAAsF,CAAC;AAEhH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKrD;AAED,MAAM,WAAW,aAAa;IAC5B,yEAAyE;IACzE,OAAO,EAAE,UAAU,CAAC;IACpB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,UAAU,EAAE,CACV,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,OAAO,CAAC;QAAE,QAAQ,EAAE,aAAa,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,mFAAmF;IACnF,eAAe,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;IAC/C,0DAA0D;IAC1D,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,KAAK,IAAI,CAAC;IAC7C,uEAAuE;IACvE,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,oFAAoF;IACpF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,qBAAa,eAAe;IAad,OAAO,CAAC,QAAQ,CAAC,IAAI;IAZjC,+CAA+C;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,iEAAiE;IACjE,OAAO,CAAC,IAAI,CAAuC;IACnD,4CAA4C;IAC5C,OAAO,CAAC,UAAU,CAAgC;IAClD,yEAAyE;IACzE,OAAO,CAAC,MAAM,CAAuB;IACrC,yEAAyE;IACzE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,cAAc,CAA4B;gBAErB,IAAI,EAAE,aAAa;IAMhD,qCAAqC;IACrC,IAAI,IAAI,IAAI,OAAO,CAElB;IAED;;;;;;OAMG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAcrC;;;OAGG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQ3B;;;;;OAKG;YACW,GAAG;IAwBjB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAQnB,wEAAwE;YAC1D,IAAI;IAgClB;;;;;OAKG;YACW,MAAM;CAerB"}

package/dist/voice-turn.js

@@ -0,0 +1,207 @@
+/**
+ * The voice turn runner: each `ask_talk2view` request of an ElevenLabs voice
+ * call becomes an engine turn on the end-user's chat session, one at a time,
+ * as the voice service's handoff does for Gemini Live (`va/handoff.py`).
+ *
+ * An identical request already in flight or queued is merged
+ * ({@link ALREADY_WORKING}); a different one waits its turn. Every `ask()`
+ * resolves with plain text for the agent to speak.
+ *
+ * Keep this module out of core's up-front bundle: only the voice controller,
+ * which core loads with `import()`, may import it.
+ */
+/** The answer to a request identical to one already in flight or queued. */
+export const ALREADY_WORKING = 'status: already_working (still on the previous request)';
+/** The answer when a turn ends without any text. */
+export const NO_TEXT = '(the agent returned no text)';
+/** The answer when a turn could not be run, or ran past its limit. */
+export const TURN_FAILED = 'error: I couldn’t reach the assistant just now.';
+/**
+ * How long a turn may run, its resumes and any wait on a card included,
+ * before it is ended with {@link TURN_FAILED}. It is the voice service's
+ * `engine_turn_timeout_s` (`va/engine_bridge.py`), and the agent's
+ * `ask_talk2view` tool stops waiting for an answer at the same 120 seconds
+ * (`response_timeout_secs`).
+ */
+export const TURN_TIMEOUT_MS = 120_000;
+/**
+ * What the engine is told about a voice turn: the reply is spoken, and the
+ * call collects no approvals and shows no platform-tool activity.
+ */
+export const VOICE_TURN = { surface: 'voice', supportsApproval: false, supportsToolEvents: false };
+/**
+ * What makes two requests the same: lower-cased, whitespace collapsed to
+ * single spaces, and trailing `?`, `.`, `!` and spaces dropped, as the voice
+ * service's `normalise_request` (`va/handoff.py`).
+ */
+export function normaliseRequest(text) {
+    const collapsed = text.toLowerCase().trim().split(/\s+/).join(' ');
+    let end = collapsed.length;
+    while (end > 0 && '?.! '.includes(collapsed.charAt(end - 1)))
+        end -= 1;
+    return collapsed.slice(0, end);
+}
+/**
+ * Runs a voice call's requests as engine turns, one at a time. `abort()`
+ * answers every pending `ask()` at once, as the call ends.
+ */
+export class VoiceTurnRunner {
+    deps;
+    /** Normalised requests in flight or queued. */
+    inFlight = new Set();
+    /** The last turn queued: the next one starts when it settles. */
+    last = Promise.resolve();
+    /** The controller of the turn in flight. */
+    controller = null;
+    /** Set by {@link abort}: from then on every `ask()` resolves with it. */
+    reason = null;
+    /** Resolves with the reason on {@link abort}; every `ask()` races it. */
+    aborted;
+    resolveAborted;
+    constructor(deps) {
+        this.deps = deps;
+        this.aborted = new Promise((resolve) => {
+            this.resolveAborted = resolve;
+        });
+    }
+    /** A turn is in flight or queued. */
+    get busy() {
+        return this.inFlight.size > 0;
+    }
+    /**
+     * Run `request` as an engine turn. Resolves with the turn's text, trimmed,
+     * or {@link NO_TEXT}; `error: <message>` when the engine reports an error;
+     * {@link TURN_FAILED} when the turn could not be run or ran past its limit;
+     * {@link ALREADY_WORKING} when the same request is already in flight or
+     * queued; once aborted, the abort reason.
+     */
+    ask(request) {
+        if (this.reason !== null)
+            return Promise.resolve(this.reason);
+        const key = normaliseRequest(request);
+        if (this.inFlight.has(key))
+            return Promise.resolve(ALREADY_WORKING);
+        // One turn at a time, in order. With none in flight or queued this one
+        // starts now, so the engine has it at once.
+        const start = () => this.run(request);
+        const idle = !this.busy;
+        this.inFlight.add(key);
+        const turn = (idle ? start() : this.last.then(start)).finally(() => this.inFlight.delete(key));
+        this.last = turn;
+        return Promise.race([turn, this.aborted]);
+    }
+    /**
+     * End the runner for good: abort the turn in flight, resolve its `ask()`
+     * and every queued one with `reason`, and resolve later ones with it at once.
+     */
+    abort(reason) {
+        if (this.reason !== null)
+            return;
+        this.reason = reason;
+        this.inFlight.clear();
+        this.controller?.abort();
+        this.resolveAborted(reason);
+    }
+    /**
+     * One turn, unless the runner was aborted while it waited. A turn still
+     * running at its limit is aborted and answers {@link TURN_FAILED}, whether
+     * or not its stream has noticed, and the runner moves on: the request
+     * leaves the in-flight set and the next turn starts.
+     */
+    async run(request) {
+        if (this.reason !== null)
+            return this.reason;
+        const controller = new AbortController();
+        this.controller = controller;
+        let expire;
+        const expired = new Promise((resolve) => {
+            expire = resolve;
+        });
+        const timer = setTimeout(() => {
+            controller.abort();
+            expire(TURN_FAILED);
+        }, this.deps.turnTimeoutMs ?? TURN_TIMEOUT_MS);
+        try {
+            this.reportState('working');
+            return await Promise.race([this.turn(request, controller.signal), expired]);
+        }
+        catch {
+            return TURN_FAILED;
+        }
+        finally {
+            clearTimeout(timer);
+            this.controller = null;
+            this.reportState('idle');
+        }
+    }
+    /**
+     * Tell the caller the runner's state. A throw from `onState` is swallowed,
+     * and nothing is logged: it must not lose the turn's answer, nor stop the
+     * turns queued behind it.
+     */
+    reportState(state) {
+        try {
+            this.deps.onState(state);
+        }
+        catch {
+            // Swallowed, as above.
+        }
+    }
+    /** The turn's answer, from its stream and the stream of each resume. */
+    async turn(request, signal) {
+        let text = '';
+        let events = this.deps.session.sendMessage(request, { systemPrompt: this.deps.pagePrompt, signal, ...VOICE_TURN });
+        for (;;) {
+            let approval = null;
+            for await (const event of events) {
+                // Aborted (the call ended, or the turn ran past its limit): the ask has
+                // its answer already, so whatever arrives after that is dropped.
+                if (signal.aborted)
+                    return TURN_FAILED;
+                if (event.type === 'text') {
+                    text += event.content;
+                }
+                else if (event.type === 'approval_required') {
+                    approval = {
+                        toolCallId: event.toolCallId,
+                        toolName: event.toolName,
+                        arguments: event.arguments,
+                        description: event.description,
+                    };
+                }
+                else if (event.type === 'error') {
+                    if (event.errorType === 'budget_exceeded')
+                        this.deps.onBudgetExceeded();
+                    return `error: ${event.message}`;
+                }
+            }
+            if (approval === null)
+                return text.trim() || NO_TEXT;
+            // Nor, once aborted, does a card open, a tool run or a resume go out:
+            // checked here, after the tool permission, and below, after the card.
+            if (signal.aborted)
+                return TURN_FAILED;
+            events = await this.resume(approval, signal);
+            if (signal.aborted)
+                return TURN_FAILED;
+        }
+    }
+    /**
+     * The resume of a client tool call that needs the end-user's go-ahead. A
+     * tool they always allow runs at once. Otherwise the card decides: the
+     * resume carries their decision, or the reason the card closed without one.
+     * Nothing runs until the resume is read.
+     */
+    async resume(approval, signal) {
+        const { session } = this.deps;
+        if (this.deps.isAlwaysAllowed(approval.toolName)) {
+            return session.respondToApproval(approval, { action: 'once' }, signal, VOICE_TURN);
+        }
+        const { decision, endedBecause } = await this.deps.onApproval(approval.toolCallId, approval.toolName, approval.arguments);
+        if (endedBecause) {
+            return session.resumeToolCall(approval.toolCallId, JSON.stringify({ error: endedBecause }), true, signal, VOICE_TURN);
+        }
+        return session.respondToApproval(approval, decision, signal, VOICE_TURN);
+    }
+}
+//# sourceMappingURL=voice-turn.js.map

package/dist/voice-turn.js.map

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

package/dist/voice.d.ts

@@ -3,17 +3,35 @@
  *
  * Core never imports this module statically: the `T2VVoice` facade
  * (`voice-facade.ts`) loads it with `import()` on the first `start()`, and it
- * in turn loads the Pipecat libraries, so chat-only partners ship neither.
+ * in turn loads the call libraries, so chat-only partners ship none of them.
  *
- * The engine mints a ticket (`POST /v1/voice/sessions`); the Pipecat client
- * libraries are loaded on first `start()` so chat-only partners never ship
- * them; WebRTC audio goes to the voice agent service; client tools the agent
- * calls arrive here over the RTVI data channel and run through the SAME tool
- * registry and permission check as chat, so partners write no new code.
+ * The engine mints the call (`POST /v1/voice/sessions`) on one of the voice
+ * models this SDK runs, and the mint says which. A Gemini Live call gets a
+ * ticket: the Pipecat client libraries, loaded on every `start()` because the
+ * microphone opens through them before the mint, carry its WebRTC audio to
+ * the voice agent service, and the client tools the agent calls arrive here
+ * over the RTVI data channel. An ElevenLabs call gets a conversation token:
+ * it runs in `voice-elevenlabs.ts` on the `@elevenlabs/client` library, and
+ * the agent's requests become engine turns on the end-user's chat session
+ * (`voice-turn.ts`), all three loaded with `import()` only for such a call. An
+ * ElevenLabs call that can't connect is tried once more, on Gemini Live.
+ * Either way, client tools run through the SAME tool registry and permission
+ * check as chat, so partners write no new code.
  */
 import { VoiceStartError } from './voice-error.js';
+import type { T2VSession } from './sessions.js';
 import type { T2VTools } from './tools.js';
-import type { VoiceEventMap, VoiceStartOptions, VoiceState } from './types.js';
+import type { VoiceEventMap, VoiceModelId, VoiceStartOptions, VoiceState } from './types.js';
+/** The voice models this SDK can run, as it asks the engine for them. */
+export declare const VOICE_MODELS_THIS_SDK_RUNS: readonly VoiceModelId[];
+/** What the end-user is told when no voice model this app allows can take the call. */
+export declare const NO_VOICE_MESSAGE = "Voice isn\u2019t available right now.";
+/** Each voice model's name, as the notes say it. */
+export declare const VOICE_MODEL_NAMES: Record<VoiceModelId, string>;
+/** The note when a voice model couldn't connect and another took the call: the engine's text. */
+export declare const NOTE_COULD_NOT_CONNECT = "Using {fallback} \u2014 {wanted} couldn\u2019t connect.";
+/** {@link NOTE_COULD_NOT_CONNECT} for the voice model used (`fallback`) and the one given up (`wanted`). */
+export declare function couldNotConnectNote(fallback: VoiceModelId, wanted: VoiceModelId): string;
 export interface PipecatCallbacks {
     onConnected?: () => void;
     onDisconnected?: () => void;
@@ -85,6 +103,18 @@ export interface T2VVoiceDeps {
     approvalTimeoutMs?: number;
     /** Whether the browser will prompt for the microphone. Default: the Permissions API. */
     micPermission?: () => Promise<PermissionState | 'unknown'>;
+    /**
+     * The chat session a voice call's turns run on, from the mint's
+     * `session_id`: the end-user's one engine session for this partner.
+     */
+    sessionFor: (sessionId: string) => T2VSession;
+    /**
+     * Loads the ElevenLabs client library, only when an ElevenLabs call starts.
+     * Default: `loadElevenLabsLibs` (`voice-elevenlabs.ts`).
+     */
+    loadElevenLabs?: import('./voice-elevenlabs.js').ElevenLabsLibLoader;
+    /** The browser's language tag, for the call's greeting and language. Default: `navigator.language`. */
+    language?: () => string;
 }
 export { VoiceStartError };
 /** The voice controller. Construct the {@link T2VVoice} facade (`t2v.voice`) instead. */
@@ -93,6 +123,26 @@ export declare class T2VVoiceController {
     private readonly emitter;
     private _state;
     private client;
+    /** The ElevenLabs call, from its start until the call ends. It reports its own end. */
+    private elCall;
+    /**
+     * The conversation id of an ElevenLabs call the engine minted that no
+     * {@link elCall} has taken over yet: an ending reports its end.
+     */
+    private mintedCall;
+    /**
+     * The mint in flight, until the start that sent it reads the answer. It
+     * may yet return an ElevenLabs call, so an ending meanwhile reports that
+     * call's end once it returns.
+     */
+    private mintInFlight;
+    /**
+     * ElevenLabs end reports the engine has not answered yet, and mints an
+     * ending came during. The next start waits for them before it mints, since
+     * the engine releases a call's credit when it hears of the end. Never
+     * rejects.
+     */
+    private pendingEndReports;
     private audio;
     private libs;
     private pendingApproval;
@@ -104,7 +154,13 @@ export declare class T2VVoiceController {
      * epoch belongs to a call that was hung up, and must not touch this one.
      */
     private epoch;
-    /** Settles the in-flight `start()`'s connect wait when the call is hung up mid-start. */
+    /**
+     * Bumped by every start as it asks for the microphone. Daily's call object
+     * is one per page, so every Pipecat client's microphone is the same track,
+     * and it belongs to the latest start that asked for it.
+     */
+    private micOpens;
+    /** Settles the in-flight `start()`'s waits when the call is hung up mid-start. */
     private abortStart;
     /**
      * The hang-up in progress; a concurrent `stop()` joins it. Tagged with the
@@ -135,6 +191,73 @@ export declare class T2VVoiceController {
      * call is hung up (`stop()`) before it connects.
      */
     start(options?: VoiceStartOptions): Promise<void>;
+    /**
+     * A Pipecat client for a Gemini Live call, its callbacks bound to the
+     * start that built it (`stale`). They do nothing once the client is no
+     * longer the controller's: an ElevenLabs call took over, or the call
+     * ended. A refused first offer (503 at capacity, 502) is retried by the
+     * transport for several seconds; the ticket cannot succeed on a retry, so
+     * it allows none until connected, then gets its default back for mid-call
+     * ICE recovery.
+     */
+    private buildPipecat;
+    /**
+     * Connect a Gemini Live call with the mint's ticket and offer URL, its ICE
+     * servers already on the transport. Resolves once the bot is ready.
+     */
+    private connectGemini;
+    /**
+     * Ask the engine for a call (`POST /v1/voice/sessions`) on any voice model
+     * this SDK runs but `exclude`, with the page's instructions and the
+     * browser's language (left out when longer than {@link MAX_LANGUAGE_LENGTH}).
+     * The engine chooses the voice model. When none is left for this app and
+     * this SDK (403 `voice_model_unavailable`), the start fails with
+     * {@link NO_VOICE_MESSAGE}.
+     */
+    private mintVoice;
+    /**
+     * The ElevenLabs call's module, with the voice turn runner, and the
+     * library it runs on, both loaded with `import()`.
+     */
+    private loadElevenLabsCall;
+    /**
+     * Start the ElevenLabs call the engine minted, once its module and library
+     * have loaded. Its time limit counts from `mintedAt`, when the mint
+     * answered. Its requests run as engine turns on the chat session the
+     * mint names, with the page prompt as their system message; the agent gets
+     * the page prompt unfenced (`voice-elevenlabs.ts`). Resolves `true` when
+     * the call started, or the start was hung up (that ending reported the
+     * call's end); `false` when it couldn't connect, and its end is still to
+     * be reported.
+     */
+    private startElevenLabs;
+    /**
+     * The ElevenLabs call couldn't connect, and nothing has reported its end.
+     * The engine is told (it releases the credit it holds for the call), then
+     * asked for the call once more, without ElevenLabs, and its note shown.
+     * Resolves that mint, or `null` once the start is hung up.
+     */
+    private fallBackToGeminiLive;
+    /**
+     * Keep an end report until the engine answers it: the next start waits for
+     * it. A report that fails counts as answered.
+     */
+    private keepEndReport;
+    /**
+     * The end report for a mint that was in flight as the call ended. Once the
+     * mint returns, the end of the ElevenLabs call it made is reported, with
+     * the ending's reason. Settles once the engine answers that report, or as
+     * soon as the mint fails or returns a Gemini Live call. Never rejects.
+     */
+    private reportEndAfterMint;
+    /**
+     * Tell the engine an ElevenLabs call has ended (`POST
+     * /v1/voice/calls/{id}/end`), so it settles the credit it holds for the
+     * call. Sent with `keepalive`, so it outlives the page. A failure is
+     * swallowed: the engine settles a call nobody reported from ElevenLabs'
+     * bill.
+     */
+    private reportEnd;
     /** Hang up. Safe to call in any state. */
     stop(): Promise<void>;
     /**