@belonguniverseai/react-sdk 0.3.6 → 0.4.1

package/dist/component/{mindmap-definition-RKZ34NQL-RZVaz4dV.js → mindmap-definition-RKZ34NQL-cTac4kYU.js}

@@ -1,6 +1,6 @@
-import { g as oe } from "./chunk-55IACEB6-CIN0g3JH.js";
-import { s as ae } from "./chunk-2J33WTMH-DyOrhFxY.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-CnzRBGo3.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-RZVaz4dV.js.map
+//# sourceMappingURL=mindmap-definition-RKZ34NQL-cTac4kYU.js.map

package/dist/component/{pieDiagram-4H26LBE5-CEwcfNwI.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-CnzRBGo3.js";
-import { p as gt } from "./chunk-4BX2VUAB-Bc66-Fjy.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-6nY2VvBR.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-CEwcfNwI.js.map
+//# sourceMappingURL=pieDiagram-4H26LBE5-B1SubLQb.js.map

package/dist/component/{quadrantDiagram-W4KKPZXB-BJBEiTgK.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-CnzRBGo3.js";
-import { l as te } from "./linear-CtCl_nrs.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-BJBEiTgK.js.map
+//# sourceMappingURL=quadrantDiagram-W4KKPZXB-CzyBW8Cr.js.map

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

@@ -1,6 +1,6 @@
-import { g as Ge } from "./chunk-55IACEB6-CIN0g3JH.js";
-import { s as ze } from "./chunk-2J33WTMH-DyOrhFxY.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-CnzRBGo3.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-CVHog8O-.js.map
+//# sourceMappingURL=requirementDiagram-4Y6WPE33-DgS33NcX.js.map

package/dist/component/{sankeyDiagram-5OEKKPKP-Cn1N0qrl.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-CnzRBGo3.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-Cn1N0qrl.js.map
+//# sourceMappingURL=sankeyDiagram-5OEKKPKP-Cp4o_akq.js.map

package/dist/component/{sequenceDiagram-3UESZ5HK-CRaBqdL0.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-CnzRBGo3.js";
-import { a as pr, b as ee, g as dt, d as Er, e as re, f as ae } from "./chunk-ND2GUHAM-BJo4K53f.js";
-import { I as ur } from "./chunk-QZHKN3VN-DufugBok.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-CRaBqdL0.js.map
+//# sourceMappingURL=sequenceDiagram-3UESZ5HK-2gf91-2b.js.map

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

@@ -1,5 +1,5 @@
-import { s as R, a as W, S as N } from "./chunk-AQP2D5EJ-CPlwnVcL.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-CnzRBGo3.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-9q4hv0ii.js.map
+//# sourceMappingURL=stateDiagram-AJRCARHV-BByZezJw.js.map

package/dist/component/{stateDiagram-v2-BHNVJYJU-By7O-5eN.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-CPlwnVcL.js";
-import { _ as l } from "./mermaid-GHXKKRXX-CnzRBGo3.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-By7O-5eN.js.map
+//# sourceMappingURL=stateDiagram-v2-BHNVJYJU-B-IObShO.js.map

package/dist/component/{timeline-definition-PNZ67QCA-BWfxZI7f.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-CnzRBGo3.js";
-import { d as ot } from "./arc-6nY2VvBR.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-BWfxZI7f.js.map
+//# sourceMappingURL=timeline-definition-PNZ67QCA-D_2NG1sj.js.map

package/dist/component/{vennDiagram-CIIHVFJN-B_PQ6bU6.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-CnzRBGo3.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-B_PQ6bU6.js.map
+//# sourceMappingURL=vennDiagram-CIIHVFJN-BjrQUaEs.js.map

package/dist/component/{wardleyDiagram-YWT4CUSO-P7tCzeA0.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-CnzRBGo3.js";
-import { p as Bt } from "./chunk-4BX2VUAB-Bc66-Fjy.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-P7tCzeA0.js.map
+//# sourceMappingURL=wardleyDiagram-YWT4CUSO-DYcvfAeQ.js.map

package/dist/component/{xychartDiagram-2RQKCTM6-B4Z_Zrko.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-CnzRBGo3.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-CtCl_nrs.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-B4Z_Zrko.js.map
+//# sourceMappingURL=xychartDiagram-2RQKCTM6-CtLaJFtQ.js.map

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

@@ -0,0 +1,16 @@
+/**
+ * The agent glyph for the multi-agent rail group: the EXACT chat-bubble icon
+ * the single-agent rail item uses (same `MessageSquare`, same size — the
+ * icons must not read as a different family), with the agent's number as a
+ * small counter disc at the bottom-right corner, unread-count style. The
+ * disc mirrors the working badge's idiom (`size-3.5` rounded disc on
+ * `bg-background`, EmbedRail's `lineBadge`) so the two corners speak the same
+ * visual language: status top-right, identity bottom-right.
+ *
+ * Decorative: callers put the accessible name ("Main agent",
+ * "Agent 2 — invoices") on the button itself, so the numeral is aria-hidden.
+ */
+export declare function AgentChatIcon({ line, className, }: {
+    readonly line: number;
+    readonly className?: string;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,17 @@
+import { WorkPhase } from '../../embed/voice-narration.ts';
+/**
+ * The ONE phase→icon mapping for "an agent is working right now" — extracted
+ * from CallScreen (the orb's work badge + each agent-board card's working
+ * icon) so the rail's agent-group badges (Rail-C) wear the SAME icon per
+ * phase instead of a second hand-rolled copy drifting from the first.
+ *
+ * `phase === null` means "working but the kind of work isn't classified yet"
+ * (e.g. between dispatch and the run's first tool call) — a spinner, not a
+ * missing icon. Every caller passes its own `className` for sizing/color;
+ * the spinner's `animate-spin` is baked in here rather than left to callers,
+ * since a non-spinning "spinner" icon would be a silent visual bug.
+ */
+export declare function AgentPhaseIcon({ phase, className, }: {
+    readonly phase: WorkPhase | null;
+    readonly className?: string;
+}): import("react").JSX.Element;

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

@@ -1,3 +1,4 @@
+import { SessionSummary } from './EmbedSessions.tsx';
 import { BelongTheme, BelongThemePalette, PresetName } from '../../types/public.ts';
 /**
  * Logged-in user avatar (rail top). Opens a menu: "Signed in as …", the theme
@@ -7,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, accent, cssVars, presets, activePreset, onToggleMode, onToggleSide, onAccentChange, onAccentReset, onCssVarsChange, onApplyPreset, onLogout, }: {
+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;
@@ -17,10 +18,14 @@ export declare function EmbedAvatar({ user, size, theme, palette, side, menuSide
      *  the mobile bottom nav bar overrides it to open upward. */
     menuSide?: "left" | "right" | "top";
     /** Active chat session id (null when no conversation is open yet). Shown in
-     *  the menu under the build stamp and copyable for telemetry correlation. */
+     *  the menu under the build stamp and copyable for telemetry correlation;
+     *  also the History submenu's active-row indicator (Rail-D). */
     sessionId: string | null;
     /** Browser supports mic capture — gates the Voice (push-to-talk) section. */
     voiceSupported: boolean;
+    /** Recent sessions for the History submenu (Rail-D: demoted from the
+     *  rail's own dropdown into the settings menu). */
+    sessions: readonly SessionSummary[];
     accent: string | null;
     cssVars: Record<string, string>;
     presets: readonly {
@@ -35,4 +40,18 @@ export declare function EmbedAvatar({ user, size, theme, palette, side, menuSide
     onCssVarsChange: (v: Record<string, string>) => void;
     onApplyPreset: (name: PresetName) => void;
     onLogout: () => void;
+    onNewSession: () => void;
+    onSelectSession: (id: string) => void;
+    onDeleteSession: (id: string) => void;
+    onRenameSession: (id: string, title: string) => void;
+    /** 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, 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;
@@ -58,9 +58,28 @@ export declare function EmbedRail({ view, collapsed, user, theme, palette, sessi
     onLogout: () => void;
     onNewSession: () => void;
     onSelectSession: (id: string) => void;
+    /** 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).
+     *  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
+     *  for lines 2+ (line 1 is the foreground chat; see `agentItem`). */
+    onCloseAgentLine: (line: number) => void;
     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

@@ -4,14 +4,43 @@ export interface SessionSummary {
     readonly title: string | null;
     readonly updatedAt: string;
 }
+type SessionsBodyProps = {
+    sessions: readonly SessionSummary[];
+    activeId: string | null;
+    onNew: () => void;
+    onSelect: (id: string) => void;
+    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 —
+ * the reusable half of the sessions switcher. `EmbedSessions` below wraps this
+ * in its own `DropdownMenu`/`DropdownMenuContent` for the rail/mobile trigger;
+ * `EmbedAvatar`'s History submenu wraps the SAME body in a
+ * `DropdownMenuSub`/`DropdownMenuSubContent` instead (Rail-D) — one
+ * implementation of rename/delete/select, two menu shells. Radix unmounts a
+ * 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, 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, }: {
-    sessions: readonly SessionSummary[];
-    activeId: string | null;
+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. */
@@ -22,11 +51,7 @@ export declare function EmbedSessions({ sessions, activeId, theme, side, trigger
     /** Visible text under the trigger icon (mobile nav names its cells; the
      *  rail stays icon-only). */
     triggerLabel?: string;
-    onNew: () => void;
-    onSelect: (id: string) => void;
-    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;
     /** Fired when the menu opens — the dock refetches the list so it's fresh. */
     onOpen?: () => void;
 }): import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,32 @@
+/**
+ * Pending session-adoption notice (Rail-D) — the "Loaded into Agent N" line
+ * the chat shows after the user opens an old conversation from the History
+ * menu. Selecting a session REMOUNTS ChatRoute (BelongDock's `setChatMount`),
+ * which wipes any notice appended at select time — so the notice can't be
+ * fired where the selection happens. Instead the select handler records a
+ * pending entry here (module singleton, survives the remount), and the NEW
+ * ChatRoute consumes it once it mounts on that session.
+ *
+ * One slot, last-write-wins: a second selection before the first mount lands
+ * simply replaces the pending entry — only the session actually mounted gets
+ * its notice. Consuming for a non-matching session leaves the entry alone
+ * (an unrelated remount must not swallow it) — it is dropped only when a
+ * NEWER selection overwrites it.
+ */
+/** Record that `sessionId` was just opened from History into agent `line`. */
+export declare const setPendingAdoptionNotice: (sessionId: string, line: number) => void;
+/** 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/auth0-cache.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Auth0 SPA localStorage-cache discovery, shared by the script auto-embed,
+ * React component compatibility path, and proactive refresher.
+ *
+ * Entries live under `@@auth0spajs@@::<clientId>::<audience>::<scope>`. Callers
+ * provide the exact audience(s) they are allowed to forward. We never fall
+ * back to an unrelated entry: localStorage can contain credentials for several
+ * APIs, and forwarding an arbitrary bearer token to Belong would disclose it
+ * before belong-cloud had a chance to reject its audience.
+ */
+/**
+ * Known Simetrik API audiences accepted by belong-cloud. Regional values take
+ * precedence over the legacy misspelled value so an old cache entry cannot
+ * mask a current region token. The list lets both the script and React
+ * component integrations find the token already cached by app.simetrik.com,
+ * app.mx.simetrik.com, or app.br.simetrik.com.
+ */
+export declare const DEFAULT_AUTH0_AUDIENCES: readonly string[];
+export type Auth0CacheEntry = {
+    readonly clientId: string;
+    readonly audience: string;
+    readonly scope: string;
+    readonly accessToken: string;
+};
+/** A single audience (possibly a comma-separated list) or an explicit list →
+ *  the ordered, trimmed, non-empty audience array. */
+export declare const normalizeAudiences: (audience: string | readonly string[]) => readonly string[];
+/**
+ * The cache entry the dock should use: the first configured audience with an
+ * entry wins in list order. Null when no explicitly allowed audience is cached.
+ */
+export declare const findAuth0CacheEntry: (audience: string | readonly string[]) => Auth0CacheEntry | null;

package/dist/embed/auth0-refresh.d.ts

@@ -55,13 +55,16 @@ export type TokenRefreshClient = {
 };
 /**
  * Derive the Auth0 config from the host's `@@auth0spajs@@` localStorage cache.
- * Returns null when no entry matches `audience` (host isn't Auth0-SPA, or the
- * user isn't signed in for this API) — the caller then degrades to a no-op.
+ * Accepts one audience or an ordered list. Resolution is shared with the token
+ * provider via `findAuth0CacheEntry`, so the refresher keys its Auth0Client to
+ * the SAME explicitly allowed entry whose token the dock sends. Returns null
+ * when nothing usable is cached (host isn't Auth0-SPA, or the user isn't signed
+ * in) — the caller then degrades to a no-op.
  */
-export declare const deriveAuth0RefreshConfig: (audience: string) => Auth0RefreshConfig | null;
+export declare const deriveAuth0RefreshConfig: (audience: string | readonly string[]) => Auth0RefreshConfig | null;
 export type InstallAuth0RefreshOptions = {
-    /** The API audience whose token the dock sends (matches auto-embed's). */
-    readonly audience: string;
+    /** The API audience(s) whose token the dock sends (matches auto-embed's). */
+    readonly audience: string | readonly string[];
     /** Idle keepalive cadence; defaults to 10 min. */
     readonly keepaliveIntervalMs?: number;
     /** Injected in tests so no real Auth0Client / network is constructed. */

package/dist/embed/copy.d.ts

@@ -68,6 +68,8 @@ export type MenuCopy = {
     readonly lightMode: string;
     readonly moveLeft: string;
     readonly moveRight: string;
+    /** History submenu label (Rail-D: the demoted sessions switcher). */
+    readonly history: string;
     readonly voice: string;
     readonly pushToTalk: string;
     readonly pressAnyKey: string;

package/dist/embed/dock-state.d.ts

@@ -30,3 +30,19 @@ export type ViewClickResult = {
     readonly size: DockSize;
 };
 export declare const resolveViewClick: (clickedView: DockView, currentView: DockView, currentSize: DockSize) => ViewClickResult;
+/**
+ * Decide what a NAVIGATION intent does — "show me this view", as opposed to a
+ * rail icon's toggle. A rail agent chip is navigation: the user is asking for
+ * that agent's chat, so it must ALWAYS land on the view (expanding a collapsed
+ * dock) and must never minimize, even when the dock is already open on chat.
+ * Routing an agent chip through `resolveViewClick` made "select Agent 2 while
+ * chat is open" collapse the dock instead of switching agents.
+ *
+ * Deliberately a SEPARATE entry point rather than a flag on `resolveViewClick`:
+ * the Chat rail icon's minimize toggle is intentional behaviour and stays
+ * exactly as it was.
+ */
+export declare const resolveViewNavigation: (currentSize: DockSize) => {
+    readonly action: "navigate";
+    readonly size: DockSize;
+};

package/dist/embed/global.d.ts

@@ -28,6 +28,12 @@ export declare const peekPanelEnabled: () => boolean;
  * didn't configure one — the consent surface stays hidden then.
  */
 export declare const peekAgentGrantConfig: () => AgentGrantConfig | null;
+/** Grant provider when the host set a workspace but named none (single-provider
+ *  product today). Keep in sync with the backend's default grant provider.
+ *  DEPRECATED backcompat default: a generic host should never inherit another
+ *  tenant's provider. The next major requires an explicit
+ *  `init({ agentGrant: { provider } })` (omitted → grants off). */
+export declare const DEFAULT_AGENT_GRANT_PROVIDER = "simetrik";
 /**
  * The CURRENT grant scope. A workspace in effect (host override ▸ live URL param
  * ▸ static init value — see embed/workspace-scope.ts) IS the trigger: the dock

package/dist/embed/host-layout-vars.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The dock → host layout contract: the CSS custom properties the SDK publishes
+ * on `document.documentElement` so a host page can lay its own fixed, sticky,
+ * and portal-mounted UI out inside the viewport the dock leaves free.
+ *
+ * See docs/guides/011-host-layout-contract.md.
+ *
+ * EVERY variable is written on EVERY update — the inactive side is `0px`, not
+ * absent. A host stylesheet computing
+ *
+ *   width: calc(100vw - var(--belong-dock-left-offset) - var(--belong-dock-right-offset))
+ *
+ * must never hit an undefined operand, which would invalidate the whole
+ * declaration.
+ */
+export declare const HOST_LAYOUT_VAR_NAMES: readonly ["--belong-dock-side", "--belong-dock-width", "--belong-dock-left-offset", "--belong-dock-right-offset", "--belong-dock-reserve-left", "--belong-dock-reserve-right"];
+export type HostLayoutVars = Readonly<Record<string, string>>;
+/**
+ * `reservePx` is the dock's TOTAL footprint on its side (chat dock + plan +
+ * preview panels) — exactly what `<body>` padding reserves. Pass 0 when the
+ * dock overlays instead of reserving (mobile sheet, no configured panel), so
+ * the host reads a full-width viewport.
+ */
+export declare const resolveHostLayoutVars: (side: "left" | "right", reservePx: number) => HostLayoutVars;