@burdenoff/fe-libs 2026.903.10 → 2026.904.2

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

@@ -0,0 +1,62 @@
+import { ReactNode } from 'react';
+/**
+ * Assistant copy, namespaced by product.
+ *
+ * The assistant UI is shared but its translations are not: every product seeds
+ * its own keys, and HealthyBowl already has hundreds of `healthybowl.assistant.*`
+ * keys live in production. So a shared component cannot hardcode a key prefix —
+ * it must ask for a RELATIVE key and let the product decide the namespace.
+ *
+ * ★★ The shape below is chosen to be byte-compatible with what HealthyBowl
+ * already ships. `assistantTranslationKey('healthybowl', 'header.title')` is
+ * exactly `'healthybowl.assistant.header.title'`, which is the key already
+ * seeded and already translated. Any other shape would silently drop every
+ * non-English user back to the English fallback while every test still passed —
+ * the migration would look clean and quietly un-translate the product.
+ *
+ * Products other than HealthyBowl simply have no keys yet, so they get the
+ * English fallback until they seed theirs. That is a known, visible gap rather
+ * than a regression.
+ */
+/**
+ * How a relative key becomes a full translation key.
+ *
+ * Pure and exported precisely so the compatibility claim above is testable
+ * without rendering anything.
+ */
+export declare function assistantTranslationKey(namespace: string, key: string): string;
+export interface AssistantI18nValue {
+    /** Product id, e.g. `healthybowl`. Matches the id in shared/config/products. */
+    namespace: string;
+}
+export interface AssistantI18nProviderProps {
+    namespace: string;
+    children: ReactNode;
+}
+/**
+ * Supplies the product namespace to every assistant component beneath it.
+ *
+ * Mount it once, as high as the assistant goes — the same product id the
+ * transport already needs for `AI_ASSISTANT_PRODUCT`, so there is one answer to
+ * "which product is this?" rather than two that can disagree.
+ */
+export declare function AssistantI18nProvider({ namespace, children, }: AssistantI18nProviderProps): import("react/jsx-runtime").JSX.Element;
+/** The namespace in force, or null when no provider is mounted. */
+export declare function useAssistantI18nNamespace(): string | null;
+export type AssistantTr = (key: string, fallback: string, params?: Record<string, string | number>) => string;
+/**
+ * Translate a RELATIVE assistant key, e.g. `tr('header.title', 'Assistant')`.
+ *
+ * Fallback semantics match the products' existing `useTr`: the I18n provider
+ * returns the key itself when it has no translation, and the caller's English
+ * string is used instead so a raw key never reaches the UI.
+ *
+ * ★ With no provider mounted this returns the English fallback rather than
+ * throwing. A missing provider is a configuration mistake, but a thrown error
+ * inside render is a white screen, and English copy is strictly better than
+ * that. It complains once to the console so the mistake is still findable — the
+ * failure this guards against is the assistant silently rendering English in
+ * every locale, which is exactly what happened to the fe-libs shell.
+ */
+export declare function useAssistantTr(): AssistantTr;
+//# sourceMappingURL=i18n.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../../src/shared/assistant/i18n.tsx"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAIf;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACV,MAAM,CAER;AAED,MAAM,WAAW,kBAAkB;IACjC,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,SAAS,EACT,QAAQ,GACT,EAAE,0BAA0B,2CAO5B;AAED,mEAAmE;AACnE,wBAAgB,yBAAyB,IAAI,MAAM,GAAG,IAAI,CAEzD;AAED,MAAM,MAAM,WAAW,GAAG,CACxB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KACrC,MAAM,CAAC;AAIZ;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,IAAI,WAAW,CA4B5C"}

package/dist/shared/assistant/i18n.js

