@belonguniverseai/react-sdk 0.1.5 → 0.1.7

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

@@ -17,3 +17,12 @@ export declare const feedbackEs: {
         send: string;
     };
 };
+export declare const feedbackPt: {
+    feedback: {
+        goodResponse: string;
+        badResponse: string;
+        reasonPlaceholder: string;
+        skip: string;
+        send: string;
+    };
+};

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

@@ -73,3 +73,40 @@ export declare const filesEs: {
         attachmentFallback: string;
     };
 };
+export declare const filesPt: {
+    files: {
+        refreshFiles: string;
+        searchDocumentsPlaceholder: string;
+        searchDocuments: string;
+        noFilesYet: string;
+        noFilesHint: string;
+        uploading: string;
+        dropFilesOrBrowse: string;
+        supportedTypes: string;
+        previewFile: string;
+        downloadFile: string;
+        uploadedInConversation: string;
+        noInlinePreview: string;
+        download: string;
+        loadingPreview: string;
+        truncatedNotice: string;
+        previewGenerateFailed: string;
+        previewTooLong: string;
+        previewUnavailable: string;
+        generatingPreview: string;
+        pageAlt: string;
+        previewOf: string;
+        searchWorkspacePlaceholder: string;
+        searchWorkspace: string;
+        workspaceFiles: string;
+        refresh: string;
+        refreshWorkspaceFiles: string;
+        workspaceEmpty: string;
+        noMatches: string;
+        ageJustNow: string;
+        ageMinutes: string;
+        ageHours: string;
+        ageDays: string;
+        attachmentFallback: string;
+    };
+};

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

@@ -4,12 +4,15 @@ export declare const headerEn: {
         readonly byBelong: "by Belong";
         readonly navChat: "Chat";
         readonly navFiles: "Files";
+        readonly navScheduled: "Scheduled";
         readonly chatPlanRunning: "Chat — plan running, {{completed}} of {{total}} steps done";
         readonly devMode: "Dev mode";
         readonly devModeTitle: "Dev mode (belong:dev)";
         readonly muteReplies: "Mute replies";
         readonly readRepliesAloud: "Read replies aloud";
         readonly speechNotSupported: "Speech not supported";
+        readonly railVoiceToggle: "Voice replies on/off — hold {{key}} to talk";
+        readonly hotkeyHint: "Hold {{key}} to talk — chat can stay closed";
         readonly expand: "Expand";
         readonly collapse: "Collapse";
     };
@@ -19,12 +22,33 @@ export declare const headerEs: {
         byBelong: string;
         navChat: string;
         navFiles: string;
+        navScheduled: string;
         chatPlanRunning: string;
         devMode: string;
         devModeTitle: string;
         muteReplies: string;
         readRepliesAloud: string;
         speechNotSupported: string;
+        railVoiceToggle: string;
+        hotkeyHint: string;
+        expand: string;
+        collapse: string;
+    };
+};
+export declare const headerPt: {
+    header: {
+        byBelong: string;
+        navChat: string;
+        navFiles: string;
+        navScheduled: string;
+        chatPlanRunning: string;
+        devMode: string;
+        devModeTitle: string;
+        muteReplies: string;
+        readRepliesAloud: string;
+        speechNotSupported: string;
+        railVoiceToggle: string;
+        hotkeyHint: string;
         expand: string;
         collapse: string;
     };

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

@@ -15,3 +15,11 @@ export declare const loginEs: {
         signIn: string;
     };
 };
+export declare const loginPt: {
+    login: {
+        welcome: string;
+        byBelong: string;
+        signInPrompt: string;
+        signIn: string;
+    };
+};

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

@@ -33,3 +33,20 @@ export declare const planEs: {
         reject: string;
     };
 };
+export declare const planPt: {
+    plan: {
+        cueReady: string;
+        fallbackTitle: string;
+        closeLabel: string;
+        emptyState: string;
+        resizeLabel: string;
+        stepCompleted: string;
+        stepFailed: string;
+        stepPending: string;
+        progressDone: string;
+        failedPrefix: string;
+        failedHelp: string;
+        approveAndRun: string;
+        reject: string;
+    };
+};

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

