@belonguniverseai/react-sdk 0.6.31 → 0.6.33

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

@@ -0,0 +1,69 @@
+/**
+ * The monthly token quota's refusal notice (TS-DOCK-03, DE-QTA-10).
+ *
+ * The server renders the same four-locale table for the notice's fallback
+ * text (`quota-notice-copy.ts` in belong-cloud), and a root parity test
+ * compares the two key by key — change one, change both.
+ *
+ * Copy rules (plan 018, CLAUDE.md §42): the unit is "tokens", never
+ * "weighted" / "ponderados" / "ponderati"; the copy never names Belong; it
+ * names the tenant's product, or — when a notice carries none — no product at
+ * all ("your admin"), never a stand-in noun.
+ *
+ * The `NoDate` / `NoProduct` variants are for a notice whose `resetsAt` or
+ * `productName` is missing or unreadable (every field but `kind` is optional
+ * on the wire, SAD §9). The server always sends both with `exhausted`, so it
+ * renders only `exhausted`, `blocked`, and `scheduleSkipped` itself.
+ */
+export declare const quotaEn: {
+    readonly quota: {
+        readonly notice: {
+            readonly exhausted: "You've used this month's tokens for {{product}}. They reset on {{resetDate}}. Ask your {{product}} admin if you need more.";
+            readonly exhaustedNoDate: "You've used this month's tokens for {{product}}. Ask your {{product}} admin if you need more.";
+            readonly exhaustedNoProduct: "You've used this month's tokens. They reset on {{resetDate}}. Ask your admin if you need more.";
+            readonly exhaustedNoProductNoDate: "You've used this month's tokens. Ask your admin if you need more.";
+            readonly blocked: "Your access to the agent in {{product}} is paused. Ask your {{product}} admin to turn it back on.";
+            readonly blockedNoProduct: "Your access to the agent is paused. Ask your admin to turn it back on.";
+            readonly scheduleSkipped: "Skipped: this month's tokens are used up.";
+        };
+    };
+};
+export declare const quotaEs: {
+    readonly quota: {
+        readonly notice: {
+            readonly exhausted: "Usaste los tokens de este mes para {{product}}. Se restablecen el {{resetDate}}. Si necesitas más, pídeselo a tu administrador de {{product}}.";
+            readonly exhaustedNoDate: "Usaste los tokens de este mes para {{product}}. Si necesitas más, pídeselo a tu administrador de {{product}}.";
+            readonly exhaustedNoProduct: "Usaste los tokens de este mes. Se restablecen el {{resetDate}}. Si necesitas más, pídeselo a tu administrador.";
+            readonly exhaustedNoProductNoDate: "Usaste los tokens de este mes. Si necesitas más, pídeselo a tu administrador.";
+            readonly blocked: "Tu acceso al agente en {{product}} está en pausa. Pídele a tu administrador de {{product}} que lo reactive.";
+            readonly blockedNoProduct: "Tu acceso al agente está en pausa. Pídele a tu administrador que lo reactive.";
+            readonly scheduleSkipped: "Omitida: se agotaron los tokens de este mes.";
+        };
+    };
+};
+export declare const quotaPt: {
+    readonly quota: {
+        readonly notice: {
+            readonly exhausted: "Você usou os tokens deste mês para {{product}}. Eles são renovados em {{resetDate}}. Se precisar de mais, fale com o administrador do {{product}}.";
+            readonly exhaustedNoDate: "Você usou os tokens deste mês para {{product}}. Se precisar de mais, fale com o administrador do {{product}}.";
+            readonly exhaustedNoProduct: "Você usou os tokens deste mês. Eles são renovados em {{resetDate}}. Se precisar de mais, fale com o seu administrador.";
+            readonly exhaustedNoProductNoDate: "Você usou os tokens deste mês. Se precisar de mais, fale com o seu administrador.";
+            readonly blocked: "Seu acesso ao agente no {{product}} está pausado. Peça ao administrador do {{product}} para reativá-lo.";
+            readonly blockedNoProduct: "Seu acesso ao agente está pausado. Peça ao seu administrador para reativá-lo.";
+            readonly scheduleSkipped: "Ignorada: os tokens deste mês acabaram.";
+        };
+    };
+};
+export declare const quotaIt: {
+    readonly quota: {
+        readonly notice: {
+            readonly exhausted: "Hai usato i token di questo mese per {{product}}. Si azzerano il giorno {{resetDate}}. Se te ne servono altri, chiedi all'amministratore di {{product}}.";
+            readonly exhaustedNoDate: "Hai usato i token di questo mese per {{product}}. Se te ne servono altri, chiedi all'amministratore di {{product}}.";
+            readonly exhaustedNoProduct: "Hai usato i token di questo mese. Si azzerano il giorno {{resetDate}}. Se te ne servono altri, chiedi al tuo amministratore.";
+            readonly exhaustedNoProductNoDate: "Hai usato i token di questo mese. Se te ne servono altri, chiedi al tuo amministratore.";
+            readonly blocked: "Il tuo accesso all'agente in {{product}} è in pausa. Chiedi all'amministratore di {{product}} di riattivarlo.";
+            readonly blockedNoProduct: "Il tuo accesso all'agente è in pausa. Chiedi al tuo amministratore di riattivarlo.";
+            readonly scheduleSkipped: "Saltata: i token di questo mese sono esauriti.";
+        };
+    };
+};

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

