@burdenoff/fe-libs 2026.1004.8 → 2026.1005.2

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

@@ -50,5 +50,26 @@ export declare function isUnknownFieldError(error: unknown): boolean;
  *   found" and "404" are deliberately not matched here.
  */
 export declare function isMissingGatewayFieldError(error: unknown, field: string, typeNames?: readonly string[]): boolean;
+/**
+ * ★★ BOFF-7914 (speed S3): the turn stream's OWN mint backoff, separate from the
+ * `sse` capability above. `getAssistantStreamAccess` (the widget transport's
+ * mint) latches `sse: unsupported` for the page on any failure; this one must
+ * not: a mint that answered 404 because the relay is off in prod, or failed
+ * once on a bad network, is retried after a pause, and never disables the
+ * stream for the rest of the page (design rule 6).
+ *
+ * - a 404 (relay off, product not allowlisted, bridge without the projection)
+ *   backs off 5 minutes: it is a deployment answer, not a blip;
+ * - any other failure backs off 60 seconds;
+ * - a success clears it.
+ *
+ * Per page load, like every capability here. It only ever LENGTHENS a backoff.
+ */
+export declare const STREAM_MINT_BACKOFF_UNAVAILABLE_MS: number;
+export declare const STREAM_MINT_BACKOFF_ERROR_MS = 60000;
+/** Is a mint inside its backoff window? */
+export declare function streamMintBackedOff(now?: number): boolean;
+export declare function backOffStreamMint(ms: number, now?: number): void;
+export declare function clearStreamMintBackoff(): void;
 export {};
 //# sourceMappingURL=capabilities.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../../src/shared/assistant/capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,WAAW,GAAG,aAAa,CAAC;AAEtE,UAAU,qBAAqB;IAC7B,qBAAqB,EAAE,eAAe,CAAC;IACvC,UAAU,EAAE,eAAe,CAAC;IAC5B,GAAG,EAAE,eAAe,CAAC;IACrB;;;OAGG;IACH,WAAW,EAAE,eAAe,CAAC;IAC7B;;;;OAIG;IACH,yBAAyB,EAAE,eAAe,CAAC;IAC3C,sBAAsB,EAAE,eAAe,CAAC;IACxC,2BAA2B,EAAE,eAAe,CAAC;CAC9C;AAYD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,qBAAqB,GAAG,eAAe,CAE/E;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,qBAAqB,GAAG,IAAI,CAEpE;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,qBAAqB,GAAG,IAAI,CAEtE;AAED,8EAA8E;AAC9E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAK3D;AAID;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,SAAS,MAAM,EAAO,GAChC,OAAO,CAWT"}
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../../src/shared/assistant/capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,WAAW,GAAG,aAAa,CAAC;AAEtE,UAAU,qBAAqB;IAC7B,qBAAqB,EAAE,eAAe,CAAC;IACvC,UAAU,EAAE,eAAe,CAAC;IAC5B,GAAG,EAAE,eAAe,CAAC;IACrB;;;OAGG;IACH,WAAW,EAAE,eAAe,CAAC;IAC7B;;;;OAIG;IACH,yBAAyB,EAAE,eAAe,CAAC;IAC3C,sBAAsB,EAAE,eAAe,CAAC;IACxC,2BAA2B,EAAE,eAAe,CAAC;CAC9C;AAYD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,qBAAqB,GAAG,eAAe,CAE/E;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,qBAAqB,GAAG,IAAI,CAEpE;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,qBAAqB,GAAG,IAAI,CAEtE;AAED,8EAA8E;AAC9E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAK3D;AAID;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,SAAS,MAAM,EAAO,GAChC,OAAO,CAWT;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,kCAAkC,QAAa,CAAC;AAC7D,eAAO,MAAM,4BAA4B,QAAS,CAAC;AAInD,2CAA2C;AAC3C,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAmB,GAAG,OAAO,CAErE;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,IAAI,CAE5E;AAED,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}

package/dist/shared/assistant/capabilities.js