@@ -0,0 +1,32 @@
+import { useI18n as e } from "../providers/shell/I18nProvider.js";
+import { createContext as t, useCallback as n, useContext as r, useMemo as i } from "react";
+import { jsx as a } from "react/jsx-runtime";
+//#region src/shared/assistant/i18n.tsx
+function o(e, t) {
+	return `${e}.assistant.${t}`;
+}
+var s = t(null);
+function c({ namespace: e, children: t }) {
+	let n = i(() => ({ namespace: e }), [e]);
+	return /* @__PURE__ */ a(s.Provider, {
+		value: n,
+		children: t
+	});
+}
+function l() {
+	return r(s)?.namespace ?? null;
+}
+var u = !1;
+function d() {
+	let { t } = e(), r = l();
+	return r === null && !u && (u = !0, console.error("[assistant] No AssistantI18nProvider mounted — assistant copy will render in English for every locale. Wrap the assistant in <AssistantI18nProvider namespace=\"<product>\">.")), n((e, n, i) => {
+		if (r === null) return f(n, i);
+		let a = o(r, e), s = t(a);
+		return f(s === a ? n : s, i);
+	}, [t, r]);
+}
+function f(e, t) {
+	return t ? Object.entries(t).reduce((e, [t, n]) => e.replace(RegExp(`\\{\\{${t}\\}\\}`, "g"), String(n)), e) : e;
+}
+//#endregion
+export { c as AssistantI18nProvider, o as assistantTranslationKey, l as useAssistantI18nNamespace, d as useAssistantTr };

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

@@ -59,4 +59,8 @@ export * from './images';
 export * from './operations';
 export * from './capabilities';
 export * from './speech/hostedTtsProtocol';
+export * from './i18n';
+export * from './voice/speechLabels';
+export * from './voice/replyLanguage';
+export * from './voice/speechPlayback';
 //# 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AAGxB,cAAc,wBAAwB,CAAC;AAKvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAG9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,gBAAgB,CAAC;AAK/B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/assistant/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AAGxB,cAAc,wBAAwB,CAAC;AAKvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAG9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,gBAAgB,CAAC;AAK/B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAG3C,cAAc,QAAQ,CAAC;AAEvB,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC"}

package/dist/shared/assistant/voice/replyLanguage.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Which language is this reply actually in? (BOFF-7107)
+ *
+ * The assistant reads replies aloud by choosing a voice for `useI18n().locale` —
+ * the UI language. That is the wrong signal the moment the model answers in the
+ * language the USER wrote in rather than the one the chrome is set to, which is
+ * exactly what the language directive in `assistantPrompt` now asks it to do.
+ * A Tamil reply read by an English voice is confident nonsense, and it is the
+ * one failure the speech module is built to make impossible.
+ *
+ * So playback keys on the reply text instead. Deliberately by SCRIPT, not by a
+ * statistical language detector:
+ *
+ *  - it is deterministic, dependency-free and costs no bundle;
+ *  - for the languages HealthyBowl actually serves beyond English — Tamil,
+ *    Hindi, Arabic, Chinese — the script IS the language, unambiguously;
+ *  - a detector that can separate en/es/fr/de (`franc` and friends) is ~40KB and
+ *    still guesses on short strings.
+ *
+ * The honest limitation: **Latin-script languages cannot be told apart this
+ * way.** A Spanish reply in an English UI still gets an English voice. That is a
+ * far smaller failure than the cross-script one (an English voice reading
+ * Spanish is accented but intelligible; an English voice reading Tamil is
+ * noise), and closing it needs a real detector — a deliberate later choice, not
+ * an oversight.
+ */
+/**
+ * The locale whose voice should read `text`, or `null` when the script does not
+ * decide it (empty, no letters, or Latin — see the module note).
+ */
+export declare function detectScriptLocale(text: string): string | null;
+/**
+ * The locale to speak `text` in: the script when it decides, else the app locale.
+ *
+ * Falling back to the app locale (rather than refusing) keeps every Latin-script
+ * reply behaving exactly as it did before this existed.
+ */
+/**
+ * ⚠️ `appLocale` is the caller's best available signal for "which language did
+ * the user mean", and it is only as good as that signal.
+ *
+ * With the interface language alone it is a weak proxy: an English-UI user who
+ * writes in Urdu produces an Urdu reply, but `appLocale` says `en`, so a shared
+ * Arabic script falls back to the family default and picks an Arabic voice.
+ * BOFF-7108 is what fixes this properly — it lets the user state the language
+ * they are speaking, independently of the interface, and passes THAT here.
+ *
+ * Callers should therefore hand in the most specific language they know: the
+ * user's declared conversation language if there is one, the UI locale only as a
+ * last resort.
+ */
+export declare function resolveSpeechLocale(text: string, appLocale: string): string;
+//# sourceMappingURL=replyLanguage.d.ts.map

