@belonguniverseai/react-sdk 0.1.2 → 0.1.4

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

@@ -0,0 +1,100 @@
+/** Embed misc dock strings (composer pickers, workspace tree, shell/CSV/preview
+ *  panels, attribution, dev runtime bar, avatar menu, conversation frame). */
+export declare const embedMiscEn: {
+    readonly embed: {
+        readonly yourSkills: "Your skills";
+        readonly skillsMenuLabel: "Skills";
+        readonly minimizeSkills: "Minimize skills";
+        readonly expandSkills: "Expand skills";
+        readonly workspaceFilesMenuLabel: "Workspace files";
+        readonly previewFile: "Preview {{name}}";
+        readonly downloadFile: "Download {{name}}";
+        readonly refresh: "Refresh";
+        readonly refreshWorkspaceFiles: "Refresh workspace files";
+        readonly searchWorkspace: "Search workspace…";
+        readonly searchWorkspaceFiles: "Search workspace files";
+        readonly workspaceCreateHint: "Open the terminal once to create your workspace, then refresh.";
+        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 csvEmpty: "This file is empty.";
+        readonly csvRowLimit: "Showing the first {{shown}} of {{total}} rows — download for the full file.";
+        readonly preview: "Preview";
+        readonly exitFullscreen: "Exit fullscreen";
+        readonly fullscreen: "Fullscreen";
+        readonly closePreview: "Close preview";
+        readonly nothingToPreview: "Nothing to preview yet.";
+        readonly resizePreview: "Resize preview";
+        readonly previewTruncated: "… (truncated — download for the full file)";
+        readonly noInlinePreview: "No inline preview for {{type}}.";
+        readonly thisFile: "this file";
+        readonly download: "Download";
+        readonly loadingPreview: "Loading preview…";
+        readonly poweredByBelong: "Powered by Belong";
+        readonly devDefault: "default";
+        readonly devModelIdPlaceholder: "model id (blank = env default)";
+        readonly devModelIdTitle: "Exact model id for the selected provider — overrides the env pin";
+        readonly devBadge: "dev";
+        readonly devRuntimeLabel: "runtime:";
+        readonly devModelLabel: "model (mastra):";
+        readonly closeDevMode: "Close dev mode";
+        readonly deployedAt: "deployed {{label}}";
+        readonly devOverrideActive: "Dev override active — click to change";
+        readonly micUnmuted: "Mic unmuted";
+        readonly micMuted: "Mic muted";
+        readonly agentWorking: "{{name}} is working…";
+        readonly clearChat: "Clear chat";
+        readonly clearChatTooltip: "Clear chat (the assistant keeps the full context)";
+        readonly clear: "Clear";
+        readonly stop: "Stop";
+    };
+};
+export declare const embedMiscEs: {
+    embed: {
+        yourSkills: string;
+        skillsMenuLabel: string;
+        minimizeSkills: string;
+        expandSkills: string;
+        workspaceFilesMenuLabel: string;
+        previewFile: string;
+        downloadFile: string;
+        refresh: string;
+        refreshWorkspaceFiles: string;
+        searchWorkspace: string;
+        searchWorkspaceFiles: string;
+        workspaceCreateHint: string;
+        workspaceLoadError: string;
+        workspaceNoFiles: string;
+        workspaceNoMatches: string;
+        csvEmpty: string;
+        csvRowLimit: string;
+        preview: string;
+        exitFullscreen: string;
+        fullscreen: string;
+        closePreview: string;
+        nothingToPreview: string;
+        resizePreview: string;
+        previewTruncated: string;
+        noInlinePreview: string;
+        thisFile: string;
+        download: string;
+        loadingPreview: string;
+        poweredByBelong: string;
+        devDefault: string;
+        devModelIdPlaceholder: string;
+        devModelIdTitle: string;
+        devBadge: string;
+        devRuntimeLabel: string;
+        devModelLabel: string;
+        closeDevMode: string;
+        deployedAt: string;
+        devOverrideActive: string;
+        micUnmuted: string;
+        micMuted: string;
+        agentWorking: string;
+        clearChat: string;
+        clearChatTooltip: string;
+        clear: string;
+        stop: string;
+    };
+};

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

