@belonguniverseai/react-sdk 0.6.28 → 0.6.29

package/dist/embed/voice-prefs.d.ts

@@ -1,32 +1,20 @@
+import { PushToTalkKey } from './voice-config.ts';
+/** What the user picked in Settings: a key to hold, or push-to-talk off. */
+export type PushToTalkChoice = PushToTalkKey | "off";
+/** `useSyncExternalStore` subscribe — fires whenever the user's choice changes, in any tab. */
+export declare const subscribePushToTalkKey: (listener: () => void) => (() => void);
+/** The user's own choice, or `null` when they never chose (host default applies). */
+export declare const peekUserPushToTalkChoice: () => PushToTalkChoice | null;
+/** The key the dock actually binds — the user's choice over the host default — or `null` for none. */
+export declare const getEffectivePushToTalkKey: () => PushToTalkKey | null;
+/** `useSyncExternalStore` snapshot — the effective key (a primitive, so stable). */
+export declare const peekPushToTalkKey: () => PushToTalkKey | null;
 /**
- * User voice preferences — the per-browser push-to-talk key override and the
- * first-conversation voice hint flag.
- *
- *   Host default (voice-config `pushToTalkKey`)  ◀  user pref (localStorage)
- *
- * `voice-config.ts` carries the HOST's deployment-wide knobs (set once via
- * `configureVoice`); this module layers the END USER's own choice on top, the
- * same way `theme.ts` layers user prefs over the host theme. Components read
- * the EFFECTIVE key (user pref if set, else host default) through a tiny
- * external store (`subscribePushToTalkKey` / `peekPushToTalkKey`) so the
- * settings UI, the composer tooltip, and the dock's key handler all rebind
- * live when the user picks a new key.
- *
- * localStorage is a perimeter: the prefs bag is zod-validated on read and any
- * junk (corrupted JSON, wrong shape, storage disabled) degrades to "no pref".
+ * Persist the user's choice and notify subscribers. The value comes from a
+ * form control, so it is parsed here: anything outside the key list and "off"
+ * is ignored.
  */
-/** `useSyncExternalStore` subscribe — fires on set/clear of the user key. */
-export declare const subscribePushToTalkKey: (listener: () => void) => (() => void);
-/** The user's own override, or `null` when the host default applies. */
-export declare const peekUserPushToTalkKey: () => string | null;
-/** The key the dock actually binds: user pref if set, else the host default. */
-export declare const getEffectivePushToTalkKey: () => string;
-/** `useSyncExternalStore` snapshot — the effective key (string, so stable). */
-export declare const peekPushToTalkKey: () => string;
-/** Persist a user-chosen `KeyboardEvent.code` and notify subscribers. */
-export declare const setUserPushToTalkKey: (code: string) => void;
-/** Drop the user override (back to the host default) and notify subscribers. */
-export declare const clearUserPushToTalkKey: () => void;
+export declare const setUserPushToTalkChoice: (choice: string) => void;
 /** True once the push-to-talk hint chip was dismissed (X or first capture). */
 export declare const readVoiceHintDismissed: () => boolean;
 /** Persist the hint dismissal so it never shows again in this browser. */
@@ -46,14 +34,10 @@ export type VoiceClosedSendMode = "confirm" | "auto";
 export declare const subscribeVoiceClosedSendMode: (listener: () => void) => (() => void);
 export declare const peekVoiceClosedSendMode: () => VoiceClosedSendMode;
 export declare const setVoiceClosedSendMode: (mode: VoiceClosedSendMode) => void;