package/dist/shared/assistant/voice/replyLanguage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replyLanguage.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/voice/replyLanguage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AA2EH;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgD9D;AAED;;;;;GAKG;AACH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAU3E"}

package/dist/shared/assistant/voice/replyLanguage.js

@@ -0,0 +1,112 @@
+//#region src/shared/assistant/voice/replyLanguage.ts
+var e = [
+	{
+		locale: "ja",
+		pattern: /[\p{Script=Hiragana}\p{Script=Katakana}]/u
+	},
+	{
+		locale: "ko",
+		pattern: /\p{Script=Hangul}/u
+	},
+	{
+		locale: "zh",
+		pattern: /\p{Script=Han}/u
+	},
+	{
+		locale: "ta",
+		pattern: /\p{Script=Tamil}/u
+	},
+	{
+		locale: "hi",
+		pattern: /\p{Script=Devanagari}/u
+	},
+	{
+		locale: "bn",
+		pattern: /\p{Script=Bengali}/u
+	},
+	{
+		locale: "te",
+		pattern: /\p{Script=Telugu}/u
+	},
+	{
+		locale: "kn",
+		pattern: /\p{Script=Kannada}/u
+	},
+	{
+		locale: "ml",
+		pattern: /\p{Script=Malayalam}/u
+	},
+	{
+		locale: "gu",
+		pattern: /\p{Script=Gujarati}/u
+	},
+	{
+		locale: "pa",
+		pattern: /\p{Script=Gurmukhi}/u
+	},
+	{
+		locale: "ar",
+		pattern: /\p{Script=Arabic}/u
+	},
+	{
+		locale: "he",
+		pattern: /\p{Script=Hebrew}/u
+	},
+	{
+		locale: "ru",
+		pattern: /\p{Script=Cyrillic}/u
+	},
+	{
+		locale: "el",
+		pattern: /\p{Script=Greek}/u
+	}
+], t = {
+	zh: ["zh", "ja"],
+	ar: [
+		"ar",
+		"ur",
+		"fa",
+		"ps",
+		"sd"
+	],
+	hi: [
+		"hi",
+		"mr",
+		"ne",
+		"sa",
+		"kok"
+	],
+	ru: [
+		"ru",
+		"uk",
+		"bg",
+		"sr",
+		"mk",
+		"be"
+	]
+}, n = .3, r = .2, i = /\p{L}/u;
+function a(t) {
+	if (!t) return null;
+	let a = 0, o = /* @__PURE__ */ new Map();
+	for (let n of t) if (i.test(n)) {
+		a += 1;
+		for (let { locale: t, pattern: r } of e) if (r.test(n)) {
+			o.set(t, (o.get(t) ?? 0) + 1);
+			break;
+		}
+	}
+	if (a === 0) return null;
+	let s = o.get("ja") ?? 0, c = o.get("zh") ?? 0;
+	s > 0 && s >= (s + c) * r && (o.set("ja", s + c), o.delete("zh"));
+	let l = null, u = 0;
+	for (let [e, t] of o) t > u && (l = e, u = t);
+	return l !== null && u / a >= n ? l : null;
+}
+function o(e, n) {
+	let r = a(e);
+	if (r === null) return n;
+	let i = t[r];
+	return i && i.includes(n) ? n : r;
+}
+//#endregion
+export { a as detectScriptLocale, o as resolveSpeechLocale };

package/dist/shared/assistant/voice/speechLabels.d.ts

@@ -0,0 +1,12 @@
+import { SpeakableLabels } from './speakableText';
+/**
+ * Labels to read a reply in `locale` with.
+ *
+ * `uiLabels` is the interface-language set, used both as the base and as the
+ * fallback for any language not carried here — so English replies, and any
+ * language we have no table for, behave exactly as before.
+ */
+export declare function speechLabelsFor(locale: string, uiLabels: SpeakableLabels): SpeakableLabels;
+/** Exposed for tests: which languages have their own spoken labels. */
+export declare const SPOKEN_LABEL_LANGUAGES: string[];
+//# sourceMappingURL=speechLabels.d.ts.map