@@ -57,10 +57,12 @@ export declare const scheduledEn: {
         readonly sharedConflict: "Someone updated this task while you were editing. Your text is still here. Copy any changes you want to keep, then reopen the editor to load the latest version.";
         readonly sharedReadOnly: "You no longer have edit access. Your unsaved changes are still here.";
         readonly templateUnavailable: "The linked HTML template could not be read. Ask the owner to restore it, then resume this task.";
+        readonly sharedOwnerUnavailable: "This shared task is unavailable right now. Resume it when its owner's workspace is back.";
         readonly cliReconnectRequired: "Simetrik couldn't be reached during this run. It reconnects on its own the next time you open Simetrik.";
         readonly deliveryFailed: "The task ran but couldn't send its result: every message or email it tried to send failed. Check that its Slack, Teams or email connection is still connected.";
         readonly cliUnavailable: "Simetrik didn't respond during this run, so nothing could be checked and no email was sent.";
         readonly emailNotPrepared: "This run ended before it finished its check, so no email was sent. Open the run to see what stopped it.";
+        readonly runIncomplete: "This run stopped before it finished, so its work may be partial. Open its conversation to see where it stopped.";
         readonly viewTitle: "Scheduled";
         readonly subtitle: "Run work automatically, even when you're away";
         readonly newTask: "New task";
@@ -73,6 +75,7 @@ export declare const scheduledEn: {
         readonly loading: "Loading scheduled tasks…";
         readonly empty: "No scheduled tasks yet";
         readonly emptyHint: "Create one to run a prompt later — once or on a repeating schedule.";
+        readonly emptyProjectHint: "Or start a project to share tasks and files with your team.";
         readonly noResults: "No matches for “{{q}}”";
         readonly loadError: "Couldn't load scheduled tasks.";
         readonly loadMore: "Load more";
@@ -127,6 +130,10 @@ export declare const scheduledEn: {
         readonly summaryDaily: "Daily at {{time}}";
         readonly summaryWeekdays: "Weekdays at {{time}}";
         readonly summaryWeekly: "Every {{day}} at {{time}}";
+        readonly recurrenceCustomWeekly: "Custom weekly";
+        readonly weekdaysLabel: "Days of the week";
+        readonly daysRequired: "Select at least one day.";
+        readonly summaryCustomWeekly: "Every {{day}} at {{time}}";
         readonly summaryInterval: "Every {{minutes}} min";
         readonly summaryManual: "Manual only";
         readonly timezoneSuffix: "({{timezone}})";
@@ -185,6 +192,7 @@ export declare const scheduledEn: {
         readonly runStatusNeedsAttention: "Needs attention";
         readonly runStatusCompleted: "Completed";
         readonly runStatusFailed: "Failed";
+        readonly runStatusStoppedEarly: "Stopped early";
         readonly runNeedsAttentionHint: "Waiting for your input.";
         readonly manualRun: "Manual run";
         readonly manualRunPaused: "Manual run while paused";
@@ -334,10 +342,12 @@ export declare const scheduledEs: {
         sharedConflict: string;
         sharedReadOnly: string;
         templateUnavailable: string;
+        sharedOwnerUnavailable: string;
         cliReconnectRequired: string;
         deliveryFailed: string;
         cliUnavailable: string;
         emailNotPrepared: string;
+        runIncomplete: string;
         viewTitle: string;
         subtitle: string;
         newTask: string;
@@ -350,6 +360,7 @@ export declare const scheduledEs: {
         loading: string;
         empty: string;
         emptyHint: string;
+        emptyProjectHint: string;
         noResults: string;
         loadError: string;
         loadMore: string;
@@ -404,6 +415,10 @@ export declare const scheduledEs: {
         summaryDaily: string;
         summaryWeekdays: string;
         summaryWeekly: string;
+        recurrenceCustomWeekly: string;
+        weekdaysLabel: string;
+        daysRequired: string;
+        summaryCustomWeekly: string;
         summaryInterval: string;
         summaryManual: string;
         timezoneSuffix: string;
@@ -462,6 +477,7 @@ export declare const scheduledEs: {
         runStatusNeedsAttention: string;
         runStatusCompleted: string;
         runStatusFailed: string;
+        runStatusStoppedEarly: string;
         runNeedsAttentionHint: string;
         manualRun: string;
         manualRunPaused: string;
@@ -611,10 +627,12 @@ export declare const scheduledPt: {
         sharedConflict: string;
         sharedReadOnly: string;
         templateUnavailable: string;
+        sharedOwnerUnavailable: string;
         cliReconnectRequired: string;
         deliveryFailed: string;
         cliUnavailable: string;
         emailNotPrepared: string;
+        runIncomplete: string;
         viewTitle: string;
         subtitle: string;
         newTask: string;
@@ -627,6 +645,7 @@ export declare const scheduledPt: {
         loading: string;
         empty: string;
         emptyHint: string;
+        emptyProjectHint: string;
         noResults: string;
         loadError: string;
         loadMore: string;
@@ -681,6 +700,10 @@ export declare const scheduledPt: {
         summaryDaily: string;
         summaryWeekdays: string;
         summaryWeekly: string;
+        recurrenceCustomWeekly: string;
+        weekdaysLabel: string;
+        daysRequired: string;
+        summaryCustomWeekly: string;
         summaryInterval: string;
         summaryManual: string;
         timezoneSuffix: string;
@@ -739,6 +762,7 @@ export declare const scheduledPt: {
         runStatusNeedsAttention: string;
         runStatusCompleted: string;
         runStatusFailed: string;
+        runStatusStoppedEarly: string;
         runNeedsAttentionHint: string;
         manualRun: string;
         manualRunPaused: string;
@@ -888,10 +912,12 @@ export declare const scheduledIt: {
         sharedConflict: string;
         sharedReadOnly: string;
         templateUnavailable: string;
+        sharedOwnerUnavailable: string;
         cliReconnectRequired: string;
         deliveryFailed: string;
         cliUnavailable: string;
         emailNotPrepared: string;
+        runIncomplete: string;
         viewTitle: string;
         subtitle: string;
         newTask: string;
@@ -904,6 +930,7 @@ export declare const scheduledIt: {
         loading: string;
         empty: string;
         emptyHint: string;
+        emptyProjectHint: string;
         noResults: string;
         loadError: string;
         loadMore: string;
@@ -958,6 +985,10 @@ export declare const scheduledIt: {
         summaryDaily: string;
         summaryWeekdays: string;
         summaryWeekly: string;
+        recurrenceCustomWeekly: string;
+        weekdaysLabel: string;
+        daysRequired: string;
+        summaryCustomWeekly: string;
         summaryInterval: string;
         summaryManual: string;
         timezoneSuffix: string;
@@ -1016,6 +1047,7 @@ export declare const scheduledIt: {
         runStatusNeedsAttention: string;
         runStatusCompleted: string;
         runStatusFailed: string;
+        runStatusStoppedEarly: string;
         runNeedsAttentionHint: string;
         manualRun: string;
         manualRunPaused: string;

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

@@ -18,8 +18,12 @@ export declare const settingsEn: {
         usageDescription: string;
         about: string;
         aboutDescription: string;
+        secrets: string;
+        secretsDescription: string;
         apiKeys: string;
         apiKeysDescription: string;
+        guide: string;
+        guideDescription: string;
         apiKeysName: string;
         apiKeysCreate: string;
         apiKeysRevoke: string;
@@ -82,8 +86,12 @@ export declare const settingsEs: {
         usageDescription: string;
         about: string;
         aboutDescription: string;
+        secrets: string;
+        secretsDescription: string;
         apiKeys: string;
         apiKeysDescription: string;
+        guide: string;
+        guideDescription: string;
         apiKeysName: string;
         apiKeysCreate: string;
         apiKeysRevoke: string;
@@ -146,8 +154,12 @@ export declare const settingsPt: {
         usageDescription: string;
         about: string;
         aboutDescription: string;
+        secrets: string;
+        secretsDescription: string;
         apiKeys: string;
         apiKeysDescription: string;
+        guide: string;
+        guideDescription: string;
         apiKeysName: string;
         apiKeysCreate: string;
         apiKeysRevoke: string;
@@ -210,8 +222,12 @@ export declare const settingsIt: {
         usageDescription: string;
         about: string;
         aboutDescription: string;
+        secrets: string;
+        secretsDescription: string;
         apiKeys: string;
         apiKeysDescription: string;
+        guide: string;
+        guideDescription: string;
         apiKeysName: string;
         apiKeysCreate: string;
         apiKeysRevoke: string;

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

@@ -208,6 +208,7 @@ export declare const streamEn: {
         readonly reconnectingBadge: "reconnecting";
         readonly incompleteTask: "Paused — unfinished";
         readonly resumingAfterPause: "Taking longer than expected — picking it back up…";
+        readonly answerBlocked: "That answer was blocked before it finished. You can start a new conversation. If it keeps happening, contact support.";
         readonly open: "Open";
         readonly reconnectRateLimited: "{{provider}} is busy — trying again automatically in {{seconds}}s.";
         readonly reconnectRateLimitedStill: "{{provider}} is still busy. We'll keep trying on our own.";
@@ -412,6 +413,7 @@ export declare const streamEs: {
         reconnectingBadge: string;
         incompleteTask: string;
         resumingAfterPause: string;
+        answerBlocked: string;
         open: string;
         reconnectRateLimited: string;
         reconnectRateLimitedStill: string;
@@ -616,6 +618,7 @@ export declare const streamPt: {
         reconnectingBadge: string;
         incompleteTask: string;
         resumingAfterPause: string;
+        answerBlocked: string;
         open: string;
         reconnectRateLimited: string;
         reconnectRateLimitedStill: string;
@@ -820,6 +823,7 @@ export declare const streamIt: {
         reconnectingBadge: string;
         incompleteTask: string;
         resumingAfterPause: string;
+        answerBlocked: string;
         open: string;
         reconnectRateLimited: string;
         reconnectRateLimitedStill: string;

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

@@ -0,0 +1,120 @@
+export declare const vaultEn: {
+    readonly vault: {
+        readonly title: "Secrets";
+        readonly description: "Save credentials for your own use across workspaces. Only their names and references are shown to the agent.";
+        readonly add: "Add secret";
+        readonly empty: "No secrets saved.";
+        readonly loading: "Loading secrets…";
+        readonly unavailable: "Secrets are unavailable here. Remove credentials from your message before sending.";
+        readonly name: "Name";
+        readonly nameHint: "Use lowercase letters, numbers and hyphens. Names cannot be changed.";
+        readonly kind: "Kind";
+        readonly apiKey: "API key";
+        readonly pem: "PEM private key";
+        readonly value: "Secret value";
+        readonly save: "Save";
+        readonly saveSecret: "Save secret";
+        readonly captureHint: "Secret detected. Save it securely; only its reference will be included in your message.";
+        readonly saving: "Saving…";
+        readonly cancel: "Cancel";
+        readonly replace: "Replace value";
+        readonly delete: "Delete";
+        readonly deleteConfirm: "Delete {{name}}? Commands using this reference will no longer work.";
+        readonly nameTaken: "That name is already in use.";
+        readonly notFound: "This secret no longer exists. Refresh and try again.";
+        readonly invalidInput: "Check the name and secret value.";
+        readonly requestFailed: "Could not update secrets. Try again.";
+        readonly forbidden: "You do not have access to secrets.";
+        readonly pasteBlocked: "This text looks like a credential. Remove it from your message and save it as a secret.";
+    };
+};
+export declare const vaultEs: {
+    vault: {
+        title: string;
+        description: string;
+        add: string;
+        empty: string;
+        loading: string;
+        unavailable: string;
+        name: string;
+        nameHint: string;
+        kind: string;
+        apiKey: string;
+        pem: string;
+        value: string;
+        save: string;
+        saveSecret: string;
+        captureHint: string;
+        saving: string;
+        cancel: string;
+        replace: string;
+        delete: string;
+        deleteConfirm: string;
+        nameTaken: string;
+        notFound: string;
+        invalidInput: string;
+        requestFailed: string;
+        forbidden: string;
+        pasteBlocked: string;
+    };
+};
+export declare const vaultPt: {
+    vault: {
+        title: string;
+        description: string;
+        add: string;
+        empty: string;
+        loading: string;
+        unavailable: string;
+        name: string;
+        nameHint: string;
+        kind: string;
+        apiKey: string;
+        pem: string;
+        value: string;
+        save: string;
+        saveSecret: string;
+        captureHint: string;
+        saving: string;
+        cancel: string;
+        replace: string;
+        delete: string;
+        deleteConfirm: string;
+        nameTaken: string;
+        notFound: string;
+        invalidInput: string;
+        requestFailed: string;
+        forbidden: string;
+        pasteBlocked: string;
+    };
+};
+export declare const vaultIt: {
+    vault: {
+        title: string;
+        description: string;
+        add: string;
+        empty: string;
+        loading: string;
+        unavailable: string;
+        name: string;
+        nameHint: string;
+        kind: string;
+        apiKey: string;
+        pem: string;
+        value: string;
+        save: string;
+        saveSecret: string;
+        captureHint: string;
+        saving: string;
+        cancel: string;
+        replace: string;
+        delete: string;
+        deleteConfirm: string;
+        nameTaken: string;
+        notFound: string;
+        invalidInput: string;
+        requestFailed: string;
+        forbidden: string;
+        pasteBlocked: string;
+    };
+};

package/dist/lib/use-tab-leadership.d.ts

@@ -2,5 +2,6 @@ import { TabRole } from './tab-leadership.ts';
 /** The persisted server id replaces a new Session's per-tab placeholder. */
 export declare const useTabLeadership: (chatId: string) => {
     readonly role: TabRole;
+    readonly ownedElsewhere: boolean;
     readonly requestControl: () => void;
 };

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

@@ -39,6 +39,11 @@ export declare const refreshNewestHistoryPage: (client: QueryClient, scope: Hist
  * and not marked stale by a turn that finished since.
  */
 export declare const peekNewestHistoryPage: (client: QueryClient, scope: HistoryScope) => LoadedHistoryPage | null;
+/**
+ * A session this dock just created has no turns, so its newest page is known
+ * without asking. Opening it paints at once, with no spinner and no read.
+ */
+export declare const seedEmptyNewestHistoryPage: (client: QueryClient, scope: HistoryScope) => void;
 /** 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. */

package/dist/routes/chat/question-parts.d.ts

@@ -0,0 +1,26 @@
+import { AnswerQuestionResult } from '../../api/questions.ts';
+import { BelongUIMessage, ChoiceRequestData } from '../../stream/belong-data-parts.ts';
+/**
+ * Plan 013 — rewrite the transcript's `data-choice-request` part for one
+ * question with its resolved shape, so the record reads exactly as it will
+ * after a reload (the history patch) without waiting for the wire; the live
+ * same-id part that follows overwrites it with the identical state. Every
+ * other message keeps its identity (no churn for the renderers).
+ */
+export declare const patchChoicePart: (messages: readonly BelongUIMessage[], resolved: ChoiceRequestData) => BelongUIMessage[];
+/**
+ * Plan 013 — Stop's local un-arm: the newest `pending` question flips to
+ * `cancelled`, exactly as the server's abort path flips its row. Walks the
+ * transcript itself rather than the derived card: X only HIDES a card in
+ * this tab, and a question hidden here is still cancelled by Stop — the
+ * record must read the same as it will after a reload (§41).
+ */
+export declare const cancelPendingQuestion: (messages: readonly BelongUIMessage[]) => BelongUIMessage[];
+/**
+ * Plan 013 — the part as the server's 409 says it settled: the row of record
+ * (another tab's answer / reply, a Stop's `cancelled`, a dismissal), which is
+ * what a reload would show — never an `answered` synthesised from nothing.
+ */
+export declare const rowOfRecord: (question: ChoiceRequestData, settled: Extract<AnswerQuestionResult, {
+    reason: "already_resolved";
+}>) => ChoiceRequestData;

package/dist/routes/chat/queued-delivery.d.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import { BelongChatTransport } from '../../stream/belong-chat-transport.ts';
+import { QuotaNoticeData } from '../../stream/belong-data-parts.ts';
+import { QueuedMessageOutboxEntry } from '../../stream/queued-message-outbox.ts';
+declare const postMessageResponseSchema: z.ZodObject<{
+    messageId: z.ZodString;
+    taskId: z.ZodString;
+    runId: z.ZodString;
+    idempotent: z.ZodBoolean;
+}, z.core.$strip>;
+type QueuedMessageAccepted = z.infer<typeof postMessageResponseSchema> & {
+    readonly kind: "accepted";
+};
+export type QueuedMessagePostOwner = {
+    readonly kind: "queued-message-post-owner";
+};
+export declare const releaseQueuedMessagePostOwner: (owner: QueuedMessagePostOwner) => void;
+export declare const persistAndPostQueuedMessage: (apiBaseUrl: string, entry: QueuedMessageOutboxEntry, owner: QueuedMessagePostOwner, onFailure: () => void, onAccepted?: (result: QueuedMessageAccepted) => void, onQuotaRefused?: (notice: QuotaNoticeData) => void) => void;
+export declare const persistNewQueuedMessage: (apiBaseUrl: string, entry: QueuedMessageOutboxEntry, owner: QueuedMessagePostOwner, replayedIds: Set<string>, onFailure: () => void, onQuotaRefused: (notice: QuotaNoticeData) => void, timingTransport?: BelongChatTransport) => void;
+export {};

package/dist/routes/chat/queued-messages.d.ts

@@ -0,0 +1,15 @@
+import { BelongUIMessage, QuotaNoticeData } from '../../stream/belong-data-parts.ts';
+export type QueuedMessage = {
+    readonly clientId: string;
+    readonly text: string;
+    readonly submittedAt: number;
+} & ({
+    readonly state: "queued" | "failed";
+} | {
+    readonly state: "quota_refused";
+    readonly notice: QuotaNoticeData;
+});
+export declare const queuedTurnHasReply: (history: readonly BelongUIMessage[], text: string) => boolean;
+export declare const dropQueuedLandedIn: (history: readonly BelongUIMessage[]) => (prev: readonly QueuedMessage[]) => readonly QueuedMessage[];
+export declare const markQueuedFailed: (clientId: string) => (prev: readonly QueuedMessage[]) => readonly QueuedMessage[];
+export declare const markQueuedQuotaRefused: (clientId: string, notice: QuotaNoticeData) => (prev: readonly QueuedMessage[]) => readonly QueuedMessage[];

package/dist/routes/chat/session-api.d.ts

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+import { ActiveRunLookup } from './use-catch-up-on-return.ts';
+import { BelongChatTransport, RecalledQueuedMessage } from '../../stream/belong-chat-transport.ts';
+type SessionApiResult = {
+    readonly ok: true;
+    readonly body: unknown;
+} | {
+    readonly ok: false;
+    readonly status: number | null;
+    readonly body: unknown;
+};
+export declare const sessionApiFetch: (apiBaseUrl: string, sessionId: string, path: "messages" | "compact" | "clear" | "active-run", init?: RequestInit, query?: URLSearchParams) => Promise<SessionApiResult>;
+declare const activeRunResponseSchema: z.ZodUnion<readonly [z.ZodNull, z.ZodObject<{
+    runId: z.ZodString;
+    status: z.ZodEnum<{
+        queued: "queued";
+        waiting_for_approval: "waiting_for_approval";
+        running: "running";
+        waiting_for_user: "waiting_for_user";
+        waiting_for_ui_action: "waiting_for_ui_action";
+        recovering: "recovering";
+        cancelling: "cancelling";
+    }>;
+}, z.core.$strip>]>;
+type ActiveRunInfo = z.infer<typeof activeRunResponseSchema>;
+export declare const loadActiveRun: (apiBaseUrl: string, sessionId: string) => Promise<ActiveRunInfo>;
+export declare const lookUpActiveRun: (apiBaseUrl: string, sessionId: string) => Promise<ActiveRunLookup>;
+export declare const cancelRunForStop: (input: {
+    readonly apiBaseUrl: string;
+    readonly transport: BelongChatTransport;
+    readonly runId: string | null;
+    readonly sessionId: string | null;
+}) => Promise<readonly RecalledQueuedMessage[]>;
+type CompactOutcome = {
+    readonly status: "compacted";
+    readonly messagesCompacted: number;
+} | {
+    readonly status: "noop";
+} | {
+    readonly status: "busy";
+} | {
+    readonly status: "error";
+};
+export declare const compactSession: (apiBaseUrl: string, sessionId: string) => Promise<CompactOutcome>;
+export declare const compactNoticeText: (outcome: CompactOutcome) => string;
+type ClearOutcome = {
+    readonly status: "cleared";
+} | {
+    readonly status: "error";
+};
+export declare const clearSession: (apiBaseUrl: string, sessionId: string) => Promise<ClearOutcome>;
+export {};

package/dist/routes/chat/session-history-api.d.ts

@@ -0,0 +1,9 @@
+import { QueryClient } from '@tanstack/react-query';
+import { HistoryPageResult, HistoryScope } from './history-cache.ts';
+export declare const loadSessionHistory: (apiBaseUrl: string, sessionId: string, before?: string) => Promise<HistoryPageResult>;
+/**
+ * Read a chat's newest page ahead of opening it (the Chats list's
+ * `SessionIntentContext`), so it opens painted from the cache. A chat kept
+ * live needs no read; a page read in the last 30 s is not read again.
+ */
+export declare const prefetchChatHistory: (queryClient: QueryClient, apiBaseUrl: string, scope: HistoryScope) => void;

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

@@ -0,0 +1,45 @@
+import { BelongUIMessage } from '../../stream/belong-data-parts.ts';
+import { LoadedHistoryPage } from './history-cache.ts';
+import { HistoryPaging } from './history-paging.ts';
+export type TranscriptEvent = {
+    readonly kind: "history_restored";
+    readonly page: LoadedHistoryPage;
+    readonly onScreen: readonly BelongUIMessage[];
+} | {
+    readonly kind: "caught_up";
+    readonly page: LoadedHistoryPage;
+    readonly caughtUp: BelongUIMessage[];
+} | {
+    readonly kind: "compacted";
+    readonly page: LoadedHistoryPage;
+} | {
+    readonly kind: "quota_stopped";
+    readonly page: LoadedHistoryPage;
+} | {
+    readonly kind: "queued_reply_landed";
+    readonly history: readonly BelongUIMessage[];
+    /** Asked when React applies the update: a Clear or a new turn may come first. */
+    readonly canApply: () => boolean;
+} | {
+    readonly kind: "older_page_loaded";
+    readonly page: LoadedHistoryPage;
+    readonly expectedFirstId: string;
+} | {
+    readonly kind: "cleared";
+} | {
+    readonly kind: "unsaved_chat_cleared";
+};
+type CursorUpdate = {
+    readonly kind: "keep";
+} | {
+    readonly kind: "set";
+    readonly id: string | null;
+};
+export type TranscriptUpdate = {
+    readonly messages: BelongUIMessage[] | ((current: BelongUIMessage[]) => BelongUIMessage[]);
+    readonly paging: HistoryPaging | ((paging: HistoryPaging) => HistoryPaging) | null;
+    readonly historyThrough: CursorUpdate;
+    readonly spokenThrough: CursorUpdate;
+};
+export declare const transcriptUpdateFor: (event: TranscriptEvent) => TranscriptUpdate;
+export {};

package/dist/routes/chat/use-catch-up-on-return.d.ts

@@ -66,5 +66,12 @@ export declare const useCatchUpOnReturn: (input: {
     readonly controlRequestId?: number;
     readonly prepareControl?: (sessionId: string) => Promise<void>;
     readonly onControlReady?: (ready: boolean) => void;
+    /**
+     * This mount shows a session this tab created a moment ago. Its first
+     * promotion has nothing to catch up on, so writing is not held for the reads.
+     * Only the first: if control ever moves to another tab and back, this tab
+     * catches up like any other.
+     */
+    readonly justCreated?: boolean;
     readonly returnOptions?: Parameters<typeof useReturnToPage>[1];
 }) => void;