@burdenoff/fe-libs 2026.903.4 → 2026.903.5

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

@@ -21,4 +21,8 @@ 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;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,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/voice/assistantPollSchedule.d.ts

@@ -0,0 +1,38 @@
+/**
+ * How often to re-check for the assistant's reply while a turn is in flight.
+ *
+ * The assistant has no streaming transport: the prompt is a fire-and-forget POST
+ * and the reply is discovered by re-fetching the message list. So this interval
+ * is the granularity of the whole experience — it bounds how late the answer
+ * appears in chat AND how late speech can start, because auto-speak only fires
+ * once a poll observes the reply completed.
+ *
+ * A flat 1500ms was the previous behaviour, which meant up to 1.5s of dead time
+ * after the answer was already sitting on the server, and made streamed text
+ * arrive in visible jerks rather than flowing.
+ *
+ * ★ The schedule is a compromise, not free. Every poll re-fetches the newest
+ * messages in full rather than a delta, so a faster interval is a real increase
+ * in request rate. It is spent where it buys the most — the first few seconds,
+ * where most replies land — and given back afterwards, so a long-running turn
+ * costs no more than it used to.
+ *
+ * The proper fix is a delta fetch (`sinceMs`, which the shared client already
+ * supports) or a streaming transport; both are larger changes than this.
+ */
+/** While the answer is most likely to land. */
+export declare const POLL_FAST_MS = 600;
+/** Still active, but the cheap wins are gone. */
+export declare const POLL_STEADY_MS = 1000;
+/** Long-running turn: back to the original cadence. */
+export declare const POLL_SLOW_MS = 1500;
+export declare const POLL_FAST_UNTIL_MS = 6000;
+export declare const POLL_STEADY_UNTIL_MS = 20000;
+/**
+ * Delay before the next poll, given how long this turn has been running.
+ *
+ * `elapsedMs` is injected rather than read from a clock so the schedule is
+ * testable and cannot drift with a mocked timer.
+ */
+export declare function pollDelayMs(elapsedMs: number): number;
+//# sourceMappingURL=assistantPollSchedule.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assistantPollSchedule.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/voice/assistantPollSchedule.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,+CAA+C;AAC/C,eAAO,MAAM,YAAY,MAAM,CAAC;AAChC,iDAAiD;AACjD,eAAO,MAAM,cAAc,OAAO,CAAC;AACnC,uDAAuD;AACvD,eAAO,MAAM,YAAY,OAAO,CAAC;AAEjC,eAAO,MAAM,kBAAkB,OAAQ,CAAC;AACxC,eAAO,MAAM,oBAAoB,QAAS,CAAC;AAE3C;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAIrD"}

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

@@ -0,0 +1,36 @@
+import { AssistantLanguage } from './languages';
+export interface AssistantLanguagePair {
+    /** What the user speaks or types. Drives the recogniser. */
+    input: AssistantLanguage;
+    /** What the assistant answers in. Drives the prompt directive and the voice. */
+    reply: AssistantLanguage;
+    /**
+     * A human chose this reply language, rather than it being guessed.
+     *
+     * `buildLanguagePreamble` uses this to decide whether the language the user
+     * WROTE IN overrides their setting. For a guess it should — what they typed is
+     * better evidence than the interface language. For a choice it must not, or
+     * the preference is inert for everyone who types rather than dictates.
+     *
+     * ★ True when EITHER field was pinned, not only the reply field. Someone who
+     * picked Tamil before this setting existed has `replyLanguage` null and means
+     * "answer me in Tamil"; reading only the reply field would decide they never
+     * chose anything and hand their setting back to the mirror clause — silently
+     * re-breaking, for every existing user, the exact bug that clause was written
+     * to fix.
+     *
+     * False only when NOTHING was pinned and the language came from the interface.
+     *
+     * Resolved rather than merely non-null, so a stale persisted code from a build
+     * that offered more languages is not mistaken for a decision.
+     */
+    replyIsExplicit: boolean;
+}
+export declare function resolveLanguagePair(inputCode: string | null | undefined, replyCode: string | null | undefined, appLocale: string): AssistantLanguagePair;
+/**
+ * Does the reply language follow the input, or has it been pinned?
+ *
+ * The selector shows "Match my language" for the former, and it is the default.
+ */
+export declare function replyFollowsInput(replyCode: string | null | undefined): boolean;
+//# sourceMappingURL=languagePair.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"languagePair.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/voice/languagePair.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAmD,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEtG,MAAM,WAAW,qBAAqB;IACpC,4DAA4D;IAC5D,KAAK,EAAE,iBAAiB,CAAC;IACzB,gFAAgF;IAChF,KAAK,EAAE,iBAAiB,CAAC;IACzB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,SAAS,EAAE,MAAM,GAChB,qBAAqB,CAWvB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAE/E"}

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

