@burdenoff/fe-libs 2026.903.3 → 2026.903.5

package/dist/shared/assistant/index.d.ts

@@ -19,4 +19,10 @@ export type { UseVoiceInputOptions, UseVoiceInputResult, VoiceInputError } from
 export { toCaptionText } from './voice/captionText';
 export { parseConfirmationRefusal, findPendingWrite } from './pendingWrite';
 export type { PendingWrite, PendingWriteValue } from './pendingWrite';
+export { createSpeechEngines } from './speech/createSpeechEngine';
+export type { SpeechEngine, SpeechSpeakOptions, SpeechSpeakHandlers, SpeechErrorReason } from './speech/types';
+export { buildVoiceTranscriptMarkdown, voiceTranscriptFilename, buildContinuedFromVoiceNote } from './voice/voiceTranscript';
+export { resolveLanguagePair, replyFollowsInput } from './voice/languagePair';
+export { ASSISTANT_LANGUAGES, resolveAssistantLanguage, findAssistantLanguage } from './voice/languages';
+export type { AssistantLanguage } from './voice/languages';
 //# sourceMappingURL=index.d.ts.map

package/dist/shared/assistant/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/assistant/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,QAAQ,EACR,aAAa,EACb,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAKpB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,4BAA4B,EAC5B,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,aAAa,EACb,qBAAqB,EACrB,yBAAyB,EACzB,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,OAAO,CAAC;AAEf,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,sBAAsB,EACtB,yBAAyB,EACzB,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,iBAAiB,EACjB,2BAA2B,EAC3B,oBAAoB,EACpB,2BAA2B,EAC3B,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,cAAc,EACd,cAAc,EACd,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxG,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/assistant/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,QAAQ,EACR,aAAa,EACb,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAKpB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,4BAA4B,EAC5B,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,aAAa,EACb,qBAAqB,EACrB,yBAAyB,EACzB,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,OAAO,CAAC;AAEf,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,sBAAsB,EACtB,yBAAyB,EACzB,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,iBAAiB,EACjB,2BAA2B,EAC3B,oBAAoB,EACpB,2BAA2B,EAC3B,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,cAAc,EACd,cAAc,EACd,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxG,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC/G,OAAO,EAAE,4BAA4B,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAC7H,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AACzG,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/shared/assistant/speech/browserSpeechEngine.d.ts

@@ -0,0 +1,3 @@
+import { SpeechEngine } from './types';
+export declare const browserSpeechEngine: SpeechEngine;
+//# sourceMappingURL=browserSpeechEngine.d.ts.map

package/dist/shared/assistant/speech/browserSpeechEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browserSpeechEngine.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/speech/browserSpeechEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EACV,YAAY,EAKb,MAAM,SAAS,CAAC;AAsCjB,eAAO,MAAM,mBAAmB,EAAE,YAsGjC,CAAC"}

package/dist/shared/assistant/speech/browserSpeechEngine.js

@@ -0,0 +1,89 @@
+//#region src/shared/assistant/speech/browserSpeechEngine.ts
+function e() {
+	if (typeof window > "u") return null;
+	try {
+		return window.speechSynthesis ?? null;
+	} catch {
+		return null;
+	}
+}
+function t() {
+	return typeof window < "u" && typeof window.SpeechSynthesisUtterance == "function";
+}
+function n(e) {
+	switch (e) {
+		case "canceled":
+		case "cancelled":
+		case "interrupted": return "cancelled";
+		case "not-allowed": return "not-allowed";
+		case "synthesis-unavailable":
+		case "language-unavailable":
+		case "voice-unavailable": return "unsupported";
+		default: return "unknown";
+	}
+}
+var r = 0, i = {
+	id: "browser-speech-synthesis",
+	isSupported() {
+		return e() !== null && t();
+	},
+	listVoices() {
+		try {
+			return e()?.getVoices() ?? [];
+		} catch {
+			return [];
+		}
+	},
+	subscribeVoices(t) {
+		let n = e();
+		if (!n?.addEventListener) return () => {};
+		let r = () => t();
+		return n.addEventListener("voiceschanged", r), () => n.removeEventListener("voiceschanged", r);
+	},
+	speak(i, a, o = {}) {
+		let s = e();
+		if (!s || !t()) {
+			o.onError?.("unsupported");
+			return;
+		}
+		let c = i.filter((e) => e.trim().length > 0);
+		if (c.length === 0) {
+			o.onEnd?.();
+			return;
+		}
+		r += 1;
+		let l = r;
+		try {
+			s.cancel();
+		} catch {}
+		c.forEach((e, t) => {
+			let i = new window.SpeechSynthesisUtterance(e);
+			i.lang = a.lang, a.voice && (i.voice = a.voice), a.rate !== void 0 && (i.rate = a.rate), i.onstart = () => {
+				l === r && o.onChunkStart?.(t);
+			}, i.onerror = (e) => {
+				if (l === r) {
+					r += 1;
+					try {
+						s.cancel();
+					} catch {}
+					o.onError?.(n(e.error));
+				}
+			}, t === c.length - 1 && (i.onend = () => {
+				l === r && o.onEnd?.();
+			});
+			try {
+				s.speak(i);
+			} catch {
+				l === r && o.onError?.("unknown");
+			}
+		});
+	},
+	cancel() {
+		r += 1;
+		try {
+			e()?.cancel();
+		} catch {}
+	}
+};
+//#endregion
+export { i as browserSpeechEngine };

