@llblab/pi-telegram 0.48.1 → 0.48.3

package/CHANGELOG.md

@@ -4,6 +4,15 @@
 
 ## Unreleased
 
+## 0.48.3: Assistant publication identity hotfix
+
+- `Thread restore display identity`: Restoring or reclaiming a Thread now renames the destination from its current Workspace display title when available, rather than leaking the internal baked slot name such as `Moss` into directory-title mode.
+- `Assistant publication identity`: An empty terminal assistant message may recover an earlier preserved answer, but it no longer republishes that text when the same Telegram intermediate output was already admitted; the pre-send turn fence also prevents lost-acknowledgement retries while allowing later turns.
+
+## 0.48.2: Follower promotion recovery
+
+- `Follower promotion recovery`: A failed follower-to-leader promotion, including unavailable Thread slot authority, is now contained as a retryable bus recovery event instead of escaping a detached heartbeat recovery promise and terminating Pi.
+
 ## 0.48.1: Truthful terminal queue count hotfix
 
 - `Terminal queue status`: The yellow `+N` suffix now counts only executable prompts still waiting in the Telegram queue. The current agent run never contributes—whether it started from Telegram, the terminal, or autonomous continuation—and a dispatched Telegram prompt leaves the visible count before its run settles.

package/dist/lib/activity.d.ts

@@ -201,7 +201,9 @@ export interface TelegramActivityPublicationRuntime {
 export declare function createTelegramActivityPublicationRuntime(): TelegramActivityPublicationRuntime;
 export interface TelegramAssistantOutputRuntime {
     start: () => void;
+    beginTurn: () => void;
     accept: (event: TelegramAssistantSegmentEvent) => void;
+    hasAdmittedTelegramIntermediate: (text: string) => boolean;
     waitForIdle: () => Promise<void>;
     stop: () => void;
 }

package/dist/lib/activity.js

@@ -520,6 +520,7 @@ export function createTelegramAssistantOutputRuntime(deps) {
     let running = false;
     let tail = Promise.resolve();
     const admitted = new Set();
+    const admittedTelegramIntermediateText = new Set();
     const isEligibleEvent = (event) => (event.source === "telegram" && event.placement === "intermediate") ||
         event.source === "local" ||
         event.source === "autonomous" ||
@@ -529,8 +530,12 @@ export function createTelegramAssistantOutputRuntime(deps) {
             generation += 1;
             running = true;
             admitted.clear();
+            admittedTelegramIntermediateText.clear();
             tail = Promise.resolve();
         },
+        beginTurn() {
+            admittedTelegramIntermediateText.clear();
+        },
         accept(event) {
             if (!running || !isEligibleEvent(event) || !event.text.trim())
                 return;
@@ -538,6 +543,9 @@ export function createTelegramAssistantOutputRuntime(deps) {
             if (admitted.has(key))
                 return;
             admitted.add(key);
+            if (event.source === "telegram" && event.placement === "intermediate") {
+                admittedTelegramIntermediateText.add(event.text.trim());
+            }
             const admittedGeneration = generation;
             const admittedAuthority = deps.captureAuthority?.();
             const preparation = deps.prepareSend?.(event);
@@ -562,6 +570,9 @@ export function createTelegramAssistantOutputRuntime(deps) {
                 }
             }).finally(() => preparation?.settle());
         },
+        hasAdmittedTelegramIntermediate(text) {
+            return admittedTelegramIntermediateText.has(text.trim());
+        },
         waitForIdle() {
             return tail;
         },
@@ -569,6 +580,7 @@ export function createTelegramAssistantOutputRuntime(deps) {
             generation += 1;
             running = false;
             admitted.clear();
+            admittedTelegramIntermediateText.clear();
         },
     };
 }

package/dist/lib/bindings.d.ts