@@ -0,0 +1,15 @@
+import { findAssistantLanguage as e, resolveAssistantLanguage as t } from "./languages.js";
+//#region src/shared/assistant/voice/languagePair.ts
+function n(n, r, i) {
+	let a = t(n, i), o = e(r);
+	return {
+		input: a,
+		reply: o ?? a,
+		replyIsExplicit: o !== null || e(n) !== null
+	};
+}
+function r(t) {
+	return e(t) === null;
+}
+//#endregion
+export { r as replyFollowsInput, n as resolveLanguagePair };

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

@@ -0,0 +1,74 @@
+/**
+ * The language the user is TALKING TO the assistant in (BOFF-7108).
+ *
+ * Separate from the app locale on purpose. A farmer whose phone and UI are in
+ * English may well speak Tamil, and until now the only way to dictate Tamil was
+ * to translate the entire interface — the recogniser language was derived from
+ * `useI18n().locale`, so the two could not be chosen independently.
+ *
+ * One selection drives three things, which is the point:
+ *   1. `recognition.lang` — what the recogniser is listening for;
+ *   2. the reply-language directive — what the model answers in;
+ *   3. the voice for reading that reply aloud.
+ *
+ * Deliberately NOT keyed on the app `Locale` union. That union is the set of
+ * languages the INTERFACE is translated into (9, from fe-libs); this is the set
+ * of languages a user might SPEAK, which is larger and grows for different
+ * reasons. Tying them together is what created the problem.
+ */
+export interface AssistantLanguage {
+    /** Primary subtag. What we persist, and what the speech-locale helpers take. */
+    code: string;
+    /** BCP-47 tag handed to the Web Speech APIs — region matters to acoustic models. */
+    tag: string;
+    /**
+     * The ENDONYM — what a speaker calls their own language. Someone who reads
+     * only Tamil cannot find "Tamil" in a list; they can find "தமிழ்".
+     */
+    label: string;
+    /**
+     * English name, for the model-facing directive.
+     *
+     * Hardcoded rather than derived from `Intl.DisplayNames` because this string
+     * goes into a prompt: it must be stable and correct regardless of the reader's
+     * browser, and a missing `Intl` implementation must not silently degrade an
+     * instruction into a bare subtag the model may answer *about* instead of *in*.
+     */
+    english: string;
+    /**
+     * Speaking rate for this language, 1 = the engine's default.
+     *
+     * Nothing set a rate at all until now, so every user heard the spec default of
+     * 1.0 — reported as "it reads fast", which it is: a synthesised voice at 1.0 is
+     * harder to follow than a person at the same nominal speed, and harder again
+     * when the listener is outdoors or hearing a second language.
+     *
+     * Indic and Arabic get a further reduction. Their scripts pack more syllables
+     * per character than Latin, so the same nominal rate delivers noticeably more
+     * speech per second.
+     */
+    rate?: number;
+}
+/** Applied when a language does not override it. */
+export declare const DEFAULT_SPEECH_RATE = 0.9;
+/**
+ * India first and by speaker count, then the other app locales.
+ *
+ * Regions follow where HealthyBowl operates: `-IN` for the Indic languages,
+ * because a recogniser tuned for `ur-PK` or a voice for `bn-BD` is the wrong
+ * pronunciation model for this product's users.
+ */
+export declare const ASSISTANT_LANGUAGES: readonly AssistantLanguage[];
+export declare function findAssistantLanguage(code: string | null | undefined): AssistantLanguage | null;
+/**
+ * Which language to use: the user's explicit choice, else the app locale, else
+ * English.
+ *
+ * The app-locale step is what keeps this backwards-compatible — a user who never
+ * touches the new control behaves exactly as before, because the value derived
+ * is the one the old code derived. An app locale outside this list (or a stale
+ * persisted code from a build that offered more) degrades to English rather than
+ * handing the recogniser a tag it will reject.
+ */
+export declare function resolveAssistantLanguage(selectedCode: string | null | undefined, appLocale: string): AssistantLanguage;
+//# sourceMappingURL=languages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"languages.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/voice/languages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,iBAAiB;IAChC,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,oFAAoF;IACpF,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;;OAOG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,oDAAoD;AACpD,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAGvC;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,iBAAiB,EAkB3D,CAAC;AAOF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,iBAAiB,GAAG,IAAI,CAG/F;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACvC,SAAS,EAAE,MAAM,GAChB,iBAAiB,CAEnB"}

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

