@burdenoff/fe-libs 2026.1005.1 → 2026.1005.3

package/dist/shared/assistant/voice/handsfree/echoGate.js

@@ -0,0 +1,198 @@
+//#region src/shared/assistant/voice/handsfree/echoGate.ts
+var e = Object.freeze({
+	windowFrames: 12,
+	lowCorr: .3,
+	lowRunFrames: 3,
+	headsetLowRunFrames: 2,
+	calibFrames: 50,
+	maxLagFrames: 25,
+	minCalibCorr: .5,
+	tailFrames: 30,
+	floorDb: -60,
+	referenceSilentDb: -58,
+	quietMicDb: -55,
+	flatStdDb: 1,
+	tailDecayDbPerFrame: 3
+}), t = 2400, n = 150, r = 1200, i = (e, t) => {
+	let n = [...e].sort((e, t) => e - t);
+	return n[Math.min(n.length - 1, Math.floor(t * n.length))] ?? 0;
+};
+function a(e, t, n) {
+	let r = e.length, i = 0, a = 0;
+	for (let n = 0; n < r; n += 1) i += e[n] ?? 0, a += t[n] ?? 0;
+	i /= r, a /= r;
+	let o = 0, s = 0, c = 0;
+	for (let n = 0; n < r; n += 1) {
+		let r = (e[n] ?? 0) - i, l = (t[n] ?? 0) - a;
+		o += r * l, s += r * r, c += l * l;
+	}
+	let l = Math.sqrt(c / r) < n;
+	return s === 0 || c === 0 ? {
+		corr: 0,
+		refFlat: l
+	} : {
+		corr: o / Math.sqrt(s * c),
+		refFlat: l
+	};
+}
+var o = class {
+	params;
+	mic = [];
+	ref = [];
+	tail = [];
+	base = 0;
+	total = 0;
+	playing = !1;
+	hasReference = !0;
+	playStart = 0;
+	armedUntil = -1;
+	current = null;
+	prior = null;
+	noEchoPath = !1;
+	lowRun = 0;
+	headset = !1;
+	constructor(t = {}) {
+		this.params = {
+			...e,
+			...t
+		};
+	}
+	get isPlaying() {
+		return this.playing;
+	}
+	get hasPrior() {
+		return this.prior !== null;
+	}
+	get calibration() {
+		let e = this.current ?? this.prior;
+		return e ? {
+			lagMs: e.lag * 20,
+			corr: e.corr
+		} : null;
+	}
+	setHeadset(e) {
+		this.headset = e;
+	}
+	playbackStarted(e) {
+		this.playing = !0, this.hasReference = e, this.playStart = this.total, this.current = null, this.noEchoPath = !1, this.lowRun = 0;
+	}
+	playbackStopped() {
+		this.playing && (this.playing = !1, this.armedUntil = this.total + this.params.tailFrames);
+	}
+	pushFrame(e, t) {
+		let n = this.total;
+		this.total += 1;
+		let r = this.params.floorDb;
+		this.mic.push(Math.min(0, Math.max(r, e)));
+		let i = Math.min(0, Math.max(r, t));
+		this.ref.push(i);
+		let a = this.tail[this.tail.length - 1] ?? r;
+		if (this.tail.push(Math.max(i, a - this.params.tailDecayDbPerFrame)), this.trim(), !(this.playing || n < this.armedUntil)) return this.lowRun = 0, {
+			pass: !0,
+			reason: "no-playback",
+			coherence: null
+		};
+		if (!this.hasReference) return this.lowRun = 0, {
+			pass: !1,
+			reason: "no-reference",
+			coherence: null
+		};
+		let o = n - this.playStart;
+		if (this.playing && this.current === null && !this.noEchoPath && o >= this.params.calibFrames && n % 10 == 0 && this.calibrate(n), this.noEchoPath) return this.lowRun = 0, {
+			pass: !0,
+			reason: "no-echo-path",
+			coherence: null
+		};
+		let s = this.current ?? this.prior;
+		if (!s) {
+			let e = this.windowMax(this.ref, n, 0) > this.params.referenceSilentDb;
+			return this.lowRun = 0, {
+				pass: !e,
+				reason: e ? "calibrating" : "reference-silent",
+				coherence: null
+			};
+		}
+		let c = this.params.windowFrames;
+		if (this.windowMax(this.ref, n - s.lag, c + 6) <= this.params.referenceSilentDb) return this.lowRun = 0, {
+			pass: !0,
+			reason: "reference-silent",
+			coherence: null
+		};
+		let { corr: l, refFlat: u } = this.coherence(n, s.lag);
+		if (l === null) return this.lowRun = 0, {
+			pass: !1,
+			reason: "calibrating",
+			coherence: null
+		};
+		if (u) return {
+			pass: !1,
+			reason: "flat-reference",
+			coherence: l
+		};
+		this.lowRun = l < this.params.lowCorr ? this.lowRun + 1 : 0;
+		let d = this.headset ? this.params.headsetLowRunFrames : this.params.lowRunFrames, f = this.lowRun >= d;
+		return {
+			pass: f,
+			reason: f ? "uncorrelated" : "follows-reference",
+			coherence: l
+		};
+	}
+	at(e, t) {
+		return e[t - this.base];
+	}
+	windowMax(e, t, n) {
+		let r = this.params.floorDb;
+		for (let i = t - n; i <= t; i += 1) {
+			let t = this.at(e, i);
+			t !== void 0 && t > r && (r = t);
+		}
+		return r;
+	}
+	coherence(e, t) {
+		let n = this.params.windowFrames, r = [], i = [];
+		for (let a = e - n + 1; a <= e; a += 1) {
+			let e = this.at(this.mic, a), n = this.at(this.tail, a - t);
+			if (e === void 0 || n === void 0) return {
+				corr: null,
+				refFlat: !1
+			};
+			r.push(e), i.push(n);
+		}
+		return a(r, i, this.params.flatStdDb);
+	}
+	calibrate(e) {
+		let t = Math.max(this.playStart, e - n + 1), r = [], o = 0;
+		for (let n = t; n <= e; n += 1) {
+			let e = this.at(this.mic, n), t = this.at(this.ref, n);
+			e !== void 0 && r.push(e), t !== void 0 && t > this.params.referenceSilentDb && (o += 1);
+		}
+		if (o < this.params.calibFrames * .6) return;
+		let s = null;
+		for (let n = 0; n <= this.params.maxLagFrames; n += 1) {
+			let r = [], i = [];
+			for (let a = t; a <= e; a += 1) {
+				let e = this.at(this.mic, a), t = this.at(this.tail, a - n);
+				e !== void 0 && t !== void 0 && (r.push(e), i.push(t));
+			}
+			if (r.length < 30) continue;
+			let { corr: o, refFlat: c } = a(r, i, this.params.flatStdDb);
+			c || (!s || o > s.corr) && (s = {
+				lag: n,
+				corr: o
+			});
+		}
+		if (s && s.corr >= this.params.minCalibCorr) {
+			this.current = s, this.prior = s;
+			return;
+		}
+		i(r, .9) <= this.params.quietMicDb && (this.noEchoPath = !0);
+	}
+	trim() {
+		this.mic.length <= t || (this.mic = this.mic.slice(r), this.ref = this.ref.slice(r), this.tail = this.tail.slice(r), this.base += r);
+	}
+	reset() {
+		this.mic = [], this.ref = [], this.tail = [], this.base = 0, this.total = 0, this.playing = !1, this.armedUntil = -1, this.current = null, this.prior = null, this.noEchoPath = !1, this.lowRun = 0;
+	}
+};
+//#endregion
+export { e as DEFAULT_ECHO_GATE_PARAMS, o as EchoGate };

