@llblab/pi-telegram 0.24.10 → 0.25.0

package/lib/config.ts

@@ -55,6 +55,7 @@ export interface ResolvedTelegramTimeConfig {
 }
 
 export type TelegramAssistantRenderingMode = "rich" | "html";
+export type TelegramActivityVerbosity = "quiet" | "verbose";
 
 export interface TelegramConfig {
   /** @deprecated persisted identity belongs in profiles.default; retained for effective/legacy views */
@@ -74,6 +75,9 @@ export interface TelegramConfig {
     draftPreviews?: boolean;
     rendering?: TelegramAssistantRenderingMode;
     proactivePush?: boolean;
+    activity?: TelegramActivityVerbosity;
+    /** @deprecated use activity */
+    activityVerbosity?: TelegramActivityVerbosity;
   };
   /** @deprecated use assistant.draftPreviews */
   draftPreviews?: boolean;
@@ -678,7 +682,7 @@ export function createTelegramProactivePushSetter(
   return async (enabled) => {
     await loadLatestTelegramConfig(configStore);
     const current = configStore.get();
-    const config = {
+    const config: TelegramConfig = {
       ...current,
       assistant: { ...current.assistant, proactivePush: enabled },
     };
@@ -746,6 +750,40 @@ export function createTelegramAssistantRenderingModeSetter(
   };
 }
 
+export function createTelegramActivityVerbosityGetter(
+  configStore: Pick<TelegramConfigStore, "get">,
+): () => TelegramActivityVerbosity {
+  return () => {
+    const assistant = configStore.get().assistant;
+    if (assistant?.activity !== undefined) {
+      return assistant.activity === "verbose" ? "verbose" : "quiet";
+    }
+    return assistant?.activityVerbosity === "verbose" ? "verbose" : "quiet";
+  };
+}
+
+export function createTelegramActivityVerbositySetter(
+  configStore: TelegramMutableConfigStore,
+): (verbosity: TelegramActivityVerbosity) => Promise<void> {
+  return async (verbosity) => {
+    await loadLatestTelegramConfig(configStore);
+    const current = configStore.get();
+    const {
+      activityVerbosity: _legacyActivityVerbosity,
+      ...assistant
+    } = current.assistant ?? {};
+    const config = {
+      ...current,
+      assistant: {
+        ...assistant,
+        activity: verbosity,
+      },
+    };
+    configStore.set(config);
+    await configStore.persist(config);
+  };
+}
+
 export function createTelegramVoiceReplyModeGetter(
   configStore: Pick<TelegramConfigStore, "get">,
 ): () => "hidden" | "mirror" | "always" {
@@ -919,6 +957,10 @@ export function createTelegramConfigControls(
       createTelegramAssistantRenderingModeGetter(configStore),
     setAssistantRenderingMode:
       createTelegramAssistantRenderingModeSetter(configStore),
+    getActivityVerbosity:
+      createTelegramActivityVerbosityGetter(configStore),
+    setActivityVerbosity:
+      createTelegramActivityVerbositySetter(configStore),
     getVoiceReplyMode: createTelegramVoiceReplyModeGetter(configStore),
     isVoiceReplyModeConfigured:
       createTelegramVoiceReplyModeConfiguredChecker(configStore),

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/outbound-buttons.ts

@@ -11,7 +11,7 @@ import type {
   TelegramInlineKeyboardMarkup,
 } from "./keyboard.ts";
 import {
-  parseTelegramCommentAttributes,
+  parseTelegramActionPayload,
   parseTopLevelTelegramComment,
   replaceTopLevelHtmlComments,
 } from "./outbound-markup.ts";
@@ -87,16 +87,27 @@ function normalizeMarkdownAfterButtonExtraction(markdown: string): string {
   return markdown.replace(/\n{3,}/g, "\n\n").trim();
 }
 
-function parseButtonsCommentAttributes(input: string): {
-  label?: string;
-  prompt?: string;
-  selectedStyle?: TelegramInlineKeyboardButtonStyle;
-} {
-  const attributes = parseTelegramCommentAttributes(input);
-  const selectedStyle = attributes.selected_style;
+function getTelegramButtonString(
+  payload: Record<string, unknown>,
+  key: string,
+): string | undefined {
+  const value = payload[key];
+  if (typeof value !== "string") return undefined;
+  const trimmed = value.trim();
+  return trimmed || undefined;
+}
+
+function parseTelegramButtonAction(
+  payload: Record<string, unknown>,
+): TelegramOutboundButtonAction | undefined {
+  const value = getTelegramButtonString(payload, "value");
+  const label = getTelegramButtonString(payload, "label") ?? value;
+  const prompt = getTelegramButtonString(payload, "prompt") ?? value;
+  if (!label || !prompt) return undefined;
+  const selectedStyle = payload.selected_style;
   return {
-    ...(attributes.label ? { label: attributes.label } : {}),
-    ...(attributes.prompt ? { prompt: attributes.prompt } : {}),
+    text: label,
+    prompt,
     ...(selectedStyle === "success" ||
     selectedStyle === "danger" ||
     selectedStyle === "primary"
@@ -105,49 +116,6 @@ function parseButtonsCommentAttributes(input: string): {
   };
 }
 
-function parseButtonsCommentRows(
-  head: string,
-  body: string | undefined,
-): TelegramOutboundButtonAction[][] {
-  const trimmedHead = head.trim();
-
-  if (body === undefined) {
-    if (trimmedHead.startsWith(":")) {
-      const label = trimmedHead.slice(1).trim();
-      return label ? [[{ text: label, prompt: label }]] : [];
-    }
-    const attributes = parseButtonsCommentAttributes(head);
-    return attributes.label && attributes.prompt
-      ? [
-          [
-            {
-              text: attributes.label,
-              prompt: attributes.prompt,
-              ...(attributes.selectedStyle
-                ? { selectedStyle: attributes.selectedStyle }
-                : {}),
-            },
-          ],
-        ]
-      : [];
-  }
-
-  const attributes = parseButtonsCommentAttributes(head);
-  const prompt = body.trim();
-  if (!attributes.label || !prompt) return [];
-  return [
-    [
-      {
-        text: attributes.label,
-        prompt,
-        ...(attributes.selectedStyle
-          ? { selectedStyle: attributes.selectedStyle }
-          : {}),
-      },
-    ],
-  ];
-}
-
 export function createTelegramButtonActionStore(
   options: { ttlMs?: number } = {},
 ): TelegramButtonActionStore {
@@ -197,14 +165,15 @@ export function planTelegramButtonReply(
   const stripped = replaceTopLevelHtmlComments(markdown, (comment) => {
     const command = parseTopLevelTelegramComment(comment, "telegram_button");
     if (!command) return comment.raw;
-    const rows = parseButtonsCommentRows(command.head, command.body);
-    for (const row of rows) {
-      keyboard.push(
-        row.map((button) => ({
-          text: button.text,
-          callback_data: deps.registerAction(button),
-        })),
-      );
+    const payload = parseTelegramActionPayload(comment, "telegram_button");
+    const action = payload ? parseTelegramButtonAction(payload) : undefined;
+    if (action) {
+      keyboard.push([
+        {
+          text: action.text,
+          callback_data: deps.registerAction(action),
+        },
+      ]);
     }
     return "";
   });