package/dist/shared/assistant/voice/speechLabels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"speechLabels.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/voice/speechLabels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAyGvD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,eAAe,GACxB,eAAe,CAKjB;AAED,uEAAuE;AACvE,eAAO,MAAM,sBAAsB,UAAkC,CAAC"}

package/dist/shared/assistant/voice/speechLabels.js

@@ -0,0 +1,75 @@
+//#region src/shared/assistant/voice/speechLabels.ts
+var e = {
+	en: {
+		codeBlock: "Code block",
+		image: "image",
+		link: "link",
+		largeTable: "Table with {{rows}} rows and {{columns}} columns",
+		truncated: "The rest of this message is not read aloud",
+		nestedItem: "Sub-item {{ordinal}}",
+		emailAt: "at",
+		emailDot: "dot"
+	},
+	ta: {
+		codeBlock: "நிரல் தொகுதி",
+		image: "படம்",
+		link: "இணைப்பு",
+		largeTable: "{{rows}} வரிசைகள் மற்றும் {{columns}} நெடுவரிசைகள் கொண்ட அட்டவணை",
+		truncated: "இந்தச் செய்தியின் மீதமுள்ள பகுதி வாசிக்கப்படவில்லை",
+		nestedItem: "துணை உருப்படி {{ordinal}}",
+		emailAt: "அட்",
+		emailDot: "புள்ளி"
+	},
+	hi: {
+		codeBlock: "कोड ब्लॉक",
+		image: "छवि",
+		link: "लिंक",
+		largeTable: "{{rows}} पंक्तियों और {{columns}} स्तंभों वाली तालिका",
+		truncated: "इस संदेश का शेष भाग नहीं पढ़ा जाता",
+		nestedItem: "उप-आइटम {{ordinal}}",
+		emailAt: "ऐट",
+		emailDot: "डॉट"
+	},
+	ar: {
+		codeBlock: "كتلة برمجية",
+		image: "صورة",
+		link: "رابط",
+		largeTable: "جدول من {{rows}} صفوف و {{columns}} أعمدة",
+		truncated: "لا تتم قراءة بقية هذه الرسالة بصوت عالٍ",
+		nestedItem: "عنصر فرعي {{ordinal}}",
+		emailAt: "أت",
+		emailDot: "نقطة"
+	},
+	es: {
+		codeBlock: "Bloque de código",
+		image: "imagen",
+		link: "enlace",
+		largeTable: "Tabla con {{rows}} filas y {{columns}} columnas",
+		truncated: "El resto de este mensaje no se lee en voz alta",
+		nestedItem: "Subelemento {{ordinal}}",
+		emailAt: "arroba",
+		emailDot: "punto"
+	},
+	zh: {
+		codeBlock: "代码块",
+		image: "图片",
+		link: "链接",
+		largeTable: "包含 {{rows}} 行 {{columns}} 列的表格",
+		truncated: "此消息的其余部分不会朗读",
+		nestedItem: "子项 {{ordinal}}",
+		emailAt: "at",
+		emailDot: "点"
+	}
+};
+function t(t, n) {
+	let r = t.trim().toLowerCase().split(/[-_]/)[0];
+	if (!r) return n;
+	let i = e[r];
+	return i ? {
+		...n,
+		...i
+	} : n;
+}
+var n = Object.keys(e);
+//#endregion
+export { n as SPOKEN_LABEL_LANGUAGES, t as speechLabelsFor };

