@belonguniverseai/react-sdk 0.6.18 → 0.6.20

package/dist/embed/page-context.d.ts

@@ -0,0 +1,11 @@
+/** Resolve the label LIVE (fresh title read). See the header for precedence. */
+export declare const peekPageContextLabel: () => string | null;
+export declare const subscribePageContext: (listener: () => void) => (() => void);
+/** `useSyncExternalStore` hook — the effective label, re-rendering on change. */
+export declare const usePageContextLabel: () => string | null;
+/** Seed from the embed config (`applyInitConfig`); replaces the whole config. */
+export declare const configurePageContext: (input: unknown) => void;
+/** Imperative host switch (`belong.setPageContext`); `null` drops the override. */
+export declare const setHostPageContext: (label: unknown) => void;
+/** Test-only: reset config + override, disconnect the observer, re-seed. */
+export declare const __resetPageContextForTest: () => void;

package/dist/embed/show-target.d.ts

@@ -0,0 +1,6 @@
+import { WorkspaceFocusTarget } from '../stream/workspace-focus-store.ts';
+type ShowTargetSource = "user" | "agent-auto";
+export declare const showTarget: (target: WorkspaceFocusTarget, options?: {
+    readonly source?: ShowTargetSource;
+}) => void;
+export {};

package/dist/embed/slash-commands.d.ts

@@ -78,6 +78,13 @@ export type SlashTokenMatch = {
     readonly start: number;
     readonly end: number;
 };
+/**
+ * Can a `/` at this position open the menu? Only at the start of the draft or
+ * after whitespace — the rule {@link slashTokenMatch} enforces. Exported so the
+ * composer's `/` button can splice a slash in that the matcher will actually
+ * recognise, instead of re-deriving the same predicate and drifting from it.
+ */
+export declare const isSlashBoundary: (ch: string | undefined) => boolean;
 /**
  * Detect a `/command` being typed at `caret` within `text` — ANYWHERE in the
  * draft, not just at the start (mirrors {@link atMentionMatch}). The `/` must

package/dist/embed/user-context.d.ts

@@ -0,0 +1,14 @@
+export type UserContext = {
+    readonly displayName: string | null;
+};
+/** Seed from the embed config (`applyInitConfig`); re-`init` replaces it. */
+export declare const configureUserContext: (input: unknown) => void;
+/** Imperative host switch (`belong.setUser`) — see the header for the two clears. */
+export declare const setHostUser: (user: unknown) => void;
+/** The effective user context (stable reference until it changes). */
+export declare const peekUserContext: () => UserContext;
+export declare const subscribeUserContext: (listener: () => void) => (() => void);
+/** `useSyncExternalStore` hook — re-renders on a host name change. */
+export declare const useUserContext: () => UserContext;
+/** Test-only: drop the init value, the override, and every listener. */
+export declare const __resetUserContextForTest: () => void;

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

