@belonguniverseai/react-sdk 0.6.23 → 0.6.25

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

@@ -3,7 +3,7 @@ export declare const en: {
         readonly newItem: "New: {{title}}";
         readonly close: "Close";
         readonly download: "Download";
-        readonly shownByBelong: "Shown by Belong";
+        readonly shownBy: "Shown by {{name}}";
         readonly openedByYou: "You opened this";
         readonly planTitle: "Plan";
         readonly subagentsFilterAll: "All {{count}}";
@@ -15,22 +15,12 @@ export declare const en: {
     readonly usage: {
         readonly expandComposer: "Expand message input";
         readonly collapseComposer: "Compact message input";
-        readonly filesShort_one: "{{count}} file";
-        readonly filesShort_other: "{{count}} files";
         readonly contextTitle: "Context for this message";
-        readonly filesToSend: "Files to send";
-        readonly attachedFiles_one: "{{count}} file attached";
-        readonly attachedFiles_other: "{{count}} files attached";
-        readonly filesNote: "These files will be sent with your next message.";
-        readonly emptyFiles: "Attach files to include them in your next message.";
         readonly pageNote: "Page label only; this control does not attach page contents.";
         readonly removeFile: "Remove {{name}}";
         readonly closeContext: "Close context";
         readonly currentPage: "Current page";
-        readonly tooltip: "Auto-compacts at {{chars}} chars; {{tokens}} tokens used this session";
         readonly windowTooltip: "Context window: {{used}} of {{window}} tokens used ({{pct}}%)";
-        readonly context: "Context {{pct}}%";
-        readonly tokens: "{{count}} tokens";
         readonly inOut: "Input {{in}} · output {{out}}";
         readonly turnsThisSessionOne: "{{count}} turn this session";
         readonly turnsThisSessionOther: "{{count}} turns this session";
@@ -45,10 +35,12 @@ export declare const en: {
             };
             readonly freeSpace: "Free space";
             readonly estimateNote: "Breakdown is estimated; the total is as reported by the model.";
-            readonly sessionTokens: "{{tokens}} tokens this session";
             readonly cacheLine: "Cache: {{read}} read · {{write}} written";
             readonly autoCompact: "Auto-compact: {{pct}}% of budget";
         };
+        readonly compactionLabel: "Auto-compact: {{used}} of {{limit}} characters used ({{pct}}%)";
+        readonly chatTotal: "Used in this chat: {{tokens}} tokens";
+        readonly chatTotalNote: "Each reply re-reads the chat, so this grows faster than the context window.";
     };
     readonly stream: {
         readonly toolExecutionError: "The tool could not complete. Please try again.";
@@ -306,6 +298,22 @@ export declare const en: {
         readonly deleteDescription: "{{name}} will be removed, and the assistant will stop using it in this workspace.";
         readonly deleteConfirm: "Delete";
         readonly deleting: "Deleting…";
+        readonly viewEdit: "View and edit";
+        readonly editIntro: "The instructions the assistant follows. Changing the name at the top renames the skill.";
+        readonly editTextAria: "Instructions for {{name}}";
+        readonly editFiles: "Also in this skill:";
+        readonly editLoading: "Opening this skill…";
+        readonly editLoadError: "Couldn't open this skill.";
+        readonly editSave: "Save";
+        readonly editSaving: "Saving…";
+        readonly editStale: "This skill changed since you opened it. Reload to get the latest version — your unsaved changes will be lost.";
+        readonly editContentReserved: "These instructions copy one of your company's skills, so they can't be saved as your own.";
+        readonly editReload: "Reload";
+        readonly editNameTaken: "You already have a skill named {{name}}.";
+        readonly editRenameHint: "Change the name at the top and try again.";
+        readonly editInvalid: "This isn't a valid skill yet — check the name and description lines at the top.";
+        readonly editTooLong: "These instructions are too long. Shorten them and try again.";
+        readonly editFailed: "Couldn't save your changes. Try again.";
     };
     readonly settings: {
         title: string;
@@ -1119,6 +1127,7 @@ export declare const en: {
         readonly thinking: "Thinking…";
         readonly followerBanner: "This conversation is open in another tab";
         readonly historyUnavailable: "Couldn't load this conversation — try reopening it.";
+        readonly showEarlierMessages: "Show earlier messages";
     };
     readonly compaction: {
         readonly compacted: "Compacted {{count}} earlier messages into a summary.";

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

@@ -1,6 +1,6 @@
 /**
  * Skills rail surface (skill library spec §11): the list, the inline on/off
- * switch, download/delete, and the upload dialog.
+ * switch, download/delete, the upload dialog, and the View / Edit dialog.
  *
  * Copy names the PRODUCT only (§42): never SKILL.md, bundle, sandbox,
  * frontmatter, archive or workspace plumbing. File extensions are the one
@@ -10,8 +10,12 @@
  * Keep navigation, the `/` menu, dialogs and activity labels consistent.
  *
  * Nothing here is phrased as breakage: a failed toggle, download or delete is
- * an ordinary moment rendered orange (§42); only a refused upload inside the
- * dialog is red.
+ * an ordinary moment rendered orange (§42); only a refused upload or edit
+ * inside its dialog is red.
+ *
+ * The edit copy points at the lines the user can SEE in the editor: in es/pt/it
+ * the `name` / `description` line keys stay in English, because that is what
+ * the instructions literally say.
  */
 export declare const skillsEn: {
     readonly skills: {
@@ -82,6 +86,22 @@ export declare const skillsEn: {
         readonly deleteDescription: "{{name}} will be removed, and the assistant will stop using it in this workspace.";
         readonly deleteConfirm: "Delete";
         readonly deleting: "Deleting…";
+        readonly viewEdit: "View and edit";
+        readonly editIntro: "The instructions the assistant follows. Changing the name at the top renames the skill.";
+        readonly editTextAria: "Instructions for {{name}}";
+        readonly editFiles: "Also in this skill:";
+        readonly editLoading: "Opening this skill…";
+        readonly editLoadError: "Couldn't open this skill.";
+        readonly editSave: "Save";
+        readonly editSaving: "Saving…";
+        readonly editStale: "This skill changed since you opened it. Reload to get the latest version — your unsaved changes will be lost.";
+        readonly editContentReserved: "These instructions copy one of your company's skills, so they can't be saved as your own.";
+        readonly editReload: "Reload";
+        readonly editNameTaken: "You already have a skill named {{name}}.";
+        readonly editRenameHint: "Change the name at the top and try again.";
+        readonly editInvalid: "This isn't a valid skill yet — check the name and description lines at the top.";
+        readonly editTooLong: "These instructions are too long. Shorten them and try again.";
+        readonly editFailed: "Couldn't save your changes. Try again.";
     };
 };
 export declare const skillsEs: {
@@ -153,6 +173,22 @@ export declare const skillsEs: {
         deleteDescription: string;
         deleteConfirm: string;
         deleting: string;
+        viewEdit: string;
+        editIntro: string;
+        editTextAria: string;
+        editFiles: string;
+        editLoading: string;
+        editLoadError: string;
+        editSave: string;
+        editSaving: string;
+        editStale: string;
+        editContentReserved: string;
+        editReload: string;
+        editNameTaken: string;
+        editRenameHint: string;
+        editInvalid: string;
+        editTooLong: string;
+        editFailed: string;
     };
 };
 export declare const skillsPt: {
@@ -224,6 +260,22 @@ export declare const skillsPt: {
         deleteDescription: string;
         deleteConfirm: string;
         deleting: string;
+        viewEdit: string;
+        editIntro: string;
+        editTextAria: string;
+        editFiles: string;
+        editLoading: string;
+        editLoadError: string;
+        editSave: string;
+        editSaving: string;
+        editStale: string;
+        editContentReserved: string;
+        editReload: string;
+        editNameTaken: string;
+        editRenameHint: string;
+        editInvalid: string;
+        editTooLong: string;
+        editFailed: string;
     };
 };
 export declare const skillsIt: {
@@ -295,5 +347,21 @@ export declare const skillsIt: {
         deleteDescription: string;
         deleteConfirm: string;
         deleting: string;
+        viewEdit: string;
+        editIntro: string;
+        editTextAria: string;
+        editFiles: string;
+        editLoading: string;
+        editLoadError: string;
+        editSave: string;
+        editSaving: string;
+        editStale: string;
+        editContentReserved: string;
+        editReload: string;
+        editNameTaken: string;
+        editRenameHint: string;
+        editInvalid: string;
+        editTooLong: string;
+        editFailed: string;
     };
 };

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

@@ -3,22 +3,12 @@ export declare const usageEn: {
     readonly usage: {
         readonly expandComposer: "Expand message input";
         readonly collapseComposer: "Compact message input";
-        readonly filesShort_one: "{{count}} file";
-        readonly filesShort_other: "{{count}} files";
         readonly contextTitle: "Context for this message";
-        readonly filesToSend: "Files to send";
-        readonly attachedFiles_one: "{{count}} file attached";
-        readonly attachedFiles_other: "{{count}} files attached";
-        readonly filesNote: "These files will be sent with your next message.";
-        readonly emptyFiles: "Attach files to include them in your next message.";
         readonly pageNote: "Page label only; this control does not attach page contents.";
         readonly removeFile: "Remove {{name}}";
         readonly closeContext: "Close context";
         readonly currentPage: "Current page";
-        readonly tooltip: "Auto-compacts at {{chars}} chars; {{tokens}} tokens used this session";
         readonly windowTooltip: "Context window: {{used}} of {{window}} tokens used ({{pct}}%)";
-        readonly context: "Context {{pct}}%";
-        readonly tokens: "{{count}} tokens";
         readonly inOut: "Input {{in}} · output {{out}}";
         readonly turnsThisSessionOne: "{{count}} turn this session";
         readonly turnsThisSessionOther: "{{count}} turns this session";
@@ -33,32 +23,24 @@ export declare const usageEn: {
             };
             readonly freeSpace: "Free space";
             readonly estimateNote: "Breakdown is estimated; the total is as reported by the model.";
-            readonly sessionTokens: "{{tokens}} tokens this session";
             readonly cacheLine: "Cache: {{read}} read · {{write}} written";
             readonly autoCompact: "Auto-compact: {{pct}}% of budget";
         };
+        readonly compactionLabel: "Auto-compact: {{used}} of {{limit}} characters used ({{pct}}%)";
+        readonly chatTotal: "Used in this chat: {{tokens}} tokens";
+        readonly chatTotalNote: "Each reply re-reads the chat, so this grows faster than the context window.";
     };
 };
 export declare const usageEs: {
     usage: {
         expandComposer: string;
         collapseComposer: string;
-        filesShort_one: string;
-        filesShort_other: string;
         contextTitle: string;
-        filesToSend: string;
-        attachedFiles_one: string;
-        attachedFiles_other: string;
-        filesNote: string;
-        emptyFiles: string;
         pageNote: string;
         removeFile: string;
         closeContext: string;
         currentPage: string;
-        tooltip: string;
         windowTooltip: string;
-        context: string;
-        tokens: string;
         inOut: string;
         turnsThisSessionOne: string;
         turnsThisSessionOther: string;
@@ -73,32 +55,24 @@ export declare const usageEs: {
             };
             freeSpace: string;
             estimateNote: string;
-            sessionTokens: string;
             cacheLine: string;
             autoCompact: string;
         };
+        compactionLabel: string;
+        chatTotal: string;
+        chatTotalNote: string;
     };
 };
 export declare const usagePt: {
     usage: {
         expandComposer: string;
         collapseComposer: string;
-        filesShort_one: string;
-        filesShort_other: string;
         contextTitle: string;
-        filesToSend: string;
-        attachedFiles_one: string;
-        attachedFiles_other: string;
-        filesNote: string;
-        emptyFiles: string;
         pageNote: string;
         removeFile: string;
         closeContext: string;
         currentPage: string;
-        tooltip: string;
         windowTooltip: string;
-        context: string;
-        tokens: string;
         inOut: string;
         turnsThisSessionOne: string;
         turnsThisSessionOther: string;
@@ -113,32 +87,24 @@ export declare const usagePt: {
             };
             freeSpace: string;
             estimateNote: string;
-            sessionTokens: string;
             cacheLine: string;
             autoCompact: string;
         };
+        compactionLabel: string;
+        chatTotal: string;
+        chatTotalNote: string;
     };
 };
 export declare const usageIt: {
     usage: {
         expandComposer: string;
         collapseComposer: string;
-        filesShort_one: string;
-        filesShort_other: string;
         contextTitle: string;
-        filesToSend: string;
-        attachedFiles_one: string;
-        attachedFiles_other: string;
-        filesNote: string;
-        emptyFiles: string;
         pageNote: string;
         removeFile: string;
         closeContext: string;
         currentPage: string;
-        tooltip: string;
         windowTooltip: string;
-        context: string;
-        tokens: string;
         inOut: string;
         turnsThisSessionOne: string;
         turnsThisSessionOther: string;
@@ -153,9 +119,11 @@ export declare const usageIt: {
             };
             freeSpace: string;
             estimateNote: string;
-            sessionTokens: string;
             cacheLine: string;
             autoCompact: string;
         };
+        compactionLabel: string;
+        chatTotal: string;
+        chatTotalNote: string;
     };
 };

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

@@ -1,11 +1,13 @@
 /** Fullscreen workspace pane strings (spec 2026-09-02). §42: the copy names the
- *  product only — "Belong" — never the pane, the agent, or the dock. */
+ *  product only, never the pane or the dock. `shownBy`'s `{{name}}` is the
+ *  tenant's agent identity (`useAgentIdentity`: "Simetrik agent", "Belong
+ *  agent", or a custom brand), so a Simetrik user is never told "Belong". */
 export declare const workspaceEn: {
     readonly workspace: {
         readonly newItem: "New: {{title}}";
         readonly close: "Close";
         readonly download: "Download";
-        readonly shownByBelong: "Shown by Belong";
+        readonly shownBy: "Shown by {{name}}";
         readonly openedByYou: "You opened this";
         readonly planTitle: "Plan";
         readonly subagentsFilterAll: "All {{count}}";
@@ -20,7 +22,7 @@ export declare const workspaceEs: {
         newItem: string;
         close: string;
         download: string;
-        shownByBelong: string;
+        shownBy: string;
         openedByYou: string;
         planTitle: string;
         subagentsFilterAll: string;
@@ -35,7 +37,7 @@ export declare const workspacePt: {
         newItem: string;
         close: string;
         download: string;
-        shownByBelong: string;
+        shownBy: string;
         openedByYou: string;
         planTitle: string;
         subagentsFilterAll: string;
@@ -50,7 +52,7 @@ export declare const workspaceIt: {
         newItem: string;
         close: string;
         download: string;
-        shownByBelong: string;
+        shownBy: string;
         openedByYou: string;
         planTitle: string;
         subagentsFilterAll: string;

package/dist/lib/remembered-state.d.ts

@@ -0,0 +1,9 @@
+export type RememberedState<T> = {
+    /** `useState`, remembered under `key` across unmounts. */
+    readonly useRemembered: (key: string | undefined, initial: T) => readonly [T, (next: T) => void];
+    readonly peek: (key: string) => T | undefined;
+    readonly set: (key: string, value: T) => void;
+    readonly reset: () => void;
+};
+/** One typed store. `maxEntries` bounds a long page's memory; the oldest go first. */
+export declare const createRememberedState: <T>(maxEntries?: number) => RememberedState<T>;

package/dist/lib/use-remembered-disclosure.d.ts

@@ -0,0 +1,2 @@
+export declare const useRememberedDisclosure: (key: string | undefined, defaultOpen: boolean) => readonly [boolean, (open: boolean) => void];
+export declare const __resetRememberedDisclosuresForTest: () => void;

package/dist/routes/chat/draft-updaters.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `setDraft` updaters for ChatRoute's programmatic draft writers, moved out of
+ * `routes/chat.tsx` verbatim (decomposition ratchet: the route file must not
+ * grow). Module-level so the route's callbacks stay within the
+ * function-nesting limit.
+ *
+ * (BEL-255 note: these writers used to be seed-aware, stripping an untouched
+ * welcome seed before appending. The welcome question is now a GHOST
+ * suggestion the composer paints over an EMPTY draft — it never lives in the
+ * draft string — so every programmatic writer composes onto user text only.)
+ */
+/** BEL-144 — appends recalled queued-message texts under whatever the user
+ *  already typed, newline-separated (handleStop's restore). */
+export declare const appendTextsToDraft: (texts: readonly string[]) => (prev: string) => string;
+/** Dictation append (open surface + closed-surface confirm mode). */
+export declare const appendDictationToDraft: (text: string) => (prev: string) => string;

package/dist/routes/chat/history-cache.d.ts

@@ -0,0 +1,47 @@
+import { QueryClient } from '@tanstack/react-query';
+import { BelongUIMessage } from '../../stream/belong-data-parts.ts';
+import { HistoryPageRead } from './history-paging.ts';
+export type LoadedHistoryPage = HistoryPageRead<BelongUIMessage>;
+export type HistoryPageResult = ({
+    readonly ok: true;
+} & LoadedHistoryPage) | {
+    readonly ok: false;
+    readonly reason: "network" | "bad_status" | "bad_body" | "not_found";
+};
+/** Which chat a page belongs to. `workspaceKey`: the scoped id, or "". */
+export type HistoryScope = {
+    readonly workspaceKey: string;
+    readonly sessionId: string;
+};
+/** A newest page read this recently is still good for a prefetch. */
+export declare const PREFETCHED_PAGE_MAX_AGE_MS = 30000;
+/**
+ * A page read this recently is the server's answer already: a chat opened
+ * right after the Chats list read it ahead (the pointer rested on its row)
+ * isn't read twice.
+ */
+export declare const JUST_READ_MS = 2000;
+/**
+ * Read one page through the cache: the newest (`before` undefined) or the one
+ * `before` names. `maxAgeMs` is how old a cached copy may be and still be
+ * returned without asking the server; 0 always asks, sharing a read already in
+ * flight.
+ */
+export declare const readHistoryPage: (client: QueryClient, scope: HistoryScope, before: string | undefined, load: () => Promise<HistoryPageResult>, maxAgeMs: number) => Promise<HistoryPageResult>;
+/**
+ * Read the newest page from the server now, never joining a read already in
+ * flight (it may predate what the caller is waiting for: a turn that just
+ * ended), and keep what it returns.
+ */
+export declare const refreshNewestHistoryPage: (client: QueryClient, scope: HistoryScope, load: () => Promise<HistoryPageResult>) => Promise<HistoryPageResult>;
+/**
+ * The newest page as the cache holds it, when it may be painted: read before,
+ * and not marked stale by a turn that finished since.
+ */
+export declare const peekNewestHistoryPage: (client: QueryClient, scope: HistoryScope) => LoadedHistoryPage | null;
+/** A turn finished: the cached newest page no longer holds the chat's end. */
+export declare const markNewestHistoryPageStale: (client: QueryClient, scope: HistoryScope) => void;
+/** Drop every cached page of one chat (deleted), in any workspace. */
+export declare const forgetSessionHistory: (client: QueryClient, sessionId: string) => void;
+/** Drop every cached page (sign-out). */
+export declare const forgetHistoryCache: (client: QueryClient) => void;

package/dist/routes/chat/history-paging.d.ts

@@ -0,0 +1,61 @@
+import { SessionUsageBaseline } from '../../stream/select-session-usage.ts';
+/** Turns per history page: a few screens, and a small read even when tool-heavy. */
+export declare const HISTORY_PAGE_MESSAGES = 30;
+export type HistoryPaging = {
+    /** A loaded page's first message id → the cursor of the page before it. */
+    readonly olderCursorByFirstMessageId: ReadonlyMap<string, string>;
+    /**
+     * Messages an OLDER page brought in (scrolled to, not opened on). What they
+     * hold is history to read: an unanswered question there must not re-arm the
+     * question card mid-scroll — it stays answerable from its record.
+     */
+    readonly olderPageMessageIds: ReadonlySet<string>;
+    /**
+     * The chat's usage total from the latest NEWEST-page read — the baseline
+     * `selectSessionUsage` adds live turns to. Undefined until a read carried one
+     * (an older server never does).
+     */
+    readonly sessionUsage: SessionUsageBaseline | null | undefined;
+};
+export declare const NO_HISTORY_PAGING: HistoryPaging;
+export type HistoryPageRead<T extends {
+    readonly id: string;
+} = {
+    readonly id: string;
+}> = {
+    readonly messages: readonly T[];
+    /** The next older page's cursor; null once this page reached the start. */
+    readonly before: string | null;
+    readonly sessionUsage: SessionUsageBaseline | null | undefined;
+};
+/** Remember a page just read; `newest` reads also refresh the usage baseline. */
+export declare const recordHistoryPage: (paging: HistoryPaging, page: HistoryPageRead, newest: boolean) => HistoryPaging;
+/** The conversation without what older pages brought in (see `olderPageMessageIds`). */
+export declare const withoutOlderPages: <T extends {
+    readonly id: string;
+}>(paging: HistoryPaging, messages: readonly T[]) => readonly T[];
+/** The cursor of the page before the first message on screen, if there is one. */
+export declare const olderHistoryCursor: (paging: HistoryPaging, messages: readonly {
+    readonly id: string;
+}[]) => string | undefined;
+/**
+ * What a newest-page re-read must leave alone: the older pages the reader
+ * scrolled in ABOVE it. Found by the page's first row id; nothing when the
+ * page does not line up with the screen (then it is merged as a whole).
+ */
+export declare const splitOlderPrefix: <T extends {
+    readonly id: string;
+}>(loaded: readonly {
+    readonly id: string;
+}[], current: readonly T[]) => {
+    readonly older: readonly T[];
+    readonly rest: readonly T[];
+};
+/**
+ * Put an older page above the conversation. Unless the conversation changed
+ * while it was fetched (a clear, a re-read that no longer lines up): then the
+ * page is dropped, and the next scroll-up fetches the right one.
+ */
+export declare const prependHistoryPage: <T extends {
+    readonly id: string;
+}>(older: readonly T[], current: T[], expectedFirstId: string) => T[];

package/dist/routes/chat/kept-chats.d.ts

@@ -0,0 +1,39 @@
+import { Chat } from '@ai-sdk/react';
+import { DataUIPart } from 'ai';
+import { BelongChatTransport } from '../../stream/belong-chat-transport.ts';
+import { BelongDataParts, BelongUIMessage } from '../../stream/belong-data-parts.ts';
+import { HistoryPaging } from './history-paging.ts';
+/** What the mount showing a chat does with its events. */
+export type LiveChatHandlers = {
+    readonly onError: (error: Error) => void;
+    readonly onData: (part: DataUIPart<BelongDataParts>) => void;
+};
+export type LiveChat = {
+    readonly chat: Chat<BelongUIMessage>;
+    readonly transport: BelongChatTransport;
+    /**
+     * Route the chat's events to the mount showing it, until the returned
+     * release. Errors with no mount to show them are dropped: the chat keeps its
+     * `error` state for the next mount. Data parts keep reaching the last mount's
+     * handler, so a schedule a background turn creates still refreshes the list.
+     */
+    readonly show: (handlers: LiveChatHandlers) => () => void;
+    readonly isShown: () => boolean;
+    /** The older pages the chat's messages hold, so a mount taking it back keeps scrolling up from there. */
+    readonly paging: () => HistoryPaging;
+    readonly keepPaging: (paging: HistoryPaging) => void;
+    /**
+     * When each live message was first seen: its clock until history carries
+     * one. Kept with the chat so taking it back doesn't restamp every live turn.
+     */
+    readonly seenAtMs: Map<string, number>;
+};
+/** The chat kept for a session, whatever state it is in. */
+export declare const peekKeptChat: (workspaceKey: string, sessionId: string) => LiveChat | null;
+/** Keep `live` as the session's chat, the most recently used. */
+export declare const keepLiveChat: (workspaceKey: string, sessionId: string, live: LiveChat) => void;
+/** Drop a session's kept chat (deleted, or cleared elsewhere), in any workspace. */
+export declare const forgetLiveChat: (sessionId: string) => void;
+/** Drop every kept chat (sign-out, or the dock unmounting). */
+export declare const forgetLiveChats: () => void;
+export declare const __resetKeptChatsForTest: () => void;

package/dist/routes/chat/live-chats.d.ts

@@ -0,0 +1,14 @@
+import { BelongChatTransport } from '../../stream/belong-chat-transport.ts';
+import { BelongUIMessage } from '../../stream/belong-data-parts.ts';
+import { HistoryPaging } from './history-paging.ts';
+import { LiveChat } from './kept-chats.ts';
+export declare const createLiveChat: (input: {
+    readonly id: string;
+    readonly transport: BelongChatTransport;
+    readonly messages?: readonly BelongUIMessage[];
+    readonly paging?: HistoryPaging;
+    /** A request finished (a turn ended, or its stream closed). */
+    readonly onFinish: () => void;
+}) => LiveChat;
+/** The chat kept for a session, when it can be shown as it is. Reads only — safe during render. */
+export declare const findLiveChat: (workspaceKey: string, sessionId: string) => LiveChat | null;

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

@@ -0,0 +1,4 @@
+import { BelongUIMessage } from '../../stream/belong-data-parts.ts';
+/** Newest messages always mounted. */
+export declare const PINNED_TAIL_MESSAGES = 2;
+export declare const transcriptPinnedIds: (messages: readonly BelongUIMessage[]) => ReadonlySet<string>;

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

@@ -0,0 +1,49 @@
+import { ComponentProps, ReactNode } from 'react';
+import { BelongUIMessage } from '../../stream/belong-data-parts.ts';
+import { MessageParts } from '../../stream/message-parts.tsx';
+import { PartRendererExtraPropsInput } from './part-renderer-extra-props.ts';
+/** Separates the part keys in {@link TranscriptRowProps.goalSetPartKeys}. */
+export declare const GOAL_SET_KEY_SEPARATOR = "\n";
+/**
+ * The route-level wiring every row shares. `ChatRoute` memoizes it, and each
+ * field is stable while nothing it describes changes — a streamed chunk or a
+ * keystroke leaves it untouched, so settled rows skip their render.
+ */
+export type TranscriptRowWiring = {
+    /** A run is streaming (any message) — gates the plan/goal CTAs. */
+    readonly isStreaming: boolean;
+    readonly lastUserMessageIndex: number;
+    /** The session the feedback route is scoped to; `null` hides the feedback row. */
+    readonly feedbackSessionId: string | null;
+    /** The message's display time (server-stamped, or first seen live). */
+    readonly messageTime: (message: BelongUIMessage) => number;
+    readonly onFollowContinuation: ComponentProps<typeof MessageParts>["onFollowContinuation"];
+    readonly continueConnectorFor: PartRendererExtraPropsInput["continueConnectorFor"];
+    readonly onExecutePlan: () => void;
+    readonly hasLiveGoal: boolean;
+    readonly goalDoor: PartRendererExtraPropsInput["goalDoor"];
+    readonly onOpenGoalView: (() => void) | undefined;
+    readonly goalFileCount: number;
+    readonly onGoalSchedule: (command: string) => void;
+    readonly onGoalGetFiles: (() => void) | undefined;
+    readonly onGoalStartAnother: () => void;
+};
+export type TranscriptRowProps = {
+    readonly message: BelongUIMessage;
+    /** This message's index in the FULL conversation (not the render window). */
+    readonly index: number;
+    /** The run is streaming into THIS message. */
+    readonly streaming: boolean;
+    /**
+     * This message's "Goal set" receipt keys (`<messageId>:<partId>`), joined by
+     * {@link GOAL_SET_KEY_SEPARATOR}: a string, so an unchanged receipt keeps
+     * the memo even though the session-wide set is rebuilt on every update.
+     */
+    readonly goalSetPartKeys: string;
+    /** The user message that started the session's goal ("Sent as goal"). */
+    readonly sentAsGoal: boolean;
+    /** The refused `/goal` card — only on the message it answers, else `null`. */
+    readonly goalRefusalCard: ReactNode;
+    readonly wiring: TranscriptRowWiring;
+};
+export declare const TranscriptRow: import('react').NamedExoticComponent<TranscriptRowProps>;

package/dist/routes/chat/use-session-goal.d.ts

@@ -38,7 +38,12 @@ export type StartGoalInput = {
  * which is normally one the user already settled. Prefer an explicitly pending
  * card; otherwise take the last.
  */
-export declare const scrollAndFocusPendingCard: (kind: PendingCardKind) => void;
+export declare const scrollAndFocusPendingCard: (kind: PendingCardKind, 
+/**
+ * Where to look: the dock's root. In production that is a SHADOW root,
+ * which `document.querySelectorAll` cannot see into.
+ */
+root?: ParentNode) => void;
 /** Every prop `<GoalComposeSheet>` takes — named once so `composeSheet` and
  *  `goalDoor.composeSheet` below don't have to repeat the shape. */
 type GoalComposeSheetProps = {