package/dist/shared/assistant/speech/createSpeechEngine.d.ts

@@ -0,0 +1,50 @@
+import { SpeechEngine } from './types';
+export interface SpeechEngineConfig {
+    /** Our proxy's URL. Empty/undefined keeps the device engine. */
+    endpoint?: string | null;
+    getHeaders?: () => Record<string, string>;
+    fetchImpl?: typeof fetch;
+}
+/**
+ * Point the assistant at a hosted TTS proxy.
+ *
+ * Called by the host shell's provider, exactly as `configureGeocoder` is. This
+ * is the supported way to turn hosted speech on; the environment variable below
+ * only ever works when this package is run directly (dev / standalone).
+ *
+ * ★ `getHeaders` is not optional in practice, only in the type. The proxy turns
+ * text into audio the org is BILLED for, so an endpoint that accepts anonymous
+ * POSTs is a metered API open to anyone who reads the bundle. The engine has
+ * always supported per-request headers; until now nothing could reach that hook
+ * from the host, which meant the only configuration this function could express
+ * was an unauthenticated one. It is a function rather than a value because
+ * access tokens expire and the engine outlives any one of them — reading a
+ * token once at configure time would work until it rotated and then fail
+ * exactly where it is hardest to notice, mid-reply.
+ */
+export declare function configureSpeechEngine(options: {
+    ttsEndpoint?: string | null;
+    getHeaders?: () => Record<string, string>;
+}): void;
+/**
+ * Read the rollout config.
+ *
+ * Order matters: explicit runtime configuration, then a global the host can set
+ * before the bundle loads, and only then the build-time variable — which is
+ * eliminated in the published package and therefore useful for local dev only.
+ */
+export declare function readSpeechEngineConfig(): SpeechEngineConfig;
+/**
+ * The engine to use, or the device engine when hosted TTS is not configured.
+ *
+ * Returns `null` for `hosted` when off, so callers can tell "hosted is not
+ * configured" from "hosted is configured but cannot speak this language".
+ */
+export declare function createSpeechEngines(config?: SpeechEngineConfig): {
+    device: SpeechEngine;
+    hosted: SpeechEngine | null;
+};
+export declare function getSpeechEngine(): SpeechEngine;
+/** Test seam: drop the singleton so the next call re-reads the config. */
+export declare function resetSpeechEngine(): void;
+//# sourceMappingURL=createSpeechEngine.d.ts.map

package/dist/shared/assistant/speech/createSpeechEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSpeechEngine.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/speech/createSpeechEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,MAAM,WAAW,kBAAkB;IACjC,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC7C,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C,GAAG,IAAI,CAmBP;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,IAAI,kBAAkB,CAY3D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,kBAA6C,GAAG;IAC1F,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;CAC7B,CASA;AAeD,wBAAgB,eAAe,IAAI,YAAY,CAG9C;AAED,0EAA0E;AAC1E,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/shared/assistant/speech/createSpeechEngine.js