@@ -0,0 +1,124 @@
+//#region src/shared/assistant/voice/languages.ts
+var e = .85, t = [
+	{
+		code: "en",
+		tag: "en-IN",
+		label: "English",
+		english: "English"
+	},
+	{
+		code: "hi",
+		tag: "hi-IN",
+		label: "हिन्दी",
+		english: "Hindi",
+		rate: e
+	},
+	{
+		code: "bn",
+		tag: "bn-IN",
+		label: "বাংলা",
+		english: "Bengali",
+		rate: e
+	},
+	{
+		code: "te",
+		tag: "te-IN",
+		label: "తెలుగు",
+		english: "Telugu",
+		rate: e
+	},
+	{
+		code: "mr",
+		tag: "mr-IN",
+		label: "मराठी",
+		english: "Marathi",
+		rate: e
+	},
+	{
+		code: "ta",
+		tag: "ta-IN",
+		label: "தமிழ்",
+		english: "Tamil",
+		rate: e
+	},
+	{
+		code: "gu",
+		tag: "gu-IN",
+		label: "ગુજરાતી",
+		english: "Gujarati",
+		rate: e
+	},
+	{
+		code: "kn",
+		tag: "kn-IN",
+		label: "ಕನ್ನಡ",
+		english: "Kannada",
+		rate: e
+	},
+	{
+		code: "ml",
+		tag: "ml-IN",
+		label: "മലയാളം",
+		english: "Malayalam",
+		rate: e
+	},
+	{
+		code: "pa",
+		tag: "pa-IN",
+		label: "ਪੰਜਾਬੀ",
+		english: "Punjabi",
+		rate: e
+	},
+	{
+		code: "ur",
+		tag: "ur-IN",
+		label: "اردو",
+		english: "Urdu",
+		rate: e
+	},
+	{
+		code: "ar",
+		tag: "ar-SA",
+		label: "العربية",
+		english: "Arabic",
+		rate: e
+	},
+	{
+		code: "es",
+		tag: "es-ES",
+		label: "Español",
+		english: "Spanish"
+	},
+	{
+		code: "fr",
+		tag: "fr-FR",
+		label: "Français",
+		english: "French"
+	},
+	{
+		code: "de",
+		tag: "de-DE",
+		label: "Deutsch",
+		english: "German"
+	},
+	{
+		code: "zh",
+		tag: "zh-CN",
+		label: "中文",
+		english: "Chinese"
+	},
+	{
+		code: "ja",
+		tag: "ja-JP",
+		label: "日本語",
+		english: "Japanese"
+	}
+], n = new Map(t.map((e) => [e.code, e])), r = n.get("en");
+function i(e) {
+	return e ? n.get(e.trim().toLowerCase().split("-")[0]) ?? null : null;
+}
+function a(e, t) {
+	return i(e) ?? i(t) ?? r;
+}
+//#endregion
+export { t as ASSISTANT_LANGUAGES, i as findAssistantLanguage, a as resolveAssistantLanguage };

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