@@ -278,12 +278,13 @@ export declare const deliverAgentFailure: (message: string) => void;
  * this section's header. */
 export declare const deliverLineReply: (line: number) => void;
 /**
- * A background line published an artifact: OPEN it on screen, mirroring
- * chat.tsx's foreground auto-open effect exactly — ALWAYS docked (a persisted
- * fullscreen pref would swallow the whole app), the same closable/resizable
- * panel a click on the artifact card gives. Deduped per artifactId (replays /
- * reconnects re-emit the part). NO spoken response: the line's finish reply
- * already narrates the result; a second voice line would double-speak.
+ * A background line published an artifact: OPEN it on screen via `showTarget`
+ * (agent-auto), mirroring chat.tsx's foreground auto-open effect exactly —
+ * docked (never the swallow-the-whole-app fullscreen preview) outside the
+ * fullscreen workspace pane, a no-op inside it (the focus observer owns agent
+ * focus there). Deduped per artifactId (replays / reconnects re-emit the
+ * part). NO spoken response: the line's finish reply already narrates the
+ * result; a second voice line would double-speak.
  */
 export declare const deliverLineArtifact: (line: number, artifact: {
     readonly artifactId: string;

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

@@ -1,4 +1,12 @@
 export declare const en: {
+    readonly workspace: {
+        readonly newItem: "New: {{title}}";
+        readonly close: "Close";
+        readonly download: "Download";
+        readonly shownByBelong: "Shown by Belong";
+        readonly openedByYou: "You opened this";
+        readonly planTitle: "Plan";
+    };
     readonly usage: {
         readonly tooltip: "Auto-compacts at {{chars}} chars; {{tokens}} tokens used this session";
         readonly windowTooltip: "Context window: {{used}} of {{window}} tokens used ({{pct}}%)";
@@ -24,6 +32,7 @@ export declare const en: {
         };
     };
     readonly stream: {
+        readonly toolExecutionError: "The tool could not complete. Please try again.";
         readonly copyOutput: "Copy output";
         readonly terminalOutput: "terminal output";
         readonly skillChip: "Skill: {{name}}";
@@ -350,6 +359,8 @@ export declare const en: {
         readonly hotkeyHint: "Hold {{key}} to talk — chat can stay closed";
         readonly expand: "Expand";
         readonly collapse: "Collapse";
+        readonly fullscreen: "Fullscreen";
+        readonly exitFullscreen: "Exit fullscreen";
         readonly spawnAgent: "New agent";
         readonly closeChat: "Close this chat";
         readonly closeAgent: "Close {{label}}";
@@ -440,8 +451,6 @@ export declare const en: {
         readonly deployedAt: "deployed {{label}}";
         readonly devOverrideActive: "Dev override active — click to change";
         readonly callLightModelActive: "Calls are stepped down to the light voice model — click for the best voice";
-        readonly micUnmuted: "Mic unmuted";
-        readonly micMuted: "Mic muted";
         readonly agentWorking: "{{name}} is working…";
     };
     readonly connectors: {
@@ -748,7 +757,6 @@ export declare const en: {
         readonly retry: "Retry";
     };
     readonly composer: {
-        readonly placeholder: "Ask anything — or type / for commands…";
         readonly attachFiles: "Attach files";
         readonly dismissVoiceHint: "Dismiss voice hint";
         readonly executionMode: "Execution mode: {{mode}}";

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

@@ -42,8 +42,6 @@ export declare const embedMiscEn: {
         readonly deployedAt: "deployed {{label}}";
         readonly devOverrideActive: "Dev override active — click to change";
         readonly callLightModelActive: "Calls are stepped down to the light voice model — click for the best voice";
-        readonly micUnmuted: "Mic unmuted";
-        readonly micMuted: "Mic muted";
         readonly agentWorking: "{{name}} is working…";
     };
 };
@@ -89,8 +87,6 @@ export declare const embedMiscEs: {
         deployedAt: string;
         devOverrideActive: string;
         callLightModelActive: string;
-        micUnmuted: string;
-        micMuted: string;
         agentWorking: string;
     };
 };
@@ -136,8 +132,6 @@ export declare const embedMiscPt: {
         deployedAt: string;
         devOverrideActive: string;
         callLightModelActive: string;
-        micUnmuted: string;
-        micMuted: string;
         agentWorking: string;
     };
 };

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

@@ -17,6 +17,8 @@ export declare const headerEn: {
         readonly hotkeyHint: "Hold {{key}} to talk — chat can stay closed";
         readonly expand: "Expand";
         readonly collapse: "Collapse";
+        readonly fullscreen: "Fullscreen";
+        readonly exitFullscreen: "Exit fullscreen";
         readonly spawnAgent: "New agent";
         readonly closeChat: "Close this chat";
         readonly closeAgent: "Close {{label}}";
@@ -43,6 +45,8 @@ export declare const headerEs: {
         hotkeyHint: string;
         expand: string;
         collapse: string;
+        fullscreen: string;
+        exitFullscreen: string;
         spawnAgent: string;
         closeChat: string;
         closeAgent: string;
@@ -69,6 +73,8 @@ export declare const headerPt: {
         hotkeyHint: string;
         expand: string;
         collapse: string;
+        fullscreen: string;
+        exitFullscreen: string;
         spawnAgent: string;
         closeChat: string;
         closeAgent: string;

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

@@ -8,6 +8,7 @@
  */
 export declare const streamEn: {
     readonly stream: {
+        readonly toolExecutionError: "The tool could not complete. Please try again.";
         readonly copyOutput: "Copy output";
         readonly terminalOutput: "terminal output";
         readonly skillChip: "Skill: {{name}}";
@@ -118,6 +119,7 @@ export declare const streamEn: {
 };
 export declare const streamEs: {
     stream: {
+        toolExecutionError: string;
         copyOutput: string;
         terminalOutput: string;
         skillChip: string;
@@ -225,6 +227,7 @@ export declare const streamEs: {
 };
 export declare const streamPt: {
     stream: {
+        toolExecutionError: string;
         copyOutput: string;
         terminalOutput: string;
         skillChip: string;

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

@@ -0,0 +1,32 @@
+/** Fullscreen workspace pane strings (spec 2026-09-02). §42: the copy names the
+ *  product only — "Belong" — never the pane, the agent, or the dock. */
+export declare const workspaceEn: {
+    readonly workspace: {
+        readonly newItem: "New: {{title}}";
+        readonly close: "Close";
+        readonly download: "Download";
+        readonly shownByBelong: "Shown by Belong";
+        readonly openedByYou: "You opened this";
+        readonly planTitle: "Plan";
+    };
+};
+export declare const workspaceEs: {
+    workspace: {
+        newItem: string;
+        close: string;
+        download: string;
+        shownByBelong: string;
+        openedByYou: string;
+        planTitle: string;
+    };
+};
+export declare const workspacePt: {
+    workspace: {
+        newItem: string;
+        close: string;
+        download: string;
+        shownByBelong: string;
+        openedByYou: string;
+        planTitle: string;
+    };
+};

package/dist/stream/belong-chat-transport.d.ts

@@ -20,11 +20,11 @@ export declare const choiceAnswerSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"skipped">;
 }, z.core.$strip>], "kind">;
 export declare const choiceStateSchema: z.ZodEnum<{
-    pending: "pending";
     detached: "detached";
-    cancelled: "cancelled";
-    answered: "answered";
+    pending: "pending";
     dismissed: "dismissed";
+    answered: "answered";
+    cancelled: "cancelled";
 }>;
 /**
  * The wire/stored part union. Exported so the history loader (chat.tsx) can
@@ -189,8 +189,8 @@ export declare const wireStreamPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
     data: z.ZodObject<{
         status: z.ZodEnum<{
             failed: "failed";
-            cancelled: "cancelled";
             completed: "completed";
+            cancelled: "cancelled";
             continuing: "continuing";
             throttled: "throttled";
         }>;
@@ -224,11 +224,11 @@ export declare const wireStreamPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
     data: z.ZodObject<{
         questionRequestId: z.ZodString;
         state: z.ZodEnum<{
-            pending: "pending";
             detached: "detached";
-            cancelled: "cancelled";
-            answered: "answered";
+            pending: "pending";
             dismissed: "dismissed";
+            answered: "answered";
+            cancelled: "cancelled";
         }>;
         questions: z.ZodArray<z.ZodObject<{
             id: z.ZodString;

package/dist/stream/use-agent-workspace-focus.d.ts

@@ -0,0 +1,5 @@
+import { BelongUIMessage } from './belong-data-parts.ts';
+export declare const useAgentWorkspaceFocus: (input: {
+    readonly messages: readonly BelongUIMessage[];
+    readonly historyLoading: boolean;
+}) => void;

package/dist/stream/workspace-focus-observer.d.ts

@@ -0,0 +1,7 @@
+import { BelongUIMessage } from './belong-data-parts.ts';
+import { WorkspaceFocusTarget } from './workspace-focus-store.ts';
+export type WorkspaceFocusEvent = {
+    readonly key: string;
+    readonly target: WorkspaceFocusTarget;
+};
+export declare const collectWorkspaceFocusEvents: (messages: readonly BelongUIMessage[], workspaceExternalId: string | null) => readonly WorkspaceFocusEvent[];

package/dist/stream/workspace-focus-store.d.ts

@@ -0,0 +1,26 @@
+import { PreviewTarget } from './preview-panel-store.ts';
+export type WorkspaceFocusTarget = PreviewTarget | {
+    readonly kind: "plan";
+};
+export type WorkspaceFocusState = {
+    readonly target: WorkspaceFocusTarget | null;
+    /** Who put `target` there; null iff `target` is null. */
+    readonly setBy: "agent" | "user" | null;
+    /** The agent wants this shown, but the user holds the pane. */
+    readonly pending: WorkspaceFocusTarget | null;
+};
+/** Same thing on screen? Artifacts by id, workspace files by pinned scope + path, plans by kind. */
+export declare const isSameFocusTarget: (a: WorkspaceFocusTarget, b: WorkspaceFocusTarget) => boolean;
+export declare const peekWorkspaceFocus: () => WorkspaceFocusState;
+export declare const subscribeWorkspaceFocus: (listener: () => void) => (() => void);
+export declare const useWorkspaceFocus: () => WorkspaceFocusState;
+/** The agent produced something: show it, unless the user holds the pane. */
+export declare const focusFromAgent: (target: WorkspaceFocusTarget) => void;
+/** The user opened something: show it and take the pane. */
+export declare const focusFromUser: (target: WorkspaceFocusTarget) => void;
+/** The user clicked the "New: …" chip: show the agent's item and hand back the pane. */
+export declare const followAgent: () => void;
+/** The user closed the pane: empty it, or show what the agent was waiting to show. */
+export declare const clearFocus: () => void;
+/** Session switch / new session / leaving fullscreen: forget everything. */
+export declare const resetWorkspaceFocus: () => void;

package/dist/types/public.d.ts

@@ -142,6 +142,31 @@ export type BelongInitInput = {
      * new value to flip it. (BEL-77)
      */
     readonly panelEnabled?: boolean;
+    /**
+     * Who is signed in, for the greeting ("Hi Ana — …") and the avatar menu.
+     * Optional; re-`init` or `belong.setUser` to change it. A re-`init` states
+     * the host's intent in FULL: omitting `user` clears the previously seeded
+     * name. A live `belong.setUser` override outranks this value and SURVIVES a
+     * later `init` until the host clears it with `setUser(null)`. Nothing is
+     * stored — a reload re-derives it from the host's next `init`.
+     */
+    readonly user?: {
+        readonly displayName?: string;
+    };
+    /**
+     * What page the user is on, shown as "Looking at ‹label›" before the first
+     * message. Omit `label` to use the browser tab title (`document.title`,
+     * tracked live so SPA navigation updates the line); pass
+     * `fromDocumentTitle: false` to show nothing unless a label is given.
+     * A re-`init` replaces this config wholesale: omitting `pageContext` clears
+     * a previously seeded `label` and restores the tab-title fallback.
+     * `belong.setPageContext` overrides both at runtime and SURVIVES a later
+     * `init` until the host clears it with `setPageContext(null)`.
+     */
+    readonly pageContext?: {
+        readonly label?: string;
+        readonly fromDocumentTitle?: boolean;
+    };
     /** Optional theme overrides applied at startup (before first render). */
     readonly theme?: PartialBelongTheme;
     /** Optional voice config (push-to-talk + read-aloud). */
@@ -231,6 +256,20 @@ export type BelongGlobal = {
      * alongside URL tracking for instant switches.
      */
     readonly setWorkspace: (id: string | null) => void;
+    /**
+     * Set the signed-in user at runtime (wins over `init({ user })`).
+     * `setUser(null)` drops the override back to the init value;
+     * `setUser({ displayName: null })` says "no name for this user" and shows
+     * none even when `init` seeded one.
+     */
+    readonly setUser: (user: {
+        readonly displayName?: string | null;
+    } | null) => void;
+    /**
+     * Set the page label shown before the first message (wins over
+     * `init({ pageContext })` and the tab title). `null` drops the override.
+     */
+    readonly setPageContext: (label: string | null) => void;
     readonly setTheme: (theme: PartialBelongTheme) => void;
     readonly applyPreset: (name: PresetName) => void;
     readonly open: () => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@belonguniverseai/react-sdk",
-  "version": "0.6.18",
+  "version": "0.6.20",
   "description": "Belong — embeddable React AI assistant dock. Mount <BelongWidget> in your app tree with getToken dependency-injection auth.",
   "license": "UNLICENSED",
   "type": "module",

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

@@ -1,4 +0,0 @@
-import { DockCopyVariant } from '../../embed/copy.ts';
-export declare function CapabilityHints({ variant }: {
-    variant: DockCopyVariant;
-}): import("react").JSX.Element;