@@ -0,0 +1,31 @@
+import { browserSpeechEngine as e } from "./browserSpeechEngine.js";
+import { createHostedTtsEngine as t } from "./hostedTtsSpeechEngine.js";
+import "./routingSpeechEngine.js";
+//#region src/shared/assistant/speech/createSpeechEngine.ts
+var n, r;
+function i() {
+	if (n) return {
+		endpoint: n,
+		getHeaders: r
+	};
+	if (typeof window < "u") {
+		let e = window.__HB_TTS_ENDPOINT__;
+		if (e) return {
+			endpoint: e,
+			getHeaders: r
+		};
+	}
+	return { endpoint: (void 0)?.trim() || null };
+}
+function a(n = i()) {
+	return {
+		device: e,
+		hosted: n.endpoint ? t({
+			endpoint: n.endpoint,
+			getHeaders: n.getHeaders,
+			fetchImpl: n.fetchImpl
+		}) : null
+	};
+}
+//#endregion
+export { a as createSpeechEngines };

package/dist/shared/assistant/speech/hostedTtsProtocol.d.ts

@@ -0,0 +1,118 @@
+import { SpeechErrorReason } from './types';
+/** What the client sends per chunk. */
+export interface HostedTtsRequest {
+    text: string;
+    /** BCP-47, e.g. `ta-IN`. The vendor needs the region, not a bare subtag. */
+    languageCode: string;
+    /** Vendor voice id, e.g. `ta-IN-Chirp3-HD-Kore`. Omitted = server default. */
+    voiceName?: string;
+    /** Vendor voice tier, so the backend need not infer it from the name. */
+    tier: string;
+    /**
+     * The same knob the device engine calls `rate`.
+     *
+     * ★ The accepted range depends on which vendor ENDPOINT the proxy calls, not
+     * on the voice tier — see `SPEAKING_RATE_MAX_SYNC` below. Values in use are
+     * 0.9, and 0.85 for Indic scripts and Arabic, comfortably inside every
+     * variant, so this has never affected playback.
+     */
+    speakingRate?: number;
+}
+/**
+ * Google's synthesize response is `{ audioContent: <base64 mp3> }`. We accept
+ * that shape directly so the proxy can be a thin pass-through, but the proxy is
+ * also free to return raw audio bytes — see `decodeAudioResponse`.
+ */
+export interface HostedTtsJsonResponse {
+    audioContent?: string;
+    error?: {
+        message?: string;
+    };
+}
+/**
+ * The accepted speaking-rate bounds, for any caller that clamps.
+ *
+ * ★ The ceiling is a property of the ENDPOINT, not of the voice tier, and the
+ * vendor's own rejection message says both numbers out loud:
+ *
+ *   "Unable to adjust speaking rate. Please ensure that speaking_rate is in the
+ *    range [0.25, 4.0] for sync synthesis and in the range [0.25, 2.0] for
+ *    streaming synthesis."
+ *
+ * Measured against the live API on 2026-08-31 with `en-IN-Chirp3-HD-Puck` and a
+ * fixed sentence, reading the returned LINEAR16 duration rather than trusting
+ * the HTTP status — 4.0 synthesises and is genuinely ~4x faster (21.93s at 0.25
+ * down to 1.37s at 4.0); 4.1, 5.0 and 0.2 are all rejected with the message
+ * above.
+ *
+ * This corrects a previous edit of this file which narrowed the ceiling to 2.0
+ * and attributed 4.0 to "the older Standard/WaveNet tiers". That reading was
+ * wrong: 2.0 is the STREAMING limit, and the tier has nothing to do with it.
+ *
+ * `SPEAKING_RATE_MAX` is the sync ceiling because the proxy calls
+ * `v1/text:synthesize`. Moving it to `v1/text:streamingSynthesize` — tempting,
+ * since that is how you cut time-to-first-audio — halves the ceiling, and rates
+ * the client had treated as valid would start returning 400. That switch has to
+ * change this alias in the same commit, which is why both bounds are named
+ * rather than one being a magic number.
+ */
+export declare const SPEAKING_RATE_MIN = 0.25;
+export declare const SPEAKING_RATE_MAX_SYNC = 4;
+export declare const SPEAKING_RATE_MAX_STREAMING = 2;
+export declare const SPEAKING_RATE_MAX = 4;
+/**
+ * Should a failure stop the engine claiming support for the rest of the page?
+ *
+ * ★ `not-allowed` has TWO producers and only one of them is terminal:
+ *
+ *  - `classifyHttpFailure` maps HTTP 401/403 to it — the proxy refuses us, and
+ *    every later request will be refused identically. Latching is right: it
+ *    makes `routingSpeechEngine` fall back to device voices instead of
+ *    repeating a request that cannot succeed.
+ *  - the engine maps the browser's `NotAllowedError` to it — the autoplay
+ *    policy declining to play audio that was not started by a user gesture.
+ *    That is PER-GESTURE and entirely transient; the very next tap works.
+ *
+ * Latching on the second silently deleted the hosted voice for the whole page
+ * after a single refusal — and auto-speak is precisely the path that triggers
+ * it, because an arriving reply is not a gesture. The user would hear Chirp 3
+ * once, be refused once, and get device voices for the rest of the session with
+ * nothing explaining why.
+ *
+ * Pure and exported because the engine itself cannot be unit-tested here (no
+ * DOM, no Audio), so the decision is kept where it CAN be.
+ */
+export declare function shouldDisableEngine(reason: string | undefined, transient: boolean): boolean;
+/** Vendor limit is 5000 bytes per request; stay well inside it. */
+export declare const HOSTED_TTS_MAX_CHARS = 2000;
+export declare function buildRequest(text: string, languageCode: string, tier: string, voiceName?: string | null, speakingRate?: number): HostedTtsRequest;
+/**
+ * Map a transport failure onto the reasons the UI already knows how to explain.
+ *
+ * `cancelled` is deliberately NOT produced here — an aborted request is the
+ * caller's own doing and the engine reports it, exactly as the browser engine
+ * swallows its own `canceled` utterance errors.
+ */
+export declare function classifyHttpFailure(status: number): SpeechErrorReason;
+/** Base64 → bytes, without assuming a DOM (`atob` is not in node). */
+export declare function base64ToBytes(base64: string): Uint8Array;
+/**
+ * Accept either shape the proxy may return: a JSON body carrying base64
+ * (the vendor's own shape, so the proxy can pass it straight through) or raw
+ * audio bytes.
+ *
+ * Returns null when the payload carries no audio at all — which must be treated
+ * as a failure, not as silence. A zero-byte "success" that plays nothing is the
+ * dead-button bug this feature already fixed once.
+ */
+export declare function decodeAudioResponse(contentType: string | null, body: ArrayBuffer | HostedTtsJsonResponse): Uint8Array | null;
+/**
+ * Split text the hosted vendor would reject for length.
+ *
+ * `chunkForSpeech` already splits for the browser engine's ~15s utterance
+ * ceiling, and those chunks are normally far under the vendor limit — this is a
+ * backstop for a single pathological sentence, and it splits on whitespace so a
+ * word is never cut in half.
+ */
+export declare function splitForVendor(text: string, limit?: number): string[];
+//# sourceMappingURL=hostedTtsProtocol.d.ts.map