@@ -0,0 +1,121 @@
+/**
+ * Markdown → speakable plain text (BOFF-6290, assistant voice reply).
+ *
+ * An assistant reply is Markdown: headings, tables, fenced code, links, list
+ * markers, the odd emoji. Handing that string straight to a speech engine reads
+ * out "asterisk asterisk yield asterisk asterisk", spells URLs character by
+ * character, and grinds through a forty-row table one pipe at a time. This
+ * module flattens a reply into something a person would actually say.
+ *
+ * Design notes:
+ *
+ *  - **Pure, and deliberately so.** This repo's vitest runs in the `node`
+ *    environment (no jsdom), so audio and DOM behaviour are not testable here.
+ *    The transformation is where the real logic lives, so it is isolated as a
+ *    pure function with no imports and covered directly by `speakableText.test.ts`.
+ *  - **Copy comes in through `labels`**, not `useTr`, so the function stays pure
+ *    and the spoken placeholders still follow the app locale (the hook passes
+ *    translated strings in). `{{rows}}` / `{{columns}}` interpolate the same way
+ *    `useTr` params do.
+ *  - **No lookbehind assertions.** Safari < 16.4 throws at *parse* time on a
+ *    lookbehind, which would take down the whole module — the same trap the
+ *    old hand-rolled markdown renderer fell into (see AssistantMarkdownRenderer).
+ *    Every rule below uses a captured prefix or a lookahead instead.
+ */
+export interface SpeakableLabels {
+    /** Spoken in place of a fenced code block, which is unlistenable read out. */
+    codeBlock: string;
+    /** Spoken for an image with no alt text. */
+    image: string;
+    /** Spoken in place of a URL — nobody wants "h t t p s colon slash slash". */
+    link: string;
+    /** Spoken in place of a table too large to read. Params: rows, columns. */
+    largeTable: string;
+    /** Appended when a very long reply is cut short. */
+    truncated: string;
+    /** Spoken for `@` in an address. English "at" inside a Tamil reply is jarring. */
+    emailAt: string;
+    /** Spoken for `.` in an address. */
+    emailDot: string;
+    /**
+     * Prefix for a numbered item nested under an UNnumbered one. Param: ordinal.
+     *
+     * Nested ordered items normally read as a dotted path ("2.1.") which already
+     * says where the sub-steps are; that is impossible when the parent is a
+     * bullet and has no number of its own, so the level is named instead.
+     */
+    nestedItem: string;
+}
+/**
+ * Sentence punctuation is deliberately absent: block-level labels get a full
+ * stop from `asSentence`, and the inline ones ("link", "image") have to read
+ * naturally mid-sentence — "see link for details", not "see Link. for details".
+ */
+export declare const DEFAULT_SPEAKABLE_LABELS: SpeakableLabels;
+/**
+ * Tables at or below this many body rows are flattened into "header: value"
+ * sentences, because a 2×3 table is usually THE answer. Anything larger is
+ * summarised — the point of the limit is that a long table is unlistenable, not
+ * that tables are unimportant.
+ */
+export declare const MAX_SPOKEN_TABLE_ROWS = 3;
+/** Roughly ten minutes of speech. Past this the reply is summarised as cut off. */
+export declare const MAX_SPEAKABLE_CHARS = 8000;
+/**
+ * Utterances are split at about this length before being queued.
+ *
+ * Chrome (and Edge) silently stop a single `SpeechSynthesisUtterance` after
+ * roughly fifteen seconds — a long-standing engine bug, not something we can
+ * feature-detect. Queueing sentence-sized utterances keeps every one of them
+ * well under that ceiling, so a long reply finishes instead of dying mid-word.
+ */
+export declare const SPEECH_CHUNK_CHARS = 180;
+/**
+ * Chunk ceiling for Chinese and Japanese, in CHARACTERS.
+ *
+ * The limit above is sized for Latin text, where ~180 characters is ~30 words
+ * and lands around ten seconds. A CJK character is a whole syllable — a zh voice
+ * reads roughly 4–6 of them a second — so 180 of them is a minute of speech,
+ * four times past the very cut-off the chunking exists to dodge. 40 characters
+ * is ~7–10 seconds, the same target the Latin limit is aiming at.
+ */
+export declare const SPEECH_CHUNK_CJK_CHARS = 40;
+export interface SpeakableOptions {
+    labels?: Partial<SpeakableLabels>;
+    maxChars?: number;
+    maxSpokenTableRows?: number;
+}
+/**
+ * Split a GFM table row into cells, honouring `\|` escapes.
+ *
+ * Written as a scan rather than `split(/(?<!\\)\|/)` on purpose — see the
+ * no-lookbehind note at the top of the file.
+ */
+export declare function splitTableRow(line: string): string[];
+/**
+ * Say an address the way a person reads one out.
+ *
+ * "support at healthybowl dot com" — an engine handed the raw string either
+ * spells it or swallows the punctuation, and expanding the dots here also keeps
+ * the sentence splitter from mistaking `.com` for the end of a sentence.
+ */
+export declare function speakableEmail(address: string, at?: string, dot?: string): string;
+/**
+ * Convert an assistant reply (Markdown) into plain text worth speaking.
+ *
+ * Returns `''` when there is nothing speakable — the caller should treat that
+ * as "no speak control", not as an error.
+ */
+export declare function toSpeakableText(markdown: string, options?: SpeakableOptions): string;
+/** Does this text need CJK treatment? True for mixed "土壤 pH 6.5" text too. */
+export declare function containsCjk(text: string): boolean;
+/**
+ * Split speakable text into utterance-sized chunks.
+ *
+ * See SPEECH_CHUNK_CHARS: this exists to dodge Chrome's ~15 second single
+ * utterance cut-off, so the split points are sentence boundaries (a pause the
+ * listener expects) rather than an arbitrary character offset. A CJK sentence
+ * gets the tighter CJK ceiling, because a character there is a whole syllable.
+ */
+export declare function chunkForSpeech(text: string, maxChars?: number, cjkMaxChars?: number): string[];
+//# sourceMappingURL=speakableText.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"speakableText.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/voice/speakableText.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,kFAAkF;IAClF,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,eAStC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,mFAAmF;AACnF,eAAO,MAAM,mBAAmB,OAAQ,CAAC;AAEzC;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AA6CD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAsBpD;AAkBD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,SAAO,EAAE,GAAG,SAAQ,GAAG,MAAM,CAE9E;AAqJD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,MAAM,CAiJxF;AAiMD,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAkFD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAA2B,EACrC,WAAW,GAAE,MAA+B,GAC3C,MAAM,EAAE,CAoEV"}

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

