@llblab/pi-telegram 0.11.2 → 0.12.0

package/lib/menu-settings.ts

@@ -7,7 +7,7 @@
 import {
   getTelegramExtensionSettingsRows,
   type TelegramSectionRegistry,
-} from "./extension-sections.ts";
+} from "./sections.ts";
 import type { TelegramTimeMode } from "./config.ts";
 import type { TelegramInlineKeyboardMarkup } from "./keyboard.ts";
 import type { TelegramModelMenuState } from "./menu-model.ts";
@@ -115,7 +115,8 @@ export interface TelegramSettingsMenuRuntimeDeps<
 
 export const SETTINGS_MENU_TITLE = "<b>⚙️ Settings:</b>";
 export const PROACTIVE_PUSH_SETTINGS_TITLE = "<b>📌 Proactive push:</b>";
-export const TIME_INJECTION_MODE_SETTINGS_TITLE = "<b>🕒 Time injection mode:</b>";
+export const TIME_INJECTION_MODE_SETTINGS_TITLE =
+  "<b>🕒 Time injection mode:</b>";
 export const VOICE_REPLY_MODE_SETTINGS_TITLE = "<b>👄 Voice reply mode:</b>";
 
 type TelegramVoiceReplyModeSetting = TelegramVoiceReplyMode | "hidden";
@@ -124,6 +125,10 @@ function getVoiceReplyModeLabel(mode: TelegramVoiceReplyModeSetting): string {
   return mode;
 }
 