package/dist/shared/assistant/speech/hostedTtsProtocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hostedTtsProtocol.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/speech/hostedTtsProtocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,uCAAuC;AACvC,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,YAAY,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,iBAAiB,OAAO,CAAC;AACtC,eAAO,MAAM,sBAAsB,IAAM,CAAC;AAC1C,eAAO,MAAM,2BAA2B,IAAM,CAAC;AAC/C,eAAO,MAAM,iBAAiB,IAAyB,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,CAG3F;AAED,mEAAmE;AACnE,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAEzC,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,EACzB,YAAY,CAAC,EAAE,MAAM,GACpB,gBAAgB,CAUlB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAOrE;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAaxD;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,IAAI,EAAE,WAAW,GAAG,qBAAqB,GACxC,UAAU,GAAG,IAAI,CAWnB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAuB,GAAG,MAAM,EAAE,CAenF"}

package/dist/shared/assistant/speech/hostedTtsProtocol.js

@@ -0,0 +1,42 @@
+//#region src/shared/assistant/speech/hostedTtsProtocol.ts
+function e(e, t) {
+	return t ? !1 : e === "not-allowed" || e === "unsupported";
+}
+var t = 2e3;
+function n(e, t, n, r, i) {
+	let a = {
+		text: e,
+		languageCode: t,
+		tier: n
+	};
+	return r && r.toLowerCase().startsWith(t.toLowerCase()) && (a.voiceName = r), i !== void 0 && (a.speakingRate = i), a;
+}
+function r(e) {
+	return e === 401 || e === 403 ? "not-allowed" : e === 404 || e === 501 ? "unsupported" : "unknown";
+}
+function i(e) {
+	let t = globalThis.Buffer, n = typeof atob == "function" ? atob(e) : t?.from(e, "base64").toString("binary") ?? "", r = new Uint8Array(n.length);
+	for (let e = 0; e < n.length; e += 1) r[e] = n.charCodeAt(e);
+	return r;
+}
+function a(e, t) {
+	if (t instanceof ArrayBuffer) return t.byteLength > 0 ? new Uint8Array(t) : null;
+	if (e?.includes("json") || typeof t == "object") {
+		let e = t.audioContent;
+		if (!e) return null;
+		let n = i(e);
+		return n.length > 0 ? n : null;
+	}
+	return null;
+}
+function o(e, n = t) {
+	if (e.length <= n) return [e];
+	let r = [], i = e;
+	for (; i.length > n;) {
+		let e = i.slice(0, n).lastIndexOf(" "), t = e > n * .5 ? e : n;
+		r.push(i.slice(0, t).trim()), i = i.slice(t).trim();
+	}
+	return i && r.push(i), r.filter((e) => e.length > 0);
+}
+//#endregion
+export { n as buildRequest, r as classifyHttpFailure, a as decodeAudioResponse, e as shouldDisableEngine, o as splitForVendor };