@@ -0,0 +1,19 @@
+/** Message feedback dock strings. */
+export declare const feedbackEn: {
+    readonly feedback: {
+        readonly goodResponse: "Good response";
+        readonly badResponse: "Bad response";
+        readonly reasonPlaceholder: "What was off? (optional)";
+        readonly skip: "Skip";
+        readonly send: "Send";
+    };
+};
+export declare const feedbackEs: {
+    feedback: {
+        goodResponse: string;
+        badResponse: string;
+        reasonPlaceholder: string;
+        skip: string;
+        send: string;
+    };
+};

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

@@ -0,0 +1,75 @@
+/** Files dock strings. */
+export declare const filesEn: {
+    readonly files: {
+        readonly refreshFiles: "Refresh files";
+        readonly searchDocumentsPlaceholder: "Search documents…";
+        readonly searchDocuments: "Search documents";
+        readonly noFilesYet: "No files yet";
+        readonly noFilesHint: "Ask Belong to create some, or drop a file below.";
+        readonly uploading: "Uploading…";
+        readonly dropFilesOrBrowse: "Drop files here or browse";
+        readonly supportedTypes: "Supports PDF, DOC, MD, TXT, XLSX";
+        readonly previewFile: "Preview {{filename}}";
+        readonly downloadFile: "Download {{filename}}";
+        readonly uploadedInConversation: "Uploaded in this conversation";
+        readonly noInlinePreview: "No inline preview for {{mimeType}}.";
+        readonly download: "Download";
+        readonly loadingPreview: "Loading preview…";
+        readonly truncatedNotice: "… (truncated — download for the full file)";
+        readonly previewGenerateFailed: "Couldn't generate a preview.";
+        readonly previewTooLong: "Preview is taking too long.";
+        readonly previewUnavailable: "Can't preview this file — download it instead.";
+        readonly generatingPreview: "Generating preview…";
+        readonly pageAlt: "{{filename}} page {{page}}";
+        readonly previewOf: "Preview of {{filename}}";
+        readonly searchWorkspacePlaceholder: "Search workspace files…";
+        readonly searchWorkspace: "Search workspace files";
+        readonly workspaceFiles: "Workspace files";
+        readonly refresh: "Refresh";
+        readonly refreshWorkspaceFiles: "Refresh workspace files";
+        readonly workspaceEmpty: "No files yet — what Claude writes in your workspace shows up here.";
+        readonly noMatches: "No matches.";
+        readonly ageJustNow: "just now";
+        readonly ageMinutes: "{{count}}m ago";
+        readonly ageHours: "{{count}}h ago";
+        readonly ageDays: "{{count}}d ago";
+        readonly attachmentFallback: "attachment";
+    };
+};
+export declare const filesEs: {
+    files: {
+        refreshFiles: string;
+        searchDocumentsPlaceholder: string;
+        searchDocuments: string;
+        noFilesYet: string;
+        noFilesHint: string;
+        uploading: string;
+        dropFilesOrBrowse: string;
+        supportedTypes: string;
+        previewFile: string;
+        downloadFile: string;
+        uploadedInConversation: string;
+        noInlinePreview: string;
+        download: string;
+        loadingPreview: string;
+        truncatedNotice: string;
+        previewGenerateFailed: string;
+        previewTooLong: string;
+        previewUnavailable: string;
+        generatingPreview: string;
+        pageAlt: string;
+        previewOf: string;
+        searchWorkspacePlaceholder: string;
+        searchWorkspace: string;
+        workspaceFiles: string;
+        refresh: string;
+        refreshWorkspaceFiles: string;
+        workspaceEmpty: string;
+        noMatches: string;
+        ageJustNow: string;
+        ageMinutes: string;
+        ageHours: string;
+        ageDays: string;
+        attachmentFallback: string;
+    };
+};

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

@@ -0,0 +1,31 @@
+/** Header and rail dock strings. */
+export declare const headerEn: {
+    readonly header: {
+        readonly byBelong: "by Belong";
+        readonly navChat: "Chat";
+        readonly navFiles: "Files";
+        readonly chatPlanRunning: "Chat — plan running, {{completed}} of {{total}} steps done";
+        readonly devMode: "Dev mode";
+        readonly devModeTitle: "Dev mode (belong:dev)";
+        readonly muteReplies: "Mute replies";
+        readonly readRepliesAloud: "Read replies aloud";
+        readonly speechNotSupported: "Speech not supported";
+        readonly expand: "Expand";
+        readonly collapse: "Collapse";
+    };
+};
+export declare const headerEs: {
+    header: {
+        byBelong: string;
+        navChat: string;
+        navFiles: string;
+        chatPlanRunning: string;
+        devMode: string;
+        devModeTitle: string;
+        muteReplies: string;
+        readRepliesAloud: string;
+        speechNotSupported: string;
+        expand: string;
+        collapse: string;
+    };
+};

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