+/** Human label for a push-to-talk key: "ControlLeft" → "Left Ctrl". */
+export declare const formatKeyCode: (code: PushToTalkKey) => string;
 /**
- * Human label for a `KeyboardEvent.code`: "ControlLeft" → "Left Ctrl",
- * "KeyA" → "A", "Digit7" → "7". Codes with no friendlier reading ("Space",
- * "F1", unknown codes) pass through unchanged.
- */
-export declare const formatKeyCode: (code: string) => string;
-/**
- * Test-only: clear listeners and re-seed the user key from localStorage. The
+ * Test-only: clear listeners and re-seed the user's choice from localStorage. The
  * store is a module singleton, so unit tests reset it in `beforeEach`.
  */
 export declare const __resetVoicePrefsForTest: () => void;

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

@@ -16,7 +16,7 @@ export declare const en: {
         readonly expandComposer: "Expand message input";
         readonly collapseComposer: "Compact message input";
         readonly contextTitle: "Context for this message";
-        readonly pageNote: "Page label only; this control does not attach page contents.";
+        readonly pageNote: "The agent receives this page name with your message, not the page contents.";
         readonly removeFile: "Remove {{name}}";
         readonly closeContext: "Close context";
         readonly currentPage: "Current page";
@@ -500,6 +500,7 @@ export declare const en: {
         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 cliReconnectRequired: "Simetrik couldn't be reached during this run. It reconnects on its own the next time you open Simetrik.";
         readonly viewTitle: "Scheduled";
         readonly subtitle: "Run work automatically, even when you're away";
         readonly newTask: "New task";
@@ -523,7 +524,7 @@ export declare const en: {
         readonly nextRunIn: "Next run {{when}}";
         readonly lastRun: "Last run {{time}}";
         readonly dayAtTime: "{{day}} at {{time}}";
-        readonly pausedNotice: "Paused — runs won't start until you resume.";
+        readonly pausedNotice: "Paused — scheduled runs won't start until you resume. Run now still runs it once.";
         readonly scheduleIdLabel: "Schedule ID";
         readonly copyScheduleId: "Copy ID";
         readonly customEmailLabel: "Custom email enabled";
@@ -534,6 +535,15 @@ export declare const en: {
         readonly sharedRecipients: "Shared recipients";
         readonly sharedRecipientsHelp: "Sent only from the owner’s original task. Shared delivery pauses when that task is paused.";
         readonly errorRecipientsInvalid: "Enter valid, unique email addresses.";
+        readonly errorEmailAddressingInvalid: "This combination of shared and local email settings is invalid. Combined CC and BCC lists allow 50 addresses each; Reply-To allows 10. Extra local CC/BCC recipients need a To address that is not already covered by shared delivery.";
+        readonly emailCopiesToggle: "Add CC, BCC or Reply-To";
+        readonly emailCopiesLabel: "CC, BCC and Reply-To";
+        readonly emailCc: "CC";
+        readonly emailBcc: "BCC";
+        readonly emailReplyTo: "Reply-To";
+        readonly emailCopiesHelp: "Everyone sees the CC addresses, BCC stays hidden, and replies go to Reply-To. Separate addresses with commas.";
+        readonly sharedEmailCopies: "Shared CC, BCC and Reply-To";
+        readonly sharedEmailCopiesHelp: "Added only to the owner’s original task email, like shared recipients. Each person can also add their own.";
         readonly emailAccountRecipient: "Schedule owner's account email";
         readonly teamsDeliveryLabel: "Microsoft Teams delivery approved";
         readonly teamsStatusActive: "Active";
@@ -590,6 +600,8 @@ export declare const en: {
         readonly resumedCompleted: "Its time already passed, so this one-time task is now completed.";
         readonly runNow: "Run now";
         readonly runNowStarted: "Run started — it will appear below.";
+        readonly runPausedConfirmTitle: "Run this paused task now?";
+        readonly runPausedConfirmBody: "This task is paused. It will run once now, including its emails, and stay paused.";
         readonly edit: "Edit";
         readonly delete: "Delete";
         readonly deleteConfirmTitle: "Delete this scheduled task?";
@@ -608,6 +620,7 @@ export declare const en: {
         readonly runStatusFailed: "Failed";
         readonly runNeedsAttentionHint: "Waiting for your input.";
         readonly manualRun: "Manual run";
+        readonly manualRunPaused: "Manual run while paused";
         readonly openRun: "Open this run's conversation";
         readonly detailLoadError: "Couldn't load this scheduled task.";
         readonly detailGone: "This scheduled task no longer exists.";
@@ -624,6 +637,7 @@ export declare const en: {
         readonly progressDone: "done";
         readonly failedPrefix: "Failed:";
         readonly failedHelp: "Tell me what to do";
+        readonly runThisPlan: "Run this plan";
         readonly approveAndRun: "Approve & run";
         readonly reject: "Reject";
     };
@@ -799,6 +813,9 @@ export declare const en: {
         readonly issueReport: {
             readonly open: "Send feedback";
             readonly title: "Send feedback";
+            readonly sdkVersion: "SDK version";
+            readonly sessionId: "Session ID";
+            readonly copyDetails: "Copy report details";
             readonly placeholder: "Describe the issue";
             readonly includesWithShot: "This report includes a screenshot of the current screen and technical details of your session.";
             readonly includesNoShot: "This report includes technical details of your session.";
@@ -1278,6 +1295,7 @@ export declare const en: {
     readonly conversation: {
         readonly thinking: "Thinking…";
         readonly followerBanner: "This conversation is open in another tab";
+        readonly useThisTab: "Use this tab";
         readonly historyUnavailable: "Couldn't load this conversation — try reopening it.";
         readonly showEarlierMessages: "Show earlier messages";
     };
@@ -1326,6 +1344,7 @@ export declare const en: {
         readonly refusal: {
             readonly existsTitle: "This chat already has a goal.";
             readonly existsBody: "One goal at a time — this one is still running.";
+            readonly existsBodyUnfinished: "One goal at a time — this one isn't finished yet.";
             readonly existsOpen: "Open it";
             readonly existsReplace: "Clear it and set this one";
             readonly disabledTitle: "Goals aren't turned on here yet.";
@@ -1343,6 +1362,13 @@ export declare const en: {
         };
         readonly edited: "Goal updated.";
         readonly revived: "Goal updated and resumed — the assistant will pick it up now.";
+        readonly stillStopped: {
+            readonly budget: "Goal updated, but it's still stopped: its budget is {{cap}} and it has already used {{used}}. To restart it, send /goal budget with a number above {{used}}.";
+            readonly turns: "Goal updated, but it's still stopped: its turn limit is {{cap}} and it has already used {{used}}. To restart it, send /goal turns with a number above {{used}}.";
+            readonly budgetAndTurns: "Goal updated, but it's still stopped: its budget is {{tokenBudget}} and it has already used {{tokensUsed}}; its turn limit is {{maxTurns}} and it has already used {{turnsUsed}}. To restart it, send /goal budget with a number above {{tokensUsed}} and /goal turns with a number above {{turnsUsed}}.";
+            readonly time: "Goal updated, but it's still stopped: it ran for as long as it was allowed, and that limit can't be raised. To keep chatting here, clear it with /goal clear — you can start a new goal after that.";
+            readonly generic: "Goal updated, but it's still stopped: every limit it reached has to go above what it has already used before it can restart.";
+        };
         readonly notEditable: "The goal can no longer be edited.";
         readonly editUsage: "Use /goal edit <objective>, /goal turns <number> or /goal budget <tokens>.";
         readonly status: "Goal · {{status}} · turn {{turnsUsed}} of {{maxTurns}} — {{objective}}";

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

@@ -9,6 +9,9 @@ export declare const feedbackEn: {
         readonly issueReport: {
             readonly open: "Send feedback";
             readonly title: "Send feedback";
+            readonly sdkVersion: "SDK version";
+            readonly sessionId: "Session ID";
+            readonly copyDetails: "Copy report details";
             readonly placeholder: "Describe the issue";
             readonly includesWithShot: "This report includes a screenshot of the current screen and technical details of your session.";
             readonly includesNoShot: "This report includes technical details of your session.";
@@ -39,6 +42,9 @@ export declare const feedbackEs: {
         issueReport: {
             open: string;
             title: string;
+            sdkVersion: string;
+            sessionId: string;
+            copyDetails: string;
             placeholder: string;
             includesWithShot: string;
             includesNoShot: string;
@@ -69,6 +75,9 @@ export declare const feedbackPt: {
         issueReport: {
             open: string;
             title: string;
+            sdkVersion: string;
+            sessionId: string;
+            copyDetails: string;
             placeholder: string;
             includesWithShot: string;
             includesNoShot: string;
@@ -99,6 +108,9 @@ export declare const feedbackIt: {
         issueReport: {
             open: string;
             title: string;
+            sdkVersion: string;
+            sessionId: string;
+            copyDetails: string;
             placeholder: string;
             includesWithShot: string;
             includesNoShot: string;

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

@@ -12,6 +12,7 @@ export declare const planEn: {
         readonly progressDone: "done";
         readonly failedPrefix: "Failed:";
         readonly failedHelp: "Tell me what to do";
+        readonly runThisPlan: "Run this plan";
         readonly approveAndRun: "Approve & run";
         readonly reject: "Reject";
     };
@@ -30,6 +31,7 @@ export declare const planEs: {
         failedPrefix: string;
         failedHelp: string;
         approveAndRun: string;
+        runThisPlan: string;
         reject: string;
     };
 };
@@ -47,6 +49,7 @@ export declare const planPt: {
         failedPrefix: string;
         failedHelp: string;
         approveAndRun: string;
+        runThisPlan: string;
         reject: string;
     };
 };
@@ -64,6 +67,7 @@ export declare const planIt: {
         failedPrefix: string;
         failedHelp: string;
         approveAndRun: string;
+        runThisPlan: string;
         reject: string;
     };
 };

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

@@ -57,6 +57,7 @@ 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 cliReconnectRequired: "Simetrik couldn't be reached during this run. It reconnects on its own the next time you open Simetrik.";
         readonly viewTitle: "Scheduled";
         readonly subtitle: "Run work automatically, even when you're away";
         readonly newTask: "New task";
@@ -80,7 +81,7 @@ export declare const scheduledEn: {
         readonly nextRunIn: "Next run {{when}}";
         readonly lastRun: "Last run {{time}}";
         readonly dayAtTime: "{{day}} at {{time}}";
-        readonly pausedNotice: "Paused — runs won't start until you resume.";
+        readonly pausedNotice: "Paused — scheduled runs won't start until you resume. Run now still runs it once.";
         readonly scheduleIdLabel: "Schedule ID";
         readonly copyScheduleId: "Copy ID";
         readonly customEmailLabel: "Custom email enabled";
@@ -91,6 +92,15 @@ export declare const scheduledEn: {
         readonly sharedRecipients: "Shared recipients";
         readonly sharedRecipientsHelp: "Sent only from the owner’s original task. Shared delivery pauses when that task is paused.";
         readonly errorRecipientsInvalid: "Enter valid, unique email addresses.";
+        readonly errorEmailAddressingInvalid: "This combination of shared and local email settings is invalid. Combined CC and BCC lists allow 50 addresses each; Reply-To allows 10. Extra local CC/BCC recipients need a To address that is not already covered by shared delivery.";
+        readonly emailCopiesToggle: "Add CC, BCC or Reply-To";
+        readonly emailCopiesLabel: "CC, BCC and Reply-To";
+        readonly emailCc: "CC";
+        readonly emailBcc: "BCC";
+        readonly emailReplyTo: "Reply-To";
+        readonly emailCopiesHelp: "Everyone sees the CC addresses, BCC stays hidden, and replies go to Reply-To. Separate addresses with commas.";
+        readonly sharedEmailCopies: "Shared CC, BCC and Reply-To";
+        readonly sharedEmailCopiesHelp: "Added only to the owner’s original task email, like shared recipients. Each person can also add their own.";
         readonly emailAccountRecipient: "Schedule owner's account email";
         readonly teamsDeliveryLabel: "Microsoft Teams delivery approved";
         readonly teamsStatusActive: "Active";
@@ -147,6 +157,8 @@ export declare const scheduledEn: {
         readonly resumedCompleted: "Its time already passed, so this one-time task is now completed.";
         readonly runNow: "Run now";
         readonly runNowStarted: "Run started — it will appear below.";
+        readonly runPausedConfirmTitle: "Run this paused task now?";
+        readonly runPausedConfirmBody: "This task is paused. It will run once now, including its emails, and stay paused.";
         readonly edit: "Edit";
         readonly delete: "Delete";
         readonly deleteConfirmTitle: "Delete this scheduled task?";
@@ -165,6 +177,7 @@ export declare const scheduledEn: {
         readonly runStatusFailed: "Failed";
         readonly runNeedsAttentionHint: "Waiting for your input.";
         readonly manualRun: "Manual run";
+        readonly manualRunPaused: "Manual run while paused";
         readonly openRun: "Open this run's conversation";
         readonly detailLoadError: "Couldn't load this scheduled task.";
         readonly detailGone: "This scheduled task no longer exists.";
@@ -228,6 +241,7 @@ export declare const scheduledEs: {
         sharedConflict: string;
         sharedReadOnly: string;
         templateUnavailable: string;
+        cliReconnectRequired: string;
         viewTitle: string;
         subtitle: string;
         newTask: string;
@@ -262,6 +276,15 @@ export declare const scheduledEs: {
         sharedRecipients: string;
         sharedRecipientsHelp: string;
         errorRecipientsInvalid: string;
+        errorEmailAddressingInvalid: string;
+        emailCopiesToggle: string;
+        emailCopiesLabel: string;
+        emailCc: string;
+        emailBcc: string;
+        emailReplyTo: string;
+        emailCopiesHelp: string;
+        sharedEmailCopies: string;
+        sharedEmailCopiesHelp: string;
         emailAccountRecipient: string;
         teamsDeliveryLabel: string;
         teamsStatusActive: string;
@@ -318,6 +341,8 @@ export declare const scheduledEs: {
         resumedCompleted: string;
         runNow: string;
         runNowStarted: string;
+        runPausedConfirmTitle: string;
+        runPausedConfirmBody: string;
         edit: string;
         delete: string;
         deleteConfirmTitle: string;
@@ -336,6 +361,7 @@ export declare const scheduledEs: {
         runStatusFailed: string;
         runNeedsAttentionHint: string;
         manualRun: string;
+        manualRunPaused: string;
         openRun: string;
         detailLoadError: string;
         detailGone: string;
@@ -399,6 +425,7 @@ export declare const scheduledPt: {
         sharedConflict: string;
         sharedReadOnly: string;
         templateUnavailable: string;
+        cliReconnectRequired: string;
         viewTitle: string;
         subtitle: string;
         newTask: string;
@@ -433,6 +460,15 @@ export declare const scheduledPt: {
         sharedRecipients: string;
         sharedRecipientsHelp: string;
         errorRecipientsInvalid: string;
+        errorEmailAddressingInvalid: string;
+        emailCopiesToggle: string;
+        emailCopiesLabel: string;
+        emailCc: string;
+        emailBcc: string;
+        emailReplyTo: string;
+        emailCopiesHelp: string;
+        sharedEmailCopies: string;
+        sharedEmailCopiesHelp: string;
         emailAccountRecipient: string;
         teamsDeliveryLabel: string;
         teamsStatusActive: string;
@@ -489,6 +525,8 @@ export declare const scheduledPt: {
         resumedCompleted: string;
         runNow: string;
         runNowStarted: string;
+        runPausedConfirmTitle: string;
+        runPausedConfirmBody: string;
         edit: string;
         delete: string;
         deleteConfirmTitle: string;
@@ -507,6 +545,7 @@ export declare const scheduledPt: {
         runStatusFailed: string;
         runNeedsAttentionHint: string;
         manualRun: string;
+        manualRunPaused: string;
         openRun: string;
         detailLoadError: string;
         detailGone: string;
@@ -570,6 +609,7 @@ export declare const scheduledIt: {
         sharedConflict: string;
         sharedReadOnly: string;
         templateUnavailable: string;
+        cliReconnectRequired: string;
         viewTitle: string;
         subtitle: string;
         newTask: string;
@@ -604,6 +644,15 @@ export declare const scheduledIt: {
         sharedRecipients: string;
         sharedRecipientsHelp: string;
         errorRecipientsInvalid: string;
+        errorEmailAddressingInvalid: string;
+        emailCopiesToggle: string;
+        emailCopiesLabel: string;
+        emailCc: string;
+        emailBcc: string;
+        emailReplyTo: string;
+        emailCopiesHelp: string;
+        sharedEmailCopies: string;
+        sharedEmailCopiesHelp: string;
         emailAccountRecipient: string;
         teamsDeliveryLabel: string;
         teamsStatusActive: string;
@@ -660,6 +709,8 @@ export declare const scheduledIt: {
         resumedCompleted: string;
         runNow: string;
         runNowStarted: string;
+        runPausedConfirmTitle: string;
+        runPausedConfirmBody: string;
         edit: string;
         delete: string;
         deleteConfirmTitle: string;
@@ -678,6 +729,7 @@ export declare const scheduledIt: {
         runStatusFailed: string;
         runNeedsAttentionHint: string;
         manualRun: string;
+        manualRunPaused: string;
         openRun: string;
         detailLoadError: string;
         detailGone: string;

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

@@ -4,7 +4,7 @@ export declare const usageEn: {
         readonly expandComposer: "Expand message input";
         readonly collapseComposer: "Compact message input";
         readonly contextTitle: "Context for this message";
-        readonly pageNote: "Page label only; this control does not attach page contents.";
+        readonly pageNote: "The agent receives this page name with your message, not the page contents.";
         readonly removeFile: "Remove {{name}}";
         readonly closeContext: "Close context";
         readonly currentPage: "Current page";

package/dist/lib/tab-control-store.d.ts

@@ -0,0 +1,14 @@
+/** Live ownership shared by the composer and the browser-control channel. */
+export type TabOwnership = {
+    readonly term: number;
+    readonly tabId: string;
+};
+export type TabControlSnapshot = {
+    readonly role: "pending" | "leader" | "follower";
+    readonly owner: TabOwnership | null;
+};
+export declare const peekTabControl: (sessionId: string) => TabControlSnapshot;
+export declare const subscribeTabControl: (listener: () => void) => (() => void);
+export declare const publishTabControl: (sessionId: string, snapshot: TabControlSnapshot) => void;
+/** A departing controller must not clear a newer controller's snapshot. */
+export declare const clearTabControl: (sessionId: string, snapshot: TabControlSnapshot) => void;

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

@@ -1,26 +1,9 @@
-/**
- * Multi-tab same-session guard (plan 007 §C5).
- *
- * Two dock tabs open on ONE session can double-send and clobber the persisted
- * `{ runId, lastEventId }` stream state. This module elects a single LEADER
- * tab per session over a `BroadcastChannel` (`belong:session:<sessionId>`);
- * follower tabs banner "open in another tab" and disable the composer.
- *
- * Protocol (all messages Zod-parsed at the perimeter — §4):
- *   - on start every tab broadcasts a `claim` carrying `{ tabId, claimedAtMs }`
- *   - seniority = the EARLIER claim; equal timestamps tie-break on tabId
- *   - the leader heartbeats every ~5 s and re-asserts when a junior claims
- *   - a tab that hears a senior claim/heartbeat becomes follower
- *   - a follower takes over when no senior beat lands for ~12 s, or
- *     immediately on the leader's `release` (stop / pagehide)
- *
- * Feature detection: no `BroadcastChannel` (older WebKit, jsdom) → guard
- * disabled, the tab stays leader, zero behavior change.
- */
+import { TabControlSnapshot } from './tab-control-store.ts';
 export type TabRole = "leader" | "follower";
 export declare const HEARTBEAT_INTERVAL_MS = 5000;
 export declare const TAKEOVER_TIMEOUT_MS = 12000;
-/** The narrow `BroadcastChannel` surface the guard uses (injectable for tests). */
+/** Allow the channel's asynchronous discovery replies to arrive before claiming. */
+export declare const DISCOVERY_INTERVAL_MS = 150;
 export type LeadershipChannel = {
     postMessage: (message: unknown) => void;
     close: () => void;
@@ -30,17 +13,19 @@ export type LeadershipChannel = {
 };
 export type TabLeadershipOptions = {
     readonly sessionId: string;
-    /** Fired on every role CHANGE (the caller assumes "leader" until told). */
-    readonly onRoleChange: (role: TabRole) => void;
+    readonly onChange: (snapshot: TabControlSnapshot) => void;
     readonly heartbeatIntervalMs?: number;
     readonly takeoverTimeoutMs?: number;
-    /** Channel seam; return `null` for "unsupported" (guard disabled). */
+    readonly discoveryIntervalMs?: number;
     readonly createChannel?: (name: string) => LeadershipChannel | null;
-    /** Clock seam (§25). */
     readonly nowMs?: () => number;
+    /** Separate browser realms have separate page identities; injectable in tests. */
+    readonly tabId?: string;
 };
 export type TabLeadershipHandle = {
     readonly stop: () => void;
+    readonly requestControl: () => void;
+    readonly getSnapshot: () => TabControlSnapshot;
 };
 export declare const tabLeadershipChannelName: (sessionId: string) => string;
 export declare const startTabLeadership: (options: TabLeadershipOptions) => TabLeadershipHandle;

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

@@ -1,8 +1,6 @@
 import { TabRole } from './tab-leadership.ts';
-/**
- * @param chatId The mount-time chat id — the persisted server session if one
- *   was already known at mount, else a per-tab `belong-chat-<nanoid>`
- *   placeholder. Used only as the channel key until the real server session id
- *   is persisted.
- */
-export declare const useTabLeadership: (chatId: string) => TabRole;
+/** The persisted server id replaces a new Session's per-tab placeholder. */
+export declare const useTabLeadership: (chatId: string) => {
+    readonly role: TabRole;
+    readonly requestControl: () => void;
+};

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

@@ -0,0 +1,53 @@
+import { BelongUIMessage } from '../../stream/belong-data-parts.ts';
+/**
+ * Merge freshly-fetched server history with whatever is CURRENTLY on screen
+ * (§41 — a history load must never make a message the user is looking at
+ * disappear). Server order is authoritative; any LOCAL-ONLY message — most
+ * often the optimistic turn a concurrent send appended after this fetch
+ * started — survives, appended AFTER the server-ordered messages rather than
+ * lost to the replace.
+ *
+ * What is on screen above the page stays above it: the page lines up on the
+ * first of its rows found on screen (`isRowOf`, so a turn this tab streamed
+ * live lines up too), then back over the earlier rows of the page.
+ *
+ * Dedupe prefers the row id, then the client id the row was sent with. A
+ * message with no id match yet falls back to `(role, flattened text)`. Only
+ * the suffix AFTER the last server-known on-screen message can be local-only.
+ * Within that suffix, an assistant at the same next position as a durable
+ * assistant is the same historical turn with stream-vs-folded whitespace/part
+ * drift, not a new reply. A genuinely live assistant is preserved when
+ * durable history has no assistant at that position yet.
+ */
+export declare const mergeRestoredHistory: (loaded: readonly BelongUIMessage[], onScreen: readonly BelongUIMessage[]) => BelongUIMessage[];
+/**
+ * A kept chat shows every turn it streamed. The server's newest page holds
+ * something it never saw only when it has a user turn that is not on screen:
+ * one sent from another tab or device (the reply to it comes with it).
+ *
+ * Turns are matched one to one, by their row id or the client id they were
+ * sent with, so a prompt repeated elsewhere ("continue", or two files-only
+ * turns with no text) is still a new turn. Text is only a fallback for a row
+ * that carries no client id, matched in order against the turns on screen
+ * that no id accounted for.
+ */
+export declare const hasUnseenTurns: (loaded: readonly BelongUIMessage[], onScreen: readonly BelongUIMessage[]) => boolean;
+/**
+ * #839 — what an IDLE chat shows once the reader comes back to it, given the
+ * newest page read just now: the conversation a reload would show (§41),
+ * without the reload. Null when the page brings nothing the screen lacks, so
+ * a return with nothing new leaves every message — and every card — as it is.
+ *
+ * - The page lines up with the screen (some message on screen is one of its
+ *   rows): the turns added elsewhere are merged in after what is on screen,
+ *   exactly as a mount merges its read (`mergeRestoredHistory`) — no
+ *   duplicates, server order, older pages above it and anything only this
+ *   tab holds kept.
+ * - Nothing on screen is on the page: the conversation moved past a whole
+ *   page while this tab was away, or was cleared elsewhere and went on. What
+ *   is on screen is from before the page, so the page replaces it, as a
+ *   reload would; scrolling up loads what came before it.
+ * - An empty page never empties the screen: a chat cleared in another tab
+ *   reads empty after the next reload, but a return alone wipes nothing.
+ */
+export declare const catchUpTranscript: (page: readonly BelongUIMessage[], onScreen: readonly BelongUIMessage[]) => BelongUIMessage[] | null;

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

@@ -38,16 +38,35 @@ export declare const withoutOlderPages: <T extends {
 export declare const olderHistoryCursor: (paging: HistoryPaging, messages: readonly {
     readonly id: string;
 }[]) => string | undefined;
+/** Where a walk back over a page stands: page row and on-screen message. */
+export type PageRowPlace = {
+    readonly pageIndex: number;
+    readonly screenIndex: number;
+};
+/** How a page's rows are told apart on screen (see {@link splitOlderPrefix}). */
+export type PageRowMatch<R, T> = {
+    /** `message` IS `row`. Anchors the page on screen. */
+    readonly isRow: (row: R, message: T) => boolean;
+    /** `message`, on screen right above where the page lines up so far, stands
+     * for `row`, an earlier page row; `at` says where both are. */
+    readonly isSameTurn: (row: R, message: T, at: PageRowPlace) => boolean;
+};
 /**
- * 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).
+ * What a newest-page re-read must leave alone: whatever is on screen ABOVE
+ * the page (older pages the reader scrolled in, turns from before it). The
+ * page's first row found on screen anchors it; walking back from there, each
+ * earlier page row takes the message right above while that message stands
+ * for it, and the first one that does not ends the walk: what is above it
+ * stays where it is, even if that shows a message the page also holds. An
+ * extra message reads better than a wrong pairing. Nothing when no row of the
+ * page is on screen (it is merged as a whole). By default rows match by id
+ * only; the chat's merge passes its own rules.
  */
-export declare const splitOlderPrefix: <T extends {
+export declare const splitOlderPrefix: <R extends {
     readonly id: string;
-}>(loaded: readonly {
+}, T extends {
     readonly id: string;
-}[], current: readonly T[]) => {
+}>(loaded: readonly R[], current: readonly T[], match?: PageRowMatch<R, T>) => {
     readonly older: readonly T[];
     readonly rest: readonly T[];
 };