@burdenoff/microfe-bigconsole 2026.930.2 → 2026.1001.2

package/dist/bigconsole/AdminRoot.d.ts

@@ -0,0 +1,10 @@
+import { FC } from 'react';
+import { AdminRootProps } from './types';
+
+/**
+ * Root component for the BigConsole admin microfrontend.
+ *
+ * This is the admin entry point that host applications import and render.
+ */
+export declare const AdminRoot: FC<AdminRootProps>;
+//# sourceMappingURL=AdminRoot.d.ts.map

package/dist/bigconsole/AdminRoot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdminRoot.d.ts","sourceRoot":"","sources":["../../src/bigconsole/AdminRoot.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAMhC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAI9C;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,EAAE,CAAC,cAAc,CA0DxC,CAAC"}

package/dist/bigconsole/AdminRoutes.d.ts

@@ -0,0 +1,7 @@
+/**
+ * BigConsole Admin Routes
+ *
+ * Internal routing for the admin surface mounted inside admin-app.
+ */
+export declare function AdminRoutes(): import("react").JSX.Element;
+//# sourceMappingURL=AdminRoutes.d.ts.map

package/dist/bigconsole/AdminRoutes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdminRoutes.d.ts","sourceRoot":"","sources":["../../src/bigconsole/AdminRoutes.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,wBAAgB,WAAW,gCAM1B"}

package/dist/bigconsole/BigConsoleRoot.d.ts

@@ -0,0 +1,29 @@
+import { FC } from 'react';
+import { BigConsoleRootProps } from './types';
+
+/**
+ * Root component for the BigConsole microfrontend.
+ *
+ * This is the main entry point that host applications import and render.
+ * It sets up the necessary providers and renders the internal routing.
+ * Automatically registers navigation items with the shell if registration functions are provided.
+ *
+ * @example
+ * ```tsx
+ * import { BigConsoleRoot, type BigConsoleRootProps } from '@burdenoff/microfe-bigconsole';
+ *
+ * function App() {
+ *   const props: BigConsoleRootProps = {
+ *     basePath: '/analytics',
+ *     navigate: (path) => router.push(path),
+ *     currentUser: { id: '1', email: 'user@example.com' },
+ *     apiGatewayUrl: 'https://api.example.com',
+ *     authToken: 'token',
+ *   };
+ *
+ *   return <BigConsoleRoot {...props} />;
+ * }
+ * ```
+ */
+export declare const BigConsoleRoot: FC<BigConsoleRootProps>;
+//# sourceMappingURL=BigConsoleRoot.d.ts.map

package/dist/bigconsole/BigConsoleRoot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BigConsoleRoot.d.ts","sourceRoot":"","sources":["../../src/bigconsole/BigConsoleRoot.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAQhC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAiEnD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,cAAc,EAAE,EAAE,CAAC,mBAAmB,CAsVlD,CAAC"}

package/dist/bigconsole/BigConsoleRoutes.d.ts

@@ -0,0 +1,6 @@
+import { BigConsoleRootProps } from './types';
+
+/** Generate a new workflow builder path with a fresh UUID key. */
+export declare const newWorkflowPath: () => string;
+export declare function BigConsoleRoutes(_props: BigConsoleRootProps): import("react").JSX.Element;
+//# sourceMappingURL=BigConsoleRoutes.d.ts.map

package/dist/bigconsole/BigConsoleRoutes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BigConsoleRoutes.d.ts","sourceRoot":"","sources":["../../src/bigconsole/BigConsoleRoutes.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAsDnD,kEAAkE;AAClE,eAAO,MAAM,eAAe,cAAwD,CAAC;AA4PrF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,+BAkE3D"}

package/dist/bigconsole/assistant/assistantApi.d.ts