@@ -0,0 +1,33 @@
+/**
+ * What a voice says when you audition it.
+ *
+ * Picking a voice used to be silent: you chose one, nothing happened, and the
+ * first time you heard it was after asking the assistant a real question and
+ * waiting out a round trip. Auditioning a voice should not cost a model call.
+ *
+ * ★ The sample is in the SPOKEN language, not the interface language. A voice is
+ * being judged on how it reads Tamil, so making it read English tells the
+ * listener nothing about the decision they are making — and the two are
+ * independent settings here anyway.
+ *
+ * ★ Carried as a static table rather than through `tr()`, for the same reason
+ * `speechLabels` is: the i18n provider only ever fetches the ACTIVE locale, so
+ * there is nothing to ask for a Tamil string while the interface is English.
+ * These are one short sentence each and they are needed synchronously.
+ *
+ * Deliberately short. Long enough to hear timbre and cadence, short enough that
+ * auditioning four voices is not a chore, and it names the product so the
+ * listener hears the one word this voice will say most often.
+ */
+/**
+ * The audition sentence for a locale.
+ *
+ * Falls back to English rather than to silence: a voice the listener can hear
+ * saying the wrong language still answers "what does this voice sound like",
+ * which is the question being asked. Region subtags are ignored — `ta-IN` and
+ * `ta-LK` want the same sentence.
+ */
+export declare function voicePreviewText(locale: string): string;
+/** Exposed for tests: which languages have their own audition sentence. */
+export declare const PREVIEW_LANGUAGES: string[];
+//# sourceMappingURL=voicePreview.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"voicePreview.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/voice/voicePreview.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAsBH;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB,UAAmC,CAAC"}

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

