@llblab/pi-kit 0.29.1 → 0.30.0

package/node_modules/@llblab/pi-telegram/dist/lib/replies.js

@@ -4,9 +4,9 @@
  * Owns native assistant replies, rendered UI delivery, guest placeholder rotation, reply transport wiring, and plain text replies
  */
 import { assertTelegramInlineKeyboardCallbackData } from "./keyboard.js";
-import { getTelegramTargetThreadParams, } from "./target.js";
-import { isTelegramApiCommitUnknownError } from "./telegram-api.js";
 import { renderTelegramMessage, } from "./rendering.js";
+import { getTelegramTargetThreadParams, } from "./target.js";
+import { assertTelegramApiCallAuthority, isTelegramApiCommitUnknownError, TelegramApiAuthorityError, } from "./telegram-api.js";
 export { renderTelegramMessage, };
 export function renderTelegramMarkdownToHtmlDraft(markdown) {
     return renderTelegramMessage(markdown, { mode: "markdown" })
@@ -15,21 +15,6 @@ export function renderTelegramMarkdownToHtmlDraft(markdown) {
 }
 export const TELEGRAM_RICH_MESSAGE_MAX_CHARS = 32768;
 export const TELEGRAM_RICH_MESSAGE_MAX_BLOCKS = 500;
-export function createReplyDedupRuntime() {
-    const replied = new Map();
-    return {
-        shouldReply(promptMessageId) {
-            if (replied.has(promptMessageId))
-                return false;
-            replied.set(promptMessageId, true);
-            return true;
-        },
-        reset() {
-            replied.clear();
-        },
-    };
-}
-// --- Transport-level dedup ---
 const lastRepliedToMessageIdByTarget = new Map();
 const replyDedupPreservedOnNextReset = new Map();
 let replyDedupGeneration = 0;
@@ -80,9 +65,11 @@ export async function withTelegramReplyParameters(chatId, messageId, target, sen
         return await send(parameters);
     }
     catch (error) {
-        if (parameters && !isTelegramApiCommitUnknownError(error)
-            && generation === replyDedupGeneration
-            && lastRepliedToMessageIdByTarget.get(key) === messageId) {
+        if (parameters &&
+            !isTelegramApiCommitUnknownError(error) &&
+            !(error instanceof TelegramApiAuthorityError && error.requestIssued) &&
+            generation === replyDedupGeneration &&
+            lastRepliedToMessageIdByTarget.get(key) === messageId) {
             if (previous === undefined)
                 lastRepliedToMessageIdByTarget.delete(key);
             else
@@ -172,32 +159,49 @@ export function buildTelegramReplyTransport(deps) {
     };
 }
 export async function sendTelegramRenderedChunks(chatId, chunks, deps, options) {
-    assertTelegramInlineKeyboardCallbackData(options?.replyMarkup);
+    return sendTelegramChunkSequence(chatId, chunks, options?.replyToMessageId, options, deps.recordOwnership, (chunk, fields, callOptions) => deps.sendMessage({
+        chat_id: chatId,
+        text: chunk.text,
+        parse_mode: chunk.parseMode,
+        ...fields,
+    }, callOptions));
+}
+/**
+ * Ordered chunk delivery: only the first chunk replies, only the last carries markup, and authority is rechecked
+ * before issuance and after every response/ownership publication.
+ */
+async function sendTelegramChunkSequence(chatId, chunks, replyToMessageId, options, recordOwnership, send) {
+    const target = options?.target && { ...options.target }, assertAuthority = options?.assertAuthority, replyMarkup = options?.replyMarkup;
+    assertTelegramInlineKeyboardCallbackData(replyMarkup);
     let lastMessageId;
     for (const [index, chunk] of chunks.entries()) {
-        const sent = await withTelegramReplyParameters(chatId, index === 0 ? options?.replyToMessageId : undefined, options?.target, (replyParameters) => deps.sendMessage({
-            chat_id: chatId,
-            text: chunk.text,
-            parse_mode: chunk.parseMode,
-            reply_markup: index === chunks.length - 1 ? options?.replyMarkup : undefined,
-            ...(replyParameters ? { reply_parameters: replyParameters } : {}),
-            ...(options?.target ? getTelegramTargetThreadParams(options.target) : {}),
-        }));
-        lastMessageId = sent.message_id;
-        deps.recordOwnership?.({
-            chatId,
-            messageId: sent.message_id,
-            target: options?.target,
+        assertTelegramApiCallAuthority(assertAuthority, false);
+        const sent = await withTelegramReplyParameters(chatId, index === 0 ? replyToMessageId : undefined, target, async (replyParameters) => {
+            const sent = await send(chunk, {
+                reply_markup: index === chunks.length - 1 ? replyMarkup : undefined,
+                ...(replyParameters ? { reply_parameters: replyParameters } : {}),
+                ...(target ? getTelegramTargetThreadParams(target) : {}),
+            }, assertAuthority ? { assertAuthority } : undefined);
+            assertTelegramApiCallAuthority(assertAuthority, true);
+            return sent;
         });
+        assertTelegramApiCallAuthority(assertAuthority, true);
+        lastMessageId = sent.message_id;
+        recordOwnership?.({ chatId, messageId: sent.message_id, target });
+        assertTelegramApiCallAuthority(assertAuthority, true);
     }
     return lastMessageId;
 }
 export async function editTelegramRenderedMessage(chatId, messageId, chunks, deps, options) {
+    options = { ...options, target: options?.target && { ...options.target } };
+    const assertAuthority = options.assertAuthority;
+    assertTelegramApiCallAuthority(assertAuthority, false);
     assertTelegramInlineKeyboardCallbackData(options?.replyMarkup);
     if (chunks.length === 0)
         return messageId;
     const [firstChunk, ...remainingChunks] = chunks;
-    deps.recordOwnership?.({ chatId, messageId, target: options?.target });
+    if (!assertAuthority)
+        deps.recordOwnership?.({ chatId, messageId, target: options.target });
     await deps.editMessage({
         chat_id: chatId,
         message_id: messageId,
@@ -205,22 +209,29 @@ export async function editTelegramRenderedMessage(chatId, messageId, chunks, dep
         parse_mode: firstChunk.parseMode,
         reply_markup: remainingChunks.length === 0 ? options?.replyMarkup : undefined,
         ...(options?.target ? getTelegramTargetThreadParams(options.target) : {}),
-    });
+    }, assertAuthority ? { assertAuthority } : undefined);
+    assertTelegramApiCallAuthority(assertAuthority, true);
+    if (assertAuthority)
+        deps.recordOwnership?.({ chatId, messageId, target: options.target });
+    assertTelegramApiCallAuthority(assertAuthority, true);
     if (remainingChunks.length > 0) {
         return sendTelegramRenderedChunks(chatId, remainingChunks, deps, {
             replyMarkup: options?.replyMarkup,
             target: options?.target,
+            assertAuthority,
         });
     }
     return messageId;
 }
 export async function sendTelegramPlainReply(text, deps, options) {
+    options = { ...options, target: options?.target && { ...options.target } };
     const chunks = deps.renderTelegramMessage(text, {
         mode: options?.parseMode === "HTML" ? "html" : "plain",
     });
     return deps.sendRenderedChunks(chunks, {
         target: options?.target,
         replyToMessageId: options?.replyToMessageId,
+        assertAuthority: options.assertAuthority,
     });
 }
 function normalizeIndentedTelegramNativeMarkdownList(line) {
@@ -242,22 +253,28 @@ function normalizeTelegramNativeMarkdownLine(line) {
     result = result.replace(/(^|[^\\$])\$([A-Z][A-Z0-9]{1,})(?!\$)(?=\b|[.,;:)/-])/g, (_match, prefix, ticker) => `${prefix}\\$${ticker}`);
     return result.replace(/\u0000(\d+)\u0000/g, (_match, index) => codeSpans[Number(index)] ?? "");
 }
+export function parseTelegramMarkdownFenceOpening(line) {
+    const markerText = line.match(/^ {0,3}(`{3,}|~{3,})/)?.[1];
+    return markerText
+        ? { marker: markerText[0], length: markerText.length }
+        : undefined;
+}
+export function isTelegramMarkdownFenceClosing(line, fence) {
+    return new RegExp(`^ {0,3}${fence.marker}{${fence.length},}\\s*$`).test(line);
+}
+/** Fence state after one line: outside a fence a marker opens one; inside, a matching marker closes it. */
+function advanceTelegramMarkdownFence(fence, line) {
+    if (!fence)
+        return parseTelegramMarkdownFenceOpening(line);
+    return isTelegramMarkdownFenceClosing(line, fence) ? undefined : fence;
+}
 function hasClosingDisplayMathDelimiter(lines, startIndex) {
     let fence;
     for (let index = startIndex + 1; index < lines.length; index += 1) {
         const line = lines[index] ?? "";
-        const fenceMatch = line.match(/^ {0,3}(`{3,}|~{3,})/);
         if (!fence && line.trim() === "$$")
             return true;
-        if (!fence && fenceMatch) {
-            const markerText = fenceMatch[1] ?? "```";
-            fence = { marker: markerText[0], length: markerText.length };
-            continue;
-        }
-        if (fence &&
-            new RegExp(`^ {0,3}${fence.marker}{${fence.length},}\\s*$`).test(line)) {
-            fence = undefined;
-        }
+        fence = advanceTelegramMarkdownFence(fence, line);
     }
     return false;
 }
@@ -267,7 +284,6 @@ export function normalizeTelegramNativeMarkdown(markdown) {
     let displayMath = false;
     return lines
         .map((line, index) => {
-        const fenceMatch = line.match(/^ {0,3}(`{3,}|~{3,})/);
         const inFence = fence !== undefined;
         if (!inFence && line.trim() === "$$") {
             if (displayMath) {
@@ -281,17 +297,9 @@ export function normalizeTelegramNativeMarkdown(markdown) {
         }
         if (displayMath)
             return line;
-        if (!inFence && fenceMatch) {
-            const markerText = fenceMatch[1] ?? "```";
-            fence = {
-                marker: markerText[0],
-                length: markerText.length,
-            };
-            return line;
-        }
-        if (inFence &&
-            new RegExp(`^ {0,3}${fence?.marker}{${fence?.length},}\\s*$`).test(line)) {
-            fence = undefined;
+        const nextFence = advanceTelegramMarkdownFence(fence, line);
+        if (nextFence !== fence) {
+            fence = nextFence;
             return line;
         }
         if (!inFence)
@@ -349,21 +357,12 @@ function splitTelegramNativeMarkdownBlocks(markdown) {
         current.length = 0;
     };
     for (const line of markdown.split("\n")) {
-        const fenceMatch = line.match(/^ {0,3}(`{3,}|~{3,})/);
         if (!fence && line.trim().length === 0) {
             flush();
             continue;
         }
         current.push(line);
-        if (!fence && fenceMatch) {
-            const markerText = fenceMatch[1] ?? "```";
-            fence = { marker: markerText[0], length: markerText.length };
-            continue;
-        }
-        if (fence &&
-            new RegExp(`^ {0,3}${fence.marker}{${fence.length},}\\s*$`).test(line)) {
-            fence = undefined;
-        }
+        fence = advanceTelegramMarkdownFence(fence, line);
     }
     flush();
     return blocks;
@@ -376,21 +375,12 @@ function splitTelegramNativeMarkdownCountedBlocks(block) {
     let current = [];
     let fence;
     for (const line of block.split("\n")) {
-        const fenceMatch = line.match(/^ {0,3}(`{3,}|~{3,})/);
         if (!fence && current.length >= TELEGRAM_RICH_MESSAGE_MAX_BLOCKS) {
             chunks.push(current.join("\n"));
             current = [];
         }
         current.push(line);
-        if (!fence && fenceMatch) {
-            const markerText = fenceMatch[1] ?? "```";
-            fence = { marker: markerText[0], length: markerText.length };
-            continue;
-        }
-        if (fence &&
-            new RegExp(`^ {0,3}${fence.marker}{${fence.length},}\\s*$`).test(line)) {
-            fence = undefined;
-        }
+        fence = advanceTelegramMarkdownFence(fence, line);
     }
     if (current.length > 0)
         chunks.push(current.join("\n"));
@@ -427,12 +417,10 @@ function splitTelegramNativeMarkdownLongFenceBlock(block) {
     const lines = block.split("\n");
     const opening = lines[0] ?? "";
     const closing = lines[lines.length - 1] ?? "";
-    const openingMatch = opening?.match(/^ {0,3}(`{3,}|~{3,})/);
-    if (!openingMatch || !closing || lines.length < 2)
+    const openingFence = parseTelegramMarkdownFenceOpening(opening);
+    if (!openingFence || !closing || lines.length < 2)
         return undefined;
-    const markerText = openingMatch[1] ?? "```";
-    const marker = markerText[0];
-    if (!new RegExp(`^ {0,3}${marker}{${markerText.length},}\\s*$`).test(closing)) {
+    if (!isTelegramMarkdownFenceClosing(closing, openingFence)) {
         return undefined;
     }
     const maxContentLength = TELEGRAM_RICH_MESSAGE_MAX_CHARS - opening.length - closing.length - 2;
@@ -478,33 +466,24 @@ function findTelegramNativeMarkdownSplitIndex(text, hardLimit = TELEGRAM_RICH_ME
     return hardLimit;
 }
 export async function sendTelegramNativeMarkdownReply(chatId, replyToMessageId, markdown, deps, options) {
-    assertTelegramInlineKeyboardCallbackData(options?.replyMarkup);
-    let lastMessageId;
-    const chunks = splitTelegramNativeMarkdown(markdown);
-    for (const [index, chunk] of chunks.entries()) {
-        const sent = await withTelegramReplyParameters(chatId, index === 0 ? replyToMessageId : undefined, options?.target, (replyParameters) => deps.sendRichMessage({
-            chat_id: chatId,
-            rich_message: { markdown: chunk },
-            reply_markup: index === chunks.length - 1 ? options?.replyMarkup : undefined,
-            ...(replyParameters ? { reply_parameters: replyParameters } : {}),
-            ...(options?.target ? getTelegramTargetThreadParams(options.target) : {}),
-        }));
-        lastMessageId = sent.message_id;
-        deps.recordOwnership?.({
-            chatId,
-            messageId: sent.message_id,
-            target: options?.target,
-        });
-    }
-    return lastMessageId;
+    return sendTelegramChunkSequence(chatId, splitTelegramNativeMarkdown(markdown), replyToMessageId, options, deps.recordOwnership, (chunk, fields, callOptions) => deps.sendRichMessage({ chat_id: chatId, rich_message: { markdown: chunk }, ...fields }, callOptions));
 }
 async function sendTelegramNativeRichMessage(chatId, richMessage, deps, options) {
+    options = { ...options, target: options?.target && { ...options.target } };
+    const assertAuthority = options.assertAuthority;
+    assertTelegramApiCallAuthority(assertAuthority, false);
     const sent = await deps.sendRichMessage({
         chat_id: chatId,
         rich_message: richMessage,
         ...(options?.target ? getTelegramTargetThreadParams(options.target) : {}),
+    }, assertAuthority ? { assertAuthority } : undefined);
+    assertTelegramApiCallAuthority(assertAuthority, true);
+    deps.recordOwnership?.({
+        chatId,
+        messageId: sent.message_id,
+        target: options?.target,
     });
-    deps.recordOwnership?.({ chatId, messageId: sent.message_id, target: options?.target });
+    assertTelegramApiCallAuthority(assertAuthority, true);
     return sent.message_id;
 }
 export function createTelegramRenderedMessageDeliveryRuntime(deps) {
@@ -531,17 +510,23 @@ export function createTelegramRenderedMessageRuntime(deps) {
                 renderTelegramMessage: deps.renderTelegramMessage,
                 sendRenderedChunks: (chunks, chunkOptions) => deps.replyTransport.sendRenderedChunks(chatId, chunks, {
                     target: chunkOptions?.target,
+                    assertAuthority: chunkOptions?.assertAuthority,
                     replyToMessageId: chunkOptions?.replyToMessageId ?? replyToMessageId,
                 }),
             }, options);
         },
         sendMarkdownReply: async (chatId, replyToMessageId, markdown, options) => {
+            options = {
+                ...options,
+                target: options?.target && { ...options.target },
+            };
             const renderingMode = deps.getAssistantRenderingMode?.() ?? "rich";
             if (renderingMode === "html") {
                 return deps.replyTransport.sendRenderedChunks(chatId, deps.renderTelegramMessage(markdown, { mode: "markdown" }), {
                     replyMarkup: options?.replyMarkup,
                     target: options?.target,
                     replyToMessageId,
+                    assertAuthority: options.assertAuthority,
                 });
             }
             return sendTelegramNativeMarkdownReply(chatId, replyToMessageId, markdown, {
@@ -549,14 +534,23 @@ export function createTelegramRenderedMessageRuntime(deps) {
                 sendRichMessage: deps.sendRichMessage,
             }, options);
         },
-        editInteractiveMessage: async (chatId, messageId, text, mode, replyMarkup) => {
-            await deps.replyTransport.editRenderedMessage(chatId, messageId, deps.renderTelegramMessage(text, { mode }), { replyMarkup });
+        editInteractiveMessage: async (chatId, messageId, text, mode, replyMarkup, options) => {
+            options = {
+                ...options,
+                target: options?.target && { ...options.target },
+            };
+            await deps.replyTransport.editRenderedMessage(chatId, messageId, deps.renderTelegramMessage(text, { mode }), { ...options, replyMarkup });
         },
         sendInteractiveMessage: async (chatId, text, mode, replyMarkup, options) => {
+            options = {
+                ...options,
+                target: options?.target && { ...options.target },
+            };
             return deps.replyTransport.sendRenderedChunks(chatId, deps.renderTelegramMessage(text, { mode }), {
                 replyMarkup,
                 target: options?.target,
                 replyToMessageId: options?.replyToMessageId,
+                assertAuthority: options.assertAuthority,
             });
         },
         sendSectionRichMessage: (chatId, message, options) => sendTelegramNativeRichMessage(chatId, message, {
@@ -565,17 +559,6 @@ export function createTelegramRenderedMessageRuntime(deps) {
         }, options),
     };
 }
-// --- Dedup-wrapped Reply Wrappers ---
-/** Wrap a sendTextReply with reply dedup so only the first message
- *  in a turn carries reply metadata. */
-export function dedupSendTextReply(dedup, inner) {
-    return async (chatId, replyToMessageId, text, options) => {
-        const effectiveReplyTo = dedup.shouldReply(replyToMessageId)
-            ? replyToMessageId
-            : undefined;
-        return inner(chatId, effectiveReplyTo, text, options);
-    };
-}
 /**
  * Guest reply sender: answers guest queries with native Rich Markdown content.
  * Guest queries use InlineQueryResult input_message_content rather than chat

package/node_modules/@llblab/pi-telegram/dist/lib/routing.d.ts

@@ -43,6 +43,71 @@ export declare function resolveTelegramGuestPromptPeer(input: {
 export declare function resolveTelegramGuestFileScope(input: Parameters<typeof resolveTelegramGuestPromptPeer>[0]): string;
 import * as Threads from "./threads.ts";
 import * as Updates from "./updates.ts";
+/** Prepare the selected leader's exact retained originals; no copy, adoption, acceptance proof or dispatch. */
+export declare function prepareTelegramLiveLeaderOriginal(input: {
+    request: Threads.TelegramWorkspaceRestoreRequest;
+    messages: readonly unknown[];
+    isCurrent(): boolean;
+}): Updates.TelegramLiveDeferredInputPreparation | undefined;
+export type TelegramLiveRebindCleanupIssue = {
+    status: "not-ready";
+} | {
+    status: "finished";
+    operationId: string;
+    cleanup: ThreadReconciler.TelegramLiveRebindCleanupOutcome;
+    recorded: boolean;
+};
+/** Default live-rebind cleanup pacing: quick early attempts, then minutely, within a 15-minute window. */
+export declare const TELEGRAM_LIVE_REBIND_CLEANUP_SCHEDULE: Readonly<{
+    delaysMs: readonly number[];
+    intervalMs: 60000;
+    windowMs: number;
+}>;
+/** Chooser-scoped saved command reference; it is never retained after the chooser record. */
+type TelegramLiveRebindSelectedCommandReference = {
+    operationId: string;
+    preparedSource: Bus.TelegramBusPreparedCommandSource;
+    selectedCommand: Bus.TelegramBusSelectedCommandInput;
+};
+/** One warm live attempt with exact post-release peer donor settlement; no startup recovery, Restore ACK or cleanup. */
+export declare function createTelegramLiveRebindCoordinator(input: {
+    request: Threads.TelegramWorkspaceRestoreRequest;
+    /** Captures caller source/reference, admission, profile, transport and Pi lifetime. */
+    authority: Threads.TelegramWorkspaceRestoreAuthority;
+    messages: readonly unknown[];
+    restoreStore: Threads.TelegramWorkspaceRestore;
+    threadStore: Pick<Threads.TelegramTopicTargetStore, "withWorkspaceRestoreSnapshot">;
+    getRecipient(): (Threads.TelegramWorkspaceRestoreRecipient & {
+        bindingKey: string;
+    }) | undefined;
+    leader?: {
+        apply(intent: Threads.TelegramWorkspaceLiveRebindIntent, mode: "apply" | "inspect", isCurrent: () => boolean): Promise<void>;
+        /** Synchronous local identity only; safe inside a Workspace publication fence. */
+        isApplied(intent: Threads.TelegramWorkspaceLiveRebindIntent): boolean;
+    } & ({
+        /** Confirm ordinary queue admission of these same bound messages, never handler replay. */
+        continue(messages: readonly unknown[], isCurrent: () => boolean): Promise<boolean>;
+        /** Observe only the same issued admission through its existing receipt owner; never re-enqueue. */
+        observeAdmission?(): boolean;
+        complete?: never;
+    } | {
+        /** Issue one semantic completion; the adapter owns detached delivery and errors, not a removal ACK. */
+        complete(messages: readonly unknown[], isCurrent: () => boolean): void;
+        continue?: never;
+    });
+    follower?: {
+        run: ReturnType<typeof Bus.createTelegramBusLiveRebindController>;
+        /** Explicit staged singleton command branch; absence preserves ordinary live input behavior. */
+        selectedCommand?: Bus.TelegramBusSelectedCommandInput;
+    };
+    recordRuntimeEvent?: (category: string, error: unknown, details: Record<string, unknown>) => void;
+}): {
+    /** Correlation only; a later cleanup attempt rereads and revalidates the canonical row itself. */
+    operationId: string;
+    /** Body-free copy of the authenticated saved command reference: correlation only, never authority, an ACK or a cleanup permit. */
+    selectedCommandReference(): TelegramLiveRebindSelectedCommandReference | undefined;
+    advance(): Promise<"protected" | "unknown" | "released">;
+};
 /** One admitted Restore attempt through recipient readiness, never source dispatch or cleanup. */
 export declare function advanceTelegramWorkspaceRestore(input: {
     request: Threads.TelegramWorkspaceRestoreRequest;
@@ -68,8 +133,8 @@ export declare function advanceTelegramWorkspaceRestore(input: {
     inspectOnly?: true;
 }): Promise<Threads.TelegramWorkspaceRestoreIntent | undefined>;
 export declare const TELEGRAM_ALL_TAB_COMMAND_MAX_AGE_MS: number;
-/** One user-facing answer for expired or previous-process routing controls. */
-export declare const TELEGRAM_ROUTING_CHOICE_EXPIRED = "\u231B Routing choice expired.";
+/** The toast for expired or previous-process routing controls; the chooser notice is written separately. */
+export declare const TELEGRAM_ROUTING_CHOICE_EXPIRED = "Routing choice expired";
 export declare function isTelegramAllTabCommandExpired(message: {
     date?: number;
     message_thread_id?: number;
@@ -121,6 +186,7 @@ export interface TelegramInboundRouteRuntimeDeps<TMessage extends TelegramRouted
     captureWorkspaceExternalProtection?: ReturnType<typeof createTelegramWorkspaceExternalProtectionCapture>;
     /** Strict committed abandonment plus retained original; shared by Restore and temporary-input cancellation. */
     inspectRestoreSourceAbandonment?: (updateId: number, journalBindingKey: string) => Threads.TelegramTemporaryThreadCancellationEvidence | undefined;
+    inspectRoutingInputGroupExpiry?: (input: Threads.TelegramTemporaryThreadInput) => readonly Threads.TelegramTemporaryThreadCancellationEvidence[] | undefined;
     /** Strict active-journal observation only; a hint or missing source never substitutes for this ACK. */
     inspectRestoreSourceCompletion?: (expected: Updates.TelegramDeferredSourceEvidence & {
         completionSha256: string;
@@ -131,17 +197,36 @@ export interface TelegramInboundRouteRuntimeDeps<TMessage extends TelegramRouted
         journalBindingKey: string;
     }) => TelegramUpdateJournalQueuedReceiptEvidence | undefined;
     hasWorkspaceRestoreAuthority?: () => boolean;
+    /** Exact live root authority; capability advertisement alone cannot replace owned profile/session/recipient fences. */
+    hasWorkspaceLiveRebindAuthority?: () => boolean;
     /** Strict complete namespace plus exact current/historical references; only an empty result clears journal protection. */
-    inspectTemporaryThreadSources?: (target: Queue.TelegramQueueTarget, requiredJournalBindingKeys: readonly string[]) => readonly number[] | undefined;
+    inspectTemporaryThreadSources?: (target: Queue.TelegramQueueTarget, requiredJournalBindingKeys: readonly string[], ownInputs?: readonly Threads.TelegramTemporaryThreadInput[]) => readonly number[] | undefined;
     /** Quiet period after the last cancelled input before one cleanup attempt; defaults to 1000 ms. */
     temporaryThreadCleanupDelayMs?: number;
+    /** Live-rebind cleanup attempt pacing; the bounded window ends in `not-issued`, never a time-based deletion. */
+    liveRebindCleanupSchedule?: {
+        delaysMs: readonly number[];
+        intervalMs: number;
+        windowMs: number;
+    };
     getSessionGeneration?: () => number;
     workspaceRestoreRecipient?: {
         getSessionId: (ctx: TContext) => string | undefined;
         getCwd: (ctx: TContext) => string | undefined;
         getLeaderIdentity: Threads.TelegramLeaderThreadStateRuntime["getIdentity"];
+        /** Read-only current leader work; source/chooser lifetime is not recipient authority. */
+        observeLeaderWork?: (oldTarget: Queue.TelegramQueueTarget & {
+            threadId: number;
+        }, ctx: TContext) => Bus.TelegramBusLiveRebindWorkState;
         followerRegistry: Pick<Bus.TelegramBusFollowerRegistry, "get" | "register">;
         runFollower: ReturnType<typeof Bus.createTelegramBusWorkspaceRestoreController>;
+        liveFollower?: {
+            /** Pure trusted assembly availability (Commands/native/menu and local protocol), never future target activation. */
+            isSelectedCommandAvailable?(follower: Readonly<Bus.TelegramBusFollowerView>, name: string): boolean;
+            /** Exact session journal identity from the existing registration/journal owners, never the profile routing key. */
+            getJournalBindingKey(follower: Bus.TelegramBusFollowerView): string | undefined;
+            run: ReturnType<typeof Bus.createTelegramBusLiveRebindController>;
+        };
     };
     bridgeRuntime: TelegramBridgeRuntime;
     activeTurnRuntime: Queue.TelegramActiveTurnStore;
@@ -153,9 +238,11 @@ export interface TelegramInboundRouteRuntimeDeps<TMessage extends TelegramRouted
     currentModelRuntime: Model.CurrentModelRuntime<TContext, TModel>;
     modelSwitchController: Model.TelegramModelSwitchController<TContext, Model.ScopedTelegramModel<TModel>>;
     menuActions: Menu.TelegramMenuActionRuntime<TContext, TModel>;
+    /** Thinking controls refuse while the active Telegram turn expects a voice reply. */
+    isVoiceReplyActive?: () => boolean;
     updateSettingsMenuMessage?: (state: Menu.TelegramModelMenuState<TModel>, ctx: TContext) => Promise<void>;
-    openQueueMenu: (chatId: number, replyToMessageId: number, ctx: TContext) => Promise<void>;
-    openSettingsMenu?: (chatId: number, replyToMessageId: number, ctx: TContext) => Promise<void>;
+    openQueueMenu: (chatId: number, replyToMessageId: number, ctx: TContext, threadId?: number, options?: Pick<TelegramApiCallOptions, "assertAuthority">) => Promise<void>;
+    openSettingsMenu?: (chatId: number, replyToMessageId: number, ctx: TContext, threadId?: number, options?: Pick<TelegramApiCallOptions, "assertAuthority">) => Promise<void>;
     settingsMenuCallbackHandler?: (query: TCallbackQuery, ctx: TContext) => Promise<boolean>;
     queueMenuCallbackHandler: (query: TCallbackQuery, ctx: TContext) => Promise<boolean>;
     buttonActionStore?: OutboundHandlers.TelegramButtonActionStore;
@@ -183,12 +270,16 @@ export interface TelegramInboundRouteRuntimeDeps<TMessage extends TelegramRouted
         };
     }) => void;
     stopTypingLoop?: () => void;
-    answerCallbackQuery: (callbackQueryId: string, text?: string) => Promise<void>;
-    editInteractiveMessage?: (chatId: number, messageId: number, text: string, mode: "markdown" | "html" | "plain", replyMarkup: Menu.TelegramReplyMarkup) => Promise<void>;
+    answerCallbackQuery: (callbackQueryId: string, text?: string, options?: Pick<TelegramApiCallOptions, "assertAuthority">) => Promise<void>;
+    editInteractiveMessage?: (chatId: number, messageId: number, text: string, mode: "markdown" | "html" | "plain", replyMarkup: Menu.TelegramReplyMarkup, options?: {
+        target?: Queue.TelegramQueueTarget;
+        assertAuthority?: TelegramApiCallOptions["assertAuthority"];
+    }) => Promise<void>;
     editMessageReplyMarkup?: (chatId: number, messageId: number, replyMarkup: OutboundHandlers.TelegramOutboundButtonMarkup) => Promise<void>;
     sendInteractiveMessage?: (chatId: number, text: string, mode: "markdown" | "html" | "plain", replyMarkup: Menu.TelegramReplyMarkup, options?: {
         target?: Queue.TelegramQueueTarget;
         replyToMessageId?: number;
+        assertAuthority?: TelegramApiCallOptions["assertAuthority"];
     }) => Promise<number | undefined>;
     deleteMessage?: (chatId: number, messageId: number) => Promise<void>;
     answerGuestQuery: (guestQueryId: string, text?: string) => Promise<void>;
@@ -201,8 +292,11 @@ export interface TelegramInboundRouteRuntimeDeps<TMessage extends TelegramRouted
     sendTextReply: (chatId: number, replyToMessageId: number, text: string, options?: {
         parseMode?: "HTML";
         target?: Queue.TelegramQueueTarget;
+        assertAuthority?: TelegramApiCallOptions["assertAuthority"];
     }) => Promise<number | undefined>;
     setMyCommands: Commands.TelegramBotCommandRegistrationDeps["setMyCommands"];
+    /** Captures independent recipient authority, never the source execution or dialog handle. */
+    captureThreadNameRecipientAuthority?: (target: Queue.TelegramQueueTarget, ctx: TContext) => (() => void) | undefined;
     validateThreadName?: (threadName: string) => string | undefined;
     renameCurrentThread?: Commands.TelegramThreadDisplayNameRenamePort;
     resetCurrentThreadName?: Commands.TelegramThreadDisplayNameResetPort;
@@ -222,6 +316,7 @@ export interface TelegramInboundRouteRuntimeDeps<TMessage extends TelegramRouted
         onError: (error: unknown) => void;
     }) => void;
     recordRuntimeEvent?: (category: string, error: unknown, details?: Record<string, unknown>) => void;
+    beginCommandEffectWork?: Commands.TelegramCommandRuntimeDeps<TMessage, TContext>["beginCommandEffectWork"];
     sectionRegistry?: TelegramSectionRegistry;
     sendSectionRichMessage?: (chatId: number, message: TelegramInputRichMessage, options?: {
         target?: {
@@ -248,6 +343,25 @@ export declare function createTelegramInboundRouteRuntime<TUpdate extends Update
     onUpdateCompleted: NonNullable<Updates.TelegramUpdateWorkerRuntimeDeps<TContext>["onUpdateCompleted"]>;
     onWorkspaceRestoreRecipientObserved(follower: Bus.TelegramBusFollowerView, isCurrent: () => boolean, ctx: TContext | undefined): Promise<void> | undefined;
     waitForRestoreSettlement(): Promise<void>;
+    /** Commands-owned registry port for dormant scoped recipient assembly, not ordinary update replay. */
+    prepareHeldCommand: ReturnType<typeof Commands.createTelegramCommandHandlerTargetRuntime<TMessage, TContext>>["prepareHeldCommand"];
+    canPrepareHeldCommand: ReturnType<typeof Commands.createTelegramCommandHandlerTargetRuntime<TMessage, TContext>>["canPrepareHeldCommand"];
+    /** Fresh body-free recipient observation only; never reconstructs an attempt or grants cleanup. */
+    observeLiveRebindLeaderWork(intent: Threads.TelegramWorkspaceLiveRebindIntent, ctx: TContext): Promise<Bus.TelegramBusLiveRebindWorkObservation | undefined>;
+    /** Fresh non-destructive candidate only; no retained idle, cleanup action or deletion grant. */
+    prepareLiveRebindLeaderCleanup(intent: Threads.TelegramWorkspaceLiveRebindIntent, ctx: TContext): Promise<ThreadReconciler.TelegramLiveRebindCleanupPreparation | undefined>;
+    /** Requires the authenticated peer's exact retained released carrier; never recreates save/apply/release. */
+    prepareLiveRebindFollowerCleanup(intent: Threads.TelegramWorkspaceLiveRebindIntent, ctx: TContext): Promise<ThreadReconciler.TelegramLiveRebindCleanupPreparation | undefined>;
+    /**
+     * One cleanup attempt under fresh admission: a fresh clear sample, then the durable issue marker, one unretried
+     * deletion and the terminal record. `not-ready` leaves the released row unissued; `undefined` is lost authority.
+     */
+    issueLiveRebindLeaderCleanup(intent: Threads.TelegramWorkspaceLiveRebindIntent, ctx: TContext): Promise<TelegramLiveRebindCleanupIssue | undefined>;
+    issueLiveRebindFollowerCleanup(intent: Threads.TelegramWorkspaceLiveRebindIntent, ctx: TContext): Promise<TelegramLiveRebindCleanupIssue | undefined>;
+    /** Coordinator-only prompt admission; caller retains Workspace/canonical and exact recipient authority. */
+    continueLiveRebindPrompt(messages: readonly TMessage[], ctx: TContext, target: Queue.TelegramQueueTarget & {
+        threadId: number;
+    }, isCurrent: () => boolean): Promise<boolean>;
 };
 export interface TelegramAssistantOutputAuthority<TTransportStamp> {
     transportStamp: TTransportStamp;