@belonguniverseai/react-sdk 0.1.2 → 0.1.4-beta

package/dist/component/{mindmap-definition-RKZ34NQL-C0g8QURW.js → mindmap-definition-RKZ34NQL-DB-r9g1c.js}

@@ -1,6 +1,6 @@
-import { g as oe } from "./chunk-55IACEB6-CLJ9pgvn.js";
-import { s as ae } from "./chunk-2J33WTMH-iwZo17vf.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-Bk5cDfRV.js";
+import { g as oe } from "./chunk-55IACEB6-CcASKowe.js";
+import { s as ae } from "./chunk-2J33WTMH-BAqJCIVt.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-CUwFO8-B.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-C0g8QURW.js.map
+//# sourceMappingURL=mindmap-definition-RKZ34NQL-DB-r9g1c.js.map

package/dist/component/{pieDiagram-4H26LBE5-Mbexiv4J.js → pieDiagram-4H26LBE5-CMqPVjRg.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-Bk5cDfRV.js";
-import { p as gt } from "./chunk-4BX2VUAB-CKT6dptL.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-CUwFO8-B.js";
+import { p as gt } from "./chunk-4BX2VUAB-CTC8q-Ea.js";
 import { p as dt } from "./wardley-L42UT6IY-HA1eSIS_.js";
-import { d as P } from "./arc-DPDIJagU.js";
+import { d as P } from "./arc-BxS7Httb.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-Mbexiv4J.js.map
+//# sourceMappingURL=pieDiagram-4H26LBE5-CMqPVjRg.js.map

package/dist/component/{quadrantDiagram-W4KKPZXB-BPRDLHzc.js → quadrantDiagram-W4KKPZXB-DWWi29dP.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-Bk5cDfRV.js";
-import { l as te } from "./linear-COVcd8bM.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-CUwFO8-B.js";
+import { l as te } from "./linear-BdhJkh0B.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-BPRDLHzc.js.map
+//# sourceMappingURL=quadrantDiagram-W4KKPZXB-DWWi29dP.js.map

package/dist/component/{requirementDiagram-4Y6WPE33-XjOXpLfB.js → requirementDiagram-4Y6WPE33-D1nFFrnS.js}

@@ -1,6 +1,6 @@
-import { g as Ge } from "./chunk-55IACEB6-CLJ9pgvn.js";
-import { s as ze } from "./chunk-2J33WTMH-iwZo17vf.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-Bk5cDfRV.js";
+import { g as Ge } from "./chunk-55IACEB6-CcASKowe.js";
+import { s as ze } from "./chunk-2J33WTMH-BAqJCIVt.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-CUwFO8-B.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-XjOXpLfB.js.map
+//# sourceMappingURL=requirementDiagram-4Y6WPE33-D1nFFrnS.js.map

package/dist/component/{sankeyDiagram-5OEKKPKP-Boo0vXVH.js → sankeyDiagram-5OEKKPKP-BnfzKSOs.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-Bk5cDfRV.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-CUwFO8-B.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-Boo0vXVH.js.map
+//# sourceMappingURL=sankeyDiagram-5OEKKPKP-BnfzKSOs.js.map

package/dist/component/{sequenceDiagram-3UESZ5HK-CmZk5hb2.js → sequenceDiagram-3UESZ5HK-D3r-W-Vw.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-Bk5cDfRV.js";
-import { a as pr, b as ee, g as dt, d as Er, e as re, f as ae } from "./chunk-ND2GUHAM-BUngsBoq.js";
-import { I as ur } from "./chunk-QZHKN3VN-CFfcj0kF.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-CUwFO8-B.js";
+import { a as pr, b as ee, g as dt, d as Er, e as re, f as ae } from "./chunk-ND2GUHAM-_nr7rOab.js";
+import { I as ur } from "./chunk-QZHKN3VN-BCKH-gFC.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-CmZk5hb2.js.map
+//# sourceMappingURL=sequenceDiagram-3UESZ5HK-D3r-W-Vw.js.map

package/dist/component/{stateDiagram-AJRCARHV-zKdC8ZqU.js → stateDiagram-AJRCARHV-Ba3bMrr0.js}

@@ -1,5 +1,5 @@
-import { s as R, a as W, S as N } from "./chunk-AQP2D5EJ-iLdnjZec.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-Bk5cDfRV.js";
+import { s as R, a as W, S as N } from "./chunk-AQP2D5EJ-B_-4XjtP.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-CUwFO8-B.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-zKdC8ZqU.js.map
+//# sourceMappingURL=stateDiagram-AJRCARHV-Ba3bMrr0.js.map

package/dist/component/{stateDiagram-v2-BHNVJYJU-C3TFxstc.js → stateDiagram-v2-BHNVJYJU-YCAvqrHf.js}

@@ -1,5 +1,5 @@
-import { s as e, b as r, a as s, S as t } from "./chunk-AQP2D5EJ-iLdnjZec.js";
-import { _ as l } from "./mermaid-GHXKKRXX-Bk5cDfRV.js";
+import { s as e, b as r, a as s, S as t } from "./chunk-AQP2D5EJ-B_-4XjtP.js";
+import { _ as l } from "./mermaid-GHXKKRXX-CUwFO8-B.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-C3TFxstc.js.map
+//# sourceMappingURL=stateDiagram-v2-BHNVJYJU-YCAvqrHf.js.map

package/dist/component/{timeline-definition-PNZ67QCA-DV17S1NP.js → timeline-definition-PNZ67QCA-DlxU8RFH.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-Bk5cDfRV.js";
-import { d as ot } from "./arc-DPDIJagU.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-CUwFO8-B.js";
+import { d as ot } from "./arc-BxS7Httb.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-DV17S1NP.js.map
+//# sourceMappingURL=timeline-definition-PNZ67QCA-DlxU8RFH.js.map

package/dist/component/{vennDiagram-CIIHVFJN-DtHYS_yc.js → vennDiagram-CIIHVFJN-teVIHl4-.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-Bk5cDfRV.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-CUwFO8-B.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-DtHYS_yc.js.map
+//# sourceMappingURL=vennDiagram-CIIHVFJN-teVIHl4-.js.map

package/dist/component/{wardleyDiagram-YWT4CUSO-BxPk1XTc.js → wardleyDiagram-YWT4CUSO-B31MFPtu.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-Bk5cDfRV.js";
-import { p as Bt } from "./chunk-4BX2VUAB-CKT6dptL.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-CUwFO8-B.js";
+import { p as Bt } from "./chunk-4BX2VUAB-CTC8q-Ea.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-BxPk1XTc.js.map
+//# sourceMappingURL=wardleyDiagram-YWT4CUSO-B31MFPtu.js.map

package/dist/component/{xychartDiagram-2RQKCTM6-C3o6FXYC.js → xychartDiagram-2RQKCTM6-csegzRq-.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-Bk5cDfRV.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-CUwFO8-B.js";
 import { i as di } from "./init-BOu0eQYQ.js";
 import { o as fi } from "./ordinal-D0x7izaa.js";
-import { l as Dt } from "./linear-COVcd8bM.js";
+import { l as Dt } from "./linear-BdhJkh0B.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-C3o6FXYC.js.map
+//# sourceMappingURL=xychartDiagram-2RQKCTM6-csegzRq-.js.map

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

@@ -9,10 +9,12 @@ import { BelongThemeBrand, BelongThemePalette } from '../../types/public.ts';
  *   active                   → slim "connected until <time>" row + revoke
  *   unconfigured embed       → renders nothing (host didn't pass a scope)
  *
- * The scope (the host's active workspace) is re-read from the page URL
- * (SPA pushState doesn't fire events, so poll): switching workspace
- * re-keys the status query — a grant is single-workspace, so the new
- * workspace prompts its own consent, and dismissal is per-workspace.
+ * The scope (the host's active workspace) comes from the shared
+ * workspace-scope store (embed/workspace-scope.ts — one URL poll +
+ * `belong.setWorkspace`, shared with the session list / Files tab / chat):
+ * switching workspace re-keys the status query — a grant is
+ * single-workspace, so the new workspace prompts its own consent, and
+ * dismissal is per-workspace.
  *
  * The Allow click POSTs with the same host web JWT every API call
  * carries; only status + expiry ever come back — never tokens.

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

@@ -10,6 +10,12 @@ import { ReactNode } from 'react';
  * refocus stays seamless. Each picker passes its own ids / test-ids / aria-label
  * (consumed by the composer's `aria-controls` + `aria-activedescendant`) and a
  * `layout` for the only part that differs — the row's flex direction/gap.
+ *
+ * The option rows live in their own `overflow-auto` scroll region so a long list
+ * scrolls INSIDE the capped popover (`max-h-60`); an optional `header` is pinned
+ * above that region (it stays put while the rows scroll). Keyboard highlight
+ * follows the scroll — see the selected-row `scrollIntoView` in
+ * {@link ComposerMenuOption}.
  */
 /** The highlight + select callbacks both composer pickers take from the parent. */
 export type ComposerPickerProps = {
@@ -17,10 +23,12 @@ export type ComposerPickerProps = {
     onSelect: (value: string) => void;
     onHighlight: (index: number) => void;
 };
-export declare function ComposerMenu({ id, testId, ariaLabel, children, }: {
+export declare function ComposerMenu({ id, testId, ariaLabel, header, children, }: {
     id: string;
     testId: string;
     ariaLabel: string;
+    /** Pinned above the scroll region — stays visible while the rows scroll. */
+    header?: ReactNode;
     children: ReactNode;
 }): import("react").JSX.Element;
 export declare function ComposerMenuOption({ id, testId, selected, index, layout, onSelect, onHighlight, children, }: {

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

@@ -1,3 +1,5 @@
+import { VoiceActionFlash } from '../../embed/closed-surface-voice-bus.ts';
+import { VoiceStatus } from '../../embed/voice-bus.ts';
 import { SessionSummary } from './EmbedSessions';
 import { PlanProgress } from '../../stream/plan-progress.ts';
 import { BelongTheme, BelongThemePalette, PresetName } from '../../types/public.ts';
@@ -9,7 +11,7 @@ export type EmbedView = "chat" | "files";
  * 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, accent, cssVars, presets, activePreset, onSelectView, onToggleCollapse, onToggleMode, onToggleSide, onAccentChange, onAccentReset, onCssVarsChange, onApplyPreset, onLogout, onNewSession, onSelectSession, onDeleteSession, 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, onDeleteSession, onRenameSession, onSessionsOpen, onToggleSpeak, onExpand, }: {
     view: EmbedView;
     collapsed: boolean;
     user: string | null;
@@ -24,6 +26,20 @@ export declare function EmbedRail({ view, collapsed, user, theme, palette, sessi
     ttsSupported: boolean;
     /** Browser supports mic capture — gates the avatar menu's Voice section. */
     voiceSupported: boolean;
+    /** Live capture status for the rail's voice cue, or null to show none.
+     *  The dock passes it only while the chat surface (and thus VoiceOverlay)
+     *  is off-screen — collapsed or on another view — so push-to-talk still
+     *  gives visible feedback without yanking the panel open. */
+    voiceStatus: VoiceStatus | null;
+    /** Held dictation draft shown on the rail while the chat surface is closed
+     *  and confirm-mode is active; null shows no chip. */
+    pendingVoiceDraft: string | null;
+    /** Transient action confirmation (sent / approved / rejected); the seq lets a
+     *  repeated same-kind action re-trigger the flash. */
+    voiceActionFlash: {
+        readonly kind: VoiceActionFlash;
+        readonly seq: number;
+    } | null;
     accent: string | null;
     cssVars: Record<string, string>;
     presets: readonly {
@@ -43,6 +59,7 @@ export declare function EmbedRail({ view, collapsed, user, theme, palette, sessi
     onNewSession: () => void;
     onSelectSession: (id: string) => void;
     onDeleteSession: (id: string) => void;
+    onRenameSession: (id: string, title: string) => void;
     onSessionsOpen?: () => void;
     onToggleSpeak: () => void;
     onExpand: () => void;

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

@@ -5,11 +5,11 @@ export interface SessionSummary {
     readonly updatedAt: string;
 }
 /**
- * Header control to start a new chat, switch to a recent session, or delete
- * one via an inline trash → confirm flow. Supports new chat, switch, and
- * per-row delete (inline confirm).
+ * 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, onNew, onSelect, onDelete, onOpen, }: {
+export declare function EmbedSessions({ sessions, activeId, theme, side, onNew, onSelect, onDelete, onRename, onOpen, }: {
     sessions: readonly SessionSummary[];
     activeId: string | null;
     theme: BelongTheme;
@@ -18,6 +18,8 @@ export declare function EmbedSessions({ sessions, activeId, theme, side, onNew,
     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;

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

@@ -1,5 +1,15 @@
 import { KeyboardEvent as ReactKeyboardEvent, Ref } from 'react';
 import { BelongThemePalette } from '../../types/public.ts';
+/**
+ * Is the editor the focused element within its OWN root? The dock mounts in a
+ * shadow root, where `el.ownerDocument.activeElement` is the shadow HOST (the dock
+ * element), never the inner editor — so a document-level focus check always reads
+ * "not focused", the caret-restore in the controlled-sync effect is skipped, and
+ * the caret collapses to offset 0 on every Shift+Enter / paste (BEL-94).
+ * `getRootNode()` returns the ShadowRoot (or Document in the light DOM); both
+ * expose `activeElement` scoped to that tree, so this holds in either mount.
+ */
+export declare const isEditorFocused: (el: HTMLElement) => boolean;
 export type MentionInputHandle = {
     focus: () => void;
     getCaret: () => number | null;

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

@@ -2,12 +2,16 @@ import { SkillSummary } from '../../api/skills.ts';
 import { ComposerPickerProps } from './ComposerMenu';
 /**
  * Slash-command menu shown above the composer when the user types `/`. Purely
- * presentational — the parent owns the filtered list, highlight, and select.
- * Skills render under group headings (app groups, plus a "Your skills" section
- * for the user's own installed skills); a header is emitted whenever the group
- * changes between consecutive options, so the flat highlight index the parent
- * tracks stays intact. Built on the shared {@link ComposerMenu} chrome.
+ * presentational — the parent owns the filtered list, highlight, select, and the
+ * `collapsed` state. Skills render under group headings (app groups, plus a
+ * "Your skills" section for the user's own installed skills); a header is emitted
+ * whenever the group changes between consecutive options, so the flat highlight
+ * index the parent tracks stays intact. A pinned title bar carries a
+ * minimize/expand toggle; when `collapsed`, only that bar shows. Built on the
+ * shared {@link ComposerMenu} chrome.
  */
-export declare function SlashCommandMenu({ skills, highlightedIndex, onSelect, onHighlight, }: {
+export declare function SlashCommandMenu({ skills, highlightedIndex, collapsed, onToggleCollapse, onSelect, onHighlight, }: {
     skills: readonly SkillSummary[];
+    collapsed: boolean;
+    onToggleCollapse: () => void;
 } & ComposerPickerProps): import("react").JSX.Element;

package/dist/components/feedback/feedback-metadata.d.ts

@@ -1,36 +1,10 @@
-import { z } from 'zod';
+import { BelongMessageMetadata } from '../../stream/message-metadata.ts';
 import { FeedbackSentiment } from './message-feedback.tsx';
-export declare const feedbackMetadataSchema: z.ZodObject<{
-    taskId: z.ZodString;
-    feedback: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-        sentiment: z.ZodEnum<["up", "down"]>;
-        reason: z.ZodNullable<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        reason: string | null;
-        sentiment: "up" | "down";
-    }, {
-        reason: string | null;
-        sentiment: "up" | "down";
-    }>>>;
-}, "strip", z.ZodTypeAny, {
-    taskId: string;
-    feedback?: {
-        reason: string | null;
-        sentiment: "up" | "down";
-    } | null | undefined;
-}, {
-    taskId: string;
-    feedback?: {
-        reason: string | null;
-        sentiment: "up" | "down";
-    } | null | undefined;
-}>;
 /**
- * Narrow an assistant message's `unknown` metadata to its feedback shape, or
- * null when it carries no taskId (user turns, pre-feedback rows) — which hides
- * the feedback row.
+ * Flatten a message's metadata to its feedback shape, or null when it carries
+ * no taskId (user turns, pre-feedback rows) — which hides the feedback row.
  */
-export declare const readFeedbackMetadata: (meta: unknown) => {
+export declare const readFeedbackMetadata: (meta: BelongMessageMetadata | undefined) => {
     readonly taskId: string;
     readonly sentiment: FeedbackSentiment | null;
     readonly reason: string | null;

package/dist/embed/approval-bus.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Registry of tool-approval cards awaiting a decision, so the voice transcript
+ * handler in ChatRoute can resolve one hands-free (chat surface closed) without
+ * reaching into a card's local state. Each ApprovalRenderer registers while its
+ * card is actionable and calls the returned cleanup on resolve/unmount. `peek`
+ * returns the most-recently-registered entry — the card the user is answering.
+ */
+export type ApprovalCardDecision = "approved" | "rejected" | "amend_requested";
+export type PendingApproval = {
+    readonly approvalId: string;
+    readonly resolve: (decision: ApprovalCardDecision) => void;
+};
+export declare const registerPendingApproval: (entry: PendingApproval) => (() => void);
+export declare const peekPendingApproval: () => PendingApproval | null;

package/dist/embed/approval-decision.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Spoken tool-approval decision (pure, no DOM). While a `data-approval-request`
+ * card is actionable, a final voice transcript is classified into the card's
+ * wire decisions. Safety bias mirrors plan-decision: a modification marker
+ * anywhere → amend_requested (never approve/reject a card the user wants
+ * changed); reject checked before approve; unrecognized speech → "unclear",
+ * which the caller ignores rather than resolving the card by accident.
+ */
+export type ApprovalVoiceDecision = "approved" | "rejected" | "amend_requested" | "unclear";
+export declare const interpretApprovalDecision: (transcript: string) => ApprovalVoiceDecision;

package/dist/embed/auto-embed.d.ts

@@ -4,7 +4,7 @@
  * Lets a host drop the dock in with a single tag and no glue JS:
  *
  *   <script src="https://…/belong-a3s-sdk.js" id="belong-sdk-script"
- *           data-backend="https://api.example.com"></script>
+ *           data-backend="https://api.example.com" data-locale="es"></script>
  *
  * On load we find that tag, read `data-backend`, and — for hosts that sign the
  * user in with Auth0 (e.g. Simetrik) — read the user's EXISTING access token

package/dist/embed/closed-surface-voice-bus.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Coordinates CLOSED-surface voice UI state between the two always-mounted
+ * sibling components: BelongDock (owns the rail + collapse/view) publishes
+ * `surfaceHidden`; ChatRoute (owns conversation + draft) publishes the pending
+ * dictation draft and fires a transient action flash. BelongDock feeds the
+ * draft + flash into the rail as props. One immutable snapshot per mutation so
+ * `useSyncExternalStore` observes identity changes.
+ */
+export type VoiceActionFlash = "sent" | "approved" | "rejected";
+export type ClosedSurfaceVoiceState = {
+    readonly surfaceHidden: boolean;
+    readonly pendingDraft: string | null;
+    readonly lastAction: {
+        readonly kind: VoiceActionFlash;
+        readonly seq: number;
+    } | null;
+};
+export declare const subscribeClosedSurfaceVoice: (listener: () => void) => (() => void);
+export declare const peekClosedSurfaceVoice: () => ClosedSurfaceVoiceState;
+export declare const peekSurfaceHidden: () => boolean;
+export declare const peekPendingDraft: () => string | null;
+export declare const setSurfaceHidden: (hidden: boolean) => void;
+export declare const setPendingDraft: (text: string | null) => void;
+export declare const flashVoiceAction: (kind: VoiceActionFlash) => void;
+export declare const __resetClosedSurfaceVoiceForTest: () => void;

package/dist/embed/copy.d.ts

@@ -42,6 +42,9 @@ export type MenuCopy = {
     readonly pressAnyKey: string;
     readonly change: string;
     readonly reset: string;
+    readonly voiceSend: string;
+    readonly voiceSendConfirm: string;
+    readonly voiceSendAuto: string;
     readonly style: string;
     readonly appearance: string;
     readonly accentColor: string;

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

@@ -24,6 +24,38 @@ export declare const resolveDockWidthPx: (state: DockResizeState, panelWidth: nu
  * reflow of text at every intermediate width.
  */
 export declare const resolvePanelWidthPx: (state: DockResizeState, panelWidth: number) => number;
+/** Clearance a host modal needs from the dock before we consider it clear. */
+export declare const HOST_MODAL_GUTTER_PX = 16;
+/**
+ * BEL-112: would a host modal at `rect` land under a dock reserving
+ * `reservePx` on `side` of a `viewportWidthPx` viewport? Pure geometry — the
+ * caller decides what to do about it (yield: collapse to the rail).
+ */
+export declare const hostModalOverlapsReserve: (rect: {
+    readonly left: number;
+    readonly right: number;
+}, viewportWidthPx: number, side: "left" | "right", reservePx: number) => boolean;
+/**
+ * BEL-112 "side to side": the signed `margin-left` (px) that pushes a host
+ * modal at `rect` (its UNSHIFTED position) out from under the dock — negative
+ * shifts left for a right dock, positive shifts right for a left dock. 0 when
+ * it's already clear. Margin composes with the host's own `left: 50%;
+ * translateX(-50%)` centering AND its open/close transform animations,
+ * so the push never fights either.
+ */
+export declare const resolveHostModalShiftPx: (rect: {
+    readonly left: number;
+    readonly right: number;
+}, viewportWidthPx: number, side: "left" | "right", reservePx: number) => number;
+/**
+ * Can the modal clear the dock by shifting alone — i.e. after the shift it
+ * still sits fully on-screen (a gutter from the far edge)? When false the
+ * dock must yield instead (collapse to the rail).
+ */
+export declare const canHostModalFitBesideDock: (rect: {
+    readonly left: number;
+    readonly right: number;
+}, viewportWidthPx: number, side: "left" | "right", reservePx: number) => boolean;
 /** Collapse toggle: any open state → collapsed; collapsed → expanded. */
 export declare const nextOnToggleCollapse: (state: DockResizeState) => DockResizeState;
 /** Modal toggle: expanded ↔ modal; no-op while collapsed. */

package/dist/embed/global.d.ts

@@ -29,9 +29,10 @@ export declare const peekPanelEnabled: () => boolean;
  */
 export declare const peekAgentGrantConfig: () => AgentGrantConfig | null;
 /**
- * The CURRENT scope: the live URL param when tracking is configured (the
- * host SPA rewrites it on workspace switch without a reload), else the
- * static value from init. Null = no scope → grant surface hidden.
+ * The CURRENT scope: resolved by the workspace-scope store (host override ▸
+ * live URL param ▸ static init value — see embed/workspace-scope.ts, which
+ * the whole dock keys off). Null = no grant config or no workspace in effect
+ * → grant surface hidden.
  */
 export declare const resolveAgentGrantScope: () => {
     provider: string;

package/dist/embed/locale.d.ts

@@ -1,18 +1,37 @@
 import { BelongLocale } from '../types/public.ts';
 export type Locale = BelongLocale;
 export declare const DEFAULT_LOCALE: Locale;
-/** Set the host/tenant default locale (from `init`); user choice still wins. */
+/** Narrow an untrusted value (attribute, storage, navigator) to a Locale. */
+export declare const parseLocale: (value: unknown) => Locale | null;
+/**
+ * Declarative host/tenant default (from `init` / the React `locale` prop).
+ * The FIRST call seeds the deployment default — a stored user choice still
+ * wins. A LATER call with a different value is the host switching language
+ * at runtime (BEL-140): it drops the user override so the switch is visible.
+ * Re-applying the same value (React effect re-runs, re-`init`) is a no-op.
+ */
 export declare const configureLocale: (locale: Locale | undefined) => void;
+/**
+ * Imperative host switch (`belong.setLocale`, a `data-locale` attribute flip).
+ * Always applies and drops the user override — the host just told us the page
+ * language changed NOW.
+ */
+export declare const setHostLocale: (locale: Locale) => void;
 export declare const subscribeLocale: (listener: () => void) => (() => void);
-/** The effective locale: user choice, else host default, else English. */
+/** The effective locale: user choice ▸ host locale ▸ browser ▸ English. */
 export declare const peekLocale: () => Locale;
 /** The user's explicit choice, or null when none (host default applies). */
 export declare const peekUserLocale: () => Locale | null;
-/** Persist the user's language choice and notify subscribers. */
+/** Persist the user's in-dock language choice and notify subscribers. */
 export declare const setUserLocale: (locale: Locale) => void;
-/** Drop the user override (back to the host default / English). */
+/** Drop the user override (back to the host default / browser / English). */
 export declare const clearUserLocale: () => void;
 /** `useSyncExternalStore` hook — the effective locale, re-rendering on change. */
 export declare const useLocale: () => Locale;
-/** Test-only: clear listeners + host default and re-seed the user choice. */
+/**
+ * Test-only: reset host locale and re-seed the user choice from storage.
+ * Deliberately KEEPS the listener set — the i18next instance (`@sdk/i18n`)
+ * subscribes once at module load, and clearing it would silently detach the
+ * catalogs from the store for the rest of the test file.
+ */
 export declare const __resetLocaleForTest: () => void;

package/dist/embed/plan-decision.d.ts

@@ -1,6 +1,8 @@
 import { PlanData } from '../stream/belong-data-parts.ts';
 export type PlanDecision = "approve" | "reject" | "feedback";
-/** Classify a final voice transcript while a plan is awaiting a decision. */
+/** Classify a final voice transcript while a plan is awaiting a decision. A
+ *  modification marker (or anything unrecognized) is "feedback" — forwarded to
+ *  the agent verbatim rather than approving/rejecting a plan the user is tweaking. */
 export declare const interpretPlanDecision: (transcript: string) => PlanDecision;
 /**
  * Spoken announcement for a freshly proposed plan: title, summary, step

package/dist/embed/use-workspace-file-download.d.ts

@@ -10,6 +10,8 @@
  * `onError` so each component keeps its own `error` state (also used by its
  * `load()` flow).
  */
+/** `path` (+ the current workspace scope) as a workspace-file query string. */
+export declare const workspaceFileQuery: (path: string) => string;
 export declare function useWorkspaceFileDownload(apiBaseUrl: string, onError: (message: string | null) => void): {
     download: (path: string) => Promise<void>;
     downloading: string | null;

package/dist/embed/voice-decision.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Shared spoken-decision classifier for the two places we accept a voice
+ * approve/reject: a proposed plan (`plan-decision.ts`) and a tool-approval card
+ * (`approval-decision.ts`). Both apply the same safety ordering — a modification
+ * marker anywhere wins, reject is checked before approve, and bare yes/no/ok
+ * only decide on short utterances — over their own vocabularies, then map the
+ * outcome to their own domain type. Keeping the algorithm here (not copied into
+ * each caller) is the single source for that ordering.
+ */
+/** Per-caller vocabulary + the short-utterance bound for bare words. */
+export type DecisionVocab = {
+    /** Modification markers — any occurrence routes to "marker" (feedback/amend). */
+    readonly markers: readonly string[];
+    /** Unambiguous reject phrases, matched as a word-boundary prefix. */
+    readonly rejectPhrases: readonly string[];
+    /** Unambiguous approve phrases, matched as a word-boundary prefix. */
+    readonly approvePhrases: readonly string[];
+    /** Bare rejects ("no"…) — decide only as the first word of a short utterance. */
+    readonly bareRejectWords: readonly string[];
+    /** Bare approvals ("yes"…) — decide only as the first word of a short utterance. */
+    readonly bareApproveWords: readonly string[];
+    /** Bare words decide only when the utterance is at most this many words. */
+    readonly maxBareWords: number;
+};
+export type DecisionOutcome = "approve" | "reject" | "marker" | "none";
+/** Classify a final voice transcript against a caller's decision vocabulary. */
+export declare const classifyDecision: (transcript: string, vocab: DecisionVocab) => DecisionOutcome;

package/dist/embed/voice-phrase-match.d.ts

@@ -0,0 +1,5 @@
+/** Shared voice-transcript normalization + word-prefix matching. */
+/** Lowercase, strip diacritics + punctuation, collapse whitespace. */
+export declare const normalizeTranscript: (transcript: string) => string;
+/** True when `phrase` is a word-boundary prefix of the utterance's words. */
+export declare const startsWithPhrase: (words: readonly string[], phrase: string) => boolean;