package/dist/shared/assistant/voice/handsfree/handsFreeController.d.ts

@@ -0,0 +1,77 @@
+import { CaptureFrameMessage } from './captureWorklet';
+import { EpochGuard } from './bargeIn';
+import { MicCaptureHandle } from './micCapture';
+import { PlaybackSource } from './playbackReference';
+import { SttTransport } from './sttTransport';
+import { VoiceSessionPhase } from '../voiceSession';
+export type FallbackReason = "mic-denied" | "mic-unavailable" | "transport-unavailable" | "transport-auth" | "transport-quota" | "transport-upstream" | "phantom-barge-ins";
+export interface ControllerSession {
+    phase: VoiceSessionPhase;
+    muted: boolean;
+}
+export interface ControllerDeps {
+    /** Open the microphone; frames are delivered to the callback. */
+    startCapture: (onFrame: (frame: CaptureFrameMessage) => void) => Promise<MicCaptureHandle | FakeCapture>;
+    transport: SttTransport;
+    getSession: () => ControllerSession;
+    /** What is making sound right now. */
+    getPlaybackSource: () => PlaybackSource;
+    /** Is the output route a headset (a hint)? */
+    getHeadsetHint?: () => boolean;
+    language: () => string;
+    /** The user's voice started while the assistant was audible: STOP PLAYBACK and abandon the turn. */
+    onBargeIn: () => void;
+    /** Words from the user, already epoch-checked. */
+    onTranscript: (text: string, final: boolean, language: string | undefined) => void;
+    /** Hands-free gave up: the session falls back to the tap-first Web Speech path. */
+    onFallback: (reason: FallbackReason) => void;
+    /** A barge-in that produced no words within `NOTHING_HEARD_MS`. */
+    onNothingHeard?: () => void;
+    isEnabled: () => boolean;
+    prerollMs?: number;
+    setTimer?: (fn: () => void, ms: number) => ReturnType<typeof setTimeout>;
+    clearTimer?: (handle: ReturnType<typeof setTimeout>) => void;
+    onTelemetry?: (event: ControllerTelemetry) => void;
+}
+/** The slice of a capture handle the controller needs (so tests can fake it). */
+export interface FakeCapture {
+    context?: AudioContext;
+    micSource?: MediaStreamAudioSourceNode;
+    track?: MediaStreamTrack;
+    stop(): void;
+}
+export type ControllerTelemetry = {
+    type: "onset";
+    plan: string;
+    atFrame: number;
+    playbackSource: PlaybackSource;
+    gate: string;
+    calibration: {
+        lagMs: number;
+        corr: number;
+    } | null;
+} | {
+    type: "stopped-playback";
+    frame: number;
+} | {
+    type: "stale-transcript-dropped";
+    epoch: number;
+    current: number;
+} | {
+    type: "fallback";
+    reason: FallbackReason;
+} | {
+    type: "nothing-heard";
+};
+export interface HandsFreeController {
+    start(): Promise<void>;
+    stop(): void;
+    /** Frames consumed so far (for tests and telemetry). */
+    readonly frames: number;
+    /** Test seam: feed a frame as the worklet would. */
+    feed(frame: CaptureFrameMessage): void;
+    readonly epoch: EpochGuard;
+    readonly running: boolean;
+}
+export declare function createHandsFreeController(deps: ControllerDeps): HandsFreeController;
+//# sourceMappingURL=handsFreeController.d.ts.map