@@ -0,0 +1,91 @@
+import { AssistantMode, AssistantRawMessage, AssistantRawSession, AssistantSandboxAuthContext } from './types';
+import { PageContext } from './pageContext';
+
+/**
+ * The product this transport stamps on every assistant sandbox it creates
+ * (`metadata.assistantProduct`) — the same key the shared fe-libs assistant
+ * stamps for HealthyBowl and VibeControls, and FluidGrids stamps for itself — and
+ * the ONLY product whose sandboxes it will reuse (BOFF-7331).
+ *
+ * ★ The VALUE now comes from `./product`, which is the one place the id is
+ * spelled. This constant keeps its name because the stamp, the env var and the
+ * reuse predicate below all read it — but a second literal spelled the same way
+ * is exactly how `AI_ASSISTANT_PRODUCT` and `metadata.assistantProduct` drift
+ * apart, and `assistantSeamWiring.test.ts` now forbids one.
+ */
+export declare const ASSISTANT_PRODUCT = "bigconsole";
+export declare function isProdRuntime(): boolean;
+/**
+ * Image tag recorded on the sandbox. It is metadata only: the sandbox
+ * cf-proxy's AiAssistant pin decides which image actually runs (plan decision
+ * D9), so the tag is NOT used to pick a sandbox for reuse — see
+ * `isReusableAssistantSandbox`.
+ */
+export declare function getImageTagForMode(mode: AssistantMode, isProd?: boolean): string;
+/**
+ * `assistant` reuses the api-calls image (mode is selected at runtime via
+ * AI_ASSISTANT_MODE). The registry is fe-libs' — the Azure registry this used to
+ * hardcode was decommissioned on 2026-08-15 and is not in wspace-sandbox-svc's
+ * default ALLOWED_IMAGE_REGISTRIES.
+ */
+export declare function getImageForMode(mode: AssistantMode, isProd?: boolean): string;
+export interface ActiveAssistantSandbox {
+    id: string;
+    name: string;
+    status: string;
+    metadata: Record<string, unknown> | null;
+    template: string;
+    createdBy: string;
+}
+/**
+ * May this active sandbox be reused for `mode`?
+ *
+ * Every product's assistant runs as the same user in the same workspace, so
+ * `getActiveSandboxes` returns HealthyBowl's, VibeControls' and FluidGrids'
+ * assistant sandboxes too (BOFF-7331). Adopting one of those runs the wrong
+ * product guide, and HB/VC `api-calls` sandboxes have CONFIRM_WRITES on, which
+ * the legacy widget BigConsole mounts has no Approve UI for. So:
+ *   - the sandbox must be stamped `assistantProduct: 'bigconsole'`. Unstamped
+ *     sandboxes — every BigConsole sandbox created before this change — are NOT
+ *     reused: their product cannot be proven. They lapse on their 600s TTL.
+ *   - a sandbox recording `confirmWrites: true` is never reused, whoever
+ *     stamped it: it waits for approvals this widget cannot give.
+ *   - the image tag is NOT compared (D9). It never decided what runs.
+ *   - ownership FAILS CLOSED: with no `userId` nothing is reusable. fe-libs'
+ *     AuthTokenProvider starts with `userId` null, and a super_admin caller is
+ *     handed every sandbox in the workspace, so skipping the owner check when
+ *     the id is unknown would adopt another user's BigConsole sandbox. The
+ *     caller creates a fresh sandbox instead.
+ */
+export declare function isReusableAssistantSandbox(sandbox: ActiveAssistantSandbox, mode: AssistantMode, userId?: string | null): boolean;
+/**
+ * May a sandbox id cached from an earlier page lifecycle (sessionStorage) be
+ * adopted for `mode`?
+ *
+ * A cached id carries no proof of what it points at: a tab that adopted another
+ * product's, an unstamped or another user's sandbox under an older build would
+ * otherwise keep driving it. So the sandbox is fetched and held to exactly the
+ * same predicate as a freshly listed one. A sandbox that no longer exists is not
+ * reusable. Transport errors propagate; the caller treats them as "not reusable".
+ */
+export declare function isCachedAssistantSandboxReusable(sandboxId: string, workspaceId: string, mode: AssistantMode, authContext?: AssistantSandboxAuthContext): Promise<boolean>;
+export declare function findExistingSandbox(workspaceId: string, mode: AssistantMode, authContext?: AssistantSandboxAuthContext): Promise<string | null>;
+export declare function createAssistantSandbox(mode: AssistantMode, workspaceId: string, authContext?: AssistantSandboxAuthContext): Promise<string>;
+export declare function waitForSandboxReady(sandboxId: string, workspaceId: string, authContext?: AssistantSandboxAuthContext, maxWaitMs?: number): Promise<void>;
+export declare function waitForAssistantServiceReady(sandboxId: string, workspaceId: string, mode: AssistantMode, authContext?: AssistantSandboxAuthContext, maxWaitMs?: number): Promise<void>;
+export declare function createAssistantSession(sandboxId: string, workspaceId: string, mode: AssistantMode, authContext?: AssistantSandboxAuthContext): Promise<{
+    sessionId: string;
+}>;
+/**
+ * All conversations held by this sandbox, newest first.
+ *
+ * The sandbox is the source of truth for the transcript, so the History list is
+ * built from it rather than from anything we cache client-side — what the user
+ * can reopen is exactly what the agent still has.
+ */
+export declare function listAssistantSessions(sandboxId: string, workspaceId: string, authContext?: AssistantSandboxAuthContext): Promise<AssistantRawSession[]>;
+export declare function deleteAssistantSession(sandboxId: string, workspaceId: string, sessionId: string, authContext?: AssistantSandboxAuthContext): Promise<void>;
+export declare function sendAssistantPromptAsync(sandboxId: string, workspaceId: string, sessionId: string, prompt: string, mode: AssistantMode, pageContext?: PageContext, authContext?: AssistantSandboxAuthContext): Promise<void>;
+export declare function getAssistantMessages(sandboxId: string, workspaceId: string, sessionId: string, authContext?: AssistantSandboxAuthContext, limit?: number): Promise<AssistantRawMessage[]>;
+export declare function extendAssistantSandboxTTL(sandboxId: string, workspaceId: string, additionalSeconds?: number, authContext?: AssistantSandboxAuthContext): Promise<void>;
+//# sourceMappingURL=assistantApi.d.ts.map

package/dist/bigconsole/assistant/assistantApi.d.ts.map

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

package/dist/bigconsole/assistant/assistantProduct.d.ts

