@belonguniverseai/react-sdk 0.3.5 → 0.4.0

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

@@ -57,6 +57,7 @@ export declare const en: {
         readonly executingTasks: "Working on it…";
         readonly workedSteps_one: "Worked · {{count}} step";
         readonly workedSteps_other: "Worked · {{count}} steps";
+        readonly resumingAfterPause: "Taking longer than expected — picking it back up…";
         readonly open: "Open";
         readonly reconnectNeeded: "The {{provider}} session needs reconnecting to continue.";
         readonly reconnect: "Reconnect";
@@ -82,6 +83,7 @@ export declare const en: {
         readonly noSessionsYet: "No sessions yet.";
         readonly untitledSession: "Untitled session";
         readonly updated: "updated";
+        readonly loadedIntoAgent: "Loaded into Agent {{line}}";
     };
     readonly scheduled: {
         readonly viewTitle: "Scheduled";
@@ -211,6 +213,8 @@ export declare const en: {
         readonly hotkeyHint: "Hold {{key}} to talk — chat can stay closed";
         readonly expand: "Expand";
         readonly collapse: "Collapse";
+        readonly spawnAgent: "New agent";
+        readonly closeAgent: "Close {{label}}";
     };
     readonly files: {
         readonly refreshFiles: "Refresh files";
@@ -270,6 +274,7 @@ export declare const en: {
         readonly workspaceLoadError: "Couldn't load your workspace files.";
         readonly workspaceNoFiles: "No files yet — what Belong writes in your workspace shows up here.";
         readonly workspaceNoMatches: "No matches.";
+        readonly workspaceWaking: "Waking up your workspace — your files will appear in a moment…";
         readonly csvEmpty: "This file is empty.";
         readonly csvRowLimit: "Showing the first {{shown}} of {{total}} rows — download for the full file.";
         readonly preview: "Preview";
@@ -433,6 +438,7 @@ export declare const en: {
         readonly endCall: "End call";
         readonly dismiss: "Dismiss";
         readonly startCall: "Start voice call";
+        readonly reconnectCall: "Reconnect voice call";
     };
     readonly callScreen: {
         readonly title: "Voice call";
@@ -474,6 +480,12 @@ export declare const en: {
         readonly lineWorking: "working";
         readonly lineReady: "ready";
         readonly lineFailed: "failed";
+        readonly lineIdle: "idle";
+        readonly lineNotStarted: "not started";
+        readonly lineNoChat: "no chat yet";
+        readonly activity: "Activity";
+        readonly showConversationLog: "Show conversation log";
+        readonly hideConversationLog: "Hide conversation log";
         readonly ambientTypingCode: "Typing code…";
         readonly ambientReviewingDiff: "Reviewing the diff…";
         readonly ambientRunningChecks: "Running checks…";

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

@@ -17,6 +17,7 @@ export declare const embedMiscEn: {
         readonly workspaceLoadError: "Couldn't load your workspace files.";
         readonly workspaceNoFiles: "No files yet — what Belong writes in your workspace shows up here.";
         readonly workspaceNoMatches: "No matches.";
+        readonly workspaceWaking: "Waking up your workspace — your files will appear in a moment…";
         readonly csvEmpty: "This file is empty.";
         readonly csvRowLimit: "Showing the first {{shown}} of {{total}} rows — download for the full file.";
         readonly preview: "Preview";
@@ -62,6 +63,7 @@ export declare const embedMiscEs: {
         workspaceLoadError: string;
         workspaceNoFiles: string;
         workspaceNoMatches: string;
+        workspaceWaking: string;
         csvEmpty: string;
         csvRowLimit: string;
         preview: string;
@@ -107,6 +109,7 @@ export declare const embedMiscPt: {
         workspaceLoadError: string;
         workspaceNoFiles: string;
         workspaceNoMatches: string;
+        workspaceWaking: string;
         csvEmpty: string;
         csvRowLimit: string;
         preview: string;

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

@@ -15,6 +15,8 @@ export declare const headerEn: {
         readonly hotkeyHint: "Hold {{key}} to talk — chat can stay closed";
         readonly expand: "Expand";
         readonly collapse: "Collapse";
+        readonly spawnAgent: "New agent";
+        readonly closeAgent: "Close {{label}}";
     };
 };
 export declare const headerEs: {
@@ -33,6 +35,8 @@ export declare const headerEs: {
         hotkeyHint: string;
         expand: string;
         collapse: string;
+        spawnAgent: string;
+        closeAgent: string;
     };
 };
 export declare const headerPt: {
@@ -51,5 +55,7 @@ export declare const headerPt: {
         hotkeyHint: string;
         expand: string;
         collapse: string;
+        spawnAgent: string;
+        closeAgent: string;
     };
 };

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

@@ -18,6 +18,7 @@ export declare const sessionsEn: {
         readonly noSessionsYet: "No sessions yet.";
         readonly untitledSession: "Untitled session";
         readonly updated: "updated";
+        readonly loadedIntoAgent: "Loaded into Agent {{line}}";
     };
 };
 export declare const sessionsEs: {
@@ -39,6 +40,7 @@ export declare const sessionsEs: {
         noSessionsYet: string;
         untitledSession: string;
         updated: string;
+        loadedIntoAgent: string;
     };
 };
 export declare const sessionsPt: {
@@ -60,5 +62,6 @@ export declare const sessionsPt: {
         noSessionsYet: string;
         untitledSession: string;
         updated: string;
+        loadedIntoAgent: string;
     };
 };

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

@@ -57,6 +57,7 @@ export declare const streamEn: {
         readonly executingTasks: "Working on it…";
         readonly workedSteps_one: "Worked · {{count}} step";
         readonly workedSteps_other: "Worked · {{count}} steps";
+        readonly resumingAfterPause: "Taking longer than expected — picking it back up…";
         readonly open: "Open";
         readonly reconnectNeeded: "The {{provider}} session needs reconnecting to continue.";
         readonly reconnect: "Reconnect";
@@ -116,6 +117,7 @@ export declare const streamEs: {
         executingTasks: string;
         workedSteps_one: string;
         workedSteps_other: string;
+        resumingAfterPause: string;
         open: string;
         reconnectNeeded: string;
         reconnect: string;
@@ -175,6 +177,7 @@ export declare const streamPt: {
         executingTasks: string;
         workedSteps_one: string;
         workedSteps_other: string;
+        resumingAfterPause: string;
         open: string;
         reconnectNeeded: string;
         reconnect: string;

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

@@ -410,18 +410,22 @@ export declare const wireStreamPartSchema: z.ZodDiscriminatedUnion<"type", [z.Zo
     data: z.ZodObject<{
         status: z.ZodEnum<["continuing", "completed", "cancelled", "failed", "throttled"]>;
         message: z.ZodOptional<z.ZodString>;
+        retryable: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         status: "completed" | "failed" | "cancelled" | "continuing" | "throttled";
         message?: string | undefined;
+        retryable?: boolean | undefined;
     }, {
         status: "completed" | "failed" | "cancelled" | "continuing" | "throttled";
         message?: string | undefined;
+        retryable?: boolean | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
     id: string;
     data: {
         status: "completed" | "failed" | "cancelled" | "continuing" | "throttled";
         message?: string | undefined;
+        retryable?: boolean | undefined;
     };
     type: "data-status";
 }, {
@@ -429,6 +433,7 @@ export declare const wireStreamPartSchema: z.ZodDiscriminatedUnion<"type", [z.Zo
     data: {
         status: "completed" | "failed" | "cancelled" | "continuing" | "throttled";
         message?: string | undefined;
+        retryable?: boolean | undefined;
     };
     type: "data-status";
 }>, z.ZodObject<{
@@ -667,6 +672,22 @@ export declare const RECONNECT_MAX_CONSECUTIVE_FAILURES = 10;
  * instead — the same discipline browser/control-channel.ts already applies.
  */
 export declare const STALL_TIMEOUT_MS = 30000;
+/**
+ * How long a retryable terminal (`data-status {status:"failed",
+ * retryable:true}` — a turn-deadline abort whose task WILL be reactivated on
+ * the same run/stream) may sit with no subsequent delivered event before the
+ * transport stops waiting and promotes it to a real failure. Reactivation is
+ * normally near-instant (the post-drain outbox recheck fires as the aborted
+ * drain settles) but the resumed turn can take a while to emit its first
+ * event (sandbox boot, transcript hydrate); the fleet-wide outbox sweep is
+ * the slowest legitimate path (≤60s period + ~30s first event). Without this
+ * bound a run that never resumes would hold the connection open forever —
+ * the server's 15s keepalives feed the stall watchdog, so no drop ever
+ * occurs and the composer stays wedged. Kept ≤ the persisted-cursor
+ * freshness window (stream-state-store RESUME_MAX_AGE_MS, 120s) so a reload
+ * anywhere inside an armed grace can still resume the run cursor.
+ */
+export declare const RESUME_GRACE_MS = 120000;
 export type BelongChatTransportOptions = {
     /** Belong cloud base URL, e.g. `http://localhost:8787`. */
     readonly apiBaseUrl: string;
@@ -680,6 +701,11 @@ export type BelongChatTransportOptions = {
      * production uses `STALL_TIMEOUT_MS`.
      */
     readonly stallTimeoutMs?: number;
+    /**
+     * Retryable-terminal grace override (§25). Tests shrink it to tens of ms;
+     * production uses `RESUME_GRACE_MS`.
+     */
+    readonly resumeGraceMs?: number;
     /**
      * Workspace isolation: the host workspace this transport's session belongs
      * to. Defaults to the CURRENT scope at construction — captured once, so a

package/dist/stream/belong-data-parts.d.ts

@@ -147,6 +147,14 @@ export type ArtifactData = {
 export type StatusData = {
     readonly status: RunStatusKind;
     readonly message?: string | undefined;
+    /**
+     * Resume promise on a "failed" status: the backend verified the session
+     * still has pending work, so outbox recovery will reactivate the task and
+     * keep streaming into the SAME run/stream. The transport keeps its cursor
+     * open on it (no finalize) and the renderer shows a quiet "picking it back
+     * up" pill instead of a scary failure badge.
+     */
+    readonly retryable?: boolean | undefined;
 };
 /**
  * F3 — per-turn token usage + compaction context. Emitted once per turn at

package/dist/stream/route-dispatch.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The ONE seam that turns a `data-navigation` part into a host route-handler
+ * call — shared by the foreground renderer (`ai-sdk-part-renderers.tsx`'s
+ * `NavigationRenderer`) and a BACKGROUND line's run reader
+ * (`voice/line-run-reader.ts`), so a navigation the model dispatches on a
+ * background agent actually reaches the host instead of being silently
+ * dropped (a background line has no renderer to pick it up).
+ *
+ * Every failure mode (no handler registered, the handler throwing, the
+ * handler resolving `{ ok: false }`) collapses to one of three outcomes —
+ * never a throw — so both call sites can treat this as a plain result.
+ */
+export type RouteDispatchOutcome = "ok" | "failed" | "no_handler";
+export declare const dispatchRouteNavigation: (data: {
+    readonly routeName: string;
+    readonly params: Readonly<Record<string, string>>;
+}) => Promise<RouteDispatchOutcome>;

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

@@ -45,7 +45,8 @@ export type PersistedStreamState = z.infer<typeof streamStateSchema>;
  * 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;
+export type StreamStateWriteMode = "select" | "select_if_empty" | "preserve_selection";
+export declare const writeStreamState: (state: Omit<PersistedStreamState, "updatedAt">, workspaceId?: string | null, mode?: StreamStateWriteMode) => 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
@@ -63,11 +64,11 @@ export declare const clearStreamState: (workspaceId?: string | null) => void;
  */
 export declare const readResumableStreamState: (workspaceId?: string | null) => PersistedStreamState | null;
 /**
- * Persist the chosen session as the active stream session (sessions menu
- * switch / new). Passing a session id points the next ChatRoute mount at that
- * conversation with NO live run cursor (`runId`/`lastEventId` null) — so it
- * restores from history rather than resuming a stale run. Passing null clears
- * the pointer entirely, so a fresh `belong-chat-<id>` is generated (New chat).
+ * Select one Session (sessions menu switch / new). A Session with a live cursor
+ * parked by this tab restores that cursor so the next ChatRoute mount resumes
+ * its working run. Historical/terminal Sessions restore from history with no
+ * run cursor. Passing null clears only the selected pointer; parked live runs
+ * remain available when the user comes back to them.
  */
 export declare const setActiveSessionId: (sessionId: string | null) => void;
 /**

package/dist/types/public.d.ts

@@ -259,8 +259,10 @@ export type BelongGlobal = {
     readonly __forceAgentLines?: (lines: readonly {
         line: number;
         label: string;
-        status: "working" | "ready" | "failed" | "needs_approval";
+        status: "idle" | "working" | "ready" | "failed" | "needs_approval";
         sessionId?: string;
+        currentStepLabel?: string;
+        currentPhase?: "coding" | "files" | "actions";
     }[]) => void;
 };
 declare global {

package/package.json

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

package/dist/embed/universe-origin.d.ts

@@ -1,24 +0,0 @@
-/**
- * The host page's canonical origin — the BEL-111 `universeOrigin` component
- * prop. The dock's cross-origin navigation rebasing (`browser/spa-navigate.ts`)
- * and the cross-origin block in `browser/dom-bridge.ts` treat this as "the host
- * app's origin": a URL on a DIFFERENT origin is foreign (blocked / left for a
- * full load), and same-app env variants (prod↔stage) are rebased onto it.
- *
- * A single source so every branch agrees — reading `globalThis.location`
- * directly in some branches and a configured value in others would rebase
- * inconsistently. When unset it defaults to the live page origin, so the
- * script-tag embed and any host that never passes `universeOrigin` behave
- * exactly as before.
- */
-/** Register the host's canonical origin. Null / empty clears it (→ live origin). */
-export declare const setUniverseOrigin: (origin: string | null | undefined) => void;
-/** The configured universe origin string, or the live page origin when unset. */
-export declare const getUniverseOrigin: () => string;
-/**
- * The universe origin as a `URL` (for `.origin` + `.hostname`), or null when it
- * isn't a parseable absolute origin (e.g. a sandboxed `"null"` origin). Callers
- * treat null as "can't tell" and fall back to leaving the URL untouched /
- * refusing a client-side nav — matching the pre-existing safe defaults.
- */
-export declare const getUniverseUrl: () => URL | null;