@burdenoff/fe-libs 2026.911.5 → 2026.912.1

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

@@ -94,7 +94,10 @@ export * from './ui/composer/connectSource';
 export * from './preview/types';
 export * from './preview/context';
 export * from './preview/previewTransitions';
+export * from './preview/surfaceState';
+export * from './preview/runIdentity';
 export * from './ui/panelOverlays';
+export * from './ui/useDropdownEscape';
 export * from './ui/useOverlayFocus';
 export * from './preview/useAssistantPreviewBridge';
 export * from './preview/AssistantPreviewOverlay';

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/preview/previewTransitions.d.ts

@@ -1,5 +1,12 @@
 import { AssistantConversationStatus } from '../conversation';
 import { AssistantPreviewEvent, AssistantPreviewRun } from './types';
+import { AssistantToolStep } from '../ui/AssistantToolActivity';
+/**
+ * ★ Exported so the bridge can ask "is this live?" without naming any status.
+ * `previewInvariants` forbids status literals in the bridge precisely so there
+ * is one vocabulary for what counts as running, and this keeps that true.
+ */
+export declare function isRunningStatus(status: AssistantConversationStatus): boolean;
 export interface PreviewBridgeState {
     /**
      * ★★ The conversation whose baseline has been established.
@@ -67,6 +74,11 @@ export interface PreviewInput {
     readonly conversationId: string | null;
     readonly status: AssistantConversationStatus;
     readonly content: string | null;
+    /**
+     * ★ The tool activity for this message, already parsed. Passed IN rather than
+     * derived here so this function stays pure and testable without the parser.
+     */
+    readonly steps: readonly AssistantToolStep[];
     readonly error?: string | null;
     /** `isStageCopy`, injected so this stays pure and testable without i18n. */
     readonly isFiller: (content: string) => boolean;

package/dist/shared/assistant/preview/previewTransitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"previewTransitions.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/preview/previewTransitions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAS1E,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,CAAC,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/C;;;;;;;;OAQG;IACH,QAAQ,CAAC,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAChD;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,wEAAwE;IACxE,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED,eAAO,MAAM,kBAAkB,EAAE,kBAKhC,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACzC;;;;;;;;OAQG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;CACjD;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,kBAAkB,EACzB,KAAK,EAAE,YAAY,GAClB;IAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAAC,KAAK,EAAE,kBAAkB,CAAA;CAAE,CAiIhE"}
+{"version":3,"file":"previewTransitions.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/preview/previewTransitions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AASrE;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAE5E;AAED,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,CAAC,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/C;;;;;;;;OAQG;IACH,QAAQ,CAAC,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAChD;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,wEAAwE;IACxE,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED,eAAO,MAAM,kBAAkB,EAAE,kBAKhC,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACzC;;;;;;;;OAQG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;CACjD;AAkDD,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,kBAAkB,EACzB,KAAK,EAAE,YAAY,GAClB;IAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAAC,KAAK,EAAE,kBAAkB,CAAA;CAAE,CAwJhE"}

package/dist/shared/assistant/preview/previewTransitions.js

@@ -3,94 +3,107 @@ var e = new Set([
 	"provisioning",
 	"connecting",
 	"streaming"
-]), t = {
+]);
+function t(t) {
+	return e.has(t);
+}
+var n = {
 	observedConversationId: null,
 	startedRun: null,
 	lastEndedRunId: null,
 	lastSnapshot: null
 };