@@ -0,0 +1,17 @@
+/** Login dock strings. */
+export declare const loginEn: {
+    readonly login: {
+        readonly welcome: "Welcome to {{name}}";
+        readonly byBelong: "by Belong";
+        readonly signInPrompt: "Sign in to start chatting.";
+        readonly signIn: "Sign in";
+    };
+};
+export declare const loginEs: {
+    login: {
+        welcome: string;
+        byBelong: string;
+        signInPrompt: string;
+        signIn: string;
+    };
+};

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

@@ -0,0 +1,35 @@
+/** Plan dock strings. */
+export declare const planEn: {
+    readonly plan: {
+        readonly cueReady: "Plan ready — View";
+        readonly fallbackTitle: "Plan";
+        readonly closeLabel: "Close plan";
+        readonly emptyState: "No plan yet. Ask the agent to plan something.";
+        readonly resizeLabel: "Resize plan";
+        readonly stepCompleted: "completed";
+        readonly stepFailed: "failed";
+        readonly stepPending: "pending";
+        readonly progressDone: "done";
+        readonly failedPrefix: "Failed:";
+        readonly failedHelp: "Tell me what to do";
+        readonly approveAndRun: "Approve & run";
+        readonly reject: "Reject";
+    };
+};
+export declare const planEs: {
+    plan: {
+        cueReady: string;
+        fallbackTitle: string;
+        closeLabel: string;
+        emptyState: string;
+        resizeLabel: string;
+        stepCompleted: string;
+        stepFailed: string;
+        stepPending: string;
+        progressDone: string;
+        failedPrefix: string;
+        failedHelp: string;
+        approveAndRun: string;
+        reject: string;
+    };
+};

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

@@ -0,0 +1,43 @@
+/** Sessions dock strings. */
+export declare const sessionsEn: {
+    readonly sessions: {
+        readonly chats: "Chats";
+        readonly newChat: "New chat";
+        readonly noChatsYet: "No chats yet";
+        readonly untitledChat: "Untitled chat";
+        readonly confirmDelete: "Confirm delete";
+        readonly cancelDelete: "Cancel delete";
+        readonly deleteChat: "Delete chat";
+        readonly renameChat: "Rename chat";
+        readonly chatName: "Chat name";
+        readonly saveName: "Save name";
+        readonly cancelRename: "Cancel rename";
+        readonly recentSessions: "Recent sessions";
+        readonly loading: "Loading…";
+        readonly failedToLoad: "Failed to load: {{message}}";
+        readonly noSessionsYet: "No sessions yet.";
+        readonly untitledSession: "Untitled session";
+        readonly updated: "updated";
+    };
+};
+export declare const sessionsEs: {
+    sessions: {
+        chats: string;
+        newChat: string;
+        noChatsYet: string;
+        untitledChat: string;
+        confirmDelete: string;
+        cancelDelete: string;
+        deleteChat: string;
+        renameChat: string;
+        chatName: string;
+        saveName: string;
+        cancelRename: string;
+        recentSessions: string;
+        loading: string;
+        failedToLoad: string;
+        noSessionsYet: string;
+        untitledSession: string;
+        updated: string;
+    };
+};

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

