@belonguniverseai/react-sdk 0.1.6 → 0.1.8

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/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/lib/use-effect-event.d.ts

@@ -0,0 +1,13 @@
+/**
+ * React-18-compatible implementation of the `useEffectEvent` contract.
+ *
+ * The component build externalizes React, so importing React 19's native
+ * `useEffectEvent` would make the dock fail at runtime in a React 18 host.
+ * Keep this compatibility boundary local until React 19 is the minimum host
+ * version again.
+ *
+ * Same contract as React's: stable identity across renders, always sees the
+ * latest props/state, and must NOT be called during render — only from an
+ * effect, a timer, or an event handler.
+ */
+export declare const useEffectEvent: <TArgs extends readonly unknown[], TResult>(callback: (...args: TArgs) => TResult) => ((...args: TArgs) => TResult);

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

@@ -70,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

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,6 +100,8 @@ 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";
@@ -87,6 +110,14 @@ 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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@belonguniverseai/react-sdk",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Belong — embeddable React AI assistant dock. Mount <BelongWidget> in your app tree with getToken dependency-injection auth.",
   "license": "UNLICENSED",
   "type": "module",
@@ -20,8 +20,8 @@
     "./dist/component/index.js"
   ],
   "peerDependencies": {
-    "react": ">=19",
-    "react-dom": ">=19"
+    "react": ">=18.2.0",
+    "react-dom": ">=18.2.0"
   },
   "keywords": [
     "belong",

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

@@ -1,27 +0,0 @@
-import { BelongThemeBrand, BelongThemePalette } from '../../types/public.ts';
-/**
- * The agent-grant consent surface, rendered above the chat thread.
- * Non-blocking: chat works without a grant (the agent falls back to
- * device login in the terminal); this card just offers/states the
- * delegated CLI session.
- *
- *   none / expired / revoked → consent (or re-consent) prompt
- *   active                   → slim "connected until <time>" row + revoke
- *   unconfigured embed       → renders nothing (host didn't pass a scope)
- *
- * 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.
- */
-type AgentGrantCardProps = {
-    readonly palette: BelongThemePalette;
-    readonly brand: BelongThemeBrand;
-};
-export declare function AgentGrantCard({ palette, brand }: AgentGrantCardProps): import("react").JSX.Element | null;
-export {};

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

@@ -1,58 +0,0 @@
-/** Agent-grant consent card dock strings. */
-export declare const agentGrantEn: {
-    readonly agentGrant: {
-        readonly headlineExpired: "Your agent session expired";
-        readonly headlineRevoked: "Agent session disconnected";
-        readonly headlineNone: "Let the {{name}} agent use the CLI in the background";
-        readonly body: "It acts on your behalf in your current workspace — time-limited (24 h), revocable anytime.";
-        readonly connected: "{{name}} agent connected";
-        readonly connectedUntil: "{{name}} agent connected · until {{until}}";
-        readonly disconnect: "Disconnect";
-        readonly ctaAllow: "Allow";
-        readonly ctaReconnect: "Reconnect";
-        readonly notNow: "Not now";
-        readonly errorNotScopeMember: "Your {{name}} user isn't a member of this workspace, so the agent can't connect here. Switch to a workspace you belong to.";
-        readonly errorScopeSessionLimit: "This workspace is at its limit of active agent connections. We tried to free one up — reload and reconnect, or try again in a moment.";
-        readonly errorAuthTokenAlreadyUsed: "Reconnecting needs a fresh {{name}} sign-in — the last one was just used to connect. It refreshes on your next page reload, or on its own in a few minutes.";
-        readonly errorGrantRejected: "Simetrik declined the connection. This is usually a permissions or workspace issue — if it persists, contact Simetrik support.";
-        readonly errorGeneric: "Couldn't connect the agent session. Try again.";
-    };
-};
-export declare const agentGrantEs: {
-    agentGrant: {
-        headlineExpired: string;
-        headlineRevoked: string;
-        headlineNone: string;
-        body: string;
-        connected: string;
-        connectedUntil: string;
-        disconnect: string;
-        ctaAllow: string;
-        ctaReconnect: string;
-        notNow: string;
-        errorNotScopeMember: string;
-        errorScopeSessionLimit: string;
-        errorAuthTokenAlreadyUsed: string;
-        errorGrantRejected: string;
-        errorGeneric: string;
-    };
-};
-export declare const agentGrantPt: {
-    agentGrant: {
-        headlineExpired: string;
-        headlineRevoked: string;
-        headlineNone: string;
-        body: string;
-        connected: string;
-        connectedUntil: string;
-        disconnect: string;
-        ctaAllow: string;
-        ctaReconnect: string;
-        notNow: string;
-        errorNotScopeMember: string;
-        errorScopeSessionLimit: string;
-        errorAuthTokenAlreadyUsed: string;
-        errorGrantRejected: string;
-        errorGeneric: string;
-    };
-};