@llblab/pi-telegram 0.24.11 → 0.25.0

package/lib/menu-settings.ts

@@ -5,6 +5,7 @@
  */
 
 import type {
+  TelegramActivityVerbosity,
   TelegramAssistantRenderingMode,
   TelegramTimeMode,
 } from "./config.ts";
@@ -23,6 +24,7 @@ export interface TelegramSettingsStateDeps {
   isProactivePushEnabled: () => boolean;
   areDraftPreviewsEnabled: () => boolean;
   getAssistantRenderingMode: () => TelegramAssistantRenderingMode;
+  getActivityVerbosity: () => TelegramActivityVerbosity;
   getTimeInjectionMode: () => TelegramTimeMode;
   getVoiceReplyMode: () => TelegramVoiceReplyMode;
   isVoiceReplyModeConfigured: () => boolean;
@@ -35,6 +37,9 @@ export interface TelegramSettingsMutationDeps extends TelegramSettingsStateDeps
   setAssistantRenderingMode: (
     mode: TelegramAssistantRenderingMode,
   ) => Promise<void>;
+  setActivityVerbosity: (
+    verbosity: TelegramActivityVerbosity,
+  ) => Promise<void>;
   setVoiceReplyMode: (
     mode: TelegramVoiceReplyMode | undefined,
   ) => Promise<void>;
@@ -138,6 +143,8 @@ export const PROACTIVE_PUSH_SETTINGS_TITLE = "<b>📌 Proactive push:</b>";
 export const DRAFT_PREVIEWS_SETTINGS_TITLE = "<b>📝 Draft previews:</b>";
 export const ASSISTANT_RENDERING_SETTINGS_TITLE =
   "<b>🧾 Assistant rendering:</b>";
+export const ACTIVITY_VERBOSITY_SETTINGS_TITLE =
+  "<b>🔬 Activity:</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>";
@@ -213,6 +220,19 @@ export function buildAssistantRenderingSettingsText(
   ].join("\n");
 }
 