@@ -0,0 +1,49 @@
+import { VoiceTranscriptTurn } from './turnVisibility';
+/**
+ * The spoken conversation as a Markdown document.
+ *
+ * ★ Sessions become headings rather than one flat list. A transcript is read
+ * later, when "which day was that?" is the actual question — running three
+ * separate exchanges together is precisely what the session id was added to
+ * stop, and a saved file is the copy most likely to outlive anyone's memory of
+ * the order.
+ *
+ * ★ Markdown, not JSON. The audience is a person forwarding a spoken exchange to
+ * an agronomist or an insurer; the whole-conversation JSON export already exists
+ * for anything machine-shaped.
+ */
+export declare function buildVoiceTranscriptMarkdown(turns: readonly VoiceTranscriptTurn[], labels: {
+    title: string;
+    savedAt: string;
+    session: string;
+    earlier: string;
+    you: string;
+    assistant: string;
+}, now: Date): string;
+/** A filename that sorts by date and never collides across a single day. */
+export declare function voiceTranscriptFilename(now: Date): string;
+/**
+ * The note that "Continue in chat" leaves in the typed thread.
+ *
+ * ★ It carries the user's QUESTIONS and none of the assistant's answers, capped
+ * at three. The spec asks for "a concise summary rather than dumping every voice
+ * turn", and the answers are the long half — they are one click away in the
+ * transcript, and pasting them into the thread would be the exact leak the
+ * surfaces were split to prevent.
+ *
+ * ★ Built from the user's own words rather than by asking the model. A generated
+ * summary costs a round trip and can be wrong about what someone asked; their
+ * own sentences, clipped, cannot be. This also makes the action instant and
+ * free, which matters for a control people will press to get out of a voice
+ * session.
+ *
+ * ★ It tells the MODEL nothing, and does not need to. The client sends no
+ * history — the backend session already holds every spoken turn — so this note
+ * exists purely so the human can see, in the thread, what was discussed.
+ */
+export declare function buildContinuedFromVoiceNote(turns: readonly VoiceTranscriptTurn[], labels: {
+    intro: string;
+    nothing: string;
+    more: (count: number) => string;
+}): string;
+//# sourceMappingURL=voiceTranscript.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"voiceTranscript.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/voice/voiceTranscript.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAgCvF;;;;;;;;;;;;GAYG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,SAAS,mBAAmB,EAAE,EACrC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAC5G,GAAG,EAAE,IAAI,GACR,MAAM,CA8BR;AAED,4EAA4E;AAC5E,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,IAAI,GAAG,MAAM,CAIzD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,SAAS,mBAAmB,EAAE,EACrC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;CAAE,GAC1E,MAAM,CAaR"}

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

@@ -0,0 +1,42 @@
+import { groupConsecutiveBySession as e } from "./turnVisibility.js";
+//#region src/shared/assistant/voice/voiceTranscript.ts
+var t = 3, n = 80;
+function r(e, t) {
+	let n = e.replace(/\s+/g, " ").trim();
+	if (n.length <= t) return n;
+	let r = n.slice(0, t), i = r.lastIndexOf(" ");
+	return `${(i > t * .6 ? r.slice(0, i) : r).trimEnd()}…`;
+}
+function i(e) {
+	let t = new Date(e);
+	return Number.isNaN(t.getTime()) ? "" : t.toLocaleTimeString(void 0, {
+		hour: "2-digit",
+		minute: "2-digit"
+	});
+}
+function a(t, n, r) {
+	let a = e(t, (e) => e.sessionId), o = [
+		`# ${n.title}`,
+		"",
+		`_${n.savedAt}: ${r.toLocaleString()}_`,
+		""
+	], s = 0;
+	return a.forEach((e) => {
+		e.sessionId ? (s += 1, o.push(`## ${n.session} ${s}`, "")) : o.push(`## ${n.earlier}`, "");
+		for (let t of e.turns) {
+			let e = t.role === "user" ? n.you : n.assistant, r = i(t.timestamp);
+			o.push(r ? `**${e}** (${r})` : `**${e}**`, "", t.text.trim(), "");
+		}
+	}), `${o.join("\n").trimEnd()}\n`;
+}
+function o(e) {
+	return `healthybowl-voice-${`${e.getFullYear()}-${String(e.getMonth() + 1).padStart(2, "0")}-${String(e.getDate()).padStart(2, "0")}`}-${`${String(e.getHours()).padStart(2, "0")}${String(e.getMinutes()).padStart(2, "0")}`}.md`;
+}
+function s(e, i) {
+	let a = e.filter((e) => e.role === "user" && e.text.trim()).map((e) => e.text);
+	if (a.length === 0) return i.nothing;
+	let o = a.slice(-t), s = a.length - o.length, c = [i.intro, ...o.map((e) => `• ${r(e, n)}`)];
+	return s > 0 && c.push(i.more(s)), c.join("\n");
+}
+//#endregion
+export { s as buildContinuedFromVoiceNote, a as buildVoiceTranscriptMarkdown, o as voiceTranscriptFilename };