+function getTelegramSettingsStateValueLabel(value: string): string {
+  return value.length > 0 ? value[0]!.toUpperCase() + value.slice(1) : value;
+}
+
 function getVoiceReplyModeSetting(
   mode: TelegramVoiceReplyMode,
   configured: boolean,
@@ -197,21 +202,23 @@ export function buildTelegramSettingsMenuReplyMarkup(
   rows.push(
     [
       {
-        text: `👄 Voice reply: ${getVoiceReplyModeLabel(
-          getVoiceReplyModeSetting(voiceReplyMode, voiceReplyModeConfigured),
+        text: `👄 Voice reply: ${getTelegramSettingsStateValueLabel(
+          getVoiceReplyModeLabel(
+            getVoiceReplyModeSetting(voiceReplyMode, voiceReplyModeConfigured),
+          ),
         )}`,
         callback_data: "settings:open:voice-reply",
       },
     ],
     [
       {
-        text: `🕒 Time injection: ${timeInjectionMode}`,
+        text: `🕒 Time injection: ${getTelegramSettingsStateValueLabel(timeInjectionMode)}`,
         callback_data: "settings:open:time-injection",
       },
     ],
     [
       {
-        text: `📌 Proactive push: ${proactivePushEnabled ? "on" : "off"}`,
+        text: `📌 Proactive push: ${proactivePushEnabled ? "On" : "Off"}`,
         callback_data: "settings:open:proactive",
       },
     ],
@@ -251,11 +258,11 @@ export function buildProactivePushSettingsReplyMarkup(
       [{ text: "⬆️ Back", callback_data: "settings:list" }],
       [
         {
-          text: proactivePushEnabled ? "🟢 on" : "⚫️ on",
+          text: proactivePushEnabled ? "🟢 On" : "⚫️ On",
           callback_data: "settings:set:proactive:on",
         },
         {
-          text: proactivePushEnabled ? "⚫️ off" : "🟡 off",
+          text: proactivePushEnabled ? "⚫️ Off" : "🟡 Off",
           callback_data: "settings:set:proactive:off",
         },
       ],
@@ -372,7 +379,10 @@ export async function handleTelegramSettingsMenuCallbackAction(
     await deps.answerCallbackQuery(callbackQueryId);
     return true;
   }
-  if (data === "settings:open:time-injection" || data === "settings:open:time") {
+  if (
+    data === "settings:open:time-injection" ||
+    data === "settings:open:time"
+  ) {
     await updateTimeInjectionModeSettingsMessage(deps);
     await deps.answerCallbackQuery(callbackQueryId);
     return true;
@@ -506,7 +516,8 @@ export function createTelegramSettingsMenuRuntime<
           ? query.data.slice("settings:set:time-injection:".length)
           : query.data.slice("settings:set:time:".length);
         if (
-          (hasTimeInjectionPrefix || query.data.startsWith("settings:set:time:")) &&
+          (hasTimeInjectionPrefix ||
+            query.data.startsWith("settings:set:time:")) &&
           (timeMode === "off" ||
             timeMode === "hidden" ||
             timeMode === "always" ||

package/lib/menu-status.ts

@@ -8,7 +8,7 @@ import { formatTelegramCommandEmojiPrefix } from "./commands.ts";
 import {
   getTelegramSectionMainMenuRows,
   type TelegramSectionRegistry,
-} from "./extension-sections.ts";
+} from "./sections.ts";
 import {
   formatStatusButtonLabel,
   type TelegramMenuMessageRuntimeDeps,

package/lib/menu.ts

@@ -10,7 +10,7 @@ import {
   handleTelegramSectionSettingsOpen,
   parseTelegramSectionCallback,
   type TelegramSectionRegistry,
-} from "./extension-sections.ts";
+} from "./sections.ts";
 import {
   createTelegramModelMenuStateBuilder,
   handleTelegramModelMenuCallbackAction,

package/lib/{outbound-handlers.ts → outbound.ts}

@@ -1,7 +1,7 @@
 /**
- * Telegram outbound handler helpers
+ * Telegram outbound surface helpers
  * Zones: telegram outbound, assistant markup, command templates, callback routing
- * Owns assistant-authored outbound markup extraction, configured artifact generation, callback actions, and Telegram outbound delivery
+ * Owns assistant-authored outbound markup extraction, configured artifact generation, callback actions, runtime-event bridge, and Telegram outbound delivery
  */
 
 import { randomUUID } from "node:crypto";
@@ -61,6 +61,18 @@ const DEFAULT_VOICE_TIMEOUT_MS = 120_000;
  * diagnostics alongside pi-telegram's own events. Events are silently dropped
  * when pi-telegram is not loaded.
  */
+export type TelegramRuntimeEventRecorder = (
+  category: string,
+  error: unknown,
+  details?: Record<string, unknown>,
+) => void;
+
+export function bindTelegramRuntimeEventRecorder(
+  recorder: TelegramRuntimeEventRecorder,
+): void {
+  (globalThis as Record<string, unknown>)[VOICE_EVENT_RECORDER_KEY] = recorder;
+}
+
 export function recordTelegramRuntimeEvent(
   category: string,
   error: unknown,
@@ -70,13 +82,7 @@ export function recordTelegramRuntimeEvent(
     VOICE_EVENT_RECORDER_KEY
   ];
   if (typeof recorder === "function") {
-    (
-      recorder as (
-        category: string,
-        error: unknown,
-        details?: Record<string, unknown>,
-      ) => void
-    )(category, error, details);
+    (recorder as TelegramRuntimeEventRecorder)(category, error, details);
   }
 }
 
@@ -1028,7 +1034,9 @@ export function createTelegramVoiceReplySender(
         });
         return;
       } catch (error) {
-        deps.recordRuntimeEvent?.("voice", error, { phase: "template-handler-send" });
+        deps.recordRuntimeEvent?.("voice", error, {
+          phase: "template-handler-send",
+        });
       }
     }
 
@@ -1045,7 +1053,9 @@ export function createTelegramVoiceReplySender(
         });
         return;
       } catch (error) {
-        deps.recordRuntimeEvent?.("voice", error, { phase: "programmatic-handler-send" });
+        deps.recordRuntimeEvent?.("voice", error, {
+          phase: "programmatic-handler-send",
+        });
       }
     }
 

package/lib/polling.ts

@@ -1,5 +1,5 @@
 /**
- * Telegram polling domain helpers
+ * Telegram polling runtime domain helpers
  * Zones: telegram transport, polling runtime
  * Owns polling request builders, stop conditions, and the long-poll loop runtime for Telegram updates
  */
@@ -91,8 +91,9 @@ export function createTelegramPollingActivityReader(
   return () => isTelegramPollingControllerActive(state);
 }
 
-export interface TelegramPollingRuntimeDeps<TContext>
-  extends TelegramRuntimeEventRecorderPort {
+export interface TelegramPollingRuntimeDeps<
+  TContext,
+> extends TelegramRuntimeEventRecorderPort {
   hasBotToken: () => boolean;
   getPollingPromise: () => Promise<void> | undefined;
   setPollingPromise: (promise: Promise<void> | undefined) => void;

package/lib/preview.ts

@@ -22,7 +22,7 @@ import {
 } from "./rendering.ts";
 
 import { buildTelegramReplyParameters } from "./replies.ts";
-import { stripTelegramCommentMarkupForPreview } from "./outbound-handlers.ts";
+import { stripTelegramCommentMarkupForPreview } from "./outbound.ts";
 import { shouldSuppressPreviewForVoice } from "./voice.ts";
 
 const TELEGRAM_PREVIEW_THROTTLE_MS = 750;

package/lib/routing.ts

@@ -7,12 +7,12 @@
 import { readFile } from "node:fs/promises";
 import * as Commands from "./commands.ts";
 import type { TelegramConfigStore } from "./config.ts";
-import type { TelegramSectionRegistry } from "./extension-sections.ts";
-import type { TelegramInboundHandlerRuntime } from "./inbound-handlers.ts";
+import type { TelegramSectionRegistry } from "./sections.ts";
+import type { TelegramInboundHandlerRuntime } from "./inbound.ts";
 import * as Media from "./media.ts";
 import * as Menu from "./menu.ts";
 import * as Model from "./model.ts";
-import * as OutboundHandlers from "./outbound-handlers.ts";
+import * as OutboundHandlers from "./outbound.ts";
 import * as PromptTemplates from "./prompt-templates.ts";
 import * as Queue from "./queue.ts";
 import type { TelegramBridgeRuntime } from "./runtime.ts";
@@ -138,6 +138,7 @@ export interface TelegramInboundRouteRuntimeDeps<
 }
 
 const TELEGRAM_OWNED_CALLBACK_PREFIXES = [
+  "compact:",
   "menu:",
   "model:",
   "queue:",
@@ -262,6 +263,45 @@ export function createTelegramInboundRouteRuntime<
       );
       if (handled) return;
     }
+    const handledByCompact =
+      await Commands.handleTelegramCompactConfirmationCallback(query, {
+        ctx,
+        answerCallbackQuery: deps.answerCallbackQuery,
+        editInteractiveMessage: deps.editInteractiveMessage ?? (async () => {}),
+        runCompact: async (compactCtx, chatId, replyToMessageId) => {
+          await Commands.handleTelegramCompactCommand({
+            isIdle: () => deps.isIdle(compactCtx),
+            hasPendingMessages: () => deps.hasPendingMessages(compactCtx),
+            hasActiveTelegramTurn: deps.activeTurnRuntime.has,
+            hasDispatchPending: deps.bridgeRuntime.lifecycle.hasDispatchPending,
+            hasQueuedTelegramItems: deps.telegramQueueStore.hasQueuedItems,
+            isCompactionInProgress:
+              deps.bridgeRuntime.lifecycle.isCompactionInProgress,
+            setCompactionInProgress:
+              deps.bridgeRuntime.lifecycle.setCompactionInProgress,
+            updateStatus: () => deps.updateStatus(compactCtx),
+            dispatchNextQueuedTelegramTurn: () =>
+              deps.dispatchNextQueuedTelegramTurn(compactCtx),
+            requestDeferredDispatchNextQueuedTelegramTurn:
+              deps.requestDeferredDispatchNextQueuedTelegramTurn
+                ? (dispatch) =>
+                    deps.requestDeferredDispatchNextQueuedTelegramTurn?.(() =>
+                      dispatch(),
+                    )
+                : undefined,
+            compact: (callbacks) => deps.compact(compactCtx, callbacks),
+            startTypingLoop: deps.startTypingLoop
+              ? () => deps.startTypingLoop?.(compactCtx, chatId)
+              : undefined,
+            stopTypingLoop: deps.stopTypingLoop,
+            sendTextReply: (text) =>
+              deps.sendTextReply(chatId, replyToMessageId, text).then(() => {}),
+            suppressStartNotice: true,
+            recordRuntimeEvent: deps.recordRuntimeEvent,
+          });
+        },
+      });
+    if (handledByCompact) return;
     const handledByQueue = await deps.queueMenuCallbackHandler(query, ctx);
     if (handledByQueue) return;
     const handledBySettings = await deps.settingsMenuCallbackHandler?.(
@@ -372,6 +412,7 @@ export function createTelegramInboundRouteRuntime<
     getPromptTemplateCommands,
     persistConfig: deps.configStore.persist,
     sendTextReply: deps.sendTextReply,
+    sendInteractiveMessage: deps.sendInteractiveMessage,
     recordRuntimeEvent: deps.recordRuntimeEvent,
   });
   const promptEnqueue = Queue.createTelegramPromptEnqueueController<

package/lib/{extension-sections.ts → sections.ts}

@@ -1,12 +1,13 @@
 /**
  * Telegram Extension Sections registry and callback routing
  * Zones: telegram ui, extension platform, callback routing
- * Owns section registration, token mapping, main-menu/settings row injection, and section callback dispatch
+ * Owns section registration, global registry binding, token mapping, main-menu/settings row injection, and section callback dispatch
  */
 
 import type { TelegramInlineKeyboardMarkup } from "./keyboard.ts";
 
 const SECTION_REGISTRY_KEY = "__piTelegramSectionRegistry__";
+const TELEGRAM_CALLBACK_DATA_MAX_BYTES = 64;
 
 // --- Core Types ---
 
@@ -181,9 +182,7 @@ function buildTelegramSectionContext(
         .then(() => {}),
     enqueuePrompt: deps.enqueuePrompt,
     callbackData: (action, payload) =>
-      payload
-        ? `section:${token}:${action}:${payload}`
-        : `section:${token}:${action}`,
+      buildTelegramSectionCallbackData(token, action, payload),
     deleteMessage: () =>
       messageId !== undefined
         ? deps.deleteMessage(chatId, messageId)
@@ -231,9 +230,7 @@ function buildTelegramSectionCallbackContext(
         .then(() => {}),
     enqueuePrompt: deps.enqueuePrompt,
     callbackData: (action, payload) =>
-      payload
-        ? `section:${token}:${action}:${payload}`
-        : `section:${token}:${action}`,
+      buildTelegramSectionCallbackData(token, action, payload),
     deleteMessage: () =>
       messageId !== undefined
         ? deps.deleteMessage(chatId, messageId)
@@ -250,6 +247,13 @@ export function setGlobalTelegramSectionRegistry(
   (globalThis as Record<string, unknown>)[SECTION_REGISTRY_KEY] = registry;
 }
 
+/** @internal */
+export function createAndBindTelegramSectionRegistry(): TelegramSectionRegistry {
+  const registry = createTelegramExtensionSectionRegistry();
+  setGlobalTelegramSectionRegistry(registry);
+  return registry;
+}
+
 /**
  * Register a Telegram Extension Section from any pi extension.
  * Returns a disposer. Throws if no section registry is active.
@@ -271,8 +275,8 @@ export function registerTelegramSection(
 
 /**
  * Get current section diagnostics. Returns empty array when registry is absent.
+ * @internal
  */
-/** @internal */
 export function getTelegramSectionDiagnostics(): TelegramSectionDiagnostic[] {
   const registry = (globalThis as Record<string, unknown>)[
     SECTION_REGISTRY_KEY
@@ -291,6 +295,27 @@ const BACK_NAV_ROW = {
   text: "⬆️ Back",
 } as const;
 
+function getUtf8ByteLength(value: string): number {
+  return new TextEncoder().encode(value).byteLength;
+}
+
+function buildTelegramSectionCallbackData(
+  token: TelegramSectionToken,
+  action: string,
+  payload?: string,
+): string {
+  const data = payload
+    ? `section:${token}:${action}:${payload}`
+    : `section:${token}:${action}`;
+  const byteLength = getUtf8ByteLength(data);
+  if (byteLength > TELEGRAM_CALLBACK_DATA_MAX_BYTES) {
+    throw new Error(
+      `Telegram section callback_data exceeds ${TELEGRAM_CALLBACK_DATA_MAX_BYTES} bytes (${byteLength}). Use a shorter action/payload or store state behind a compact key.`,
+    );
+  }
+  return data;
+}
+
 function prependBackRow(
   replyMarkup: TelegramInlineKeyboardMarkup | undefined,
   backCallback: string,
@@ -319,6 +344,10 @@ export function createTelegramExtensionSectionRegistry(): TelegramSectionRegistr
   let nextToken = 0;
 
   function register(section: TelegramSectionRegistration): () => void {
+    const duplicate = [...sections.values()].find((s) => s.id === section.id);
+    if (duplicate) {
+      throw new Error(`Telegram section id already registered: ${section.id}`);
+    }
     const token = String(nextToken++);
     const registered: RegisteredTelegramSection = {
       id: section.id,

package/lib/updates.ts

@@ -1,7 +1,7 @@
 /**
  * Telegram updates domain helpers
  * Zones: telegram inbound, authorization, routing plans
- * Owns update extraction, authorization, classification, execution planning, and runtime execution for Telegram updates
+ * Owns update extraction, authorization, classification, execution planning, runtime execution, and the public update-handler registry
  */
 
 import {
@@ -851,3 +851,123 @@ export async function executeTelegramUpdatePlan<
     if (!isTelegramStaleContextError(error)) throw error;
   }
 }
+
+// --- Public update handler registry ---
+
+/**
+ * Verdict returned by a public Telegram update handler.
+ *
+ * - `"consume"` — the handler processed this update; pi-telegram skips default routing.
+ * - `"pass"` (or `void`/`undefined`) — pi-telegram routes the update normally.
+ */
+export type TelegramUpdateHandlerVerdict = "consume" | "pass";
+
+export type TelegramUpdateHandler = (
+  update: unknown,
+) =>
+  | TelegramUpdateHandlerVerdict
+  | void
+  | Promise<TelegramUpdateHandlerVerdict | void>;
+
+export interface TelegramUpdateHandlerRegistry {
+  /** Schema version of this registry shape. */
+  readonly version: 1;
+  /**
+   * Register an update handler. Returns a disposer that removes it.
+   *
+   * Handlers are invoked in registration order on every Telegram update,
+   * before pi-telegram's own routing. The first handler that returns
+   * `"consume"` wins and stops the chain for that update.
+   */
+  add: (handler: TelegramUpdateHandler) => () => void;
+  /**
+   * Run all registered handlers against an update.
+   *
+   * Used by pi-telegram's polling runtime; companion extensions should call
+   * {@link registerTelegramUpdateHandler} or `add` instead of dispatching directly.
+   */
+  dispatch: (update: unknown) => Promise<TelegramUpdateHandlerVerdict>;
+}
+
+const UPDATE_HANDLER_REGISTRY_KEY = "__piTelegramUpdateHandlerRegistry__";
+
+function isValidV1UpdateHandlerRegistry(
+  candidate: unknown,
+): candidate is TelegramUpdateHandlerRegistry {
+  if (!candidate || typeof candidate !== "object") return false;
+  const r = candidate as Partial<TelegramUpdateHandlerRegistry>;
+  return (
+    r.version === 1 &&
+    typeof r.add === "function" &&
+    typeof r.dispatch === "function"
+  );
+}
+
+function getOrCreateUpdateHandlerRegistry(): TelegramUpdateHandlerRegistry {
+  const g = globalThis as Record<string, unknown>;
+  const existing = g[UPDATE_HANDLER_REGISTRY_KEY];
+  if (isValidV1UpdateHandlerRegistry(existing)) return existing;
+  const handlers = new Set<TelegramUpdateHandler>();
+  const registry: TelegramUpdateHandlerRegistry = {
+    version: 1,
+    add(handler) {
+      handlers.add(handler);
+      return () => handlers.delete(handler);
+    },
+    async dispatch(update) {
+      for (const handler of handlers) {
+        try {
+          const result = await handler(update);
+          if (result === "consume") return "consume";
+        } catch {
+          // Update handler errors must not break polling.
+        }
+      }
+      return "pass";
+    },
+  };
+  g[UPDATE_HANDLER_REGISTRY_KEY] = registry;
+  return registry;
+}
+
+/**
+ * Called by pi-telegram's own runtime to obtain the registry it dispatches
+ * through. Companion extensions should not call this; use
+ * {@link registerTelegramUpdateHandler} instead.
+ */
+export function getTelegramUpdateHandlerRegistry(): TelegramUpdateHandlerRegistry {
+  return getOrCreateUpdateHandlerRegistry();
+}
+
+export interface TelegramUpdateHandlerWrapDeps<TUpdate, TContext> {
+  defaultHandle: (update: TUpdate, ctx: TContext) => Promise<void>;
+  registry?: TelegramUpdateHandlerRegistry;
+}
+
+/**
+ * Wrap a default polling `handleUpdate` with the public update handler registry.
+ */
+export function createTelegramUpdateHandle<TUpdate, TContext>(
+  deps: TelegramUpdateHandlerWrapDeps<TUpdate, TContext>,
+): (update: TUpdate, ctx: TContext) => Promise<void> {
+  const registry = deps.registry ?? getOrCreateUpdateHandlerRegistry();
+  const { defaultHandle } = deps;
+  return async function handleTelegramUpdate(update, ctx) {
+    const verdict = await registry.dispatch(update);
+    if (verdict === "consume") return;
+    await defaultHandle(update, ctx);
+  };
+}
+
+/**
+ * Register a handler that runs before pi-telegram routes a Telegram update
+ * through its built-in handlers.
+ *
+ * This is the low-level public surface for companion extensions that share
+ * the same bot and pi process with pi-telegram.
+ */
+export function registerTelegramUpdateHandler(
+  handler: TelegramUpdateHandler,
+): () => void {
+  return getOrCreateUpdateHandlerRegistry().add(handler);
+}

package/lib/voice.ts

@@ -12,13 +12,14 @@
  *
  * Separation of concerns:
  * - All decision logic and domain rules live here.
- * - Actual delivery (sending the audio via Telegram) stays in outbound-handlers.ts.
+ * - Actual delivery (sending the audio via Telegram) stays in outbound.ts.
  *
  * Keeps voice policy, turn tagging, prompt contributions, and markup helpers
  * out of the queue, preview, turn-building, and delivery domains.
  */
 
-const VOICE_SYNTHESIS_PROVIDER_REGISTRY_KEY = "__piTelegramVoiceSynthesisProviders__";
+const VOICE_SYNTHESIS_PROVIDER_REGISTRY_KEY =
+  "__piTelegramVoiceSynthesisProviders__";
 const VOICE_TRANSCRIPTION_PROVIDER_REGISTRY_KEY =
   "__piTelegramVoiceTranscriptionProviders__";
 
@@ -81,11 +82,20 @@ function getOrCreateVoiceSynthesisProviderRegistry(): Map<
   if (existing instanceof Map)
     return existing as Map<string, TelegramVoiceSynthesisProvider>;
   const registry = new Map<string, TelegramVoiceSynthesisProvider>();
-  (globalThis as Record<string, unknown>)[VOICE_SYNTHESIS_PROVIDER_REGISTRY_KEY] =
-    registry;
+  (globalThis as Record<string, unknown>)[
+    VOICE_SYNTHESIS_PROVIDER_REGISTRY_KEY
+  ] = registry;
   return registry;
 }
 
+/**
+ * Register a high-level Telegram voice synthesis provider.
+ *
+ * Stable public API callers must pass a stable `options.id` so diagnostics,
+ * replacement, and cleanup can identify the provider. Omitted ids remain a
+ * compatibility path for pre-matrix callers and receive generated session-local
+ * ids.
+ */
 export function registerTelegramVoiceSynthesisProvider(
   provider:
     | TelegramVoiceSynthesisProvider
@@ -103,9 +113,11 @@ export function registerTelegramVoiceSynthesisProvider(
           (text: string, options?: { lang?: string; rate?: string }) =>
             provider(text, options),
           {
-            getVoicePolicy: (provider as TelegramVoiceSynthesisProvider).getVoicePolicy,
-            getVoicePromptContribution: (provider as TelegramVoiceSynthesisProvider)
-              .getVoicePromptContribution,
+            getVoicePolicy: (provider as TelegramVoiceSynthesisProvider)
+              .getVoicePolicy,
+            getVoicePromptContribution: (
+              provider as TelegramVoiceSynthesisProvider
+            ).getVoicePromptContribution,
           },
         ) as TelegramVoiceSynthesisProvider)
       : provider;
@@ -144,6 +156,13 @@ function getOrCreateVoiceTranscriptionProviderRegistry(): Map<
   return registry;
 }
 
+/**
+ * Register a high-level Telegram voice transcription provider.
+ *
+ * Stable public API callers must pass a stable `options.id`. Omitted ids remain
+ * a compatibility path for pre-matrix callers and receive generated
+ * session-local ids.
+ */
 export function registerTelegramVoiceTranscriptionProvider(
   provider: TelegramVoiceTranscriptionProvider,
   options?: { id?: string },
@@ -182,9 +201,9 @@ export const TELEGRAM_VOICE_REPLY_MODES = [
  * Pi-telegram owns reply-mode policy through telegram.json. If
  * config.voice.replyMode is missing or invalid, the safe default is manual.
  */
-export function getTelegramVoiceReplyMode(
-  config?: { voice?: { replyMode?: string } },
-): TelegramVoiceReplyMode {
+export function getTelegramVoiceReplyMode(config?: {
+  voice?: { replyMode?: string };
+}): TelegramVoiceReplyMode {
   const configMode = config?.voice?.replyMode;
   if (
     configMode &&
@@ -202,9 +221,9 @@ export function getTelegramVoiceReplyMode(
  * Reads from `config.voice.sendTranscript`.
  * Default: false (no transcript text sent at all).
  */
-export function getTelegramVoiceSendTranscript(
-  config?: { voice?: { sendTranscript?: boolean } },
-): boolean {
+export function getTelegramVoiceSendTranscript(config?: {
+  voice?: { sendTranscript?: boolean };
+}): boolean {
   return !!config?.voice?.sendTranscript;
 }
 
@@ -292,4 +311,4 @@ export {
   stripTelegramCommentMarkupForDelivery,
   stripTelegramVoiceMarkupForPreview,
   normalizeMarkdownAfterVoiceExtraction,
-} from "./outbound-handlers.ts";
+} from "./outbound.ts";

package/package.json

@@ -1,12 +1,21 @@
 {
   "name": "@llblab/pi-telegram",
-  "version": "0.11.2",
+  "version": "0.12.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",
@@ -35,6 +44,7 @@
   },
   "files": [
     "index.ts",
+    "api/",
     "lib/",
     "README.md",
     "AGENTS.md",