@llblab/pi-kit 0.35.0 → 0.35.1

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

@@ -1377,13 +1377,55 @@ export async function handleTelegramAgentEndRuntime(deps) {
                 });
             }
         }
-        if (turn.guestInlineMessageId && deps.editGuestReply) {
-            const experimentText = assistant.errorMessage
+        if (!isDeliveryActive())
+            return;
+        if (turn.guestInlineMessageId) {
+            let experimentText = assistant.errorMessage
                 ? "Telegram bridge: Pi failed while processing the request."
                 : finalText;
+            const [attachment] = turn.queuedAttachments;
+            if (!assistant.errorMessage && attachment) {
+                try {
+                    if (!deps.sendGuestAttachment)
+                        throw new Error("Guest attachment delivery is unavailable.");
+                    await deps.sendGuestAttachment(turn, attachment, finalText || undefined, { isDeliveryActive });
+                    if (isDeliveryActive() && endPlan.shouldDispatchNext)
+                        deps.dispatchNextQueuedTelegramTurn();
+                    return;
+                }
+                catch (error) {
+                    deps.recordRuntimeEvent?.("delivery", error, {
+                        phase: "guest-attachment", guestQueryId: turn.guestQueryId,
+                    });
+                    if (!isDeliveryActive())
+                        return;
+                    if (isTelegramApiCommitUnknownError(error)) {
+                        if (endPlan.shouldDispatchNext)
+                            deps.dispatchNextQueuedTelegramTurn();
+                        return;
+                    }
+                    experimentText = "Telegram bridge could not deliver the requested attachment. Please retry in a normal bot chat.";
+                }
+            }
+            else if (!assistant.errorMessage && hasOutboundArtifacts) {
+                experimentText = [finalText, "Telegram Guest Mode cannot replace an inline placeholder with a voice note. Please request MP3 audio or use a normal bot chat."].filter(Boolean).join("\n\n");
+            }
+            if (!deps.editGuestReply) {
+                deps.recordRuntimeEvent?.("delivery", new Error("Guest inline reply editing is unavailable."), {
+                    phase: "guest-ack-edit", guestQueryId: turn.guestQueryId,
+                });
+                if (endPlan.shouldDispatchNext)
+                    deps.dispatchNextQueuedTelegramTurn();
+                return;
+            }
             if (experimentText) {
                 try {
-                    await deps.editGuestReply(turn.guestInlineMessageId, experimentText);
+                    await deps.editGuestReply(turn.guestInlineMessageId, experimentText, {
+                        assertAuthority() {
+                            if (!isDeliveryActive())
+                                throw new Error("Guest reply edit lost authority.");
+                        },
+                    });
                     deps.recordRuntimeEvent?.("guest", new Error("Guest ACK edited the guest answer"), { phase: "guest-ack-edited", guestQueryId: turn.guestQueryId });
                 }
                 catch (error) {
@@ -1419,7 +1461,7 @@ export async function handleTelegramAgentEndRuntime(deps) {
         const [guestAttachment] = turn.queuedAttachments;
         if (guestAttachment && deps.sendGuestAttachment) {
             try {
-                await deps.sendGuestAttachment(turn, guestAttachment, finalText || undefined);
+                await deps.sendGuestAttachment(turn, guestAttachment, finalText || undefined, { isDeliveryActive });
             }
             catch (error) {
                 deps.recordRuntimeEvent?.("delivery", error, {

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

@@ -163,8 +163,12 @@ export declare function createGuestMarkdownReplyEditor(deps: {
     editGuestInlineMessage: (inlineMessageId: string, content: {
         richMessage?: TelegramInputRichMessage;
         text?: string;
+    }, options?: {
+        assertAuthority?: () => void;
     }) => Promise<void>;
-}): (inlineMessageId: string, markdown: string) => Promise<void>;
+}): (inlineMessageId: string, markdown: string, options?: {
+    assertAuthority?: () => void;
+}) => Promise<void>;
 /**
  * Guest Mode placeholder rotation: the early ACK is the first placeholder
  * frame and the runtime steps the remaining frames once per interval, moving

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

@@ -578,11 +578,11 @@ export function createGuestMarkdownReplySender(deps) {
  * chat/message pair.
  */
 export function createGuestMarkdownReplyEditor(deps) {
-    return async (inlineMessageId, markdown) => {
+    return async (inlineMessageId, markdown, options) => {
         const [richMarkdown = markdown] = splitTelegramNativeMarkdown(markdown);
         await deps.editGuestInlineMessage(inlineMessageId, {
             richMessage: { markdown: richMarkdown },
-        });
+        }, options);
     };
 }
 /**

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

@@ -211,6 +211,8 @@ export interface TelegramInboundRouteRuntimeDeps<TMessage extends TelegramRouted
     canUsePreDispatchRebind?: (recipient?: Threads.TelegramWorkspaceRestoreRecipient) => boolean;
     /** Strict complete namespace plus exact current/historical references; only an empty result clears journal protection. */
     inspectTemporaryThreadSources?: (target: Queue.TelegramQueueTarget, requiredJournalBindingKeys: readonly string[], ownInputs?: readonly Threads.TelegramTemporaryThreadInput[]) => readonly number[] | undefined;
+    /** Explicit cleanup-only recovery; never called by a read-only protection observer. */
+    recoverTemporaryThreadDeadQueueOwners?: (target: Queue.TelegramQueueTarget, requiredJournalBindingKeys: readonly string[], ownInputs: readonly Threads.TelegramTemporaryThreadInput[], isCurrent: () => boolean) => number;
     /** Quiet period after the last cancelled input before one cleanup attempt; defaults to 0 ms. */
     temporaryThreadCleanupDelayMs?: number;
     /** Live-rebind cleanup attempt pacing; the bounded window ends in `not-issued`, never a time-based deletion. */

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

@@ -4574,6 +4574,100 @@ export function createTelegramInboundRouteRuntime(deps) {
         }
         await promptEnqueue(messages, ctx);
     };
+    /** Local menu acceptance owns a one-shot effect; source removal and cleanup precede its release, never its replay. */
+    const stageTemporaryRerouteMenu = async (pending, command, messages, ctx, assertRecipientCurrent, completion) => {
+        const original = pending.messages[0];
+        const cap = captureTemporaryThreadAuthority(ctx);
+        const temporary = pending.temporaryThread ?? findCreatedTemporaryThread(pending.sourceTarget);
+        if (!cap?.isCurrent() || !temporary)
+            return undefined;
+        let accept, resume;
+        const accepted = new Promise(resolve => { accept = resolve; });
+        const released = new Promise(resolve => { resume = resolve; });
+        const admission = {
+            assertSourceCurrent() {
+                if (!completion.isCurrent())
+                    throw new Error("Rerouted menu source authority changed.");
+            },
+            assertRecipientCurrent,
+            reportCompleted() {
+                const result = completion.reportCompleted();
+                accept(result);
+                return result;
+            },
+            async beforeEffects() {
+                if (!(await released))
+                    throw new Error("Rerouted menu execution was not released.");
+            },
+        };
+        const prepare = command.name === "start" ? commandHandler.prepareSelectedStartCommand
+            : command.name === "help" ? commandHandler.prepareSelectedHelpCommand : commandHandler.prepareSelectedMenuCommand;
+        const dispatch = prepare(command, messages, ctx, admission);
+        if (!dispatch)
+            return undefined;
+        const execution = dispatch().catch(error => {
+            deps.recordRuntimeEvent?.("routing", error, { phase: "reroute-menu-execution" });
+            return false;
+        });
+        if (!(await Promise.race([accepted, execution.then(() => false)]))) {
+            resume(false);
+            await execution;
+            return undefined;
+        }
+        return async () => {
+            let allowEffects = false;
+            try {
+                const confirmed = await new Promise(resolve => {
+                    let done = false, unsubscribe;
+                    const signal = Updates.getTelegramUpdateExecutionFence(original)?.signal;
+                    const finish = (result) => {
+                        if (done)
+                            return;
+                        done = true;
+                        clearTimeout(timer);
+                        unsubscribe?.();
+                        signal?.removeEventListener("abort", abort);
+                        resolve(result);
+                    };
+                    const abort = () => finish(false);
+                    const observe = () => {
+                        if (!cap.isCurrent() || !completion.isCurrent())
+                            finish(false);
+                        else if (completion.inspectCompletion())
+                            finish(true);
+                    };
+                    const timer = setTimeout(abort, deps.liveRebindCommandCompletionTimeoutMs ?? 8_000);
+                    timer.unref?.();
+                    unsubscribe = Updates.subscribeTelegramDeferredSourceCompletion(original, observe);
+                    signal?.addEventListener("abort", abort, { once: true });
+                    if (signal?.aborted)
+                        abort();
+                    else
+                        observe();
+                });
+                if (!confirmed)
+                    throw new Error("Rerouted menu source removal is unconfirmed; execution remains suppressed.");
+                assertRecipientCurrent();
+                cancelTemporaryThreadCleanup(temporary.token);
+                try {
+                    await runTemporaryThreadCleanup(temporary.token, cap, false);
+                }
+                catch (error) {
+                    // Cleanup uncertainty retains its canonical grant, not command execution authority or a retry license.
+                    deps.recordRuntimeEvent?.("routing", error, { phase: "reroute-menu-cleanup" });
+                }
+                assertRecipientCurrent();
+                allowEffects = true;
+            }
+            catch (error) {
+                deps.recordRuntimeEvent?.("routing", error, { phase: "reroute-menu-release" });
+            }
+            finally {
+                resume(allowEffects);
+                await execution;
+            }
+        };
+    };
     const finalizePendingReroute = async (rerouteId, pending, query, successMessage, assertExecutionCurrent = Updates.createTelegramUpdateExecutionFenceGuard(query), retainRecord = false) => {
         assertExecutionCurrent();
         const dismissed = await dismissRerouteChooserMessage(query, assertExecutionCurrent);
@@ -4888,9 +4982,17 @@ export function createTelegramInboundRouteRuntime(deps) {
             if (!cancelledCurrent())
                 return;
             entry = cap.adopt(entry);
-            if (!entry ||
-                !cap.isCurrent() ||
-                isRerouteTargetProtected(target, undefined, entry))
+            if (!entry || !cap.isCurrent())
+                return;
+            if (isRerouteTargetProtected(target, undefined, entry) && deps.recoverTemporaryThreadDeadQueueOwners &&
+                store.inspectTemporaryThreadTarget(entry, cap.authority)?.kind === "temporary") {
+                const inputs = Threads.getTelegramTemporaryThreadInputs(entry);
+                const removed = deps.recoverTemporaryThreadDeadQueueOwners(target, [cap.journalBindingKey, ...inputs.map(input => input.journalBindingKey)], inputs, cap.isCurrent);
+                if (removed > 0)
+                    deps.recordRuntimeEvent?.("routing", "Discarded historical queue receipts from confirmed-dead owners before temporary Thread cleanup.", { phase: "temporary-thread-dead-owner-recovery", removedUpdateCount: removed });
+            }
+            // Recovery is not deletion authority: recapture every ordinary protection after the journal CAS.
+            if (!cap.isCurrent() || isRerouteTargetProtected(target, undefined, entry))
                 return;
             const issued = store.issueTemporaryThreadCleanup(entry, cap.authority);
             if (!issued || !cap.isCurrent())
@@ -5911,7 +6013,7 @@ export function createTelegramInboundRouteRuntime(deps) {
         await deps.answerCallbackQuery(query.id);
         return true;
     };
-    const executeUnboundRerouteCallbackOperation = async (query, ctx) => {
+    const executeUnboundRerouteCallbackOperation = async (query, ctx, afterAdmission) => {
         const parsed = parseTelegramUnboundRerouteCallbackData(query.data);
         if (!parsed)
             return false;
@@ -6432,7 +6534,21 @@ export function createTelegramInboundRouteRuntime(deps) {
         const localMessages = pending.rerouteCopies
             ? cloneTelegramMessagesForThread(pending.messages, parsed.threadId, pending.rerouteCopies.bySourceUpdateId)
             : reroutedMessages;
-        await dispatchPendingRerouteMessages(pending, localMessages, ctx);
+        const command = pending.dispatchKind === "command"
+            ? getLiveRebindMenu(localMessages) ?? getLiveRebindHelp(localMessages) : undefined;
+        const completion = pending.rerouteCopies && command
+            ? Updates.prepareTelegramDeferredSourceCompletion(pending.messages[0]) : undefined;
+        if (command && completion) {
+            const release = await stageTemporaryRerouteMenu(pending, command, localMessages, ctx, assertRerouteCurrent, completion);
+            if (!release) {
+                await deps.answerCallbackQuery(query.id, "Command acceptance unconfirmed; not resending");
+                return true;
+            }
+            afterAdmission(release);
+        }
+        else {
+            await dispatchPendingRerouteMessages(pending, localMessages, ctx);
+        }
         assertRerouteCurrent();
         pending.messages = [];
         return completeRoutedReroute();
@@ -6441,14 +6557,22 @@ export function createTelegramInboundRouteRuntime(deps) {
         const parsed = parseTelegramUnboundRerouteCallbackData(query.data);
         if (!parsed)
             return false;
-        return withPendingRerouteSelection(parsed.rerouteId, query, () => {
-            if (!deps.runWorkspaceOperation)
-                return executeUnboundRerouteCallbackOperation(query, ctx);
-            return deps.runWorkspaceOperation({
-                operationId: `workspace-reroute:${query.id}`,
-                operationKind: "workspace.route-unbound-thread",
-                scopes: [{ kind: "profile" }],
-            }, () => executeUnboundRerouteCallbackOperation(query, ctx));
+        return withPendingRerouteSelection(parsed.rerouteId, query, async () => {
+            let release;
+            const operation = () => executeUnboundRerouteCallbackOperation(query, ctx, value => { release = value; });
+            try {
+                if (!deps.runWorkspaceOperation)
+                    return await operation();
+                return await deps.runWorkspaceOperation({
+                    operationId: `workspace-reroute:${query.id}`,
+                    operationKind: "workspace.route-unbound-thread",
+                    scopes: [{ kind: "profile" }],
+                }, operation);
+            }
+            finally {
+                // Keep the exact source references, but release the non-reentrant Workspace gate before cleanup.
+                await release?.();
+            }
         });
     };
     const handleUnboundRerouteCallback = async (query, ctx) => {

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

@@ -343,6 +343,12 @@ export interface TelegramAnswerGuestQueryOptions {
     result?: TelegramGuestCachedMediaResult;
 }
 export interface TelegramEditGuestInlineMessageContent {
+    /** Cached media only: inline edits cannot upload a new local file. */
+    media?: {
+        type: "photo" | "document" | "audio";
+        media: string;
+        caption?: string;
+    };
     text?: string;
     richMessage?: TelegramInputRichMessage;
     parseMode?: "HTML";
@@ -465,13 +471,12 @@ export interface TelegramBridgeApiRuntime extends Pick<TelegramApiClient, "call"
     answerCallbackQuery: (callbackQueryId: string, text?: string, options?: Pick<TelegramApiCallOptions, "assertAuthority">) => Promise<void>;
     answerGuestQuery: (guestQueryId: string, text?: string, options?: TelegramAnswerGuestQueryOptions) => Promise<void>;
     /**
-     * Temporary Guest Mode ACK experiment: answers the guest query and returns
-     * the sent inline message id so the final answer can edit that early reply.
-     * Requires direct transport ownership; Telegram does not document editing
-     * guest answers, so this exists only to falsify that behavior live.
+     * Answers the guest query and retains the sent inline message id for final
+     * text or cached-media replacement. Requires direct transport ownership;
+     * actual guest-media rendering remains live-client gated.
      */
     answerGuestQueryForInlineMessage: (guestQueryId: string, text?: string, options?: TelegramAnswerGuestQueryOptions) => Promise<string | undefined>;
-    editGuestInlineMessage: (inlineMessageId: string, content: TelegramEditGuestInlineMessageContent) => Promise<void>;
+    editGuestInlineMessage: (inlineMessageId: string, content: TelegramEditGuestInlineMessageContent, options?: Pick<TelegramApiCallOptions, "assertAuthority">) => Promise<void>;
     deleteMessage: (chatId: number, messageId: number) => Promise<void>;
     prepareTempDir: () => Promise<number>;
 }

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

@@ -1267,14 +1267,31 @@ export function createTelegramBridgeApiRuntime(deps) {
             const sent = await callRecorded("answerGuestQuery", buildTelegramAnswerGuestQueryBody(guestQueryId, text, options));
             return sent?.inline_message_id;
         },
-        editGuestInlineMessage: async (inlineMessageId, content) => {
+        editGuestInlineMessage: async (inlineMessageId, content, options) => {
+            if (content.media) {
+                try {
+                    const result = await callRecorded("editMessageMedia", {
+                        inline_message_id: inlineMessageId,
+                        media: content.media,
+                    }, { ...options, maxAttempts: 1, retryRateLimit: false });
+                    if (result !== true)
+                        throw new Error("Missing inline edit acknowledgement.");
+                }
+                catch (error) {
+                    // Only a parsed rejection permits replacing this attempt with a failure notice.
+                    if (isTelegramApiRequestRejected(error, "editMessageMedia"))
+                        throw error;
+                    throw new TelegramApiCommitUnknownError("editMessageMedia", error);
+                }
+                return;
+            }
             await callRecorded("editMessageText", {
                 inline_message_id: inlineMessageId,
                 ...(content.richMessage
                     ? { rich_message: content.richMessage }
                     : { text: content.text }),
                 ...(content.parseMode ? { parse_mode: content.parseMode } : {}),
-            });
+            }, options);
         },
         prepareTempDir: () => prepareTelegramTempDir(deps.tempDir, deps.tempFileMaxAgeMs),
         deleteMessage: (chatId, messageId) => callRecorded("deleteMessage", {

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

@@ -1307,8 +1307,14 @@ function liveRebindOldTargetUnknown(value) {
 function retainLiveRebind(value) {
     return liveRebindActive(value) || liveRebindOldTargetUnknown(value) || value.oldTargetProtected === true;
 }
+function provisioningProtectionIntents(snapshot) {
+    return [...snapshot.operations, ...(snapshot.liveRebindings ?? []).filter(retainLiveRebind)];
+}
+function protectedLiveRebindOldTargetIntents(snapshot) {
+    return (snapshot?.liveRebindings ?? []).filter(value => value.oldTargetProtected === true || liveRebindOldTargetUnknown(value) || value.inputRelease !== undefined && value.cleanup === "issued");
+}
 function protectedLiveRebindOldTargets(snapshot) {
-    return (snapshot?.liveRebindings ?? []).filter(value => value.oldTargetProtected === true || liveRebindOldTargetUnknown(value) || value.inputRelease !== undefined && value.cleanup === "issued").map(value => ({ ...value.request.binding.target }));
+    return protectedLiveRebindOldTargetIntents(snapshot).map(value => ({ ...value.request.binding.target }));
 }
 function pendingWorkspaceRelocationRequests(snapshot) {
     return [
@@ -1362,10 +1368,11 @@ function assertWorkspaceRestoreBindingProtection(file) {
             throw new Error("Protected Workspace Restore owner target changed.");
         }
     }
-    for (const old of protectedLiveRebindOldTargets(file.workspaceRestore)) {
+    for (const { request } of protectedLiveRebindOldTargetIntents(file.workspaceRestore)) {
+        const old = request.binding.target;
         if (file.workspaceBindings?.some(value => targetMatches(value.target, old)) ||
             file.threads?.some(value => targetMatches(value.target, old) && ["active", "starting", "pending", "probe-required"].includes(value.status)) ||
-            file.pendingProvisions?.some(value => !value.target || targetMatches(value.target, old)) ||
+            file.pendingProvisions?.some(value => conflictsWithWorkspaceRestoreProvision(request, value)) ||
             file.reservations?.some(value => targetMatches(value.target, old)))
             throw new Error("Unknown live cleanup target remains protected.");
     }
@@ -2942,7 +2949,7 @@ export function createTelegramTopicTargetStore(options) {
                 !isDeepStrictEqual(file.workspaceRestore?.liveRebindings?.find((intent) => intent.request.operationId === expected.request.operationId), expected))
                 throw new Error("Workspace live-rebind observation changed.");
             assertWorkspaceRestoreBindingProtection(file);
-            assertRestoreRecoveryProtection(path, file.workspaceRestore.operations, file.pendingProvisions ?? []);
+            assertRestoreRecoveryProtection(path, provisioningProtectionIntents(file.workspaceRestore), file.pendingProvisions ?? []);
             observe({
                 threads: file.threads,
                 workspaceBindings: file.workspaceBindings,
@@ -2976,7 +2983,7 @@ export function createTelegramTopicTargetStore(options) {
                     !isDeepStrictEqual(file.workspaceRestore?.liveRebindings?.find((intent) => intent.request.operationId === request.operationId), expected))
                     return true;
                 assertWorkspaceRestoreBindingProtection(file);
-                assertRestoreRecoveryProtection(path, file.workspaceRestore.operations, file.pendingProvisions ?? []);
+                assertRestoreRecoveryProtection(path, provisioningProtectionIntents(file.workspaceRestore), file.pendingProvisions ?? []);
                 const canonical = file.workspaceBindings ?? [], warm = Array.from(workspaceBindings.values());
                 const matchesRecipient = (bindings, rows) => {
                     const bindingsForKey = bindings.filter((binding) => binding.bindingKey === request.binding.bindingKey);
@@ -3008,7 +3015,9 @@ export function createTelegramTopicTargetStore(options) {
                 const protectedTarget = (bindings, rows, reserved, provisions, cleanups) => bindings.some((binding) => targetMatches(binding.target, old)) ||
                     rows.some((row) => currentRow(row) && targetMatches(row.target, old)) ||
                     reserved.some((value) => targetMatches(value.target, old)) ||
-                    provisions.some((value) => !value.target || targetMatches(value.target, old)) ||
+                    // Use the same binding/slot/owner/target conflicts as rebind admission. An unrelated unlocated
+                    // create must not globally veto cleanup of this exact former binding (nor its issued marker).
+                    provisions.some((value) => conflictsWithWorkspaceRestoreProvision(request, value)) ||
                     cleanups.some((value) => targetMatches(value.target, old));
                 if (protectedTarget(canonical, file.threads, file.reservations ?? [], file.pendingProvisions ?? [], file.pendingCleanups ?? []) ||
                     protectedTarget(warm, Array.from(records.values()), reservations, pendingProvisions, pendingCleanups) ||
@@ -3153,7 +3162,10 @@ export function createTelegramTopicTargetStore(options) {
                 if (bindings.length > 1 ||
                     file.threads.some((value) => targetMatches(value.target, target)) ||
                     file.reservations?.some((value) => targetMatches(value.target, target)) ||
-                    file.pendingProvisions?.some((value) => !value.target || targetMatches(value.target, target)) ||
+                    // This exact created frame already proves a separately created routing tab (API ACK or authenticated
+                    // implicit creation). An unlocated Workspace create is not its owner; keep that intent unresolved,
+                    // but veto a concrete target collision. Generic unknown-target/Restore cleanup keeps its own guards.
+                    file.pendingProvisions?.some((value) => !!value.target && targetMatches(value.target, target)) ||
                     file.pendingCleanups?.some((value) => targetMatches(value.target, target)) ||
                     file.workspaceRetirements?.some((value) => targetMatches(value.binding.target, target)) ||
                     before.state.operations.some((value) => targetMatches(value.request.target, target)))
@@ -3274,7 +3286,7 @@ export function createTelegramTopicTargetStore(options) {
                         }
                         assertWorkspaceRestoreBindingProtection(before.file);
                         const provisions = parseTopicTargetFile(before.file).pendingProvisions ?? [];
-                        assertRestoreRecoveryProtection(path, before.state.operations, provisions);
+                        assertRestoreRecoveryProtection(path, provisioningProtectionIntents(before.state), provisions);
                         const after = { ...before.file, workspaceRestore: next };
                         // New temporary targets must be checked against the file they will be published into.
                         assertWorkspaceRestoreBindingProtection(parseTopicTargetFile(after));
@@ -3284,7 +3296,7 @@ export function createTelegramTopicTargetStore(options) {
                         if (workspaceIO) {
                             if (!workspaceFrame || !currentScope() || !isCurrent())
                                 return false;
-                            assertRestoreRecoveryProtection(path, [...before.state.operations, ...next.operations], provisions);
+                            assertRestoreRecoveryProtection(path, [...provisioningProtectionIntents(before.state), ...provisioningProtectionIntents(next)], provisions);
                             committedBefore = before;
                             committedAfter = JSON.parse(content);
                             workspaceFrame.value = committedAfter;
@@ -3304,7 +3316,7 @@ export function createTelegramTopicTargetStore(options) {
                                     return;
                                 if (!isDeepStrictEqual(read().file, before.file))
                                     throw new Error("Workspace Restore evidence changed before publication.");
-                                assertRestoreRecoveryProtection(path, [...before.state.operations, ...next.operations], provisions);
+                                assertRestoreRecoveryProtection(path, [...provisioningProtectionIntents(before.state), ...provisioningProtectionIntents(next)], provisions);
                                 if (!currentScope() || !isCurrent())
                                     return;
                                 replaceTelegramWorkspaceFile(temporary, path);
@@ -4175,7 +4187,7 @@ export function createTelegramTopicTargetStore(options) {
         upsertPendingProvision(provision) {
             if (pendingWorkspaceRelocationRequests(workspaceRestore).some((request) => conflictsWithWorkspaceRestoreProvision(request, provision)) ||
                 conflictsWithTemporaryThread(workspaceRestore, provision.target) ||
-                protectedLiveRebindOldTargets(workspaceRestore).some(old => !provision.target || targetMatches(old, provision.target))) {
+                protectedLiveRebindOldTargetIntents(workspaceRestore).some(({ request }) => conflictsWithWorkspaceRestoreProvision(request, provision))) {
                 throw new Error("Protected Workspace Restore provisioning conflict.");
             }
             const next = {

package/node_modules/@llblab/pi-telegram/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llblab/pi-telegram",
-  "version": "0.57.0",
+  "version": "0.57.1",
   "private": false,
   "publishConfig": {
     "access": "public"

package/node_modules/@llblab/pi-telegram/docs/architecture.md

@@ -485,6 +485,10 @@ This multi-input lifecycle is implemented in the local candidate, not authority
 
 Temporary Reroute publishes the prompt in its selected destination before local queue/command admission or follower IPC. The existing exact whole-group `forwardedInputs` grant precedes this one unretried Bot API request as well as native dispatch; complete distinct positive returned IDs provide display/reply anchors, never source acceptance or settlement. `forwardMessages` preserves albums and requires ascending source IDs, so the warm map correlates each destination ID with its immutable original source update ID rather than a routed zero ID or array position. Acknowledged routing copies are preferred; a proven still-retained All original or real native-Thread original may supply the source instead. Before issuance and after awaits, guards recheck source/executor/operator/context/generation/profile, exact issued group, live recipient record and Workspace session binding; followers also retain their exact registration/protocol ownership. API and IPC callbacks stay local. Reroute passes recipient/session authority plus each original execution fence to the existing socket connect/write/ACK checks, with one guarded transport attempt; a stale post-write ACK cannot settle donor custody or undo accepted recipient work. The input's warm projection uses the confirmed copy ID and clears former-tab reply suppression before carrying the original execution fence; donor journal originals remain untouched. A partial/malformed/lost API reply or revoked authority keeps the issued group nonterminal with no output or native retry, even after restart. A lost native IPC ACK similarly retains donor authority and cannot replay an already accepted recipient input or its display copies. Local receipt disposal and exact whole-group foreign source-removal ACKs still own temporary cleanup; neither a visible copy nor model completion grants deletion. A follower donor ACK may precede recipient receipt disposal, so a fully resolved but protected, unissued tab retains one metadata-only one-second recheck and accepts existing session-delivery drain wakes. Every attempt reacquires profile admission and fresh namespace/binding/source/authority proof; time is not a deletion grant. A fresh runtime drain can reobserve retained completed membership without replaying its input. Issued or unknown deletion never repeats. Restore's held-input sequencing and cleanup schedules are unchanged.
 
+A canonical temporary frame in phase `created` identifies its own independently created tab: either the exact one-shot `createForumTopic` response was acknowledged, or an owner-authenticated fresh implicit creation was admitted. An unrelated Workspace creation intent without a target therefore does not turn this positively identified tab into an unknown target. That uncertain intent is retained unchanged; this is neither age-based expiry nor permission to discard its recovery evidence. Any concrete provision targeting this tab, binding, owner, reservation, Restore operation, unresolved source or uncertain issued deletion retains its existing veto. `creating` frames never acquire this exemption, and generic unknown-target cleanup keeps its separate conservative rules. Restore old-target protection uses its exact binding/slot/owner/target conflict contract, including late recovered target evidence, rather than treating every unrelated targetless creation as a global veto; see the [Live-Rebind Channel](./multi-instance-bus.md#live-rebind-channel).
+
+Fresh local menu Reroute (`/start`, `/help`, `/status`, `/model`, `/thinking`, `/queue`, `/settings`) uses the existing selected-command owner with a release barrier captured during preparation. After acknowledged destination publication, exact worker completion readiness and paired-recipient validation permit one acceptance report, not immediate menu effects. The routing operation finalizes its chooser and releases profile admission while retaining its exact source references. A bounded subscription then requires the worker's exact removal ACK; absence, a thrown removal after commit, timeout or ended source authority is not completion. Cleanup acquires a new profile admission, behind source-completion bookkeeping, and rechecks every ordinary temporary-tab protection. Only then are the accepted menu effects released under the captured recipient/session/target guard. Siblings, live queue custody, unconfirmed deletion and other protection may retain the tab without cancelling the independently accepted menu. An issued deletion never repeats. Lost recipient authority or an unconfirmed source ACK suppresses effects without replay. Sources lacking fresh exact completion readiness, other command kinds, follower delivery and Restore retain their existing paths; neither queue-producing commands nor cold inputs are pre-completed to manufacture cleanup authority. Ordinary follower ACK proves durable custody but does not hold the recipient worker before execution. Restore's held-command RPCs additionally bind relocation, saved input and canonical release authority; they are not a negotiated Reroute release protocol. Mutating local commands complete after their semantic action, and queue-producing commands retain their separately acknowledged receipts. Startup/historical inputs are excluded by the worker's fresh-source readiness predicate. Those contracts cannot borrow the menu-only barrier by changing command classification or weakening source protection.
+
 - `Membership`: A positively source-linked disposable temporary Thread owns no Pi binding or A–Z slot and may contain multiple independent unassigned inputs, each with its own routing controls. Track exact journal source/group membership, including additional inputs, rather than treating the first chooser or a process-local count as the whole Thread. Serialize admission, selection, cancellation, Restore and cleanup through the existing Workspace admission and mutation owners; unreadable, incomplete, selected, accepted, running or unknown-issued evidence blocks deletion.
 - `Per-input Cancel`: Privately retain the exact original and positively commit source-only cancellation before acknowledging `Routing cancelled` and deleting its one-shot chooser message. Other unassigned inputs retain their choosers and custody; cancelling one input neither delivers nor cancels siblings. No separate Cancel-and-delete action or extra confirmation dialog is required, but the chooser must disclose the conditional whole-tab deletion consequence.
 - `Last-resolution cleanup`: Only an explicit Cancel or positive completion of an explicitly issued Forward that resolves the final known group may schedule deletion of the entire still-temporary Telegram tab, including all its messages. The operator-approved grace is now zero, superseding the earlier 1-second and 2–3-second designs: deletion is attempted right after the chooser is deleted. For Last Cancel, scheduling follows positively recorded whole-group cancellation and successful retirement of the final chooser, not the initial button tap. The timer establishes earliest eligibility for one proof-gated cleanup attempt, not an exact deletion time: Workspace admission, fresh protection checks and Bot API latency may delay or refuse it. Actual client timing was accepted in the operator's 0.52.0 live smoke. Mirrored native witnesses use shortened injected delays, not a production-default or Telegram-client timing measurement. This grace is presentation timing, not proof of emptiness or non-delivery. New input or a changed binding/authority cancels the scheduled cleanup. Immediately before issuance, reacquire current Workspace admission, recheck exact operator/profile/session/leader/source/target authority, positive disposable-tab provenance, complete source dispositions and all Thread protection, then publish the canonical one-shot temporary cleanup grant. A restored/bound Thread or any unresolved/unverifiable work remains protected. TTL, startup, silence and a zero chooser count do not manufacture this last-Cancel grant. Failed/unknown deletion cannot undo cancellation or cause automatic repeat issuance.
@@ -694,7 +698,7 @@ Assistant delivery guarantees:
 - Prompt context blocks use compact metadata (`[tag|key:value]`) as the stable inbound contract. `[telegram...]` names the current surface only: owner/current turns use `[telegram]` or `[telegram|thread:<name>]`; guest-mode turns use `[telegram|guest:<group-title-or-peer-username-or-id>]`. In a private Guest Mode turn the paired owner's `from` identity is never the guest: the remote private-chat identity wins, then non-owner caller metadata, with a non-bot replied peer available only as a final identity fallback when stronger conversation evidence is absent; username falls back to the remote display name and numeric id. Reply attribution still belongs independently in `[reply|from:...]`, and a replied bot can never define or replace the current `[telegram|guest:...]` location identity. Source authors for quoted/forwarded material and their files are carried by `[reply|from:<username-or-id>]`, `[forward|from:<username-or-id>]`, and `[attachments|from:<username-or-id>]`, while plain `[attachments]` remains current-turn attachments and is ordered before reply/forward/source context. Media embedded in inbound Telegram `rich_message` blocks is downloaded like ordinary message media and stays attached to its forward-source block instead of being mislabeled as current-user material. Guest-mode turns append a `[guest]` block to their turn text stating the one-reply/limited-window constraint and instructing a fast, concise, self-contained answer; the note travels with the turn text rather than the system prompt.
 - Quoted rich replies use Telegram `rich_message` blocks as the prompt-context source when available, so `[reply]` context receives rendered plain text instead of raw `InputRichMessage.markdown` fallback text. Replied media runs through the same inbound handlers and voice transcription providers as current-message media, with provenance-scoped `[outputs|from:…]` appended inside the reply block.
 - Long native Markdown replies are split only at Telegram Rich Message transport limits; oversized fenced code, display-math, and fully wrapped inline-formatting blocks are rewrapped per chunk so persisted Rich Markdown chunks remain structurally valid.
-- When Draft previews are enabled, streaming previews pass structurally closed assistant Markdown prefixes through to `sendRichMessageDraft` with ownership checks, voice and guest-turn suppression, and serialized flushes. Telegram Guest Mode allows exactly one answer that cannot be patched afterward, so guest turns never start preview state even while `assistant.draftPreviews` is enabled. Unclosed inline spans, links, fenced code, comments, and display-math blocks are held back until a safe boundary exists. Draft failures are recorded and the failing frame is skipped instead of degrading to raw plain-message previews, because partial Markdown can be invalid while the final message remains valid.
+- When Draft previews are enabled, streaming previews pass structurally closed assistant Markdown prefixes through to `sendRichMessageDraft` with ownership checks, voice and guest-turn suppression, and serialized flushes. Telegram Guest Mode uses one guest answer, normally an early inline placeholder edited at completion, so guest turns never start ordinary preview state even while `assistant.draftPreviews` is enabled. Queued attachments replace the acknowledged placeholder through cached-media edits rather than a second guest answer; supported types, error handling and staging authority follow the [Guest Mode media boundary](./outbound.md#guest-mode-media-boundary). Unclosed inline spans, links, fenced code, comments, and display-math blocks are held back until a safe boundary exists. Draft failures are recorded and the failing frame is skipped instead of degrading to raw plain-message previews, because partial Markdown can be invalid while the final message remains valid.
 - Preview flushes are single-flight within their generation. Publication and final delivery capture only preceding draft/publication dependencies, never later drafts blocked by that publication, and final delivery performs no post-final draft-clear call. Reset/invalidation detaches old-generation dependencies; previously issued transport requests may still settle, but stale draft, timer and publication results cannot clear or mutate replacement work. Successful final text delivery clears local preview state only while its captured segment, session and transport remain active.
 
 UI/compat rendering guarantees:

package/node_modules/@llblab/pi-telegram/docs/multi-instance-bus.md

@@ -311,6 +311,8 @@ Every participating peer must negotiate the required capabilities and retain cur
 
 Semantic reports, queued receipts, completion observation and delivery remain separate. Native exact ACK and donor CAS still own source disposition; lost or mismatched evidence retains uncertainty without handler replay, another queue or fallback admission. This section owns the unified command-channel policy; [architecture](./architecture.md#live-rebind-module-map) owns the module map. Existing Workspace Restore receivers/readers and queue-handoff retain their custody contracts; the new loaded root prefers live rebinding rather than using legacy Restore as an uncertain-input fallback. Source-enabled bounded cleanup is not proof of an actual deletion or client acceptance. Supported leader/follower prompts, commands and templates use `saved → binding applied → cleanup decision → input issuance → native admission/execution`. The chooser holds its existing profile admission through the unchanged whole first delay and one fresh cleanup attempt, without nested leader admission or another queue. A negotiated follower reports work through `observe-held` before release; binding readiness is not execution permission. `inputRelease: held/issued/accepted` is independent of cleanup: an issued input is never replayed after a lost admission reply, and a finished cleanup with held input remains active binding/source protection. Confirmed, failed or unknown terminal deletion permits the one native input attempt only on the confirmed binding. Issued and unknown old-target evidence remains canonically protected against reuse and generic cleanup, including response/publication interruption; unknown evidence survives input acceptance and is never capacity-evicted or reissued. If earlier work prevents issuance, input proceeds on the confirmed new target and the existing paced scheduler owns deferred cleanup; no old-target clearance is invented. Detached command producers accept their one input grant independently from exact source ACKs and reply publication; menu/reply authority tolerates only that issued-to-accepted progress, never changed binding, cleanup, recipient or generation. Expanded templates retain their captured content/default lane and Continue its control lane. A session-replacing `/new` producer with earlier protected work records positively unissued cleanup plus durable `oldTargetProtected`; it cannot erase that old-target protection or transfer a delete grant into the successor. Actual replacement still uses the existing post-removal Pi gateway and confirmation, not Restore readiness. Follower command/control completion retains the exact prepared-source/native ACK before donor CAS; queued admission is not completion and cannot dispose the donor. Unsupported producers do not gain arbitrary follower execution. Older peers keep the preceding supported channel. In deferred cleanup, old-tab cleanup waits for the recipient session to be idle, which the moved input itself may keep busy; its paced retries keep a whole first delay so a detached command reply still sees the released, cleanup-free row, but after that a leader's `agent_settled` or drained output barrier wakes a waiting retry at once. Publication/command-work, Activity handlers, per-target companion queues and target/chat API counters capture lifetime-fenced notifications when work starts and emit only after their pending observation clears. The session adapter defers the hint without awaiting cleanup and rechecks its captured context generation, transport/profile and leader epoch/operator authority. Streaming technical events can drain the publication queue without ending the agent run. A delivery hint while SDK idle is false, unavailable or throwing is retained in the existing chain but does not clear its timer or acquire Workspace admission. `agent_settled` remains an unconditional recheck hint; after settlement, actual remaining delivery drains can wake the retry. A running attempt retains one coalesced hint without a concurrent check, then re-enters the same idle filter after releasing its admission. A fresh timer/settlement attempt consumes the previously deferred hint; signals arriving during that await are not lost. Timer retries, including busy-session samples, are unchanged. Terminal outcomes discard hints, including unknown issued deletion. The initial one-second delay, retry/window fallback, follower pacing and negotiated IPC contracts remain unchanged. Each chain also retains its original generation/profile-store/epoch/operator lifetime rather than rebasing to a reused context. The wake only re-samples every gate through fresh admission; it never grants cleanup, clears unconfirmed work, occupies the publication tail or holds Pi settlement for deletion. Windows runs the same strict paths, exercised by the CI matrix; actual Pi/client acceptance and release are not inferred from supplied IPC fixtures.
 
+Live-rebind old-target cleanup and retained issued/unknown deletion markers use the same provisioning-conflict identity as rebind admission: binding key, slot, legacy owner identity and concrete old/new target. An unrelated intent without a target is retained, but is not a global veto on this exact former binding. The inverse provisioning write checks use the same rule. Fresh provisioning-recovery evidence participates in cleanup observation, publication and captured-recipient API-boundary checks, including after issuance; an exact late target collision or malformed matching recovery still refuses without erasing the intent or retrying a deletion. The ordering remains held input → confirmed new binding → old-tab cleanup decision → input release, not destructive deletion before a replacement binding is established. Native All `/start` regressions cover the successful old-tab deletion/new-tab preservation sequence, an unrelated ambiguous intent, protected busy work and a lost deletion reply. The paired Reroute regression deletes only the exhausted temporary tab and preserves the selected instance's binding. Post-reload operator checks confirmed both idle leader flows: Reroute removes its exhausted temporary tab, while Restore preserves the new tab and removes the old one. This acceptance does not imply every busy-session or follower scenario was exercised.
+
 ### Local IPC endpoint with bounded native paths
 
 Leader opens a local Node `net` endpoint only for the start that still owns its lifecycle: a stop that lands while startup is still replaying cleanup or binding the endpoint makes that start release whatever it brought up and never begin polling, and the startup display-stabilization timer arms only for the start that began it. The endpoint is a Unix-domain socket under the agent temp directory on Unix-like platforms, or a deterministic Windows named pipe (`\\.\pipe\pi-telegram-...`) on native Windows. A filesystem-style endpoint supplied by legacy state or a transport harness normalizes deterministically to the same Windows pipe boundary before listen/connect. On Unix, an endpoint that would exceed conservative domain-socket pathname limits maps to a private user-scoped, hash-derived path under the OS temp directory; ordinary agent paths remain under `tmp/pi-telegram`. On Unix, each server listens on a private generation socket and atomically publishes the stable profile path as a relative symlink; delayed shutdown closes only its private path and cannot remove a replacement generation's link. Followers register, heartbeat, and exchange routed events. The transport boundary owns endpoint derivation, socket-vs-pipe detection, bounded operation-aware retry policy, timeout/transient IPC error classification, endpoint reachability probes, and request-scoped transport events. Follower registration uses a longer registration-specific response timeout than ordinary heartbeat/forwarding calls because the leader may need to provision a Telegram thread before it can return the assigned target; timing out that handshake leaves a visible tab with no follower heartbeat. Keep this handshake to the true critical path: create/reuse the target, persist the live binding, and return it. Connected notices and replaced-thread reconciliation cleanup are non-critical and should run after registration so a follower becomes routable before Telegram client/server UI convergence work finishes.
@@ -587,7 +589,7 @@ For repeated unselected All-tab `/start`, a newer durable source supersedes olde
 
 The bounded pending reroute owns its original source target and the returned chooser message ID independently from remaining messages. Authenticated callbacks must match the stored chat/chooser and any supplied thread field. `InaccessibleMessage` may omit the thread field; a missing callback message, unknown chooser, conflicting identity, threadless source, or already-owned Restore source fails closed rather than forwarding to the old target. Restart or expiry without that pending identity does not authorize reconstruction from callback data alone. When the original input itself has no thread ID (including an All-tab `/start`), the chooser offers routing only, not Restore; old Restore callbacks explain that a plain message must first be sent in the destination thread. Client tab selection is not inferred from recent topic creation or from the chosen Pi instance.
 
-After dispatch, cleanup retries retain source identity but never redispatch accepted messages. Confirmed typed HTTP 400 `message to delete not found` completes message deletion idempotently; permission and transient failures remain errors. Reroute cleanup rechecks current bindings, live targets, reservations, and pending provisions before close, before delete, and on retry. Other destructive cleanup origins use the shared synchronous target-protection policy: explicit retirement permits only its unchanged departing binding, persisted shutdown intent permits only its original pre-intent binding, and reservation/provision cleanup permits only the corresponding unchanged claim. Protection checks also guard post-API local invalidation, reservation, and disconnect completion. A newly protected target cancels remaining cleanup. Already-issued remote operations cannot be undone by a later local ownership change; checks prevent subsequent effects, not retroactive cancellation.
+After dispatch, cleanup retries retain source identity but never redispatch accepted messages. For a fully resolved, positively unbound temporary tab, explicit cleanup may recover historical v1 queued receipts owned by confirmed-dead processes under profile admission and cross-family journal serialization. Strict complete namespace and exact-reference inspection precede whole unoffered receipt CAS recovery; alive/unverifiable owners, offered receipts, malformed sources and unsupported custody remain protective. Protection reads themselves never recover or repair files, and successful recovery is followed by a fresh ordinary protection check before one deletion grant. Confirmed typed HTTP 400 `message to delete not found` completes message deletion idempotently; permission and transient failures remain errors. Reroute cleanup rechecks current bindings, live targets, reservations, and pending provisions before close, before delete, and on retry. Other destructive cleanup origins use the shared synchronous target-protection policy: explicit retirement permits only its unchanged departing binding, persisted shutdown intent permits only its original pre-intent binding, and reservation/provision cleanup permits only the corresponding unchanged claim. Protection checks also guard post-API local invalidation, reservation, and disconnect completion. A newly protected target cancels remaining cleanup. Already-issued remote operations cannot be undone by a later local ownership change; checks prevent subsequent effects, not retroactive cancellation.
 
 Follower Restore uses only the source-bound `leader.workspaceRestore` protocol described under [protocol identity and compatibility](#protocol-identity-and-compatibility). The follower validates the retained operation and exact registration/session authority under read-only canonical snapshot protection; it never persists leader-owned state. Lost apply replies require inspection, not target replacement or another apply grant. Legacy target-replacement requests are rejected before recipient effects.
 

package/node_modules/@llblab/pi-telegram/docs/outbound.md

@@ -80,9 +80,11 @@ Core assistant output accepts only the Markdown or HTML `InputRichMessage` forms
 
 ### Guest Mode media boundary
 
-A Guest Mode reply is one `answerGuestQuery` call carrying exactly one `InlineQueryResult`; it is not a normal chat target and cannot receive `sendDocument`/`sendVoice` multipart uploads through sentinel `chatId: 0`. `telegram_attach` therefore admits at most one file during a guest turn and rejects additional files before queue mutation.
+A Guest Mode reply starts with one `answerGuestQuery` call carrying exactly one `InlineQueryResult`; it is not a normal chat target and cannot receive `sendDocument`/`sendVoice` multipart uploads through sentinel `chatId: 0`. The direct owner normally answers immediately with a placeholder and retains its `inline_message_id` for the final edit. `telegram_attach` admits at most one file during a guest turn and rejects additional files before queue mutation.
 
-Telegram accepts public URLs or existing Telegram `file_id` values for inline media results, but pi-telegram does not publish local artifacts to external hosting. A local guest document, photo, MP3 audio, or OGG/OPUS voice therefore uses a temporary upload to the paired owner's bot chat, extraction of the returned `file_id`, one cached-media guest answer, and best-effort deletion of the staging message. That message can briefly appear or notify the owner. One guest query can carry only one media item, and its answer text must fit the media caption limit rather than a separate full Rich Markdown message.
+Local guest documents, PNG/JPEG photos and MP3 audio use a temporary upload to the paired owner's bot chat, extraction of the returned `file_id`, and best-effort deletion of the staging message. With an acknowledged placeholder, the final result replaces that exact inline message through `editMessageMedia`; it never calls `answerGuestQuery` again. Without a placeholder, delivery retains the single cached-media guest-answer path, including OGG/OPUS voice support. The staging message can briefly appear or notify the owner. One reply carries one media item, with final text truncated to the 1024-character caption limit. No external file hosting or upload to `chatId: 0` is used.
+
+OGG/OPUS voice attachments cannot replace the acknowledged inline placeholder and are rejected before queue mutation; voice markup produces an explicit explanation instead of silently disappearing. Use MP3 audio or a normal bot chat. Upload failures and confirmed media-edit rejections replace the placeholder with a delivery-error notice where possible. An uncertain media-edit outcome is recorded without retrying or overwriting the possibly delivered media. Session/transport authority is checked after placeholder stop and upload, and at final edit issuance; retired work cannot edit, send fallback text or delete staging messages under successor authority. Actual guest-media rendering remains a live-client acceptance check.
 
 Configured text handlers provide `template`. A string is one command; an array is ordered composition. Top-level `args` and `defaults` apply to all composed steps unless a step defines private values. The command-template default timeout applies automatically. Use `template: [...]` for composition; the old local `pipe` alias is removed in 0.13.0. A falsy root `when` skips that handler: inbound and voice selection continue with the next matching handler, while a text transform passes its input through unchanged. A falsy `when` on a composed step, or on any enclosing composition node, skips that step and passes the previous output on. `recover` runs only between failed `retry` attempts of the node that declares it; its output is ignored and a recovery failure stops further retries. `parallel` and `delay` are not executed by these handlers.