@belonguniverseai/react-sdk 0.3.6 → 0.4.0

package/dist/component/{mindmap-definition-RKZ34NQL-RZVaz4dV.js → mindmap-definition-RKZ34NQL-DeQED-9b.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-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";
 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-DeQED-9b.js.map

package/dist/component/{pieDiagram-4H26LBE5-CEwcfNwI.js → pieDiagram-4H26LBE5-CZ5Zt_mz.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-iO2IZZUN.js";
+import { p as gt } from "./chunk-4BX2VUAB-DlsylVfZ.js";
 import { p as dt } from "./wardley-L42UT6IY-HA1eSIS_.js";
-import { d as P } from "./arc-6nY2VvBR.js";
+import { d as P } from "./arc-BhIvhaIH.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-CZ5Zt_mz.js.map

package/dist/component/{quadrantDiagram-W4KKPZXB-BJBEiTgK.js → quadrantDiagram-W4KKPZXB-Dib1AukJ.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-iO2IZZUN.js";
+import { l as te } from "./linear-D1rJivs3.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-Dib1AukJ.js.map

package/dist/component/{requirementDiagram-4Y6WPE33-CVHog8O-.js → requirementDiagram-4Y6WPE33-DubjTJYS.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-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";
 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-DubjTJYS.js.map

package/dist/component/{sankeyDiagram-5OEKKPKP-Cn1N0qrl.js → sankeyDiagram-5OEKKPKP-Cq2S3XKs.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-iO2IZZUN.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-Cq2S3XKs.js.map

package/dist/component/{sequenceDiagram-3UESZ5HK-CRaBqdL0.js → sequenceDiagram-3UESZ5HK-BUo5k0zn.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-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";
 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-BUo5k0zn.js.map

package/dist/component/{stateDiagram-AJRCARHV-9q4hv0ii.js → stateDiagram-AJRCARHV-DJwQp0D7.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-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 { 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-DJwQp0D7.js.map

package/dist/component/{stateDiagram-v2-BHNVJYJU-By7O-5eN.js → stateDiagram-v2-BHNVJYJU-BX77P5aq.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-DmcGMHHV.js";
+import { _ as l } from "./mermaid-GHXKKRXX-iO2IZZUN.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-BX77P5aq.js.map

package/dist/component/{timeline-definition-PNZ67QCA-BWfxZI7f.js → timeline-definition-PNZ67QCA-DnQ481VI.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-iO2IZZUN.js";
+import { d as ot } from "./arc-BhIvhaIH.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-DnQ481VI.js.map

package/dist/component/{vennDiagram-CIIHVFJN-B_PQ6bU6.js → vennDiagram-CIIHVFJN-BQ0X92lQ.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-iO2IZZUN.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-BQ0X92lQ.js.map

package/dist/component/{wardleyDiagram-YWT4CUSO-P7tCzeA0.js → wardleyDiagram-YWT4CUSO-CMTnjVTA.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-iO2IZZUN.js";
+import { p as Bt } from "./chunk-4BX2VUAB-DlsylVfZ.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-CMTnjVTA.js.map

package/dist/component/{xychartDiagram-2RQKCTM6-B4Z_Zrko.js → xychartDiagram-2RQKCTM6-BLSiRWug.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-iO2IZZUN.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-D1rJivs3.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-BLSiRWug.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, }: {
     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,11 @@ 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;
 }): 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, onToggleSpeak, onExpand, }: {
     view: EmbedView;
     collapsed: boolean;
     user: string | null;
@@ -58,6 +58,17 @@ 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).
+     *  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;
+    /** 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;

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

@@ -4,14 +4,32 @@ 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;
+};
+/**
+ * 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, }: 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, }: 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 +40,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/embed/adoption-notice.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 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;
+/** 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;

package/dist/embed/host-push-controller.d.ts

@@ -0,0 +1,67 @@
+/**
+ * BEL-112 / push layout: keeps HOST `position: fixed` surfaces out from under
+ * the dock.
+ *
+ * `<body>` padding reserves the dock's width for everything in the normal
+ * flow. Fixed host UI escapes that flow — a right-anchored Simetrik drawer,
+ * a portal-mounted popout, a drawer scrim, a centered modal — so this
+ * controller finds those surfaces and writes ONE inline margin per element to
+ * shift or shrink them into the free viewport. The geometry lives in
+ * embed/host-surface.ts; this file is the DOM adapter around it.
+ *
+ * Two escape hatches for the failure modes a host can put us in:
+ *
+ *   fight detection  a host that repositions its own surface against our
+ *                    margin never converges (customer report: rename dialog
+ *                    shaking left↔right). Writes are budgeted per element
+ *                    within a stable footprint+viewport epoch; past the cap
+ *                    the element is left alone forever.
+ *   yield            a surface too wide to fit beside the dock can't be
+ *                    corrected at all, so the DOCK gives way instead — the
+ *                    owner collapses it to the rail via `onYieldNeeded` and
+ *                    restores on `onYieldCleared`.
+ *
+ * No React: the owner injects the two callbacks and pushes layout changes in.
+ */
+/** Per-element inline-margin writes allowed inside one stable epoch. */
+export declare const MAX_HOST_SURFACE_SHIFT_WRITES = 4;
+export type HostPushLayout = {
+    readonly side: "left" | "right";
+    /** Total width the dock reserves: chat dock + plan panel + preview panel. */
+    readonly reservePx: number;
+};
+export type HostPushControllerDeps = {
+    /**
+     * A surface can't fit beside the dock — the owner should collapse. Called
+     * once per yield episode, never while a yield is already pending.
+     */
+    readonly onYieldNeeded: () => void;
+    /** Every surface that forced the yield is gone — the owner may restore. */
+    readonly onYieldCleared: () => void;
+};
+export type HostPushController = {
+    /** Push new layout inputs and re-evaluate (dock resized, side flipped). */
+    readonly setLayout: (layout: HostPushLayout) => void;
+    /** Request an evaluation on the next frame (coalesced). */
+    readonly schedule: () => void;
+    /** Disconnect observers and restore every margin this controller wrote. */
+    readonly stop: () => void;
+};
+/**
+ * Candidate host surfaces, from three complementary sources:
+ *
+ *   1. dialog-ish elements anywhere (Radix and friends set one of these);
+ *   2. DIRECT CHILDREN of <body> that compute to `position: fixed` — where
+ *      React and Radix portals land, hit-testable or not;
+ *   3. anything currently under the dock, found by hit-testing the reserve
+ *      band — this is what catches a fixed drawer rendered INLINE deep in the
+ *      host's own tree, which is how plenty of hosts (Simetrik included) build
+ *      them.
+ *
+ * Probing every element's computed style would be far too expensive for a
+ * MutationObserver callback; between them these three cost a bounded number of
+ * style reads per evaluation. `position: sticky` is deliberately excluded —
+ * sticky lives in the normal flow, so the body padding already moves it.
+ */
+export declare const collectHostSurfaces: (side: "left" | "right", reservePx: number) => readonly HTMLElement[];
+export declare const startHostPushController: (initialLayout: HostPushLayout, deps: HostPushControllerDeps) => HostPushController;

package/dist/embed/host-surface.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Pure classification + correction geometry for HOST viewport-anchored
+ * surfaces (drawers, popouts, side panels, modal backdrops, centered modals).
+ *
+ * The dock reserves its width with `<body>` padding, which reflows everything
+ * in the normal flow. `position: fixed` host UI escapes that flow and would
+ * render underneath the dock, so the dock corrects it with one inline margin.
+ * Which margin, and how far, is decided here — no DOM, no React.
+ *
+ * Three correctable shapes:
+ *
+ *   full_bleed  an overlay spanning the viewport (a drawer's backdrop, an
+ *               `inset: 0` scrim). Shifting it would just move it off screen;
+ *               a margin on the dock side SHRINKS it, which is the fix.
+ *   anchored    a drawer/panel pinned to the dock's own viewport edge.
+ *   floating    a centered modal that merely overlaps the reserve band.
+ *
+ * `anchored` and `floating` share the legacy `resolveHostModalShiftPx`
+ * magnitude; they are distinguished so the classification is explicit and
+ * testable, and so a future rule can treat them differently.
+ */
+export type HostSurfaceRect = {
+    readonly left: number;
+    readonly right: number;
+};
+export type HostSurfaceKind = "clear" | "full_bleed" | "anchored" | "floating";
+/**
+ * How far a surface edge may sit from the viewport edge and still count as
+ * pinned to it. Generous on purpose: hosts inset drawers and scrims by a few
+ * pixels (`right: 8px`, a 1px border, scrollbar-gutter compensation) and those
+ * are still edge-anchored — misreading one as a free-floating modal would send
+ * it a margin the browser cannot act on.
+ */
+export declare const EDGE_ANCHOR_TOLERANCE_PX = 24;
+/**
+ * The inline property a correction writes, the signed DELTA to add to whatever
+ * margin the host already set there, and the shape it was derived from — the
+ * caller needs the kind to back the correction out of a later measurement (a
+ * shift moves the box; a shrink moves one edge).
+ */
+export type HostSurfaceCorrection = {
+    readonly property: "margin-left" | "margin-right";
+    readonly px: number;
+    readonly kind: HostSurfaceKind;
+};
+export declare const classifyHostSurface: (rect: HostSurfaceRect, viewportWidthPx: number, side: "left" | "right", reservePx: number) => HostSurfaceKind;
+/**
+ * The inline correction that moves `rect` (its UNSHIFTED position) out from
+ * under a dock reserving `reservePx` on `side`. `px: 0` means leave it alone.
+ */
+export declare const resolveHostSurfaceCorrection: (rect: HostSurfaceRect, viewportWidthPx: number, side: "left" | "right", reservePx: number) => HostSurfaceCorrection;
+/**
+ * Can this surface be corrected and still sit fully on screen? A full-bleed
+ * overlay always can (shrinking it never pushes it off). Shifted surfaces are
+ * judged by the legacy fit test. False means the dock must yield instead.
+ */
+export declare const canHostSurfaceFitBesideDock: (rect: HostSurfaceRect, viewportWidthPx: number, side: "left" | "right", reservePx: number) => boolean;