@burdenoff/fe-libs 2026.1004.8 → 2026.1005.2

package/dist/shared/assistant/store.js

@@ -3,58 +3,60 @@ import "../../shared-utils.js";
 import { restoreAutoRouting as t } from "./autoRouting.js";
 import { createGuardedAssistantStorage as n } from "./guardedStorage.js";
 import { DEFAULT_VOICE_GRACE_MS as r, resolveVoiceGraceMs as i } from "./voice/handsFree.js";
-import { normaliseHistoryTitle as a } from "./history/historyControls.js";
-import { getHistoryStamp as o, historyOpenFilter as s, notifyAssistantStorageFull as c, offerHistoryRename as l } from "./history/stampRegistry.js";
-import { forgetLiveTurns as u } from "./liveTurns.js";
-import { LEGACY_WRITE_CONSENT_KEY as d, restoreAcknowledgedWriteModes as f, withWriteModeAcknowledged as p } from "./writeModeConsent.js";
-import { create as m } from "zustand";
-import { persist as h } from "zustand/middleware";
+import { resolveStoredHandsFree as a } from "./voice/handsfree/handsFreeSetting.js";
+import { normaliseHistoryTitle as o } from "./history/historyControls.js";
+import { getHistoryStamp as s, historyOpenFilter as c, notifyAssistantStorageFull as l, offerHistoryRename as u } from "./history/stampRegistry.js";
+import { forgetLiveTurns as d } from "./liveTurns.js";
+import { LEGACY_WRITE_CONSENT_KEY as f, restoreAcknowledgedWriteModes as p, withWriteModeAcknowledged as m } from "./writeModeConsent.js";
+import { create as h } from "zustand";
+import { persist as g } from "zustand/middleware";
 //#region src/shared/assistant/store.ts
