@belonguniverseai/react-sdk 0.1.3 → 0.1.4-beta

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

@@ -1,6 +1,6 @@
-import { g as oe } from "./chunk-55IACEB6-Da2BRT6c.js";
-import { s as ae } from "./chunk-2J33WTMH-Dg3NXbVg.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-mE-t6fEG.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-4eLujZip.js.map
+//# sourceMappingURL=mindmap-definition-RKZ34NQL-DB-r9g1c.js.map

package/dist/component/{pieDiagram-4H26LBE5-Bv3aeU7h.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-mE-t6fEG.js";
-import { p as gt } from "./chunk-4BX2VUAB-BDtEKe-l.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-Dftg9hbM.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-Bv3aeU7h.js.map
+//# sourceMappingURL=pieDiagram-4H26LBE5-CMqPVjRg.js.map

package/dist/component/{quadrantDiagram-W4KKPZXB-BlpxPqAT.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-mE-t6fEG.js";
-import { l as te } from "./linear-DSEm-mVJ.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-BlpxPqAT.js.map
+//# sourceMappingURL=quadrantDiagram-W4KKPZXB-DWWi29dP.js.map

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

@@ -1,6 +1,6 @@
-import { g as Ge } from "./chunk-55IACEB6-Da2BRT6c.js";
-import { s as ze } from "./chunk-2J33WTMH-Dg3NXbVg.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-mE-t6fEG.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-DGG1FxFS.js.map
+//# sourceMappingURL=requirementDiagram-4Y6WPE33-D1nFFrnS.js.map

package/dist/component/{sankeyDiagram-5OEKKPKP-CQ-jfvW-.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-mE-t6fEG.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-CQ-jfvW-.js.map
+//# sourceMappingURL=sankeyDiagram-5OEKKPKP-BnfzKSOs.js.map

package/dist/component/{sequenceDiagram-3UESZ5HK-Ck-VbsGz.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-mE-t6fEG.js";
-import { a as pr, b as ee, g as dt, d as Er, e as re, f as ae } from "./chunk-ND2GUHAM-DbdImadK.js";
-import { I as ur } from "./chunk-QZHKN3VN-6IxJ3-HB.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-Ck-VbsGz.js.map
+//# sourceMappingURL=sequenceDiagram-3UESZ5HK-D3r-W-Vw.js.map

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

@@ -1,5 +1,5 @@
-import { s as R, a as W, S as N } from "./chunk-AQP2D5EJ-D8PxFJHV.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-mE-t6fEG.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-KlZdFGFQ.js.map
+//# sourceMappingURL=stateDiagram-AJRCARHV-Ba3bMrr0.js.map

package/dist/component/{stateDiagram-v2-BHNVJYJU-Djoz6HMn.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-D8PxFJHV.js";
-import { _ as l } from "./mermaid-GHXKKRXX-mE-t6fEG.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-Djoz6HMn.js.map
+//# sourceMappingURL=stateDiagram-v2-BHNVJYJU-YCAvqrHf.js.map

package/dist/component/{timeline-definition-PNZ67QCA-C3x7MWUx.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-mE-t6fEG.js";
-import { d as ot } from "./arc-Dftg9hbM.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-C3x7MWUx.js.map
+//# sourceMappingURL=timeline-definition-PNZ67QCA-DlxU8RFH.js.map

package/dist/component/{vennDiagram-CIIHVFJN-B4SXjWyu.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-mE-t6fEG.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-B4SXjWyu.js.map
+//# sourceMappingURL=vennDiagram-CIIHVFJN-teVIHl4-.js.map

package/dist/component/{wardleyDiagram-YWT4CUSO-B_0Q8QFc.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-mE-t6fEG.js";
-import { p as Bt } from "./chunk-4BX2VUAB-BDtEKe-l.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-B_0Q8QFc.js.map
+//# sourceMappingURL=wardleyDiagram-YWT4CUSO-B31MFPtu.js.map

package/dist/component/{xychartDiagram-2RQKCTM6-yIfLkIZO.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-mE-t6fEG.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-DSEm-mVJ.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-yIfLkIZO.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, 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, 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 {

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/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/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/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;

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

@@ -42,6 +42,10 @@ export declare const readPersistedTtsEnabled: () => boolean | null;
 export declare const setPersistedTtsEnabled: (enabled: boolean) => void;
 /** Drop the persisted speaker choice (back to the host default). Test-only. */
 export declare const clearPersistedTtsEnabled: () => void;
+export type VoiceClosedSendMode = "confirm" | "auto";
+export declare const subscribeVoiceClosedSendMode: (listener: () => void) => (() => void);
+export declare const peekVoiceClosedSendMode: () => VoiceClosedSendMode;
+export declare const setVoiceClosedSendMode: (mode: VoiceClosedSendMode) => void;
 /**
  * Human label for a `KeyboardEvent.code`: "ControlLeft" → "Left Ctrl",
  * "KeyA" → "A", "Digit7" → "7". Codes with no friendlier reading ("Space",

package/dist/embed/voice-send-intent.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Spoken send/cancel intent for the CLOSED-surface dictation flow (pure, no DOM).
+ *
+ * With the chat surface hidden, a dictated draft is held on the rail and a
+ * FOLLOW-UP push-to-talk utterance either sends it, discards it, or adds more
+ * words. Safety bias: a mis-fired "send" posts a turn the user can't see, so
+ * only an utterance that is EXACTLY a command word counts — anything richer is
+ * dictation (appended, always recoverable).
+ */
+export type VoiceSendIntent = "send" | "cancel" | "dictate";
+/** Classify a follow-up transcript while a closed-surface draft is pending. */
+export declare const interpretVoiceSendIntent: (transcript: string) => VoiceSendIntent;

package/dist/embed/workspace-scope.d.ts

@@ -0,0 +1,44 @@
+export declare const isWorkspaceExternalId: (value: string) => boolean;
+export type WorkspaceScope = {
+    readonly kind: "unconfigured";
+} | {
+    readonly kind: "scoped";
+    readonly id: string;
+} | {
+    readonly kind: "missing";
+};
+/** Poll cadence for URL-param tracking (the grant card's historical 2s). */
+export declare const WORKSPACE_SCOPE_POLL_MS = 2000;
+/** Resolve the scope LIVE (fresh URL read). See the header for precedence. */
+export declare const peekWorkspaceScope: () => WorkspaceScope;
+/**
+ * The scoped id, or null (unconfigured AND missing both read as null).
+ * CAUTION: because this collapses `missing`, it is only safe where the
+ * caller's surface is already disabled/blocked in the missing state (e.g.
+ * the stream-state pointer key). Request paths that WRITE must use
+ * `peekWorkspaceScope()` and refuse `missing` explicitly — never fall back
+ * to the shared legacy root.
+ */
+export declare const peekWorkspaceId: () => string | null;
+export declare const subscribeWorkspaceScope: (listener: () => void) => (() => void);
+/** `useSyncExternalStore` hook — the effective scope, re-rendering on change. */
+export declare const useWorkspaceScope: () => WorkspaceScope;
+/**
+ * Configure tracking from the embed config (`applyInitConfig` derives it from
+ * `agentGrant.scopeUrlParam` / `scopeExternalId`, so existing Simetrik embeds
+ * get workspace isolation with zero host changes). Re-applying the same
+ * config (re-`init`, React effect re-runs) is a no-op.
+ */
+export declare const configureWorkspaceScope: (input: {
+    readonly urlParam?: string | null;
+    readonly staticId?: string | null;
+}) => void;
+/**
+ * Imperative host switch (`belong.setWorkspace`) — wins over URL tracking
+ * until cleared with `null`, and notifies synchronously (no poll latency).
+ * An invalid id is rejected with a warning and leaves the scope unchanged —
+ * a host bug must never silently break the dock.
+ */
+export declare const setHostWorkspace: (id: string | null) => void;
+/** Test-only: reset config + override and re-seed the snapshot. Keeps listeners. */
+export declare const __resetWorkspaceScopeForTest: () => void;

package/dist/i18n/messages/en.d.ts

@@ -171,6 +171,8 @@ export declare const en: {
     readonly embed: {
         readonly yourSkills: "Your skills";
         readonly skillsMenuLabel: "Skills";
+        readonly minimizeSkills: "Minimize skills";
+        readonly expandSkills: "Expand skills";
         readonly workspaceFilesMenuLabel: "Workspace files";
         readonly previewFile: "Preview {{name}}";
         readonly downloadFile: "Download {{name}}";
@@ -342,6 +344,7 @@ export declare const en: {
         readonly backendUnavailable: "Can't reach the assistant service — check your connection.";
         readonly streamError: "Stream error — {{message}}";
         readonly streamErrorFallback: "please retry";
+        readonly workspaceUnavailable: "Waiting for a workspace — select one in the app to continue.";
     };
 };
 export type EnMessages = typeof en;

package/dist/i18n/messages/surfaces/embedMisc.d.ts

@@ -4,6 +4,8 @@ export declare const embedMiscEn: {
     readonly embed: {
         readonly yourSkills: "Your skills";
         readonly skillsMenuLabel: "Skills";
+        readonly minimizeSkills: "Minimize skills";
+        readonly expandSkills: "Expand skills";
         readonly workspaceFilesMenuLabel: "Workspace files";
         readonly previewFile: "Preview {{name}}";
         readonly downloadFile: "Download {{name}}";
@@ -51,6 +53,8 @@ export declare const embedMiscEs: {
     embed: {
         yourSkills: string;
         skillsMenuLabel: string;
+        minimizeSkills: string;
+        expandSkills: string;
         workspaceFilesMenuLabel: string;
         previewFile: string;
         downloadFile: string;

package/dist/stream/ai-sdk-part-renderers.d.ts

@@ -31,6 +31,13 @@ export type PartRendererProps = {
      * omits it while a run streams so the CTA can't double-submit).
      */
     readonly onExecutePlan?: (() => void) | undefined;
+    /**
+     * The part belongs to a restored-history message (`metadata.fromHistory`,
+     * stamped by `loadSessionHistory`). The dispatch renderers (navigation,
+     * ui_action, cli-reconnect) render settled and never re-fire their one-shot
+     * side effects. Absent/false = live part, dispatch as usual.
+     */
+    readonly historical?: boolean | undefined;
 };
 /**
  * The AI SDK's `UIMessagePart` union is open at the patch-version
@@ -39,7 +46,7 @@ export type PartRendererProps = {
  * `BelongDataParts` (above) plus the SDK's built-in `text` and
  * `reasoning` parts.
  */
-export declare const PartRenderer: ({ part, onExecutePlan }: PartRendererProps) => import("react").JSX.Element | null;
+export declare const PartRenderer: ({ part, onExecutePlan, historical }: PartRendererProps) => import("react").JSX.Element | null;
 /** One shell command paired with its (same-id) sandbox output, if any. */
 export type TerminalCommand = {
     readonly command: ToolCallData;