package/dist/shared/assistant/voice/handsfree/handsFreeController.d.ts.map

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

package/dist/shared/assistant/voice/handsfree/handsFreeController.js

@@ -0,0 +1,126 @@
+import { NOTHING_HEARD_MS as e, createEpochGuard as t, planOnset as n, shouldFallBackToTap as r } from "./bargeIn.js";
+import "./captureWorklet.js";
+import { EchoGate as i } from "./echoGate.js";
+import { MicCaptureError as a } from "./micCapture.js";
+import { PreRollRing as o } from "./preRollRing.js";
+import { DEFAULT_VAD_PARAMS as s, createVad as c } from "./vad.js";
+//#region src/shared/assistant/voice/handsfree/handsFreeController.ts
+var l = {
+	unavailable: "transport-unavailable",
+	auth: "transport-auth",
+	quota: "transport-quota",
+	upstream: "transport-upstream",
+	closed: "transport-upstream",
+	"not-allowed": "mic-denied"
+};
+function u(u) {
+	let d = u.setTimer ?? ((e, t) => setTimeout(e, t)), f = u.clearTimer ?? ((e) => clearTimeout(e)), p = new i(), m = c(), h = new o(u.prerollMs ?? 700, 20), g = t(), _ = null, v = !1, y = 0, b = null, x = null, S = 0, C = null, w = 0, T = null, E = !1, D = (e) => u.onTelemetry?.(e), O = (e) => {
+		E || (E = !0, D({
+			type: "fallback",
+			reason: e
+		}), P(), u.onFallback(e));
+	}, k = () => {
+		T !== null && f(T), T = null;
+	}, A = (e) => {
+		if (e === C) return;
+		let t = C;
+		C = e, e === null ? p.playbackStopped() : (t === null || t !== e) && p.playbackStarted(e === "hosted"), m.setOnsetFrames(e === "device" ? 6 : s.onsetFrames);
+	}, j = () => {
+		b &&= (u.transport.closeUtterance(b.id), null);
+	}, M = (t) => {
+		let i = u.getSession(), a = n({
+			enabled: u.isEnabled(),
+			muted: i.muted,
+			phase: i.phase,
+			playbackAudible: C !== null
+		});
+		if (D({
+			type: "onset",
+			plan: a.kind,
+			atFrame: y,
+			playbackSource: C,
+			gate: t,
+			calibration: p.calibration
+		}), a.kind === "ignore") return;
+		a.kind === "barge-in" && (u.onBargeIn(), D({
+			type: "stopped-playback",
+			frame: y
+		}), p.playbackStopped(), C = null, k(), u.transport.recognitionOwner === "transport" && (T = d(() => {
+			T = null, w += 1, D({ type: "nothing-heard" }), u.onNothingHeard?.(), r(w) && O("phantom-barge-ins");
+		}, e))), x && u.transport.cancelUtterance(x);
+		let o = g.open();
+		S += 1, b = {
+			id: `u${S}`,
+			epoch: o
+		}, x = b.id, u.transport.openUtterance({
+			utteranceId: b.id,
+			epoch: o,
+			preRoll: h.snapshot()
+		});
+	}, N = (e) => {
+		if (!v) return;
+		y += 1, A(u.getPlaybackSource()), u.getHeadsetHint && p.setHeadset(u.getHeadsetHint());
+		let t = p.pushFrame(e.rmsDb, e.refDb), n = new Int16Array(e.pcm);
+		h.push(n);
+		let r = m.push({
+			rmsDb: e.rmsDb,
+			zcr: e.zcr
+		}, t.pass);
+		r.event === "onset" ? M(t.reason) : b && r.inSegment && u.transport.pushFrame(n), r.event === "end" && j();
+	}, P = () => {
+		if (!v && !_) return;
+		v = !1, k(), b && u.transport.cancelUtterance(b.id), b = null, g.invalidate(), u.transport.stop(), h.clear(), p.reset(), m.reset();
+		let e = _;
+		_ = null, e?.stop();
+	};
+	return {
+		async start() {
+			if (v || E) return;
+			let e = u.getSession();
+			if (!u.isEnabled() || e.muted || e.phase === "ended" || e.phase === "idle") return;
+			v = !0;
+			try {
+				_ = await u.startCapture(N);
+			} catch (e) {
+				v = !1, O(e instanceof a && e.reason === "not-allowed" ? "mic-denied" : "mic-unavailable");
+				return;
+			}
+			if (!v) {
+				_.stop(), _ = null;
+				return;
+			}
+			let t = _ && "context" in _ && _.context && _.micSource && _.track ? {
+				context: _.context,
+				micSource: _.micSource,
+				track: _.track
+			} : null;
+			await u.transport.start(t, u.language(), {
+				onTranscript(e) {
+					if (!g.accepts(e.epoch)) {
+						D({
+							type: "stale-transcript-dropped",
+							epoch: e.epoch,
+							current: g.current()
+						});
+						return;
+					}
+					k(), u.onTranscript(e.text, e.final, e.language);
+				},
+				onError(e) {
+					O(l[e.code]);
+				}
+			});
+		},
+		stop: P,
+		get frames() {
+			return y;
+		},
+		feed: N,
+		epoch: g,
+		get running() {
+			return v;
+		}
+	};
+}
+//#endregion
+export { u as createHandsFreeController };