@@ -0,0 +1,253 @@
+/** Scheduled surface strings (rail view: list, create/edit dialog, detail, runs). */
+export declare const scheduledEn: {
+    readonly scheduled: {
+        readonly viewTitle: "Scheduled";
+        readonly subtitle: "Run work automatically, even when you're away";
+        readonly newTask: "New scheduled task";
+        readonly searchPlaceholder: "Search scheduled tasks";
+        readonly filterAll: "All";
+        readonly filterUpcoming: "Upcoming";
+        readonly filterCompleted: "Completed";
+        readonly loading: "Loading scheduled tasks…";
+        readonly empty: "No scheduled tasks yet";
+        readonly emptyHint: "Create one to run a prompt later — once or on a repeating schedule.";
+        readonly noResults: "No matches for “{{q}}”";
+        readonly loadError: "Couldn't load scheduled tasks.";
+        readonly loadMore: "Load more";
+        readonly statusActive: "Active";
+        readonly statusPaused: "Paused";
+        readonly statusCompleted: "Completed";
+        readonly statusUpcoming: "Upcoming";
+        readonly nextRun: "Next run {{time}}";
+        readonly nextRunIn: "Next run {{when}}";
+        readonly lastRun: "Last run {{time}}";
+        readonly dayAtTime: "{{day}} at {{time}}";
+        readonly pausedNotice: "Paused — runs won't start until you resume.";
+        readonly summaryOnce: "Once on {{time}}";
+        readonly summaryDaily: "Daily at {{time}}";
+        readonly summaryWeekdays: "Weekdays at {{time}}";
+        readonly summaryWeekly: "Every {{day}} at {{time}}";
+        readonly timezoneSuffix: "({{timezone}})";
+        readonly recurrenceNone: "Does not repeat";
+        readonly recurrenceDaily: "Daily";
+        readonly recurrenceWeekdays: "Weekdays (Mon–Fri)";
+        readonly recurrenceWeekly: "Weekly";
+        readonly dialogCreateTitle: "New scheduled task";
+        readonly dialogEditTitle: "Edit scheduled task";
+        readonly dialogHint: "You can change this later.";
+        readonly promptLabel: "What should the agent do?";
+        readonly promptPlaceholder: "Include everything the agent needs — each run starts a fresh conversation.";
+        readonly titleLabel: "Title (optional)";
+        readonly titlePlaceholder: "Shown in your scheduled list";
+        readonly whenLabel: "When";
+        readonly dateLabel: "Date";
+        readonly timeLabel: "Time";
+        readonly repeatLabel: "Repeat";
+        readonly timezoneLabel: "Timezone";
+        readonly timezoneSearchPlaceholder: "Search timezones…";
+        readonly timezoneNoMatch: "No matching timezone";
+        readonly create: "Create scheduled task";
+        readonly saveChanges: "Save changes";
+        readonly cancel: "Cancel";
+        readonly errorPromptRequired: "Write a prompt for the scheduled run.";
+        readonly errorPastTime: "Pick a time in the future.";
+        readonly errorTooFar: "Pick a time within the next year.";
+        readonly errorCreateFailed: "Couldn't create the schedule — try again.";
+        readonly errorUpdateFailed: "Couldn't save the changes — try again.";
+        readonly back: "Back to scheduled";
+        readonly pause: "Pause";
+        readonly resume: "Resume";
+        readonly resumedCompleted: "Its time already passed, so this one-time task is now completed.";
+        readonly runNow: "Run now";
+        readonly runNowStarted: "Run started — it will appear below.";
+        readonly edit: "Edit";
+        readonly delete: "Delete";
+        readonly deleteConfirmTitle: "Delete this scheduled task?";
+        readonly deleteConfirmBody: "Future runs are cancelled. Past runs and their conversations stay in your history.";
+        readonly deleteConfirm: "Delete";
+        readonly actionsMenu: "Schedule actions";
+        readonly actionFailed: "That didn't work — refresh and try again.";
+        readonly runsHeading: "Runs";
+        readonly runsCount_one: "{{count}} run";
+        readonly runsCount_other: "{{count}} runs";
+        readonly runsEmpty: "No runs yet — the first one appears here after it starts.";
+        readonly runsLoadError: "Couldn't load runs.";
+        readonly runStatusRunning: "Running";
+        readonly runStatusNeedsAttention: "Needs attention";
+        readonly runStatusCompleted: "Completed";
+        readonly runStatusFailed: "Failed";
+        readonly runNeedsAttentionHint: "Waiting for your input.";
+        readonly manualRun: "Manual run";
+        readonly openRun: "Open this run's conversation";
+        readonly detailLoadError: "Couldn't load this scheduled task.";
+        readonly detailGone: "This scheduled task no longer exists.";
+    };
+};
+export declare const scheduledEs: {
+    scheduled: {
+        viewTitle: string;
+        subtitle: string;
+        newTask: string;
+        searchPlaceholder: string;
+        filterAll: string;
+        filterUpcoming: string;
+        filterCompleted: string;
+        loading: string;
+        empty: string;
+        emptyHint: string;
+        noResults: string;
+        loadError: string;
+        loadMore: string;
+        statusActive: string;
+        statusPaused: string;
+        statusCompleted: string;
+        statusUpcoming: string;
+        nextRun: string;
+        nextRunIn: string;
+        lastRun: string;
+        dayAtTime: string;
+        pausedNotice: string;
+        summaryOnce: string;
+        summaryDaily: string;
+        summaryWeekdays: string;
+        summaryWeekly: string;
+        timezoneSuffix: string;
+        recurrenceNone: string;
+        recurrenceDaily: string;
+        recurrenceWeekdays: string;
+        recurrenceWeekly: string;
+        dialogCreateTitle: string;
+        dialogEditTitle: string;
+        dialogHint: string;
+        promptLabel: string;
+        promptPlaceholder: string;
+        titleLabel: string;
+        titlePlaceholder: string;
+        whenLabel: string;
+        dateLabel: string;
+        timeLabel: string;
+        repeatLabel: string;
+        timezoneLabel: string;
+        timezoneSearchPlaceholder: string;
+        timezoneNoMatch: string;
+        create: string;
+        saveChanges: string;
+        cancel: string;
+        errorPromptRequired: string;
+        errorPastTime: string;
+        errorTooFar: string;
+        errorCreateFailed: string;
+        errorUpdateFailed: string;
+        back: string;
+        pause: string;
+        resume: string;
+        resumedCompleted: string;
+        runNow: string;
+        runNowStarted: string;
+        edit: string;
+        delete: string;
+        deleteConfirmTitle: string;
+        deleteConfirmBody: string;
+        deleteConfirm: string;
+        actionsMenu: string;
+        actionFailed: string;
+        runsHeading: string;
+        runsCount_one: string;
+        runsCount_other: string;
+        runsEmpty: string;
+        runsLoadError: string;
+        runStatusRunning: string;
+        runStatusNeedsAttention: string;
+        runStatusCompleted: string;
+        runStatusFailed: string;
+        runNeedsAttentionHint: string;
+        manualRun: string;
+        openRun: string;
+        detailLoadError: string;
+        detailGone: string;
+    };
+};
+export declare const scheduledPt: {
+    scheduled: {
+        viewTitle: string;
+        subtitle: string;
+        newTask: string;
+        searchPlaceholder: string;
+        filterAll: string;
+        filterUpcoming: string;
+        filterCompleted: string;
+        loading: string;
+        empty: string;
+        emptyHint: string;
+        noResults: string;
+        loadError: string;
+        loadMore: string;
+        statusActive: string;
+        statusPaused: string;
+        statusCompleted: string;
+        statusUpcoming: string;
+        nextRun: string;
+        nextRunIn: string;
+        lastRun: string;
+        dayAtTime: string;
+        pausedNotice: string;
+        summaryOnce: string;
+        summaryDaily: string;
+        summaryWeekdays: string;
+        summaryWeekly: string;
+        timezoneSuffix: string;
+        recurrenceNone: string;
+        recurrenceDaily: string;
+        recurrenceWeekdays: string;
+        recurrenceWeekly: string;
+        dialogCreateTitle: string;
+        dialogEditTitle: string;
+        dialogHint: string;
+        promptLabel: string;
+        promptPlaceholder: string;
+        titleLabel: string;
+        titlePlaceholder: string;
+        whenLabel: string;
+        dateLabel: string;
+        timeLabel: string;
+        repeatLabel: string;
+        timezoneLabel: string;
+        timezoneSearchPlaceholder: string;
+        timezoneNoMatch: string;
+        create: string;
+        saveChanges: string;
+        cancel: string;
+        errorPromptRequired: string;
+        errorPastTime: string;
+        errorTooFar: string;
+        errorCreateFailed: string;
+        errorUpdateFailed: string;
+        back: string;
+        pause: string;
+        resume: string;
+        resumedCompleted: string;
+        runNow: string;
+        runNowStarted: string;
+        edit: string;
+        delete: string;
+        deleteConfirmTitle: string;
+        deleteConfirmBody: string;
+        deleteConfirm: string;
+        actionsMenu: string;
+        actionFailed: string;
+        runsHeading: string;
+        runsCount_one: string;
+        runsCount_other: string;
+        runsEmpty: string;
+        runsLoadError: string;
+        runStatusRunning: string;
+        runStatusNeedsAttention: string;
+        runStatusCompleted: string;
+        runStatusFailed: string;
+        runNeedsAttentionHint: string;
+        manualRun: string;
+        openRun: string;
+        detailLoadError: string;
+        detailGone: string;
+    };
+};

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