package/dist/shared/assistant/speech/hostedTtsSpeechEngine.d.ts

@@ -0,0 +1,10 @@
+import { SpeechEngine } from './types';
+export interface HostedTtsOptions {
+    /** Absolute or same-origin path of OUR proxy. Never the vendor directly. */
+    endpoint: string;
+    /** Extra headers per request (auth). Called fresh each time so a rotated token is picked up. */
+    getHeaders?: () => Record<string, string>;
+    fetchImpl?: typeof fetch;
+}
+export declare function createHostedTtsEngine(options: HostedTtsOptions): SpeechEngine;
+//# sourceMappingURL=hostedTtsSpeechEngine.d.ts.map

package/dist/shared/assistant/speech/hostedTtsSpeechEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hostedTtsSpeechEngine.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/speech/hostedTtsSpeechEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAUH,OAAO,KAAK,EAAE,YAAY,EAA4D,MAAM,SAAS,CAAC;AAEtG,MAAM,WAAW,gBAAgB;IAC/B,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAC;IACjB,gGAAgG;IAChG,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,gBAAgB,GAAG,YAAY,CAkP7E"}

package/dist/shared/assistant/speech/hostedTtsSpeechEngine.js

@@ -0,0 +1,121 @@
+import { HOSTED_TTS_TIER as e, HOSTED_VOICES as t, hostedLocaleFor as n } from "./hostedVoiceCatalogue.js";
+import { buildRequest as r, classifyHttpFailure as i, decodeAudioResponse as a, shouldDisableEngine as o, splitForVendor as s } from "./hostedTtsProtocol.js";
+//#region src/shared/assistant/speech/hostedTtsSpeechEngine.ts
+function c(c) {
+	let l = c.fetchImpl ?? ((...e) => fetch(...e)), u = null, d = null, f = 0, p = null, m = !1, h = () => {
+		d &&= (URL.revokeObjectURL(d), null);
+	}, g = () => {
+		if (u) {
+			u.onended = null, u.onerror = null;
+			try {
+				u.pause();
+			} catch {}
+			u = null;
+		}
+		h();
+	};
+	async function _(t, o, s) {
+		let u = r(t, n(o.lang) ?? o.lang, e, o.voice?.name ?? null, o.rate), d = await l(c.endpoint, {
+			method: "POST",
+			signal: s,
+			headers: {
+				"content-type": "application/json",
+				...c.getHeaders?.() ?? {}
+			},
+			body: JSON.stringify(u)
+		});
+		if (!d.ok) {
+			let e = /* @__PURE__ */ Error(`hosted tts ${d.status}`);
+			throw e.reason = i(d.status), e;
+		}
+		let f = d.headers.get("content-type"), p = a(f, f?.includes("json") ? await d.json() : await d.arrayBuffer());
+		if (!p) {
+			let e = /* @__PURE__ */ Error("hosted tts returned no audio");
+			throw e.reason = "unknown", e;
+		}
+		return p;
+	}
+	function v(e, t, n) {
+		return new Promise((r, i) => {
+			if (t !== f) {
+				r();
+				return;
+			}
+			let a = new Blob([e.slice().buffer], { type: "audio/mpeg" });
+			h(), d = URL.createObjectURL(a);
+			let o = new Audio(d);
+			u = o, o.onended = () => {
+				t === f && r();
+			}, o.onerror = () => {
+				if (t !== f) {
+					r();
+					return;
+				}
+				let e = /* @__PURE__ */ Error("audio playback failed");
+				e.reason = "unknown", i(e);
+			}, o.play().then(() => {
+				t === f && n?.();
+			}, (e) => {
+				if (t !== f) {
+					r();
+					return;
+				}
+				let n = /* @__PURE__ */ Error("audio play rejected"), a = e?.name === "NotAllowedError";
+				n.reason = a ? "not-allowed" : "unknown", n.transient = a, i(n);
+			});
+		});
+	}
+	return {
+		id: "hosted-tts",
+		isSupported() {
+			return m ? !1 : typeof window < "u" && typeof window.Audio == "function" && typeof fetch == "function";
+		},
+		listVoices() {
+			return [...t];
+		},
+		subscribeVoices() {
+			return () => {};
+		},
+		speak(e, t, n = {}) {
+			let r = e.filter((e) => e.trim().length > 0).flatMap((e) => s(e));
+			if (r.length === 0) {
+				n.onEnd?.();
+				return;
+			}
+			f += 1;
+			let i = f;
+			g();
+			let a = new AbortController();
+			p = a;
+			let c = !1, l = () => {
+				c || (c = !0, n.onStart?.());
+			}, u = (e) => {
+				let n = _(e, t, a.signal);
+				return n.catch(() => {}), n;
+			};
+			(async () => {
+				try {
+					let e = u(r[0]);
+					for (let t = 0; t < r.length; t += 1) {
+						if (i !== f) return;
+						let a = await e;
+						if (i !== f) return;
+						let o = r[t + 1];
+						o !== void 0 && (e = u(o)), n.onChunkStart?.(t), await v(a, i, l);
+					}
+					i === f && n.onEnd?.();
+				} catch (e) {
+					if (a.abort(), i !== f) return;
+					f += 1, g();
+					let t = e?.reason;
+					o(t, e?.transient === !0) && (m = !0), n.onError?.(t === "not-allowed" || t === "unsupported" || t === "cancelled" ? t : "unknown");
+				}
+			})();
+		},
+		cancel() {
+			f += 1, p?.abort(), p = null, g();
+		}
+	};
+}
+//#endregion
+export { c as createHostedTtsEngine };