package/dist/shared/assistant/voice/handsfree/handsFreeRuntime.d.ts

@@ -0,0 +1,15 @@
+import { SttTransport, SttTransportKind, TransportChoice, TransportEnvironment } from './sttTransport';
+/** Feature flag + endpoint for the backend stream. Unset by default: never selected. */
+export interface StreamingConfig {
+    enabled: boolean;
+    ticketUrl: string;
+    getAuthorization: () => string | null;
+}
+/** Configure (or, with `null`, clear) the backend-stream route. Nothing calls this today. */
+export declare function configureHandsFreeStreaming(config: StreamingConfig | null): void;
+export declare function readTransportEnvironment(): TransportEnvironment;
+/** Phones: the OS recogniser and a getUserMedia stream contend for the one microphone. */
+export declare function isMobileUserAgent(userAgent: string): boolean;
+export declare function chooseTransport(env?: TransportEnvironment): TransportChoice;
+export declare function createRuntimeTransport(kind: SttTransportKind): SttTransport;
+//# sourceMappingURL=handsFreeRuntime.d.ts.map

package/dist/shared/assistant/voice/handsfree/handsFreeRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handsFreeRuntime.d.ts","sourceRoot":"","sources":["../../../../../src/shared/assistant/voice/handsfree/handsFreeRuntime.ts"],"names":[],"mappings":"AAiBA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EAC1B,MAAM,gBAAgB,CAAC;AAOxB,wFAAwF;AACxF,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CACvC;AAID,6FAA6F;AAC7F,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,eAAe,GAAG,IAAI,GAC7B,IAAI,CAEN;AAaD,wBAAgB,wBAAwB,IAAI,oBAAoB,CAS/D;AAED,0FAA0F;AAC1F,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,wBAAgB,eAAe,CAC7B,GAAG,GAAE,oBAAiD,GACrD,eAAe,CAIjB;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,gBAAgB,GAAG,YAAY,CA0D3E"}

