@xrkseek/harness 0.3.11 → 0.4.0-rc.2

package/node_modules/@xrkseek/exec-voice/dist/browser/env.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Runtime resolution of browser globals + shared error mapping.
+ *
+ * Everything is read structurally off `globalThis` so this module never
+ * references `lib.dom` and degrades to an honest `VOICE_UNAVAILABLE`.
+ */
+import { VoiceError } from "../types.js";
+import type { BrowserVoiceDeps, GetUserMedia, VoiceMediaRecorderCtor, VoiceMediaStream, VoicePeerConnectionCtor } from "./types.js";
+/** Stop every track on a stream; a dead track must not mask the real error. */
+export declare function releaseStream(stream: VoiceMediaStream): void;
+export declare function resolveGetUserMedia(deps: BrowserVoiceDeps): GetUserMedia;
+export declare function resolveRecorder(deps: BrowserVoiceDeps): VoiceMediaRecorderCtor;
+export declare function resolvePeerConnection(deps: BrowserVoiceDeps): VoicePeerConnectionCtor;
+/** `btoa`-based Base64 for a byte buffer (chunked to avoid call-stack limits). */
+export declare function encodeBase64(bytes: Uint8Array, btoaImpl?: (data: string) => string): string;
+/** Map a `getUserMedia` rejection to a coded `VoiceError` with an actionable hint. */
+export declare function micError(err: unknown): VoiceError;
+/** True when both capture paths have their required globals present. */
+export declare function micCapabilities(deps?: BrowserVoiceDeps): {
+    readonly dictation: boolean;
+    readonly session: boolean;
+};
+//# sourceMappingURL=env.d.ts.map

package/node_modules/@xrkseek/exec-voice/dist/browser/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/browser/env.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EACZ,sBAAsB,EACtB,gBAAgB,EAChB,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAEpB,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAQ5D;AAeD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,GAAG,YAAY,CAUxE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,GAAG,sBAAsB,CAS9E;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,gBAAgB,GAAG,uBAAuB,CASrF;AAED,kFAAkF;AAClF,wBAAgB,YAAY,CAC1B,KAAK,EAAE,UAAU,EACjB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAClC,MAAM,CAcR;AASD,sFAAsF;AACtF,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CA6BjD;AAED,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,IAAI,GAAE,gBAAqB,GAAG;IAC5D,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B,CAWA"}

package/node_modules/@xrkseek/exec-voice/dist/browser/env.js