@@ -27,5 +27,15 @@ function s(t, n, r = []) {
 	let i = t instanceof Error ? t.message : String(t), a = (e) => `["'\u201C]${o(e)}["'\u201D]`;
 	return /missing @rbac directive/i.test(i) ? RegExp(`Field ${a(n)}`).test(i) ? !0 : e(t).some((e) => e.code === "FORBIDDEN" && e.field === n) : RegExp(`Cannot query field ${a(n)}`).test(i) ? !0 : r.some((e) => RegExp(`Unknown type ${a(e)}`).test(i));
 }
+var c = 5 * 6e4, l = 6e4, u = 0;
+function d(e = Date.now()) {
+	return e < u;
+}
+function f(e, t = Date.now()) {
+	u = Math.max(u, t + e);
+}
+function p() {
+	u = 0;
+}
 //#endregion
-export { n as getCapability, s as isMissingGatewayFieldError, a as isUnknownFieldError, r as markSupported, i as markUnsupported };
+export { l as STREAM_MINT_BACKOFF_ERROR_MS, c as STREAM_MINT_BACKOFF_UNAVAILABLE_MS, f as backOffStreamMint, p as clearStreamMintBackoff, n as getCapability, s as isMissingGatewayFieldError, a as isUnknownFieldError, r as markSupported, i as markUnsupported, d as streamMintBackedOff };

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