package/dist/shared/assistant/voice/handsfree/handsFreeRuntime.js

@@ -0,0 +1,78 @@
+import { readTransportOverride as e } from "./handsFreeSetting.js";
+import { createAudioTrackTransport as t } from "./audioTrackTransport.js";
+import { createBackendStreamTransport as n } from "./backendStreamTransport.js";
+import { isMicCaptureSupported as r } from "./micCapture.js";
+import { selectSttTransport as i } from "./sttTransport.js";
+import { createWebSpeechTransport as a } from "./webSpeechTransport.js";
+//#region src/shared/assistant/voice/handsfree/handsFreeRuntime.ts
+var o = null;
+function s(e) {
+	o = e;
+}
+function c() {
+	if (typeof window > "u") return null;
+	let e = window.SpeechRecognition ?? window.webkitSpeechRecognition;
+	return typeof e == "function" ? e : null;
+}
+function l() {
+	return {
+		userAgent: typeof navigator > "u" ? "" : navigator.userAgent,
+		hasSpeechRecognition: c() !== null,
+		hasAudioWorklet: r(),
+		backendStreamEnabled: o?.enabled === !0,
+		backendStreamConfigured: o !== null && o.ticketUrl !== ""
+	};
+}
+function u(e) {
+	return /Android|iPhone|iPad|iPod|Mobile/.test(e);
+}
+function d(t = l()) {
+	let n = e();
+	return n ? {
+		kind: n,
+		because: "test-override"
+	} : i(t);
+}
+function f(e) {
+	if (e === "audio-track") return t({ createRecognition: () => {
+		let e = c();
+		return e ? new e() : null;
+	} });
+	if (e === "backend-stream") {
+		let e = o;
+		return n({
+			fetchTicket: async () => {
+				if (!e) throw Error("streaming not configured");
+				let t = e.getAuthorization(), n = await fetch(e.ticketUrl, {
+					method: "POST",
+					headers: t ? { authorization: t } : {},
+					credentials: "include"
+				});
+				if (!n.ok) throw Error(`ticket ${n.status}`);
+				let r = await n.json(), i = typeof r == "object" && r ? r : {};
+				if (typeof i.ticket != "string" || typeof i.wsUrl != "string") throw Error("bad ticket response");
+				return {
+					ticket: i.ticket,
+					wsUrl: i.wsUrl
+				};
+			},
+			createSocket: (e, t) => {
+				let n = new WebSocket(e, t);
+				return n.binaryType = "arraybuffer", {
+					get readyState() {
+						return n.readyState;
+					},
+					send: (e) => n.send(e),
+					close: (e) => n.close(e),
+					listen(e) {
+						n.onopen = () => e.open(), n.onerror = () => e.error(), n.onclose = (t) => e.close(t.code), n.onmessage = (t) => e.message(t.data);
+					}
+				};
+			},
+			languages: (e) => e.toLowerCase().startsWith("en") ? [e] : [e, "en-IN"]
+		});
+	}
+	return a();
+}
+//#endregion
+export { d as chooseTransport, s as configureHandsFreeStreaming, f as createRuntimeTransport, u as isMobileUserAgent, l as readTransportEnvironment };

