@belonguniverseai/react-sdk 0.6.33 → 0.6.35

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

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { RECONNECT_MAX_CONSECUTIVE_FAILURES } from './reconnect-backoff.ts';
 import { ChatTransport, UIMessageChunk } from 'ai';
 import { FirstResponseObservation, FirstResponseSample } from '../infrastructure/telemetry/first-response-timing.ts';
 import { AUTH_EXPIRED_ERROR_PREFIX } from '../api/auth-errors.ts';
@@ -22,8 +23,8 @@ export declare const choiceAnswerSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"skipped">;
 }, z.core.$strip>], "kind">;
 export declare const choiceStateSchema: z.ZodEnum<{
-    cancelled: "cancelled";
     pending: "pending";
+    cancelled: "cancelled";
     dismissed: "dismissed";
     answered: "answered";
     detached: "detached";
@@ -64,9 +65,9 @@ export declare const wireStreamPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
             title: z.ZodString;
             kind: z.ZodString;
             status: z.ZodOptional<z.ZodEnum<{
-                failed: "failed";
-                completed: "completed";
                 pending: "pending";
+                completed: "completed";
+                failed: "failed";
                 in_progress: "in_progress";
             }>>;
         }, z.core.$strip>>;
@@ -91,8 +92,8 @@ export declare const wireStreamPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
                 label: z.ZodString;
                 value: z.ZodString;
                 emphasis: z.ZodOptional<z.ZodEnum<{
-                    normal: "normal";
                     warning: "warning";
+                    normal: "normal";
                 }>>;
             }, z.core.$strip>>;
             body: z.ZodNullable<z.ZodObject<{
@@ -109,8 +110,8 @@ export declare const wireStreamPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
     data: z.ZodObject<{
         toolName: z.ZodString;
         state: z.ZodEnum<{
-            failed: "failed";
             completed: "completed";
+            failed: "failed";
             started: "started";
         }>;
         input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -133,8 +134,8 @@ export declare const wireStreamPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
         name: z.ZodString;
         description: z.ZodString;
         state: z.ZodEnum<{
-            failed: "failed";
             running: "running";
+            failed: "failed";
             finished: "finished";
         }>;
         stepsUsed: z.ZodOptional<z.ZodNumber>;
@@ -163,8 +164,8 @@ export declare const wireStreamPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
     data: z.ZodObject<{
         state: z.ZodEnum<{
             output: "output";
-            failed: "failed";
             completed: "completed";
+            failed: "failed";
             started: "started";
         }>;
         stream: z.ZodOptional<z.ZodEnum<{
@@ -184,8 +185,8 @@ export declare const wireStreamPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
         uiActionRequestId: z.ZodString;
         actionName: z.ZodString;
         state: z.ZodEnum<{
-            failed: "failed";
             completed: "completed";
+            failed: "failed";
             requested: "requested";
         }>;
         args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -229,8 +230,8 @@ export declare const wireStreamPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
     id: z.ZodString;
     data: z.ZodObject<{
         status: z.ZodEnum<{
-            failed: "failed";
             completed: "completed";
+            failed: "failed";
             cancelled: "cancelled";
             continuing: "continuing";
             throttled: "throttled";
@@ -272,8 +273,8 @@ export declare const wireStreamPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
     data: z.ZodObject<{
         questionRequestId: z.ZodString;
         state: z.ZodEnum<{
-            cancelled: "cancelled";
             pending: "pending";
+            cancelled: "cancelled";
             dismissed: "dismissed";
             answered: "answered";
             detached: "detached";
@@ -307,10 +308,10 @@ export declare const wireStreamPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
     data: z.ZodObject<{
         goalId: z.ZodString;
         status: z.ZodEnum<{
-            waiting_for_approval: "waiting_for_approval";
             active: "active";
             paused: "paused";
             blocked: "blocked";
+            waiting_for_approval: "waiting_for_approval";
             clarifying: "clarifying";
             completion_claimed: "completion_claimed";
             deferred: "deferred";
@@ -352,10 +353,10 @@ export declare const wireStreamPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
             kind: z.ZodString;
             actor: z.ZodString;
             toStatus: z.ZodNullable<z.ZodEnum<{
-                waiting_for_approval: "waiting_for_approval";
                 active: "active";
                 paused: "paused";
                 blocked: "blocked";
+                waiting_for_approval: "waiting_for_approval";
                 clarifying: "clarifying";
                 completion_claimed: "completion_claimed";
                 deferred: "deferred";
@@ -393,8 +394,8 @@ export declare const wireStreamPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
     data: z.ZodObject<{
         kind: z.ZodLiteral<"quota_exceeded">;
         reason: z.ZodCatch<z.ZodOptional<z.ZodEnum<{
-            exhausted: "exhausted";
             blocked: "blocked";
+            exhausted: "exhausted";
         }>>>;
         productName: z.ZodCatch<z.ZodOptional<z.ZodString>>;
         resetsAt: z.ZodCatch<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
@@ -426,13 +427,8 @@ export declare class PostMessageError extends Error {
     readonly body: string;
     constructor(status: number, body: string);
 }
-/** First reconnect delay — identical to the historic fixed delay, so the
- * BEL-48 mid-run clean-EOF reconnect regains the stream just as fast. */
-export declare const RECONNECT_BASE_DELAY_MS = 1000;
-/** Exponential backoff ceiling. */
-export declare const RECONNECT_MAX_DELAY_MS = 30000;
-/** Consecutive connection attempts that deliver no event before we give up. */
-export declare const RECONNECT_MAX_CONSECUTIVE_FAILURES = 10;
+/** The reconnect policy lives with every other reader of a run's stream. */
+export { RECONNECT_MAX_CONSECUTIVE_FAILURES };
 /**
  * Liveness watchdog: the server emits a `: keepalive` comment every 15s
  * (run-stream.routes.ts), so a healthy connection delivers a chunk at least
@@ -473,9 +469,10 @@ export type BelongChatTransportOptions = {
     readonly apiBaseUrl: string;
     /**
      * Reconnect delay seam (§25 — do not hide time). Tests inject an instant
-     * recorder; production uses a real setTimeout sleep.
+     * recorder; production uses a real setTimeout sleep that `signal` (a stop
+     * or a supersede) ends at once.
      */
-    readonly sleepMs?: (ms: number) => Promise<void>;
+    readonly sleepMs?: (ms: number, signal: AbortSignal) => Promise<void>;
     /**
      * Stall-watchdog window override (§25). Tests shrink it to tens of ms;
      * production uses `STALL_TIMEOUT_MS`.

package/dist/stream/message-metadata.d.ts

@@ -1,4 +1,33 @@
 import { z } from 'zod';
+/** Mirrors belong-cloud's `ProactiveTurnNote` (`proactive-turn-note.ts`). */
+declare const proactiveTurnNoteSchema: z.ZodObject<{
+    tag: z.ZodEnum<{
+        needs_you: "needs_you";
+        heads_up: "heads_up";
+        done_on_my_own: "done_on_my_own";
+    }>;
+    source: z.ZodNullable<z.ZodObject<{
+        origin: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"scheduled_task">;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"simetrik">;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"app">;
+            app: z.ZodEnum<{
+                gmail: "gmail";
+                slack: "slack";
+                calendar: "calendar";
+            }>;
+            place: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"connector">;
+            name: z.ZodString;
+        }, z.core.$strip>], "kind">;
+        moreCount: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ProactiveTurnNote = z.infer<typeof proactiveTurnNoteSchema>;
+export type ProactiveTurnSource = NonNullable<ProactiveTurnNote["source"]>;
 export declare const belongMessageMetadataSchema: z.ZodObject<{
     taskId: z.ZodOptional<z.ZodString>;
     feedback: z.ZodOptional<z.ZodNullable<z.ZodObject<{
@@ -12,5 +41,33 @@ export declare const belongMessageMetadataSchema: z.ZodObject<{
     skill: z.ZodOptional<z.ZodString>;
     fromHistory: z.ZodOptional<z.ZodBoolean>;
     clientMessageId: z.ZodOptional<z.ZodString>;
+    proactive: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        tag: z.ZodEnum<{
+            needs_you: "needs_you";
+            heads_up: "heads_up";
+            done_on_my_own: "done_on_my_own";
+        }>;
+        source: z.ZodNullable<z.ZodObject<{
+            origin: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"scheduled_task">;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"simetrik">;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"app">;
+                app: z.ZodEnum<{
+                    gmail: "gmail";
+                    slack: "slack";
+                    calendar: "calendar";
+                }>;
+                place: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"connector">;
+                name: z.ZodString;
+            }, z.core.$strip>], "kind">;
+            moreCount: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    sentBy: z.ZodOptional<z.ZodLiteral<"personal_agent">>;
 }, z.core.$strip>;
 export type BelongMessageMetadata = z.infer<typeof belongMessageMetadataSchema>;
+export {};

package/dist/stream/pause-notice-copy.d.ts

@@ -0,0 +1,3 @@
+import { TFunction } from 'i18next';
+/** The localized line for a paused task's termination reason: its own, or the generic one. */
+export declare const pauseNoticeText: (t: TFunction, terminationReason: string | undefined) => string;

package/dist/stream/reconnect-backoff.d.ts

@@ -0,0 +1,39 @@
+/**
+ * How a reader of `GET /v1/runs/:runId/stream` waits between reconnects, and
+ * when it gives up (plan 007 §C4). One policy for every reader of a run's
+ * stream, so none of them can hammer the server harder than the chat does.
+ */
+/** Consecutive connection attempts that deliver no event before we give up. */
+export declare const RECONNECT_MAX_CONSECUTIVE_FAILURES = 10;
+/**
+ * Whether an event's `id:` moves a reader past its cursor. Only that counts as
+ * progress for the failure streak: an id-less part, or an id the reader has
+ * already seen (a server repeating itself), proves nothing, so a stream that
+ * only ever gives those still runs out of attempts. Ids that are not
+ * `<ms>-<seq>` count as progress when they differ from the cursor.
+ */
+export declare const advancesCursor: (eventId: string, cursor: string | null) => boolean;
+/**
+ * The wait before the next attempt, after `consecutiveFailuresCount` attempts
+ * in a row delivered no event: 1 s → 2 s → 4 s … capped at 30 s. A reader also
+ * passes its streak of attempts that ended on the run stream's failure notice
+ * (#1063), whichever is larger, so a server that brings one new event and then
+ * breaks, on every attempt, is polled at up to 30 s rather than every second.
+ */
+export declare const reconnectDelayMs: (consecutiveFailuresCount: number) => number;
+/**
+ * The notice streak after an attempt that ended on the run stream's failure
+ * notice. An attempt that brought many new events first was a healthy stream
+ * that broke once, so its break starts the streak over at 1 (a 1 s wait), and
+ * the sixth such break in a long run never freezes the answer for 30 s. A
+ * trickle of fewer new events keeps climbing toward the 30 s ceiling.
+ */
+export declare const nextNoticeStreakCount: (noticeStreakCount: number, attemptNewEventsCount: number) => number;
+/**
+ * The default wait before a reconnect: `ms`, or less. An abort of `signal`
+ * ends it at once and clears its timer and listener, so a reader torn down
+ * mid-backoff holds no timer for up to 30 s (review 1063.6 S3). It resolves
+ * either way: the caller re-checks its own abort state after the wait, so a
+ * live reader waits exactly as long as before.
+ */
+export declare const abortableSleepMs: (ms: number, signal: AbortSignal) => Promise<void>;

package/dist/stream/run-error-copy.d.ts

@@ -0,0 +1,25 @@
+import { TFunction } from 'i18next';
+import { BelongUIMessage } from './belong-data-parts.ts';
+/** The localized line for a failed run's code: its own, or the generic one. */
+export declare const runErrorText: (t: TFunction, code: string | undefined) => string;
+/** The `error` chunk text for a failed run: its code behind the marker, never its message. */
+export declare const runErrorErrorText: (code: string | undefined) => string;
+/** The localized line for a failed run's error text, or `null` for any other error. */
+export declare const runErrorTextFromError: (t: TFunction, errorMessage: string) => string | null;
+/** What a live call offers after a failure: the same as the dock's line says. */
+type RunErrorNextStep = "try_again" | "new_conversation";
+/**
+ * The call's next step for a failed run's error text. A line that says to
+ * start a new chat (a conversation grown too long, a blocked answer) must not
+ * be followed by an offer to try again; everything else may try again.
+ */
+export declare const runErrorNextStepFromError: (errorMessage: string) => RunErrorNextStep;
+/**
+ * Whether a turn already shows its failure: its LAST status part is a failed
+ * run that is neither paused nor resuming. Then the turn's own notice (the
+ * same live and from history, §41) says it, and the chat's error row must
+ * not repeat it. A turn still showing "picking it back up" whose resume
+ * never came does not, so the row says it there.
+ */
+export declare const turnShowsRunFailure: (message: BelongUIMessage) => boolean;
+export {};

package/dist/stream/stream-notice.d.ts

@@ -0,0 +1,9 @@
+import { TFunction } from 'i18next';
+/** Whether a wire `data-status` part is the run stream's failure notice. */
+export declare const isStreamNoticePart: (part: {
+    readonly id?: string | undefined;
+}) => boolean;
+/** The give-up `error` chunk text for a stream notice: its code behind the marker, never its message. */
+export declare const streamNoticeErrorText: (code: string | undefined) => string;
+/** The localized line for a stream notice's error text, or `null` for any other error. */
+export declare const streamNoticeText: (t: TFunction, errorMessage: string) => string | null;

package/package.json

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

package/dist/component/flowDiagram-UKHOOZJN-8qLgX2Wv.js

@@ -1,19 +0,0 @@
-globalThis.process = globalThis.process || { env: {} }, globalThis.global = globalThis.global || globalThis;
-import "./chunk-Y2CYZVJY-CiUSrfaV.js";
-import "./src-CKo8cHWB.js";
-import "./chunk-I66GZJ75-Dkw1ISGd.js";
-import "./chunk-NSK5VX7P-thQxjtNK.js";
-import "./chunk-ZIRB5QZD-DmX0SXRC.js";
-import "./chunk-W5SLKNZC-DLV7M8by.js";
-import "./chunk-UBXNYLIW-D26S6zO6.js";
-import "./chunk-4I5QYGJK-C29OfER5.js";
-import "./chunk-WRU74C26-13bvIAgD.js";
-import "./chunk-QR6OTTB3-OMd-rgNj.js";
-import "./chunk-7BUUIJ7U-DJJ8ycYS.js";
-import "./chunk-7Z6QIM7H-vNexNF_V.js";
-import "./chunk-J7OUQ5F2-dC67pJWg.js";
-import "./chunk-5VM5RSS4-BuOiQaWo.js";
-import "./chunk-2GRJ4B5K-CWOCv67u.js";
-import "./chunk-XXDRQBXY-BP7ld7ls.js";
-import "./chunk-KBJHAD2P-dwIA6Vmi.js";
-export { n as diagram } from "./chunk-JQJVKLGR-Djj9TdhH.js";