@@ -402,6 +402,8 @@ export declare const ASSISTANT_I18N_LITERAL_COPY: {
     readonly "voice.graceLabel": "Wait after I stop talking";
     readonly "voice.graceOption": "{{seconds}} seconds";
     readonly "voice.graceOptionDefault": "{{seconds}} seconds (default)";
+    readonly "voice.handsFreeHint": "Let the assistant listen while it answers, so you can speak over it to correct it. Works best with headphones. You can always tap to interrupt.";
+    readonly "voice.handsFreeLabel": "Hands-free interrupt (beta)";
     readonly "voice.languageFollowApp": "Same as interface";
     readonly "voice.languageLabel": "Language you speak to the assistant";
     readonly "voice.languageNotSupported": "This browser cannot recognise spoken {{language}}. Try a different browser, or type instead.";
@@ -440,6 +442,8 @@ export declare const ASSISTANT_I18N_LITERAL_COPY: {
     readonly "voiceSession.newSession": "New voice session";
     readonly "voiceSession.noSpeechSupport": "This browser cannot listen. Try a different browser, or type instead.";
     readonly "voiceSession.noVoiceSupport": "This device has no voice that can speak this language.";
+    readonly "voiceSession.noticeHandsFreeFallback": "Hands-free interrupt turned itself off for this conversation. Tap to interrupt still works.";
+    readonly "voiceSession.noticeHandsFreeNothingHeard": "Stopped, but I did not catch that. Say it again, or tap to replay.";
     readonly "voiceSession.noticeNetwork": "Speech recognition lost its connection. Check your network — it will retry.";
     readonly "voiceSession.noticeNotCapturing": "The microphone did not start. Check that this site is allowed to use it, then try again.";
     readonly "voiceSession.noticeNothingHeard": "Nothing heard yet. Check your microphone is not muted or in use by another app.";

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

@@ -1 +1 @@
-{"version":3,"file":"i18nManifest.d.ts","sourceRoot":"","sources":["../../../src/shared/assistant/i18nManifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAa1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0GG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAodG,CAAC;AAE5C,mDAAmD;AACnD,MAAM,MAAM,uBAAuB,GAAG,MAAM,OAAO,2BAA2B,CAAC;AAW/E;;;GAGG;AACH,eAAO,MAAM,4BAA4B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgCtE,CAAC;AAEL;;;;GAIG;AACH,eAAO,MAAM,+BAA+B;;EAGjC,CAAC;AAEZ;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKjE,CAAC;AAEL,kEAAkE;AAClE,MAAM,MAAM,uBAAuB,GAAG,IAAI,CACxC,mBAAmB,EACnB,IAAI,GAAG,OAAO,GAAG,mBAAmB,CACrC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,SAAS,uBAAuB,EAAE,GACxC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAexB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC1C,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC9C,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiCzB"}
+{"version":3,"file":"i18nManifest.d.ts","sourceRoot":"","sources":["../../../src/shared/assistant/i18nManifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAa1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0GG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2dG,CAAC;AAE5C,mDAAmD;AACnD,MAAM,MAAM,uBAAuB,GAAG,MAAM,OAAO,2BAA2B,CAAC;AAW/E;;;GAGG;AACH,eAAO,MAAM,4BAA4B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgCtE,CAAC;AAEL;;;;GAIG;AACH,eAAO,MAAM,+BAA+B;;EAGjC,CAAC;AAEZ;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKjE,CAAC;AAEL,kEAAkE;AAClE,MAAM,MAAM,uBAAuB,GAAG,IAAI,CACxC,mBAAmB,EACnB,IAAI,GAAG,OAAO,GAAG,mBAAmB,CACrC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,SAAS,uBAAuB,EAAE,GACxC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAexB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC1C,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC9C,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiCzB"}

package/dist/shared/assistant/i18nManifest.js

@@ -300,6 +300,8 @@ var p = {
 	"voice.graceLabel": "Wait after I stop talking",
 	"voice.graceOption": "{{seconds}} seconds",
 	"voice.graceOptionDefault": "{{seconds}} seconds (default)",
+	"voice.handsFreeHint": "Let the assistant listen while it answers, so you can speak over it to correct it. Works best with headphones. You can always tap to interrupt.",
+	"voice.handsFreeLabel": "Hands-free interrupt (beta)",
 	"voice.languageFollowApp": "Same as interface",
 	"voice.languageLabel": "Language you speak to the assistant",
 	"voice.languageNotSupported": "This browser cannot recognise spoken {{language}}. Try a different browser, or type instead.",
@@ -338,6 +340,8 @@ var p = {
 	"voiceSession.newSession": "New voice session",
 	"voiceSession.noSpeechSupport": "This browser cannot listen. Try a different browser, or type instead.",
 	"voiceSession.noVoiceSupport": "This device has no voice that can speak this language.",
+	"voiceSession.noticeHandsFreeFallback": "Hands-free interrupt turned itself off for this conversation. Tap to interrupt still works.",
+	"voiceSession.noticeHandsFreeNothingHeard": "Stopped, but I did not catch that. Say it again, or tap to replay.",
 	"voiceSession.noticeNetwork": "Speech recognition lost its connection. Check your network — it will retry.",
 	"voiceSession.noticeNotCapturing": "The microphone did not start. Check that this site is allowed to use it, then try again.",
 	"voiceSession.noticeNothingHeard": "Nothing heard yet. Check your microphone is not muted or in use by another app.",

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

@@ -51,6 +51,21 @@ export * from './voice/voiceStatus';
 export * from './voice/rotationClock';
 export * from './voice/voiceSession';
 export * from './voice/handsFree';
+export * from './voice/handsfree/audioTrackTransport';
+export * from './voice/handsfree/backendStreamTransport';
+export * from './voice/handsfree/bargeIn';
+export * from './voice/handsfree/captureWorklet';
+export * from './voice/handsfree/echoGate';
+export * from './voice/handsfree/handsFreeController';
+export * from './voice/handsfree/handsFreeRuntime';
+export * from './voice/handsfree/handsFreeSetting';
+export * from './voice/handsfree/micCapture';
+export * from './voice/handsfree/playbackReference';
+export * from './voice/handsfree/preRollRing';
+export * from './voice/handsfree/sttTransport';
+export * from './voice/handsfree/useHandsFreeInterrupt';
+export * from './voice/handsfree/vad';
+export * from './voice/handsfree/webSpeechTransport';
 export * from './voice/affirmations';
 export * from './voice/supersededTurns';
 export * from './voice/speechVoices';
@@ -143,6 +158,7 @@ export * from './ui/composer/AssistantModeSelector';
 export * from './ui/composer/AssistantVoiceButton';
 export * from './ui/composer/AssistantVoiceSelector';
 export * from './ui/composer/AssistantVoiceGraceSelector';
+export * from './ui/composer/AssistantHandsFreeInterruptToggle';
 export * from './ui/voice/AssistantVoiceOrb';
 export * from './ui/voice/AssistantVoiceSessionButton';
 export * from './ui/voice/VoiceCaption';
@@ -202,6 +218,10 @@ export * from './permissionError';
 export * from './autoRouting';
 export * from './turnOutcome';
 export * from './turnTimeline';
+export * from './turnStream';
+export * from './liveDeltas';
+export * from './liveOverlay';
+export * from './snapshotPoller';
 export * from './turnTimingReport';
 export * from './turnTimingReporter';
 export * from './prewarm';

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

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

@@ -0,0 +1,76 @@
+import { AssistantRawMessage } from './types';
+/** One frame as the stream hands it over: the SSE event name and its JSON data. */
+export interface LiveFrame {
+    readonly event: string;
+    readonly data: unknown;
+}
+/** What the reducer holds about one text part. */
+export interface LivePartState {
+    readonly messageId: string;
+    /** The stream generation that started the part (`LiveDeltaState.generation`). */
+    readonly generation: number;
+    /** The redacted text so far — or, once `ended`, the final redacted text. */
+    readonly text: string;
+    /** Began live: this stream saw the part's start frame. `false` is poll-only. */
+    readonly live: boolean;
+    /** The part's end frame arrived. */
+    readonly ended: boolean;
+    /** A delta did not continue the text: no later delta is applied. */
+    readonly gapped: boolean;
+    /** A new generation began while the part was being written. */
+    readonly frozen: boolean;
+}
+export interface LiveMessageState {
+    readonly created?: number;
+    readonly completed?: number;
+}
+export interface LiveDeltaState {
+    /** +1 for every re-mint. */
+    readonly generation: number;
+    readonly parts: ReadonlyMap<string, LivePartState>;
+    readonly messages: ReadonlyMap<string, LiveMessageState>;
+}
+/** Bounds on what one turn's stream may make this reducer remember. */
+export declare const LIVE_PART_LIMIT = 256;
+export declare const LIVE_MESSAGE_LIMIT = 256;
+/** The longest live text one part may hold; past it the part is frozen. */
+export declare const LIVE_TEXT_LIMIT: number;
+export declare function createLiveState(): LiveDeltaState;
+/**
+ * The stream was lost: whatever arrives next is unknown, so every part still
+ * being written is frozen at its text. The generation does not change.
+ */
+export declare function freezeLiveParts(state: LiveDeltaState): LiveDeltaState;
+/**
+ * A new generation: the stream was replaced (a re-mint). Every part still being
+ * written is frozen at its text — the frames between two streams are unknown —
+ * and parts the new stream starts belong to the new generation.
+ */
+export declare function beginLiveGeneration(state: LiveDeltaState): LiveDeltaState;
+/**
+ * Fold one frame into the state. Frames that are not about text (a tool part, a
+ * reasoning part, `session.idle`, `stream.end`) change nothing here: they wake
+ * the poll loop, and that is `turnStream`'s business.
+ */
+export declare function reduceLiveFrame(state: LiveDeltaState, frame: LiveFrame): LiveDeltaState;
+/**
+ * The poll's messages with the live text merged in, for DISPLAY ONLY.
+ *
+ * - Only messages created after `floor` are touched.
+ * - A text part the poll already has is rewritten in place (same id); a
+ *   live-from-start part the poll has not seen yet is appended to its message,
+ *   or to a synthetic assistant message that is NOT completed.
+ * - A part first seen mid-way (`live: false`) is never taken from the stream.
+ * - The input is never modified; nothing is removed; nothing but the text of
+ *   text parts changes.
+ */
+export declare function applyLiveDeltas(polled: readonly AssistantRawMessage[], state: LiveDeltaState, floor: number): AssistantRawMessage[];
+/**
+ * How much of the turn's text the stream carried: `full` when every text part
+ * it saw was live from its start and none was gapped or frozen, `partial` when
+ * the stream carried some but not all, `none` when it carried nothing.
+ */
+export declare function liveCoverage(state: LiveDeltaState): "full" | "partial" | "none";
+/** Has any live text arrived that could be shown? */
+export declare function hasLiveText(state: LiveDeltaState): boolean;
+//# sourceMappingURL=liveDeltas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"liveDeltas.d.ts","sourceRoot":"","sources":["../../../src/shared/assistant/liveDeltas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAA2B,MAAM,SAAS,CAAC;AAE5E,mFAAmF;AACnF,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,kDAAkD;AAClD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,iFAAiF;IACjF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,oCAAoC;IACpC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,oEAAoE;IACpE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,4BAA4B;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACnD,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC1D;AAED,uEAAuE;AACvE,eAAO,MAAM,eAAe,MAAM,CAAC;AACnC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,2EAA2E;AAC3E,eAAO,MAAM,eAAe,QAAa,CAAC;AAE1C,wBAAgB,eAAe,IAAI,cAAc,CAEhD;AAqBD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,CASrE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,CAGzE;AA+HD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,SAAS,GACf,cAAc,CAehB;AAoCD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,SAAS,mBAAmB,EAAE,EACtC,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,MAAM,GACZ,mBAAmB,EAAE,CAmEvB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAa/E;AAED,qDAAqD;AACrD,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAK1D"}

package/dist/shared/assistant/liveDeltas.js

@@ -0,0 +1,196 @@
+//#region src/shared/assistant/liveDeltas.ts
+var e = 256, t = 256, n = 512 * 1024;
+function r() {
+	return {
+		generation: 0,
+		parts: /* @__PURE__ */ new Map(),
+		messages: /* @__PURE__ */ new Map()
+	};
+}
+function i(e) {
+	return typeof e == "object" && e && !Array.isArray(e) ? e : void 0;
+}
+var a = (e) => typeof e == "string" && e !== "" ? e : void 0, o = (e) => typeof e == "number" && Number.isFinite(e) ? e : void 0;
+function s(e, t, n) {
+	let r = new Map(e);
+	return r.set(t, n), r;
+}
+function c(e) {
+	let t = null;
+	for (let [n, r] of e.parts) r.live && !r.ended && !r.frozen && (t ??= new Map(e.parts), t.set(n, {
+		...r,
+		frozen: !0
+	}));
+	return t ? {
+		...e,
+		parts: t
+	} : e;
+}
+function l(e) {
+	let t = c(e);
+	return {
+		...t,
+		generation: t.generation + 1
+	};
+}
+function u(e, t) {
+	let n = i(t.info), r = a(n?.id);
+	if (!n || !r || n.role !== "assistant" || !e.messages.has(r) && e.messages.size >= 256) return e;
+	let c = i(n.time), l = o(c?.created), u = o(c?.completed), d = e.messages.get(r);
+	return {
+		...e,
+		messages: s(e.messages, r, {
+			...l === void 0 ? d?.created === void 0 ? {} : { created: d.created } : { created: l },
+			...u === void 0 ? d?.completed === void 0 ? {} : { completed: d.completed } : { completed: u }
+		})
+	};
+}
+function d(e, t) {
+	let r = a(t.id), c = a(t.messageID);
+	if (!r || !c) return e;
+	let l = o(i(t.time)?.end) !== void 0, u = typeof t.text == "string" ? t.text : void 0, d = e.parts.get(r);
+	if (!d) {
+		if (e.parts.size >= 256) return e;
+		let n = t.live === !0 && u === "" && !l;
+		return {
+			...e,
+			parts: s(e.parts, r, {
+				messageId: c,
+				generation: e.generation,
+				text: "",
+				live: n,
+				ended: l,
+				gapped: !1,
+				frozen: !1
+			})
+		};
+	}
+	return d.ended || !l ? e : !d.live || u === void 0 ? {
+		...e,
+		parts: s(e.parts, r, {
+			...d,
+			ended: !0
+		})
+	} : {
+		...e,
+		parts: s(e.parts, r, {
+			...d,
+			text: u.length > 524288 ? u.slice(0, n) : u,
+			ended: !0
+		})
+	};
+}
+function f(e, t) {
+	let n = a(t.partID), r = typeof t.delta == "string" ? t.delta : void 0, i = o(t.offset);
+	if (!n || r === void 0) return e;
+	let c = e.parts.get(n);
+	return !c || !c.live || c.ended || c.gapped || c.frozen ? e : c.generation === e.generation ? i !== c.text.length || c.text.length + r.length > 524288 ? {
+		...e,
+		parts: s(e.parts, n, {
+			...c,
+			gapped: !0
+		})
+	} : r === "" ? e : {
+		...e,
+		parts: s(e.parts, n, {
+			...c,
+			text: c.text + r
+		})
+	} : {
+		...e,
+		parts: s(e.parts, n, {
+			...c,
+			frozen: !0
+		})
+	};
+}
+function p(e, t) {
+	let n = i(t.data);
+	if (!n) return e;
+	switch (t.event) {
+		case "message.updated": return u(e, n);
+		case "message.part.updated": return n.type === "text" ? d(e, n) : e;
+		case "message.part.delta": return n.partType === "text" || n.partType === void 0 ? f(e, n) : e;
+		default: return e;
+	}
+}
+function m(e, t) {
+	return e.time?.end !== void 0 || t.info?.time?.completed !== void 0;
+}
+function h(e, t, n) {
+	return t !== void 0 && n ? t : t === void 0 ? e.text : t.startsWith(e.text) ? t : e.text.startsWith(t) ? e.text : t;
+}
+function g(e, t, n) {
+	if (t.parts.size === 0) return [...e];
+	let r = /* @__PURE__ */ new Map();
+	for (let e of t.parts) {
+		let [, t] = e;
+		if (!t.live || t.text === "" && !t.ended) continue;
+		let n = r.get(t.messageId);
+		n ? n.push(e) : r.set(t.messageId, [e]);
+	}
+	if (r.size === 0) return [...e];
+	let i = [], a = /* @__PURE__ */ new Set();
+	for (let t of e) {
+		let e = t.info?.id, o = e ? r.get(e) : void 0;
+		if (!e || !o) {
+			i.push(t);
+			continue;
+		}
+		a.add(e);
+		let s = t.info?.time?.created ?? 0;
+		if (t.info?.role !== "assistant" || s <= n) {
+			i.push(t);
+			continue;
+		}
+		let c = [...t.parts ?? []];
+		for (let [e, n] of o) {
+			let r = c.findIndex((t) => t.type === "text" && t.id === e);
+			if (r < 0) {
+				c.push({
+					type: "text",
+					id: e,
+					text: n.text
+				});
+				continue;
+			}
+			let i = c[r], a = h(n, typeof i.text == "string" ? i.text : void 0, m(i, t));
+			a !== i.text && (c[r] = {
+				...i,
+				text: a
+			});
+		}
+		i.push({
+			...t,
+			parts: c
+		});
+	}
+	for (let [e, o] of r) {
+		if (a.has(e)) continue;
+		let r = t.messages.get(e)?.created;
+		r === void 0 || r <= n || i.push({
+			info: {
+				id: e,
+				role: "assistant",
+				time: { created: r }
+			},
+			parts: o.map(([e, t]) => ({
+				type: "text",
+				id: e,
+				text: t.text
+			}))
+		});
+	}
+	return i;
+}
+function _(e) {
+	let t = 0, n = 0;
+	for (let r of e.parts.values()) r.live && r.text !== "" ? (t += 1, (r.gapped || r.frozen) && (n += 1)) : r.live || (n += 1);
+	return t === 0 ? "none" : n === 0 ? "full" : "partial";
+}
+function v(e) {
+	for (let t of e.parts.values()) if (t.live && t.text !== "") return !0;
+	return !1;
+}
+//#endregion
+export { t as LIVE_MESSAGE_LIMIT, e as LIVE_PART_LIMIT, n as LIVE_TEXT_LIMIT, g as applyLiveDeltas, l as beginLiveGeneration, r as createLiveState, c as freezeLiveParts, v as hasLiveText, _ as liveCoverage, p as reduceLiveFrame };

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

@@ -0,0 +1,62 @@
+import { LiveDeltaState } from './liveDeltas';
+import { AssistantRawMessage } from './types';
+export interface LiveOverlayEntry {
+    readonly conversationId: string;
+    readonly content: string;
+}
+interface LiveOverlayState {
+    readonly byMessageId: Readonly<Record<string, LiveOverlayEntry>>;
+    setLive: (messageId: string, conversationId: string, content: string) => void;
+    clearLive: (messageId: string) => void;
+}
+/** Not persisted, by construction: there is no `persist` in this file. */
+export declare const useLiveOverlay: import('zustand').UseBoundStore<import('zustand').StoreApi<LiveOverlayState>>;
+/** The live text for one message, or null when there is none. */
+export declare function useLiveOverlayContent(messageId: string | null | undefined): string | null;
+/** What the live renderer needs of the stream. `TurnStream` satisfies it. */
+export interface LiveSource {
+    readonly live: LiveDeltaState;
+    onLive(listener: () => void): () => void;
+    endLive(): void;
+}
+export interface LiveRenderOptions {
+    stream: LiveSource;
+    conversationId: string;
+    /** The turn's own assistant message id: the only key this writes. */
+    messageId: string;
+    /**
+     * The bubble's text for these messages — the SAME builder the poll uses
+     * (`buildAssistantProgress` + `sanitizeAssistantResponse`), so the live text
+     * and the finished answer are made the same way.
+     */
+    build: (messages: AssistantRawMessage[], floor: number) => string;
+    /** Called once, when live text first exists for this turn (after arming). */
+    onFirstDelta?: () => void;
+    /** Called once, when the overlay first shows text. */
+    onFirstVisible?: () => void;
+    /** Minimum gap between live renders. Leading edge, with a trailing call. */
+    throttleMs?: number;
+    now?: () => number;
+    setTimer?: (run: () => void, ms: number) => unknown;
+    clearTimer?: (timer: unknown) => void;
+    /** Tests only: a store other than the shared one. */
+    overlay?: Pick<LiveOverlayState, "setLive" | "clearLive">;
+}
+export interface LiveRender {
+    /**
+     * Allow rendering, once the reply floor is known AND the prompt is sent
+     * (design rule 3). Frames that arrived earlier were only kept; they render
+     * now, if they are this turn's.
+     */
+    arm(floor: number): void;
+    /** The poll landed: re-merge its messages with the live text, at once. */
+    refresh(polled: readonly AssistantRawMessage[]): void;
+    /** Synchronous, idempotent. Detaches, cancels the throttle, drops the overlay. */
+    end(): void;
+    readonly armed: boolean;
+    readonly ended: boolean;
+}
+export declare const LIVE_RENDER_THROTTLE_MS = 100;
+export declare function createLiveRender(options: LiveRenderOptions): LiveRender;
+export {};
+//# sourceMappingURL=liveOverlay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"liveOverlay.d.ts","sourceRoot":"","sources":["../../../src/shared/assistant/liveOverlay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,UAAU,gBAAgB;IACxB,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;IACjE,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9E,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAED,0EAA0E;AAC1E,eAAO,MAAM,cAAc,+EAyBxB,CAAC;AAEJ,iEAAiE;AACjE,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACnC,MAAM,GAAG,IAAI,CAIf;AAED,6EAA6E;AAC7E,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,MAAM,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IACzC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,UAAU,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,KAAK,EAAE,CAAC,QAAQ,EAAE,mBAAmB,EAAE,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAClE,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,sDAAsD;IACtD,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IACpD,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,qDAAqD;IACrD,OAAO,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,GAAG,WAAW,CAAC,CAAC;CAC3D;AAED,MAAM,WAAW,UAAU;IACzB;;;;OAIG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,0EAA0E;IAC1E,OAAO,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,GAAG,IAAI,CAAC;IACtD,kFAAkF;IAClF,GAAG,IAAI,IAAI,CAAC;IACZ,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAkGvE"}

package/dist/shared/assistant/liveOverlay.js

@@ -0,0 +1,64 @@
+import { applyLiveDeltas as e, hasLiveText as t } from "./liveDeltas.js";
+import { create as n } from "zustand";
+//#region src/shared/assistant/liveOverlay.ts
+var r = n()((e) => ({
+	byMessageId: {},
+	setLive: (t, n, r) => e((e) => {
+		let i = e.byMessageId[t];
+		return i && i.content === r && i.conversationId === n ? e : { byMessageId: {
+			...e.byMessageId,
+			[t]: {
+				conversationId: n,
+				content: r
+			}
+		} };
+	}),
+	clearLive: (t) => e((e) => {
+		if (!(t in e.byMessageId)) return e;
+		let n = { ...e.byMessageId };
+		return delete n[t], { byMessageId: n };
+	})
+}));
+function i(e) {
+	return r((t) => e ? t.byMessageId[e]?.content ?? null : null);
+}
+var a = 100;
+function o(n) {
+	let i = n.now ?? Date.now, a = n.setTimer ?? ((e, t) => setTimeout(e, t)), o = n.clearTimer ?? ((e) => {
+		clearTimeout(e);
+	}), s = n.overlay ?? r.getState(), c = n.throttleMs ?? 100, l = null, u = [], d = !1, f = null, p = -Infinity, m = "", h = !1, g = !1, _ = () => l === null ? "" : n.build(e(u, n.stream.live, l), l), v = () => {
+		h || l === null || t(n.stream.live) && _() !== "" && (h = !0, n.onFirstDelta?.());
+	}, y = () => {
+		if (f = null, d || l === null) return;
+		let e = _();
+		e === "" || e === m || (p = i(), m = e, s.setLive(n.messageId, n.conversationId, e), g || (g = !0, n.onFirstVisible?.()));
+	}, b = n.stream.onLive(() => {
+		if (d || l === null) return;
+		v();
+		let e = p + c - i();
+		if (e <= 0) {
+			f !== null && (o(f), f = null), y();
+			return;
+		}
+		f === null && (f = a(y, e));
+	});
+	return {
+		arm(e) {
+			d || l !== null || (l = e, v(), y());
+		},
+		refresh(e) {
+			u = e, !(d || l === null) && y();
+		},
+		end() {
+			d || (d = !0, f !== null && (o(f), f = null), b(), s.clearLive(n.messageId), n.stream.endLive());
+		},
+		get armed() {
+			return l !== null;
+		},
+		get ended() {
+			return d;
+		}
+	};
+}
+//#endregion
+export { a as LIVE_RENDER_THROTTLE_MS, o as createLiveRender, r as useLiveOverlay, i as useLiveOverlayContent };

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

@@ -0,0 +1,48 @@
+/**
+ * ★★ BOFF-7914 (speed S3): the completion fast path.
+ *
+ * A turn's completion is discovered by a GET of the session's messages — the
+ * poll — and only by it. Without a stream the poll is the whole mechanism.
+ * With one, the bridge's `session.idle` says the turn is over, and the question
+ * becomes how soon after it the poll can SEE that.
+ *
+ * Take the common case: a GET started just before the idle is still in flight.
+ * Its answer was read before the turn settled, so it will probably say "not
+ * done", and the loop would then sleep and issue another. Instead, the idle
+ * starts ONE extra GET at once, beside the one in flight. Then:
+ *
+ * - Snapshots are applied in START order. Whichever finishes first is applied;
+ *   an OLDER snapshot that arrives after a newer one is discarded.
+ * - At most one extra request is outstanding, and at most two are started per
+ *   turn. The cadence of an ordinary poll is unchanged.
+ * - A failed request is skipped when a newer one is still pending or has
+ *   succeeded; it is thrown only when nothing newer can answer.
+ * - A snapshot says nothing by itself: the caller applies it exactly as it
+ *   applies a snapshot without a stream. This module decides nothing about the
+ *   turn.
+ */
+export interface SnapshotPollerOptions {
+    /** Extra requests the idle fast path may start per turn. */
+    maxExtra?: number;
+}
+export interface SnapshotPoller<T> {
+    /**
+     * The next snapshot to apply. Starts a request when none is pending; when a
+     * newer request than the one that answered is pending, it stays pending for
+     * the next call (`hasPending`).
+     */
+    next(): Promise<T>;
+    /**
+     * The bridge said the turn is idle. If a request is in flight, start one
+     * extra now and return true; otherwise (or past the caps) return false and
+     * leave it to the next `next()`.
+     */
+    startExtra(): boolean;
+    /** A started request has not been applied yet: do not sleep before `next()`. */
+    hasPending(): boolean;
+    /** Requests started in all, for tests and for the timeline. */
+    readonly started: number;
+    readonly extraStarted: number;
+}
+export declare function createSnapshotPoller<T>(fetch: () => Promise<T>, options?: SnapshotPollerOptions): SnapshotPoller<T>;
+//# sourceMappingURL=snapshotPoller.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"snapshotPoller.d.ts","sourceRoot":"","sources":["../../../src/shared/assistant/snapshotPoller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,WAAW,qBAAqB;IACpC,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;IACnB;;;;OAIG;IACH,UAAU,IAAI,OAAO,CAAC;IACtB,gFAAgF;IAChF,UAAU,IAAI,OAAO,CAAC;IACtB,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAUD,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,KAAK,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACvB,OAAO,GAAE,qBAA0B,GAClC,cAAc,CAAC,CAAC,CAAC,CAoGnB"}