@belonguniverseai/react-sdk 0.6.26 → 0.6.28

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

@@ -14,6 +14,8 @@ export declare const settingsEn: {
         voiceDescription: string;
         history: string;
         historyDescription: string;
+        usage: string;
+        usageDescription: string;
         about: string;
         aboutDescription: string;
         apiKeys: string;
@@ -34,6 +36,10 @@ export declare const settingsEn: {
         apiKeysAuthError: string;
         apiKeysCreateError: string;
         apiKeysRevokeError: string;
+        workspaceScope: string;
+        workspaceScopeDescription: string;
+        workspaceScopeApplies: string;
+        workspaceScopeSaveError: string;
         profile: string;
         languageDescription: string;
         dockPosition: string;
@@ -42,6 +48,7 @@ export declare const settingsEn: {
         light: string;
         dark: string;
         presetDescription: string;
+        tenantDefault: string;
         advancedAppearance: string;
         advancedDescription: string;
         readRepliesDescription: string;
@@ -71,6 +78,8 @@ export declare const settingsEs: {
         voiceDescription: string;
         history: string;
         historyDescription: string;
+        usage: string;
+        usageDescription: string;
         about: string;
         aboutDescription: string;
         apiKeys: string;
@@ -91,6 +100,10 @@ export declare const settingsEs: {
         apiKeysAuthError: string;
         apiKeysCreateError: string;
         apiKeysRevokeError: string;
+        workspaceScope: string;
+        workspaceScopeDescription: string;
+        workspaceScopeApplies: string;
+        workspaceScopeSaveError: string;
         profile: string;
         languageDescription: string;
         dockPosition: string;
@@ -99,6 +112,7 @@ export declare const settingsEs: {
         light: string;
         dark: string;
         presetDescription: string;
+        tenantDefault: string;
         advancedAppearance: string;
         advancedDescription: string;
         readRepliesDescription: string;
@@ -128,6 +142,8 @@ export declare const settingsPt: {
         voiceDescription: string;
         history: string;
         historyDescription: string;
+        usage: string;
+        usageDescription: string;
         about: string;
         aboutDescription: string;
         apiKeys: string;
@@ -148,6 +164,10 @@ export declare const settingsPt: {
         apiKeysAuthError: string;
         apiKeysCreateError: string;
         apiKeysRevokeError: string;
+        workspaceScope: string;
+        workspaceScopeDescription: string;
+        workspaceScopeApplies: string;
+        workspaceScopeSaveError: string;
         profile: string;
         languageDescription: string;
         dockPosition: string;
@@ -156,6 +176,7 @@ export declare const settingsPt: {
         light: string;
         dark: string;
         presetDescription: string;
+        tenantDefault: string;
         advancedAppearance: string;
         advancedDescription: string;
         readRepliesDescription: string;
@@ -185,6 +206,8 @@ export declare const settingsIt: {
         voiceDescription: string;
         history: string;
         historyDescription: string;
+        usage: string;
+        usageDescription: string;
         about: string;
         aboutDescription: string;
         apiKeys: string;
@@ -205,6 +228,10 @@ export declare const settingsIt: {
         apiKeysAuthError: string;
         apiKeysCreateError: string;
         apiKeysRevokeError: string;
+        workspaceScope: string;
+        workspaceScopeDescription: string;
+        workspaceScopeApplies: string;
+        workspaceScopeSaveError: string;
         profile: string;
         languageDescription: string;
         dockPosition: string;
@@ -213,6 +240,7 @@ export declare const settingsIt: {
         light: string;
         dark: string;
         presetDescription: string;
+        tenantDefault: string;
         advancedAppearance: string;
         advancedDescription: string;
         readRepliesDescription: string;

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

@@ -2,9 +2,7 @@
 export declare const statsEn: {
     readonly stats: {
         readonly title: "Session stats";
-        readonly input: "Input";
-        readonly output: "Output";
-        readonly total: "Total";
+        readonly tokens: "Tokens";
         readonly timeRunning: "Time running";
         readonly turns: "Turns";
         readonly toolCalls: "Tool calls";
@@ -20,9 +18,7 @@ export declare const statsEn: {
 export declare const statsEs: {
     stats: {
         title: string;
-        input: string;
-        output: string;
-        total: string;
+        tokens: string;
         timeRunning: string;
         turns: string;
         toolCalls: string;
@@ -38,9 +34,7 @@ export declare const statsEs: {
 export declare const statsPt: {
     stats: {
         title: string;
-        input: string;
-        output: string;
-        total: string;
+        tokens: string;
         timeRunning: string;
         turns: string;
         toolCalls: string;
@@ -56,9 +50,7 @@ export declare const statsPt: {
 export declare const statsIt: {
     stats: {
         title: string;
-        input: string;
-        output: string;
-        total: string;
+        tokens: string;
         timeRunning: string;
         turns: string;
         toolCalls: string;

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

@@ -78,6 +78,35 @@ export declare const streamEn: {
         readonly toolForgetDone: "Forgot a note";
         readonly toolForgetFailed: "Couldn't forget the note";
         readonly toolForgetDetail: "Deleted a saved note about you.";
+        readonly toolUsageRunning: "Checking your usage";
+        readonly toolUsageDone: "Checked your usage";
+        readonly toolUsageFailed: "Couldn't check your usage";
+        readonly toolUsageDetail: "Looked up how many tokens you've used.";
+        readonly toolCheckBackgroundRunning: "Checking a background command";
+        readonly toolCheckBackgroundDone: "Checked a background command";
+        readonly toolCheckBackgroundFailed: "Couldn't check the background command";
+        readonly toolCheckBackgroundDetail: "Read what a command running in the background wrote.";
+        readonly toolWaitBackgroundRunning: "Waiting for a background command";
+        readonly toolWaitBackgroundDone: "Waited for a background command";
+        readonly toolWaitBackgroundFailed: "Couldn't wait for the background command";
+        readonly toolWaitBackgroundDetail: "Waited for a command running in the background to finish.";
+        readonly toolStopBackgroundRunning: "Stopping a background command";
+        readonly toolStopBackgroundDone: "Stopped a background command";
+        readonly toolStopBackgroundFailed: "Couldn't stop the background command";
+        readonly toolStopBackgroundDetail: "Stopped a command that was running in the background.";
+        readonly toolReadFileRunning: "Reading {{file}}";
+        readonly toolReadFileDone: "Read {{file}}";
+        readonly toolReadFileFailed: "Couldn't read {{file}}";
+        readonly toolReadFileDetail: "Read {{path}}.";
+        readonly toolWriteFileRunning: "Writing {{file}}";
+        readonly toolWriteFileDone: "Wrote {{file}}";
+        readonly toolWriteFileFailed: "Couldn't write {{file}}";
+        readonly toolWriteFileDetail: "Wrote {{path}}.";
+        readonly toolEditFileRunning: "Editing {{file}}";
+        readonly toolEditFileDone: "Edited {{file}}";
+        readonly toolEditFileFailed: "Couldn't edit {{file}}";
+        readonly toolEditFileDetail: "Edited {{path}}.";
+        readonly toolFileUnnamed: "a file";
         readonly toolSaveSkillRunning: "Saving a skill";
         readonly toolSaveSkillDone: "Saved a skill";
         readonly toolSaveSkillFailed: "Couldn't save the skill";
@@ -102,6 +131,7 @@ export declare const streamEn: {
         readonly browserRefreshView: "Refreshed the page";
         readonly failedBadge: "failed";
         readonly actionReadFile: "Read a file";
+        readonly actionCheckedUsage: "Checked your usage";
         readonly actionWroteFile: "Updated a file";
         readonly actionPublishedArtifact: "Put a report on screen";
         readonly actionLookedUpSkill: "Looked up a skill";
@@ -255,6 +285,35 @@ export declare const streamEs: {
         toolForgetDone: string;
         toolForgetFailed: string;
         toolForgetDetail: string;
+        toolUsageRunning: string;
+        toolUsageDone: string;
+        toolUsageFailed: string;
+        toolUsageDetail: string;
+        toolCheckBackgroundRunning: string;
+        toolCheckBackgroundDone: string;
+        toolCheckBackgroundFailed: string;
+        toolCheckBackgroundDetail: string;
+        toolWaitBackgroundRunning: string;
+        toolWaitBackgroundDone: string;
+        toolWaitBackgroundFailed: string;
+        toolWaitBackgroundDetail: string;
+        toolStopBackgroundRunning: string;
+        toolStopBackgroundDone: string;
+        toolStopBackgroundFailed: string;
+        toolStopBackgroundDetail: string;
+        toolReadFileRunning: string;
+        toolReadFileDone: string;
+        toolReadFileFailed: string;
+        toolReadFileDetail: string;
+        toolWriteFileRunning: string;
+        toolWriteFileDone: string;
+        toolWriteFileFailed: string;
+        toolWriteFileDetail: string;
+        toolEditFileRunning: string;
+        toolEditFileDone: string;
+        toolEditFileFailed: string;
+        toolEditFileDetail: string;
+        toolFileUnnamed: string;
         toolSaveSkillRunning: string;
         toolSaveSkillDone: string;
         toolSaveSkillFailed: string;
@@ -279,6 +338,7 @@ export declare const streamEs: {
         browserRefreshView: string;
         failedBadge: string;
         actionReadFile: string;
+        actionCheckedUsage: string;
         actionWroteFile: string;
         actionPublishedArtifact: string;
         actionLookedUpSkill: string;
@@ -429,6 +489,35 @@ export declare const streamPt: {
         toolForgetDone: string;
         toolForgetFailed: string;
         toolForgetDetail: string;
+        toolUsageRunning: string;
+        toolUsageDone: string;
+        toolUsageFailed: string;
+        toolUsageDetail: string;
+        toolCheckBackgroundRunning: string;
+        toolCheckBackgroundDone: string;
+        toolCheckBackgroundFailed: string;
+        toolCheckBackgroundDetail: string;
+        toolWaitBackgroundRunning: string;
+        toolWaitBackgroundDone: string;
+        toolWaitBackgroundFailed: string;
+        toolWaitBackgroundDetail: string;
+        toolStopBackgroundRunning: string;
+        toolStopBackgroundDone: string;
+        toolStopBackgroundFailed: string;
+        toolStopBackgroundDetail: string;
+        toolReadFileRunning: string;
+        toolReadFileDone: string;
+        toolReadFileFailed: string;
+        toolReadFileDetail: string;
+        toolWriteFileRunning: string;
+        toolWriteFileDone: string;
+        toolWriteFileFailed: string;
+        toolWriteFileDetail: string;
+        toolEditFileRunning: string;
+        toolEditFileDone: string;
+        toolEditFileFailed: string;
+        toolEditFileDetail: string;
+        toolFileUnnamed: string;
         toolSaveSkillRunning: string;
         toolSaveSkillDone: string;
         toolSaveSkillFailed: string;
@@ -453,6 +542,7 @@ export declare const streamPt: {
         browserRefreshView: string;
         failedBadge: string;
         actionReadFile: string;
+        actionCheckedUsage: string;
         actionWroteFile: string;
         actionPublishedArtifact: string;
         actionLookedUpSkill: string;
@@ -603,6 +693,35 @@ export declare const streamIt: {
         toolForgetDone: string;
         toolForgetFailed: string;
         toolForgetDetail: string;
+        toolUsageRunning: string;
+        toolUsageDone: string;
+        toolUsageFailed: string;
+        toolUsageDetail: string;
+        toolCheckBackgroundRunning: string;
+        toolCheckBackgroundDone: string;
+        toolCheckBackgroundFailed: string;
+        toolCheckBackgroundDetail: string;
+        toolWaitBackgroundRunning: string;
+        toolWaitBackgroundDone: string;
+        toolWaitBackgroundFailed: string;
+        toolWaitBackgroundDetail: string;
+        toolStopBackgroundRunning: string;
+        toolStopBackgroundDone: string;
+        toolStopBackgroundFailed: string;
+        toolStopBackgroundDetail: string;
+        toolReadFileRunning: string;
+        toolReadFileDone: string;
+        toolReadFileFailed: string;
+        toolReadFileDetail: string;
+        toolWriteFileRunning: string;
+        toolWriteFileDone: string;
+        toolWriteFileFailed: string;
+        toolWriteFileDetail: string;
+        toolEditFileRunning: string;
+        toolEditFileDone: string;
+        toolEditFileFailed: string;
+        toolEditFileDetail: string;
+        toolFileUnnamed: string;
         toolSaveSkillRunning: string;
         toolSaveSkillDone: string;
         toolSaveSkillFailed: string;
@@ -627,6 +746,7 @@ export declare const streamIt: {
         browserRefreshView: string;
         failedBadge: string;
         actionReadFile: string;
+        actionCheckedUsage: string;
         actionWroteFile: string;
         actionPublishedArtifact: string;
         actionLookedUpSkill: string;

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

@@ -9,7 +9,6 @@ export declare const usageEn: {
         readonly closeContext: "Close context";
         readonly currentPage: "Current page";
         readonly windowTooltip: "Context window: {{used}} of {{window}} tokens used ({{pct}}%)";
-        readonly inOut: "Input {{in}} · output {{out}}";
         readonly turnsThisSessionOne: "{{count}} turn this session";
         readonly turnsThisSessionOther: "{{count}} turns this session";
         readonly panel: {
@@ -23,7 +22,6 @@ export declare const usageEn: {
             };
             readonly freeSpace: "Free space";
             readonly estimateNote: "Breakdown is estimated; the total is as reported by the model.";
-            readonly cacheLine: "Cache: {{read}} read · {{write}} written";
             readonly autoCompact: "Auto-compact: {{pct}}% of budget";
         };
         readonly compactionLabel: "Auto-compact: {{used}} of {{limit}} characters used ({{pct}}%)";
@@ -41,7 +39,6 @@ export declare const usageEs: {
         closeContext: string;
         currentPage: string;
         windowTooltip: string;
-        inOut: string;
         turnsThisSessionOne: string;
         turnsThisSessionOther: string;
         panel: {
@@ -55,7 +52,6 @@ export declare const usageEs: {
             };
             freeSpace: string;
             estimateNote: string;
-            cacheLine: string;
             autoCompact: string;
         };
         compactionLabel: string;
@@ -73,7 +69,6 @@ export declare const usagePt: {
         closeContext: string;
         currentPage: string;
         windowTooltip: string;
-        inOut: string;
         turnsThisSessionOne: string;
         turnsThisSessionOther: string;
         panel: {
@@ -87,7 +82,6 @@ export declare const usagePt: {
             };
             freeSpace: string;
             estimateNote: string;
-            cacheLine: string;
             autoCompact: string;
         };
         compactionLabel: string;
@@ -105,7 +99,6 @@ export declare const usageIt: {
         closeContext: string;
         currentPage: string;
         windowTooltip: string;
-        inOut: string;
         turnsThisSessionOne: string;
         turnsThisSessionOther: string;
         panel: {
@@ -119,7 +112,6 @@ export declare const usageIt: {
             };
             freeSpace: string;
             estimateNote: string;
-            cacheLine: string;
             autoCompact: string;
         };
         compactionLabel: string;

package/dist/infrastructure/telemetry/first-response-timing.d.ts

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+export type FirstResponseKey = {
+    readonly sessionId: string;
+    readonly runId: string;
+    readonly clientMessageId: string;
+};
+export type FirstResponseObservation = FirstResponseKey & {
+    readonly phase: "acknowledgment" | "main";
+};
+export type FirstResponseSample = FirstResponseObservation & {
+    readonly postAcceptedMs: number;
+    readonly deliveryMs: number;
+    readonly renderMs?: number;
+};
+export declare const firstResponseObservationsSchema: z.ZodArray<z.ZodObject<{
+    sessionId: z.ZodString;
+    runId: z.ZodString;
+    clientMessageId: z.ZodString;
+    phase: z.ZodEnum<{
+        acknowledgment: "acknowledgment";
+        main: "main";
+    }>;
+}, z.core.$strip>>;
+/** One bounded registry per transport; history and reconnect never create entries. */
+export declare const createFirstResponseTiming: (input: {
+    readonly nowMs: () => number;
+    readonly report: (sample: FirstResponseSample) => void;
+}) => {
+    start: ({ clientMessageId }: {
+        readonly clientMessageId: string;
+    }) => void;
+    accepted: (key: FirstResponseKey & {
+        readonly sourceMessageId: string;
+    }) => void;
+    observations: (key: {
+        readonly sessionId: string;
+        readonly runId: string;
+        readonly sourceMessageIds: readonly string[];
+        readonly phase: FirstResponseObservation["phase"];
+    }) => readonly FirstResponseObservation[];
+    delivered: (observation: FirstResponseObservation) => void;
+    rendered: (observation: FirstResponseObservation) => void;
+    cancel: ({ clientMessageId }: {
+        readonly clientMessageId: string;
+    }) => void;
+    finishRun: (key: {
+        readonly sessionId: string;
+        readonly runId: string;
+    }) => void;
+};
+export declare const reportFirstResponseSample: (sample: FirstResponseSample) => void;

package/dist/lib/use-now.d.ts

@@ -0,0 +1,32 @@
+/**
+ * The dock's clock, as one moving value every surface can read.
+ *
+ * Surfaces that say something about time — "Link works until…", "refreshed 2h
+ * ago", "hasn't refreshed since…" — used to capture `new Date()` in a
+ * `useState` initializer. That freezes the comparison at MOUNT: a link that
+ * expired four minutes ago was still offered as live, and an overdue warning
+ * never appeared, even after a refetch brought fresh rows (P2, 2026-09-27
+ * PR #614 deep audit finding 8). Server-side expiry is enforced, so the damage
+ * was a screen that lied, not access — which is exactly the kind of thing a
+ * reader stops trusting the rest of the surface over.
+ *
+ * ONE STORE, not a hook-local interval, and that is the point: every consumer
+ * in a render reads the SAME `Date` object. Two independent clocks a few
+ * milliseconds apart can straddle an expiry and render "live" beside "expired"
+ * in the same paint (§25), which is the bug the frozen `useState` was
+ * originally protecting against — this keeps that guarantee and adds movement.
+ *
+ * One interval for the whole SDK, started by the first subscriber and cleared
+ * by the last: nothing ticks while no surface is on screen, and a store that
+ * has been idle re-reads the wall clock when it starts again rather than
+ * handing out the instant it stopped at.
+ */
+/**
+ * How often the shared instant advances. Half a minute: everything the dock
+ * says about time is minute-scale or coarser ("works until 10:00", "2h ago"),
+ * so this is fine enough that no reader sees a stale answer, and coarse enough
+ * that an idle dock is not re-rendering its surfaces every second.
+ */
+export declare const NOW_TICK_MS = 30000;
+/** The current instant, shared with every other consumer of this render. */
+export declare const useNow: () => Date;

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

@@ -0,0 +1,2 @@
+/** /artifacts/:liveArtifactId — one live report and every version it has had. */
+export declare const ArtifactDetailRoute: () => import("react").JSX.Element;

package/dist/routes/artifacts.d.ts

@@ -0,0 +1,2 @@
+/** /artifacts — the live reports the assistant keeps up to date (rail tab). */
+export declare const ArtifactsRoute: () => import("react").JSX.Element;

package/dist/routes/chat/transcript-row.d.ts

@@ -29,6 +29,7 @@ export type TranscriptRowWiring = {
     readonly onGoalStartAnother: () => void;
 };
 export type TranscriptRowProps = {
+    readonly onFirstResponseRendered?: ComponentProps<typeof MessageParts>["onFirstResponseRendered"];
     readonly message: BelongUIMessage;
     /** This message's index in the FULL conversation (not the render window). */
     readonly index: number;

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

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { ChatTransport, UIMessageChunk } from 'ai';
+import { FirstResponseObservation, FirstResponseSample } from '../infrastructure/telemetry/first-response-timing.ts';
 import { BelongUIMessage, WireStreamPart } from './belong-data-parts.ts';
 declare const cancelRunResponseSchema: z.ZodObject<{
     recalledMessages: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -20,11 +21,11 @@ export declare const choiceAnswerSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"skipped">;
 }, z.core.$strip>], "kind">;
 export declare const choiceStateSchema: z.ZodEnum<{
-    detached: "detached";
-    pending: "pending";
     cancelled: "cancelled";
+    pending: "pending";
     dismissed: "dismissed";
     answered: "answered";
+    detached: "detached";
 }>;
 /**
  * The wire/stored part union. Exported so the history loader (chat.tsx) can
@@ -37,6 +38,14 @@ export declare const wireStreamPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
     type: z.ZodLiteral<"text">;
     id: z.ZodString;
     text: z.ZodString;
+    responsePhase: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        phase: z.ZodEnum<{
+            acknowledgment: "acknowledgment";
+            main: "main";
+        }>;
+        sourceMessageIds: z.ZodArray<z.ZodString>;
+        replyKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"data-reasoning">;
     id: z.ZodString;
@@ -54,9 +63,9 @@ export declare const wireStreamPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
             title: z.ZodString;
             kind: z.ZodString;
             status: z.ZodOptional<z.ZodEnum<{
-                pending: "pending";
                 failed: "failed";
                 completed: "completed";
+                pending: "pending";
                 in_progress: "in_progress";
             }>>;
         }, z.core.$strip>>;
@@ -250,6 +259,7 @@ export declare const wireStreamPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
                 count: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>;
         }, z.core.$strip>>;
+        weightedHundredths: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"data-choice-request">;
@@ -257,11 +267,11 @@ export declare const wireStreamPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
     data: z.ZodObject<{
         questionRequestId: z.ZodString;
         state: z.ZodEnum<{
-            detached: "detached";
-            pending: "pending";
             cancelled: "cancelled";
+            pending: "pending";
             dismissed: "dismissed";
             answered: "answered";
+            detached: "detached";
         }>;
         questions: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
@@ -292,13 +302,13 @@ 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";
             clarifying: "clarifying";
             completion_claimed: "completion_claimed";
             deferred: "deferred";
             waiting_for_user: "waiting_for_user";
-            waiting_for_approval: "waiting_for_approval";
             waiting_for_ui_action: "waiting_for_ui_action";
             blocked: "blocked";
             budget_limited: "budget_limited";
@@ -337,13 +347,13 @@ 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";
                 clarifying: "clarifying";
                 completion_claimed: "completion_claimed";
                 deferred: "deferred";
                 waiting_for_user: "waiting_for_user";
-                waiting_for_approval: "waiting_for_approval";
                 waiting_for_ui_action: "waiting_for_ui_action";
                 blocked: "blocked";
                 budget_limited: "budget_limited";
@@ -434,6 +444,10 @@ export declare const RESUME_GRACE_MS = 120000;
  * across tests in the same file otherwise). */
 export declare const __resetLiveStreamRegistryForTest: () => void;
 export type BelongChatTransportOptions = {
+    readonly firstResponseTiming?: {
+        readonly nowMs: () => number;
+        readonly report: (sample: FirstResponseSample) => void;
+    };
     /** Belong cloud base URL, e.g. `http://localhost:8787`. */
     readonly apiBaseUrl: string;
     /**
@@ -469,6 +483,10 @@ export type BelongChatTransportOptions = {
     readonly foregroundGeneration?: number;
 };
 export type StreamContext = {
+    textPhaseKey?: string;
+    firstResponseObservations?: (phase: NonNullable<Extract<WireStreamPart, {
+        type: "text";
+    }>["responsePhase"]>) => readonly FirstResponseObservation[];
     modelActivity?: {
         id: string;
         stepIndex: number;
@@ -534,6 +552,10 @@ export declare class BelongChatTransport implements ChatTransport<BelongUIMessag
     takeForeground(): void;
     /** Forget an unavailable session so the next send creates a fresh one. */
     reset(): void;
+    /** Register Stop before its cross-tab lookup/auth can yield. Later sends
+     * wait for the cancellation request, while the UI can stop listening at once.
+     */
+    stopRun: (resolveRun: () => string | null | Promise<string | null>) => Promise<readonly RecalledQueuedMessage[]>;
     /**
      * Best-effort server-side cancel of an in-flight run. `useChat`'s `stop()`
      * only aborts the local stream (stops listening); this tells belong-cloud to
@@ -568,6 +590,16 @@ export declare class BelongChatTransport implements ChatTransport<BelongUIMessag
      * unaccepted stop.
      */
     stopSubagent: (runId: string, subagentId: string) => Promise<void>;
+    beginFirstResponse: (clientMessageId: string) => void;
+    cancelFirstResponse: (clientMessageId: string) => void;
+    acceptFirstResponse: (input: {
+        sessionId: string;
+        runId: string;
+        clientMessageId: string;
+        messageId: string;
+        idempotent: boolean;
+    }) => void;
+    observeFirstResponseRendered: (observation: FirstResponseObservation) => void;
     sendMessages: ChatTransport<BelongUIMessage>["sendMessages"];
     reconnectToStream: ChatTransport<BelongUIMessage>["reconnectToStream"];
 }

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

@@ -310,6 +310,11 @@ export type UsageData = {
     readonly autoCompactThresholdChars: number;
     /** The detailed context-window breakdown (own-loop runtimes only). */
     readonly contextWindow?: ContextWindowData | undefined;
+    /**
+     * Plan 018 — the turn in WEIGHTED tokens, in hundredths: the one unit the
+     * dock shows users. Absent on a turn from a cloud that predates it.
+     */
+    readonly weightedHundredths?: number | undefined;
 };
 /**
  * Goal Mode M6 — a goal the agent OFFERED. Nothing exists on the backend
@@ -367,6 +372,11 @@ export type BelongUIMessage = UIMessage<BelongMessageMetadata, BelongDataParts>;
  * chunks yet — the transport translates this into `UIMessageChunk`.
  */
 export type WireTextPart = {
+    readonly responsePhase?: {
+        readonly phase: "acknowledgment" | "main";
+        readonly sourceMessageIds: readonly string[];
+        readonly replyKey?: string | undefined;
+    } | undefined;
     readonly type: "text";
     readonly id: string;
     readonly text: string;

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

@@ -1,4 +1,5 @@
 import { BelongMessagePart, PartRendererProps } from './ai-sdk-part-renderers.tsx';
+import { FirstResponseObservation } from '../infrastructure/telemetry/first-response-timing.ts';
 /**
  * The parts a message is INDEXED from (spec deviation 16). File parts render as
  * chips above the message and never reach a render group, and dropping one
@@ -10,7 +11,7 @@ import { BelongMessagePart, PartRendererProps } from './ai-sdk-part-renderers.ts
  * is the same list.
  */
 export declare const indexableMessageParts: (parts: readonly BelongMessagePart[]) => readonly BelongMessagePart[];
-export declare const MessageParts: ({ parts, streaming, historical, onContinueConnector, onExecutePlan, onFollowContinuation, partProps, }: {
+export declare const MessageParts: ({ parts, streaming, historical, onContinueConnector, onExecutePlan, onFollowContinuation, partProps, onFirstResponseRendered, }: {
     /** The message's parts, file parts already removed (they render as chips). */
     readonly parts: readonly BelongMessagePart[];
     /** This message is the one a run is streaming into right now. */
@@ -39,4 +40,5 @@ export declare const MessageParts: ({ parts, streaming, historical, onContinueCo
      * the named props still wins. Absent = no goal wiring (stories, tests).
      */
     readonly partProps?: ((part: BelongMessagePart) => Partial<PartRendererProps>) | undefined;
+    readonly onFirstResponseRendered?: ((observation: FirstResponseObservation) => void) | undefined;
 }) => import("react").JSX.Element;