@@ -0,0 +1,73 @@
+import { LocalUiCommandOptions } from '@burdenoff/fe-libs/shared/assistant/localUiCommands';
+import { AssistantProductProviderProps } from '@burdenoff/fe-libs/shared/assistant/product';
+
+/**
+ * Where this product's assistant files land in the workspace file library.
+ *
+ * ★★ Capitalised as a DISPLAY name while the product id is `bigconsole`, which
+ * is exactly why fe-libs cannot derive it: its fallback is
+ * `/${product}/AI Assistant/…` → `/bigconsole/AI Assistant/…`.
+ *
+ * These strings become load-bearing the moment anything is saved. A wrong value
+ * does not fail loudly — it quietly starts a SECOND folder beside the first and
+ * orphans everything in the original. Today nothing can be orphaned: BigConsole's
+ * legacy transport extracts uploaded files into the prompt and saves nothing to
+ * the library, so no `/BigConsole/AI Assistant/*` path exists yet. That makes
+ * this a free choice now and an expensive one the moment BC4 ships attachments.
+ */
+export declare const STORAGE_FOLDERS: {
+    readonly attachments: "/BigConsole/AI Assistant/Attachments";
+    readonly artifacts: "/BigConsole/AI Assistant/Artifacts";
+};
+/**
+ * How the panel reads a UI command it carries out itself (BOFF-7802), for
+ * BigConsole.
+ *
+ * ★★ `mode-only` because BigConsole's CONTENT has themes of its own: a
+ * dashboard has a theme, so "use the dark theme" in a dashboard builder is a
+ * request about the dashboard, and must reach the model rather than flip the
+ * app. fe-libs names this exact case (`LocalUiCommandOptions.themeWords`). Only
+ * "<name> mode" ("dark mode") or a theme qualified as the app's ("change the
+ * app theme to dark") still changes the app locally, with no turn.
+ *
+ * ★ Its own exported constant so the seam test can pin the field by identity,
+ * like every other field on the seam value.
+ */
+export declare const LOCAL_UI_COMMANDS: LocalUiCommandOptions;
+/**
+ * Every seam field, required — the provider's props minus its children, and
+ * minus the two answers BigConsole deliberately does not give.
+ *
+ * ★★ `reportTokenUsage` is omitted ON EVIDENCE, not by oversight, and this
+ * `Omit` member is the only place that decision is expressed in the type system.
+ * `wspace-bigconsole-svc` declares NO token-usage mutation at all, and nothing in
+ * this MFE reports one today. The obvious "fix" — wiring fe-libs' shared
+ * reporter — would bill VibeControls for BigConsole turns: `reportAiTokenUsage`
+ * is declared only in `wspace-vibecontrols-svc`, against the
+ * `vibecontrols.ai.credits` quota. Metering BigConsole is a backend change.
+ *
+ * Note that BigConsole's `bigconsole.*` quotas are a different mechanism —
+ * they cap entity counts, not AI spend — so their presence is not evidence that
+ * turns are metered.
+ *
+ * ★★ `confirmWrite` is omitted so a HIGH-risk write proposal is confirmed in
+ * fe-libs' shared `AssistantWriteConfirmDialog` (BOFF-7803 5a). That is the
+ * documented default when a product has no dialog of its own, and BigConsole
+ * has none. A product dialog must meet the whole contract fe-libs sets for it
+ * (readback, target count, consequences, the exact confirm label, sensitive
+ * values masked, never `window.confirm`), and the shared one already does, so a
+ * BigConsole copy would only be a second place for that to go wrong. The
+ * bigconsole-app ambient declaration of this value mirrors this `Omit`.
+ */
+export type BigConsoleAssistantProduct = Required<Omit<AssistantProductProviderProps, 'children' | 'reportTokenUsage' | 'confirmWrite'>>;
+/**
+ * ★ Each field points at a product-owned implementation BY IDENTITY — no inline
+ * arrow wrappers. The seam guard asserts `toBe`, because a wrapper is how a
+ * function silently stops being the one the tests cover.
+ *
+ * ★ `writeAccess` is deliberately absent: it is a PROP on the shared panel, not
+ * a seam field, so it belongs to BC4's panel mount rather than here. Same for
+ * the preview controller, which the panel takes as `panelProps.preview`.
+ */
+export declare const BIGCONSOLE_ASSISTANT_PRODUCT: BigConsoleAssistantProduct;
+//# sourceMappingURL=assistantProduct.d.ts.map

package/dist/bigconsole/assistant/assistantProduct.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistantProduct.d.ts","sourceRoot":"","sources":["../../../src/bigconsole/assistant/assistantProduct.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qDAAqD,CAAC;AACjG,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,6CAA6C,CAAC;AAOjG;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,eAAe;;;CAGlB,CAAC;AAEX;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,iBAAiB,EAAE,qBAAmD,CAAC;AAEpF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,0BAA0B,GAAG,QAAQ,CAC/C,IAAI,CAAC,6BAA6B,EAAE,UAAU,GAAG,kBAAkB,GAAG,cAAc,CAAC,CACtF,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,4BAA4B,EAAE,0BA+B1C,CAAC"}

package/dist/bigconsole/assistant/assistantPrompt.d.ts

@@ -0,0 +1,48 @@
+import { AssistantPromptOptions } from '@burdenoff/fe-libs/shared/assistant/product';
+import { AssistantMode } from '@burdenoff/fe-libs/shared/assistant/types';
+
+/**
+ * Marks where our instructions stop and the user's words begin. Exactly one may
+ * exist in a prompt, and it must be last — see `buildPromptForMode`.
+ */
+export declare const USER_REQUEST_DELIMITER = "--- User request ---";
+/**
+ * The write rules for a Build turn to a LEGACY sandbox, which runs a mutation
+ * itself. Unchanged by BOFF-7803 5a, byte for byte.
+ */
+export declare const API_CALLS_CONFIRM_PREAMBLE: string;
+/**
+ * The write rules for a Build turn to a PROPOSAL-V1 sandbox (BOFF-7803 5a),
+ * composed exactly as fe-libs documents it: the shared rules, a blank line,
+ * then this product's own delimiter.
+ *
+ * ★★ The rules are fe-libs' `PROPOSAL_WRITE_RULES`, not a BigConsole rewrite.
+ * They are kept consistent with the sandbox's own proposal policy, so a local
+ * copy would be a second text to keep in step with it. They carry no delimiter
+ * of their own, so this one is the only one, and it is last, as after the
+ * legacy preamble.
+ */
+export declare const API_CALLS_PROPOSAL_PREAMBLE: string;
+/**
+ * Compose the turn actually sent to the agent.
+ *
+ * Ordering is deliberate. Dictation goes AFTER the language lines and before the
+ * delimiter: it is an instruction about the user's text, so it belongs with the
+ * instructions rather than inside them.
+ *
+ * ★★ `USER_REQUEST_DELIMITER` is emitted exactly once, here. Both api-calls
+ * preambles end with their own copy, so it must not be added again — a second
+ * one mid-prompt leaves the safety instructions sitting *after* a "User request"
+ * marker, i.e. presented to the model as though the user had written them.
+ *
+ * ★★ `options` is fe-libs' sixth argument (BOFF-7803 5a): what the sandbox this
+ * turn goes to enforces, from its own `/health` — never this product's flag,
+ * which only says what BigConsole ASKS for. A proposal-v1 sandbox gets the
+ * proposal rules; every other turn is composed exactly as before.
+ *
+ * ★ No branch for Ask (`assistant`). It is read-only — its sandbox boots with
+ * `AI_ASSISTANT_READONLY=1` — so there is no write to confirm, and inventing a
+ * confirmation preamble for it would be copy that lies about what the mode does.
+ */
+export declare function buildPromptForMode(mode: AssistantMode, content: string, languageName?: string, isExplicitChoice?: boolean, dictated?: boolean, options?: AssistantPromptOptions): string;
+//# sourceMappingURL=assistantPrompt.d.ts.map