-function g() {
+function _() {
 	return `${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
 }
-function _(e) {
+function v(e) {
 	let t = e.sandboxesByMode[e.mode]?.sandboxId;
 	return t ? {
 		sandboxId: t,
 		mode: e.mode
 	} : null;
 }
-var v = new Set([d, "sandboxWriteCapabilities"]);
-function y(e, n) {
-	let r = typeof e == "object" && e ? Object.fromEntries(Object.entries(e).filter(([e]) => !v.has(e))) : {};
+var y = new Set([f, "sandboxWriteCapabilities"]);
+function b(e, n) {
+	let r = typeof e == "object" && e ? Object.fromEntries(Object.entries(e).filter(([e]) => !y.has(e))) : {};
 	return {
 		...n,
 		...r,
-		acknowledgedWriteModes: f(e),
+		acknowledgedWriteModes: p(e),
 		autoRouting: t(e),
-		voiceGraceMs: i(r.voiceGraceMs)
+		voiceGraceMs: i(r.voiceGraceMs),
+		handsFreeInterrupt: a(r.handsFreeInterrupt)
 	};
 }
-function b(e, t, n) {
+function x(e, t, n) {
 	let r = new Set(t);
 	n && e.activeConversationId !== null && r.delete(e.activeConversationId);
 	let i = e.conversations.filter((e) => r.has(e.id));
 	if (i.length === 0) return {};
-	u(i.flatMap((e) => e.messages.map((e) => e.id)));
+	d(i.flatMap((e) => e.messages.map((e) => e.id)));
 	let a = e.conversations.filter((e) => !r.has(e.id)), o = { ...e.processingByConversationId };
 	for (let e of r) delete o[e];
 	if (e.activeConversationId === null || !r.has(e.activeConversationId)) return {
 		conversations: a,
 		processingByConversationId: o
 	};
-	let c = a.find(s());
+	let s = a.find(c());
 	return {
 		conversations: a,
 		processingByConversationId: o,
-		activeConversationId: c?.id ?? null,
-		...c ? {
-			mode: c.mode,
-			autoRouting: c.routedBy === "auto"
+		activeConversationId: s?.id ?? null,
+		...s ? {
+			mode: s.mode,
+			autoRouting: s.routedBy === "auto"
 		} : {}
 	};
 }
-var x = m()(h((e, t) => ({
+var S = h()(g((e, t) => ({
 	conversations: [],
 	activeConversationId: null,
 	mode: "assistant",
@@ -70,15 +72,16 @@ var x = m()(h((e, t) => ({
 	replyLanguage: null,
 	preferredVoices: {},
 	voiceGraceMs: r,
+	handsFreeInterrupt: !1,
 	createConversation: (n, r, i) => {
-		let a = g(), s = (/* @__PURE__ */ new Date()).toISOString(), c = r === void 0 && t().autoRouting, l = i?.routedBy ?? (c ? "auto" : void 0), u = r ?? (c ? "assistant" : t().mode), d = o(), f = {
+		let a = _(), o = (/* @__PURE__ */ new Date()).toISOString(), c = r === void 0 && t().autoRouting, l = i?.routedBy ?? (c ? "auto" : void 0), u = r ?? (c ? "assistant" : t().mode), d = s(), f = {
 			id: a,
 			title: n || "New conversation",
 			mode: u,
 			messages: [],
 			backendSessionId: null,
-			createdAt: s,
-			updatedAt: s,
+			createdAt: o,
+			updatedAt: o,
 			...l ? { routedBy: l } : {},
 			...d ? { sync: {
 				v: 1,
@@ -100,7 +103,7 @@ var x = m()(h((e, t) => ({
 			conversations: n,
 			processingByConversationId: r
 		};
-		let i = n.find(s());
+		let i = n.find(c());
 		return {
 			conversations: n,
 			processingByConversationId: r,
@@ -112,8 +115,8 @@ var x = m()(h((e, t) => ({
 		};
 	}),
 	renameConversation: (t, n) => {
-		let r = a(n);
-		r && (l(t, r) || e((e) => ({ conversations: e.conversations.map((e) => e.id === t ? {
+		let r = o(n);
+		r && (u(t, r) || e((e) => ({ conversations: e.conversations.map((e) => e.id === t ? {
 			...e,
 			title: r,
 			updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
@@ -276,20 +279,24 @@ var x = m()(h((e, t) => ({
 		assistantLanguage: null,
 		replyLanguage: null,
 		preferredVoices: {},
-		voiceGraceMs: r
+		voiceGraceMs: r,
+		handsFreeInterrupt: !1
 	}),
 	submitPrompt: (t) => e({ pendingPrompt: t }),
 	consumePendingPrompt: () => {
 		let n = t().pendingPrompt;
 		return n !== null && e({ pendingPrompt: null }), n;
 	},
-	acknowledgeWriteMode: (t) => e((e) => ({ acknowledgedWriteModes: p(e.acknowledgedWriteModes, t) })),
+	acknowledgeWriteMode: (t) => e((e) => ({ acknowledgedWriteModes: m(e.acknowledgedWriteModes, t) })),
 	setAutoSpeak: (t) => e({ autoSpeakEnabled: t }),
 	setAssistantLanguage: (t) => e({ assistantLanguage: t }),
 	setReplyLanguage: (t) => e({ replyLanguage: t }),
 	setVoiceGraceMs: (t) => {
 		i(t) === t && e({ voiceGraceMs: i(t) });
 	},
+	setHandsFreeInterrupt: (t) => {
+		e({ handsFreeInterrupt: a(t) });
+	},
 	setPreferredVoice: (t, n) => e((e) => {
 		let r = { ...e.preferredVoices };
 		return n === null ? delete r[t] : r[t] = n, { preferredVoices: r };
@@ -327,11 +334,11 @@ var x = m()(h((e, t) => ({
 			...a && !i.titleLocked ? { title: a } : {}
 		};
 	}) })),
-	removeConversationsSilently: (t) => e((e) => b(e, t, !1)),
-	evictConversations: (t) => e((e) => b(e, t, !0))
+	removeConversationsSilently: (t) => e((e) => x(e, t, !1)),
+	evictConversations: (t) => e((e) => x(e, t, !0))
 }), {
 	name: "hb-ai-assistant",
-	storage: n(e(), (e, t, n) => c(n)),
+	storage: n(e(), (e, t, n) => l(n)),
 	partialize: (e) => ({
 		conversations: e.conversations.map(({ ...e }) => e),
 		activeConversationId: e.activeConversationId,
@@ -343,9 +350,10 @@ var x = m()(h((e, t) => ({
 		assistantLanguage: e.assistantLanguage,
 		replyLanguage: e.replyLanguage,
 		preferredVoices: e.preferredVoices,
-		voiceGraceMs: e.voiceGraceMs
+		voiceGraceMs: e.voiceGraceMs,
+		handsFreeInterrupt: e.handsFreeInterrupt
 	}),
-	merge: y
+	merge: b
 }));
 //#endregion
-export { y as mergePersistedAssistantState, _ as resolveActiveModeSandbox, x as useAssistantStore };
+export { b as mergePersistedAssistantState, v as resolveActiveModeSandbox, S as useAssistantStore };

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

@@ -0,0 +1,71 @@
+import { LiveDeltaState } from './liveDeltas';
+import { StreamAccess } from './types';
+export type TurnStreamStatus = "minting" | "connecting" | "open" | "closed" | "unavailable";
+export type WakeResult = "wake" | "idle" | "timeout" | "abort";
+/** The slice of the browser `EventSource` this client uses. */
+export interface EventSourceLike {
+    readonly readyState: number;
+    addEventListener(type: string, listener: (event: {
+        readonly data?: unknown;
+    }) => void): void;
+    close(): void;
+}
+/** The timeline marks the stream makes (`turnTimeline.ts`). */
+export type TurnStreamMark = "streamOpen" | "streamIdle" | "streamRemint";
+export interface TurnStreamOptions {
+    /** Mint a stream URL, or null when there is none. Never throws into here. */
+    mint: () => Promise<StreamAccess | null>;
+    /** Open a connection; null when the browser has no EventSource. */
+    createEventSource?: (url: string) => EventSourceLike | null;
+    mark?: (mark: TurnStreamMark, reason?: string) => void;
+    now?: () => number;
+    setTimer?: (run: () => void, ms: number) => unknown;
+    clearTimer?: (timer: unknown) => void;
+    /** Delays before each re-mint; its length is the cap (2 per turn). */
+    remintDelaysMs?: readonly number[];
+    /** Wake-triggered polls are at least this far apart. */
+    minWakeGapMs?: number;
+}
+export interface TurnStream {
+    readonly status: TurnStreamStatus;
+    /** An `open` with `subscribed: true` arrived during this turn. */
+    readonly reachedOpen: boolean;
+    /** The current connection's `open` carried `projection: 1`. */
+    readonly projection: boolean;
+    /** +1 per re-mint. */
+    readonly generation: number;
+    /** The reason of each re-mint, in order. */
+    readonly remintReasons: readonly string[];
+    /**
+     * Resolve when the stream says something worth polling for, or after `maxMs`.
+     * `idle` is the bridge's own end-of-turn: poll NOW. A wake that arrives with
+     * nobody waiting is remembered, so the next wait resolves at once.
+     */
+    waitWake(maxMs: number, signal?: AbortSignal): Promise<WakeResult>;
+    readonly live: LiveDeltaState;
+    onLive(listener: () => void): () => void;
+    /**
+     * Called synchronously when the bridge's idle arrives. A listener that
+     * returns true has acted on it (the completion fast path started a poll), so
+     * the idle is not also remembered for the next `waitWake`.
+     */
+    onIdle(listener: () => boolean): () => void;
+    /** Synchronous. Detach live listeners and stop reducing text. Idempotent. */
+    endLive(): void;
+    readonly liveEnded: boolean;
+    /** Tear everything down. Idempotent. */
+    close(): void;
+}
+/**
+ * The debug override: `localStorage["burdenoff.assistant.transport"] = "poll"`
+ * forces polling for this browser — no mint, no stream — for a zero-cost A/B of
+ * the two transports. Absent by default; a storage that throws reads as absent.
+ */
+export declare const TRANSPORT_OVERRIDE_KEY = "burdenoff.assistant.transport";
+export declare function transportForcedToPoll(): boolean;
+/** Can this page open a turn stream at all, and has nobody switched it off? */
+export declare function turnStreamAvailable(): boolean;
+export declare const DEFAULT_REMINT_DELAYS_MS: readonly number[];
+export declare const MIN_WAKE_GAP_MS = 250;
+export declare function openTurnStream(options: TurnStreamOptions): TurnStream;
+//# sourceMappingURL=turnStream.d.ts.map

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

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

package/dist/shared/assistant/turnStream.js

@@ -0,0 +1,266 @@
+import { STREAM_MINT_BACKOFF_ERROR_MS as e, backOffStreamMint as t } from "./capabilities.js";
+import { beginLiveGeneration as n, createLiveState as r, freezeLiveParts as i, reduceLiveFrame as a } from "./liveDeltas.js";
+//#region src/shared/assistant/turnStream.ts
+var o = 2, s = "burdenoff.assistant.transport";
+function c() {
+	try {
+		return globalThis.localStorage?.getItem(s) === "poll";
+	} catch {
+		return !1;
+	}
+}
+function l() {
+	return typeof EventSource < "u" && !c();
+}
+var u = [1e3, 5e3], d = 250, f = [
+	"open",
+	"message.updated",
+	"message.part.updated",
+	"message.part.delta",
+	"session.error",
+	"session.idle",
+	"stream.end",
+	"relay.closed"
+];
+function p(e) {
+	return typeof e == "object" && e && !Array.isArray(e) ? e : void 0;
+}
+function m(e) {
+	if (typeof e == "string") try {
+		return JSON.parse(e);
+	} catch {
+		return;
+	}
+}
+function h(e) {
+	return typeof EventSource > "u" ? null : new EventSource(e, { withCredentials: !0 });
+}
+function g(s) {
+	let c = s.now ?? Date.now, l = s.setTimer ?? ((e, t) => setTimeout(e, t)), d = s.clearTimer ?? ((e) => {
+		clearTimeout(e);
+	}), g = s.createEventSource ?? h, _ = s.remintDelaysMs ?? u, v = s.minWakeGapMs ?? 250, y = "minting", b = !1, x = !1, S = 0, C = [], w = !1, T = !1, E = r(), D = /* @__PURE__ */ new Set(), O = /* @__PURE__ */ new Set(), k = null, A = 0, j = -1, M = !1, N = null, P = null, F = null, I = -Infinity, L = (e, t) => {
+		try {
+			s.mark?.(e, t);
+		} catch {}
+	}, R = (e, t) => {
+		e.settled || (e.settled = !0, d(e.maxTimer), e.gapTimer !== null && d(e.gapTimer), e.signal && e.onAbort && e.signal.removeEventListener("abort", e.onAbort), F === e && (F = null), (t === "wake" || t === "idle") && (I = c()), e.resolve(t));
+	}, z = (e) => {
+		let t = F;
+		if (!t) {
+			P = e === "idle" || P === "idle" ? "idle" : "wake";
+			return;
+		}
+		if (e === "idle") {
+			R(t, "idle");
+			return;
+		}
+		let n = I + v - c();
+		if (n <= 0) {
+			R(t, "wake");
+			return;
+		}
+		t.gapTimer === null && (t.gapTimer = l(() => {
+			t.gapTimer = null, R(t, "wake");
+		}, n));
+	}, B = () => {
+		if (!T) for (let e of [...D]) try {
+			e();
+		} catch {}
+	}, V = () => {
+		A += 1;
+		let e = k;
+		k = null;
+		try {
+			e?.close();
+		} catch {}
+	}, H = () => {
+		y = "unavailable", t(e, c());
+	}, U = () => {
+		y = "closed";
+	}, W = (e) => {
+		if (w) return;
+		if (C.length >= _.length) {
+			U();
+			return;
+		}
+		let t = _[C.length] ?? 0;
+		C.push(e), y = "minting", N !== null && d(N), N = l(() => {
+			N = null, !w && (L("streamRemint", e), S += 1, E = n(E), J());
+		}, t);
+	}, G = (e) => {
+		let t = F !== null;
+		switch (V(), E = i(E), z("wake"), e) {
+			case "client-closed":
+				U();
+				return;
+			case "session-idle":
+				t ? W("session-idle") : (y = "closed", M = !0);
+				return;
+			default: W(e);
+		}
+	}, K = (e, t, n) => {
+		if (w || e !== A) return;
+		let r = m(n);
+		if (t === "open") {
+			let t = p(r);
+			if (!t) return;
+			if (t.subscribed === !0) {
+				y = "open", j = e, b = !0, x = typeof t.projection == "number" && t.projection >= 1, L("streamOpen");
+				return;
+			}
+			G("not-subscribed");
+			return;
+		}
+		if (y === "open") {
+			if (t === "relay.closed") {
+				G(String(p(r)?.reason ?? "relay-closed"));
+				return;
+			}
+			if (t === "stream.end") {
+				G(`stream-end:${String(p(r)?.reason ?? "unknown")}`);
+				return;
+			}
+			if (x && !T && (t === "message.updated" || t === "message.part.updated" || t === "message.part.delta")) {
+				let e = a(E, {
+					event: t,
+					data: r
+				});
+				e !== E && (E = e, B());
+			}
+			switch (t) {
+				case "message.updated":
+					z("wake");
+					return;
+				case "message.part.updated": {
+					let e = p(r);
+					if (!x) {
+						z("wake");
+						return;
+					}
+					let t = p(e?.time)?.end !== void 0;
+					(e?.type === "tool" || e?.type === "text" && t) && z("wake");
+					return;
+				}
+				case "session.error":
+					z("wake");
+					return;
+				case "session.idle": {
+					if (!x) {
+						z("wake");
+						return;
+					}
+					L("streamIdle");
+					let e = !1;
+					for (let t of [...O]) try {
+						t() && (e = !0);
+					} catch {}
+					if (e) {
+						I = c();
+						return;
+					}
+					z("idle");
+					return;
+				}
+				default: return;
+			}
+		}
+	}, q = (e) => {
+		let t;
+		try {
+			t = g(e.url);
+		} catch {
+			t = null;
+		}
+		if (!t) {
+			H();
+			return;
+		}
+		let n = t, r = A += 1;
+		k = n, y = "connecting";
+		for (let e of f) n.addEventListener(e, (t) => {
+			e === "open" && typeof t.data != "string" || K(r, e, t.data);
+		});
+		n.addEventListener("error", () => {
+			if (!(w || r !== A)) {
+				if (n.readyState === o && j !== r) {
+					V(), z("wake"), H();
+					return;
+				}
+				G("error");
+			}
+		});
+	}, J = () => {
+		y = "minting";
+		let e = A;
+		s.mint().then((e) => e, () => null).then((t) => {
+			if (!(w || e !== A)) {
+				if (!t) {
+					H();
+					return;
+				}
+				q(t);
+			}
+		});
+	};
+	return J(), {
+		get status() {
+			return y;
+		},
+		get reachedOpen() {
+			return b;
+		},
+		get projection() {
+			return x;
+		},
+		get generation() {
+			return S;
+		},
+		get remintReasons() {
+			return C;
+		},
+		get live() {
+			return E;
+		},
+		get liveEnded() {
+			return T;
+		},
+		waitWake(e, t) {
+			return new Promise((n) => {
+				if (t?.aborted) {
+					n("abort");
+					return;
+				}
+				M && (M = !1, W("session-idle"));
+				let r = {
+					resolve: n,
+					maxTimer: null,
+					gapTimer: null,
+					signal: t,
+					onAbort: void 0,
+					settled: !1
+				};
+				r.maxTimer = l(() => R(r, "timeout"), e), t && (r.onAbort = () => R(r, "abort"), t.addEventListener("abort", r.onAbort)), F = r;
+				let i = P;
+				P = null, i && z(i);
+			});
+		},
+		onLive(e) {
+			return T ? () => void 0 : (D.add(e), () => {
+				D.delete(e);
+			});
+		},
+		onIdle(e) {
+			return O.add(e), () => {
+				O.delete(e);
+			};
+		},
+		endLive() {
+			T || (T = !0, D.clear());
+		},
+		close() {
+			w || (w = !0, T = !0, D.clear(), O.clear(), N !== null && (d(N), N = null), V(), F && R(F, "abort"), y !== "unavailable" && (y = "closed"));
+		}
+	};
+}
+//#endregion
+export { u as DEFAULT_REMINT_DELAYS_MS, d as MIN_WAKE_GAP_MS, s as TRANSPORT_OVERRIDE_KEY, g as openTurnStream, c as transportForcedToPoll, l as turnStreamAvailable };

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

@@ -32,12 +32,19 @@
  *   promptSent        the sandbox accepted the prompt
  *   lastQuietPoll     the last poll that saw nothing — with firstOutput, the
  *                     UPPER bound of how late polling noticed the output
- *   firstOutput       the first poll that saw anything to show (a tool line too)
+ *   streamOpen        the turn stream said `open` (BOFF-7914 S3); it can precede
+ *                     `promptSent`, because the mint runs beside the prompt
+ *   streamRemint      the stream was minted again after it ended; the FIRST
+ *                     re-mint (the reasons are the `remintReasons` of the stream)
+ *   firstDelta        the first live text of this turn that could be shown
+ *   firstOutput       the first poll — or live render — that had anything to
+ *                     show (a tool line too)
  *   firstText         the first poll that saw answer TEXT — prose not followed
  *                     by a tool call, confirmed when the turn completes, so
  *                     pre-tool narration does not count. In modes whose
  *                     narration IS the answer (BigConsole's build log), the
  *                     first narration: group reports by `mode`
+ *   streamIdle        the bridge said the turn is idle (stream turns only)
  *   answerDone        the poll that saw the answer complete
  *   complete          the turn ended (after artifacts and the credit report)
  *   speechQueued      the answer was handed to the speech feed (BOFF-8062 C1):
@@ -78,7 +85,7 @@
  * window event: any script on the page can dispatch that event, so a listener
  * on it can be fed invented timings. Only this module calls subscribers.
  */
-export declare const TURN_MILESTONES: readonly ["speechEnded", "graceStarted", "graceEnded", "handedOver", "accepted", "cleared", "attemptStarted", "prewarmJoined", "bootAdopted", "provisionStarted", "createRequested", "sandboxRunning", "serviceReady", "runtimeReady", "promptSent", "lastQuietPoll", "firstOutput", "firstText", "answerDone", "complete", "speechQueued", "ttsStarted", "firstAudio", "audioEnded"];
+export declare const TURN_MILESTONES: readonly ["speechEnded", "graceStarted", "graceEnded", "handedOver", "accepted", "cleared", "attemptStarted", "prewarmJoined", "bootAdopted", "provisionStarted", "createRequested", "sandboxRunning", "serviceReady", "runtimeReady", "promptSent", "lastQuietPoll", "streamOpen", "streamRemint", "firstDelta", "firstOutput", "firstText", "streamIdle", "answerDone", "complete", "speechQueued", "ttsStarted", "firstAudio", "audioEnded"];
 export type TurnMilestone = (typeof TURN_MILESTONES)[number];
 /**
  * How the runtime was found:
@@ -145,6 +152,16 @@ export interface TurnAttemptFacts {
      * the `prewarmJoined` mark says so.
      */
     prewarm?: "hit" | "joined" | "joinedFailed";
+    /**
+     * BOFF-7914 S3: how this attempt learnt about the reply — `sse` when the turn
+     * stream reached `open`, else `poll`. Timeline-only; the production latency
+     * report builds from an allowlist and does not carry it (until S0b).
+     */
+    transport?: "sse" | "poll";
+    /** How much of the text the stream carried: all of it, some, or none. */
+    live?: "full" | "partial" | "none";
+    /** The session: `reused`, `created` (new) or `preopened` (BOFF-8015). */
+    session?: "reused" | "created" | "preopened";
 }
 export interface TurnAttempt extends TurnAttemptFacts {
     at: Partial<Record<TurnMilestone, number>>;
@@ -265,6 +282,14 @@ export declare const TURN_SEGMENTS: readonly [{
     readonly name: "finish";
     readonly from: "firstOutput";
     readonly to: "answerDone";
+}, {
+    readonly name: "deltaToVisible";
+    readonly from: "firstDelta";
+    readonly to: "firstOutput";
+}, {
+    readonly name: "wakeLag";
+    readonly from: "streamIdle";
+    readonly to: "answerDone";
 }, {
     readonly name: "post";
     readonly from: "answerDone";

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

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