package/dist/shared/assistant/voice/speechPlayback.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Playback state for the assistant's spoken reply (BOFF-6290).
+ *
+ * A reducer rather than a pile of `useState` calls, because the awkward part of
+ * speech playback is not "is it speaking" — it is that the engine's `end` and
+ * `error` events arrive AFTER the state has already moved on:
+ *
+ *  - tapping speak on message B while A is talking cancels A, and A's `end`
+ *    event lands a tick later. Without a guard it would clear B's speaking state
+ *    and leave a button that says "stop" next to silence — or worse, silence
+ *    next to a button that says "speak" while the voice keeps going;
+ *  - closing the panel cancels playback, and the cancellation itself fires
+ *    `error` on every queued utterance.
+ *
+ * Every transition therefore carries a monotonically increasing `requestId`, and
+ * a terminal event is only honoured when it belongs to the CURRENT request. That
+ * is the whole trick, and it is pure, so it is tested directly (the audio around
+ * it is not testable in this repo's node-environment vitest).
+ */
+export type SpeechPlaybackState = {
+    readonly status: "idle";
+} | {
+    readonly status: "speaking";
+    readonly messageId: string;
+    readonly requestId: number;
+};
+export type SpeechPlaybackAction = 
+/** User pressed speak on a message (or auto-speak fired). */
+{
+    readonly type: "start";
+    readonly messageId: string;
+    readonly requestId: number;
+}
+/** User pressed the control on `messageId`: stop if it is the one talking. */
+ | {
+    readonly type: "toggle";
+    readonly messageId: string;
+    readonly requestId: number;
+}
+/** Explicit stop: the stop button, panel close, conversation switch, unmount. */
+ | {
+    readonly type: "stop";
+}
+/** The engine finished the queue for `requestId`. */
+ | {
+    readonly type: "finished";
+    readonly requestId: number;
+}
+/** The engine failed (or was cancelled) on `requestId`. */
+ | {
+    readonly type: "failed";
+    readonly requestId: number;
+};
+export declare const IDLE_PLAYBACK: SpeechPlaybackState;
+export declare function speechPlaybackReducer(state: SpeechPlaybackState, action: SpeechPlaybackAction): SpeechPlaybackState;
+/** Is THIS message the one currently being spoken? Drives one button's state. */
+export declare function isSpeakingMessage(state: SpeechPlaybackState, messageId: string): boolean;
+/**
+ * Does acting on `messageId` require cancelling what the engine is doing now?
+ *
+ * True whenever anything is playing — including the same message, where the tap
+ * means "stop". The caller cancels first, then speaks; that ordering is what
+ * makes "starting a new playback cancels the previous one" hold with a queue of
+ * utterances rather than a single one.
+ */
+export declare function requiresCancel(state: SpeechPlaybackState): boolean;
+//# sourceMappingURL=speechPlayback.d.ts.map

package/dist/shared/assistant/voice/speechPlayback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"speechPlayback.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/voice/speechPlayback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,MAAM,mBAAmB,GAC3B;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC3B;IACE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEN,MAAM,MAAM,oBAAoB;AAC9B,6DAA6D;AAC3D;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AACH,8EAA8E;GAC5E;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AACH,iFAAiF;GAC/E;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAC3B,qDAAqD;GACnD;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE;AAC3D,2DAA2D;GACzD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5D,eAAO,MAAM,aAAa,EAAE,mBAAwC,CAAC;AAErE,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,mBAAmB,EAC1B,MAAM,EAAE,oBAAoB,GAC3B,mBAAmB,CAgCrB;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,mBAAmB,EAC1B,SAAS,EAAE,MAAM,GAChB,OAAO,CAET;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAElE"}

package/dist/shared/assistant/voice/speechPlayback.js

@@ -0,0 +1,28 @@
+//#region src/shared/assistant/voice/speechPlayback.ts
+var e = { status: "idle" };
+function t(t, n) {
+	switch (n.type) {
+		case "start": return {
+			status: "speaking",
+			messageId: n.messageId,
+			requestId: n.requestId
+		};
+		case "toggle": return t.status === "speaking" && t.messageId === n.messageId ? e : {
+			status: "speaking",
+			messageId: n.messageId,
+			requestId: n.requestId
+		};
+		case "stop": return t.status === "idle" ? t : e;
+		case "finished":
+		case "failed": return t.status !== "speaking" || t.requestId !== n.requestId ? t : e;
+		default: return t;
+	}
+}
+function n(e, t) {
+	return e.status === "speaking" && e.messageId === t;
+}
+function r(e) {
+	return e.status === "speaking";
+}
+//#endregion
+export { e as IDLE_PLAYBACK, n as isSpeakingMessage, r as requiresCancel, t as speechPlaybackReducer };