@@ -202,7 +202,7 @@ interface TelegramLifecycleBindingDeps {
     publicationRuntime: TelegramBridgePublicationRuntime;
     activityRuntime: Activity.TelegramActivityRuntime;
     activityVerbosityRuntime?: ActivityVerbosity.TelegramActivityVerbosityRuntime;
-    assistantOutputRuntime: Pick<Activity.TelegramAssistantOutputRuntime, "start" | "waitForIdle" | "stop">;
+    assistantOutputRuntime: Pick<Activity.TelegramAssistantOutputRuntime, "start" | "beginTurn" | "hasAdmittedTelegramIntermediate" | "waitForIdle" | "stop">;
     sessionLifecycleRuntime: Pick<Lifecycle.TelegramLifecycleRegistrationDeps, "onSessionStart" | "onSessionShutdown" | "onModelSelect">;
     configStore: Pick<Config.TelegramConfigStore, "get" | "getOutboundHandlers" | "hasBotToken" | "load">;
     abort: Runtime.TelegramRuntimeAbortPort;

package/dist/lib/bindings.js

@@ -615,7 +615,10 @@ export function registerTelegramLifecycleRuntimeHooks({ pi, publicationRuntime,
         clearDispatchPending: lifecycle.clearDispatchPending,
         setFoldQueuedPromptsIntoHistory: lifecycle.setFoldQueuedPromptsIntoHistory,
         setActiveTurn: activeTurnRuntime.set,
-        onPromptHandedOff,
+        onPromptHandedOff: (turn, ctx) => {
+            assistantOutputRuntime.beginTurn();
+            onPromptHandedOff?.(turn, ctx);
+        },
         createPreviewState: previewRuntime.resetState,
         startTypingLoop: (ctx) => {
             const turn = activeTurnRuntime.get();
@@ -627,6 +630,7 @@ export function registerTelegramLifecycleRuntimeHooks({ pi, publicationRuntime,
         getActiveTurn: activeTurnRuntime.get,
         loadConfig: configStore.load,
         extractAssistant: Replies.extractRunAssistantMessage,
+        isRecoveredAssistantAlreadyPublished: (assistant) => !!assistant.text && assistantOutputRuntime.hasAdmittedTelegramIntermediate(assistant.text),
         getFoldQueuedPromptsIntoHistory: lifecycle.shouldFoldQueuedPromptsIntoHistory,
         resetRuntimeState: agentEndResetter,
         isSessionActive: isSessionContextActive,

package/dist/lib/bus-follower.js

@@ -821,8 +821,8 @@ export function createTelegramBusFollowerHeartbeatRecoveryHandler(deps) {
             return;
         promotionPending = true;
         deps.registrationState.beginRecovery();
+        const initialBinding = carriedBinding ?? snapshotBinding();
         try {
-            const initialBinding = carriedBinding ?? snapshotBinding();
             const state = deps.getLeaderState();
             if (state.kind === "active-elsewhere") {
                 clearRegisteredState(ctx);
@@ -862,7 +862,10 @@ export function createTelegramBusFollowerHeartbeatRecoveryHandler(deps) {
                 });
                 return;
             }
-            throw promotionError;
+            deps.recordRuntimeEvent("bus", promotionError, {
+                phase: "follower-promotion-failed",
+            });
+            scheduleRecovery(promotionError, ctx, initialBinding);
         }
         finally {
             promotionPending = false;

package/dist/lib/queue.d.ts

@@ -393,6 +393,7 @@ export interface TelegramAgentEndAssistantResult {
     text?: string;
     stopReason?: string;
     errorMessage?: string;
+    recoveredFromEarlier?: boolean;
 }
 export interface TelegramAgentEndOutboundVoiceReply {
     text: string;
@@ -468,6 +469,7 @@ export interface TelegramAgentEndHookRuntimeDeps<TTurn extends PendingTelegramTu
     getActiveTurn: () => TTurn | undefined;
     loadConfig?: () => Promise<void>;
     extractAssistant: (messages: readonly TMessage[]) => TelegramAgentEndAssistantResult;
+    isRecoveredAssistantAlreadyPublished?: (assistant: TelegramAgentEndAssistantResult) => boolean;
     getFoldQueuedPromptsIntoHistory: () => boolean;
     resetRuntimeState: () => void;
     isSessionActive?: (ctx: TContext) => boolean;

package/dist/lib/queue.js

@@ -853,7 +853,11 @@ export function createTelegramAgentEndHook(deps) {
         if (deps.isSessionActive?.(ctx) === false)
             return;
         const turn = deps.getActiveTurn();
-        const assistant = assistantOverride ?? (turn ? deps.extractAssistant(event.messages) : {});
+        const extractedAssistant = assistantOverride ?? (turn ? deps.extractAssistant(event.messages) : {});
+        const assistant = extractedAssistant.recoveredFromEarlier &&
+            deps.isRecoveredAssistantAlreadyPublished?.(extractedAssistant)
+            ? { stopReason: extractedAssistant.stopReason }
+            : extractedAssistant;
         const hasPublication = !!assistant.text || assistant.stopReason === "error" || !!turn?.queuedAttachments.length;
         const reservation = turn && !turn.guestQueryId && hasPublication ? deps.reserveActiveTurnDelivery?.() : undefined;
         const scheduleDelivery = reservation?.schedule ?? deps.scheduleActiveTurnDelivery;

package/dist/lib/replies.d.ts

@@ -44,6 +44,7 @@ export declare function extractRunAssistantMessage(messages: readonly unknown[])
     text?: string;
     stopReason?: string;
     errorMessage?: string;
+    recoveredFromEarlier?: boolean;
 };
 export interface TelegramReplyOwnershipRecorder {
     record: (input: {

package/dist/lib/replies.js

@@ -142,6 +142,7 @@ export function extractRunAssistantMessage(messages) {
             text,
             stopReason: typeof rawStopReason === "string" ? rawStopReason : undefined,
             errorMessage: typeof rawErrorMessage === "string" ? rawErrorMessage : undefined,
+            recoveredFromEarlier: true,
         };
     }
     return latest;

package/dist/lib/routing.js

@@ -923,7 +923,8 @@ export function createTelegramInboundRouteRuntime(deps) {
                     await deps.callApi("editForumTopic", {
                         chat_id: sourceTarget.chatId,
                         message_thread_id: sourceTarget.threadId,
-                        name: Threads.getTelegramTopicTitleForThreadName(threadName, slot),
+                        name: deps.getDisplayTitle?.(sourceTarget) ??
+                            Threads.getTelegramTopicTitleForThreadName(threadName, slot),
                     });
                     assertExecutionCurrent();
                 }
@@ -1024,7 +1025,8 @@ export function createTelegramInboundRouteRuntime(deps) {
                     await deps.callApi("editForumTopic", {
                         chat_id: sourceTarget.chatId,
                         message_thread_id: sourceTarget.threadId,
-                        name: Threads.getTelegramTopicTitleForThreadName(threadName, slot),
+                        name: deps.getDisplayTitle?.(sourceTarget) ??
+                            Threads.getTelegramTopicTitleForThreadName(threadName, slot),
                     });
                     assertExecutionCurrent();
                 }

package/dist/package.json

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

package/lib/activity.ts

@@ -804,7 +804,9 @@ export function createTelegramActivityPublicationRuntime(): TelegramActivityPubl
 
 export interface TelegramAssistantOutputRuntime {
   start: () => void;
+  beginTurn: () => void;
   accept: (event: TelegramAssistantSegmentEvent) => void;
+  hasAdmittedTelegramIntermediate: (text: string) => boolean;
   waitForIdle: () => Promise<void>;
   stop: () => void;
 }
@@ -834,6 +836,7 @@ export function createTelegramAssistantOutputRuntime<TAuthority = undefined>(dep
   let running = false;
   let tail: Promise<void> = Promise.resolve();
   const admitted = new Set<string>();
+  const admittedTelegramIntermediateText = new Set<string>();
   const isEligibleEvent = (event: TelegramAssistantSegmentEvent): boolean =>
     (event.source === "telegram" && event.placement === "intermediate") ||
     event.source === "local" ||
@@ -845,13 +848,20 @@ export function createTelegramAssistantOutputRuntime<TAuthority = undefined>(dep
       generation += 1;
       running = true;
       admitted.clear();
+      admittedTelegramIntermediateText.clear();
       tail = Promise.resolve();
     },
+    beginTurn() {
+      admittedTelegramIntermediateText.clear();
+    },
     accept(event) {
       if (!running || !isEligibleEvent(event) || !event.text.trim()) return;
       const key = `${event.activityId}:${event.sequence}`;
       if (admitted.has(key)) return;
       admitted.add(key);
+      if (event.source === "telegram" && event.placement === "intermediate") {
+        admittedTelegramIntermediateText.add(event.text.trim());
+      }
       const admittedGeneration = generation;
       const admittedAuthority = deps.captureAuthority?.();
       const preparation = deps.prepareSend?.(event);
@@ -877,6 +887,9 @@ export function createTelegramAssistantOutputRuntime<TAuthority = undefined>(dep
         }
       }).finally(() => preparation?.settle());
     },
+    hasAdmittedTelegramIntermediate(text) {
+      return admittedTelegramIntermediateText.has(text.trim());
+    },
     waitForIdle() {
       return tail;
     },
@@ -884,6 +897,7 @@ export function createTelegramAssistantOutputRuntime<TAuthority = undefined>(dep
       generation += 1;
       running = false;
       admitted.clear();
+      admittedTelegramIntermediateText.clear();
     },
   };
 }

package/lib/bindings.ts

@@ -835,7 +835,7 @@ interface TelegramLifecycleBindingDeps {
   activityVerbosityRuntime?: ActivityVerbosity.TelegramActivityVerbosityRuntime;
   assistantOutputRuntime: Pick<
     Activity.TelegramAssistantOutputRuntime,
-    "start" | "waitForIdle" | "stop"
+    "start" | "beginTurn" | "hasAdmittedTelegramIntermediate" | "waitForIdle" | "stop"
   >;
   sessionLifecycleRuntime: Pick<
     Lifecycle.TelegramLifecycleRegistrationDeps,
@@ -1136,7 +1136,10 @@ export function registerTelegramLifecycleRuntimeHooks({
     clearDispatchPending: lifecycle.clearDispatchPending,
     setFoldQueuedPromptsIntoHistory: lifecycle.setFoldQueuedPromptsIntoHistory,
     setActiveTurn: activeTurnRuntime.set,
-    onPromptHandedOff,
+    onPromptHandedOff: (turn, ctx) => {
+      assistantOutputRuntime.beginTurn();
+      onPromptHandedOff?.(turn, ctx);
+    },
     createPreviewState: previewRuntime.resetState,
     startTypingLoop: (ctx) => {
       const turn = activeTurnRuntime.get();
@@ -1148,6 +1151,8 @@ export function registerTelegramLifecycleRuntimeHooks({
     getActiveTurn: activeTurnRuntime.get,
     loadConfig: configStore.load,
     extractAssistant: Replies.extractRunAssistantMessage,
+    isRecoveredAssistantAlreadyPublished: (assistant) =>
+      !!assistant.text && assistantOutputRuntime.hasAdmittedTelegramIntermediate(assistant.text),
     getFoldQueuedPromptsIntoHistory:
       lifecycle.shouldFoldQueuedPromptsIntoHistory,
     resetRuntimeState: agentEndResetter,

package/lib/bus-follower.ts

@@ -1496,8 +1496,8 @@ export function createTelegramBusFollowerHeartbeatRecoveryHandler<TContext>(
     if (promotionPending) return;
     promotionPending = true;
     deps.registrationState.beginRecovery();
+    const initialBinding = carriedBinding ?? snapshotBinding();
     try {
-      const initialBinding = carriedBinding ?? snapshotBinding();
       const state = deps.getLeaderState();
       if (state.kind === "active-elsewhere") {
         clearRegisteredState(ctx);
@@ -1563,7 +1563,10 @@ export function createTelegramBusFollowerHeartbeatRecoveryHandler<TContext>(
         });
         return;
       }
-      throw promotionError;
+      deps.recordRuntimeEvent("bus", promotionError, {
+        phase: "follower-promotion-failed",
+      });
+      scheduleRecovery(promotionError, ctx, initialBinding);
     } finally {
       promotionPending = false;
     }

package/lib/queue.ts

@@ -1474,6 +1474,7 @@ export interface TelegramAgentEndAssistantResult {
   text?: string;
   stopReason?: string;
   errorMessage?: string;
+  recoveredFromEarlier?: boolean;
 }
 
 export interface TelegramAgentEndOutboundVoiceReply {
@@ -1592,6 +1593,7 @@ export interface TelegramAgentEndHookRuntimeDeps<
   extractAssistant: (
     messages: readonly TMessage[],
   ) => TelegramAgentEndAssistantResult;
+  isRecoveredAssistantAlreadyPublished?: (assistant: TelegramAgentEndAssistantResult) => boolean;
   getFoldQueuedPromptsIntoHistory: () => boolean;
   resetRuntimeState: () => void;
   isSessionActive?: (ctx: TContext) => boolean;
@@ -1736,7 +1738,11 @@ export function createTelegramAgentEndHook<
   ): Promise<void> => {
     if (deps.isSessionActive?.(ctx) === false) return;
     const turn = deps.getActiveTurn();
-    const assistant = assistantOverride ?? (turn ? deps.extractAssistant(event.messages) : {});
+    const extractedAssistant = assistantOverride ?? (turn ? deps.extractAssistant(event.messages) : {});
+    const assistant = extractedAssistant.recoveredFromEarlier &&
+        deps.isRecoveredAssistantAlreadyPublished?.(extractedAssistant)
+      ? { stopReason: extractedAssistant.stopReason }
+      : extractedAssistant;
     const hasPublication = !!assistant.text || assistant.stopReason === "error" || !!turn?.queuedAttachments.length;
     const reservation = turn && !turn.guestQueryId && hasPublication ? deps.reserveActiveTurnDelivery?.() : undefined;
     const scheduleDelivery = reservation?.schedule ?? deps.scheduleActiveTurnDelivery;

package/lib/replies.ts

@@ -191,6 +191,7 @@ export function extractRunAssistantMessage(
   text?: string;
   stopReason?: string;
   errorMessage?: string;
+  recoveredFromEarlier?: boolean;
 } {
   const latest = extractLatestAssistantMessageText(messages);
   if (latest.text || latest.stopReason !== "stop") return latest;
@@ -213,6 +214,7 @@ export function extractRunAssistantMessage(
       stopReason: typeof rawStopReason === "string" ? rawStopReason : undefined,
       errorMessage:
         typeof rawErrorMessage === "string" ? rawErrorMessage : undefined,
+      recoveredFromEarlier: true,
     };
   }
   return latest;

package/lib/routing.ts

@@ -1560,7 +1560,9 @@ export function createTelegramInboundRouteRuntime<
           await deps.callApi("editForumTopic", {
             chat_id: sourceTarget.chatId,
             message_thread_id: sourceTarget.threadId,
-            name: Threads.getTelegramTopicTitleForThreadName(threadName, slot),
+            name:
+              deps.getDisplayTitle?.(sourceTarget) ??
+              Threads.getTelegramTopicTitleForThreadName(threadName, slot),
           });
           assertExecutionCurrent();
         } catch (renameError) {
@@ -1717,7 +1719,9 @@ export function createTelegramInboundRouteRuntime<
           await deps.callApi("editForumTopic", {
             chat_id: sourceTarget.chatId,
             message_thread_id: sourceTarget.threadId,
-            name: Threads.getTelegramTopicTitleForThreadName(threadName, slot),
+            name:
+              deps.getDisplayTitle?.(sourceTarget) ??
+              Threads.getTelegramTopicTitleForThreadName(threadName, slot),
           });
           assertExecutionCurrent();
         } catch (renameError) {

package/package.json

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