-function n(t, n) {
-	let r = [], i = n.run?.runId ?? null, a = n.conversationId ?? n.run?.conversationId ?? null, o = a !== null && t.observedConversationId === a, s = {
+function r(e, t) {
+	return `${e}\u0000${t.map((e) => `${e.id}:${e.status}`).join(",")}`;
+}
+function i(e, t, n, i, a) {
+	let o = t && !i(t) ? t : "";
+	if (!o && n.length === 0) return null;
+	let s = r(o, n);
+	return s === a ? null : {
+		event: {
+			kind: "snapshot",
+			run: e,
+			content: o,
+			steps: n
+		},
+		signature: s
+	};
+}
+function a(t, n) {
+	let r = [], a = n.run?.runId ?? null, o = n.conversationId ?? n.run?.conversationId ?? null, s = o !== null && t.observedConversationId === o, c = {
 		...t,
-		observedConversationId: a ?? t.observedConversationId
-	}, c = s.startedRun;
-	if (c && c.runId !== i && (r.push({
+		observedConversationId: o ?? t.observedConversationId
+	}, l = c.startedRun;
+	if (l && l.runId !== a && (r.push({
 		kind: "end",
-		run: c,
+		run: l,
 		outcome: "abandoned",
 		error: null
-	}), s = {
-		...s,
+	}), c = {
+		...c,
 		startedRun: null,
-		lastEndedRunId: c.runId
+		lastEndedRunId: l.runId
 	}), !n.run) return {
 		events: r,
-		state: s
+		state: c
 	};
 	if (e.has(n.status)) {
-		s.startedRun?.runId !== n.run.runId && (r.push({
+		c.startedRun?.runId !== n.run.runId && (r.push({
 			kind: "start",
 			run: n.run
-		}), s = {
-			...s,
+		}), c = {
+			...c,
 			startedRun: n.run,
 			lastSnapshot: null
 		});
-		let e = s.startedRun ?? n.run, t = n.content;
-		return t && !n.isFiller(t) && t !== s.lastSnapshot && (r.push({
-			kind: "snapshot",
-			run: e,
-			content: t
-		}), s = {
-			...s,
-			lastSnapshot: t
+		let e = i(c.startedRun ?? n.run, n.content, n.steps, n.isFiller, c.lastSnapshot);
+		return e && (r.push(e.event), c = {
+			...c,
+			lastSnapshot: e.signature
 		}), {
 			events: r,
-			state: s
+			state: c
 		};
 	}
-	if (!s.startedRun) {
-		if (!o || s.lastEndedRunId === n.run.runId) return {
+	if (!c.startedRun) {
+		if (!s || c.lastEndedRunId === n.run.runId) return {
 			events: r,
 			state: {
-				...s,
+				...c,
 				lastEndedRunId: n.run.runId
 			}
 		};
 		r.push({
 			kind: "start",
 			run: n.run
-		}), s = {
-			...s,
+		}), c = {
+			...c,
 			startedRun: n.run,
 			lastSnapshot: null
 		};
 	}
-	let l = s.startedRun;
-	if (l && l.runId === n.run.runId) {
-		let e = n.content;
-		e && !n.isFiller(e) && e !== s.lastSnapshot && (r.push({
-			kind: "snapshot",
-			run: l,
-			content: e
-		}), s = {
-			...s,
-			lastSnapshot: e
+	let u = c.startedRun;
+	if (u && u.runId === n.run.runId) {
+		let e = i(u, n.content, n.steps, n.isFiller, c.lastSnapshot);
+		e && (r.push(e.event), c = {
+			...c,
+			lastSnapshot: e.signature
 		}), r.push({
 			kind: "end",
-			run: l,
+			run: u,
 			outcome: n.status === "error" ? "error" : "complete",
 			error: n.error ?? null
-		}), s = {
-			...s,
+		}), c = {
+			...c,
 			startedRun: null,
-			lastEndedRunId: l.runId
+			lastEndedRunId: u.runId
 		};
 	}
 	return {
 		events: r,
-		state: s
+		state: c
 	};
 }
 //#endregion
-export { t as IDLE_PREVIEW_STATE, n as nextPreviewEvents };
+export { n as IDLE_PREVIEW_STATE, t as isRunningStatus, a as nextPreviewEvents };

package/dist/shared/assistant/preview/runIdentity.d.ts

@@ -0,0 +1,44 @@
+import { PreviewOwner } from './surfaceState';
+export interface RunIdentityCache {
+    /**
+     * The owner this run was FIRST seen under. Subsequent calls return that same
+     * owner however many times the caller re-reads, and whoever is signed in by
+     * then — which is the entire point.
+     */
+    ownerFor(runId: string): PreviewOwner;
+    /**
+     * The owner of a run that has already SETTLED — remembered if we pinned it
+     * while it ran, otherwise the current owner — and RELEASED either way.
+     *
+     * ★★★ THIS EXISTS BECAUSE HOLDING SETTLED RUNS MADE EVICTION REACHABLE.
+     * Terminal processing entries persist by design, and the bridge meets one for
+     * every conversation the user opens, so storing them filled the map with
+     * history. Releasing here is the other half: a settled run can never need its
+     * identity again — the transitions mark it ended and consume every later tick
+     * without emitting — so an entry that stays only crowds out a run that is
+     * still live. With both, the map holds ONLY runs believed to be running, and
+     * `DEFAULT_LIMIT` has to cover concurrent turns rather than session history.
+     *
+     * ★ A miss is not a failure: a settled entry we never saw running is either
+     * history, which is consumed without emitting so the identity is never used,
+     * or a synchronous failure that settled in this very tick — where the current
+     * owner IS the run's owner, and reading it now is correct rather than the
+     * self-agreeing guard it would be for a live run.
+     */
+    ownerForSettled(runId: string): PreviewOwner;
+    /** Test seam: how many runs are currently remembered. */
+    size(): number;
+}
+export declare function createRunIdentityCache(readOwner?: () => PreviewOwner, limit?: number, 
+/** ★ Injected so expiry is testable without waiting four hours. */
+now?: () => number, maxAgeMs?: number): RunIdentityCache;
+/**
+ * The instance the bridge uses.
+ *
+ * ★ Module scope is deliberate and is what makes this survive a remount. It is
+ * shared by every panel on the page, which is safe: run ids carry the
+ * conversation id, so two panels on two conversations cannot collide, and two
+ * panels on the SAME conversation are the same run and want the same answer.
+ */
+export declare const runIdentities: RunIdentityCache;
+//# sourceMappingURL=runIdentity.d.ts.map

package/dist/shared/assistant/preview/runIdentity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runIdentity.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/preview/runIdentity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAwBxE,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC;IACtC;;;;;;;;;;;;;;;;;;OAkBG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC;IAC7C,yDAAyD;IACzD,IAAI,IAAI,MAAM,CAAC;CAChB;AAED,wBAAgB,sBAAsB,CACpC,SAAS,GAAE,MAAM,YAAkC,EACnD,KAAK,GAAE,MAAsB;AAC7B,mEAAmE;AACnE,GAAG,GAAE,MAAM,MAAiB,EAC5B,QAAQ,GAAE,MAA2B,GACpC,gBAAgB,CAgDlB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,kBAA2B,CAAC"}

package/dist/shared/assistant/preview/runIdentity.js

@@ -0,0 +1,33 @@
+import { currentPreviewOwner as e } from "./surfaceState.js";
+//#region src/shared/assistant/preview/runIdentity.ts
+var t = 14400 * 1e3, n = 512;
+function r(r = e, i = n, a = Date.now, o = t) {
+	let s = /* @__PURE__ */ new Map();
+	return {
+		ownerFor(e) {
+			let t = s.get(e);
+			if (t) return t.at = a(), s.delete(e), s.set(e, t), t.owner;
+			let n = r();
+			s.set(e, {
+				owner: n,
+				at: a()
+			});
+			let c = a() - o;
+			for (let [e, t] of s) t.at <= c && s.delete(e);
+			for (; s.size > i;) {
+				let e = s.keys().next();
+				if (e.done) break;
+				s.delete(e.value);
+			}
+			return n;
+		},
+		ownerForSettled(e) {
+			let t = s.get(e);
+			return t ? (s.delete(e), t.owner) : r();
+		},
+		size: () => s.size
+	};
+}
+var i = r();
+//#endregion
+export { r as createRunIdentityCache, i as runIdentities };

package/dist/shared/assistant/preview/surfaceState.d.ts

@@ -0,0 +1,133 @@
+import { AssistantToolStep } from '../ui/AssistantToolActivity';
+import { AssistantPreviewEvent, AssistantPreviewRun } from './types';
+/**
+ * The state a product's preview surface shows, and the rules for changing it.
+ *
+ * ★★★ WHY THIS IS HERE AND NOT IN EACH APP. It was written twice — once in
+ * HealthyBowl, once in VibeControls — and over five review rounds the SAME nine
+ * defects were found and fixed in both copies, four of them cross-account leaks.
+ * Three were introduced by the fix for the previous one. The surface itself is
+ * rightly per-product (its copy, its testids, its markdown); the state machine
+ * underneath is not, and every day it stayed duplicated it cost two fixes and
+ * risked them diverging.
+ *
+ * What a product still owns: what the reading view LOOKS like. What it no longer
+ * owns: deciding which events may write to it.
+ */
+/**
+ * ★ `ended` is the run finishing in a way THIS version does not recognise.
+ * fe-libs owns `outcome`, so a future one can reach an app that has not been
+ * rebuilt. Without a named phase for it the phase became whatever string
+ * arrived, and a product's status lookup returned `undefined`.
+ */
+export type PreviewPhase = "idle" | "generating" | "complete" | "error" | "abandoned" | "ended";
+/**
+ * Who an answer belongs to.
+ *
+ * ★★ A STRUCT, NOT A `workspaceId|actorId` STRING. Both apps carried the string
+ * form and had to split it to compare halves, which is how one of them ended up
+ * validating only the workspace and letting a second account in the same
+ * workspace read the first one's answer.
+ */
+export interface PreviewOwner {
+    readonly workspaceId: string | null;
+    readonly actorId: string | null;
+}
+export interface PreviewState {
+    readonly phase: PreviewPhase;
+    readonly content: string;
+    readonly error: string | null;
+    /** The identity this content belongs to. Never inherited across a change. */
+    readonly owner: PreviewOwner;
+    /**
+     * ★★★ THE RUN THIS CONTENT CAME FROM — `null` when nothing is in flight.
+     *
+     * Content may only be written for the run currently in flight. That single
+     * rule closes three separate ways the wrong text reached a user:
+     * a snapshot still arriving from an interrupted turn overwriting the new
+     * answer; a late terminal event ending a turn that was still streaming; and
+     * an event from a previous account being relabelled as the current one's,
+     * because a surface reads identity at DELIVERY time.
+     */
+    readonly runId: string | null;
+    /**
+     * ★★ What the assistant has been DOING, not just what it has said.
+     *
+     * Carried so a surface can render progress — a step rail, a spinner per tool —
+     * rather than only the prose. Without it the capability could express "the
+     * answer, wider" and nothing else, which is why a "watch it build" surface
+     * could not be based on it. Empty for a run that has called no tools, and
+     * cleared by `start` so one run's activity never decorates the next.
+     */
+    readonly steps: readonly AssistantToolStep[];
+}
+export declare const NO_OWNER: PreviewOwner;
+export declare const IDLE_PREVIEW: PreviewState;
+/** The identity as it is NOW. Read at delivery; never cached. */
+export declare function currentPreviewOwner(): PreviewOwner;
+export declare function sameOwner(a: PreviewOwner, b: PreviewOwner): boolean;
+/**
+ * Did this run START under this identity?
+ *
+ * ★★★ BOTH HALVES, which is the whole reason `actorId` was added to
+ * `AssistantPreviewRun`. Checking only the workspace left two accounts sharing
+ * one workspace indistinguishable: a late `start` from the previous actor was
+ * adopted under the new one, and every snapshot after it then matched the run id
+ * and painted the previous actor's answer. That case was not closeable in an app
+ * at all — the run carried no actor to compare.
+ */
+export declare function runBelongsTo(run: AssistantPreviewRun, owner: PreviewOwner): boolean;
+/**
+ * The reducer. Pure, so it can be tested without React or a DOM.
+ *
+ * ★ `abandoned` is NOT an error. The user interrupted their own turn; showing a
+ * failure for that blames them for their own decision. It keeps the text that
+ * arrived and says it stopped.
+ */
+export declare function applyPreviewEvent(state: PreviewState, event: AssistantPreviewEvent, owner: PreviewOwner): PreviewState;
+/**
+ * The store a product's reading view subscribes to.
+ *
+ * ★★ EXTERNAL, read through `useSyncExternalStore`. The controller handed to the
+ * panel must stay STABLE across renders — the bridge deliberately does not reset
+ * on controller identity — so a surface cannot hold its state in a closure the
+ * controller captures.
+ */
+export interface AssistantPreviewSurface {
+    subscribe(listener: () => void): () => void;
+    getSnapshot(): PreviewState;
+    /**
+     * Reduce an event and publish. ★ The owner is derived HERE, once, so no
+     * product can forget to do it or do it differently.
+     */
+    deliver(event: AssistantPreviewEvent): void;
+    /** Clear. Call when the identity changes. */
+    reset(): void;
+    /**
+     * Re-check the owner and NOTIFY if it changed.
+     *
+     * ★★★ THE NOTIFICATION PATH THAT `getSnapshot` IS NOT. `getSnapshot` clears
+     * on read, which protects any reader that re-renders — but nothing makes it
+     * re-render: `getWorkspaceId()`/`getActorId()` are imperative reads of the
+     * URL, storage and the JWT, with no change event for the store to subscribe
+     * to, and a surface component need not consume the auth context that did
+     * change. So on an account switch with no preview event and no unrelated
+     * render, the previous owner's answer stayed painted.
+     *
+     * ★ Products call this from the effect they already key on their auth /
+     * workspace context. It is a no-op when the owner has not changed, which is
+     * why it is safe to call on every such tick and why it is preferable to
+     * `reset()` there — `reset()` would also wipe a live run of the SAME owner
+     * whenever an unrelated part of that context ticked.
+     *
+     * @returns whether the owner had changed (and subscribers were notified).
+     */
+    syncOwner(): boolean;
+}
+export declare function createAssistantPreviewSurface(
+/**
+ * ★ Injectable so this can be tested without a DOM — `currentPreviewOwner()`
+ * reads `window.location`, which a pure test run does not have.
+ */
+readOwner?: () => PreviewOwner): AssistantPreviewSurface;
+//# sourceMappingURL=surfaceState.d.ts.map

package/dist/shared/assistant/preview/surfaceState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceState.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/preview/surfaceState.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAE1E;;;;;;;;;;;;;GAaG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,YAAY,GACZ,UAAU,GACV,OAAO,GACP,WAAW,GACX,OAAO,CAAC;AAEZ;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B;;;;;;;;;OASG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;;;;;;;;OAQG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC9C;AAED,eAAO,MAAM,QAAQ,EAAE,YAAmD,CAAC;AAE3E,eAAO,MAAM,YAAY,EAAE,YAO1B,CAAC;AAEF,iEAAiE;AACjE,wBAAgB,mBAAmB,IAAI,YAAY,CAOlD;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,OAAO,CAEnE;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,mBAAmB,EACxB,KAAK,EAAE,YAAY,GAClB,OAAO,CAET;AAUD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,qBAAqB,EAC5B,KAAK,EAAE,YAAY,GAClB,YAAY,CAyCd;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAC5C,WAAW,IAAI,YAAY,CAAC;IAC5B;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC5C,6CAA6C;IAC7C,KAAK,IAAI,IAAI,CAAC;IACd;;;;;;;;;;;;;;;;;;OAkBG;IACH,SAAS,IAAI,OAAO,CAAC;CACtB;AAED,wBAAgB,6BAA6B;AAC3C;;;GAGG;AACH,SAAS,GAAE,MAAM,YAAkC,GAClD,uBAAuB,CAqEzB"}

package/dist/shared/assistant/preview/surfaceState.js

@@ -0,0 +1,92 @@
+import { getActorId as e, getWorkspaceId as t } from "../context.js";
+//#region src/shared/assistant/preview/surfaceState.ts
+var n = {
+	workspaceId: null,
+	actorId: null
+}, r = {
+	phase: "idle",
+	content: "",
+	error: null,
+	owner: n,
+	runId: null,
+	steps: []
+};
+function i() {
+	return {
+		workspaceId: t() || null,
+		actorId: e()
+	};
+}
+function a(e, t) {
+	return e.workspaceId === t.workspaceId && e.actorId === t.actorId;
+}
+function o(e, t) {
+	return e.workspaceId === t.workspaceId && e.actorId === t.actorId;
+}
+var s = new Set([
+	"complete",
+	"error",
+	"abandoned"
+]);
+function c(e, t, n) {
+	let i = a(e.owner, n) ? e : {
+		...r,
+		owner: n
+	};
+	switch (t.kind) {
+		case "start": return o(t.run, n) ? {
+			phase: "generating",
+			content: "",
+			error: null,
+			owner: n,
+			runId: t.run.runId,
+			steps: []
+		} : i;
+		case "snapshot": return i.runId === null || t.run.runId !== i.runId ? i : {
+			...i,
+			content: t.content,
+			steps: t.steps,
+			owner: n
+		};
+		case "end": return i.runId === null || t.run.runId !== i.runId ? i : {
+			phase: s.has(t.outcome) ? t.outcome : "ended",
+			content: i.content,
+			error: t.error,
+			owner: n,
+			runId: null,
+			steps: i.steps
+		};
+		default: return i;
+	}
+}
+function l(e = i) {
+	let t = r, n = /* @__PURE__ */ new Set(), o = (e) => {
+		t = e;
+		for (let e of n) e();
+	};
+	return {
+		subscribe(e) {
+			return n.add(e), () => {
+				n.delete(e);
+			};
+		},
+		getSnapshot() {
+			return a(t.owner, e()) || (t = r), t;
+		},
+		deliver(n) {
+			o(c(t, n, e()));
+		},
+		reset() {
+			o(r);
+		},
+		syncOwner() {
+			let n = e();
+			return a(t.owner, n) ? !1 : (o({
+				...r,
+				owner: n
+			}), !0);
+		}
+	};
+}
+//#endregion
+export { r as IDLE_PREVIEW, n as NO_OWNER, c as applyPreviewEvent, l as createAssistantPreviewSurface, i as currentPreviewOwner, o as runBelongsTo, a as sameOwner };

package/dist/shared/assistant/preview/types.d.ts

@@ -1,4 +1,5 @@
 import { ReactNode } from 'react';
+import { AssistantToolStep } from '../ui/AssistantToolActivity';
 /**
  * One logical run.
  *
@@ -21,6 +22,20 @@ export interface AssistantPreviewRun {
      * workspace it never ran in.
      */
     readonly workspaceId: string | null;
+    /**
+     * ★★★ The ACTOR as it was when the run started, for the same reason — and
+     * because the workspace alone is not an identity.
+     *
+     * Added after a surface that validated only `workspaceId` was found to let a
+     * second account in the SAME workspace read the first one's answer: a late
+     * `start` from the previous actor was adopted under the new one, and every
+     * snapshot after it matched the run id. That case could not be fixed in the
+     * consuming app at all, because the run carried no actor to compare against.
+     *
+     * `null` where there is no signed-in actor, which is a real state rather than
+     * a missing value — two runs both lacking an actor are the same identity.
+     */
+    readonly actorId: string | null;
 }
 /**
  * ★★ SPOKEN TURNS ARE INCLUDED, deliberately. Voice and typed turns share one
@@ -50,7 +65,25 @@ export type AssistantPreviewEvent = {
 } | {
     kind: "snapshot";
     run: AssistantPreviewRun;
+    /**
+     * ★★ THE PROSE, with the tool-activity lines REMOVED.
+     *
+     * The assistant's raw message interleaves `Running: <tool>` /
+     * `Completed: <tool>` lines with the answer; the transcript splits them
+     * out with `parseToolActivity` and renders them as an activity card. The
+     * preview used to receive the raw content and render those lines as if
+     * they were part of the answer.
+     */
     content: string;
+    /**
+     * ★★ The same lines, structured — so a surface can show PROGRESS as well
+     * as prose.
+     *
+     * Without this a product could only ever render the answer, which is why
+     * a "watch it build" surface (BigConsole has one) could not be based on
+     * this capability at all. Empty for a run that has called no tools.
+     */
+    steps: readonly AssistantToolStep[];
 } | {
     kind: "end";
     run: AssistantPreviewRun;

package/dist/shared/assistant/preview/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/preview/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED;;;;;;;;;;;;;;GAcG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,mBAAmB,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,mBAAmB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC/D;IACE,IAAI,EAAE,KAAK,CAAC;IACZ,GAAG,EAAE,mBAAmB,CAAC;IACzB;;;;;;;;OAQG;IACH,OAAO,EAAE,UAAU,GAAG,OAAO,GAAG,WAAW,CAAC;IAC5C;;;;;;OAMG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAC;AAEN;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;;;;;;;OASG;IACH,MAAM,EAAE,MAAM,SAAS,CAAC;IAExB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAEjD,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/preview/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;GAcG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,mBAAmB,CAAA;CAAE,GAC3C;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,GAAG,EAAE,mBAAmB,CAAC;IACzB;;;;;;;;OAQG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;OAOG;IACH,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACrC,GACD;IACE,IAAI,EAAE,KAAK,CAAC;IACZ,GAAG,EAAE,mBAAmB,CAAC;IACzB;;;;;;;;OAQG;IACH,OAAO,EAAE,UAAU,GAAG,OAAO,GAAG,WAAW,CAAC;IAC5C;;;;;;OAMG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAC;AAEN;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;;;;;;;OASG;IACH,MAAM,EAAE,MAAM,SAAS,CAAC;IAExB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAEjD,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/shared/assistant/preview/useAssistantPreviewBridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAssistantPreviewBridge.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/preview/useAssistantPreviewBridge.ts"],"names":[],"mappings":"AAyCA,OAAO,KAAK,EAAE,0BAA0B,EAAyB,MAAM,SAAS,CAAC;AAyCjF,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,0BAA0B,GAAG,IAAI,GAC5C,IAAI,CAoKN"}
+{"version":3,"file":"useAssistantPreviewBridge.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/preview/useAssistantPreviewBridge.ts"],"names":[],"mappings":"AA0CA,OAAO,KAAK,EAAE,0BAA0B,EAAyB,MAAM,SAAS,CAAC;AA2CjF,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,0BAA0B,GAAG,IAAI,GAC5C,IAAI,CA0MN"}