package/dist/shared/assistant/speech/hostedVoiceCatalogue.d.ts

@@ -0,0 +1,35 @@
+import { SpeechVoiceLike } from '../voice/speechVoices';
+/** Vendor tier this catalogue describes; sent to the backend with each request. */
+export declare const HOSTED_TTS_TIER = "chirp3-hd";
+/**
+ * Every hosted voice, as `SpeechVoiceLike` so it is interchangeable with a
+ * device voice everywhere downstream.
+ *
+ * The vendor id form is `<vendor-locale>-Chirp3-HD-<Speaker>`, e.g.
+ * `ta-IN-Chirp3-HD-Kore`. It is used as BOTH the display name and the id the
+ * backend receives, because the persisted preference is keyed by name — a
+ * separate display label would break a saved pick the first time it changed.
+ *
+ * `name` is therefore always the VENDOR's spelling (it is sent on the wire and
+ * must exist), while `lang` is always the APP's (it is matched against
+ * `SPEECH_LANG`). For every locale but Mandarin these are the same string.
+ */
+export declare const HOSTED_VOICES: readonly SpeechVoiceLike[];
+/**
+ * The exact vendor locale to request for an app tag, or null when the vendor
+ * cannot speak the language at all.
+ *
+ * Prefers an exact match (`en-GB` stays `en-GB`, `zh-CN` becomes `cmn-CN`) and
+ * otherwise falls back to the primary subtag's canonical vendor locale
+ * (`ar-SA` -> `ar-XA`, `zh` -> `cmn-CN`).
+ */
+export declare function hostedLocaleFor(tag: string): string | null;
+/**
+ * True when the hosted engine can actually speak this language.
+ *
+ * The caller needs this to decide whether to fall back to the device engine
+ * for a reply in a language the vendor does not cover, rather than sending a
+ * request that can only fail.
+ */
+export declare function hostedSupportsLanguage(tag: string): boolean;
+//# sourceMappingURL=hostedVoiceCatalogue.d.ts.map