@@ -0,0 +1,144 @@
+/**
+ * Stream part-renderer strings (`src/stream/ai-sdk-part-renderers.tsx`): the
+ * cards the assistant's live stream renders — approval + choice widgets, tool
+ * activity tasks, browser step labels, consolidated terminal groups, artifact
+ * cards, and the CLI reconnect chip. Status-code badges (`ok` / `no_handler` /
+ * wire `data.status`) are technical chrome and stay verbatim, per the same
+ * rule as `embed/copy.ts`.
+ */
+export declare const streamEn: {
+    readonly stream: {
+        readonly copyOutput: "Copy output";
+        readonly terminalOutput: "terminal output";
+        readonly skillChip: "Skill: {{name}}";
+        readonly failedSuffix: " — failed";
+        readonly approvalRequired: "Approval required";
+        readonly approve: "Approve";
+        readonly requestChanges: "Request changes";
+        readonly reject: "Reject";
+        readonly approving: "Approving…";
+        readonly rejecting: "Rejecting…";
+        readonly sending: "Sending…";
+        readonly decisionApproved: "approved";
+        readonly decisionRejected: "rejected";
+        readonly decisionAmendRequested: "amend requested";
+        readonly expired: "expired";
+        readonly alreadyResolved: "already resolved";
+        readonly alwaysAllowTool: "Always allow {{toolName}}";
+        readonly alwaysAllowAction: "Always allow this action";
+        readonly submitError: "That didn't go through — {{message}}. Try again.";
+        readonly errorServerAnswered: "the server answered {{status}}";
+        readonly errorRequestUnreachable: "the request didn't reach the server";
+        readonly answered: "answered";
+        readonly alreadyAnswered: "already answered";
+        readonly submit: "Submit";
+        readonly toolShellRunning: "Running a command";
+        readonly toolShellDone: "Ran a command";
+        readonly toolShellFailed: "A command didn't complete";
+        readonly toolShellDetail: "Executed a command in the workspace.";
+        readonly toolApprovalRunning: "Requesting approval";
+        readonly toolApprovalDone: "Requested approval";
+        readonly toolApprovalFailed: "Couldn't request approval";
+        readonly toolApprovalDetail: "Asked for your approval to proceed.";
+        readonly toolGenericRunning: "Working on {{tool}}";
+        readonly toolGenericDone: "Finished {{tool}}";
+        readonly toolGenericFailed: "{{tool}} didn't complete";
+        readonly toolGenericDetail: "Used the {{tool}} capability.";
+        readonly browserSnapshot: "Took a snapshot";
+        readonly browserRead: "Read the page";
+        readonly browserClick: "Clicked an element";
+        readonly browserType: "Typed text";
+        readonly browserNavigate: "Opened a page";
+        readonly browserSelfTest: "Checked the page connection";
+        readonly browserResolveResource: "Looked up a resource";
+        readonly browserAwaitProcessed: "Waited for processing";
+        readonly browserAssertCreated: "Checked for an existing resource";
+        readonly failedBadge: "failed";
+        readonly failedCount_one: "{{count}} failed";
+        readonly failedCount_other: "{{count}} failed";
+        readonly workedOnPageSteps_one: "Worked on the page · {{count}} step";
+        readonly workedOnPageSteps_other: "Worked on the page · {{count}} steps";
+        readonly workedSteps_one: "Worked · {{count}} step";
+        readonly workedSteps_other: "Worked · {{count}} steps";
+        readonly workingSteps_one: "Working… · {{count}} step";
+        readonly workingSteps_other: "Working… · {{count}} steps";
+        readonly ranCommands_one: "Ran {{count}} command";
+        readonly ranCommands_other: "Ran {{count}} commands";
+        readonly runningCommands_one: "Running {{count}} command…";
+        readonly runningCommands_other: "Running {{count}} commands…";
+        readonly open: "Open";
+        readonly reconnectNeeded: "The {{provider}} session needs reconnecting to continue.";
+        readonly reconnect: "Reconnect";
+        readonly reconnecting: "Reconnecting…";
+        readonly reconnected: "Reconnected";
+        readonly retry: "Retry";
+    };
+};
+export declare const streamEs: {
+    stream: {
+        copyOutput: string;
+        terminalOutput: string;
+        skillChip: string;
+        failedSuffix: string;
+        approvalRequired: string;
+        approve: string;
+        requestChanges: string;
+        reject: string;
+        approving: string;
+        rejecting: string;
+        sending: string;
+        decisionApproved: string;
+        decisionRejected: string;
+        decisionAmendRequested: string;
+        expired: string;
+        alreadyResolved: string;
+        alwaysAllowTool: string;
+        alwaysAllowAction: string;
+        submitError: string;
+        errorServerAnswered: string;
+        errorRequestUnreachable: string;
+        answered: string;
+        alreadyAnswered: string;
+        submit: string;
+        toolShellRunning: string;
+        toolShellDone: string;
+        toolShellFailed: string;
+        toolShellDetail: string;
+        toolApprovalRunning: string;
+        toolApprovalDone: string;
+        toolApprovalFailed: string;
+        toolApprovalDetail: string;
+        toolGenericRunning: string;
+        toolGenericDone: string;
+        toolGenericFailed: string;
+        toolGenericDetail: string;
+        browserSnapshot: string;
+        browserRead: string;
+        browserClick: string;
+        browserType: string;
+        browserNavigate: string;
+        browserSelfTest: string;
+        browserResolveResource: string;
+        browserAwaitProcessed: string;
+        browserAssertCreated: string;
+        failedBadge: string;
+        failedCount_one: string;
+        failedCount_other: string;
+        workedOnPageSteps_one: string;
+        workedOnPageSteps_other: string;
+        workedSteps_one: string;
+        workedSteps_other: string;
+        workingSteps_one: string;
+        workingSteps_other: string;
+        ranCommands_one: string;
+        ranCommands_other: string;
+        runningCommands_one: string;
+        runningCommands_other: string;
+        open: string;
+        reconnectNeeded: string;
+        reconnect: string;
+        reconnecting: string;
+        reconnected: string;
+        retry: string;
+    };
+};

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