package/dist/shared-assistant.js

@@ -9,4 +9,7 @@ import { chatTurns as D, groupBySession as O, groupConsecutiveBySession as k, is
 import { toCaptionText as P } from "./shared/assistant/voice/captionText.js";
 import { findPendingWrite as F, parseConfirmationRefusal as I } from "./shared/assistant/pendingWrite.js";
 import { createSpeechEngines as L } from "./shared/assistant/speech/createSpeechEngine.js";
-export { v as AssistantRuntimeManager, y as buildProgress, n as buildPromptRequestBody, D as chatTurns, r as checkAssistantAiCredits, i as createAssistantSandbox, a as createAssistantSession, T as createSandboxAssistantTransport, L as createSpeechEngines, o as downloadAssistantArtifact, s as extendAssistantSandboxTTL, c as findExistingSandbox, F as findPendingWrite, l as getAssistantArtifacts, b as getAssistantMedia, u as getAssistantMessages, d as getAssistantSession, f as getAssistantStreamAccess, O as groupBySession, k as groupConsecutiveBySession, t as isQuotaExhaustedError, x as isRecoverable, A as isVoiceTurn, S as mapSessionToHistory, C as mergeMessagesById, I as parseConfirmationRefusal, p as reportAssistantAiTokenUsage, w as sanitize, m as sendAssistantPromptAsync, h as sendHeartbeat, P as toCaptionText, E as useSandboxAssistantTransport, e as useVoiceInput, j as voiceMarker, M as voiceSessionIdOf, N as voiceTurnsOnly, g as waitForAssistantServiceReady, _ as waitForSandboxRunning };
+import { buildContinuedFromVoiceNote as R, buildVoiceTranscriptMarkdown as z, voiceTranscriptFilename as B } from "./shared/assistant/voice/voiceTranscript.js";
+import { ASSISTANT_LANGUAGES as V, findAssistantLanguage as H, resolveAssistantLanguage as U } from "./shared/assistant/voice/languages.js";
+import { replyFollowsInput as W, resolveLanguagePair as G } from "./shared/assistant/voice/languagePair.js";
+export { V as ASSISTANT_LANGUAGES, v as AssistantRuntimeManager, R as buildContinuedFromVoiceNote, y as buildProgress, n as buildPromptRequestBody, z as buildVoiceTranscriptMarkdown, D as chatTurns, r as checkAssistantAiCredits, i as createAssistantSandbox, a as createAssistantSession, T as createSandboxAssistantTransport, L as createSpeechEngines, o as downloadAssistantArtifact, s as extendAssistantSandboxTTL, H as findAssistantLanguage, c as findExistingSandbox, F as findPendingWrite, l as getAssistantArtifacts, b as getAssistantMedia, u as getAssistantMessages, d as getAssistantSession, f as getAssistantStreamAccess, O as groupBySession, k as groupConsecutiveBySession, t as isQuotaExhaustedError, x as isRecoverable, A as isVoiceTurn, S as mapSessionToHistory, C as mergeMessagesById, I as parseConfirmationRefusal, W as replyFollowsInput, p as reportAssistantAiTokenUsage, U as resolveAssistantLanguage, G as resolveLanguagePair, w as sanitize, m as sendAssistantPromptAsync, h as sendHeartbeat, P as toCaptionText, E as useSandboxAssistantTransport, e as useVoiceInput, j as voiceMarker, M as voiceSessionIdOf, B as voiceTranscriptFilename, N as voiceTurnsOnly, g as waitForAssistantServiceReady, _ as waitForSandboxRunning };

package/package.json

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