@llblab/pi-telegram 0.12.0 → 0.13.0

package/lib/preview.ts

@@ -9,7 +9,7 @@ import type {
   TelegramReplyParameters,
   TelegramSendMessageBody,
   TelegramSentMessage,
-} from "./api.ts";
+} from "./telegram-api.ts";
 import {
   buildTelegramPreviewSnapshot,
   MAX_MESSAGE_LENGTH,

package/lib/queue.ts

@@ -44,6 +44,9 @@ export interface TelegramQueueLaneContract {
 
 export const TELEGRAM_QUEUE_LANE_CONTRACTS: readonly TelegramQueueLaneContract[] =
   [
+    // Control lane intentionally accepts both direct controls and resume prompts.
+    // Model-switch continuations need prompt semantics but must run before queued user work.
+    // Do not admit ordinary user prompts here without an explicit control-flow reason.
     {
       lane: "control",
       admissionMode: "control-queue",

package/lib/replies.ts

@@ -4,7 +4,10 @@
  * Owns rendered-message delivery, reply transport wiring, and plain or markdown final replies
  */
 
-import type { TelegramReplyParameters, TelegramSentMessage } from "./api.ts";
+import type {
+  TelegramReplyParameters,
+  TelegramSentMessage,
+} from "./telegram-api.ts";
 import {
   renderTelegramMessage,
   type TelegramRenderedChunk,

package/lib/status.ts

@@ -289,12 +289,25 @@ function formatTelegramRuntimeEvent(event: TelegramRuntimeEvent): string {
   return `${new Date(event.at).toISOString()} ${formatTelegramRuntimeEventSummary(event)}`;
 }
 
+function buildTelegramRuntimeEventSummary(events: TelegramRuntimeEvent[]): string {
+  const counts = new Map<string, number>();
+  for (const event of events) {
+    const category = formatTelegramRuntimeEventCategory(event);
+    counts.set(category, (counts.get(category) ?? 0) + 1);
+  }
+  return Array.from(counts.entries())
+    .sort(([left], [right]) => left.localeCompare(right))
+    .map(([category, count]) => `${category}=${count}`)
+    .join(", ");
+}
+
 export function buildTelegramRuntimeEventLines(
   events: TelegramRuntimeEvent[],
 ): string[] {
   if (events.length === 0) return ["recent runtime events: none"];
   return [
     "recent runtime events:",
+    `- summary: ${buildTelegramRuntimeEventSummary(events)}`,
     ...events
       .slice()
       .reverse()

package/lib/{api.ts → telegram-api.ts}

@@ -416,13 +416,13 @@ async function writeTelegramDownloadResponse(
   if (!response.body) {
     const buffer = Buffer.from(await response.arrayBuffer());
     assertTelegramFileSizeWithinLimit(buffer.byteLength, maxFileSizeBytes);
-    await writeFile(targetPath, buffer);
+    await writeFile(targetPath, buffer, { mode: 0o600 });
     return;
   }
   await pipeline(
     Readable.from(response.body, { objectMode: false }),
     createTelegramDownloadLimitTransform(maxFileSizeBytes),
-    createWriteStream(targetPath),
+    createWriteStream(targetPath, { mode: 0o600 }),
   );
 }
 
@@ -536,7 +536,7 @@ export async function prepareTelegramTempDir(
   tempDir: string,
   maxAgeMs: number,
 ): Promise<number> {
-  await mkdir(tempDir, { recursive: true });
+  await mkdir(tempDir, { recursive: true, mode: 0o700 });
   return cleanupTelegramTempFiles(tempDir, maxAgeMs);
 }
 
@@ -630,7 +630,7 @@ export async function downloadTelegramFile(
     { signal: options?.signal },
   );
   assertTelegramFileSizeWithinLimit(file.file_size, options?.maxFileSizeBytes);
-  await mkdir(tempDir, { recursive: true });
+  await mkdir(tempDir, { recursive: true, mode: 0o700 });
   const targetPath = join(
     tempDir,
     `${randomUUID()}-${sanitizeFileName(suggestedName)}`,

package/lib/text-groups.ts

@@ -6,7 +6,7 @@
 
 const TELEGRAM_TEXT_GROUP_DEBOUNCE_MS = 1000;
 const TELEGRAM_TEXT_GROUP_MIN_SPLIT_LENGTH = 3600;
-const TELEGRAM_TEXT_GROUP_MAX_MESSAGE_ID_GAP = 10;
+const TELEGRAM_TEXT_GROUP_MAX_MESSAGE_ID_GAP = 12;
 
 export interface TelegramTextGroupMessage {
   message_id: number;
@@ -92,7 +92,8 @@ function canAppendTelegramTextGroupMessage<
   return (
     !!previous &&
     message.message_id > previous.message_id &&
-    message.message_id <= previous.message_id + TELEGRAM_TEXT_GROUP_MAX_MESSAGE_ID_GAP &&
+    message.message_id <=
+      previous.message_id + TELEGRAM_TEXT_GROUP_MAX_MESSAGE_ID_GAP &&
     text.length > 0 &&
     !isTelegramTextGroupCommand(text)
   );

package/lib/voice.ts

@@ -23,6 +23,21 @@ const VOICE_SYNTHESIS_PROVIDER_REGISTRY_KEY =
 const VOICE_TRANSCRIPTION_PROVIDER_REGISTRY_KEY =
   "__piTelegramVoiceTranscriptionProviders__";
 
+let nextGeneratedVoiceSynthesisProviderId = 0;
+let nextGeneratedVoiceTranscriptionProviderId = 0;
+
+function getNextAvailableProviderId<T>(
+  registry: Map<string, T>,
+  prefix: string,
+  nextId: () => number,
+): string {
+  let id: string;
+  do {
+    id = `${prefix}-${nextId()}`;
+  } while (registry.has(id));
+  return id;
+}
+
 export type TelegramVoiceReplyMode = "mirror" | "always" | "manual";
 
 export type TelegramVoiceSynthesisProviderResult =
@@ -106,7 +121,13 @@ export function registerTelegramVoiceSynthesisProvider(
   options?: { id?: string },
 ): () => void {
   const registry = getOrCreateVoiceSynthesisProviderRegistry();
-  const id = options?.id ?? `voice-synthesis-provider-${registry.size}`;
+  const id =
+    options?.id ??
+    getNextAvailableProviderId(
+      registry,
+      "voice-synthesis-provider",
+      () => nextGeneratedVoiceSynthesisProviderId++,
+    );
   const normalized =
     typeof provider === "function"
       ? (Object.assign(
@@ -123,7 +144,7 @@ export function registerTelegramVoiceSynthesisProvider(
       : provider;
   registry.set(id, normalized);
   return () => {
-    registry.delete(id);
+    if (registry.get(id) === normalized) registry.delete(id);
   };
 }
 
@@ -168,10 +189,16 @@ export function registerTelegramVoiceTranscriptionProvider(
   options?: { id?: string },
 ): () => void {
   const registry = getOrCreateVoiceTranscriptionProviderRegistry();
-  const id = options?.id ?? `voice-transcription-provider-${registry.size}`;
+  const id =
+    options?.id ??
+    getNextAvailableProviderId(
+      registry,
+      "voice-transcription-provider",
+      () => nextGeneratedVoiceTranscriptionProviderId++,
+    );
   registry.set(id, provider);
   return () => {
-    registry.delete(id);
+    if (registry.get(id) === provider) registry.delete(id);
   };
 }
 
@@ -303,12 +330,12 @@ export function shouldSuppressPreviewForVoice(
   return !!(turn?.voiceReplyPreferred || turn?.voiceReplyRequired);
 }
 
-// --- Outbound Handler Re-Exports ---
+// --- Outbound Markup Re-Exports ---
 
 export {
+  normalizeMarkdownAfterVoiceExtraction,
   planTelegramVoiceReply,
-  stripTelegramCommentMarkupForPreview,
   stripTelegramCommentMarkupForDelivery,
+  stripTelegramCommentMarkupForPreview,
   stripTelegramVoiceMarkupForPreview,
-  normalizeMarkdownAfterVoiceExtraction,
-} from "./outbound.ts";
+} from "./outbound-markup.ts";

package/package.json

@@ -1,21 +1,11 @@
 {
   "name": "@llblab/pi-telegram",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "private": false,
   "publishConfig": {
     "access": "public"
   },
   "description": "Telegram runtime adapter for π",
-  "type": "module",
-  "exports": {
-    ".": "./index.ts",
-    "./inbound": "./api/inbound.ts",
-    "./outbound": "./api/outbound.ts",
-    "./updates": "./api/updates.ts",
-    "./sections": "./api/sections.ts",
-    "./voice": "./api/voice.ts",
-    "./keyboard": "./api/keyboard.ts"
-  },
   "keywords": [
     "pi-package",
     "pi",
@@ -23,6 +13,7 @@
     "bot",
     "extension"
   ],
+  "type": "module",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -33,7 +24,7 @@
     "url": "https://github.com/llblab/pi-telegram/issues"
   },
   "engines": {
-    "node": ">=22.0.0"
+    "node": ">=22.19.0"
   },
   "scripts": {
     "test": "node --experimental-strip-types --test tests/*.test.ts",
@@ -53,6 +44,15 @@
     "docs/",
     "screenshot.png"
   ],
+  "exports": {
+    ".": "./index.ts",
+    "./inbound": "./api/inbound.ts",
+    "./outbound": "./api/outbound.ts",
+    "./updates": "./api/updates.ts",
+    "./sections": "./api/sections.ts",
+    "./voice": "./api/voice.ts",
+    "./keyboard": "./api/keyboard.ts"
+  },
   "pi": {
     "extensions": [
       "./index.ts"