@llblab/pi-telegram 0.6.3 → 0.7.1

package/lib/lifecycle.ts

@@ -1,5 +1,6 @@
 /**
  * Telegram lifecycle hook registration helpers
+ * Zones: pi agent lifecycle, telegram session
  * Owns binding prepared Telegram lifecycle runtimes to pi extension lifecycle events
  */
 
@@ -13,6 +14,21 @@ import type {
   SessionStartEvent,
 } from "./pi.ts";
 
+let resetTransportReplyDedupFn: (() => void) | undefined;
+
+export function setResetTransportReplyDedup(fn: () => void): void {
+  resetTransportReplyDedupFn = fn;
+}
+
+export function createAgentStartDedupHook(
+  inner: (event: AgentStartEvent, ctx: ExtensionContext) => Promise<void>,
+): (event: AgentStartEvent, ctx: ExtensionContext) => Promise<void> {
+  return async function onAgentStartDedup(event, ctx) {
+    if (resetTransportReplyDedupFn) resetTransportReplyDedupFn();
+    return inner(event, ctx);
+  };
+}
+
 export interface TelegramBeforeAgentStartResult {
   systemPrompt?: string;
 }
@@ -76,6 +92,16 @@ export interface TelegramSessionLifecycleHooks {
   ) => Promise<void>;
 }
 
+export function createDedupAgentStartHook(
+  dedup: { reset(): void },
+  inner: (event: AgentStartEvent, ctx: ExtensionContext) => Promise<void>,
+): (event: AgentStartEvent, ctx: ExtensionContext) => Promise<void> {
+  return async (event, ctx) => {
+    dedup.reset();
+    await inner(event, ctx);
+  };
+}
+
 export interface TelegramExtraLifecycleHooks {
   onSessionStart?: (
     event: SessionStartEvent,

package/lib/locks.ts

@@ -1,5 +1,6 @@
 /**
  * Telegram singleton lock helpers
+ * Zones: shared singleton, filesystem, telegram runtime ownership
  * Owns shared locks.json access and Telegram bridge ownership semantics
  */
 
@@ -285,7 +286,7 @@ export function createTelegramLockedPollingRuntime<
           ok: false,
           canTakeover: true,
           owner: formatLock(acquired.lock),
-          message: `Telegram bridge is active in another pi instance (${formatLock(acquired.lock)}).`,
+          message: `Telegram bridge is active in another π instance (${formatLock(acquired.lock)}).`,
         };
       }
       await deps.startPolling(ctx);
@@ -298,7 +299,7 @@ export function createTelegramLockedPollingRuntime<
       await suspendPolling();
       const state = deps.lock.release();
       if (state.kind === "active-elsewhere") {
-        return `Telegram bridge is active in another pi instance (${formatLock(state.lock)}).`;
+        return `Telegram bridge is active in another π instance (${formatLock(state.lock)}).`;
       }
       if (state.kind === "stale")
         return `Removed stale Telegram bridge lock (${formatLock(state.lock)}).`;

package/lib/media.ts

@@ -1,5 +1,6 @@
 /**
  * Telegram media and text extraction helpers
+ * Zones: telegram inbound, media groups, filesystem paths
  * Normalizes inbound Telegram messages into reusable file, text, id, history, and media-group metadata
  */