@@ -0,0 +1,93 @@
+/**
+ * Runtime resolution of browser globals + shared error mapping.
+ *
+ * Everything is read structurally off `globalThis` so this module never
+ * references `lib.dom` and degrades to an honest `VOICE_UNAVAILABLE`.
+ */
+import { VoiceError } from "../types.js";
+/** Stop every track on a stream; a dead track must not mask the real error. */
+export function releaseStream(stream) {
+    for (const track of stream.getTracks()) {
+        try {
+            track.stop();
+        }
+        catch {
+            // Ignore: releasing the mic is best-effort cleanup.
+        }
+    }
+}
+function globals() {
+    return globalThis;
+}
+export function resolveGetUserMedia(deps) {
+    const fn = deps.getUserMedia ?? globals().navigator?.mediaDevices?.getUserMedia;
+    if (typeof fn !== "function") {
+        throw new VoiceError("navigator.mediaDevices.getUserMedia is unavailable — the browser mic transport " +
+            "needs a secure (https / localhost) browser context, or an injected getUserMedia", "VOICE_UNAVAILABLE");
+    }
+    return fn;
+}
+export function resolveRecorder(deps) {
+    const ctor = deps.MediaRecorder ?? globals().MediaRecorder;
+    if (typeof ctor !== "function") {
+        throw new VoiceError("MediaRecorder is unavailable — inject MediaRecorder or use a browser that supports it", "VOICE_UNAVAILABLE");
+    }
+    return ctor;
+}
+export function resolvePeerConnection(deps) {
+    const ctor = deps.PeerConnection ?? globals().RTCPeerConnection;
+    if (typeof ctor !== "function") {
+        throw new VoiceError("RTCPeerConnection is unavailable — inject PeerConnection or use a browser that supports WebRTC", "VOICE_UNAVAILABLE");
+    }
+    return ctor;
+}
+/** `btoa`-based Base64 for a byte buffer (chunked to avoid call-stack limits). */
+export function encodeBase64(bytes, btoaImpl) {
+    const fn = btoaImpl ?? globals().btoa;
+    if (typeof fn !== "function") {
+        throw new VoiceError("btoa is unavailable — inject deps.btoa or run in a browser context", "VOICE_UNAVAILABLE");
+    }
+    let binary = "";
+    const chunk = 0x8000;
+    for (let i = 0; i < bytes.length; i += chunk) {
+        binary += String.fromCharCode(...bytes.subarray(i, i + chunk));
+    }
+    return fn(binary);
+}
+function errorName(err) {
+    if (err && typeof err === "object" && "name" in err) {
+        return String(err.name ?? "");
+    }
+    return "";
+}
+/** Map a `getUserMedia` rejection to a coded `VoiceError` with an actionable hint. */
+export function micError(err) {
+    if (err instanceof VoiceError)
+        return err;
+    const name = errorName(err);
+    switch (name) {
+        case "NotAllowedError":
+        case "SecurityError":
+            return new VoiceError(`microphone permission was denied (${name}); grant mic access to continue`, "VOICE_BACKEND");
+        case "NotFoundError":
+        case "OverconstrainedError":
+            return new VoiceError(`no usable microphone was found (${name})`, "VOICE_BACKEND");
+        case "NotReadableError":
+            return new VoiceError(`microphone is already in use or unreadable (${name})`, "VOICE_BACKEND");
+        default: {
+            const detail = err instanceof Error ? err.message : String(err);
+            return new VoiceError(`getUserMedia failed${name ? ` (${name})` : ""}: ${detail}`, "VOICE_BACKEND");
+        }
+    }
+}
+/** True when both capture paths have their required globals present. */
+export function micCapabilities(deps = {}) {
+    const g = globals();
+    const hasMic = typeof deps.getUserMedia === "function" ||
+        typeof g.navigator?.mediaDevices?.getUserMedia === "function";
+    const hasRecorder = typeof deps.MediaRecorder === "function" || typeof g.MediaRecorder === "function";
+    const hasRtc = typeof deps.PeerConnection === "function" ||
+        typeof g.RTCPeerConnection === "function";
+    return { dictation: hasMic && hasRecorder, session: hasMic && hasRtc };
+}
+//# sourceMappingURL=env.js.map

package/node_modules/@xrkseek/exec-voice/dist/browser/env.js.map

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

package/node_modules/@xrkseek/exec-voice/dist/browser/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * `@xrkseek/exec-voice/browser` — client-side mic transport for the voice seam.
+ *
+ * Nothing here runs on the Host: the Node entry (`../index.js`) stays DOM-free.
+ * The browser opens the mic, captures dictation or negotiates a WebRTC session,
+ * and the Host only brokers sessions and runs STT/TTS — audio never transits it.
+ *
+ * Every dependency is injected through `BrowserVoiceDeps`, so the transport is
+ * unit-testable with fakes and never hard-references `lib.dom`.
+ */
+import { type DictationRecorder, type DictationResult, type StartDictationOptions } from "./dictation.js";
+import { type VoiceSessionHandle } from "./session.js";
+import type { BrowserVoiceDeps, VoiceSessionBroker } from "./types.js";
+export { dictateOnce, pickRecorderMime, startDictation, RECORDER_MIME_CANDIDATES, type DictateOnceOptions, type DictationRecorder, type DictationResult, type StartDictationOptions, } from "./dictation.js";
+export { encodeBase64, micCapabilities, releaseStream } from "./env.js";
+export { startVoiceSession, type StartVoiceSessionOptions, type VoiceSessionHandle, } from "./session.js";
+export type { BrowserVoiceDeps, GetUserMedia, MicConstraints, VoiceAudioTrack, VoiceBlob, VoiceMediaRecorder, VoiceMediaRecorderCtor, VoiceMediaStream, VoicePeerConnection, VoicePeerConnectionCtor, VoiceRecorderEvent, VoiceSessionBroker, VoiceSessionBrokerRequest, VoiceSessionBrokerResult, VoiceSessionDescription, } from "./types.js";
+export interface BrowserVoiceCapabilities {
+    readonly dictation: boolean;
+    readonly session: boolean;
+}
+export interface DictateOptions {
+    readonly mimeType?: string;
+    readonly timesliceMs?: number;
+    readonly maxDurationMs?: number;
+}
+export interface SessionOptions {
+    readonly broker: VoiceSessionBroker;
+    readonly instructions?: string;
+    readonly voice?: string;
+    readonly model?: string;
+    readonly onStateChange?: (state: string) => void;
+}
+/**
+ * The client-facing facade: capability probe plus the two capture paths.
+ * Construct once per browser session and share it with the UI.
+ */
+export interface BrowserVoiceTransport {
+    readonly deps: BrowserVoiceDeps;
+    capabilities(): BrowserVoiceCapabilities;
+    /** Push-to-talk take → bytes + Base64, ready for `voice_transcribe`. */
+    dictate(options?: DictateOptions): Promise<DictationResult & {
+        readonly base64: string;
+    }>;
+    /** Manual recording control (start now, stop when the user releases). */
+    openDictation(options?: StartDictationOptions): Promise<DictationRecorder>;
+    /** Realtime session: mic + WebRTC, brokered by the Host. */
+    session(options: SessionOptions): Promise<VoiceSessionHandle>;
+}
+export declare function createBrowserVoiceTransport(deps?: BrowserVoiceDeps): BrowserVoiceTransport;
+//# sourceMappingURL=index.d.ts.map