@@ -41,3 +41,24 @@ export declare const sessionsEs: {
         updated: string;
     };
 };
+export declare const sessionsPt: {
+    sessions: {
+        chats: string;
+        newChat: string;
+        noChatsYet: string;
+        untitledChat: string;
+        confirmDelete: string;
+        cancelDelete: string;
+        deleteChat: string;
+        renameChat: string;
+        chatName: string;
+        saveName: string;
+        cancelRename: string;
+        recentSessions: string;
+        loading: string;
+        failedToLoad: string;
+        noSessionsYet: string;
+        untitledSession: string;
+        updated: string;
+    };
+};

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

@@ -142,3 +142,71 @@ export declare const streamEs: {
         retry: string;
     };
 };
+export declare const streamPt: {
+    stream: {
+        copyOutput: string;
+        terminalOutput: string;
+        skillChip: string;
+        failedSuffix: string;
+        approvalRequired: string;
+        approve: string;
+        requestChanges: string;
+        reject: string;
+        approving: string;
+        rejecting: string;
+        sending: string;
+        decisionApproved: string;
+        decisionRejected: string;
+        decisionAmendRequested: string;
+        expired: string;
+        alreadyResolved: string;
+        alwaysAllowTool: string;
+        alwaysAllowAction: string;
+        submitError: string;
+        errorServerAnswered: string;
+        errorRequestUnreachable: string;
+        answered: string;
+        alreadyAnswered: string;
+        submit: string;
+        toolShellRunning: string;
+        toolShellDone: string;
+        toolShellFailed: string;
+        toolShellDetail: string;
+        toolApprovalRunning: string;
+        toolApprovalDone: string;
+        toolApprovalFailed: string;
+        toolApprovalDetail: string;
+        toolGenericRunning: string;
+        toolGenericDone: string;
+        toolGenericFailed: string;
+        toolGenericDetail: string;
+        browserSnapshot: string;
+        browserRead: string;
+        browserClick: string;
+        browserType: string;
+        browserNavigate: string;
+        browserSelfTest: string;
+        browserResolveResource: string;
+        browserAwaitProcessed: string;
+        browserAssertCreated: string;
+        failedBadge: string;
+        failedCount_one: string;
+        failedCount_other: string;
+        workedOnPageSteps_one: string;
+        workedOnPageSteps_other: string;
+        workedSteps_one: string;
+        workedSteps_other: string;
+        workingSteps_one: string;
+        workingSteps_other: string;
+        ranCommands_one: string;
+        ranCommands_other: string;
+        runningCommands_one: string;
+        runningCommands_other: string;
+        open: string;
+        reconnectNeeded: string;
+        reconnect: string;
+        reconnecting: string;
+        reconnected: string;
+        retry: string;
+    };
+};

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