+export function buildActivityVerbositySettingsText(
+  verbosity: TelegramActivityVerbosity,
+): string {
+  return [
+    `${ACTIVITY_VERBOSITY_SETTINGS_TITLE} <code>${verbosity}</code>`,
+    "",
+    "Choose how much technical model activity Telegram shows.",
+    "",
+    "<code>-</code> <code>quiet</code> (default): show public assistant output without reasoning or tool traffic.",
+    "<code>-</code> <code>verbose</code>: add ephemeral available reasoning and durable collapsed tool details.",
+  ].join("\n");
+}
+
 export function buildVoiceReplyModeSettingsText(
   mode: TelegramVoiceReplyMode,
   configured = true,
@@ -255,6 +275,7 @@ export function buildTelegramSettingsMenuReplyMarkup(
   sectionRegistryOrVoiceReplyModeConfigured?: TelegramSectionRegistry | boolean,
   voiceReplyModeConfigured = true,
   automaticThreadCleanupEnabled = true,
+  activityVerbosity: TelegramActivityVerbosity = "quiet",
 ): TelegramSettingsMenuReplyMarkup {
   const hasRenderingMode =
     assistantRenderingModeOrVoiceReplyMode === "rich" ||
@@ -280,23 +301,17 @@ export function buildTelegramSettingsMenuReplyMarkup(
   const rows: Array<Array<{ text: string; callback_data: string }>> = [
     [{ text: "⬆️ Main menu", callback_data: "menu:back" }],
   ];
-  // Extension settings rows before built-in controls
-  if (sectionRegistry) {
-    const settingsRows = getTelegramExtensionSettingsRows(sectionRegistry);
-    for (const row of settingsRows) {
-      rows.push([{ text: row.label, callback_data: row.callback_data }]);
-    }
-  }
-  rows.push(
-    [
-      {
-        text: `🧹 Thread cleanup: ${automaticThreadCleanupEnabled ? "on" : "off"}`,
-        callback_data: "settings:open:automatic-thread-cleanup",
-      },
-    ],
-    [
-      {
-        text: `👄 Voice reply: ${getTelegramSettingsStateValueLabel(
+  const settingsButtons: Array<{ text: string; callback_data: string }> = [
+    {
+      text: `📝 Draft previews: ${draftPreviewsEnabled ? "on" : "off"}`,
+      callback_data: "settings:open:draft-previews",
+    },
+    {
+      text: `🧾 Rendering: ${assistantRenderingMode}`,
+      callback_data: "settings:open:assistant-rendering",
+    },
+    {
+      text: `👄 Voice reply: ${getTelegramSettingsStateValueLabel(
           getVoiceReplyModeLabel(
             getVoiceReplyModeSetting(
               voiceReplyMode,
@@ -304,34 +319,35 @@ export function buildTelegramSettingsMenuReplyMarkup(
             ),
           ),
         )}`,
-        callback_data: "settings:open:voice-reply",
-      },
-    ],
-    [
-      {
-        text: `🕒 Time injection: ${getTelegramSettingsStateValueLabel(timeInjectionMode)}`,
-        callback_data: "settings:open:time-injection",
-      },
-    ],
-    [
-      {
-        text: `📝 Draft previews: ${draftPreviewsEnabled ? "on" : "off"}`,
-        callback_data: "settings:open:draft-previews",
-      },
-    ],
-    [
-      {
-        text: `🧾 Rendering: ${assistantRenderingMode}`,
-        callback_data: "settings:open:assistant-rendering",
-      },
-    ],
-    [
-      {
-        text: `📌 Proactive push: ${proactivePushEnabled ? "on" : "off"}`,
-        callback_data: "settings:open:proactive",
-      },
-    ],
-  );
+      callback_data: "settings:open:voice-reply",
+    },
+    {
+      text: `🔬 Activity: ${activityVerbosity}`,
+      callback_data: "settings:open:activity-verbosity",
+    },
+    {
+      text: `📌 Proactive push: ${proactivePushEnabled ? "on" : "off"}`,
+      callback_data: "settings:open:proactive",
+    },
+    {
+      text: `🕒 Time injection: ${getTelegramSettingsStateValueLabel(timeInjectionMode)}`,
+      callback_data: "settings:open:time-injection",
+    },
+    {
+      text: `🧹 Thread cleanup: ${automaticThreadCleanupEnabled ? "on" : "off"}`,
+      callback_data: "settings:open:automatic-thread-cleanup",
+    },
+  ];
+  if (sectionRegistry) {
+    const extensionRows = getTelegramExtensionSettingsRows(sectionRegistry);
+    settingsButtons.push(
+      ...extensionRows.map((row) => ({
+        text: row.label,
+        callback_data: row.callback_data,
+      })),
+    );
+  }
+  rows.push(...settingsButtons.map((button) => [button]));
   return { inline_keyboard: rows };
 }
 
@@ -354,6 +370,7 @@ export async function openTelegramSettingsMenu<
       sectionRegistry,
       deps.isVoiceReplyModeConfigured(),
       deps.isAutomaticThreadCleanupEnabled(),
+      deps.getActivityVerbosity(),
     ),
   );
   if (messageId === undefined) return;
@@ -439,6 +456,23 @@ export function buildAssistantRenderingSettingsReplyMarkup(
   };
 }
 
+export function buildActivityVerbositySettingsReplyMarkup(
+  verbosity: TelegramActivityVerbosity,
+): TelegramSettingsMenuReplyMarkup {
+  const values: TelegramActivityVerbosity[] = ["quiet", "verbose"];
+  return {
+    inline_keyboard: [
+      [{ text: "⬆️ Back", callback_data: "settings:list" }],
+      ...values.map((value) => [
+        {
+          text: `${value === verbosity ? "🟢 " : ""}${value}`,
+          callback_data: `settings:set:activity-verbosity:${value}`,
+        },
+      ]),
+    ],
+  };
+}
+
 export function buildTimeInjectionModeSettingsReplyMarkup(
   mode: TelegramTimeMode,
 ): TelegramSettingsMenuReplyMarkup {
@@ -490,6 +524,7 @@ export async function updateTelegramSettingsMenuMessage(
       sectionRegistry,
       deps.isVoiceReplyModeConfigured(),
       deps.isAutomaticThreadCleanupEnabled(),
+      deps.getActivityVerbosity(),
     ),
   );
 }
@@ -534,6 +569,16 @@ export async function updateAssistantRenderingSettingsMessage(
   );
 }
 
+export async function updateActivityVerbositySettingsMessage(
+  deps: TelegramSettingsMenuCallbackDeps,
+): Promise<void> {
+  const verbosity = deps.getActivityVerbosity();
+  await deps.updateSettingsMessage(
+    buildActivityVerbositySettingsText(verbosity),
+    buildActivityVerbositySettingsReplyMarkup(verbosity),
+  );
+}
+
 export async function updateTimeInjectionModeSettingsMessage(
   deps: TelegramSettingsMenuCallbackDeps,
 ): Promise<void> {
@@ -589,6 +634,11 @@ export async function handleTelegramSettingsMenuCallbackAction(
     await deps.answerCallbackQuery(callbackQueryId);
     return true;
   }
+  if (data === "settings:open:activity-verbosity") {
+    await updateActivityVerbositySettingsMessage(deps);
+    await deps.answerCallbackQuery(callbackQueryId);
+    return true;
+  }
   if (data === "settings:open:voice-reply") {
     await updateVoiceReplyModeSettingsMessage(deps);
     await deps.answerCallbackQuery(callbackQueryId);
@@ -660,6 +710,18 @@ export async function handleTelegramSettingsMenuCallbackAction(
       return true;
     }
   }
+  if (data.startsWith("settings:set:activity-verbosity:")) {
+    const verbosity = data.slice("settings:set:activity-verbosity:".length);
+    if (verbosity === "quiet" || verbosity === "verbose") {
+      await deps.setActivityVerbosity(verbosity);
+      await updateActivityVerbositySettingsMessage(deps);
+      await deps.answerCallbackQuery(
+        callbackQueryId,
+        `Activity: ${verbosity}`,
+      );
+      return true;
+    }
+  }
   if (
     data === "settings:set:automatic-thread-cleanup:on" ||
     data === "settings:set:automatic-thread-cleanup:off"
@@ -706,6 +768,7 @@ export function createTelegramSettingsMenuRuntime<
           isProactivePushEnabled: deps.isProactivePushEnabled,
           areDraftPreviewsEnabled: deps.areDraftPreviewsEnabled,
           getAssistantRenderingMode: deps.getAssistantRenderingMode,
+          getActivityVerbosity: deps.getActivityVerbosity,
           getVoiceReplyMode: deps.getVoiceReplyMode,
           isVoiceReplyModeConfigured: deps.isVoiceReplyModeConfigured,
           getTimeInjectionMode: deps.getTimeInjectionMode,
@@ -729,6 +792,7 @@ export function createTelegramSettingsMenuRuntime<
           isProactivePushEnabled: deps.isProactivePushEnabled,
           areDraftPreviewsEnabled: deps.areDraftPreviewsEnabled,
           getAssistantRenderingMode: deps.getAssistantRenderingMode,
+          getActivityVerbosity: deps.getActivityVerbosity,
           getVoiceReplyMode: deps.getVoiceReplyMode,
           isVoiceReplyModeConfigured: deps.isVoiceReplyModeConfigured,
           getTimeInjectionMode: deps.getTimeInjectionMode,
@@ -772,6 +836,7 @@ export function createTelegramSettingsMenuRuntime<
         isProactivePushEnabled: deps.isProactivePushEnabled,
         areDraftPreviewsEnabled: deps.areDraftPreviewsEnabled,
         getAssistantRenderingMode: deps.getAssistantRenderingMode,
+        getActivityVerbosity: deps.getActivityVerbosity,
         getVoiceReplyMode: deps.getVoiceReplyMode,
         isVoiceReplyModeConfigured: deps.isVoiceReplyModeConfigured,
         getTimeInjectionMode: deps.getTimeInjectionMode,
@@ -779,6 +844,7 @@ export function createTelegramSettingsMenuRuntime<
         setProactivePushEnabled: deps.setProactivePushEnabled,
         setDraftPreviewsEnabled: deps.setDraftPreviewsEnabled,
         setAssistantRenderingMode: deps.setAssistantRenderingMode,
+        setActivityVerbosity: deps.setActivityVerbosity,
         setVoiceReplyMode: deps.setVoiceReplyMode,
         setTimeInjectionMode: deps.setTimeInjectionMode,
         setAutomaticThreadCleanupEnabled: deps.setAutomaticThreadCleanupEnabled,

package/lib/queue.ts

@@ -968,6 +968,7 @@ export interface TelegramAgentEndRuntimeDeps<
   isSessionActive?: () => boolean;
   isTurnTransportActive?: (turn: TTurn) => boolean;
   waitForTypingIdle?: () => Promise<void>;
+  waitForActivityIdle?: () => Promise<void>;
   updateStatus: () => void;
   dispatchNextQueuedTelegramTurn: () => void;
   scheduleActiveTurnDelivery?: (task: () => Promise<void>) => void;
@@ -1047,6 +1048,7 @@ export interface TelegramAgentEndHookRuntimeDeps<
   isSessionActive?: (ctx: TContext) => boolean;
   isTurnTransportActive?: (turn: TTurn) => boolean;
   waitForTypingIdle?: () => Promise<void>;
+  waitForActivityIdle?: () => Promise<void>;
   updateStatus: (ctx: TContext) => void;
   dispatchNextQueuedTelegramTurn: (ctx: TContext) => void;
   requestDeferredDispatchNextQueuedTelegramTurn: (
@@ -1188,6 +1190,7 @@ export function createTelegramAgentEndHook<
       isSessionActive: () => deps.isSessionActive?.(ctx) ?? true,
       isTurnTransportActive: deps.isTurnTransportActive,
       waitForTypingIdle: deps.waitForTypingIdle,
+      waitForActivityIdle: deps.waitForActivityIdle,
       updateStatus: () => deps.updateStatus(ctx),
       dispatchNextQueuedTelegramTurn: () => {
         deps.requestDeferredDispatchNextQueuedTelegramTurn(
@@ -1358,6 +1361,7 @@ export async function handleTelegramAgentEndRuntime<
     return;
   }
   const deliverActiveTurn = async () => {
+    await deps.waitForActivityIdle?.();
     if (!isDeliveryActive()) return;
     if (finalText) deps.setPreviewPendingText(finalText);
     if (!finalText && hasOutboundArtifacts)

package/lib/telegram-api.ts

@@ -274,6 +274,24 @@ type TelegramInputRichMessageCommon = {
   skip_entity_detection?: boolean;
 };
 
+export type TelegramRichText =
+  | string
+  | TelegramRichText[]
+  | { type: "bold" | "code"; text: TelegramRichText };
+
+export type TelegramInputRichBlock =
+  | { type: "pre"; text: TelegramRichText; language?: string }
+  | {
+      type: "details";
+      summary: TelegramRichText;
+      blocks: TelegramInputRichBlock[];
+      is_open?: true;
+    };
+
+export type TelegramInputRichDraftBlock =
+  | TelegramInputRichBlock
+  | { type: "thinking"; text: TelegramRichText };
+
 export type TelegramInputRichMessage = TelegramInputRichMessageCommon &
   (
     | {
@@ -288,6 +306,12 @@ export type TelegramInputRichMessage = TelegramInputRichMessageCommon &
         blocks?: never;
         media?: TelegramInputRichMessageMedia[];
       }
+    | {
+        blocks: TelegramInputRichBlock[];
+        markdown?: never;
+        html?: never;
+        media?: never;
+      }
   );
 
 export type TelegramSendRichMessageBody = Record<string, unknown> & {
@@ -318,7 +342,14 @@ export type TelegramSendMessageDraftBody = Record<string, unknown> & {
 export type TelegramSendRichMessageDraftBody = Record<string, unknown> & {
   chat_id: number;
   draft_id: number;
-  rich_message: TelegramInputRichMessage;
+  rich_message:
+    | TelegramInputRichMessage
+    | (TelegramInputRichMessageCommon & {
+        blocks: TelegramInputRichDraftBlock[];
+        markdown?: never;
+        html?: never;
+        media?: never;
+      });
   message_thread_id?: number;
 };
 

package/package.json

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