@@ -0,0 +1,21 @@
+/** Usage meter dock strings. */
+export declare const usageEn: {
+    readonly usage: {
+        readonly tooltip: "Auto-compacts at {{chars}} chars; {{tokens}} tokens used this session";
+        readonly context: "Context {{pct}}%";
+        readonly tokens: "{{count}} tokens";
+        readonly lastTurn: "Last turn: {{in}} in / {{out}} out";
+        readonly turnsThisSessionOne: "{{count}} turn this session";
+        readonly turnsThisSessionOther: "{{count}} turns this session";
+    };
+};
+export declare const usageEs: {
+    usage: {
+        tooltip: string;
+        context: string;
+        tokens: string;
+        lastTurn: string;
+        turnsThisSessionOne: string;
+        turnsThisSessionOther: string;
+    };
+};

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

@@ -0,0 +1,10 @@
+/**
+ * The shape every locale catalog must satisfy: the SAME key structure as the
+ * English source of truth (`en.ts`), but with every leaf widened to a free
+ * `string`. Typing `es` as `LocaleMessages<typeof en>` makes a forgotten
+ * translation a COMPILE error (missing key) instead of a silent runtime
+ * fallback — without locking each value to the English literal.
+ */
+export type LocaleMessages<T> = {
+    readonly [K in keyof T]: T[K] extends string ? string : LocaleMessages<T[K]>;
+};

package/dist/routes/chat.d.ts