@@ -19,3 +19,13 @@ export declare const usageEs: {
         turnsThisSessionOther: string;
     };
 };
+export declare const usagePt: {
+    usage: {
+        tooltip: string;
+        context: string;
+        tokens: string;
+        lastTurn: string;
+        turnsThisSessionOne: string;
+        turnsThisSessionOther: string;
+    };
+};

package/dist/lib/use-debounced-value.d.ts

@@ -0,0 +1,2 @@
+/** Trailing-edge debounce for fast-changing inputs (e.g. server-side search). */
+export declare const useDebouncedValue: <T>(value: T, delayMs?: number) => T;

package/dist/routes/chat.d.ts

@@ -25,6 +25,7 @@ export type QueuedMessage = {
     readonly submittedAt: number;
     readonly state: "queued" | "failed";
 };
-export declare const ChatRoute: ({ sessionId }?: {
-    sessionId?: string;
+export declare const ChatRoute: ({ sessionId, reconcileBackgroundRun, }?: {
+    readonly sessionId?: string;
+    readonly reconcileBackgroundRun?: boolean;
 }) => import("react").JSX.Element;

package/dist/routes/scheduled-detail.d.ts

@@ -0,0 +1,2 @@
+/** /scheduled/:taskScheduleId — one schedule's detail + run history. */
+export declare const ScheduledDetailRoute: () => import("react").JSX.Element;

package/dist/routes/scheduled.d.ts

@@ -0,0 +1,2 @@
+/** /scheduled — the Scheduled list view (rail tab). */
+export declare const ScheduledRoute: () => import("react").JSX.Element;

package/dist/stream/stream-state-store.d.ts

@@ -30,8 +30,29 @@ declare const streamStateSchema: z.ZodObject<{
     lastEventId: string | null;
 }>;
 export type PersistedStreamState = z.infer<typeof streamStateSchema>;
+/**
+ * The tab's active stream state.
+ *
+ * Reads the AUTHORITATIVE per-tab record from `sessionStorage`. On a brand-new
+ * tab (no record yet AND this tab hasn't already decided), adopts the SHARED
+ * localStorage seed's `sessionId` — with a null run cursor, so the new tab opens
+ * the most-recent conversation from history rather than resuming another tab's
+ * live run. The adoption is one-time: it marks the tab "seeded" so a later
+ * read (e.g. after a New-chat clear) doesn't re-adopt.
+ *
+ * A record present at the FIRST read of this page realm is provenance-checked
+ * (see the duplicate-tab block above): a duplicated tab keeps the session but
+ * is demoted off the live run cursor.
+ */
 export declare const readStreamState: (workspaceId?: string | null) => PersistedStreamState | null;
 export declare const writeStreamState: (state: Omit<PersistedStreamState, "updatedAt">, workspaceId?: string | null) => void;
+/**
+ * Clear THIS TAB's pointer (New chat). Removes only the per-tab sessionStorage
+ * record and marks the tab "seeded" so a reload stays blank instead of
+ * re-adopting the shared seed. The localStorage seed is deliberately left
+ * intact: another tab's most-recent conversation, and the next brand-new tab's
+ * starting point, must not be wiped by one tab starting a fresh chat.
+ */
 export declare const clearStreamState: (workspaceId?: string | null) => void;
 /**
  * Like {@link readStreamState}, but only returns state fresh enough that its
@@ -49,6 +70,15 @@ export declare const readResumableStreamState: (workspaceId?: string | null) =>
  * the pointer entirely, so a fresh `belong-chat-<id>` is generated (New chat).
  */
 export declare const setActiveSessionId: (sessionId: string | null) => void;
+/**
+ * Select a conversation together with a known live Belong run. Scheduled
+ * occurrences start outside `BelongChatTransport`, so their run cursor enters
+ * the normal reload/resume path here when the user explicitly opens one.
+ */
+export declare const setActiveRunStream: (input: {
+    readonly sessionId: string;
+    readonly runId: string;
+}) => void;
 /**
  * Subscribe to active-session-pointer changes. Pairs with
  * {@link peekActiveSessionId} for `useSyncExternalStore`. Returns an
@@ -64,4 +94,10 @@ export declare const subscribeStreamState: (listener: () => void) => (() => void
  * memo cache needed).
  */
 export declare const peekActiveSessionId: () => string | null;
+/** Test-only: forget the per-tab seed cache + provenance state (does NOT touch
+ * Web Storage — a test clears sessionStorage/localStorage itself). */
+export declare const __resetStreamStateStoreForTest: () => void;
+/** Test-only: pin the navigation type the duplicate-tab check sees (jsdom has
+ * no PerformanceNavigationTiming entry, so tests set it explicitly). */
+export declare const __setNavigationTypeForTest: (type: "reload" | "back_forward" | "navigate") => void;
 export {};

package/dist/types/public.d.ts

@@ -39,6 +39,25 @@ export type BelongThemeBrand = {
      *  back to the default Belong mark when absent. Validated at the perimeter. */
     readonly logo?: string;
 };
+/**
+ * Per-locale override of the domain-specific welcome copy (BEL-135). The dock
+ * ships GENERIC assistant copy by default; a tenant with domain vocabulary
+ * (e.g. Simetrik's "reconciliations") supplies it here — via its theme preset
+ * or its published `theme.json` — so the default stays neutral for every host.
+ * Only these four fields are overridable; the rest of the dock chrome is
+ * product-agnostic and never carries tenant vocabulary.
+ */
+export type DockWelcomeCopy = {
+    /** Welcome-card subtitle. */
+    readonly subtitle?: string;
+    /** Welcome-card capability LABELS (icons keep their DOCK_COPY position). */
+    readonly capabilities?: readonly string[];
+    /** Empty-state intro body. */
+    readonly introBody?: string;
+    /** Quick-start suggestion chips. */
+    readonly suggestions?: readonly string[];
+};
+export type DockCopyOverride = Partial<Record<BelongLocale, DockWelcomeCopy>>;
 export type BelongTheme = {
     readonly mode: BelongThemeMode;
     readonly side: BelongThemeSide;
@@ -57,6 +76,8 @@ export type BelongTheme = {
     readonly accent?: string;
     /** Custom CSS custom-property overrides, projected last so they win over theme vars. */
     readonly cssVars?: Record<string, string>;
+    /** Per-locale welcome-copy override (BEL-135); absent → generic dock copy. */
+    readonly copy?: DockCopyOverride;
 };
 /**
  * Deep-partial of `BelongTheme`. Every layer is optional so a caller
@@ -79,14 +100,24 @@ export type PartialBelongTheme = {
     readonly accent?: string;
     /** Custom CSS custom-property overrides, projected last so they win over theme vars. */
     readonly cssVars?: Record<string, string>;
+    /** Per-locale welcome-copy override (BEL-135). */
+    readonly copy?: DockCopyOverride;
 };
 /** Built-in theme presets selectable via `belong.applyPreset(name)`. */
 export type PresetName = "belong" | "simetrik" | "custom";
 /** UI languages the dock ships. `setLocale` / `init({ locale })` accept these. */
-export type BelongLocale = "en" | "es";
+export type BelongLocale = "en" | "es" | "pt";
 export type BelongInitInput = {
     /** Belong cloud base URL, e.g. `https://api.belong.host` or `http://localhost:8787`. */
     readonly apiBaseUrl: string;
+    /**
+     * Public tenant slug (BEL-129, multi-tenant deployments). Used for
+     * boot-time, unauthenticated surfaces only — the theme fetch adds
+     * `?tenant=<slug>` and every request carries it as `X-Belong-Tenant`
+     * (observability). Authenticated routes derive the tenant from the JWT;
+     * this value can never escalate. Omit on single-tenant deployments.
+     */
+    readonly tenant?: string;
     /**
      * Dock UI language. When omitted the dock auto-detects: a stored user choice
      * ▸ the browser language ▸ English. Set it to default the deployment's
@@ -131,13 +162,17 @@ export type BelongInitInput = {
         readonly ttsChunkGapMs?: number;
     };
     /**
-     * Agent-grant (delegated CLI session) host context. The grant surface follows
-     * the ACTIVE WORKSPACE: whenever one is in scope — via `scopeExternalId` /
-     * `scopeUrlParam` here, or `setWorkspace` — the dock offers the consent card
-     * ("allow the agent to act on my behalf") for it, using the default provider.
-     * This object is OPTIONAL: set it only to pick a non-default `provider` or to
-     * track the workspace from a URL param. With no workspace in scope at all, the
-     * grant surface stays hidden.
+     * Agent-grant (delegated CLI session) host context. The grant follows the
+     * ACTIVE WORKSPACE: whenever one is in scope — via `scopeExternalId` /
+     * `scopeUrlParam` here, or `setWorkspace` — the dock silently establishes and
+     * refreshes a delegated CLI session for it (using the default provider), with
+     * NO user-facing UI. There is no consent card, connect button, or expiry
+     * banner: the session connects on first use and re-grants itself before
+     * expiry, in every execution mode. It is non-blocking — chat works without a
+     * grant (the agent falls back to CLI device-login in the terminal). This
+     * object is OPTIONAL: set it only to pick a non-default `provider` or to track
+     * the workspace from a URL param. With no workspace in scope at all, no grant
+     * is attempted.
      */
     readonly agentGrant?: {
         /** Grant provider key. Defaults to `"simetrik"`. */
@@ -147,8 +182,8 @@ export type BelongInitInput = {
         /**
          * Track the scope LIVE from this page-URL search param (e.g. `"w"`,
          * Simetrik's active-workspace param). When the host SPA switches
-         * workspace, the dock re-prompts consent for the new one — a grant is
-         * single-workspace, so each workspace needs its own. Takes precedence
+         * workspace, the dock silently connects the new one — a grant is
+         * single-workspace, so each workspace gets its own. Takes precedence
          * over a static `scopeExternalId` whenever the param is present.
          */
         readonly scopeUrlParam?: string;