package/dist/shared-assistant.js

@@ -26,4 +26,8 @@ import { toCaptionText as kt } from "./shared/assistant/voice/captionText.js";
 import { ASSISTANT_LANGUAGES as At, DEFAULT_SPEECH_RATE as jt, findAssistantLanguage as Mt, resolveAssistantLanguage as Nt } from "./shared/assistant/voice/languages.js";
 import { replyFollowsInput as Pt, resolveLanguagePair as Ft } from "./shared/assistant/voice/languagePair.js";
 import { findPendingWrite as It, parseConfirmationRefusal as Lt } from "./shared/assistant/pendingWrite.js";
-export { p as ASSISTANT_API_AUTH_STRATEGY, At as ASSISTANT_LANGUAGES, U as AssistantRuntimeManager, i as CHECK_AI_CREDITS, a as CREATE_SANDBOX, dt as DEFAULT_SPEAKABLE_LABELS, jt as DEFAULT_SPEECH_RATE, Re as ENDPOINT_GRACE_MS, o as EXTEND_SANDBOX_TTL, s as GET_ACTIVE_SANDBOXES, c as GET_SANDBOX, me as HOSTED_TTS_MAX_CHARS, ue as HOSTED_TTS_TIER, de as HOSTED_VOICES, ze as INITIAL_SESSION, Be as INTERRUPT_MAX_MS, Ve as INTERRUPT_MIN_MS, ft as MAX_SPEAKABLE_CHARS, pt as MAX_SPOKEN_TABLE_ROWS, Ct as POLL_FAST_MS, wt as POLL_FAST_UNTIL_MS, Tt as POLL_SLOW_MS, Et as POLL_STEADY_MS, Dt as POLL_STEADY_UNTIL_MS, xt as PREVIEW_LANGUAGES, l as PROXY_SANDBOX_REQUEST, u as REPORT_AI_TOKEN_USAGE, He as SILENCE_SUBMIT_MS, he as SPEAKING_RATE_MAX, ge as SPEAKING_RATE_MAX_STREAMING, _e as SPEAKING_RATE_MAX_SYNC, ve as SPEAKING_RATE_MIN, mt as SPEECH_CHUNK_CHARS, ht as SPEECH_CHUNK_CJK_CHARS, Xe as SPEECH_LANG, d as STOP_ASSISTANT_SANDBOX, Ze as VOICE_LIST_TIMEOUT_MS, f as WAIT_FOR_SANDBOX_RUNNING, ye as base64ToBytes, le as browserSpeechEngine, C as buildAssistantSandboxEnv, ct as buildContinuedFromVoiceNote, W as buildProgress, w as buildPromptRequestBody, be as buildRequest, t as buildSandboxContextInput, lt as buildVoiceTranscriptMarkdown, ne as chatTurns, T as checkAssistantAiCredits, gt as chunkForSpeech, xe as classifyHttpFailure, De as configureSpeechEngine, _t as containsCjk, E as createAssistantSandbox, D as createAssistantSession, Te as createHostedTtsEngine, Ee as createRoutingSpeechEngine, ee as createSandboxAssistantTransport, Oe as createSpeechEngines, Se as decodeAudioResponse, O as downloadAssistantArtifact, n as executeSandboxGraphQL, k as extendAssistantSandboxTTL, Mt as findAssistantLanguage, A as findExistingSandbox, It as findPendingWrite, j as getAssistantArtifacts, G as getAssistantMedia, M as getAssistantMessages, N as getAssistantSession, P as getAssistantStreamAccess, K as getAssistantText, y as getCapability, m as getImageForMode, h as getImageTagForMode, q as getRawMessageCreatedAt, g as getResourcesForMode, _ as getSandboxImageRegistry, ke as getSpeechEngine, J as getToolProgress, re as groupBySession, ie as groupConsecutiveBySession, fe as hostedLocaleFor, pe as hostedSupportsLanguage, Ue as isCapturing, We as isEcho, r as isQuotaExhaustedError, Y as isReapedSandboxConnectionError, X as isRecoverable, Qe as isSpeechBlocked, Ge as isSubmittable, b as isUnknownFieldError, ae as isVoiceTurn, $e as languageDisplayName, Z as mapSessionToHistory, x as markSupported, S as markUnsupported, Q as mergeMessagesById, Me as micIsInterrupt, F as modeRequiresConfirmWrites, et as normalizeLangTag, Ke as orbMode, Lt as parseConfirmationRefusal, qe as planReplyConsumption, Ot as pollDelayMs, tt as primaryLanguageSubtag, Ae as readSpeechEngineConfig, Pt as replyFollowsInput, I as reportAssistantAiTokenUsage, je as resetSpeechEngine, Nt as resolveAssistantLanguage, Ft as resolveLanguagePair, v as resolveSandboxAssistantMode, $ as sanitize, L as selectExistingAssistantSandbox, nt as selectVoiceForLocale, R as sendAssistantPromptAsync, z as sendHeartbeat, Ce as shouldDisableEngine, Ne as showsAssistantCaption, Pe as showsUserCaption, vt as speakableEmail, rt as speechGate, it as speechLangForLocale, we as splitForVendor, yt as splitTableRow, Je as spokenSoFar, B as stopReapedAssistantSandbox, kt as toCaptionText, bt as toSpeakableText, te as useSandboxAssistantTransport, e as useVoiceInput, at as voiceAvailability, oe as voiceMarker, St as voicePreviewText, ot as voiceQualityRank, se as voiceSessionIdOf, Ye as voiceSessionReducer, Fe as voiceStageState, ut as voiceTranscriptFilename, ce as voiceTurnsOnly, st as voicesForLocale, V as waitForAssistantServiceReady, H as waitForSandboxRunning, Ie as waveformIsActive, Le as waveformIsSettled };
+import { AssistantI18nProvider as Rt, assistantTranslationKey as zt, useAssistantI18nNamespace as Bt, useAssistantTr as Vt } from "./shared/assistant/i18n.js";
+import { SPOKEN_LABEL_LANGUAGES as Ht, speechLabelsFor as Ut } from "./shared/assistant/voice/speechLabels.js";
+import { detectScriptLocale as Wt, resolveSpeechLocale as Gt } from "./shared/assistant/voice/replyLanguage.js";
+import { IDLE_PLAYBACK as Kt, isSpeakingMessage as qt, requiresCancel as Jt, speechPlaybackReducer as Yt } from "./shared/assistant/voice/speechPlayback.js";
+export { p as ASSISTANT_API_AUTH_STRATEGY, At as ASSISTANT_LANGUAGES, Rt as AssistantI18nProvider, U as AssistantRuntimeManager, i as CHECK_AI_CREDITS, a as CREATE_SANDBOX, dt as DEFAULT_SPEAKABLE_LABELS, jt as DEFAULT_SPEECH_RATE, Re as ENDPOINT_GRACE_MS, o as EXTEND_SANDBOX_TTL, s as GET_ACTIVE_SANDBOXES, c as GET_SANDBOX, me as HOSTED_TTS_MAX_CHARS, ue as HOSTED_TTS_TIER, de as HOSTED_VOICES, Kt as IDLE_PLAYBACK, ze as INITIAL_SESSION, Be as INTERRUPT_MAX_MS, Ve as INTERRUPT_MIN_MS, ft as MAX_SPEAKABLE_CHARS, pt as MAX_SPOKEN_TABLE_ROWS, Ct as POLL_FAST_MS, wt as POLL_FAST_UNTIL_MS, Tt as POLL_SLOW_MS, Et as POLL_STEADY_MS, Dt as POLL_STEADY_UNTIL_MS, xt as PREVIEW_LANGUAGES, l as PROXY_SANDBOX_REQUEST, u as REPORT_AI_TOKEN_USAGE, He as SILENCE_SUBMIT_MS, he as SPEAKING_RATE_MAX, ge as SPEAKING_RATE_MAX_STREAMING, _e as SPEAKING_RATE_MAX_SYNC, ve as SPEAKING_RATE_MIN, mt as SPEECH_CHUNK_CHARS, ht as SPEECH_CHUNK_CJK_CHARS, Xe as SPEECH_LANG, Ht as SPOKEN_LABEL_LANGUAGES, d as STOP_ASSISTANT_SANDBOX, Ze as VOICE_LIST_TIMEOUT_MS, f as WAIT_FOR_SANDBOX_RUNNING, zt as assistantTranslationKey, ye as base64ToBytes, le as browserSpeechEngine, C as buildAssistantSandboxEnv, ct as buildContinuedFromVoiceNote, W as buildProgress, w as buildPromptRequestBody, be as buildRequest, t as buildSandboxContextInput, lt as buildVoiceTranscriptMarkdown, ne as chatTurns, T as checkAssistantAiCredits, gt as chunkForSpeech, xe as classifyHttpFailure, De as configureSpeechEngine, _t as containsCjk, E as createAssistantSandbox, D as createAssistantSession, Te as createHostedTtsEngine, Ee as createRoutingSpeechEngine, ee as createSandboxAssistantTransport, Oe as createSpeechEngines, Se as decodeAudioResponse, Wt as detectScriptLocale, O as downloadAssistantArtifact, n as executeSandboxGraphQL, k as extendAssistantSandboxTTL, Mt as findAssistantLanguage, A as findExistingSandbox, It as findPendingWrite, j as getAssistantArtifacts, G as getAssistantMedia, M as getAssistantMessages, N as getAssistantSession, P as getAssistantStreamAccess, K as getAssistantText, y as getCapability, m as getImageForMode, h as getImageTagForMode, q as getRawMessageCreatedAt, g as getResourcesForMode, _ as getSandboxImageRegistry, ke as getSpeechEngine, J as getToolProgress, re as groupBySession, ie as groupConsecutiveBySession, fe as hostedLocaleFor, pe as hostedSupportsLanguage, Ue as isCapturing, We as isEcho, r as isQuotaExhaustedError, Y as isReapedSandboxConnectionError, X as isRecoverable, qt as isSpeakingMessage, Qe as isSpeechBlocked, Ge as isSubmittable, b as isUnknownFieldError, ae as isVoiceTurn, $e as languageDisplayName, Z as mapSessionToHistory, x as markSupported, S as markUnsupported, Q as mergeMessagesById, Me as micIsInterrupt, F as modeRequiresConfirmWrites, et as normalizeLangTag, Ke as orbMode, Lt as parseConfirmationRefusal, qe as planReplyConsumption, Ot as pollDelayMs, tt as primaryLanguageSubtag, Ae as readSpeechEngineConfig, Pt as replyFollowsInput, I as reportAssistantAiTokenUsage, Jt as requiresCancel, je as resetSpeechEngine, Nt as resolveAssistantLanguage, Ft as resolveLanguagePair, v as resolveSandboxAssistantMode, Gt as resolveSpeechLocale, $ as sanitize, L as selectExistingAssistantSandbox, nt as selectVoiceForLocale, R as sendAssistantPromptAsync, z as sendHeartbeat, Ce as shouldDisableEngine, Ne as showsAssistantCaption, Pe as showsUserCaption, vt as speakableEmail, rt as speechGate, Ut as speechLabelsFor, it as speechLangForLocale, Yt as speechPlaybackReducer, we as splitForVendor, yt as splitTableRow, Je as spokenSoFar, B as stopReapedAssistantSandbox, kt as toCaptionText, bt as toSpeakableText, Bt as useAssistantI18nNamespace, Vt as useAssistantTr, te as useSandboxAssistantTransport, e as useVoiceInput, at as voiceAvailability, oe as voiceMarker, St as voicePreviewText, ot as voiceQualityRank, se as voiceSessionIdOf, Ye as voiceSessionReducer, Fe as voiceStageState, ut as voiceTranscriptFilename, ce as voiceTurnsOnly, st as voicesForLocale, V as waitForAssistantServiceReady, H as waitForSandboxRunning, Ie as waveformIsActive, Le as waveformIsSettled };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@burdenoff/fe-libs",
-  "version": "2026.903.10",
+  "version": "2026.904.2",
   "description": "Burdenoff frontend primitives and domain libraries",
   "type": "module",
   "bin": {