@@ -23,6 +23,7 @@ export type QueuedMessage = {
     readonly clientId: string;
     readonly text: string;
     readonly submittedAt: number;
+    readonly state: "queued" | "failed";
 };
 export declare const ChatRoute: ({ sessionId }?: {
     sessionId?: string;

package/dist/stream/ai-sdk-part-renderers.d.ts

@@ -2,8 +2,9 @@ import { BelongDataParts, BelongUIMessage, SandboxCommandData, ToolCallData } fr
 export declare const ToolActivityGroup: ({ tools }: {
     readonly tools: readonly ToolCallData[];
 }) => import("react").JSX.Element;
-export declare const TerminalTaskGroup: ({ commands, }: {
+export declare const TerminalTaskGroup: ({ commands, turnStreaming, }: {
     readonly commands: readonly TerminalCommand[];
+    readonly turnStreaming?: boolean;
 }) => import("react").JSX.Element;
 /** A segment of a message's text: prose to render as markdown, or a `@`-mention. */
 type TextSegment = {
@@ -30,6 +31,13 @@ export type PartRendererProps = {
      * omits it while a run streams so the CTA can't double-submit).
      */
     readonly onExecutePlan?: (() => void) | undefined;
+    /**
+     * The part belongs to a restored-history message (`metadata.fromHistory`,
+     * stamped by `loadSessionHistory`). The dispatch renderers (navigation,
+     * ui_action, cli-reconnect) render settled and never re-fire their one-shot
+     * side effects. Absent/false = live part, dispatch as usual.
+     */
+    readonly historical?: boolean | undefined;
 };
 /**
  * The AI SDK's `UIMessagePart` union is open at the patch-version
@@ -38,7 +46,7 @@ export type PartRendererProps = {
  * `BelongDataParts` (above) plus the SDK's built-in `text` and
  * `reasoning` parts.
  */
-export declare const PartRenderer: ({ part, onExecutePlan }: PartRendererProps) => import("react").JSX.Element | null;
+export declare const PartRenderer: ({ part, onExecutePlan, historical }: PartRendererProps) => import("react").JSX.Element | null;
 /** One shell command paired with its (same-id) sandbox output, if any. */
 export type TerminalCommand = {
     readonly command: ToolCallData;

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

@@ -1,6 +1,34 @@
 import { z } from 'zod';
 import { ChatTransport, UIMessageChunk } from 'ai';
 import { BelongUIMessage, WireStreamPart } from './belong-data-parts.ts';
+declare const cancelRunResponseSchema: z.ZodObject<{
+    recalledMessages: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        messageId: z.ZodString;
+        clientMessageId: z.ZodNullable<z.ZodString>;
+        text: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        clientMessageId: string | null;
+        text: string;
+        messageId: string;
+    }, {
+        clientMessageId: string | null;
+        text: string;
+        messageId: string;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    recalledMessages: {
+        clientMessageId: string | null;
+        text: string;
+        messageId: string;
+    }[];
+}, {
+    recalledMessages?: {
+        clientMessageId: string | null;
+        text: string;
+        messageId: string;
+    }[] | undefined;
+}>;
+export type RecalledQueuedMessage = z.infer<typeof cancelRunResponseSchema>["recalledMessages"][number];
 /**
  * The wire/stored part union. Exported so the history loader (chat.tsx) can
  * validate persisted assistant parts against the SAME shapes the live stream
@@ -652,6 +680,14 @@ export type BelongChatTransportOptions = {
      * production uses `STALL_TIMEOUT_MS`.
      */
     readonly stallTimeoutMs?: number;
+    /**
+     * Workspace isolation: the host workspace this transport's session belongs
+     * to. Defaults to the CURRENT scope at construction — captured once, so a
+     * workspace-A transport still streaming after the host switched to B keeps
+     * persisting its cursor under A's key and stamping A on its requests.
+     * Tests may pin it explicitly.
+     */
+    readonly workspaceExternalId?: string | null;
 };
 export type StreamContext = {
     /** Stable id we emit on every `text-delta`. Null when no text run is open. */
@@ -682,15 +718,32 @@ export type StreamContext = {
 export declare class BelongChatTransport implements ChatTransport<BelongUIMessage> {
     #private;
     constructor(options: BelongChatTransportOptions);
+    /**
+     * The server session this transport is pinned to (adopted at construction
+     * or created on first send), or null before any exists. The queued-send
+     * path reads THIS — never the live workspace-keyed pointer — so a steering
+     * message posts to the conversation on screen even inside the scope
+     * store's poll window after a host workspace switch.
+     */
+    get sessionId(): string | null;
+    /** The construction-captured workspace (see #workspaceExternalId). */
+    get workspaceExternalId(): string | null;
     /** Drop the cached session so the next `sendMessages` creates a new one. */
     reset(): void;
     /**
      * 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
      * actually halt the agent (POST /v1/runs/:runId/cancel → run-cancel pub/sub).
+     *
+     * BEL-144 — the backend also recalls the session's queued-but-unclaimed
+     * messages so they never execute; their text is returned here for the caller
+     * to restore into the composer. Any failure (network, non-2xx, old backend
+     * without the field) collapses to an empty list — the cancel stays
+     * best-effort.
      */
-    cancelRun: (runId: string) => Promise<void>;
+    cancelRun: (runId: string) => Promise<readonly RecalledQueuedMessage[]>;
     sendMessages: ChatTransport<BelongUIMessage>["sendMessages"];
     reconnectToStream: ChatTransport<BelongUIMessage>["reconnectToStream"];
 }
 export declare const wireToUiChunks: (part: WireStreamPart, ctx: StreamContext) => readonly UIMessageChunk[];
+export {};

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

@@ -1,4 +1,5 @@
 import { UIMessage } from 'ai';
+import { BelongMessageMetadata } from './message-metadata.ts';
 /**
  * F2 — per-step execution status. Optional: absent means `pending`
  * (back-compat with plans proposed before F2 and the initial propose). The
@@ -183,11 +184,12 @@ export type BelongDataParts = {
 };
 /**
  * The concrete `UIMessage` shape the chat surface and transport speak.
- * Metadata is typed `unknown` and read defensively at use sites (e.g. the
- * user-bubble skill chip reads `metadata.skill` via a narrowing guard) — keep
- * it `unknown` so new metadata fields need no type-plumbing changes.
+ * Metadata was `unknown` until the `fromHistory` gate needed to propagate
+ * reliably — now it's the `belongMessageMetadataSchema`-inferred type, parsed
+ * once at the wire perimeter (§4) so use sites read typed fields instead of
+ * re-narrowing.
  */
-export type BelongUIMessage = UIMessage<unknown, BelongDataParts>;
+export type BelongUIMessage = UIMessage<BelongMessageMetadata, BelongDataParts>;
 /**
  * Wire shape emitted by belong-cloud's SSE adapter. This stays as a
  * separate union because the server side has not migrated to AI-SDK