@belonguniverseai/react-sdk 0.4.0 → 0.4.1

package/dist/component/{mindmap-definition-RKZ34NQL-DeQED-9b.js → mindmap-definition-RKZ34NQL-cTac4kYU.js}

@@ -1,6 +1,6 @@
-import { g as oe } from "./chunk-55IACEB6-CcJHjxtI.js";
-import { s as ae } from "./chunk-2J33WTMH-DdP5frJt.js";
-import { _ as l, l as C, p as ce, r as le, G as he, K as G, c as B, i as F, b6 as de, af as ge, ag as ue, ah as pe } from "./mermaid-GHXKKRXX-iO2IZZUN.js";
+import { g as oe } from "./chunk-55IACEB6-23v_td5T.js";
+import { s as ae } from "./chunk-2J33WTMH-X2Iy3mMD.js";
+import { _ as l, l as C, p as ce, r as le, G as he, K as G, c as B, i as F, b6 as de, af as ge, ag as ue, ah as pe } from "./mermaid-GHXKKRXX-D7NVqIBP.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
 const b = [];
@@ -830,4 +830,4 @@ var _e = Y, ke = 12, N = {
 export {
   we as diagram
 };
-//# sourceMappingURL=mindmap-definition-RKZ34NQL-DeQED-9b.js.map
+//# sourceMappingURL=mindmap-definition-RKZ34NQL-cTac4kYU.js.map

package/dist/component/{pieDiagram-4H26LBE5-CZ5Zt_mz.js → pieDiagram-4H26LBE5-B1SubLQb.js}

@@ -1,7 +1,7 @@
-import { a0 as S, S as R, b5 as J, g as Q, s as Y, a as tt, b as et, t as at, q as nt, _ as g, l as W, c as rt, I as it, N as st, a7 as lt, e as ot, B as ct, K as ut } from "./mermaid-GHXKKRXX-iO2IZZUN.js";
-import { p as gt } from "./chunk-4BX2VUAB-DlsylVfZ.js";
+import { a0 as S, S as R, b5 as J, g as Q, s as Y, a as tt, b as et, t as at, q as nt, _ as g, l as W, c as rt, I as it, N as st, a7 as lt, e as ot, B as ct, K as ut } from "./mermaid-GHXKKRXX-D7NVqIBP.js";
+import { p as gt } from "./chunk-4BX2VUAB-BLlcE09Q.js";
 import { p as dt } from "./wardley-L42UT6IY-HA1eSIS_.js";
-import { d as P } from "./arc-BhIvhaIH.js";
+import { d as P } from "./arc-Du1-HUt0.js";
 import { o as pt } from "./ordinal-D0x7izaa.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
@@ -163,4 +163,4 @@ var vt = ut.pie, z = {
 export {
   Lt as diagram
 };
-//# sourceMappingURL=pieDiagram-4H26LBE5-CZ5Zt_mz.js.map
+//# sourceMappingURL=pieDiagram-4H26LBE5-B1SubLQb.js.map

package/dist/component/{quadrantDiagram-W4KKPZXB-Dib1AukJ.js → quadrantDiagram-W4KKPZXB-CzyBW8Cr.js}

@@ -1,5 +1,5 @@
-import { s as Se, g as _e, t as ee, q as Ae, a as ke, b as Fe, _ as r, c as Et, l as qt, d as vt, e as Pe, B as ve, K as z, i as Ce, a4 as Le } from "./mermaid-GHXKKRXX-iO2IZZUN.js";
-import { l as te } from "./linear-D1rJivs3.js";
+import { s as Se, g as _e, t as ee, q as Ae, a as ke, b as Fe, _ as r, c as Et, l as qt, d as vt, e as Pe, B as ve, K as z, i as Ce, a4 as Le } from "./mermaid-GHXKKRXX-D7NVqIBP.js";
+import { l as te } from "./linear-AXxuun7R.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
 var Ct = (function() {
@@ -1030,4 +1030,4 @@ var Ve = /* @__PURE__ */ r(function() {
 export {
   We as diagram
 };
-//# sourceMappingURL=quadrantDiagram-W4KKPZXB-Dib1AukJ.js.map
+//# sourceMappingURL=quadrantDiagram-W4KKPZXB-CzyBW8Cr.js.map

package/dist/component/{requirementDiagram-4Y6WPE33-DubjTJYS.js → requirementDiagram-4Y6WPE33-DgS33NcX.js}

@@ -1,6 +1,6 @@
-import { g as Ge } from "./chunk-55IACEB6-CcJHjxtI.js";
-import { s as ze } from "./chunk-2J33WTMH-DdP5frJt.js";
-import { _ as h, G as Ye, b as Xe, a as Je, s as Ze, g as et, q as tt, t as st, c as ke, l as Ne, B as it, F as rt, p as nt, r as at, u as lt } from "./mermaid-GHXKKRXX-iO2IZZUN.js";
+import { g as Ge } from "./chunk-55IACEB6-23v_td5T.js";
+import { s as ze } from "./chunk-2J33WTMH-X2Iy3mMD.js";
+import { _ as h, G as Ye, b as Xe, a as Je, s as Ze, g as et, q as tt, t as st, c as ke, l as Ne, B as it, F as rt, p as nt, r as at, u as lt } from "./mermaid-GHXKKRXX-D7NVqIBP.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
 var qe = (function() {
@@ -885,4 +885,4 @@ var mt = /* @__PURE__ */ h(async function(e, u, o, n) {
 export {
   Rt as diagram
 };
-//# sourceMappingURL=requirementDiagram-4Y6WPE33-DubjTJYS.js.map
+//# sourceMappingURL=requirementDiagram-4Y6WPE33-DgS33NcX.js.map

package/dist/component/{sankeyDiagram-5OEKKPKP-Cq2S3XKs.js → sankeyDiagram-5OEKKPKP-Cp4o_akq.js}

@@ -1,4 +1,4 @@
-import { q as kt, t as mt, s as xt, g as _t, b as vt, a as bt, _ as y, c as ot, C as St, d as G, ai as wt, B as Lt, k as Et } from "./mermaid-GHXKKRXX-iO2IZZUN.js";
+import { q as kt, t as mt, s as xt, g as _t, b as vt, a as bt, _ as y, c as ot, C as St, d as G, ai as wt, B as Lt, k as Et } from "./mermaid-GHXKKRXX-D7NVqIBP.js";
 import { o as Tt } from "./ordinal-D0x7izaa.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
@@ -859,4 +859,4 @@ var ge = {
 export {
   ge as diagram
 };
-//# sourceMappingURL=sankeyDiagram-5OEKKPKP-Cq2S3XKs.js.map
+//# sourceMappingURL=sankeyDiagram-5OEKKPKP-Cp4o_akq.js.map

package/dist/component/{sequenceDiagram-3UESZ5HK-BUo5k0zn.js → sequenceDiagram-3UESZ5HK-2gf91-2b.js}

@@ -1,6 +1,6 @@
-import { _ as g, o as tr, c as $, d as Mt, l as at, j as Ce, e as er, f as rr, k as P, b as ke, s as ar, q as sr, a as ir, g as nr, t as or, v as cr, J as lr, B as hr, i as Bt, u as Z, a5 as Q, a6 as wt, a7 as Me, a8 as dr, G as Yt, a9 as Tr, aa as Be } from "./mermaid-GHXKKRXX-iO2IZZUN.js";
-import { a as pr, b as ee, g as dt, d as Er, e as re, f as ae } from "./chunk-ND2GUHAM-Dm_d0Ags.js";
-import { I as ur } from "./chunk-QZHKN3VN-D2PGEfVN.js";
+import { _ as g, o as tr, c as $, d as Mt, l as at, j as Ce, e as er, f as rr, k as P, b as ke, s as ar, q as sr, a as ir, g as nr, t as or, v as cr, J as lr, B as hr, i as Bt, u as Z, a5 as Q, a6 as wt, a7 as Me, a8 as dr, G as Yt, a9 as Tr, aa as Be } from "./mermaid-GHXKKRXX-D7NVqIBP.js";
+import { a as pr, b as ee, g as dt, d as Er, e as re, f as ae } from "./chunk-ND2GUHAM-Bj78QMsn.js";
+import { I as ur } from "./chunk-QZHKN3VN-CS_FAlLS.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
 var $t = (function() {
@@ -2894,4 +2894,4 @@ var ra = /* @__PURE__ */ g(async function(e, t, a) {
 export {
   Ta as diagram
 };
-//# sourceMappingURL=sequenceDiagram-3UESZ5HK-BUo5k0zn.js.map
+//# sourceMappingURL=sequenceDiagram-3UESZ5HK-2gf91-2b.js.map

package/dist/component/{stateDiagram-AJRCARHV-DJwQp0D7.js → stateDiagram-AJRCARHV-BByZezJw.js}

@@ -1,5 +1,5 @@
-import { s as R, a as W, S as N } from "./chunk-AQP2D5EJ-DmcGMHHV.js";
-import { _ as f, c as t, d as M, l as S, e as P, k as z, ac as _, ad as U, a9 as C, u as F } from "./mermaid-GHXKKRXX-iO2IZZUN.js";
+import { s as R, a as W, S as N } from "./chunk-AQP2D5EJ-CsRFVdwF.js";
+import { _ as f, c as t, d as M, l as S, e as P, k as z, ac as _, ad as U, a9 as C, u as F } from "./mermaid-GHXKKRXX-D7NVqIBP.js";
 import { G as O } from "./graph-BZLHvygk.js";
 import { l as J } from "./layout-Bu6nRdWm.js";
 globalThis.process = globalThis.process || { env: {} };
@@ -263,4 +263,4 @@ var X = /* @__PURE__ */ f((e) => e.append("circle").attr("class", "start-state")
 export {
   ot as diagram
 };
-//# sourceMappingURL=stateDiagram-AJRCARHV-DJwQp0D7.js.map
+//# sourceMappingURL=stateDiagram-AJRCARHV-BByZezJw.js.map

package/dist/component/{stateDiagram-v2-BHNVJYJU-BX77P5aq.js → stateDiagram-v2-BHNVJYJU-B-IObShO.js}

@@ -1,5 +1,5 @@
-import { s as e, b as r, a as s, S as t } from "./chunk-AQP2D5EJ-DmcGMHHV.js";
-import { _ as l } from "./mermaid-GHXKKRXX-iO2IZZUN.js";
+import { s as e, b as r, a as s, S as t } from "./chunk-AQP2D5EJ-CsRFVdwF.js";
+import { _ as l } from "./mermaid-GHXKKRXX-D7NVqIBP.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
 var b = {
@@ -16,4 +16,4 @@ var b = {
 export {
   b as diagram
 };
-//# sourceMappingURL=stateDiagram-v2-BHNVJYJU-BX77P5aq.js.map
+//# sourceMappingURL=stateDiagram-v2-BHNVJYJU-B-IObShO.js.map

package/dist/component/{timeline-definition-PNZ67QCA-DnQ481VI.js → timeline-definition-PNZ67QCA-D_2NG1sj.js}

@@ -1,5 +1,5 @@
-import { _ as o, G as gt, af as Rt, ag as Ct, ah as Wt, c as pt, l as E, N as Pt, a7 as Bt, ai as ft, d as U, F as Vt, aj as Ft, B as zt } from "./mermaid-GHXKKRXX-iO2IZZUN.js";
-import { d as ot } from "./arc-BhIvhaIH.js";
+import { _ as o, G as gt, af as Rt, ag as Ct, ah as Wt, c as pt, l as E, N as Pt, a7 as Bt, ai as ft, d as U, F as Vt, aj as Ft, B as zt } from "./mermaid-GHXKKRXX-D7NVqIBP.js";
+import { d as ot } from "./arc-Du1-HUt0.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
 var tt = (function() {
@@ -1055,4 +1055,4 @@ var Qt = /* @__PURE__ */ o(function(e, t, n, i, r, h = !1) {
 export {
   me as diagram
 };
-//# sourceMappingURL=timeline-definition-PNZ67QCA-DnQ481VI.js.map
+//# sourceMappingURL=timeline-definition-PNZ67QCA-D_2NG1sj.js.map

package/dist/component/{vennDiagram-CIIHVFJN-BQ0X92lQ.js → vennDiagram-CIIHVFJN-BjrQUaEs.js}

@@ -1,4 +1,4 @@
-import { aX as Gt, s as Wt, g as Kt, t as Ht, q as Xt, a as Yt, b as Zt, _ as w, G as wt, N as Jt, d as ot, ao as Qt, af as $t, ag as te, ah as ee, e as ne, B as se, I as ie, K as oe } from "./mermaid-GHXKKRXX-iO2IZZUN.js";
+import { aX as Gt, s as Wt, g as Kt, t as Ht, q as Xt, a as Yt, b as Zt, _ as w, G as wt, N as Jt, d as ot, ao as Qt, af as $t, ag as te, ah as ee, e as ne, B as se, I as ie, K as oe } from "./mermaid-GHXKKRXX-D7NVqIBP.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
 const kt = (t, n) => Gt(t, "a", -n), _t = 1e-10;
@@ -1557,4 +1557,4 @@ var qe = { draw: Ve }, Ge = {
 export {
   Ge as diagram
 };
-//# sourceMappingURL=vennDiagram-CIIHVFJN-BQ0X92lQ.js.map
+//# sourceMappingURL=vennDiagram-CIIHVFJN-BjrQUaEs.js.map

package/dist/component/{wardleyDiagram-YWT4CUSO-CMTnjVTA.js → wardleyDiagram-YWT4CUSO-DYcvfAeQ.js}

@@ -1,5 +1,5 @@
-import { s as St, g as Mt, t as Nt, q as Tt, a as zt, b as Lt, _ as u, a4 as At, G as Xt, I as U, l as K, N as Et, e as Yt, B as It, c as j } from "./mermaid-GHXKKRXX-iO2IZZUN.js";
-import { p as Bt } from "./chunk-4BX2VUAB-DlsylVfZ.js";
+import { s as St, g as Mt, t as Nt, q as Tt, a as zt, b as Lt, _ as u, a4 as At, G as Xt, I as U, l as K, N as Et, e as Yt, B as It, c as j } from "./mermaid-GHXKKRXX-D7NVqIBP.js";
+import { p as Bt } from "./chunk-4BX2VUAB-BLlcE09Q.js";
 import { p as Ft } from "./wardley-L42UT6IY-HA1eSIS_.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
@@ -678,4 +678,4 @@ var Dt = {
 export {
   Qt as diagram
 };
-//# sourceMappingURL=wardleyDiagram-YWT4CUSO-CMTnjVTA.js.map
+//# sourceMappingURL=wardleyDiagram-YWT4CUSO-DYcvfAeQ.js.map

package/dist/component/{xychartDiagram-2RQKCTM6-BLSiRWug.js → xychartDiagram-2RQKCTM6-CtLaJFtQ.js}

@@ -1,7 +1,7 @@
-import { s as ei, g as si, t as Lt, q as ni, a as ai, b as oi, _ as a, l as Et, N as ri, e as hi, B as li, G as dt, i as ci, I as It, K as ui, a4 as gi, ap as xi, ac as Rt } from "./mermaid-GHXKKRXX-iO2IZZUN.js";
+import { s as ei, g as si, t as Lt, q as ni, a as ai, b as oi, _ as a, l as Et, N as ri, e as hi, B as li, G as dt, i as ci, I as It, K as ui, a4 as gi, ap as xi, ac as Rt } from "./mermaid-GHXKKRXX-D7NVqIBP.js";
 import { i as di } from "./init-BOu0eQYQ.js";
 import { o as fi } from "./ordinal-D0x7izaa.js";
-import { l as Dt } from "./linear-D1rJivs3.js";
+import { l as Dt } from "./linear-AXxuun7R.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
 function pi(t, i, e) {
@@ -1372,4 +1372,4 @@ var Ti = /* @__PURE__ */ a(function() {
 export {
   Mi as diagram
 };
-//# sourceMappingURL=xychartDiagram-2RQKCTM6-BLSiRWug.js.map
+//# sourceMappingURL=xychartDiagram-2RQKCTM6-CtLaJFtQ.js.map

package/dist/components/embed/EmbedAvatar.d.ts

@@ -8,7 +8,7 @@ import { BelongTheme, BelongThemePalette, PresetName } from '../../types/public.
  * colour + custom CSS), then Log out. Gradient is brand-driven (Ocean → Deep
  * Sea) via the active palette.
  */
-export declare function EmbedAvatar({ user, size, theme, palette, side, menuSide: menuSideOverride, sessionId, voiceSupported, sessions, accent, cssVars, presets, activePreset, onToggleMode, onToggleSide, onAccentChange, onAccentReset, onCssVarsChange, onApplyPreset, onLogout, onNewSession, onSelectSession, onDeleteSession, onRenameSession, onSessionsOpen, }: {
+export declare function EmbedAvatar({ user, size, theme, palette, side, menuSide: menuSideOverride, sessionId, voiceSupported, sessions, accent, cssVars, presets, activePreset, onToggleMode, onToggleSide, onAccentChange, onAccentReset, onCssVarsChange, onApplyPreset, onLogout, onNewSession, onSelectSession, onDeleteSession, onRenameSession, onSessionsOpen, onViewStats, sessionAgentLine, }: {
     user: string | null;
     size?: number;
     theme: BelongTheme;
@@ -47,4 +47,11 @@ export declare function EmbedAvatar({ user, size, theme, palette, side, menuSide
     /** Fired when the History submenu opens — the dock refetches the list so
      *  it's fresh (mirrors EmbedSessions' own `onOpen`). */
     onSessionsOpen?: () => void;
+    /** Open the per-session stats dialog (plan 2026-07-24). Optional so the
+     *  avatar menu still renders without the dock's panel host wired up. */
+    onViewStats?: (sessionId: string) => void;
+    /** sessionId -> the agent line currently bound to it (F3) — threaded
+     *  straight through to the History submenu's `EmbedSessionsBody` so an
+     *  already-open row wears its "Agent N" badge. */
+    sessionAgentLine?: ReadonlyMap<string, number>;
 }): import("react").JSX.Element;

package/dist/components/embed/EmbedHeader.d.ts

@@ -2,10 +2,33 @@ import { BelongThemeBrand, BelongThemePalette } from '../../types/public.ts';
 /**
  * Slim brand bar at the top of the chat: the mark + the brand/view title, with
  * a small "by Belong" tagline when a tenant brand is active. Action controls
- * live in the rail (EmbedRail), not here.
+ * live in the rail (EmbedRail), not here — with TWO exceptions:
+ *   • `onExportChat` — download the current conversation as JSON. Stateful:
+ *     while the backend generates the export the button shows a spinner and
+ *     is disabled; the label (aria + hover title) carries the timestamp of
+ *     the session's last export when one exists.
+ *   • `onCloseChat` — the in-surface way to close the CURRENT agent chat.
+ *     The dock passes it only while the chat view is up AND more than one
+ *     agent chat exists (closing the only conversation is meaningless — there
+ *     is nothing to fall back to), so the single-chat header stays exactly as
+ *     it always was.
  */
-export declare function EmbedHeader({ title, palette, brand, }: {
+export declare function EmbedHeader({ title, palette, brand, onExportChat, exportState, exportChatLabel, onCloseChat, closeChatLabel, }: {
     title: string;
     palette: BelongThemePalette;
     brand: BelongThemeBrand;
+    /** Request a chat export (rendered only when provided — chat view with a
+     *  server-bound session). Disabled while `exportState` is "generating". */
+    onExportChat?: () => void;
+    exportState?: "idle" | "generating";
+    /** Accessible name + hover title for the export control. Carries the last
+     *  export timestamp when the session has one. Required with `onExportChat`. */
+    exportChatLabel?: string;
+    /** Close the current agent chat (release its line, fall back to the next
+     *  agent). Rendered only when provided — see the component doc for the
+     *  dock's gating rule. */
+    onCloseChat?: () => void;
+    /** Accessible name for the close control (carries the agent's identity,
+     *  e.g. "Close Agent 2 — invoices"). Required alongside `onCloseChat`. */
+    closeChatLabel?: string;
 }): import("react").JSX.Element;

package/dist/components/embed/EmbedRail.d.ts

@@ -11,7 +11,7 @@ export type EmbedView = "chat" | "files" | "scheduled";
  * expand-to-modal — then the collapse toggle. Active fill + brand colours come
  * from `palette` so a host brand push re-themes everything.
  */
-export declare function EmbedRail({ view, collapsed, user, theme, palette, sessions, activeId, planProgress, speakEnabled, ttsSupported, voiceSupported, voiceStatus, pendingVoiceDraft, voiceActionFlash, accent, cssVars, presets, activePreset, onSelectView, onToggleCollapse, onToggleMode, onToggleSide, onAccentChange, onAccentReset, onCssVarsChange, onApplyPreset, onLogout, onNewSession, onSelectSession, onSelectAgentLine, onCloseAgentLine, onDeleteSession, onRenameSession, onSessionsOpen, onToggleSpeak, onExpand, }: {
+export declare function EmbedRail({ view, collapsed, user, theme, palette, sessions, activeId, planProgress, speakEnabled, ttsSupported, voiceSupported, voiceStatus, pendingVoiceDraft, voiceActionFlash, accent, cssVars, presets, activePreset, onSelectView, onToggleCollapse, onToggleMode, onToggleSide, onAccentChange, onAccentReset, onCssVarsChange, onApplyPreset, onLogout, onNewSession, onSelectSession, onSelectAgentLine, onCloseAgentLine, onDeleteSession, onRenameSession, onSessionsOpen, onViewStats, onToggleSpeak, onExpand, }: {
     view: EmbedView;
     collapsed: boolean;
     user: string | null;
@@ -61,9 +61,14 @@ export declare function EmbedRail({ view, collapsed, user, theme, palette, sessi
     /** Rail agent chip clicked with a BOUND session — switches to the chat view
      *  AND selects that agent's slot session (also clears its unseen-result
      *  flag, via BelongDock's existing onSelectSession → markLineSeen lookup).
-     *  An unbound line (no sessionId yet) never reaches this — the chip falls
-     *  back to `onSelectView("chat")` instead, same as today's plain chat item. */
-    onSelectAgentLine: (sessionId: string) => void;
+     *  Also reached with `null` for the UNBOUND line-1 chip specifically — the
+     *  one line whose chip is meaningfully clickable before it has a session —
+     *  which BelongDock reads as "start a new foreground chat" (see its own
+     *  doc). A line 2+ chip still unbound (the transient spinner window between
+     *  reserving the line and its session mint) does NOT reach this — it falls
+     *  back to `onSelectView("chat")` instead, same as today's plain chat item;
+     *  there is nothing meaningful to select yet and no stale session to escape. */
+    onSelectAgentLine: (sessionId: string | null) => void;
     /** User closed an agent tab — RELEASES that line's slot (in memory + durably)
      *  and nothing else. The conversation itself is NOT deleted server-side: it
      *  stays in History and can be re-adopted from the avatar menu. Only offered
@@ -72,6 +77,9 @@ export declare function EmbedRail({ view, collapsed, user, theme, palette, sessi
     onDeleteSession: (id: string) => void;
     onRenameSession: (id: string, title: string) => void;
     onSessionsOpen?: () => void;
+    /** Open the per-session stats dialog (plan 2026-07-24). Optional so the
+     *  rail still renders without the dock's panel host wired up. */
+    onViewStats?: (sessionId: string) => void;
     onToggleSpeak: () => void;
     onExpand: () => void;
 }): import("react").JSX.Element;

package/dist/components/embed/EmbedSessions.d.ts

@@ -12,6 +12,17 @@ type SessionsBodyProps = {
     onDelete: (id: string) => void;
     /** Persist a user-chosen chat name (BEL-120). Only fired for a non-blank change. */
     onRename: (id: string, title: string) => void;
+    /** sessionId -> the agent line currently bound to it (F3). A row present in
+     *  this map is open somewhere in the rail and wears a small "Agent N"
+     *  badge; a row absent from it is not open in any agent and stays clean.
+     *  Computed by the caller (EmbedRail / MobileNavBar, which already
+     *  subscribe to the agent-lines registry) so this stays a pure
+     *  presentational component — optional so a plain sessions list (no rail
+     *  context) still renders without one. */
+    sessionAgentLine?: ReadonlyMap<string, number>;
+    /** Open the per-session stats dialog (plan 2026-07-24). Optional so a plain
+     *  list without the dock's panel host still renders. */
+    onViewStats?: (sessionId: string) => void;
 };
 /**
  * The "New chat" item + recent-sessions list, WITHOUT a menu shell of its own —
@@ -23,13 +34,13 @@ type SessionsBodyProps = {
  * closed Content/SubContent by default, so this component's local edit/confirm
  * state resets for free on every close — no explicit reset needed here.
  */
-export declare function EmbedSessionsBody({ sessions, activeId, onNew, onSelect, onDelete, onRename, }: SessionsBodyProps): import("react").JSX.Element;
+export declare function EmbedSessionsBody({ sessions, activeId, onNew, onSelect, onDelete, onRename, sessionAgentLine, onViewStats, }: SessionsBodyProps): import("react").JSX.Element;
 /**
  * Header control to start a new chat, switch to a recent session, rename one via
  * an inline text edit, or delete one via an inline trash → confirm flow. Rename +
  * delete are per-row inline affordances that keep the menu open (BEL-120).
  */
-export declare function EmbedSessions({ sessions, activeId, theme, side, triggerClassName, triggerLabel, onNew, onSelect, onDelete, onRename, onOpen, }: SessionsBodyProps & {
+export declare function EmbedSessions({ sessions, activeId, theme, side, triggerClassName, triggerLabel, onNew, onSelect, onDelete, onRename, onOpen, sessionAgentLine, onViewStats, }: SessionsBodyProps & {
     theme: BelongTheme;
     /** Which way the menu opens — toward the panel from the rail edge, or
      *  upward when the trigger lives in the mobile bottom nav bar. */

package/dist/components/embed/MobileNavBar.d.ts

@@ -7,7 +7,7 @@ import { BelongTheme, BelongThemePalette, PresetName } from '../../types/public.
  * (chat / files / scheduled), the sessions switcher, the account avatar, and
  * a close chevron. Every cell is a ≥44px touch target; menus open upward.
  */
-export declare function MobileNavBar({ view, user, theme, palette, sessions, activeId, voiceSupported, accent, cssVars, presets, activePreset, onSelectView, onClose, onToggleMode, onToggleSide, onAccentChange, onAccentReset, onCssVarsChange, onApplyPreset, onLogout, onNewSession, onSelectSession, onDeleteSession, onRenameSession, onSessionsOpen, }: {
+export declare function MobileNavBar({ view, user, theme, palette, sessions, activeId, voiceSupported, accent, cssVars, presets, activePreset, onSelectView, onClose, onToggleMode, onToggleSide, onAccentChange, onAccentReset, onCssVarsChange, onApplyPreset, onLogout, onNewSession, onSelectSession, onDeleteSession, onRenameSession, onSessionsOpen, onViewStats, }: {
     view: EmbedView;
     user: string | null;
     theme: BelongTheme;
@@ -36,4 +36,7 @@ export declare function MobileNavBar({ view, user, theme, palette, sessions, act
     onDeleteSession: (id: string) => void;
     onRenameSession: (id: string, title: string) => void;
     onSessionsOpen?: () => void;
+    /** Open the per-session stats dialog (plan 2026-07-24). Optional so the
+     *  mobile nav still renders without the dock's panel host wired up. */
+    onViewStats?: (sessionId: string) => void;
 }): import("react").JSX.Element;

package/dist/components/embed/SessionStatsPanel.d.ts

@@ -0,0 +1,12 @@
+/**
+ * SessionStatsPanel (plan 2026-07-24) — a centered dialog opened from a history
+ * row's "Stats" action. Fetches GET /v1/session-stats/:id on open (works for ANY
+ * session, not just the active one, so REST not folded stream parts). Shows
+ * tokens, time running, turns, tool calls, runtime + a per-turn table, with two
+ * CSV exports.
+ */
+export type SessionStatsPanelProps = {
+    readonly sessionId: string | null;
+    readonly onClose: () => void;
+};
+export declare const SessionStatsPanel: ({ sessionId, onClose, }: SessionStatsPanelProps) => React.ReactElement | null;

package/dist/components/embed/rail-flags.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Rail feature flags — deliberately kept OUT of EmbedRail.tsx.
+ *
+ * A component file that ALSO exports a non-component value breaks React Fast
+ * Refresh's module boundary: Vite can no longer hot-swap the component and
+ * falls back to a full reload, and an already-open tab can be left in a
+ * broken HMR state until a hard reload. Living in a plain `.ts` module keeps
+ * EmbedRail.tsx a clean component-only Fast Refresh boundary.
+ */
+/**
+ * Multi-agent rail (parallel chat "agent lines" spawned from the "+" button,
+ * capped at MAX_AGENT_LINES) is DEACTIVATED — switching between the spawned
+ * agents was buggy. While off:
+ *   - the "+" spawn button is not rendered (no new chat agent lines can be
+ *     started from the rail), so a plain chat session stays on line 1 and the
+ *     rail is the single-chat item exactly as before; and
+ *   - the standalone Chats/history dropdown is restored to the rail (it was
+ *     demoted into the avatar menu when the agent rail landed).
+ * The underlying agent-line registry + voice multi-agent call board are left
+ * intact (the rail still renders line chips if a VOICE call opens more than
+ * one). Flip this to `true` to re-enable the chat spawn UX.
+ */
+export declare const MULTI_AGENT_RAIL_ENABLED = false;

package/dist/embed/adoption-notice.d.ts

@@ -18,5 +18,15 @@ export declare const setPendingAdoptionNotice: (sessionId: string, line: number)
 /** The line number to announce for `sessionId`, or null when this mount has
  * nothing pending. Consuming clears the entry (the notice fires once). */
 export declare const consumePendingAdoptionNotice: (sessionId: string) => number | null;
+/** Non-consuming read of the SAME entry (F3) — chat.tsx's line-1 bind effect
+ * uses this to learn WHICH line a freshly-opened History session should
+ * adopt onto (BelongDock recorded the intended target — the currently active
+ * line, not always line 1 — before the select remounted this route). Must
+ * not clear the entry: the notice effect above still needs to consume it
+ * once, for its own one-time "Loaded into Agent N" message, and the bind
+ * effect re-runs on every render (no dep array) so it would otherwise race
+ * that single consume. Returns null for a non-matching or already-consumed
+ * session, same as `consumePendingAdoptionNotice`. */
+export declare const peekPendingAdoptionLine: (sessionId: string) => number | null;
 /** Test-only: forget any pending entry between test cases. */
 export declare const __clearPendingAdoptionNoticeForTest: () => void;

package/dist/embed/presets.d.ts

@@ -17,6 +17,16 @@ export declare const DEFAULT_PRESET: PresetName;
 export declare const isSimetrikHost: (hostname: string) => boolean;
 /** The default preset for a host: `simetrik` on a Simetrik domain, else belong. */
 export declare const defaultPresetForHost: (hostname: string) => PresetName;
+/**
+ * The preset the dock boots with, given the user's stored choice and the host
+ * it's embedded on. **Brand-as-floor:** on a host that defaults to a tenant
+ * brand (a Simetrik domain), a stored *generic* built-in preset (`belong`) must
+ * not silently downgrade the brand — a stale `localStorage` preset from QA/dev
+ * once wiped Simetrik's brand on the real site. Only the user's explicit Custom
+ * theme (or a matching brand choice) overrides the host brand. On a non-branded
+ * host there's no floor to enforce, so the stored preference always wins.
+ */
+export declare const resolveInitialPreset: (storedPreset: PresetName | undefined, hostname: string) => PresetName;
 export declare const getPreset: (name: PresetName) => PartialBelongTheme;
 export declare const listPresets: () => readonly {
     name: PresetName;

package/dist/embed/theme.d.ts

@@ -8,6 +8,19 @@ export declare const setTheme: (partial: PartialBelongTheme) => void;
  *  the Custom style overlays the user's accent/cssVars stash. */
 export declare const applyPreset: (name: PresetName) => void;
 export declare const peekPreset: () => PresetName;
+/**
+ * One-line diagnostic of how the boot theme resolved, logged once at init
+ * (see `applyInitConfig`). Pairs with the build-provenance line (plan 007 §B4)
+ * so a "the dock isn't showing our brand" report is answerable from the host
+ * console alone: it names the winning preset + brand, the host that drove the
+ * default, and whether the tenant's *published* theme overrode it on top.
+ */
+export declare const describeThemeResolution: (input: {
+    hostname: string;
+    preset: PresetName;
+    brandName: string;
+    remoteThemeApplied: boolean;
+}) => string;
 /**
  * Set (or clear, with `null`) the Custom-style accent. Updates the stash and
  * switches to the Custom style so the change is immediately visible.

package/dist/embed/voice/line-dispatch.d.ts

@@ -18,10 +18,31 @@
  * create body carries the effective `workspaceExternalId` (absent when the host
  * runs unscoped). The line's registry label seeds the session title, so the
  * sessions list names the background conversation.
+ *
+ * BOOT RE-ATTACH (F3/R4): `attachLineReader` below is the ONE seam that wires
+ * a line-run reader onto a line, shared by a fresh dispatch (this module,
+ * right after a POST accepts a run) and `reattachPendingLineRuns` (called
+ * once at boot, after `initAgentLines()` rehydrates the registry) resuming a
+ * run that was still going when the page reloaded. Both paths persist the
+ * binding (`persistSlotRun`) and wire the identical phase/approval/navigate/
+ * artifact/finish/error callbacks — a reload must behave exactly like the
+ * live dispatch it is standing in for, not a parallel, easier-to-drift copy.
  */
 /** Abort every live line reader and invalidate their callbacks (call teardown).
  * Subscribed below to fire whenever a call leaves in_call/connecting. */
 export declare const abortAllLineReaders: () => void;
+/**
+ * BOOT RE-ATTACH (F3/R4): call this once, right after `initAgentLines()`
+ * rehydrates the registry from persisted slots. Every background line (2/3)
+ * whose slot carried a non-null `runId` already shows `status: "working"`
+ * (`rehydratedLines()` in voice-call-lines.ts) — this re-attaches its reader
+ * so the line actually converges to ready/failed via the SAME
+ * `attachLineReader` a live dispatch uses, instead of sitting at an
+ * honest-looking but permanently stuck "working". Line 1 never carries a
+ * registry `runId` (see `AgentLine.runId`'s doc) and is skipped here — its
+ * own reload-resume path is the stream-state store's, not this one.
+ */
+export declare const reattachPendingLineRuns: (fetchFn?: typeof fetch) => void;
 export declare const dispatchToLine: (req: {
     readonly line: number;
     readonly request: string;

package/dist/embed/voice/line-run-reader.d.ts

@@ -31,6 +31,21 @@
  *     NOT terminal, keep reading the same stream. "completed" finishes with
  *     the accumulated text; "cancelled" | "failed" | "throttled" are errors.
  *
+ * BOOT RE-ATTACH (F3/R4): this reader is also opened for a run that already
+ * finished before the read starts (a persisted `runId` re-attached after a
+ * reload — see `attachLineReader` in line-dispatch.ts). Two ways that shows
+ * up on the wire, both a CLEAN convergence rather than a failure:
+ *   - the run is still known server-side and just replays its full history
+ *     (§36 — `GET .../stream` with no cursor replays from the start): the
+ *     already-written terminal `data-status` event arrives like any other
+ *     part and is handled by the SAME "completed"/"cancelled"/"failed"
+ *     branch below — no special-casing needed, this is the ordinary path.
+ *   - the run (or its task) is truly gone server-side — 404/410 — which
+ *     reads identically to "nothing left to report", not an error: `onFinish`
+ *     fires with empty text instead of `onError`, so a boot re-attach never
+ *     paints a stale run as failed just because its record has since expired
+ *     or the session behind it was deleted.
+ *
  * SSE parsing here is LINE-BY-LINE (split on "\n", not "\n\n") — the server
  * sends exactly one `data:` line per event. `id:` lines carry the event
  * cursor (ignored — v1 has no reconnect/resume) and `:`-prefixed lines are
@@ -50,6 +65,6 @@ export type WatchLineRunInput = {
         mimeType: string;
     }) => void;
     readonly onFinish: (finalText: string) => void;
-    readonly onError: (message: string) => void;
+    readonly onError: (message: string, kind: "terminal" | "transport") => void;
 };
 export declare const watchLineRun: (input: WatchLineRunInput, fetchFn?: typeof fetch) => (() => void);

package/dist/embed/voice/line-slots.d.ts

@@ -24,6 +24,18 @@
  * slots" — the switchboard just starts fresh, same as a first-ever call. The
  * schema is back-compatible with the pre-line-1 bag: a persisted object with
  * only `line2`/`line3` still parses fine, `line1` just defaults to `null`.
+ *
+ * `runId` (F3/R4 — reload must not lie about a still-running background
+ * line): the durable half of `bindLineRun`'s in-memory tracking, written by
+ * `persistSlotRun` (`voice-call-lines.ts`) alongside every `bindLineRun` call
+ * a background dispatch makes. Without it, a page reload has no way to know
+ * a line was mid-run — `runId` lives only in JS memory otherwise, and the
+ * boot rehydrate would show a lying "idle" line while the run keeps
+ * streaming server-side. Back-compatible the same way `line1` is: a bag
+ * written before this field existed has no `runId` key at all, and the
+ * schema defaults it to `null` (nothing was in flight when that bag was
+ * written). Line 1 never carries a meaningful value here — its `runId` is
+ * always `null` (see `AgentLine.runId`'s doc in voice-call-lines.ts).
  */
 /** Every line number that gets a persisted slot — all three agent lines. */
 declare const SLOT_LINES: readonly [1, 2, 3];
@@ -31,6 +43,20 @@ type SlotLine = (typeof SLOT_LINES)[number];
 export type LineSlot = {
     readonly sessionId: string;
     readonly label: string;
+    readonly runId: string | null;
+};
+/** Input to `writeLineSlot` — `runId` is OPTIONAL here (unlike the stored
+ * `LineSlot`) and defaults to `null` when omitted: every existing adoption
+ * call site (`persistSlotBinding`) writes a session/label pair without ever
+ * having an opinion on `runId`, and a fresh binding correctly has no run of
+ * its own yet (any run tracked against the PREVIOUS session at this slot is
+ * moot once the binding itself changes identity). `persistSlotRun` is the
+ * only writer that ever sets `runId` to a non-null value, via the narrower
+ * `writeLineSlotRun` below. */
+export type LineSlotInput = {
+    readonly sessionId: string;
+    readonly label: string;
+    readonly runId?: string | null;
 };
 /** The persisted binding for line 1/2/3, or `null` when never set (or `line`
  * isn't a valid agent line at all). */
@@ -38,10 +64,22 @@ export declare const readLineSlot: (line: number) => LineSlot | null;
 /** Persist a line's current `{ sessionId, label }` so the NEXT rehydration
  * (`resetAgentLines()`, or a plain reload for line 1) rebinds onto the same
  * session. No-op for a line number that isn't 1/2/3, and no-op when the slot
- * already holds this exact `{ sessionId, label }` — callers (e.g. chat.tsx's
- * per-render bind effect) call this on every render, so an unchanged binding
- * must not touch storage. */
-export declare const writeLineSlot: (line: number, slot: LineSlot) => void;
+ * already holds this exact `{ sessionId, label, runId }` — callers (e.g.
+ * chat.tsx's per-render bind effect) call this on every render, so an
+ * unchanged binding must not touch storage. `runId` defaults to `null` when
+ * omitted (see `LineSlotInput`'s doc) — a fresh binding via this function
+ * always represents a NEW session identity, so any run tracked against
+ * whatever this slot held before is stale by construction. */
+export declare const writeLineSlot: (line: number, slot: LineSlotInput) => void;
+/** Update ONLY the persisted `runId` for a line's slot, leaving `sessionId`/
+ * `label` untouched — the durable half of `bindLineRun` (called together as
+ * `persistSlotRun` in voice-call-lines.ts), so a background line's in-flight
+ * run survives a reload (F3/R4). No-op for a line number that isn't 1/2/3,
+ * when the slot doesn't exist yet (nothing to attach a run to — the session
+ * itself hasn't been adopted), or when the runId is already what's
+ * persisted (bindLineRun's own no-op-on-unchanged tolerance, mirrored here so
+ * the two halves stay in lockstep). */
+export declare const writeLineSlotRun: (line: number, runId: string | null) => void;
 /** Drop a line's persisted binding — the durable half of `closeAgentLine`
  * (voice-call-lines.ts). Called when a slot is RELEASED rather than rebound: a
  * spawn whose session mint failed, or a session the user deleted. Without this

package/dist/embed/voice-call-lines.d.ts

@@ -107,6 +107,13 @@ export declare const isLineReservation: (line: number, epoch: number) => boolean
  * (the boolean chat.tsx's aliasing guard needs) and `markLineSeen`'s callers
  * (which need the actual line number to mark seen). */
 export declare const lineBoundToSession: (sessionId: string) => AgentLine | undefined;
+/** The line — INCLUDING line 1 — currently bound to `sessionId`, or `undefined`
+ * when no agent holds it. Unlike `lineBoundToSession` (deliberately line-1-blind
+ * for the aliasing guard), this is the honest "which agent already owns this
+ * conversation" lookup a History reopen needs: reopening a session that Agent 1
+ * already holds must SWITCH to Agent 1, not adopt (duplicate) it onto whatever
+ * background line the user happens to be viewing. */
+export declare const lineOwningSession: (sessionId: string) => AgentLine | undefined;
 /** True when `sessionId` is already the session of some line OTHER than line
  * 1 — chat.tsx's line-1 aliasing guard uses this to skip rebinding line 1
  * onto a background line's session while the user is viewing it via
@@ -185,10 +192,33 @@ export declare const __bindLineSessionForTest: (line: number, sessionId: string)
 export declare const persistSlotBinding: (line: number, sessionId: string, label: string) => void;
 /** `stop_agent`'s target: bound by the line-run reader once a background
  * dispatch's POST returns a runId, and cleared to `null` when that run
- * finishes/fails/errors — a stopped or finished run must not look stoppable
- * again. No-op on an unknown line or an unchanged value (mirrors
- * `setLineStatus`'s re-write-on-every-render tolerance). */
+ * reaches a confirmed terminal state — a stopped or finished run must not look
+ * stoppable again. Transport-only failures deliberately retain it for
+ * re-attachment. No-op on an unknown line or an unchanged value (mirrors
+ * `setLineStatus`'s re-write-on-every-render tolerance). In-memory only —
+ * production code wanting the binding to SURVIVE a reload calls
+ * `persistSlotRun` below instead; this stays exported for the `__force*` /
+ * `__bindLineSessionForTest` style test harnesses that intentionally want
+ * the memory-only half. */
 export declare const bindLineRun: (line: number, runId: string | null) => void;
+/**
+ * The durable half of `bindLineRun` (F3/R4): call this — not the bare
+ * `bindLineRun` — whenever a background dispatch's POST accepts a run, and
+ * again when that run reaches a terminal state (`onFinish`/`onError`
+ * clearing it back to `null`). Updates the in-memory registry AND the
+ * persisted slot together, so the ONE thing a page reload cannot observe by
+ * itself — "is this line's run still going?" — survives the reload instead
+ * of silently reverting to a lying "idle". `line-dispatch.ts`'s
+ * `attachLineReader` is the ONE seam that calls this, shared by a live
+ * dispatch and the boot re-attach (`reattachPendingLineRuns`) alike — same
+ * discipline as `persistSlotBinding`'s ADOPTION seam.
+ *
+ * Line 1 never goes through this (line-dispatch.ts never dispatches to line
+ * 1 — see its module doc): its `runId` stays the always-`null` value
+ * `bindLineRun` already tolerates, and its own run is resolved at stop-time
+ * from the stream-state store instead (`AgentLine.runId`'s doc).
+ */
+export declare const persistSlotRun: (line: number, runId: string | null) => void;
 export declare const setLineStatus: (line: number, status: AgentLineStatus, lastText?: string) => void;
 /** CallScreen's agent board reads this as the live "what is it doing right
  * now" line under a working line's status dot — written on every phase