package/dist/shared/assistant/voice/handsfree/handsFreeSetting.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The "Hands-free interrupt (beta)" setting (BOFF-8613, H3).
+ *
+ * Default OFF. The viewer's choice is persisted in the assistant store
+ * (`handsFreeInterrupt`) next to the grace preference; this file is the pure
+ * part - how a stored value and the test-only override resolve to a decision.
+ *
+ * ★ OFF means OFF. With the setting off nothing in this directory runs: no
+ * `getUserMedia`, no worklet, no transport, no listener, and the Web Speech
+ * path behaves exactly as it did before this change. That is what makes the
+ * feature reversible by a toggle.
+ *
+ * The TEST-ONLY override is a global the headless-browser tests set before the
+ * page loads (`globalThis.__boffHandsFreeInterrupt = "on"`), so a test does not
+ * have to click through settings. It can only affect the client that set it.
+ */
+export type HandsFreeOverride = "on" | "off";
+export declare const HANDS_FREE_OVERRIDE_KEY = "__boffHandsFreeInterrupt";
+export declare const HANDS_FREE_TRANSPORT_OVERRIDE_KEY = "__boffHandsFreeTransport";
+/** The stored value is trusted only if it is exactly `true`; anything else is OFF. */
+export declare function resolveStoredHandsFree(value: unknown): boolean;
+export declare function resolveHandsFreeEnabled(stored: unknown, override: unknown): boolean;
+export declare function readHandsFreeOverride(): HandsFreeOverride | undefined;
+export type TransportOverride = "web-speech" | "audio-track" | "backend-stream";
+export declare function readTransportOverride(): TransportOverride | undefined;
+//# sourceMappingURL=handsFreeSetting.d.ts.map

