@llblab/pi-kit 0.1.13 → 0.3.0

package/node_modules/@llblab/pi-telegram/lib/menu-settings.ts

@@ -21,7 +21,6 @@ import type { TelegramVoiceReplyMode } from "./voice.ts";
 export type TelegramSettingsMenuReplyMarkup = TelegramInlineKeyboardMarkup;
 
 export interface TelegramSettingsStateDeps {
-  isProactivePushEnabled: () => boolean;
   areDraftPreviewsEnabled: () => boolean;
   getAssistantRenderingMode: () => TelegramAssistantRenderingMode;
   getActivityVerbosity: () => TelegramActivityVerbosity;
@@ -32,7 +31,6 @@ export interface TelegramSettingsStateDeps {
 }
 
 export interface TelegramSettingsMutationDeps extends TelegramSettingsStateDeps {
-  setProactivePushEnabled: (enabled: boolean) => Promise<void>;
   setDraftPreviewsEnabled: (enabled: boolean) => Promise<void>;
   setAssistantRenderingMode: (
     mode: TelegramAssistantRenderingMode,
@@ -139,7 +137,6 @@ export interface TelegramSettingsMenuRuntimeDeps<
 export const SETTINGS_MENU_TITLE = "<b>⚙️ Settings:</b>";
 export const AUTOMATIC_THREAD_CLEANUP_SETTINGS_TITLE =
   "<b>🧹 Thread cleanup:</b>";
-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>";
@@ -181,19 +178,6 @@ export function buildAutomaticThreadCleanupSettingsText(
   ].join("\n");
 }
 
-export function buildProactivePushSettingsText(
-  proactivePushEnabled: boolean,
-): string {
-  return [
-    `${PROACTIVE_PUSH_SETTINGS_TITLE} <code>${proactivePushEnabled ? "on" : "off"}</code>`,
-    "",
-    "Control whether public assistant output from local/autonomous work is projected to Telegram.",
-    "",
-    "<code>-</code> <code>on</code> (default): send each completed public block, including visible checkpoints and the final answer, while connected.",
-    "<code>-</code> <code>off</code>: keep local/autonomous assistant blocks in Pi; Telegram-originated replies still use their normal delivery path.",
-  ].join("\n");
-}
-
 export function buildDraftPreviewsSettingsText(enabled: boolean): string {
   return [
     `${DRAFT_PREVIEWS_SETTINGS_TITLE} <code>${enabled ? "on" : "off"}</code>`,
@@ -265,7 +249,6 @@ export function buildTimeInjectionModeSettingsText(
 }
 
 export function buildTelegramSettingsMenuReplyMarkup(
-  proactivePushEnabled: boolean,
   draftPreviewsEnabled: boolean,
   assistantRenderingModeOrVoiceReplyMode:
     TelegramAssistantRenderingMode | TelegramVoiceReplyMode,
@@ -325,10 +308,6 @@ export function buildTelegramSettingsMenuReplyMarkup(
       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",
@@ -362,7 +341,6 @@ export async function openTelegramSettingsMenu<
     state,
     buildTelegramSettingsMenuText(),
     buildTelegramSettingsMenuReplyMarkup(
-      deps.isProactivePushEnabled(),
       deps.areDraftPreviewsEnabled(),
       deps.getAssistantRenderingMode(),
       deps.getVoiceReplyMode(),
@@ -399,26 +377,6 @@ export function buildAutomaticThreadCleanupSettingsReplyMarkup(
   };
 }
 
-export function buildProactivePushSettingsReplyMarkup(
-  proactivePushEnabled: boolean,
-): TelegramSettingsMenuReplyMarkup {
-  return {
-    inline_keyboard: [
-      [{ text: "⬆️ Back", callback_data: "settings:list" }],
-      [
-        {
-          text: proactivePushEnabled ? "🟢 On" : "⚫️ On",
-          callback_data: "settings:set:proactive:on",
-        },
-        {
-          text: proactivePushEnabled ? "⚫️ Off" : "🟡 Off",
-          callback_data: "settings:set:proactive:off",
-        },
-      ],
-    ],
-  };
-}
-
 export function buildDraftPreviewsSettingsReplyMarkup(
   enabled: boolean,
 ): TelegramSettingsMenuReplyMarkup {
@@ -521,7 +479,6 @@ export async function updateTelegramSettingsMenuMessage(
   await deps.updateSettingsMessage(
     buildTelegramSettingsMenuText(),
     buildTelegramSettingsMenuReplyMarkup(
-      deps.isProactivePushEnabled(),
       deps.areDraftPreviewsEnabled(),
       deps.getAssistantRenderingMode(),
       deps.getVoiceReplyMode(),
@@ -544,16 +501,6 @@ export async function updateAutomaticThreadCleanupSettingsMessage(
   );
 }
 
-export async function updateProactivePushSettingsMessage(
-  deps: TelegramSettingsMenuCallbackDeps,
-): Promise<void> {
-  const proactivePushEnabled = deps.isProactivePushEnabled();
-  await deps.updateSettingsMessage(
-    buildProactivePushSettingsText(proactivePushEnabled),
-    buildProactivePushSettingsReplyMarkup(proactivePushEnabled),
-  );
-}
-
 export async function updateDraftPreviewsSettingsMessage(
   deps: TelegramSettingsMenuCallbackDeps,
 ): Promise<void> {
@@ -621,9 +568,16 @@ export async function handleTelegramSettingsMenuCallbackAction(
     await deps.answerCallbackQuery(callbackQueryId);
     return true;
   }
-  if (data === "settings:open:proactive") {
-    await updateProactivePushSettingsMessage(deps);
-    await deps.answerCallbackQuery(callbackQueryId);
+  if (
+    data === "settings:open:proactive" ||
+    data === "settings:set:proactive:on" ||
+    data === "settings:set:proactive:off"
+  ) {
+    await updateTelegramSettingsMenuMessage(deps, deps.sectionRegistry);
+    await deps.answerCallbackQuery(
+      callbackQueryId,
+      "Public assistant output is always delivered while Telegram is connected.",
+    );
     return true;
   }
   if (
@@ -751,19 +705,6 @@ export async function handleTelegramSettingsMenuCallbackAction(
     );
     return true;
   }
-  if (
-    data === "settings:set:proactive:on" ||
-    data === "settings:set:proactive:off"
-  ) {
-    const enabled = data.endsWith(":on");
-    await deps.setProactivePushEnabled(enabled);
-    await updateProactivePushSettingsMessage(deps);
-    await deps.answerCallbackQuery(
-      callbackQueryId,
-      `Proactive push ${enabled ? "enabled" : "disabled"}`,
-    );
-    return true;
-  }
   await deps.answerCallbackQuery(callbackQueryId);
   return true;
 }
@@ -781,7 +722,6 @@ export function createTelegramSettingsMenuRuntime<
       return openTelegramSettingsMenu(
         {
           getModelMenuState: () => deps.getModelMenuState(chatId, ctx),
-          isProactivePushEnabled: deps.isProactivePushEnabled,
           areDraftPreviewsEnabled: deps.areDraftPreviewsEnabled,
           getAssistantRenderingMode: deps.getAssistantRenderingMode,
           getActivityVerbosity: deps.getActivityVerbosity,
@@ -805,7 +745,6 @@ export function createTelegramSettingsMenuRuntime<
       await deps.reloadConfig?.();
       return updateTelegramSettingsMenuMessage(
         {
-          isProactivePushEnabled: deps.isProactivePushEnabled,
           areDraftPreviewsEnabled: deps.areDraftPreviewsEnabled,
           getAssistantRenderingMode: deps.getAssistantRenderingMode,
           getActivityVerbosity: deps.getActivityVerbosity,
@@ -849,7 +788,6 @@ export function createTelegramSettingsMenuRuntime<
         deps.storeModelMenuState(state);
       }
       return handleTelegramSettingsMenuCallbackAction(query.id, query.data, {
-        isProactivePushEnabled: deps.isProactivePushEnabled,
         areDraftPreviewsEnabled: deps.areDraftPreviewsEnabled,
         getAssistantRenderingMode: deps.getAssistantRenderingMode,
         getActivityVerbosity: deps.getActivityVerbosity,
@@ -857,7 +795,6 @@ export function createTelegramSettingsMenuRuntime<
         isVoiceReplyModeConfigured: deps.isVoiceReplyModeConfigured,
         getTimeInjectionMode: deps.getTimeInjectionMode,
         isAutomaticThreadCleanupEnabled: deps.isAutomaticThreadCleanupEnabled,
-        setProactivePushEnabled: deps.setProactivePushEnabled,
         setDraftPreviewsEnabled: deps.setDraftPreviewsEnabled,
         setAssistantRenderingMode: deps.setAssistantRenderingMode,
         setActivityVerbosity: deps.setActivityVerbosity,

package/node_modules/@llblab/pi-telegram/lib/outbound-buttons.ts

@@ -12,7 +12,6 @@ import type {
 } from "./keyboard.ts";
 import {
   parseTelegramActionPayloadRows,
-  parseTopLevelTelegramComment,
   replaceTopLevelHtmlComments,
 } from "./outbound-markup.ts";
 import {
@@ -113,8 +112,10 @@ 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;
+  const explicitLabel = getTelegramButtonString(payload, "label");
+  const explicitPrompt = getTelegramButtonString(payload, "prompt");
+  const label = explicitLabel ?? value ?? explicitPrompt;
+  const prompt = explicitPrompt ?? value ?? explicitLabel;
   if (!label || !prompt) return undefined;
   const selectedStyle = payload.selected_style;
   return {
@@ -179,10 +180,9 @@ export function planTelegramButtonReply(
 ): TelegramButtonReplyPlan {
   const keyboard: TelegramOutboundButtonMarkup["inline_keyboard"] = [];
   const stripped = replaceTopLevelHtmlComments(markdown, (comment) => {
-    const command = ["telegram_button", "telegram_buttons"].find((candidate) =>
-      parseTopLevelTelegramComment(comment, candidate),
-    );
-    if (!command) return comment.raw;
+    const command = "telegram_button";
+    const normalizedContent = comment.content.replace(/^\s+/, "").replace(/^!/, "");
+    if (!normalizedContent.startsWith(command)) return comment.raw;
     const payloadRows = parseTelegramActionPayloadRows(comment, command);
     if (!payloadRows) return "";
     const actionRows = payloadRows.map((payloadRow) =>
@@ -225,8 +225,9 @@ export function createTelegramButtonPromptTurn(options: {
   queueOrder: number;
   action: TelegramOutboundButtonAction;
   target?: TelegramQueueTarget;
+  telegramPrefix?: string;
 }): PendingTelegramTurn {
-  const prompt = `[telegram] ${options.action.prompt}`;
+  const prompt = `${options.telegramPrefix ?? "[telegram]"} ${options.action.prompt}`;
   return {
     kind: "prompt",
     chatId: options.chatId,

package/node_modules/@llblab/pi-telegram/lib/outbound-markup.ts

@@ -153,63 +153,153 @@ export function parseTopLevelTelegramComment(
   };
 }
 
-function parseCanonicalTelegramActionAttributes(
+function parseTolerantTelegramAttributes(
   source: string,
+  names: readonly string[],
 ): Record<string, string> | undefined {
   const attributes: Record<string, string> = {};
-  const pattern = /\s*([A-Za-z_][A-Za-z0-9_-]*)="([^"]*)"/y;
-  let offset = 0;
-  while (offset < source.length) {
-    pattern.lastIndex = offset;
-    const match = pattern.exec(source);
-    if (!match) return undefined;
-    const value = match[2].trim();
-    if (value) attributes[match[1]] = value;
-    offset = pattern.lastIndex;
+  const namePattern = names.join("|");
+  const pattern = new RegExp(
+    `\\b(${namePattern})\\s*=\\s*(?:"([^"]*)"|'([^']*)'|([^\\s]+))`,
+    "gu",
+  );
+  for (const match of source.matchAll(pattern)) {
+    const value = (match[2] ?? match[3] ?? match[4] ?? "").trim();
+    if (value) attributes[match[1]!] = value;
   }
   return Object.keys(attributes).length > 0 ? attributes : undefined;
 }
 
-function getTelegramActionPayloadSource(
-  comment: TelegramTopLevelHtmlComment,
-  command: string,
-): { source: string; hasBody: boolean } | undefined {
-  const parsed = parseTopLevelTelegramComment(comment, command);
-  if (!parsed || parsed.head.trimStart().startsWith(":")) return undefined;
-  const source = [parsed.head, parsed.body]
-    .filter((part): part is string => part !== undefined)
-    .join("\n")
-    .trim();
-  return source ? { source, hasBody: parsed.body !== undefined } : undefined;
-}
-
 function isTelegramActionPayload(value: unknown): value is Record<string, unknown> {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
 
+function removeTelegramJsonTrailingCommas(source: string): string {
+  let normalized = "";
+  let inString = false;
+  let escaped = false;
+  for (let offset = 0; offset < source.length; offset += 1) {
+    const character = source[offset]!;
+    if (inString) {
+      normalized += character;
+      if (escaped) escaped = false;
+      else if (character === "\\") escaped = true;
+      else if (character === '"') inString = false;
+      continue;
+    }
+    if (character === '"') {
+      inString = true;
+      normalized += character;
+      continue;
+    }
+    if (character === ",") {
+      let next = offset + 1;
+      while (/\s/u.test(source[next] ?? "")) next += 1;
+      if (source[next] === "}" || source[next] === "]") continue;
+    }
+    normalized += character;
+  }
+  return normalized;
+}
+
+function parseTelegramJsonObjectCandidate(
+  source: string,
+): Record<string, unknown> | undefined {
+  const normalized = removeTelegramJsonTrailingCommas(source);
+  for (const candidate of normalized === source ? [source] : [source, normalized]) {
+    try {
+      const value: unknown = JSON.parse(candidate);
+      if (isTelegramActionPayload(value)) return value;
+    } catch {
+      // Try the bounded trailing-comma normalization before rejecting JSON.
+    }
+  }
+  return undefined;
+}
+
+function looksLikeTelegramNamedJsonObject(
+  source: string,
+  offset: number,
+): boolean {
+  return /^\{\s*"(?:[^"\\]|\\.)*"\s*:/u.test(source.slice(offset));
+}
+
 export function parseTelegramActionPayload(
   comment: TelegramTopLevelHtmlComment,
   command: string,
 ): Record<string, unknown> | undefined {
-  const payload = getTelegramActionPayloadSource(comment, command);
-  if (!payload) return undefined;
-  if (payload.source.startsWith("{")) {
-    try {
-      const value: unknown = JSON.parse(payload.source);
-      return isTelegramActionPayload(value) ? value : undefined;
-    } catch {
-      return undefined;
+  let content = comment.content.replace(/^\s+/, "").replace(/^!/, "");
+  if (!content.startsWith(command)) return undefined;
+  content = content.slice(command.length);
+  let attributeEnvelope = content;
+  for (let offset = 0; offset < content.length; offset += 1) {
+    if (content[offset] !== "{" && content[offset] !== "[") continue;
+    if (
+      content[offset] === "[" &&
+      !isPlausibleTelegramMatrixStart(content, offset)
+    ) {
+      const noiseEnd = findTelegramStructuredPayloadEnd(content, offset);
+      if (noiseEnd !== undefined) {
+        attributeEnvelope = `${attributeEnvelope.slice(0, offset)}${" ".repeat(noiseEnd - offset)}${attributeEnvelope.slice(noiseEnd)}`;
+        offset = noiseEnd - 1;
+      }
+      continue;
+    }
+    if (content[offset] === "{") {
+      const parsed = parseTelegramAdaptiveActionPayloadRows(
+        content.slice(offset),
+        parseTelegramVoiceCompactActionPayload,
+        { allowTrailing: true },
+      );
+      if (parsed) return parsed.rows[0]![0];
     }
+    const end = findTelegramStructuredPayloadEnd(content, offset);
+    if (end === undefined) continue;
+    attributeEnvelope = `${attributeEnvelope.slice(0, offset)}${" ".repeat(end - offset)}${attributeEnvelope.slice(end)}`;
+    offset = end - 1;
   }
-  if (payload.hasBody) return undefined;
-  return parseCanonicalTelegramActionAttributes(payload.source);
+  return parseTolerantTelegramAttributes(attributeEnvelope, [
+    "text",
+    "value",
+    "lang",
+    "rate",
+  ]);
 }
 
 const TELEGRAM_COMPACT_ACTION_CONTROL_PATTERN = /[\u0000-\u001f\u007f-\u009f]/u;
 
+type TelegramCompactActionPayloadParser = (
+  atoms: readonly string[],
+) => Record<string, unknown> | undefined;
+
+function parseTelegramButtonCompactActionPayload(
+  atoms: readonly string[],
+): Record<string, unknown> | undefined {
+  const [label, prompt, selectedStyle] = atoms;
+  if (atoms.length === 1) return { value: label };
+  if (atoms.length === 2) return { label, prompt };
+  if (
+    selectedStyle !== "primary" &&
+    selectedStyle !== "success" &&
+    selectedStyle !== "danger"
+  ) return undefined;
+  return { label, prompt, selected_style: selectedStyle };
+}
+
+function parseTelegramVoiceCompactActionPayload(
+  atoms: readonly string[],
+): Record<string, unknown> | undefined {
+  const [text, lang, rate] = atoms;
+  if (atoms.length === 1) return { text };
+  if (atoms.length === 2) return { text, lang };
+  return { text, lang, rate };
+}
+
 function parseTelegramAdaptiveActionPayloadRows(
   source: string,
-): Record<string, unknown>[][] | undefined {
+  parseCompactPayload: TelegramCompactActionPayloadParser,
+  options: { allowTrailing?: boolean } = {},
+): { rows: Record<string, unknown>[][]; end: number } | undefined {
   let offset = 0;
   const isStructuralWhitespace = (character: string | undefined): boolean =>
     character === " " ||
@@ -224,7 +314,7 @@ function parseTelegramAdaptiveActionPayloadRows(
     if (source[offset] !== ",") return true;
     offset += 1;
     skipWhitespace();
-    return source[offset] !== "," && source[offset] !== "]";
+    return source[offset] !== ",";
   };
   const normalizeAtom = (value: string): string | undefined => {
     const normalized = value.trim();
@@ -259,15 +349,7 @@ function parseTelegramAdaptiveActionPayloadRows(
           normalizeAtom(atom.join("")),
         );
         if (atoms.some((atom) => atom === undefined)) return undefined;
-        const [label, prompt, selectedStyle] = atoms as string[];
-        if (atoms.length === 1) return { value: label };
-        if (atoms.length === 2) return { label, prompt };
-        if (
-          selectedStyle !== "primary" &&
-          selectedStyle !== "success" &&
-          selectedStyle !== "danger"
-        ) return undefined;
-        return { label, prompt, selected_style: selectedStyle };
+        return parseCompactPayload(atoms as string[]);
       }
       atomSources.at(-1)!.push(character);
       offset += 1;
@@ -304,14 +386,10 @@ function parseTelegramAdaptiveActionPayloadRows(
       ) return undefined;
       if (stack.length > 0) continue;
       const candidate = source.slice(start, index + 1);
-      try {
-        const value: unknown = JSON.parse(candidate);
-        if (!isTelegramActionPayload(value)) return undefined;
-        offset = index + 1;
-        return value;
-      } catch {
-        return undefined;
-      }
+      const value = parseTelegramJsonObjectCandidate(candidate);
+      if (!value) return undefined;
+      offset = index + 1;
+      return value;
     }
     return undefined;
   };
@@ -320,6 +398,7 @@ function parseTelegramAdaptiveActionPayloadRows(
     const jsonCell = parseJsonObjectCell();
     if (jsonCell) return jsonCell;
     offset = start;
+    if (looksLikeTelegramNamedJsonObject(source, start)) return undefined;
     return parseCompactCell();
   };
   const parseRow = (): Record<string, unknown>[] | undefined => {
@@ -377,42 +456,92 @@ function parseTelegramAdaptiveActionPayloadRows(
   }
   if (!rows) return undefined;
   skipWhitespace();
-  return offset === source.length ? rows : undefined;
+  if (!options.allowTrailing && offset !== source.length) return undefined;
+  return { rows, end: offset };
+}
+
+function findTelegramStructuredPayloadEnd(
+  source: string,
+  start: number,
+): number | undefined {
+  const stack: string[] = [source[start]!];
+  let inString = false;
+  let escaped = false;
+  for (let offset = start + 1; offset < source.length; offset += 1) {
+    const character = source[offset]!;
+    if (inString) {
+      if (escaped) escaped = false;
+      else if (character === "\\") escaped = true;
+      else if (character === '"') inString = false;
+      continue;
+    }
+    if (character === '"') {
+      inString = true;
+      continue;
+    }
+    if (character === "[" || character === "{") {
+      stack.push(character);
+      continue;
+    }
+    if (character !== "]" && character !== "}") continue;
+    const expected = character === "]" ? "[" : "{";
+    if (stack.at(-1) === expected) stack.pop();
+    if (stack.length === 0) return offset + 1;
+  }
+  return undefined;
+}
+
+function isPlausibleTelegramMatrixStart(
+  source: string,
+  start: number,
+): boolean {
+  let offset = start + 1;
+  while (/\s/u.test(source[offset] ?? "")) offset += 1;
+  return (
+    source[offset] === "{" ||
+    source[offset] === "[" ||
+    source[offset] === "]"
+  );
 }
 
 export function parseTelegramActionPayloadRows(
   comment: TelegramTopLevelHtmlComment,
   command: string,
 ): Record<string, unknown>[][] | undefined {
-  const payload = getTelegramActionPayloadSource(comment, command);
-  if (!payload) return undefined;
-  if (payload.source.startsWith("[") || payload.source.startsWith("{")) {
-    try {
-      const value: unknown = JSON.parse(payload.source);
-      if (isTelegramActionPayload(value)) return [[value]];
-      if (!Array.isArray(value)) return undefined;
-      const rows: Record<string, unknown>[][] = [];
-      for (const entry of value) {
-        if (isTelegramActionPayload(entry)) {
-          rows.push([entry]);
-          continue;
-        }
-        if (
-          !Array.isArray(entry) ||
-          entry.length === 0 ||
-          !entry.every(isTelegramActionPayload)
-        ) {
-          return undefined;
-        }
-        rows.push(entry);
+  let content = comment.content.replace(/^\s+/, "").replace(/^!/, "");
+  if (!content.startsWith(command)) return undefined;
+  content = content.slice(command.length);
+  let attributeEnvelope = content;
+  for (let offset = 0; offset < content.length; offset += 1) {
+    if (content[offset] !== "[" && content[offset] !== "{") continue;
+    if (
+      content[offset] === "[" &&
+      !isPlausibleTelegramMatrixStart(content, offset)
+    ) {
+      const noiseEnd = findTelegramStructuredPayloadEnd(content, offset);
+      if (noiseEnd !== undefined) {
+        attributeEnvelope = `${attributeEnvelope.slice(0, offset)}${" ".repeat(noiseEnd - offset)}${attributeEnvelope.slice(noiseEnd)}`;
+        offset = noiseEnd - 1;
       }
-      return rows;
-    } catch {
-      return parseTelegramAdaptiveActionPayloadRows(payload.source);
+      continue;
     }
+    const parsed = parseTelegramAdaptiveActionPayloadRows(
+      content.slice(offset),
+      parseTelegramButtonCompactActionPayload,
+      { allowTrailing: true },
+    );
+    if (parsed) return parsed.rows;
+    const end = findTelegramStructuredPayloadEnd(content, offset);
+    if (end === undefined) continue;
+    attributeEnvelope = `${attributeEnvelope.slice(0, offset)}${" ".repeat(end - offset)}${attributeEnvelope.slice(end)}`;
+    offset = end - 1;
   }
-  if (payload.hasBody) return undefined;
-  const attributes = parseCanonicalTelegramActionAttributes(payload.source);
+  const attributes = parseTolerantTelegramAttributes(attributeEnvelope, [
+    "label",
+    "prompt",
+    "value",
+    "selected_style",
+  ]);
   return attributes ? [[attributes]] : undefined;
 }
 
@@ -481,9 +610,10 @@ export function planTelegramVoiceReply(
   let lang: string | undefined;
   let rate: string | undefined;
   const stripped = replaceTopLevelHtmlComments(markdown, (comment) => {
-    const command = parseTopLevelTelegramComment(comment, "telegram_voice");
-    if (!command) return comment.raw;
-    const payload = parseTelegramActionPayload(comment, "telegram_voice");
+    const command = "telegram_voice";
+    const normalizedContent = comment.content.replace(/^\s+/, "").replace(/^!/, "");
+    if (!normalizedContent.startsWith(command)) return comment.raw;
+    const payload = parseTelegramActionPayload(comment, command);
     if (!payload) return "";
     const text =
       getTelegramActionString(payload, "text") ??