@belonguniverseai/react-sdk 0.6.21 → 0.6.23

package/dist/component/{stateDiagram-OKZ733FA-BXejMYGk.js → stateDiagram-OKZ733FA-CNNoDNwB.js}

@@ -1,5 +1,5 @@
-import { s as R, a as W, S as N } from "./chunk-5RXB4S5H-CYZ36tQD.js";
-import { _ as f, c as t, d as M, l as S, e as P, k as z, aa as _, ab as U, a6 as C, y as F } from "./mermaid-GHXKKRXX-DfdCmrs3.js";
+import { s as R, a as W, S as N } from "./chunk-5RXB4S5H-DYJwqjr4.js";
+import { _ as f, c as t, d as M, l as S, e as P, k as z, aa as _, ab as U, a6 as C, y as F } from "./mermaid-GHXKKRXX-B-ea5OKA.js";
 import { G as O } from "./graph-CWpEkm4G.js";
 import { l as J } from "./layout-Br2UjHRU.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-OKZ733FA-BXejMYGk.js.map
+//# sourceMappingURL=stateDiagram-OKZ733FA-CNNoDNwB.js.map

package/dist/component/{stateDiagram-v2-UEYNNEHI-BP05TJSl.js → stateDiagram-v2-UEYNNEHI-xYjW9R-s.js}

@@ -1,5 +1,5 @@
-import { s as e, b as r, a as s, S as t } from "./chunk-5RXB4S5H-CYZ36tQD.js";
-import { _ as l } from "./mermaid-GHXKKRXX-DfdCmrs3.js";
+import { s as e, b as r, a as s, S as t } from "./chunk-5RXB4S5H-DYJwqjr4.js";
+import { _ as l } from "./mermaid-GHXKKRXX-B-ea5OKA.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-UEYNNEHI-BP05TJSl.js.map
+//# sourceMappingURL=stateDiagram-v2-UEYNNEHI-xYjW9R-s.js.map

package/dist/component/{swimlanes-SLNWSIFB-CfmDVYhs.js → swimlanes-SLNWSIFB-Chjr6NCU.js}

@@ -1,5 +1,5 @@
-import { c as Tr } from "./chunk-RYQCIY6F-CuAngwHt.js";
-import { ap as Er, aq as wr, ar as Ar, as as Rr, l as Ke, c as Nr, aj as Or, ai as Pr, ak as Br, aw as kr, ay as Fr, z as _r, av as Dr, az as Hr, y as Oe, aA as Ye, _ as d, aB as Ao } from "./mermaid-GHXKKRXX-DfdCmrs3.js";
+import { c as Tr } from "./chunk-RYQCIY6F-BWL1otLK.js";
+import { ap as Er, aq as wr, ar as Ar, as as Rr, l as Ke, c as Nr, aj as Or, ai as Pr, ak as Br, aw as kr, ay as Fr, z as _r, av as Dr, az as Hr, y as Oe, aA as Ye, _ as d, aB as Ao } from "./mermaid-GHXKKRXX-B-ea5OKA.js";
 import { G as Xr } from "./graph-CWpEkm4G.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
