@belonguniverseai/react-sdk 0.6.32 → 0.6.34

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';
@@ -239,6 +240,7 @@ export declare const wireStreamPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
         outcome: z.ZodOptional<z.ZodString>;
         terminationReason: z.ZodOptional<z.ZodString>;
         retryable: z.ZodOptional<z.ZodBoolean>;
+        code: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"data-usage">;
@@ -309,12 +311,12 @@ export declare const wireStreamPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
             waiting_for_approval: "waiting_for_approval";
             active: "active";
             paused: "paused";
+            blocked: "blocked";
             clarifying: "clarifying";
             completion_claimed: "completion_claimed";
             deferred: "deferred";
             waiting_for_user: "waiting_for_user";
             waiting_for_ui_action: "waiting_for_ui_action";
-            blocked: "blocked";
             budget_limited: "budget_limited";
             complete: "complete";
             cleared: "cleared";
@@ -354,12 +356,12 @@ export declare const wireStreamPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
                 waiting_for_approval: "waiting_for_approval";
                 active: "active";
                 paused: "paused";
+                blocked: "blocked";
                 clarifying: "clarifying";
                 completion_claimed: "completion_claimed";
                 deferred: "deferred";
                 waiting_for_user: "waiting_for_user";
                 waiting_for_ui_action: "waiting_for_ui_action";
-                blocked: "blocked";
                 budget_limited: "budget_limited";
                 complete: "complete";
                 cleared: "cleared";
@@ -386,6 +388,20 @@ export declare const wireStreamPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
             normal: "normal";
         }>>;
     }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"data-quota-notice">;
+    id: z.ZodString;
+    data: z.ZodObject<{
+        kind: z.ZodLiteral<"quota_exceeded">;
+        reason: z.ZodCatch<z.ZodOptional<z.ZodEnum<{
+            exhausted: "exhausted";
+            blocked: "blocked";
+        }>>>;
+        productName: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+        resetsAt: z.ZodCatch<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        limitWeightedTokens: z.ZodCatch<z.ZodOptional<z.ZodNumber>>;
+        usedWeightedTokens: z.ZodCatch<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$loose>;
 }, z.core.$strip>], "type">;
 /** A request was 401'd twice (once with a freshly re-read token), or no usable
  * token could be had at all (`BelongAuthUnavailableError`): the host session is
@@ -411,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
@@ -458,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/belong-data-parts.d.ts

@@ -268,6 +268,12 @@ export type StatusData = {
      * up" pill instead of a scary failure badge.
      */
     readonly retryable?: boolean | undefined;
+    /**
+     * #974 — a failed run's cause: the server's `run_error` code (e.g.
+     * `provider_content_filter`). The dock picks its copy by this, never by the
+     * English `message`. Absent from an older cloud and from other statuses.
+     */
+    readonly code?: string | undefined;
 };
 /**
  * One slice of the context-window breakdown. `key` is an open string on the
@@ -334,6 +340,28 @@ export type GoalProposalData = {
     readonly criteria?: readonly string[] | undefined;
     readonly runway?: GoalRunwayPreset | undefined;
 };
+/**
+ * Console P1 (TS-DOCK-02, DE-QTA-09) — a persisted monthly-quota refusal.
+ * The cell writes it as the assistant row answering a refused message; the
+ * history route returns it beside a fallback `text` part, which a dock that
+ * renders this card suppresses (SAD §9). The live 429 builds the same part
+ * from the response body (`routes/chat/use-quota-notice.ts`), so a reload
+ * renders what the user saw (§41).
+ *
+ * Every field but `kind` is optional on the wire (SAD §9): a newer dock must
+ * render a notice an older or partial writer left fields out of. The two
+ * figures are carried, never shown (the card has no number in it).
+ */
+export type QuotaRefusalReason = "exhausted" | "blocked";
+export type QuotaNoticeData = {
+    readonly kind: "quota_exceeded";
+    readonly reason?: QuotaRefusalReason | undefined;
+    readonly productName?: string | undefined;
+    /** ISO instant the month's tokens reset; `null` when there is none (blocked). */
+    readonly resetsAt?: string | null | undefined;
+    readonly limitWeightedTokens?: number | undefined;
+    readonly usedWeightedTokens?: number | undefined;
+};
 /**
  * Single source of truth for Belong's custom data parts. The record
  * keys (`reasoning`, `plan`, …) become the part-type suffix:
@@ -361,6 +389,8 @@ export type BelongDataParts = {
     goal: GoalView;
     /** Goal Mode M6 — a goal the agent offered via `propose_goal`. */
     "goal-proposal": GoalProposalData;
