@belonguniverseai/react-sdk 0.6.17 → 0.6.19

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.17",
+  "version": "0.6.19",
   "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;