package/dist/shared/assistant/voice/handsfree/handsFreeSetting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handsFreeSetting.d.ts","sourceRoot":"","sources":["../../../../../src/shared/assistant/voice/handsfree/handsFreeSetting.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,KAAK,CAAC;AAE7C,eAAO,MAAM,uBAAuB,6BAA6B,CAAC;AAClE,eAAO,MAAM,iCAAiC,6BAA6B,CAAC;AAE5E,sFAAsF;AACtF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE9D;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,OAAO,GAChB,OAAO,CAIT;AAWD,wBAAgB,qBAAqB,IAAI,iBAAiB,GAAG,SAAS,CAGrE;AAED,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,aAAa,GAAG,gBAAgB,CAAC;AAEhF,wBAAgB,qBAAqB,IAAI,iBAAiB,GAAG,SAAS,CAOrE"}

package/dist/shared/assistant/voice/handsfree/handsFreeSetting.js

@@ -0,0 +1,25 @@
+//#region src/shared/assistant/voice/handsfree/handsFreeSetting.ts
+var e = "__boffHandsFreeInterrupt", t = "__boffHandsFreeTransport";
+function n(e) {
+	return e === !0;
+}
+function r(e, t) {
+	return t === "on" ? !0 : t === "off" ? !1 : n(e);
+}
+function i(e) {
+	try {
+		return globalThis[e];
+	} catch {
+		return;
+	}
+}
+function a() {
+	let t = i(e);
+	return t === "on" || t === "off" ? t : void 0;
+}
+function o() {
+	let e = i(t);
+	return e === "web-speech" || e === "audio-track" || e === "backend-stream" ? e : void 0;
+}
+//#endregion
+export { e as HANDS_FREE_OVERRIDE_KEY, t as HANDS_FREE_TRANSPORT_OVERRIDE_KEY, a as readHandsFreeOverride, o as readTransportOverride, r as resolveHandsFreeEnabled, n as resolveStoredHandsFree };

package/dist/shared/assistant/voice/handsfree/micCapture.d.ts

@@ -0,0 +1,21 @@
+import { CaptureFrameMessage } from './captureWorklet';
+export interface MicCaptureHandle {
+    context: AudioContext;
+    micSource: MediaStreamAudioSourceNode;
+    track: MediaStreamTrack;
+    /** What the browser reports it applied. */
+    settings: MediaTrackSettings;
+    /** Stop everything and release the microphone. */
+    stop(): void;
+}
+export type MicCaptureFailure = "unsupported" | "not-allowed" | "unavailable";
+export declare class MicCaptureError extends Error {
+    readonly reason: MicCaptureFailure;
+    constructor(reason: MicCaptureFailure);
+}
+export declare const CAPTURE_CONSTRAINTS: MediaStreamConstraints;
+export declare function isMicCaptureSupported(): boolean;
+/** Labels of output devices that suggest headphones. A HINT only. */
+export declare function looksLikeHeadset(outputLabels: readonly string[]): boolean;
+export declare function startMicCapture(onFrame: (frame: CaptureFrameMessage) => void): Promise<MicCaptureHandle>;
+//# sourceMappingURL=micCapture.d.ts.map