package/dist/shared/assistant/speech/hostedVoiceCatalogue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hostedVoiceCatalogue.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/speech/hostedVoiceCatalogue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,mFAAmF;AACnF,eAAO,MAAM,eAAe,cAAc,CAAC;AAyE3C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,eAAe,EAQnD,CAAC;AAiCF;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO1D;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE3D"}

package/dist/shared/assistant/speech/hostedVoiceCatalogue.js

@@ -0,0 +1,53 @@
+//#region src/shared/assistant/speech/hostedVoiceCatalogue.ts
+var e = "chirp3-hd", t = [
+	"Achernar",
+	"Algenib",
+	"Charon",
+	"Kore",
+	"Puck",
+	"Zephyr"
+], n = [
+	"en-US",
+	"en-GB",
+	"en-IN",
+	"ta-IN",
+	"hi-IN",
+	"bn-IN",
+	"te-IN",
+	"mr-IN",
+	"gu-IN",
+	"kn-IN",
+	"ml-IN",
+	"pa-IN",
+	"ur-IN",
+	"ar-XA",
+	"es-ES",
+	"cmn-CN",
+	"ja-JP",
+	"fr-FR",
+	"de-DE"
+], r = { "cmn-CN": "zh-CN" };
+function i(e) {
+	return r[e] ?? e;
+}
+var a = n.flatMap((e) => t.map((t) => ({
+	name: `${e}-Chirp3-HD-${t}`,
+	lang: i(e),
+	localService: !1
+}))), o = /* @__PURE__ */ new Map();
+for (let e of n) for (let t of new Set([i(e), e])) {
+	let n = t.toLowerCase().split("-")[0];
+	o.has(n) || o.set(n, e);
+}
+var s = /* @__PURE__ */ new Map();
+for (let e of n) s.set(e.toLowerCase(), e), s.set(i(e).toLowerCase(), e);
+function c(e) {
+	let t = e.trim().replace("_", "-");
+	if (!t) return null;
+	let n = s.get(t.toLowerCase());
+	if (n) return n;
+	let r = t.toLowerCase().split("-")[0];
+	return o.get(r) ?? null;
+}
+//#endregion
+export { e as HOSTED_TTS_TIER, a as HOSTED_VOICES, c as hostedLocaleFor };

package/dist/shared/assistant/speech/index.d.ts

@@ -0,0 +1,8 @@
+export { browserSpeechEngine } from './browserSpeechEngine';
+export { createHostedTtsEngine } from './hostedTtsSpeechEngine';
+export { configureSpeechEngine, createSpeechEngines, getSpeechEngine, readSpeechEngineConfig, resetSpeechEngine, } from './createSpeechEngine';
+export { createRoutingSpeechEngine } from './routingSpeechEngine';
+export type { SpeechEngineConfig } from './createSpeechEngine';
+export { HOSTED_VOICES, HOSTED_TTS_TIER, hostedSupportsLanguage } from './hostedVoiceCatalogue';
+export type { SpeechEngine, SpeechErrorReason, SpeechSpeakHandlers, SpeechSpeakOptions, SpeechVoiceLike, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/assistant/speech/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/speech/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChG,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,GAChB,MAAM,SAAS,CAAC"}

package/dist/shared/assistant/speech/routingSpeechEngine.d.ts

@@ -0,0 +1,8 @@
+import { SpeechEngine } from './types';
+export interface RoutingEngines {
+    device: SpeechEngine;
+    /** Null when hosted TTS is not configured — then this is a pass-through. */
+    hosted: SpeechEngine | null;
+}
+export declare function createRoutingSpeechEngine({ device, hosted }: RoutingEngines): SpeechEngine;
+//# sourceMappingURL=routingSpeechEngine.d.ts.map

package/dist/shared/assistant/speech/routingSpeechEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routingSpeechEngine.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/speech/routingSpeechEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EAAE,YAAY,EAA4D,MAAM,SAAS,CAAC;AAEtG,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,YAAY,CAAC;IACrB,4EAA4E;IAC5E,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;CAC7B;AAED,wBAAgB,yBAAyB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,cAAc,GAAG,YAAY,CAoG1F"}

package/dist/shared/assistant/speech/routingSpeechEngine.js

@@ -0,0 +1 @@
+import "./hostedVoiceCatalogue.js";