@llblab/pi-kit 0.29.2 → 0.30.0

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

@@ -91,16 +91,14 @@ function createTelegramActivityContext(event, isActive) {
     };
 }
 function canCoalesceActivityEvents(previous, next) {
-    if (previous.activityId !== next.activityId ||
-        previous.type !== next.type) {
+    if (previous.activityId !== next.activityId || previous.type !== next.type) {
         return false;
     }
     if (previous.type === "assistant-text-delta" &&
         next.type === "assistant-text-delta") {
         return previous.contentIndex === next.contentIndex;
     }
-    if (previous.type === "reasoning-delta" &&
-        next.type === "reasoning-delta") {
+    if (previous.type === "reasoning-delta" && next.type === "reasoning-delta") {
         return previous.contentIndex === next.contentIndex;
     }
     if (previous.type === "tool-update" && next.type === "tool-update") {
@@ -113,8 +111,7 @@ function coalesceActivityEvents(previous, next) {
         next.type === "assistant-text-delta") {
         return { ...next, delta: previous.delta + next.delta };
     }
-    if (previous.type === "reasoning-delta" &&
-        next.type === "reasoning-delta") {
+    if (previous.type === "reasoning-delta" && next.type === "reasoning-delta") {
         return { ...next, delta: previous.delta + next.delta };
     }
     return next;
@@ -152,6 +149,7 @@ export function createTelegramActivityDispatcher(deps = {}) {
         }
     };
     return {
+        hasPending: () => Array.from(queues.values()).some((queue) => queue.active && (queue.running || queue.events.length > 0)),
         dispatch(event) {
             if (stopped)
                 return;
@@ -194,6 +192,7 @@ export function createTelegramActivityBridgeRuntime(deps) {
     let runtime;
     const getRuntime = () => runtime;
     return {
+        hasPending: () => getRuntime()?.hasPending?.(),
         onSessionStart() {
             runtime?.onSessionShutdown();
             runtime = createTelegramActivityRuntime({
@@ -298,7 +297,9 @@ export function createTelegramActivityRuntime(deps) {
             sequence,
             source: activitySource,
             ...(activityTarget ? { target: activityTarget } : {}),
-            ...(activityReplyToMessageId !== undefined ? { replyToMessageId: activityReplyToMessageId } : {}),
+            ...(activityReplyToMessageId !== undefined
+                ? { replyToMessageId: activityReplyToMessageId }
+                : {}),
             timestamp: now(),
         };
         try {
@@ -342,13 +343,15 @@ export function createTelegramActivityRuntime(deps) {
             clearActivity();
     };
     return {
+        hasPending: () => deps.dispatcher.hasPending?.(),
         recordInputSource(source) {
             pendingInputSource = source;
         },
         onAgentStart(activeTelegramTarget, replyToMessageId) {
             abandonCompaction();
             ensureActivity(activeTelegramTarget);
-            activityReplyToMessageId = activitySource === "telegram" ? replyToMessageId : undefined;
+            activityReplyToMessageId =
+                activitySource === "telegram" ? replyToMessageId : undefined;
             emit({ type: "agent-start" });
         },
         onAssistantEvent(event) {
@@ -470,12 +473,15 @@ export function createTelegramActivityRuntime(deps) {
 export function createTelegramActivityPublicationRuntime() {
     let generation = 0;
     let tail = Promise.resolve();
+    let outstanding = 0, unconfirmed = false;
     const pending = new Set();
     const reserve = () => {
         const admittedGeneration = generation;
         let state = "pending";
         let resolve;
-        const ready = new Promise((accept) => { resolve = accept; });
+        const ready = new Promise((accept) => {
+            resolve = accept;
+        });
         const cancel = () => {
             if (state !== "pending")
                 return;
@@ -484,10 +490,15 @@ export function createTelegramActivityPublicationRuntime() {
             resolve(undefined);
         };
         pending.add(cancel);
-        const result = tail.then(async () => {
+        outstanding += 1;
+        const result = tail
+            .then(async () => {
             const task = await ready;
             if (admittedGeneration === generation && task)
                 await task();
+        })
+            .finally(() => {
+            outstanding -= 1;
         });
         tail = result.catch(() => { });
         return {
@@ -507,8 +518,26 @@ export function createTelegramActivityPublicationRuntime() {
     return {
         reserve,
         enqueue: (task) => reserve().publish(task),
+        hasPending: () => outstanding > 0,
+        hasUnconfirmed: () => unconfirmed,
+        beginWork() {
+            const admittedGeneration = generation;
+            let settled = false;
+            outstanding += 1;
+            return {
+                settle(outcome) {
+                    if (settled)
+                        return;
+                    settled = true;
+                    outstanding -= 1;
+                    if (outcome === "unconfirmed" && admittedGeneration === generation)
+                        unconfirmed = true;
+                },
+            };
+        },
         reset() {
             generation += 1;
+            unconfirmed = false;
             for (const cancel of pending)
                 cancel();
             tail = Promise.resolve();

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

@@ -12,7 +12,10 @@ export function createTelegramAgentMessageRuntime(deps) {
         const leaderTarget = deps.getLeaderTarget();
         if (leaderTarget?.threadId) {
             targets.push({
-                target: { chatId: leaderTarget.chatId, threadId: leaderTarget.threadId },
+                target: {
+                    chatId: leaderTarget.chatId,
+                    threadId: leaderTarget.threadId,
+                },
                 threadName: deps.getDisplayTitle?.(leaderTarget) ?? deps.getLeaderThreadName(),
             });
         }
@@ -65,8 +68,9 @@ export function createTelegramAgentMessageRuntime(deps) {
             if (allowedChatId === undefined || !ctx) {
                 throw new Error("Telegram agent turn routing is unavailable.");
             }
-            const sourceTitle = (input.sourceTarget ? deps.getDisplayTitle?.(input.sourceTarget) : undefined)
-                ?? input.sourceThreadName;
+            const sourceTitle = (input.sourceTarget
+                ? deps.getDisplayTitle?.(input.sourceTarget)
+                : undefined) ?? input.sourceThreadName;
             const sourceLabel = sourceTitle
                 ?.replace(/[\r\n\[\]]+/g, " ")
                 .trim()

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

@@ -3,14 +3,20 @@
  * Zones: telegram, pi agent, orchestration
  * Owns pi-facing tool, command, and lifecycle hook registration for the entrypoint
  */
-import * as Activity from "./activity.ts";
 import * as ActivityVerbosity from "./activity-verbosity.ts";
+import * as Activity from "./activity.ts";
+import * as BusApi from "./bus-api.ts";
+import type { TelegramBusFollowerCommandOwner } from "./bus-follower.ts";
+import type { TelegramBusLiveRebindWorkState } from "./bus.ts";
 import * as ChannelPosts from "./channel-posts.ts";
 import * as Commands from "./commands.ts";
 import * as Config from "./config.ts";
+import * as Delivery from "./delivery.ts";
+import * as GenerativeApps from "./generative-apps.ts";
 import * as Keyboard from "./keyboard.ts";
 import * as Lifecycle from "./lifecycle.ts";
 import * as Locks from "./locks.ts";
+import * as Menu from "./menu.ts";
 import * as Model from "./model.ts";
 import * as OutboundAttachments from "./outbound-attachments.ts";
 import * as OutboundHandlers from "./outbound.ts";
@@ -18,13 +24,28 @@ import * as Pi from "./pi.ts";
 import * as Preview from "./preview.ts";
 import * as Prompts from "./prompts.ts";
 import * as Queue from "./queue.ts";
+import * as Replies from "./replies.ts";
 import * as Routing from "./routing.ts";
 import * as Runtime from "./runtime.ts";
 import * as Setup from "./setup.ts";
 import * as Status from "./status.ts";
-import * as TelegramApi from "./telegram-api.ts";
 import type { TelegramTarget } from "./target.ts";
-import * as GenerativeApps from "./generative-apps.ts";
+import * as TelegramApi from "./telegram-api.ts";
+/** Compose any registered held command over captured recipient effects; no ordinary follower API fallback. */
+export declare function createTelegramFollowerSelectedCommandBinding<TContext, TModel extends Model.MenuModel = Model.MenuModel>(deps: {
+    ctx: TContext;
+    operationId: string;
+    registrationGeneration: string;
+    name: string;
+    target: TelegramTarget & {
+        threadId: number;
+    };
+    recipient: Pick<TelegramBusFollowerCommandOwner<TContext>, "isCurrent" | "assertRecipientCurrent">;
+    command: Pick<ReturnType<typeof Commands.createTelegramCommandHandlerTargetRuntime<Commands.TelegramCommandRuntimeMessage, TContext>>, "prepareHeldCommand" | "canPrepareHeldCommand">;
+    menu?: Omit<Menu.TelegramMenuActionRuntimeDeps<TContext, TModel>, "sendTextReply" | "sendInteractiveMessage" | "editInteractiveMessage">;
+    deliver: Parameters<typeof BusApi.createTelegramSelectedMenuTextApi>[0]["deliver"];
+    recordOwnership: NonNullable<Replies.TelegramRenderedMessageDeliveryRuntimeDeps<Menu.TelegramReplyMarkup>["recordOwnership"]>;
+}): TelegramBusFollowerCommandOwner<TContext> | undefined;
 type ActivePiModel = NonNullable<Pi.ExtensionContext["model"]>;
 type TelegramRuntimeEventRecorder = (category: string, error: unknown, details?: Record<string, unknown>) => void;
 type TelegramBridgeStatusUpdater = Status.TelegramStatusRuntime<Pi.ExtensionContext>["updateStatus"];
@@ -139,6 +160,9 @@ type TelegramAssistantOutputAuthority<TTransportStamp> = ReturnType<Routing.Tele
 export interface TelegramBridgePublicationRuntime {
     enqueue: Activity.TelegramActivityPublicationRuntime["enqueue"];
     reserve: Activity.TelegramActivityPublicationRuntime["reserve"];
+    hasPending: Activity.TelegramActivityPublicationRuntime["hasPending"];
+    beginWork: Activity.TelegramActivityPublicationRuntime["beginWork"];
+    hasUnconfirmed: Activity.TelegramActivityPublicationRuntime["hasUnconfirmed"];
     capture: () => {
         target?: Queue.TelegramQueueTarget;
         isCurrent: () => boolean;
@@ -156,6 +180,21 @@ export declare function createTelegramActivityBindingRuntime<TTransportStamp>(de
     assistantOutput: Omit<Parameters<typeof createTelegramAssistantOutputBindingRuntime<TTransportStamp>>[0], "waitForActivityIdle" | "enqueue">;
     activityVerbosity: Omit<Parameters<typeof ActivityVerbosity.createTelegramActivityVerbosityRuntime<TelegramAssistantOutputAuthority<TTransportStamp>>>[0], "captureAuthority" | "isAuthorityActive" | "recordFailure" | "enqueue">;
 }): TelegramActivityBindingRuntime;
+/** Fresh current work projection; a snapshot is not a cleanup grant or target-application ACK. */
+export declare function createTelegramLiveTargetWorkObserver<TContext>(deps: {
+    queue: Pick<Queue.TelegramQueueStateStore<TContext>, "getQueuedItems">;
+    activeTurn: Pick<Queue.TelegramActiveTurnStore, "get">;
+    lifecycle: Pick<Runtime.TelegramBridgeRuntime["lifecycle"], "hasDispatchPending" | "isCompactionInProgress" | "getActiveToolExecutions">;
+    isIdle(ctx: TContext): boolean;
+    hasPendingMessages(ctx: TContext): boolean;
+    hasPendingControl(): boolean;
+    publication: Pick<TelegramBridgePublicationRuntime, "hasPending" | "hasUnconfirmed">;
+    activity: Pick<Activity.TelegramActivityRuntime, "hasPending">;
+    delivery: Pick<ReturnType<typeof Delivery.createTelegramDeliveryLifecycleHooks>, "hasPendingTarget">;
+    api: Pick<TelegramApi.TelegramApiTargetActivityRuntime, "hasPendingTarget">;
+}): (target: TelegramTarget & {
+    threadId: number;
+}, ctx: TContext) => TelegramBusLiveRebindWorkState;
 interface TelegramCommandsAndToolsBindingDeps {
     pi: Pi.ExtensionAPI;
     agentDir: string;
@@ -165,7 +204,6 @@ interface TelegramCommandsAndToolsBindingDeps {
     activeTurnRuntime: Queue.TelegramActiveTurnStore<Queue.PendingTelegramTurn>;
     lockedPollingRuntime: Locks.TelegramLockedPollingRuntime<Pi.ExtensionContext>;
     stopPolling?: () => Promise<void | string>;
-    recoverPollingStart?: Commands.TelegramBridgeCommandRegistrationDeps["recoverPollingStart"];
     getDisconnectThreadName?: () => string | undefined;
     onTransportChanged?: () => Promise<void> | void;
     getStatusLines: (options?: Status.TelegramBridgeStatusLineOptions) => string[];
@@ -199,7 +237,7 @@ interface TelegramCommandsAndToolsBindingDeps {
     connectionIntent: NonNullable<Commands.TelegramBridgeCommandRegistrationDeps["connectionIntent"]>;
     recordRuntimeEvent: TelegramRuntimeEventRecorder;
 }
-export declare function registerTelegramCommandsAndTools({ pi, agentDir, configStore, persistConfig, setup, activeTurnRuntime, lockedPollingRuntime, stopPolling, recoverPollingStart, getDisconnectThreadName, onTransportChanged, getStatusLines, buttonActionStore, sendMarkdownReply, sendChannelMarkdownMessage, sendChannelMediaMessage, listChannelPosts, mutateChannelPost, callMultipart, getDefaultChatId, getDefaultTarget, resolveAgentTarget, routeAgentMessage, canSendDirect, setGenerativeAppLiveSurfaceRuntime, recordRuntimeEvent, updateStatus, isContextCurrent, getSessionGeneration, connectionIntent, }: TelegramCommandsAndToolsBindingDeps): void;
+export declare function registerTelegramCommandsAndTools({ pi, agentDir, configStore, persistConfig, setup, activeTurnRuntime, lockedPollingRuntime, stopPolling, getDisconnectThreadName, onTransportChanged, getStatusLines, buttonActionStore, sendMarkdownReply, sendChannelMarkdownMessage, sendChannelMediaMessage, listChannelPosts, mutateChannelPost, callMultipart, getDefaultChatId, getDefaultTarget, resolveAgentTarget, routeAgentMessage, canSendDirect, setGenerativeAppLiveSurfaceRuntime, recordRuntimeEvent, updateStatus, isContextCurrent, getSessionGeneration, connectionIntent, }: TelegramCommandsAndToolsBindingDeps): void;
 interface TelegramLifecycleBindingDeps {
     pi: Pi.ExtensionAPI;
     publicationRuntime: TelegramBridgePublicationRuntime;

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

@@ -3,14 +3,17 @@
  * Zones: telegram, pi agent, orchestration
  * Owns pi-facing tool, command, and lifecycle hook registration for the entrypoint
  */
-import * as Activity from "./activity.js";
 import * as ActivityVerbosity from "./activity-verbosity.js";
+import * as Activity from "./activity.js";
+import * as BusApi from "./bus-api.js";
 import * as ChannelPosts from "./channel-posts.js";
 import * as CommandTemplates from "./command-templates.js";
 import * as Commands from "./commands.js";
 import * as Config from "./config.js";
 import * as Delivery from "./delivery.js";
+import * as GenerativeApps from "./generative-apps.js";
 import * as Lifecycle from "./lifecycle.js";
+import * as Menu from "./menu.js";
 import * as OutboundAttachments from "./outbound-attachments.js";
 import * as OutboundHandlers from "./outbound.js";
 import * as Pi from "./pi.js";
@@ -21,7 +24,91 @@ import * as Routing from "./routing.js";
 import * as Runtime from "./runtime.js";
 import * as Setup from "./setup.js";
 import * as TelegramApi from "./telegram-api.js";
-import * as GenerativeApps from "./generative-apps.js";
+/** Compose any registered held command over captured recipient effects; no ordinary follower API fallback. */
+export function createTelegramFollowerSelectedCommandBinding(deps) {
+    const { ctx, operationId, registrationGeneration, name, recipient, command, deliver, recordOwnership, } = deps, target = { ...deps.target };
+    const prepare = command.prepareHeldCommand, canPrepare = command.canPrepareHeldCommand;
+    const isCurrent = recipient.isCurrent, assertRecipientCurrent = recipient.assertRecipientCurrent, menu = deps.menu, menuPorts = menu && { ...menu };
+    if ([
+        prepare,
+        canPrepare,
+        isCurrent,
+        assertRecipientCurrent,
+        deliver,
+        recordOwnership,
+    ].some((port) => typeof port !== "function") ||
+        (menuPorts &&
+            [
+                menuPorts.getModelMenuState,
+                menuPorts.storeModelMenuState,
+                menuPorts.getActiveModel,
+                menuPorts.getThinkingLevel,
+                menuPorts.buildStatusHtml,
+                menuPorts.isIdle,
+                menuPorts.canOfferInFlightModelSwitch,
+            ].some((port) => typeof port !== "function")))
+        return undefined;
+    const portsCurrent = () => deps.ctx === ctx &&
+        deps.operationId === operationId &&
+        deps.registrationGeneration === registrationGeneration &&
+        deps.name === name &&
+        deps.recipient === recipient &&
+        recipient.isCurrent === isCurrent &&
+        recipient.assertRecipientCurrent === assertRecipientCurrent &&
+        deps.command === command &&
+        command.prepareHeldCommand === prepare &&
+        command.canPrepareHeldCommand === canPrepare &&
+        deps.deliver === deliver &&
+        deps.recordOwnership === recordOwnership &&
+        deps.menu === menu &&
+        (!menuPorts ||
+            Object.entries(menuPorts).every(([key, value]) => Reflect.get(menu, key) === value));
+    const current = () => portsCurrent() && isCurrent.call(recipient) && portsCurrent();
+    if (!current())
+        return undefined;
+    const api = BusApi.createTelegramSelectedMenuTextApi({
+        operationId,
+        registrationGeneration,
+        target,
+        assertAuthority: assertRecipientCurrent,
+        deliver,
+    });
+    const rendered = Replies.createTelegramRenderedMessageDeliveryRuntime({
+        sendMessage: api.sendMessage,
+        editMessage: api.editMessageText,
+        recordOwnership,
+        async sendRichMessage() {
+            throw new Error("Selected command has no rich or ordinary API fallback.");
+        },
+    });
+    const menus = menuPorts &&
+        Menu.createTelegramMenuActionRuntime({
+            ...menuPorts,
+            sendTextReply: rendered.sendTextReply,
+            sendInteractiveMessage: rendered.sendInteractiveMessage,
+            editInteractiveMessage: rendered.editInteractiveMessage,
+        });
+    const effects = {
+        sendTextReply: rendered.sendTextReply,
+        ...(menus ? { showStatus: menus.sendStatusMessage } : {}),
+    };
+    if (!canPrepare.call(command, name, effects) || !current())
+        return undefined;
+    return {
+        isCurrent: current,
+        assertRecipientCurrent,
+        prepare(readiness, context, input) {
+            if (!current() ||
+                context !== ctx ||
+                input.target.chatId !== target.chatId ||
+                input.target.threadId !== target.threadId ||
+                input.assertRecipientCurrent !== assertRecipientCurrent)
+                return undefined;
+            const plan = prepare.call(command, name, readiness, context, input, effects);
+            return current() ? plan : undefined;
+        },
+    };
+}
 export function createTelegramQueueBindingRuntime(deps) {
     const settleDiscardedItems = (items, ctx) => {
         const durableItems = items.filter((item) => (item.admissionReceipts?.length ?? 0) > 0);
@@ -100,7 +187,9 @@ export function createTelegramQueueBindingRuntime(deps) {
 export function createTelegramGenerativeAppLiveSurfaceBinding() {
     let current;
     return {
-        get() { return current; },
+        get() {
+            return current;
+        },
         set(runtime) {
             current?.shutdown();
             current = runtime;
@@ -314,6 +403,9 @@ export function createTelegramActivityBindingRuntime(deps) {
         publicationRuntime: {
             enqueue: publication.enqueue,
             reserve: publication.reserve,
+            hasPending: publication.hasPending,
+            beginWork: publication.beginWork,
+            hasUnconfirmed: publication.hasUnconfirmed,
             capture() {
                 const authority = assistantOutputBinding.authority.captureAuthority();
                 return {
@@ -324,7 +416,37 @@ export function createTelegramActivityBindingRuntime(deps) {
         },
     };
 }
-export function registerTelegramCommandsAndTools({ pi, agentDir, configStore, persistConfig, setup, activeTurnRuntime, lockedPollingRuntime, stopPolling, recoverPollingStart, getDisconnectThreadName, onTransportChanged, getStatusLines, buttonActionStore, sendMarkdownReply, sendChannelMarkdownMessage, sendChannelMediaMessage, listChannelPosts, mutateChannelPost, callMultipart, getDefaultChatId, getDefaultTarget, resolveAgentTarget, routeAgentMessage, canSendDirect, setGenerativeAppLiveSurfaceRuntime, recordRuntimeEvent, updateStatus, isContextCurrent, getSessionGeneration, connectionIntent, }) {
+/** Fresh current work projection; a snapshot is not a cleanup grant or target-application ACK. */
+export function createTelegramLiveTargetWorkObserver(deps) {
+    return (target, ctx) => {
+        const work = Queue.observeTelegramTargetQueueWork(target, deps.activeTurn.get(), deps.queue.getQueuedItems());
+        const flags = [
+            deps.isIdle(ctx),
+            deps.hasPendingMessages(ctx),
+            deps.lifecycle.hasDispatchPending(),
+            deps.lifecycle.isCompactionInProgress(),
+            deps.hasPendingControl(),
+        ];
+        const tools = deps.lifecycle.getActiveToolExecutions();
+        const publication = deps.publication.hasPending(), unconfirmed = deps.publication.hasUnconfirmed?.(), activity = deps.activity.hasPending?.(), delivery = deps.delivery.hasPendingTarget(target), api = deps.api.hasPendingTarget(target);
+        const unknown = work.unknown ||
+            flags.some((flag) => typeof flag !== "boolean") ||
+            !Number.isSafeInteger(tools) ||
+            tools < 0 ||
+            unconfirmed !== false ||
+            [publication, activity, delivery, api].some((flag) => typeof flag !== "boolean");
+        return {
+            sessionBusy: flags[0] !== true || flags.slice(1).some(Boolean) || tools > 0,
+            targetWork: work.protected,
+            deliveryPending: publication === true ||
+                activity === true ||
+                delivery === true ||
+                api === true,
+            unknown,
+        };
+    };
+}
+export function registerTelegramCommandsAndTools({ pi, agentDir, configStore, persistConfig, setup, activeTurnRuntime, lockedPollingRuntime, stopPolling, getDisconnectThreadName, onTransportChanged, getStatusLines, buttonActionStore, sendMarkdownReply, sendChannelMarkdownMessage, sendChannelMediaMessage, listChannelPosts, mutateChannelPost, callMultipart, getDefaultChatId, getDefaultTarget, resolveAgentTarget, routeAgentMessage, canSendDirect, setGenerativeAppLiveSurfaceRuntime, recordRuntimeEvent, updateStatus, isContextCurrent, getSessionGeneration, connectionIntent, }) {
     GenerativeApps.registerTelegramBindTool(pi, {
         agentDir,
         getActiveProfileName: configStore.getActiveProfileName,
@@ -334,13 +456,18 @@ export function registerTelegramCommandsAndTools({ pi, agentDir, configStore, pe
             : {}),
         isDeliveryHandleCurrent: Delivery.isTelegramDeliveryHandleCurrent,
         editView: (handle, view) => Delivery.editTelegramView(handle, view),
-        planOutput: OutboundHandlers.createTelegramOutboundReplyPlanner(buttonActionStore, Config.createTelegramConfigControls(configStore).getAssistantRenderingMode),
+        planOutput: OutboundHandlers.createTelegramOutboundReplyPlanner(buttonActionStore, Config.createTelegramConfigControls(configStore)
+            .getAssistantRenderingMode),
         sendMarkdownReply,
         sendView: (view, options) => Delivery.sendTelegramView(view, options),
         recordRuntimeEvent,
     });
-    ChannelPosts.registerTelegramChannelPostMutationTool(pi, { mutate: mutateChannelPost });
-    ChannelPosts.registerTelegramChannelPostListTool(pi, { list: listChannelPosts });
+    ChannelPosts.registerTelegramChannelPostMutationTool(pi, {
+        mutate: mutateChannelPost,
+    });
+    ChannelPosts.registerTelegramChannelPostListTool(pi, {
+        list: listChannelPosts,
+    });
     OutboundAttachments.registerTelegramOutboundAttachmentTool(pi, {
         getActiveTurn: activeTurnRuntime.get,
         getDefaultChatId,
@@ -356,7 +483,8 @@ export function registerTelegramCommandsAndTools({ pi, agentDir, configStore, pe
         resolveAgentTarget,
         routeAgentMessage,
         canSendDirect,
-        planMessage: OutboundHandlers.createTelegramOutboundReplyPlanner(buttonActionStore, Config.createTelegramConfigControls(configStore).getAssistantRenderingMode),
+        planMessage: OutboundHandlers.createTelegramOutboundReplyPlanner(buttonActionStore, Config.createTelegramConfigControls(configStore)
+            .getAssistantRenderingMode),
         sendMarkdownMessage: (chatId, markdown, options) => sendMarkdownReply(chatId, undefined, markdown, options),
         sendChannelMarkdownMessage,
         sendChannelMediaMessage,
@@ -456,7 +584,6 @@ export function registerTelegramCommandsAndTools({ pi, agentDir, configStore, pe
         startPolling: lockedPollingRuntime.start,
         recordConnectionEvent: (error, phase) => recordRuntimeEvent("connection", error, { phase }),
         stopPolling: stopPolling ?? lockedPollingRuntime.stop,
-        recoverPollingStart,
         getDisconnectThreadName,
         queueAgentConnectionContext,
         updateStatus,
@@ -599,7 +726,9 @@ export function registerTelegramLifecycleRuntimeHooks({ pi, publicationRuntime,
         pendingFinalPublication = undefined;
     };
     const recordPublicationFailure = (error) => {
-        recordRuntimeEvent("delivery", error, { phase: "agent-end-background-delivery" });
+        recordRuntimeEvent("delivery", error, {
+            phase: "agent-end-background-delivery",
+        });
     };
     const scheduleActiveTurnDelivery = (task) => {
         void publicationRuntime.enqueue(task).catch(recordPublicationFailure);
@@ -630,7 +759,8 @@ export function registerTelegramLifecycleRuntimeHooks({ pi, publicationRuntime,
         getActiveTurn: activeTurnRuntime.get,
         loadConfig: configStore.load,
         extractAssistant: Replies.extractRunAssistantMessage,
-        isAssistantAlreadyPublished: (assistant) => !!assistant.text && assistantOutputRuntime.hasAdmittedTelegramIntermediate(assistant.text),
+        isAssistantAlreadyPublished: (assistant) => !!assistant.text &&
+            assistantOutputRuntime.hasAdmittedTelegramIntermediate(assistant.text),
         getFoldQueuedPromptsIntoHistory: lifecycle.shouldFoldQueuedPromptsIntoHistory,
         resetRuntimeState: agentEndResetter,
         isSessionActive: isSessionContextActive,
@@ -647,7 +777,9 @@ export function registerTelegramLifecycleRuntimeHooks({ pi, publicationRuntime,
                 pending?.reservation.cancel();
             const reservation = matches && pending ? pending.reservation : publicationRuntime.reserve();
             return {
-                schedule: (task) => { void reservation.publish(task).catch(recordPublicationFailure); },
+                schedule: (task) => {
+                    void reservation.publish(task).catch(recordPublicationFailure);
+                },
                 cancel: reservation.cancel,
             };
         },
@@ -673,8 +805,7 @@ export function registerTelegramLifecycleRuntimeHooks({ pi, publicationRuntime,
         setActiveToolExecutions: lifecycle.setActiveToolExecutions,
         triggerPendingModelSwitchAbort: modelSwitchController.triggerPendingAbort,
     });
-    Lifecycle.setResetTransportReplyDedup(Replies.resetTransportReplyDedup);
-    const agentStartWithDedupReset = Lifecycle.createAgentStartDedupHook(agentLifecycleHooks.onAgentStart, scheduleActiveTurnDelivery);
+    const agentStartWithDedupReset = Lifecycle.createAgentStartDedupHook(agentLifecycleHooks.onAgentStart, Replies.resetTransportReplyDedup, scheduleActiveTurnDelivery);
     let uiPromptActive = false;
     const startAgentActivityTypingLoop = (ctx) => {
         if (uiPromptActive || !canSendAgentActivity(ctx))
@@ -705,7 +836,9 @@ export function registerTelegramLifecycleRuntimeHooks({ pi, publicationRuntime,
             if (turn && isTurnTransportActive?.(turn) === false)
                 return;
             try {
-                await sendMarkdownReply(target.chatId, replyToMessageId, text, { target });
+                await sendMarkdownReply(target.chatId, replyToMessageId, text, {
+                    target,
+                });
             }
             catch (error) {
                 recordRuntimeEvent("delivery", error, { phase: "compaction-notice" });
@@ -879,16 +1012,25 @@ export function registerTelegramLifecycleRuntimeHooks({ pi, publicationRuntime,
                 previewRuntime.seal();
                 activityRuntime.onAssistantMessageEnd(event.message.stopReason);
             }
-            if (event.message.role !== "assistant" || event.message.stopReason === "toolUse" || event.message.stopReason === "aborted")
+            if (event.message.role !== "assistant" ||
+                event.message.stopReason === "toolUse" ||
+                event.message.stopReason === "aborted")
                 return;
             const turn = activeTurnRuntime.get();
             if (!turn || turn.guestQueryId || pendingFinalPublication?.turn === turn)
                 return;
             cancelPendingFinalPublication();
-            const assistant = Replies.extractLatestAssistantMessageText([event.message]);
-            if (!assistant.text && assistant.stopReason !== "error" && turn.queuedAttachments.length === 0)
+            const assistant = Replies.extractLatestAssistantMessageText([
+                event.message,
+            ]);
+            if (!assistant.text &&
+                assistant.stopReason !== "error" &&
+                turn.queuedAttachments.length === 0)
                 return;
-            pendingFinalPublication = { turn, reservation: publicationRuntime.reserve() };
+            pendingFinalPublication = {
+                turn,
+                reservation: publicationRuntime.reserve(),
+            };
         },
         onUiPromptStart(event, ctx) {
             if (!isSessionContextActive(ctx))
@@ -911,7 +1053,8 @@ export function registerTelegramLifecycleRuntimeHooks({ pi, publicationRuntime,
         async onAgentEnd(event, ctx) {
             if (!isSessionContextActive(ctx))
                 return;
-            if (pendingFinalPublication && pendingFinalPublication.turn !== activeTurnRuntime.get()) {
+            if (pendingFinalPublication &&
+                pendingFinalPublication.turn !== activeTurnRuntime.get()) {
                 cancelPendingFinalPublication();
                 return;
             }

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

@@ -3,6 +3,7 @@
  * Zones: multi-instance bus, telegram api transport, live instance routing
  * Wraps the direct Telegram Bot API runtime so follower instances can route outbound calls through the bus leader
  */
+import { type TelegramBusSelectedMenuDeliveryObservation, type TelegramBusSelectedMenuTextEffect } from "./bus.ts";
 import type { TelegramBridgeApiRuntime } from "./telegram-api.ts";
 export type TelegramBusApiCall = (method: string, args: unknown[]) => Promise<unknown>;
 export interface TelegramBusAwareApiRuntimeDeps {
@@ -14,4 +15,15 @@ export interface TelegramBusAwareApiRuntimeDeps {
         threadId?: number;
     } | undefined;
 }
+/** Bound selected-menu projection only; no ordinary/raw API fallback and no activation during preparation. */
+export declare function createTelegramSelectedMenuTextApi(deps: {
+    operationId: string;
+    registrationGeneration: string;
+    target: {
+        chatId: number;
+        threadId: number;
+    };
+    assertAuthority: () => void;
+    deliver(effect: TelegramBusSelectedMenuTextEffect, assertAuthority: () => void): Promise<TelegramBusSelectedMenuDeliveryObservation>;
+}): Pick<TelegramBridgeApiRuntime, "sendMessage" | "editMessageText">;
 export declare function createTelegramBusAwareApiRuntime(deps: TelegramBusAwareApiRuntimeDeps): TelegramBridgeApiRuntime;