package/dist/shared/assistant/voice/handsfree/micCapture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"micCapture.d.ts","sourceRoot":"","sources":["../../../../../src/shared/assistant/voice/handsfree/micCapture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,kBAAkB,CAAC;AAM1B,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,0BAA0B,CAAC;IACtC,KAAK,EAAE,gBAAgB,CAAC;IACxB,2CAA2C;IAC3C,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,kDAAkD;IAClD,IAAI,IAAI,IAAI,CAAC;CACd;AAED,MAAM,MAAM,iBAAiB,GAAG,aAAa,GAAG,aAAa,GAAG,aAAa,CAAC;AAE9E,qBAAa,eAAgB,SAAQ,KAAK;IAC5B,QAAQ,CAAC,MAAM,EAAE,iBAAiB;gBAAzB,MAAM,EAAE,iBAAiB;CAI/C;AAED,eAAO,MAAM,mBAAmB,EAAE,sBAOjC,CAAC;AAEF,wBAAgB,qBAAqB,IAAI,OAAO,CAO/C;AAED,qEAAqE;AACrE,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAIzE;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,GAC5C,OAAO,CAAC,gBAAgB,CAAC,CA8E3B"}

package/dist/shared/assistant/voice/handsfree/micCapture.js

@@ -0,0 +1,73 @@
+import { attachPlaybackReference as e, detachPlaybackReference as t } from "./playbackReference.js";
+import { CAPTURE_PROCESSOR_NAME as n, CAPTURE_WORKLET_SOURCE as r } from "./captureWorklet.js";
+//#region src/shared/assistant/voice/handsfree/micCapture.ts
+var i = class extends Error {
+	reason;
+	constructor(e) {
+		super(`mic capture failed: ${e}`), this.reason = e, this.name = "MicCaptureError";
+	}
+}, a = { audio: {
+	echoCancellation: !0,
+	noiseSuppression: !0,
+	autoGainControl: !0,
+	channelCount: 1
+} };
+function o() {
+	return typeof navigator < "u" && typeof navigator.mediaDevices?.getUserMedia == "function" && typeof AudioContext < "u" && typeof AudioWorkletNode < "u";
+}
+function s(e) {
+	return e.some((e) => /head(phone|set)|earbud|earphone|airpods|buds|bluetooth/i.test(e));
+}
+async function c(s) {
+	if (!o()) throw new i("unsupported");
+	let c;
+	try {
+		c = await navigator.mediaDevices.getUserMedia(a);
+	} catch (e) {
+		let t = e instanceof DOMException ? e.name : "";
+		throw new i(t === "NotAllowedError" || t === "SecurityError" ? "not-allowed" : "unavailable");
+	}
+	let l = c.getAudioTracks()[0];
+	if (!l) throw c.getTracks().forEach((e) => e.stop()), new i("unavailable");
+	let u = new AudioContext({ latencyHint: "interactive" }), d = () => {
+		c.getTracks().forEach((e) => e.stop());
+	};
+	try {
+		await u.resume();
+		let i = URL.createObjectURL(new Blob([r], { type: "text/javascript" }));
+		try {
+			await u.audioWorklet.addModule(i);
+		} finally {
+			URL.revokeObjectURL(i);
+		}
+		let a = new AudioWorkletNode(u, n, {
+			numberOfInputs: 2,
+			numberOfOutputs: 0
+		}), o = u.createGain();
+		o.connect(a, 0, 1), a.port.onmessage = (e) => s(e.data);
+		let f = u.createMediaStreamSource(c);
+		f.connect(a, 0, 0), e(u, o);
+		let p = !1, m = () => h.stop(), h = {
+			context: u,
+			micSource: f,
+			track: l,
+			settings: l.getSettings(),
+			stop() {
+				if (!p) {
+					p = !0, window.removeEventListener("pagehide", m), a.port.onmessage = null;
+					try {
+						a.port.postMessage({ type: "stop" }), f.disconnect();
+					} catch {}
+					d(), t(() => {
+						u.close().catch(() => void 0);
+					});
+				}
+			}
+		};
+		return window.addEventListener("pagehide", m), h;
+	} catch (e) {
+		throw d(), u.close().catch(() => void 0), e instanceof i ? e : new i("unavailable");
+	}
+}
+//#endregion
+export { a as CAPTURE_CONSTRAINTS, i as MicCaptureError, o as isMicCaptureSupported, s as looksLikeHeadset, c as startMicCapture };