+    /** Console P1 — a persisted monthly-quota refusal (TS-DOCK-02). */
+    "quota-notice": QuotaNoticeData;
 };
 /**
  * The concrete `UIMessage` shape the chat surface and transport speak.
@@ -390,5 +420,5 @@ export type WireDataPart<NAME extends keyof BelongDataParts> = {
     readonly id: string;
     readonly data: BelongDataParts[NAME];
 };
-export type WireStreamPart = WireTextPart | WireDataPart<"model-activity"> | WireDataPart<"reasoning"> | WireDataPart<"plan"> | WireDataPart<"approval-request"> | WireDataPart<"choice-request"> | WireDataPart<"tool-call"> | WireDataPart<"subagent"> | WireDataPart<"sandbox-command"> | WireDataPart<"ui-action"> | WireDataPart<"cli-reconnect"> | WireDataPart<"navigation"> | WireDataPart<"artifact"> | WireDataPart<"status"> | WireDataPart<"usage"> | WireDataPart<"goal"> | WireDataPart<"goal-proposal">;
+export type WireStreamPart = WireTextPart | WireDataPart<"model-activity"> | WireDataPart<"reasoning"> | WireDataPart<"plan"> | WireDataPart<"approval-request"> | WireDataPart<"choice-request"> | WireDataPart<"tool-call"> | WireDataPart<"subagent"> | WireDataPart<"sandbox-command"> | WireDataPart<"ui-action"> | WireDataPart<"cli-reconnect"> | WireDataPart<"navigation"> | WireDataPart<"artifact"> | WireDataPart<"status"> | WireDataPart<"usage"> | WireDataPart<"goal"> | WireDataPart<"goal-proposal"> | WireDataPart<"quota-notice">;
 export type WireStreamPartType = WireStreamPart["type"];

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/provider-blocked.d.ts

@@ -0,0 +1,16 @@
+import { BelongUIMessage, StatusData } from './belong-data-parts.ts';
+/**
+ * A run the provider refused to finish. It ends on one localized notice in
+ * the turn (`stream.answerBlocked`), not on a stream error: nothing was lost
+ * in transit. Keyed on the run's cause code, never on the server's English
+ * prose.
+ */
+export declare const isProviderBlockedStatus: (data: StatusData) => boolean;
+/**
+ * Whether an assistant turn ended on a provider refusal. Such a run settles
+ * `ready` like a finished one (no stream error), so whatever reports a run's
+ * outcome reads this to tell the two apart. Only the turn's LAST status
+ * counts: a resumed run streams into the same message, so an earlier run's
+ * refusal can sit in front of a later run's answer.
+ */
+export declare const endedProviderBlocked: (message: BelongUIMessage) => boolean;

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.32",
+  "version": "0.6.34",
   "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-U55NEBew.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-DB1sFGc-.js";
-import "./chunk-NSK5VX7P-ur_ZGcVX.js";
-import "./chunk-ZIRB5QZD-DmX0SXRC.js";
-import "./chunk-W5SLKNZC-Dq8uD14N.js";
-import "./chunk-UBXNYLIW-CDKeQUnO.js";
-import "./chunk-4I5QYGJK-CGOVqmKQ.js";
-import "./chunk-WRU74C26-BwQb4DnE.js";
-import "./chunk-QR6OTTB3-Bl3Z_jKC.js";
-import "./chunk-7BUUIJ7U-DJJ8ycYS.js";
-import "./chunk-7Z6QIM7H-CSfSb_Xc.js";
-import "./chunk-J7OUQ5F2-DB9d7Gt_.js";
-import "./chunk-5VM5RSS4-BuOiQaWo.js";
-import "./chunk-2GRJ4B5K-C14K2lKj.js";
-import "./chunk-XXDRQBXY-BP7ld7ls.js";
-import "./chunk-KBJHAD2P-CVoxmRa8.js";
-export { n as diagram } from "./chunk-JQJVKLGR-De7zUJDv.js";