package/node_modules/@xrkseek/exec-voice/dist/browser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAIL,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC3B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEvE,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,wBAAwB,EACxB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,qBAAqB,GAC3B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,GACxB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,eAAe,EACf,SAAS,EACT,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,yBAAyB,EACzB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAClD;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,YAAY,IAAI,wBAAwB,CAAC;IACzC,wEAAwE;IACxE,OAAO,CACL,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,eAAe,GAAG;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1D,yEAAyE;IACzE,aAAa,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC3E,4DAA4D;IAC5D,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC/D;AAED,wBAAgB,2BAA2B,CACzC,IAAI,GAAE,gBAAqB,GAC1B,qBAAqB,CA0BvB"}

package/node_modules/@xrkseek/exec-voice/dist/browser/index.js

@@ -0,0 +1,44 @@
+/**
+ * `@xrkseek/exec-voice/browser` — client-side mic transport for the voice seam.
+ *
+ * Nothing here runs on the Host: the Node entry (`../index.js`) stays DOM-free.
+ * The browser opens the mic, captures dictation or negotiates a WebRTC session,
+ * and the Host only brokers sessions and runs STT/TTS — audio never transits it.
+ *
+ * Every dependency is injected through `BrowserVoiceDeps`, so the transport is
+ * unit-testable with fakes and never hard-references `lib.dom`.
+ */
+import { dictateOnce, startDictation, } from "./dictation.js";
+import { micCapabilities } from "./env.js";
+import { startVoiceSession, } from "./session.js";
+export { dictateOnce, pickRecorderMime, startDictation, RECORDER_MIME_CANDIDATES, } from "./dictation.js";
+export { encodeBase64, micCapabilities, releaseStream } from "./env.js";
+export { startVoiceSession, } from "./session.js";
+export function createBrowserVoiceTransport(deps = {}) {
+    return {
+        deps,
+        capabilities: () => micCapabilities(deps),
+        dictate: (options = {}) => {
+            const once = {
+                deps,
+                ...(options.mimeType !== undefined ? { mimeType: options.mimeType } : {}),
+                ...(options.timesliceMs !== undefined
+                    ? { timesliceMs: options.timesliceMs }
+                    : {}),
+                ...(options.maxDurationMs !== undefined
+                    ? { maxDurationMs: options.maxDurationMs }
+                    : {}),
+            };
+            return dictateOnce(once);
+        },
+        openDictation: (options = {}) => startDictation({ ...options, deps }),
+        session: (options) => {
+            const start = {
+                ...options,
+                deps,
+            };
+            return startVoiceSession(start);
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/node_modules/@xrkseek/exec-voice/dist/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EACL,WAAW,EACX,cAAc,GAKf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EACL,iBAAiB,GAGlB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,wBAAwB,GAKzB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACxE,OAAO,EACL,iBAAiB,GAGlB,MAAM,cAAc,CAAC;AAuDtB,MAAM,UAAU,2BAA2B,CACzC,OAAyB,EAAE;IAE3B,OAAO;QACL,IAAI;QACJ,YAAY,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC;QACzC,OAAO,EAAE,CAAC,OAAO,GAAG,EAAE,EAAE,EAAE;YACxB,MAAM,IAAI,GAAuB;gBAC/B,IAAI;gBACJ,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzE,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS;oBACnC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE;oBACtC,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS;oBACrC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE;oBAC1C,CAAC,CAAC,EAAE,CAAC;aACR,CAAC;YACF,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QACD,aAAa,EAAE,CAAC,OAAO,GAAG,EAAE,EAAE,EAAE,CAAC,cAAc,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,CAAC;QACrE,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE;YACnB,MAAM,KAAK,GAA6B;gBACtC,GAAG,OAAO;gBACV,IAAI;aACL,CAAC;YACF,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/node_modules/@xrkseek/exec-voice/dist/browser/session.d.ts

@@ -0,0 +1,26 @@
+import type { BrowserVoiceDeps, VoiceSessionBroker } from "./types.js";
+export interface VoiceSessionHandle {
+    readonly sessionId: string;
+    readonly provider?: string;
+    readonly note?: string;
+    /** Live `RTCPeerConnection.connectionState` (e.g. `connected`). */
+    connectionState(): string;
+    /** Release the mic and close the peer connection. */
+    stop(): void;
+}
+export interface StartVoiceSessionOptions {
+    readonly broker: VoiceSessionBroker;
+    readonly deps?: BrowserVoiceDeps;
+    readonly instructions?: string;
+    readonly voice?: string;
+    readonly model?: string;
+    readonly onStateChange?: (state: string) => void;
+}
+/**
+ * Open a realtime session. Rejects with a coded `VoiceError` when the mic is
+ * unavailable, the broker fails, or the broker answers with only an ephemeral
+ * provider secret (which this transport cannot complete without an SDP relay).
+ * On every failure path the mic is released and the peer connection closed.
+ */
+export declare function startVoiceSession(options: StartVoiceSessionOptions): Promise<VoiceSessionHandle>;
+//# sourceMappingURL=session.d.ts.map

package/node_modules/@xrkseek/exec-voice/dist/browser/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/browser/session.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACV,gBAAgB,EAGhB,kBAAkB,EAEnB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,eAAe,IAAI,MAAM,CAAC;IAC1B,qDAAqD;IACrD,IAAI,IAAI,IAAI,CAAC;CACd;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAClD;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CAqF7B"}

package/node_modules/@xrkseek/exec-voice/dist/browser/session.js

@@ -0,0 +1,96 @@
+/**
+ * Realtime voice session bootstrap, browser side.
+ *
+ * The browser opens the mic, builds a local SDP offer and hands it to a Host
+ * *broker* (the `voice_session` tool / Host route). The provider key stays on
+ * the Host; only the negotiated answer comes back. Media never transits the
+ * Host — audio flows peer-to-peer over WebRTC.
+ */
+import { VoiceError } from "../types.js";
+import { micError, releaseStream, resolveGetUserMedia, resolvePeerConnection, } from "./env.js";
+/**
+ * Open a realtime session. Rejects with a coded `VoiceError` when the mic is
+ * unavailable, the broker fails, or the broker answers with only an ephemeral
+ * provider secret (which this transport cannot complete without an SDP relay).
+ * On every failure path the mic is released and the peer connection closed.
+ */
+export async function startVoiceSession(options) {
+    const deps = options.deps ?? {};
+    const getUserMedia = resolveGetUserMedia(deps);
+    const PeerConnection = resolvePeerConnection(deps);
+    let stream;
+    try {
+        stream = await getUserMedia({ audio: true });
+    }
+    catch (err) {
+        throw micError(err);
+    }
+    let pc;
+    try {
+        const connection = new PeerConnection(deps.peerConnectionConfig);
+        pc = connection;
+        for (const track of stream.getTracks()) {
+            connection.addTrack(track, stream);
+        }
+        const notify = options.onStateChange;
+        if (notify) {
+            connection.onconnectionstatechange = () => notify(connection.connectionState ?? "unknown");
+        }
+        const offer = await connection.createOffer();
+        await connection.setLocalDescription(offer);
+        const sdpOffer = connection.localDescription?.sdp ?? offer.sdp ?? "";
+        if (!sdpOffer) {
+            throw new VoiceError("the browser produced an empty SDP offer", "VOICE_BACKEND");
+        }
+        const brokered = await options.broker({
+            sdpOffer,
+            ...(options.instructions !== undefined
+                ? { instructions: options.instructions }
+                : {}),
+            ...(options.voice !== undefined ? { voice: options.voice } : {}),
+            ...(options.model !== undefined ? { model: options.model } : {}),
+        });
+        if (brokered.sdpAnswer) {
+            const answer = {
+                type: "answer",
+                sdp: brokered.sdpAnswer,
+            };
+            await connection.setRemoteDescription(answer);
+        }
+        else if (brokered.clientSecret) {
+            throw new VoiceError("the provider answered with an ephemeral client secret, not an SDP answer; " +
+                "this transport needs a Host SDP relay — complete WebRTC directly against " +
+                "the provider endpoint if you cannot broker an answer", "VOICE_LIVE_UNSUPPORTED");
+        }
+        else {
+            throw new VoiceError("voice session broker returned neither an SDP answer nor a client secret", "VOICE_BACKEND");
+        }
+        return {
+            sessionId: brokered.sessionId,
+            ...(brokered.provider !== undefined ? { provider: brokered.provider } : {}),
+            ...(brokered.note !== undefined ? { note: brokered.note } : {}),
+            connectionState: () => connection.connectionState ?? "unknown",
+            stop() {
+                connection.onconnectionstatechange = null;
+                releaseStream(stream);
+                try {
+                    connection.close();
+                }
+                catch {
+                    // Closing an already-closed connection is not an error.
+                }
+            },
+        };
+    }
+    catch (err) {
+        try {
+            pc?.close();
+        }
+        catch {
+            // The original failure is what matters.
+        }
+        releaseStream(stream);
+        throw err;
+    }
+}
+//# sourceMappingURL=session.js.map

package/node_modules/@xrkseek/exec-voice/dist/browser/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/browser/session.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,QAAQ,EACR,aAAa,EACb,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,UAAU,CAAC;AA4BlB;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAiC;IAEjC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;IAChC,MAAM,YAAY,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,cAAc,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAEnD,IAAI,MAAwB,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,YAAY,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;IAED,IAAI,EAAmC,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACjE,EAAE,GAAG,UAAU,CAAC;QAChB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC;YACvC,UAAU,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACrC,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;QACrC,IAAI,MAAM,EAAE,CAAC;YACX,UAAU,CAAC,uBAAuB,GAAG,GAAG,EAAE,CACxC,MAAM,CAAC,UAAU,CAAC,eAAe,IAAI,SAAS,CAAC,CAAC;QACpD,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,WAAW,EAAE,CAAC;QAC7C,MAAM,UAAU,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,QAAQ,GAAG,UAAU,CAAC,gBAAgB,EAAE,GAAG,IAAI,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC;QACrE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,UAAU,CAAC,yCAAyC,EAAE,eAAe,CAAC,CAAC;QACnF,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC;YACpC,QAAQ;YACR,GAAG,CAAC,OAAO,CAAC,YAAY,KAAK,SAAS;gBACpC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE;gBACxC,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjE,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;YACvB,MAAM,MAAM,GAA4B;gBACtC,IAAI,EAAE,QAAQ;gBACd,GAAG,EAAE,QAAQ,CAAC,SAAS;aACxB,CAAC;YACF,MAAM,UAAU,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAChD,CAAC;aAAM,IAAI,QAAQ,CAAC,YAAY,EAAE,CAAC;YACjC,MAAM,IAAI,UAAU,CAClB,4EAA4E;gBAC1E,2EAA2E;gBAC3E,sDAAsD,EACxD,wBAAwB,CACzB,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,UAAU,CAClB,yEAAyE,EACzE,eAAe,CAChB,CAAC;QACJ,CAAC;QAED,OAAO;YACL,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,GAAG,CAAC,QAAQ,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3E,GAAG,CAAC,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/D,eAAe,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,eAAe,IAAI,SAAS;YAC9D,IAAI;gBACF,UAAU,CAAC,uBAAuB,GAAG,IAAI,CAAC;gBAC1C,aAAa,CAAC,MAAM,CAAC,CAAC;gBACtB,IAAI,CAAC;oBACH,UAAU,CAAC,KAAK,EAAE,CAAC;gBACrB,CAAC;gBAAC,MAAM,CAAC;oBACP,wDAAwD;gBAC1D,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC;YACH,EAAE,EAAE,KAAK,EAAE,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,wCAAwC;QAC1C,CAAC;QACD,aAAa,CAAC,MAAM,CAAC,CAAC;QACtB,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/node_modules/@xrkseek/exec-voice/dist/browser/types.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Structural views of the browser media APIs the transport touches.
+ *
+ * The Host package compiles with `lib: ["ES2022"]` (no DOM), and mic/speaker
+ * stay on the client — so instead of `lib.dom` we declare the narrow shapes we
+ * actually call. That keeps the Node entry free of DOM references and lets the
+ * transport be unit-tested with plain fakes.
+ */
+export interface VoiceAudioTrack {
+    stop(): void;
+}
+export interface VoiceMediaStream {
+    getTracks(): readonly VoiceAudioTrack[];
+}
+export interface MicConstraints {
+    readonly audio: true;
+}
+export type GetUserMedia = (constraints: MicConstraints) => Promise<VoiceMediaStream>;
+/** Minimal `Blob` view — only what a recorder chunk needs. */
+export interface VoiceBlob {
+    readonly size: number;
+    readonly type: string;
+    arrayBuffer(): Promise<ArrayBuffer>;
+}
+export interface VoiceRecorderEvent {
+    readonly data: VoiceBlob;
+}
+export interface VoiceMediaRecorder {
+    readonly mimeType: string;
+    readonly state: string;
+    ondataavailable: ((event: VoiceRecorderEvent) => void) | null;
+    onstop: ((event?: unknown) => void) | null;
+    onerror: ((event?: unknown) => void) | null;
+    start(timeslice?: number): void;
+    stop(): void;
+}
+export interface VoiceMediaRecorderCtor {
+    new (stream: VoiceMediaStream, options?: {
+        readonly mimeType?: string;
+    }): VoiceMediaRecorder;
+    /** Declared as a function-typed property (not a method) so it can be detached. */
+    readonly isTypeSupported?: (mimeType: string) => boolean;
+}
+export interface VoiceSessionDescription {
+    readonly type: string;
+    readonly sdp?: string;
+}
+export interface VoicePeerConnection {
+    readonly connectionState?: string;
+    readonly localDescription?: VoiceSessionDescription | null;
+    onconnectionstatechange: ((event?: unknown) => void) | null;
+    addTrack(track: unknown, stream?: VoiceMediaStream): unknown;
+    createOffer(): Promise<VoiceSessionDescription>;
+    setLocalDescription(description: VoiceSessionDescription): Promise<void>;
+    setRemoteDescription(description: VoiceSessionDescription): Promise<void>;
+    close(): void;
+}
+export interface VoicePeerConnectionCtor {
+    new (config?: unknown): VoicePeerConnection;
+}
+/** Injectable browser capabilities; unset values fall back to real globals. */
+export interface BrowserVoiceDeps {
+    readonly getUserMedia?: GetUserMedia;
+    readonly MediaRecorder?: VoiceMediaRecorderCtor;
+    readonly PeerConnection?: VoicePeerConnectionCtor;
+    /** Passed straight to the `RTCPeerConnection` constructor (e.g. ICE servers). */
+    readonly peerConnectionConfig?: unknown;
+    /** Injectable Base64 encoder (`btoa`); unset falls back to the global. */
+    readonly btoa?: (data: string) => string;
+}
+/**
+ * Host-side session broker: the client posts its local SDP offer and receives
+ * the negotiated answer. Wire this to the `voice_session` tool / Host route so
+ * the provider key never reaches the browser.
+ */
+export interface VoiceSessionBrokerRequest {
+    readonly sdpOffer: string;
+    readonly instructions?: string;
+    readonly voice?: string;
+    readonly model?: string;
+}
+export interface VoiceSessionBrokerResult {
+    readonly sessionId: string;
+    readonly provider?: string;
+    readonly sdpAnswer?: string;
+    /** Ephemeral provider secret when the provider has no SDP relay. */
+    readonly clientSecret?: string;
+    readonly note?: string;
+}
+export type VoiceSessionBroker = (request: VoiceSessionBrokerRequest) => Promise<VoiceSessionBrokerResult>;
+//# sourceMappingURL=types.d.ts.map

package/node_modules/@xrkseek/exec-voice/dist/browser/types.d.ts.map

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

package/node_modules/@xrkseek/exec-voice/dist/browser/types.js

@@ -0,0 +1,10 @@
+/**
+ * Structural views of the browser media APIs the transport touches.
+ *
+ * The Host package compiles with `lib: ["ES2022"]` (no DOM), and mic/speaker
+ * stay on the client — so instead of `lib.dom` we declare the narrow shapes we
+ * actually call. That keeps the Node entry free of DOM references and lets the
+ * transport be unit-tested with plain fakes.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/node_modules/@xrkseek/exec-voice/dist/browser/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/browser/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/node_modules/@xrkseek/exec-voice/dist/format.d.ts

@@ -0,0 +1,2 @@
+export declare const VOICE_PROMPT_TEXT: string;
+//# sourceMappingURL=format.d.ts.map

package/node_modules/@xrkseek/exec-voice/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,QAMlB,CAAC"}

package/node_modules/@xrkseek/exec-voice/dist/format.js

@@ -0,0 +1,8 @@
+export const VOICE_PROMPT_TEXT = [
+    "Voice (Host):",
+    "- `text_to_speech` speaks text via the Host TTS Provider (returns audio meta; does not play on the server).",
+    "- `voice_transcribe` runs one-shot STT on base64 audio (dictation / message audio).",
+    "- `voice_session` creates a realtime voice session broker (ephemeral client secret / stub SDP); mic/speaker stay on the client. Mode is Host-side, not a Face child turn.",
+    "- Without `XRK_VOICE=1` (OpenAI key) or `XRK_VOICE=memory`, tools stay visible and fail honestly.",
+].join("\n");
+//# sourceMappingURL=format.js.map

package/node_modules/@xrkseek/exec-voice/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,eAAe;IACf,6GAA6G;IAC7G,qFAAqF;IACrF,2KAA2K;IAC3K,mGAAmG;CACpG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC"}

package/node_modules/@xrkseek/exec-voice/dist/index.d.ts

@@ -0,0 +1,24 @@
+import type { VoiceService } from "./types.js";
+export { VoiceError, isVoiceError, type VoiceDelivery, type VoiceErrorCode, type VoiceLiveCreateRequest, type VoiceLiveCreateResult, type VoiceLiveStatus, type VoiceService, type VoiceSynthesizeRequest, type VoiceSynthesizeResult, type VoiceTranscribeRequest, type VoiceTranscribeResult, } from "./types.js";
+export { VOICE_PROMPT_TEXT } from "./format.js";
+export { createMemoryVoiceProvider, minimalWavBytes, type MemoryVoiceOptions, } from "./memory.js";
+export { createOpenAiVoiceProvider, type OpenAiVoiceOptions, } from "./openai-http.js";
+export { createVoiceTools, voiceUnavailableMessage, type CreateVoiceToolsOptions, } from "./tools.js";
+export interface DefaultVoiceAccessOptions {
+    readonly env?: NodeJS.ProcessEnv;
+    readonly service?: VoiceService;
+    readonly fetchImpl?: typeof fetch;
+}
+export interface DefaultVoiceAccess {
+    readonly service?: VoiceService;
+    readonly unavailableMessage: string;
+}
+/**
+ * Resolve a voice Provider.
+ * - Injected `service` wins.
+ * - `XRK_VOICE=memory` → in-memory Provider.
+ * - `XRK_VOICE=1` + API key → OpenAI-compatible TTS/STT/realtime.
+ * - Else no service; tools stay registered and fail honestly.
+ */
+export declare function createDefaultVoiceAccess(options?: DefaultVoiceAccessOptions): DefaultVoiceAccess;
+//# sourceMappingURL=index.d.ts.map

package/node_modules/@xrkseek/exec-voice/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,OAAO,EACL,UAAU,EACV,YAAY,EACZ,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,GAC3B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACL,yBAAyB,EACzB,eAAe,EACf,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,yBAAyB,EACzB,KAAK,kBAAkB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,KAAK,uBAAuB,GAC7B,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC;AASD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,yBAA8B,GACtC,kBAAkB,CA6BpB"}

package/node_modules/@xrkseek/exec-voice/dist/index.js

@@ -0,0 +1,53 @@
+import { createMemoryVoiceProvider } from "./memory.js";
+import { createOpenAiVoiceProvider } from "./openai-http.js";
+import { voiceUnavailableMessage } from "./tools.js";
+export { VoiceError, isVoiceError, } from "./types.js";
+export { VOICE_PROMPT_TEXT } from "./format.js";
+export { createMemoryVoiceProvider, minimalWavBytes, } from "./memory.js";
+export { createOpenAiVoiceProvider, } from "./openai-http.js";
+export { createVoiceTools, voiceUnavailableMessage, } from "./tools.js";
+function resolveApiKey(env) {
+    const a = String(env.XRK_VOICE_OPENAI_KEY ?? "").trim();
+    if (a)
+        return a;
+    const b = String(env.OPENAI_API_KEY ?? "").trim();
+    return b || undefined;
+}
+/**
+ * Resolve a voice Provider.
+ * - Injected `service` wins.
+ * - `XRK_VOICE=memory` → in-memory Provider.
+ * - `XRK_VOICE=1` + API key → OpenAI-compatible TTS/STT/realtime.
+ * - Else no service; tools stay registered and fail honestly.
+ */
+export function createDefaultVoiceAccess(options = {}) {
+    const env = options.env ?? process.env;
+    const unavailableMessage = voiceUnavailableMessage(env);
+    if (options.service) {
+        return { service: options.service, unavailableMessage };
+    }
+    const flag = String(env.XRK_VOICE ?? "").trim().toLowerCase();
+    if (flag === "memory") {
+        return {
+            service: createMemoryVoiceProvider(),
+            unavailableMessage,
+        };
+    }
+    if (flag === "1") {
+        const apiKey = resolveApiKey(env);
+        if (!apiKey) {
+            return { unavailableMessage };
+        }
+        const baseUrl = String(env.XRK_VOICE_BASE_URL ?? "").trim();
+        return {
+            service: createOpenAiVoiceProvider({
+                apiKey,
+                ...(baseUrl ? { baseUrl } : {}),
+                ...(options.fetchImpl ? { fetchImpl: options.fetchImpl } : {}),
+            }),
+            unavailableMessage,
+        };
+    }
+    return { unavailableMessage };
+}
+//# sourceMappingURL=index.js.map

package/node_modules/@xrkseek/exec-voice/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAE7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAErD,OAAO,EACL,UAAU,EACV,YAAY,GAWb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACL,yBAAyB,EACzB,eAAe,GAEhB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,yBAAyB,GAE1B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,gBAAgB,EAChB,uBAAuB,GAExB,MAAM,YAAY,CAAC;AAapB,SAAS,aAAa,CAAC,GAAsB;IAC3C,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACxD,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAChB,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAClD,OAAO,CAAC,IAAI,SAAS,CAAC;AACxB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACtC,UAAqC,EAAE;IAEvC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,kBAAkB,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC;IACxD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC1D,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9D,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,OAAO;YACL,OAAO,EAAE,yBAAyB,EAAE;YACpC,kBAAkB;SACnB,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,kBAAkB,EAAE,CAAC;QAChC,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5D,OAAO;YACL,OAAO,EAAE,yBAAyB,CAAC;gBACjC,MAAM;gBACN,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/B,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/D,CAAC;YACF,kBAAkB;SACnB,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAChC,CAAC"}

package/node_modules/@xrkseek/exec-voice/dist/memory.d.ts

@@ -0,0 +1,11 @@
+import type { VoiceService } from "./types.js";
+/** Minimal silent WAV (44-byte header + 0 samples). */
+export declare function minimalWavBytes(): Uint8Array;
+export interface MemoryVoiceOptions {
+    readonly transcript?: string;
+}
+/**
+ * Deterministic in-memory Provider for CI / demos (`XRK_VOICE=memory`).
+ */
+export declare function createMemoryVoiceProvider(options?: MemoryVoiceOptions): VoiceService;
+//# sourceMappingURL=memory.d.ts.map

package/node_modules/@xrkseek/exec-voice/dist/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,YAAY,EAKb,MAAM,YAAY,CAAC;AAGpB,uDAAuD;AACvD,wBAAgB,eAAe,IAAI,UAAU,CAkB5C;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,kBAAuB,GAC/B,YAAY,CA+Dd"}