package/dist/bigconsole/assistant/assistantPrompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistantPrompt.d.ts","sourceRoot":"","sources":["../../../src/bigconsole/assistant/assistantPrompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AAE1F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAE/E;;;GAGG;AACH,eAAO,MAAM,sBAAsB,yBAAyB,CAAC;AAE7D;;;GAGG;AACH,eAAO,MAAM,0BAA0B,QAQ3B,CAAC;AAEb;;;;;;;;;;GAUG;AACH,eAAO,MAAM,2BAA2B,QAAuE,CAAC;AAwEhH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,EACrB,gBAAgB,UAAQ,EACxB,QAAQ,UAAQ,EAChB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,MAAM,CAWR"}

package/dist/bigconsole/assistant/assistantRunPersistence.d.ts

@@ -0,0 +1,30 @@
+import { PreviewStepKey, PreviewStepStatus } from './assistantRunStore';
+
+/** `sessionStorage` key prefix; the workspace id follows it. */
+export declare const RUN_STORAGE_PREFIX = "bigconsole.assistant.previewRun.v1:";
+/** The slice of the run store that survives a reload. */
+export interface PersistedRun {
+    hasRun: true;
+    conversationId?: string;
+    previewOpen: boolean;
+    steps: Record<PreviewStepKey, PreviewStepStatus>;
+    entityIds: {
+        datasink?: string;
+        dashboard?: string;
+        parser?: string;
+    };
+    updatedAt: number | null;
+}
+export declare function runStorageKey(workspaceId: string): string;
+/**
+ * The run kept for this workspace and actor, or null.
+ *
+ * ★ A record written for another actor is left in place, not deleted: it is
+ * that actor's, and they may switch back. A corrupt record is removed.
+ */
+export declare function readPersistedRun(workspaceId: string, actorId: string | null): PersistedRun | null;
+/** Keeps `run` for this workspace, owned by `actorId`. Best effort. */
+export declare function writePersistedRun(workspaceId: string, actorId: string | null, run: PersistedRun): void;
+/** Forgets the run kept for this workspace. Best effort. */
+export declare function removePersistedRun(workspaceId: string): void;
+//# sourceMappingURL=assistantRunPersistence.d.ts.map

package/dist/bigconsole/assistant/assistantRunPersistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistantRunPersistence.d.ts","sourceRoot":"","sources":["../../../src/bigconsole/assistant/assistantRunPersistence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7E,gEAAgE;AAChE,eAAO,MAAM,kBAAkB,wCAAwC,CAAC;AAExE,yDAAyD;AACzD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,IAAI,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC;IACjD,SAAS,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAmBD,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzD;AAiED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,YAAY,GAAG,IAAI,CAgCjG;AAED,uEAAuE;AACvE,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,YAAY,GAAG,IAAI,CAkBtG;AAED,4DAA4D;AAC5D,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAQ5D"}

package/dist/bigconsole/assistant/assistantRunPersistence.js

@@ -33,30 +33,31 @@ function c(e) {
 		return null;
 	}
 	if (!o(t) || t.v !== 1 || t.hasRun !== !0) return null;
-	let { previewOpen: i, actorId: a, updatedAt: c, steps: l, entityIds: u } = t;
-	if (typeof i != "boolean" || a !== null && typeof a != "string" || c !== null && (typeof c != "number" || !Number.isFinite(c)) || !o(l)) return null;
-	let { datasink: d, dashboard: f, parser: p, widget: m } = l;
-	if (!s(d) || !s(f) || !s(p) || !s(m) || !o(u)) return null;
-	let h = {};
+	let { previewOpen: i, actorId: a, updatedAt: c, steps: l, entityIds: u, conversationId: d } = t;
+	if (d !== void 0 && (typeof d != "string" || !r.test(d)) || typeof i != "boolean" || a !== null && typeof a != "string" || c !== null && (typeof c != "number" || !Number.isFinite(c)) || !o(l)) return null;
+	let { datasink: f, dashboard: p, parser: m, widget: h } = l;
+	if (!s(f) || !s(p) || !s(m) || !s(h) || !o(u)) return null;
+	let g = {};
 	for (let e of n) {
 		let t = u[e];
 		if (t !== void 0) {
 			if (typeof t != "string" || !r.test(t)) return null;
-			h[e] = t;
+			g[e] = t;
 		}
 	}
 	return {
 		v: 1,
 		actorId: a,
 		hasRun: !0,
+		...typeof d == "string" ? { conversationId: d } : {},
 		previewOpen: i,
 		steps: {
-			datasink: d,
-			dashboard: f,
-			parser: p,
-			widget: m
+			datasink: f,
+			dashboard: p,
+			parser: m,
+			widget: h
 		},
-		entityIds: h,
+		entityIds: g,
 		updatedAt: c
 	};
 }