@@ -24,7 +24,7 @@ async function Fo(t, e) {
   for (const I of o)
     n.setEdge(I.start, I.end, { ...I }, I.id), e.edges.some((p) => p.id === I.id) || e.edges.push(I);
   if (globalThis.mermaidCaptureSizes) {
-    const { captureNodeSizes: I } = await import("./sizeCapture-X5ZJPWSS-D9LGwwwC.js");
+    const { captureNodeSizes: I } = await import("./sizeCapture-X5ZJPWSS-DlIoKfk1.js");
     I(t, e);
   }
   return {
@@ -5332,4 +5332,4 @@ d(Zr, "render");
 export {
   Zr as render
 };
-//# sourceMappingURL=swimlanes-SLNWSIFB-CfmDVYhs.js.map
+//# sourceMappingURL=swimlanes-SLNWSIFB-Chjr6NCU.js.map

package/dist/component/{swimlanesDiagram-ULZ7WXOC-DfjQBUfV.js → swimlanesDiagram-ULZ7WXOC-A9mWwnCX.js}

@@ -1,5 +1,5 @@
-import { c as e, s as a } from "./flowDiagram-UKHOOZJN-BZfBucKB.js";
-import { _ as s } from "./mermaid-GHXKKRXX-DfdCmrs3.js";
+import { c as e, s as a } from "./flowDiagram-UKHOOZJN-Cf42sXVK.js";
+import { _ as s } from "./mermaid-GHXKKRXX-B-ea5OKA.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
 var t = /* @__PURE__ */ s((l) => `${a(l)}
@@ -13,4 +13,4 @@ var t = /* @__PURE__ */ s((l) => `${a(l)}
 export {
   g as diagram
 };
-//# sourceMappingURL=swimlanesDiagram-ULZ7WXOC-DfjQBUfV.js.map
+//# sourceMappingURL=swimlanesDiagram-ULZ7WXOC-A9mWwnCX.js.map

package/dist/component/{timeline-definition-Z64GVDOM-C0BwzTs3.js → timeline-definition-Z64GVDOM-DldyCd1l.js}

@@ -1,5 +1,5 @@
-import { _ as o, z as gt, ad as Rt, ae as Ct, af as Wt, c as pt, l as E, G as Pt, a4 as Bt, ag as ft, d as U, u as Vt, ah as Ft, q as zt } from "./mermaid-GHXKKRXX-DfdCmrs3.js";
-import { d as ot } from "./arc-B4biduil.js";
+import { _ as o, z as gt, ad as Rt, ae as Ct, af as Wt, c as pt, l as E, G as Pt, a4 as Bt, ag as ft, d as U, u as Vt, ah as Ft, q as zt } from "./mermaid-GHXKKRXX-B-ea5OKA.js";
+import { d as ot } from "./arc-DaSgre52.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-Z64GVDOM-C0BwzTs3.js.map
+//# sourceMappingURL=timeline-definition-Z64GVDOM-DldyCd1l.js.map

package/dist/component/{vennDiagram-T6HMQDX7-CRf8sGBL.js → vennDiagram-T6HMQDX7-BGfiPWG2.js}

@@ -1,4 +1,4 @@
-import { b7 as Wt, s as Kt, g as Ht, p as Yt, o as Xt, a as Zt, b as Jt, _ as w, z as wt, G as Qt, d as ot, ao as $t, ad as te, ae as ee, af as ne, e as se, q as ie, D as oe, E as re } from "./mermaid-GHXKKRXX-DfdCmrs3.js";
+import { b7 as Wt, s as Kt, g as Ht, p as Yt, o as Xt, a as Zt, b as Jt, _ as w, z as wt, G as Qt, d as ot, ao as $t, ad as te, ae as ee, af as ne, e as se, q as ie, D as oe, E as re } from "./mermaid-GHXKKRXX-B-ea5OKA.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
 const kt = (t, n) => Wt(t, "a", -n), _t = 1e-10;
@@ -1578,4 +1578,4 @@ var Ue = { draw: qe }, We = {
 export {
   We as diagram
 };
-//# sourceMappingURL=vennDiagram-T6HMQDX7-CRf8sGBL.js.map
+//# sourceMappingURL=vennDiagram-T6HMQDX7-BGfiPWG2.js.map

package/dist/component/{wardleyDiagram-T6FBY63Y-C2h7TQ4a.js → wardleyDiagram-T6FBY63Y-Bzn9DJ27.js}

@@ -1,5 +1,5 @@
-import { p as St } from "./chunk-JWPE2WC7-ClHq4gN2.js";
-import { s as Mt, g as Nt, p as Tt, o as zt, a as Lt, b as At, _ as u, Z as Xt, z as Et, D as U, l as K, G as Yt, e as It, q as Bt, c as j } from "./mermaid-GHXKKRXX-DfdCmrs3.js";
+import { p as St } from "./chunk-JWPE2WC7-DAn-TcDC.js";
+import { s as Mt, g as Nt, p as Tt, o as zt, a as Lt, b as At, _ as u, Z as Xt, z as Et, D as U, l as K, G as Yt, e as It, q as Bt, c as j } from "./mermaid-GHXKKRXX-B-ea5OKA.js";
 import { p as Ft } from "./cynefin-VYW2F7L2-DAyxamLw.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
@@ -678,4 +678,4 @@ var Dt = {
 export {
   Qt as diagram
 };
-//# sourceMappingURL=wardleyDiagram-T6FBY63Y-C2h7TQ4a.js.map
+//# sourceMappingURL=wardleyDiagram-T6FBY63Y-Bzn9DJ27.js.map

package/dist/component/{xychartDiagram-ELKLHX3M-CBcAwmdF.js → xychartDiagram-ELKLHX3M-nMaNgT12.js}

@@ -1,7 +1,7 @@
-import { s as si, g as ai, p as Et, o as ni, a as oi, b as ri, _ as n, l as It, G as hi, e as li, q as ci, z as pt, i as ui, D as Mt, E as gi, Z as xi, aC as di, aa as Dt } from "./mermaid-GHXKKRXX-DfdCmrs3.js";
+import { s as si, g as ai, p as Et, o as ni, a as oi, b as ri, _ as n, l as It, G as hi, e as li, q as ci, z as pt, i as ui, D as Mt, E as gi, Z as xi, aC as di, aa as Dt } from "./mermaid-GHXKKRXX-B-ea5OKA.js";
 import { i as fi } from "./init-BOu0eQYQ.js";
 import { o as pi } from "./ordinal-D0x7izaa.js";
-import { l as vt } from "./linear-DYjDg3gl.js";
+import { l as vt } from "./linear-CzN3Xd3g.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
 function mi(t, i, e) {
@@ -1418,4 +1418,4 @@ var Ti = /* @__PURE__ */ n(function() {
 export {
   zi as diagram
 };
-//# sourceMappingURL=xychartDiagram-ELKLHX3M-CBcAwmdF.js.map
+//# sourceMappingURL=xychartDiagram-ELKLHX3M-nMaNgT12.js.map

package/dist/components/ai-elements/message.d.ts

@@ -6,7 +6,7 @@ import { Streamdown, ControlsConfig } from 'streamdown';
 export type MessageProps = HTMLAttributes<HTMLDivElement> & {
     from: UIMessage["role"];
 };
-export declare const Message: ({ className, from, ...props }: MessageProps) => import("react").JSX.Element;
+export declare const Message: ({ className, from, children, ...props }: MessageProps) => import("react").JSX.Element;
 export type MessageContentProps = HTMLAttributes<HTMLDivElement>;
 export declare const MessageContent: ({ children, className, ...props }: MessageContentProps) => import("react").JSX.Element;
 export type MessageActionsProps = ComponentProps<"div">;
@@ -15,7 +15,7 @@ export type MessageActionProps = ComponentProps<typeof Button> & {
     tooltip?: string;
     label?: string;
 };
-export declare const MessageAction: ({ tooltip, children, label, variant, size, ...props }: MessageActionProps) => import("react").JSX.Element;
+export declare const MessageAction: ({ tooltip, children, label, className, variant, size, ...props }: MessageActionProps) => import("react").JSX.Element;
 export type MessageBranchProps = HTMLAttributes<HTMLDivElement> & {
     defaultBranch?: number;
     onBranchChange?: (branchIndex: number) => void;

package/dist/components/ai-elements/prompt-input.d.ts

@@ -71,6 +71,8 @@ export interface PromptInputMessage {
     files: FileUIPart[];
 }
 export type PromptInputProps = Omit<HTMLAttributes<HTMLFormElement>, "onSubmit" | "onError"> & {
+    /** A context/usage row that shares the validated attachment provider. */
+    beforeInput?: ReactNode;
     accept?: string;
     multiple?: boolean;
     globalDrop?: boolean;
@@ -83,7 +85,7 @@ export type PromptInputProps = Omit<HTMLAttributes<HTMLFormElement>, "onSubmit"
     }) => void;
     onSubmit: (message: PromptInputMessage, event: SyntheticEvent<HTMLFormElement>) => void | Promise<void>;
 };
-export declare const PromptInput: ({ className, accept, multiple, globalDrop, syncHiddenInput, maxFiles, maxFileSize, onError, onSubmit, children, ...props }: PromptInputProps) => import("react").JSX.Element;
+export declare const PromptInput: ({ className, accept, multiple, globalDrop, syncHiddenInput, maxFiles, maxFileSize, onError, onSubmit, children, beforeInput, ...props }: PromptInputProps) => import("react").JSX.Element;
 export type PromptInputBodyProps = HTMLAttributes<HTMLDivElement>;
 export declare const PromptInputBody: ({ className, ...props }: PromptInputBodyProps) => import("react").JSX.Element;
 export type PromptInputTextareaProps = ComponentProps<typeof InputGroupTextarea>;

package/dist/components/ai-elements/task.d.ts

@@ -8,7 +8,8 @@ export type TaskProps = ComponentProps<typeof Collapsible>;
 export declare const Task: ({ defaultOpen, className, ...props }: TaskProps) => import("react").JSX.Element;
 export type TaskTriggerProps = Omit<ComponentProps<typeof CollapsibleTrigger>, "title"> & {
     title: ReactNode;
+    icon?: ReactNode;
 };
-export declare const TaskTrigger: ({ children, className, title, ...props }: TaskTriggerProps) => import("react").JSX.Element;
+export declare const TaskTrigger: ({ children, className, title, icon, ...props }: TaskTriggerProps) => import("react").JSX.Element;
 export type TaskContentProps = ComponentProps<typeof CollapsibleContent>;
 export declare const TaskContent: ({ children, className, ...props }: TaskContentProps) => import("react").JSX.Element;

package/dist/components/ai-elements/terminal-task.d.ts

@@ -1,5 +1,6 @@
 import { SandboxCommandData, ToolCallData } from '../../stream/belong-data-parts.ts';
-export declare const TerminalTask: ({ command, output, }: {
+export declare const TerminalTask: ({ command, output, live, }: {
     readonly command: ToolCallData;
     readonly output: SandboxCommandData | null;
+    readonly live?: boolean;
 }) => import("react").JSX.Element;

package/dist/components/connectors/portal-theme.d.ts

@@ -1,8 +1,2 @@
-import { CSSProperties } from 'react';
-export type PortalTheme = {
-    /** Spread onto the portaled content element. */
-    readonly style: CSSProperties;
-    /** `"dark"` when the dock is dark, so Tailwind's `.dark` variants apply. */
-    readonly className: string | undefined;
-};
-export declare const usePortalTheme: () => PortalTheme;
+/** Compatibility export for connector surfaces; all shared overlays now use it. */
+export { usePortalTheme, type PortalTheme } from '../../embed/portal-container.tsx';

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

@@ -3,7 +3,7 @@
  * 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
+ * disc mirrors the working badge's idiom (a small rounded disc on
  * `bg-background`, EmbedRail's `lineBadge`) so the two corners speak the same
  * visual language: status top-right, identity bottom-right.
  *

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

@@ -1,17 +1,19 @@
+import { LucideIcon } from 'lucide-react';
 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;
+export type AgentWorkPhase = WorkPhase | "thinking" | "terminal" | "skill" | null;
+/** Presentation only: real activity may continue while its decoration rests.
+ * One observer per symbol also covers scroll containers and Shadow DOM. */
+export declare function useActivityMotion(active: boolean): {
+    ref: import('react').RefObject<HTMLSpanElement | null>;
+    moving: boolean;
+};
+/** The actual MIT Thinking Orbs inline preset for thinking/working; Lucide
+ * task symbols retain their familiar silhouette while their inner marks move.
+ * Only callers with current runtime evidence enable activity. */
+export declare function AgentPhaseIcon({ phase, className, active, icon, theme, }: {
+    readonly phase: AgentWorkPhase;
     readonly className?: string;
+    readonly active?: boolean;
+    readonly icon?: LucideIcon;
+    readonly theme?: "light" | "dark";
 }): import("react").JSX.Element;

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

@@ -0,0 +1 @@
+export declare const ApiKeysSettings: () => import("react").JSX.Element;

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

@@ -1,12 +1,10 @@
-/**
- * The dock-header beta advisory: a small always-visible "Beta" pill next to
- * the header title. Clicking it opens the info widget — "«brand» is in beta",
- * the instability + report-with-👍/👎 explanation, and the U.S.-hosted-services
- * line separated as its own row. A Popover (portaled into the shadow-root
- * container) with collision handling, so the widget stays inside the viewport
- * at any dock width; the pill itself is shrink-0 so the truncating title can
- * never squeeze it out.
- */
-export declare function BetaBadge({ brandName }: {
+/** Shared beta information. The composer uses the compact footer disclosure;
+ * the older badge/menu presentations remain available to existing consumers.
+ * Overlays inherit the agent's tenant tokens and Shadow DOM portal container.
+ * `legalLine` is a tenant's own legal caveat (Simetrik's), shown first in the
+ * information behind the icon. */
+export declare function BetaBadge({ brandName, presentation, legalLine, }: {
     brandName: string;
+    presentation?: "badge" | "menu" | "label" | "footer";
+    legalLine?: string | null;
 }): import("react").JSX.Element;

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

@@ -0,0 +1,9 @@
+import { FileUIPart } from 'ai';
+/** Current host page and real pending files, separate from past token telemetry. */
+export declare function ComposerContext({ files, onAttach, onRemove, }: {
+    readonly files: readonly (FileUIPart & {
+        readonly id: string;
+    })[];
+    readonly onAttach: () => void;
+    readonly onRemove: (id: string) => void;
+}): import("react").JSX.Element | null;

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

@@ -1,30 +1,31 @@
 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
- * controls (Dark mode + Move to left/right — kept here because this dock has a
- * multi-brand theme store), a Voice group (push-to-talk key rebinding, shown
- * only when the browser supports mic capture), an Appearance group (accent
- * colour + custom CSS), then Log out. Gradient is brand-driven (Ocean → Deep
- * Sea) via the active palette.
- */
-export declare function EmbedAvatar({ user, size, theme, palette, side, menuSide: menuSideOverride, sessionId, voiceSupported, sessions, accent, cssVars, presets, activePreset, onToggleMode, onToggleSide, onAccentChange, onAccentReset, onCssVarsChange, onApplyPreset, onLogout, onNewSession, onSelectSession, onDeleteSession, onRenameSession, onSessionsOpen, onViewStats, sessionAgentLine, }: {
+/** Profile access opens one settings surface; preferences never change the active conversation. */
+export declare function EmbedAvatar({ user, size, showBrandMark, presentation, readReplies, theme, palette, side, sessionId, voiceSupported, sessions, accent, cssVars, presets, activePreset, onToggleMode, onToggleSide, onAccentChange, onAccentReset, onCssVarsChange, onApplyPreset, onLogout, onNewSession, onSelectSession, onDeleteSession, onRenameSession, onSessionsOpen, onViewStats, sessionAgentLine, }: {
     user: string | null;
     size?: number;
+    /** Keep the agent identity visible while the dock is collapsed. */
+    showBrandMark?: boolean;
+    /** Fullscreen sidebar footer keeps the account and its settings discoverable. */
+    presentation?: "icon" | "account-row";
+    /** Reply playback is independent of microphone capture support. */
+    readReplies?: {
+        readonly supported: boolean;
+        readonly enabled: boolean;
+        readonly onToggle: () => void;
+    };
     theme: BelongTheme;
     palette: BelongThemePalette;
     side: "left" | "right";
-    /** Where the menu opens. Defaults to "toward the panel" from the rail edge;
-     *  the mobile bottom nav bar overrides it to open upward. */
+    /** Retained for source compatibility; settings now use a fullscreen dialog. */
     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;
-     *  also the History submenu's active-row indicator (Rail-D). */
+     *  About and copyable for telemetry correlation;
+     *  also the History section'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). */
+    /** Recent sessions shared by settings History and the direct rail launcher. */
     sessions: readonly SessionSummary[];
     accent: string | null;
     cssVars: Record<string, string>;
@@ -44,14 +45,14 @@ export declare function EmbedAvatar({ user, size, theme, palette, side, menuSide
     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
+    /** Fired when the History section opens — the dock refetches the list so
      *  it's fresh (mirrors EmbedSessions' own `onOpen`). */
     onSessionsOpen?: () => void;
     /** Open the per-session stats dialog (plan 2026-07-24). Optional so the
-     *  avatar menu still renders without the dock's panel host wired up. */
+     *  settings dialog still renders without the dock's panel host wired up. */
     onViewStats?: (sessionId: string) => void;
     /** sessionId -> the agent line currently bound to it (F3) — threaded
-     *  straight through to the History submenu's `EmbedSessionsBody` so an
+     *  straight through to the History section's `EmbedSessionsBody` so an
      *  already-open row wears its "Agent N" badge. */
     sessionAgentLine?: ReadonlyMap<string, number>;
 }): import("react").JSX.Element;

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

@@ -5,8 +5,13 @@ import { SkillSummary } from '../../api/skills.ts';
 import { PrePromptSummary } from '../../api/pre-prompts.ts';
 import { WorkspaceFile } from '../../api/workspace-files.ts';
 import { UsageMeterProps } from './UsageMeter.tsx';
-export declare function EmbedComposer({ draft, suggestion, status, submitting, disabled, voiceSupported, voiceConfigured, listening, theme, palette, skills, prompts, workspaceFiles, mode, onModeChange, onDraftChange, onMentionOpen, onSaveAsPrompt, onSubmit, onStop, usage, pendingQuestion, }: Readonly<{
+export declare function EmbedComposer({ draft, placeholder, suggestion, status, submitting, disabled, voiceSupported, voiceConfigured, listening, theme, palette, skills, librarySkills, prompts, workspaceFiles, mode, onModeChange, onDraftChange, onMentionOpen, onSaveAsPrompt, onSubmit, onStop, usage, pendingQuestion, onSetGoal, }: Readonly<{
     draft: string;
+    /** Overrides the composer's own invitation while a surface above it is
+     *  asking for something specific (the goal row's "Tell it what to try"
+     *  hands the composer over with its own words). Null — the default — keeps
+     *  the ordinary mode-aware copy. */
+    placeholder?: string | null;
     /** BEL-255 — ghost text painted over an EMPTY draft (the locale opening
      *  question on a brand-new chat). Tab completes it into the draft; typing
      *  anything else just replaces it. Never submittable by itself: the draft
@@ -23,6 +28,8 @@ export declare function EmbedComposer({ draft, suggestion, status, submitting, d
     theme: BelongTheme;
     palette: BelongThemePalette;
     skills: readonly SkillSummary[];
+    /** Enabled skills only; the slash picker also contains workspace commands. */
+    librarySkills?: readonly SkillSummary[];
     /** The user's saved prompts (BEL-256) — merged into the `/` menu here, so a
      *  prompt cannot leak into a consumer that expects runnable skills (the voice
      *  `invoke_skill` resolver dispatches `/name` as RAW text, which the runtime
@@ -53,4 +60,9 @@ export declare function EmbedComposer({ draft, suggestion, status, submitting, d
      *  reply answers the question in chat) instead of stopping the run. An
      *  empty draft keeps the button as Stop. */
     pendingQuestion?: boolean;
+    /** Task 16 — opens the goal compose sheet ("Set a goal…", the mode menu's
+     *  fifth entry). Omitted → the entry is not offered at all, which is what
+     *  keeps every provider-less composer test/story rendering and is how
+     *  `chat.tsx` gates the door once a `goals_disabled` 503 has been seen. */
+    onSetGoal?: (() => void) | undefined;
 }>): import("react").JSX.Element;

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

@@ -1,41 +1,24 @@
+import { ReactNode } from 'react';
+import { GoalBadgeProps } from './GoalBadge.tsx';
 import { BelongThemeBrand, BelongThemePalette } from '../../types/public.ts';
-/**
- * Slim brand bar at the top of the chat: the mark + the brand/view title, and
- * a small second line under it — the name of the conversation on screen when
- * the dock passes one (`subtitle`, chat view), otherwise the "by Belong"
- * tagline when a tenant brand is active. Knowing WHICH chat is open beats the
- * co-branding line on the one surface where both compete for the same slot.
- * Action controls live in the rail (EmbedRail), not here — with TWO
- * exceptions:
- *   • `onExportChat` — download the current conversation as JSON. Stateful:
- *     while the backend generates the export the button shows a spinner and
- *     is disabled; the label (aria + hover title) carries the timestamp of
- *     the session's last export when one exists.
- *   • `onCloseChat` — the in-surface way to close the CURRENT agent chat.
- *     The dock passes it only while the chat view is up AND more than one
- *     agent chat exists (closing the only conversation is meaningless — there
- *     is nothing to fall back to), so the single-chat header stays exactly as
- *     it always was.
- */
-export declare function EmbedHeader({ title, subtitle, palette, brand, onExportChat, exportState, exportChatLabel, onCloseChat, closeChatLabel, }: {
+/** Conversation title on desktop; mobile keeps the agent's direct logo control. */
+export declare function EmbedHeader({ title, subtitle, palette, brand, onExportChat, exportState, exportChatLabel, onCloseChat, closeChatLabel, onMinimize, onToggleFullscreen, fullscreen, layoutControl, goal, }: {
     title: string;
-    /** Second header line — the current chat's name (chat view). Takes the slot
-     *  the "by Belong" tagline occupies when absent. */
     subtitle?: string;
     palette: BelongThemePalette;
     brand: BelongThemeBrand;
-    /** Request a chat export (rendered only when provided — chat view with a
-     *  server-bound session). Disabled while `exportState` is "generating". */
     onExportChat?: () => void;
     exportState?: "idle" | "generating";
-    /** Accessible name + hover title for the export control. Carries the last
-     *  export timestamp when the session has one. Required with `onExportChat`. */
     exportChatLabel?: string;
-    /** Close the current agent chat (release its line, fall back to the next
-     *  agent). Rendered only when provided — see the component doc for the
-     *  dock's gating rule. */
     onCloseChat?: () => void;
-    /** Accessible name for the close control (carries the agent's identity,
-     *  e.g. "Close Agent 2 — invoices"). Required alongside `onCloseChat`. */
     closeChatLabel?: string;
+    onMinimize?: () => void;
+    onToggleFullscreen?: () => void;
+    fullscreen?: boolean;
+    layoutControl?: ReactNode;
+    /** Goal Mode status pill — rendered only while the dock
+     *  has a live, non-cleared goal for the on-screen session. Since spec §4 it
+     *  is a DOOR: it says the status and opens the Goal rail view. Same place,
+     *  same tone rules, no panel of its own. */
+    goal?: GoalBadgeProps;
 }): import("react").JSX.Element;

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

@@ -1,3 +1,4 @@
+import { ReactNode } from 'react';
 import { VoiceActionFlash } from '../../embed/closed-surface-voice-bus.ts';
 import { VoiceStatus } from '../../embed/voice-bus.ts';
 import { SessionSummary } from './EmbedSessions';
@@ -7,15 +8,14 @@ import { BelongTheme, BelongThemePalette, PresetName } from '../../types/public.
  *  two must carry the SAME members: this one is what the chrome renders, that
  *  one is what the router and localStorage persist, and a view present in only
  *  one of them is a view you can reach but not come back to after a reload. */
-export type EmbedView = "chat" | "files" | "scheduled" | "prompts" | "connectors";
+export type EmbedView = "chat" | "goal" | "files" | "scheduled" | "prompts" | "connectors" | "skills";
 /**
- * 52px rail. Top: user avatar (account + theme controls). Middle: Chat /
- * Files nav (active = Ocean primary fill, brand-driven). Bottom
- * (when expanded): the chat action cluster — Chats (sessions), TTS speaker,
- * expand-to-modal — then the collapse toggle. Active fill + brand colours come
- * from `palette` so a host brand push re-themes everything.
+ * Compact 52px rail, expanding into a labeled 208px sidebar on request.
+ * History and workspace navigation share one hierarchy in both dock states.
+ * Focus hides labels only; every destination remains available as an icon.
+ * Active fill and brand colors come from the tenant palette.
  */
-export declare function EmbedRail({ view, collapsed, user, theme, palette, sessions, activeId, planProgress, speakEnabled, ttsSupported, voiceSupported, voiceStatus, pendingVoiceDraft, voiceActionFlash, accent, cssVars, presets, activePreset, onSelectView, onToggleCollapse, onToggleMode, onToggleSide, onAccentChange, onAccentReset, onCssVarsChange, onApplyPreset, onLogout, onNewSession, onSelectSession, onSelectAgentLine, onCloseAgentLine, onDeleteSession, onRenameSession, onSessionsOpen, onViewStats, onToggleSpeak, fullscreen, onToggleFullscreen, connectorsUnavailable, }: {
+export declare function EmbedRail({ view, collapsed, user, theme, palette, sessions, activeId, planProgress, speakEnabled, ttsSupported, voiceSupported, voiceStatus, pendingVoiceDraft, voiceActionFlash, accent, cssVars, presets, activePreset, onSelectView, onToggleMode, onToggleSide, onAccentChange, onAccentReset, onCssVarsChange, onApplyPreset, onLogout, onNewSession, onSelectSession, onSelectAgentLine, onCloseAgentLine, onDeleteSession, onRenameSession, onSessionsOpen, onViewStats, onToggleSpeak, fullscreen, navigationLabelsVisible, onToggleNavigationLabels, layoutControl, connectorsUnavailable, skillsUnavailable, goalPresent, goalNeedsYou, }: {
     view: EmbedView;
     collapsed: boolean;
     user: string | null;
@@ -51,8 +51,16 @@ export declare function EmbedRail({ view, collapsed, user, theme, palette, sessi
         label: string;
     }[];
     activePreset: PresetName;
+    /** Whether this session has a goal that is not cleared — the Goal chip
+     *  exists only then, so a user who never runs a goal never sees a dead tab. */
+    goalPresent: boolean;
+    /** The on-screen session's goal is in one of the five statuses that owe the
+     *  reader something (`goalRowModel`'s "attention" tone — Task 7). Paints an
+     *  amber dot on BOTH the Chat and Goal chips while the dock is collapsed, so
+     *  the ask is visible without opening the panel; never the only signal —
+     *  each chip's accessible label names the ask too. */
+    goalNeedsYou: boolean;
     onSelectView: (v: EmbedView) => void;
-    onToggleCollapse: () => void;
     onToggleMode: () => void;
     onToggleSide: () => void;
     onAccentChange: (c: string) => void;
@@ -85,9 +93,13 @@ export declare function EmbedRail({ view, collapsed, user, theme, palette, sessi
      *  rail still renders without the dock's panel host wired up. */
     onViewStats?: (sessionId: string) => void;
     onToggleSpeak: () => void;
-    /** The dock is fullscreen right now — the toggle reads "Exit fullscreen". */
+    /** Actual fullscreen layout; its rail stays on the physical left edge. */
     fullscreen: boolean;
-    onToggleFullscreen: () => void;
+    /** Presentation only: Focus hides labels without changing layout or navigation. */
+    navigationLabelsVisible?: boolean;
+    onToggleNavigationLabels?: () => void;
+    /** The logo controls dock visibility or fullscreen labels, owned by the shell. */
+    layoutControl?: ReactNode;
     /**
      * This deployment answered "the connectors feature is off here" — the rail
      * then hides the Connectors entry entirely, because a surface that can only
@@ -100,4 +112,11 @@ export declare function EmbedRail({ view, collapsed, user, theme, palette, sessi
      * ordinary outage keeps the entry, and the surface shows its retry state.
      */
     connectorsUnavailable?: boolean;
+    /**
+     * This deployment answered "the skill library is off here" (404, or a 503
+     * whose body is `skill_library_disabled`). Same optimistic semantics as
+     * `connectorsUnavailable`: FALSE until that answer has resolved, so the
+     * entry never pops in late and an outage never hides it.
+     */
+    skillsUnavailable?: boolean;
 }): import("react").JSX.Element;

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

@@ -24,23 +24,18 @@ type SessionsBodyProps = {
      *  list without the dock's panel host still renders. */
     onViewStats?: (sessionId: string) => void;
 };
-/**
- * The "New chat" item + recent-sessions list, WITHOUT a menu shell of its own —
- * the reusable half of the sessions switcher. `EmbedSessions` below wraps this
- * in its own `DropdownMenu`/`DropdownMenuContent` for the rail/mobile trigger;
- * `EmbedAvatar`'s History submenu wraps the SAME body in a
- * `DropdownMenuSub`/`DropdownMenuSubContent` instead (Rail-D) — one
- * implementation of rename/delete/select, two menu shells. Radix unmounts a
- * closed Content/SubContent by default, so this component's local edit/confirm
- * state resets for free on every close — no explicit reset needed here.
- */
-export declare function EmbedSessionsBody({ sessions, activeId, onNew, onSelect, onDelete, onRename, sessionAgentLine, onViewStats, }: SessionsBodyProps): import("react").JSX.Element;
+/** Shared history behavior for the compact menu and fullscreen settings.
+ * Panel rows use native buttons with sibling edit actions, so history does
+ * not depend on a Radix menu context or nest interactive controls. */
+export declare function EmbedSessionsBody({ sessions, activeId, onNew, onSelect, onDelete, onRename, sessionAgentLine, onViewStats, presentation, }: SessionsBodyProps & {
+    presentation?: "menu" | "panel";
+}): 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, sessionAgentLine, onViewStats, }: SessionsBodyProps & {
+export declare function EmbedSessions({ sessions, activeId, theme, side, triggerClassName, triggerLabel, presentation, onNew, onSelect, onDelete, onRename, onOpen, sessionAgentLine, onViewStats, }: SessionsBodyProps & {
     theme: BelongTheme;
     /** Which way the menu opens — toward the panel from the rail edge, or
      *  upward when the trigger lives in the mobile bottom nav bar. */
@@ -51,6 +46,9 @@ 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;
+    /** Labeled navigation row for the expanded sidebar; icon preserves the
+     * compact launcher and optional mobile triggerLabel. */
+    presentation?: "icon" | "labeled";
     /** Fired when the menu opens — the dock refetches the list so it's fresh. */
     onOpen?: () => void;
 }): import("react").JSX.Element;

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

@@ -0,0 +1,15 @@
+import { GoalActionOutcome, GoalView } from '../../api/goals.ts';
+export type GoalActionKind = "pause" | "resume" | "clear";
+export type GoalActionsProps = {
+    readonly goal: GoalView;
+    /** Each returns the API outcome; the footer renders its OWN failure line —
+     *  the caller never has to. */
+    readonly onAction: (action: GoalActionKind) => Promise<GoalActionOutcome>;
+    readonly onEdit?: (() => void) | undefined;
+    /** Task 19 — the footer's Snooze ▾ menu. Rendered beside Pause exactly
+     *  where `goalActionAvailability(goal.status).snooze` says the server
+     *  accepts it (active + the three waiting statuses); undefined for any
+     *  composer that has not wired snooze up yet (Storybook, older callers). */
+    readonly onSnooze?: ((wakeAt: Date) => Promise<GoalActionOutcome>) | undefined;
+};
+export declare function GoalActions({ goal, onAction, onEdit, onSnooze }: GoalActionsProps): import("react").JSX.Element;

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

@@ -0,0 +1,17 @@
+import { GoalView } from '../../api/goals.ts';
+export type GoalBadgeProps = {
+    readonly goal: GoalView;
+    /** Selects the Goal rail view. The pill is a door now, not a panel
+     *  (spec §4 — the popover is deleted). */
+    readonly onOpenGoalView: () => void;
+};
+/**
+ * The header pill (advisory placement per `a3s-dock-advisory-placement`):
+ * a shrink-0 status pill next to `BetaBadge` that says what the goal is doing
+ * and OPENS THE GOAL VIEW. It used to carry the whole goal behind a popover;
+ * that panel is deleted (spec §4) — a surface that must hold a ten-entry
+ * timeline and a row of buttons is not a popover, and the buttons were what
+ * got squeezed off screen. Renders nothing for a `cleared` goal so a previous
+ * chat's pill never lingers.
+ */
+export declare function GoalBadge({ goal, onOpenGoalView }: GoalBadgeProps): import("react").JSX.Element | null;

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

@@ -0,0 +1,6 @@
+export type GoalClearDialogProps = {
+    readonly open: boolean;
+    readonly onOpenChange: (open: boolean) => void;
+    readonly onConfirm: () => void;
+};
+export declare function GoalClearDialog({ open, onOpenChange, onConfirm }: GoalClearDialogProps): import("react").JSX.Element;

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

@@ -0,0 +1,3 @@
+export declare function GoalClearedLine({ clearedAt }: {
+    readonly clearedAt: string;
+}): import("react").JSX.Element;