@@ -77,6 +78,7 @@ function l(e, n) {
 	for (let e of t) l[e] === "running" && (l[e] = "pending");
 	return {
 		hasRun: !0,
+		...s.conversationId ? { conversationId: s.conversationId } : {},
 		previewOpen: s.previewOpen,
 		steps: l,
 		entityIds: s.entityIds,
@@ -90,6 +92,7 @@ function u(e, t, n) {
 		v: 1,
 		actorId: t,
 		hasRun: !0,
+		...n.conversationId ? { conversationId: n.conversationId } : {},
 		previewOpen: n.previewOpen,
 		steps: n.steps,
 		entityIds: n.entityIds,

package/dist/bigconsole/assistant/assistantRunPersistence.js.map

@@ -1 +1 @@
-{"version":3,"file":"assistantRunPersistence.js","names":[],"sources":["../../../src/bigconsole/assistant/assistantRunPersistence.ts"],"sourcesContent":["/**\n * The build preview's run state, kept for the life of the TAB (BOFF-7799, A3).\n *\n * ★★★ WHY. BigConsole restores the conversation from the server\n * (`SERVER_HISTORY`), but the preview's run store lived only in memory. A\n * reload kept the chat and lost the page preview under the breadcrumb, so the\n * build a user had just watched was gone while the conversation that made it\n * was still on screen. This keeps the part the page preview draws, and nothing\n * else, in `sessionStorage`.\n *\n * ★★ WHAT IS KEPT, AND WHAT IS NOT. Kept: `hasRun`, whether the preview is\n * open, the four step statuses, the entity ids and the last-update time. None\n * of that is sensitive: the ids name workspace resources the server still\n * authorises on every fetch. NOT kept: the prompt (the user's own words), the\n * caption (the agent's narration) and the error text. `isRunning` is not kept\n * either: nothing can follow a turn across a reload, so a restored `running`\n * step drops back to `pending`, exactly as `finishRun` does.\n *\n * ★★ ONE ENTRY PER WORKSPACE, and it names its actor. The key carries the\n * workspace, so a reload in another workspace never reads this one. The record\n * carries the actor it was written for, because fe-libs found that the\n * workspace alone is not an identity: two accounts can share a workspace and a\n * tab (profile switching), and the second must not be shown the first one's\n * build (see fe-libs `AssistantPreviewRun.actorId`).\n *\n * ★ EVERY STORAGE ACCESS IS CONTAINED. `sessionStorage` can be missing (tests,\n * SSR), can throw on access (blocked site data, sandboxed frames) and can throw\n * on write (quota). Any of those means \"nothing kept\", never an exception in\n * the page surface or in the store action that triggered the write.\n */\nimport type { PreviewStepKey, PreviewStepStatus } from './assistantRunStore';\n\n/** `sessionStorage` key prefix; the workspace id follows it. */\nexport const RUN_STORAGE_PREFIX = 'bigconsole.assistant.previewRun.v1:';\n\n/** The slice of the run store that survives a reload. */\nexport interface PersistedRun {\n  hasRun: true;\n  previewOpen: boolean;\n  steps: Record<PreviewStepKey, PreviewStepStatus>;\n  entityIds: { datasink?: string; dashboard?: string; parser?: string };\n  updatedAt: number | null;\n}\n\n/** What is actually written: the slice, its format version and its owner. */\ninterface StoredRun extends PersistedRun {\n  v: 1;\n  actorId: string | null;\n}\n\nconst STEP_KEYS: readonly PreviewStepKey[] = ['datasink', 'dashboard', 'parser', 'widget'];\nconst ENTITY_KEYS = ['datasink', 'dashboard', 'parser'] as const;\n\n/**\n * ★★ The id charset the store itself harvests (`ENTITY_LINK`, `JSON_ID_STEPS`).\n * Restored ids are interpolated into in-app paths (`/bigconsole/datasinks/<id>`),\n * so a value edited in devtools must not be able to smuggle `../` or a query\n * string into a navigation. Anything else is treated as a corrupt record.\n */\nconst ENTITY_ID = /^[A-Za-z0-9_-]{1,128}$/;\n\nexport function runStorageKey(workspaceId: string): string {\n  return `${RUN_STORAGE_PREFIX}${workspaceId}`;\n}\n\n/** The tab's `sessionStorage`, or null wherever it cannot be used. */\nfunction sessionStore(): Storage | null {\n  try {\n    // ★ Reading the property is itself the access that throws when site data\n    // is blocked, so the `typeof` guard sits inside the try, not before it.\n    return typeof globalThis.sessionStorage === 'undefined' ? null : globalThis.sessionStorage;\n  } catch {\n    return null;\n  }\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isStepStatus(value: unknown): value is PreviewStepStatus {\n  return value === 'pending' || value === 'running' || value === 'done' || value === 'skipped';\n}\n\n/** Parses and validates one stored record. Any deviation reads as absent. */\nfunction parseStoredRun(raw: string): StoredRun | null {\n  let value: unknown;\n  try {\n    value = JSON.parse(raw);\n  } catch {\n    return null;\n  }\n  if (!isRecord(value) || value.v !== 1 || value.hasRun !== true) return null;\n\n  const { previewOpen, actorId, updatedAt, steps, entityIds } = value;\n  if (typeof previewOpen !== 'boolean') return null;\n  if (actorId !== null && typeof actorId !== 'string') return null;\n  if (updatedAt !== null && (typeof updatedAt !== 'number' || !Number.isFinite(updatedAt))) return null;\n\n  if (!isRecord(steps)) return null;\n  const { datasink, dashboard, parser, widget } = steps;\n  if (!isStepStatus(datasink) || !isStepStatus(dashboard) || !isStepStatus(parser) || !isStepStatus(widget)) {\n    return null;\n  }\n\n  if (!isRecord(entityIds)) return null;\n  const ids: PersistedRun['entityIds'] = {};\n  for (const key of ENTITY_KEYS) {\n    const id = entityIds[key];\n    if (id === undefined) continue;\n    if (typeof id !== 'string' || !ENTITY_ID.test(id)) return null;\n    ids[key] = id;\n  }\n\n  return {\n    v: 1,\n    actorId,\n    hasRun: true,\n    previewOpen,\n    steps: { datasink, dashboard, parser, widget },\n    entityIds: ids,\n    updatedAt,\n  };\n}\n\n/**\n * The run kept for this workspace and actor, or null.\n *\n * ★ A record written for another actor is left in place, not deleted: it is\n * that actor's, and they may switch back. A corrupt record is removed.\n */\nexport function readPersistedRun(workspaceId: string, actorId: string | null): PersistedRun | null {\n  const storage = sessionStore();\n  if (!storage) return null;\n  let raw: string | null;\n  try {\n    raw = storage.getItem(runStorageKey(workspaceId));\n  } catch {\n    return null;\n  }\n  if (raw === null) return null;\n\n  const stored = parseStoredRun(raw);\n  if (!stored) {\n    removePersistedRun(workspaceId);\n    return null;\n  }\n  if (stored.actorId !== actorId) return null;\n\n  // Nothing follows a turn across a reload: a step that was in flight did not\n  // land, so it drops back to `pending` for a later prompt (as `finishRun` does).\n  const steps = { ...stored.steps };\n  for (const key of STEP_KEYS) {\n    if (steps[key] === 'running') steps[key] = 'pending';\n  }\n  return {\n    hasRun: true,\n    previewOpen: stored.previewOpen,\n    steps,\n    entityIds: stored.entityIds,\n    updatedAt: stored.updatedAt,\n  };\n}\n\n/** Keeps `run` for this workspace, owned by `actorId`. Best effort. */\nexport function writePersistedRun(workspaceId: string, actorId: string | null, run: PersistedRun): void {\n  const storage = sessionStore();\n  if (!storage) return;\n  const stored: StoredRun = {\n    v: 1,\n    actorId,\n    hasRun: true,\n    previewOpen: run.previewOpen,\n    steps: run.steps,\n    entityIds: run.entityIds,\n    updatedAt: run.updatedAt,\n  };\n  try {\n    storage.setItem(runStorageKey(workspaceId), JSON.stringify(stored));\n  } catch {\n    // Quota or blocked storage: the preview simply does not survive a reload.\n  }\n}\n\n/** Forgets the run kept for this workspace. Best effort. */\nexport function removePersistedRun(workspaceId: string): void {\n  const storage = sessionStore();\n  if (!storage) return;\n  try {\n    storage.removeItem(runStorageKey(workspaceId));\n  } catch {\n    // Blocked storage: there is nothing we could have read back either.\n  }\n}\n"],"mappings":";AAiCA,IAAa,IAAqB,uCAiB5B,IAAuC;CAAC;CAAY;CAAa;CAAU;CAAS,EACpF,IAAc;CAAC;CAAY;CAAa;CAAS,EAQjD,IAAY;AAElB,SAAgB,EAAc,GAA6B;AACzD,QAAO,GAAG,IAAqB;;AAIjC,SAAS,IAA+B;AACtC,KAAI;AAGF,SAAc,WAAW,mBAAmB,SAAc,OAAO,WAAW;SACtE;AACN,SAAO;;;AAIX,SAAS,EAAS,GAAkD;AAClE,QAAO,OAAO,KAAU,cAAY,KAAkB,CAAC,MAAM,QAAQ,EAAM;;AAG7E,SAAS,EAAa,GAA4C;AAChE,QAAO,MAAU,aAAa,MAAU,aAAa,MAAU,UAAU,MAAU;;AAIrF,SAAS,EAAe,GAA+B;CACrD,IAAI;AACJ,KAAI;AACF,MAAQ,KAAK,MAAM,EAAI;SACjB;AACN,SAAO;;AAET,KAAI,CAAC,EAAS,EAAM,IAAI,EAAM,MAAM,KAAK,EAAM,WAAW,GAAM,QAAO;CAEvE,IAAM,EAAE,gBAAa,YAAS,cAAW,UAAO,iBAAc;AAK9D,KAJI,OAAO,KAAgB,aACvB,MAAY,QAAQ,OAAO,KAAY,YACvC,MAAc,SAAS,OAAO,KAAc,YAAY,CAAC,OAAO,SAAS,EAAU,KAEnF,CAAC,EAAS,EAAM,CAAE,QAAO;CAC7B,IAAM,EAAE,aAAU,cAAW,WAAQ,cAAW;AAKhD,KAJI,CAAC,EAAa,EAAS,IAAI,CAAC,EAAa,EAAU,IAAI,CAAC,EAAa,EAAO,IAAI,CAAC,EAAa,EAAO,IAIrG,CAAC,EAAS,EAAU,CAAE,QAAO;CACjC,IAAM,IAAiC,EAAE;AACzC,MAAK,IAAM,KAAO,GAAa;EAC7B,IAAM,IAAK,EAAU;AACjB,YAAO,KAAA,GACX;OAAI,OAAO,KAAO,YAAY,CAAC,EAAU,KAAK,EAAG,CAAE,QAAO;AAC1D,KAAI,KAAO;;;AAGb,QAAO;EACL,GAAG;EACH;EACA,QAAQ;EACR;EACA,OAAO;GAAE;GAAU;GAAW;GAAQ;GAAQ;EAC9C,WAAW;EACX;EACD;;AASH,SAAgB,EAAiB,GAAqB,GAA6C;CACjG,IAAM,IAAU,GAAc;AAC9B,KAAI,CAAC,EAAS,QAAO;CACrB,IAAI;AACJ,KAAI;AACF,MAAM,EAAQ,QAAQ,EAAc,EAAY,CAAC;SAC3C;AACN,SAAO;;AAET,KAAI,MAAQ,KAAM,QAAO;CAEzB,IAAM,IAAS,EAAe,EAAI;AAClC,KAAI,CAAC,EAEH,QADA,EAAmB,EAAY,EACxB;AAET,KAAI,EAAO,YAAY,EAAS,QAAO;CAIvC,IAAM,IAAQ,EAAE,GAAG,EAAO,OAAO;AACjC,MAAK,IAAM,KAAO,EAChB,CAAI,EAAM,OAAS,cAAW,EAAM,KAAO;AAE7C,QAAO;EACL,QAAQ;EACR,aAAa,EAAO;EACpB;EACA,WAAW,EAAO;EAClB,WAAW,EAAO;EACnB;;AAIH,SAAgB,EAAkB,GAAqB,GAAwB,GAAyB;CACtG,IAAM,IAAU,GAAc;AAC9B,KAAI,CAAC,EAAS;CACd,IAAM,IAAoB;EACxB,GAAG;EACH;EACA,QAAQ;EACR,aAAa,EAAI;EACjB,OAAO,EAAI;EACX,WAAW,EAAI;EACf,WAAW,EAAI;EAChB;AACD,KAAI;AACF,IAAQ,QAAQ,EAAc,EAAY,EAAE,KAAK,UAAU,EAAO,CAAC;SAC7D;;AAMV,SAAgB,EAAmB,GAA2B;CAC5D,IAAM,IAAU,GAAc;AACzB,OACL,KAAI;AACF,IAAQ,WAAW,EAAc,EAAY,CAAC;SACxC"}
+{"version":3,"file":"assistantRunPersistence.js","names":[],"sources":["../../../src/bigconsole/assistant/assistantRunPersistence.ts"],"sourcesContent":["/**\n * The build preview's run state, kept for the life of the TAB (BOFF-7799, A3).\n *\n * ★★★ WHY. BigConsole restores the conversation from the server\n * (`SERVER_HISTORY`), but the preview's run store lived only in memory. A\n * reload kept the chat and lost the page preview under the breadcrumb, so the\n * build a user had just watched was gone while the conversation that made it\n * was still on screen. This keeps the part the page preview draws, and nothing\n * else, in `sessionStorage`.\n *\n * ★★ WHAT IS KEPT, AND WHAT IS NOT. Kept: `hasRun`, whether the preview is\n * open, the four step statuses, the entity ids and the last-update time. None\n * of that is sensitive: the ids name workspace resources the server still\n * authorises on every fetch. NOT kept: the prompt (the user's own words), the\n * caption (the agent's narration) and the error text. `isRunning` is not kept\n * either: nothing can follow a turn across a reload, so a restored `running`\n * step drops back to `pending`, exactly as `finishRun` does.\n *\n * ★★ ONE ENTRY PER WORKSPACE, and it names its actor. The key carries the\n * workspace, so a reload in another workspace never reads this one. The record\n * carries the actor it was written for, because fe-libs found that the\n * workspace alone is not an identity: two accounts can share a workspace and a\n * tab (profile switching), and the second must not be shown the first one's\n * build (see fe-libs `AssistantPreviewRun.actorId`).\n *\n * ★ EVERY STORAGE ACCESS IS CONTAINED. `sessionStorage` can be missing (tests,\n * SSR), can throw on access (blocked site data, sandboxed frames) and can throw\n * on write (quota). Any of those means \"nothing kept\", never an exception in\n * the page surface or in the store action that triggered the write.\n */\nimport type { PreviewStepKey, PreviewStepStatus } from './assistantRunStore';\n\n/** `sessionStorage` key prefix; the workspace id follows it. */\nexport const RUN_STORAGE_PREFIX = 'bigconsole.assistant.previewRun.v1:';\n\n/** The slice of the run store that survives a reload. */\nexport interface PersistedRun {\n  hasRun: true;\n  conversationId?: string;\n  previewOpen: boolean;\n  steps: Record<PreviewStepKey, PreviewStepStatus>;\n  entityIds: { datasink?: string; dashboard?: string; parser?: string };\n  updatedAt: number | null;\n}\n\n/** What is actually written: the slice, its format version and its owner. */\ninterface StoredRun extends PersistedRun {\n  v: 1;\n  actorId: string | null;\n}\n\nconst STEP_KEYS: readonly PreviewStepKey[] = ['datasink', 'dashboard', 'parser', 'widget'];\nconst ENTITY_KEYS = ['datasink', 'dashboard', 'parser'] as const;\n\n/**\n * ★★ The id charset the store itself harvests (`ENTITY_LINK`, `JSON_ID_STEPS`).\n * Restored ids are interpolated into in-app paths (`/bigconsole/datasinks/<id>`),\n * so a value edited in devtools must not be able to smuggle `../` or a query\n * string into a navigation. Anything else is treated as a corrupt record.\n */\nconst ENTITY_ID = /^[A-Za-z0-9_-]{1,128}$/;\n\nexport function runStorageKey(workspaceId: string): string {\n  return `${RUN_STORAGE_PREFIX}${workspaceId}`;\n}\n\n/** The tab's `sessionStorage`, or null wherever it cannot be used. */\nfunction sessionStore(): Storage | null {\n  try {\n    // ★ Reading the property is itself the access that throws when site data\n    // is blocked, so the `typeof` guard sits inside the try, not before it.\n    return typeof globalThis.sessionStorage === 'undefined' ? null : globalThis.sessionStorage;\n  } catch {\n    return null;\n  }\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isStepStatus(value: unknown): value is PreviewStepStatus {\n  return value === 'pending' || value === 'running' || value === 'done' || value === 'skipped';\n}\n\n/** Parses and validates one stored record. Any deviation reads as absent. */\nfunction parseStoredRun(raw: string): StoredRun | null {\n  let value: unknown;\n  try {\n    value = JSON.parse(raw);\n  } catch {\n    return null;\n  }\n  if (!isRecord(value) || value.v !== 1 || value.hasRun !== true) return null;\n\n  const { previewOpen, actorId, updatedAt, steps, entityIds, conversationId } = value;\n  if (conversationId !== undefined && (typeof conversationId !== 'string' || !ENTITY_ID.test(conversationId)))\n    return null;\n  if (typeof previewOpen !== 'boolean') return null;\n  if (actorId !== null && typeof actorId !== 'string') return null;\n  if (updatedAt !== null && (typeof updatedAt !== 'number' || !Number.isFinite(updatedAt))) return null;\n\n  if (!isRecord(steps)) return null;\n  const { datasink, dashboard, parser, widget } = steps;\n  if (!isStepStatus(datasink) || !isStepStatus(dashboard) || !isStepStatus(parser) || !isStepStatus(widget)) {\n    return null;\n  }\n\n  if (!isRecord(entityIds)) return null;\n  const ids: PersistedRun['entityIds'] = {};\n  for (const key of ENTITY_KEYS) {\n    const id = entityIds[key];\n    if (id === undefined) continue;\n    if (typeof id !== 'string' || !ENTITY_ID.test(id)) return null;\n    ids[key] = id;\n  }\n\n  return {\n    v: 1,\n    actorId,\n    hasRun: true,\n    ...(typeof conversationId === 'string' ? { conversationId } : {}),\n    previewOpen,\n    steps: { datasink, dashboard, parser, widget },\n    entityIds: ids,\n    updatedAt,\n  };\n}\n\n/**\n * The run kept for this workspace and actor, or null.\n *\n * ★ A record written for another actor is left in place, not deleted: it is\n * that actor's, and they may switch back. A corrupt record is removed.\n */\nexport function readPersistedRun(workspaceId: string, actorId: string | null): PersistedRun | null {\n  const storage = sessionStore();\n  if (!storage) return null;\n  let raw: string | null;\n  try {\n    raw = storage.getItem(runStorageKey(workspaceId));\n  } catch {\n    return null;\n  }\n  if (raw === null) return null;\n\n  const stored = parseStoredRun(raw);\n  if (!stored) {\n    removePersistedRun(workspaceId);\n    return null;\n  }\n  if (stored.actorId !== actorId) return null;\n\n  // Nothing follows a turn across a reload: a step that was in flight did not\n  // land, so it drops back to `pending` for a later prompt (as `finishRun` does).\n  const steps = { ...stored.steps };\n  for (const key of STEP_KEYS) {\n    if (steps[key] === 'running') steps[key] = 'pending';\n  }\n  return {\n    hasRun: true,\n    ...(stored.conversationId ? { conversationId: stored.conversationId } : {}),\n    previewOpen: stored.previewOpen,\n    steps,\n    entityIds: stored.entityIds,\n    updatedAt: stored.updatedAt,\n  };\n}\n\n/** Keeps `run` for this workspace, owned by `actorId`. Best effort. */\nexport function writePersistedRun(workspaceId: string, actorId: string | null, run: PersistedRun): void {\n  const storage = sessionStore();\n  if (!storage) return;\n  const stored: StoredRun = {\n    v: 1,\n    actorId,\n    hasRun: true,\n    ...(run.conversationId ? { conversationId: run.conversationId } : {}),\n    previewOpen: run.previewOpen,\n    steps: run.steps,\n    entityIds: run.entityIds,\n    updatedAt: run.updatedAt,\n  };\n  try {\n    storage.setItem(runStorageKey(workspaceId), JSON.stringify(stored));\n  } catch {\n    // Quota or blocked storage: the preview simply does not survive a reload.\n  }\n}\n\n/** Forgets the run kept for this workspace. Best effort. */\nexport function removePersistedRun(workspaceId: string): void {\n  const storage = sessionStore();\n  if (!storage) return;\n  try {\n    storage.removeItem(runStorageKey(workspaceId));\n  } catch {\n    // Blocked storage: there is nothing we could have read back either.\n  }\n}\n"],"mappings":"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"}

package/dist/bigconsole/assistant/assistantRunStore.d.ts

@@ -0,0 +1,75 @@
+export type PreviewStepKey = 'datasink' | 'dashboard' | 'parser' | 'widget';
+export type PreviewStepStatus = 'pending' | 'running' | 'done' | 'skipped';
+export declare const PREVIEW_STEPS: readonly PreviewStepKey[];
+interface AssistantRunState {
+    /** A turn is in flight. */
+    isRunning: boolean;
+    /** The panel is on screen. Auto-opens when a turn starts; the user can close it. */
+    previewOpen: boolean;
+    /** True once any turn has run — gates the "Preview" button. */
+    hasRun: boolean;
+    /**
+     * The full, context-rich panel (mounted inside BigConsoleRoot, with live entity
+     * tabs) is on screen right now. The lightweight app-shell panel reads this and
+     * steps aside so the two never render at once. It flips false the instant you
+     * leave a /bigconsole page — that is what lets the mini panel take over and keep
+     * the build visible on whatever screen you moved to.
+     */
+    richMounted: boolean;
+    prompt: string;
+    steps: Record<PreviewStepKey, PreviewStepStatus>;
+    /** Ids harvested from the agent's links. A widget has no link of its own. */
+    entityIds: {
+        datasink?: string;
+        dashboard?: string;
+        parser?: string;
+    };
+    /** Newest "⏳ …" line — what the agent says it is doing this second. */
+    caption: string;
+    /** Set when the turn fails, so the panel can stop pretending to be live. */
+    error: string | null;
+    /** Epoch ms of the last progress tick — drives the "updated 3s ago" strip. */
+    updatedAt: number | null;
+    /**
+     * The workspace this run belongs to, and the one its kept copy is filed
+     * under. Null until a page surface binds the active workspace.
+     */
+    workspaceId: string | null;
+    /** The actor the kept copy is written for, read once when the workspace is bound. */
+    actorId: string | null;
+    conversationId: string | null;
+    contentRevision: number;
+    completedResultIds: string[];
+    entityResultOrder: Partial<Record<PreviewStepKey, number>>;
+    startRun: (prompt: string, conversationId?: string) => void;
+    applyResult: (id: string, output: unknown, messageOrder?: number) => void;
+    applyProgress: (content: string) => void;
+    finishRun: (error: string | null) => void;
+    openPreview: () => void;
+    closePreview: () => void;
+    setRichMounted: (mounted: boolean) => void;
+    /**
+     * Point the store at the active workspace. A change CLEARS the run and forgets
+     * the previous workspace's kept copy, then restores this workspace's copy, if
+     * this tab kept one for this actor. Binding the same workspace is a no-op, so
+     * every surface may call it.
+     */
+    bindWorkspace: (workspaceId: string | null) => void;
+}
+/**
+ * May a run that started in `runWorkspaceId` drive a store bound to
+ * `boundWorkspaceId`?
+ *
+ * ★★ WHY IT EXISTS. A workspace switch clears the store, but a turn started in
+ * the previous workspace keeps streaming. Without this its next snapshot would
+ * refill the cleared store, and the refill would be kept under the NEW
+ * workspace's key, which is the leak the switch exists to prevent.
+ *
+ * ★ Lenient on null, deliberately: fe-libs reports `null` when it cannot read
+ * the workspace, and an unbound store has nothing to protect. Refusing either
+ * would silently stop every preview rather than guard one.
+ */
+export declare function runBelongsToWorkspace(runWorkspaceId: string | null, boundWorkspaceId: string | null): boolean;
+export declare const useAssistantRunStore: import('zustand').UseBoundStore<import('zustand').StoreApi<AssistantRunState>>;
+export {};
+//# sourceMappingURL=assistantRunStore.d.ts.map

package/dist/bigconsole/assistant/assistantRunStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistantRunStore.d.ts","sourceRoot":"","sources":["../../../src/bigconsole/assistant/assistantRunStore.ts"],"names":[],"mappings":"AA+BA,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAC5E,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;AAE3E,eAAO,MAAM,aAAa,EAAE,SAAS,cAAc,EAAkD,CAAC;AAEtG,UAAU,iBAAiB;IACzB,2BAA2B;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,oFAAoF;IACpF,WAAW,EAAE,OAAO,CAAC;IACrB,+DAA+D;IAC/D,MAAM,EAAE,OAAO,CAAC;IAChB;;;;;;OAMG;IACH,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC;IACjD,6EAA6E;IAC7E,SAAS,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,8EAA8E;IAC9E,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;OAGG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,qFAAqF;IACrF,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,iBAAiB,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3D,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5D,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1E,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAC1C,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,cAAc,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3C;;;;;OAKG;IACH,aAAa,EAAE,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CACrD;AA6ED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,EAAE,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAE7G;AAED,eAAO,MAAM,oBAAoB,gFAuJ9B,CAAC"}