@llblab/pi-telegram 0.9.8 → 0.9.9

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.9.9: Guest Mode HTML Rendering
+
+- `[Guest Mode]` Guest replies now render through the same `renderTelegramMessage` pipeline as direct messages: Markdown → HTML → `answerGuestQuery` with `parse_mode: "HTML"`. Bold, italic, code, links, lists, and tables render identically in guest and DM replies.
+- `[Replies]` Added `createGuestMarkdownReplySender` in the replies domain — guest rendering stays encapsulated within `replies.ts` and `index.ts` no longer imports from `rendering.ts` directly.
+- `[API]` Simplified `answerGuestQuery` title to a fixed `"Response"` string (the `InlineQueryResultArticle` title is hidden in guest mode and was previously generated by stripping HTML/Markdown from the message text).
+- `[API]` Removed `replyMarkup` parameter from `answerGuestQuery` — inline keyboards are not supported in guest mode because `callback_query` from inline results carries `inline_message_id` instead of `chat_id`/`message_id`, which the existing callback routing cannot handle.
+
 ## 0.9.8: Guest Mode Context
 
 - `[Guest Mode]` Extended the [telegram] prefix with |from:user (sender) and |guest:GroupName (source chat for group guest messages) so the agent sees who sent the message and where from. Private guest chats omit the guest: suffix.

package/index.ts

@@ -157,6 +157,11 @@ export default function (pi: Pi.ExtensionAPI) {
 
   // --- Message Delivery & Preview ---
 
+  const sendGuestReply = Replies.createGuestMarkdownReplySender({
+    renderTelegramMessage: Replies.renderTelegramMessage,
+    answerGuestQuery,
+  });
+
   const promptDispatchRuntime =
     Runtime.createTelegramPromptDispatchRuntime<Pi.ExtensionContext>({
       lifecycle,
@@ -497,6 +502,7 @@ export default function (pi: Pi.ExtensionAPI) {
     sendTextReply,
     sendQueuedAttachments: queuedAttachmentSender,
     answerGuestQuery,
+    sendGuestReply,
     planOutboundReply: outboundReplyPlanner,
     sendOutboundReplyArtifacts: outboundReplyArtifactSender,
     isCurrentOwner: lockOwnershipGuard.ownsContext,

package/lib/api.ts

@@ -256,7 +256,11 @@ export interface TelegramApiClient {
     callbackQueryId: string,
     text?: string,
   ) => Promise<void>;
-  answerGuestQuery?: (guestQueryId: string, text?: string) => Promise<void>;
+  answerGuestQuery?: (
+    guestQueryId: string,
+    text?: string,
+    options?: { parseMode?: string },
+  ) => Promise<void>;
 }
 
 export interface TelegramBridgeApiRuntimeDeps {
@@ -314,7 +318,11 @@ export interface TelegramBridgeApiRuntime {
     callbackQueryId: string,
     text?: string,
   ) => Promise<void>;
-  answerGuestQuery: (guestQueryId: string, text?: string) => Promise<void>;
+  answerGuestQuery: (
+    guestQueryId: string,
+    text?: string,
+    options?: { parseMode?: string },
+  ) => Promise<void>;
   prepareTempDir: () => Promise<number>;
 }
 
@@ -785,14 +793,24 @@ export function createTelegramBridgeApiRuntime(
     answerCallbackQuery: (callbackQueryId, text) => {
       return deps.client.answerCallbackQuery(callbackQueryId, text);
     },
-    answerGuestQuery: (guestQueryId, text) => {
+    answerGuestQuery: (
+      guestQueryId: string,
+      text: string | undefined,
+      options: { parseMode?: string } | undefined,
+    ) => {
       const body: Record<string, unknown> = { guest_query_id: guestQueryId };
       if (text !== undefined) {
+        const inputContent: Record<string, unknown> = {
+          message_text: text,
+        };
+        if (options?.parseMode) {
+          inputContent.parse_mode = options.parseMode;
+        }
         body.result = {
           type: "article",
           id: "1",
-          title: text.length > 64 ? text.slice(0, 61) + "..." : text,
-          input_message_content: { message_text: text },
+          title: "Response",
+          input_message_content: inputContent,
         };
       }
       return callRecorded<void>("answerGuestQuery", body);

package/lib/queue.ts

@@ -788,7 +788,8 @@ export interface TelegramAgentEndRuntimeDeps<
     text: string,
   ) => Promise<unknown>;
   sendQueuedAttachments: (turn: TTurn) => Promise<void>;
-  answerGuestQuery?: (guestQueryId: string, text?: string) => Promise<void>;
+  answerGuestQuery?: (guestQueryId: string, text?: string, options?: { parseMode?: string }) => Promise<void>;
+  sendGuestReply?: (guestQueryId: string, markdown: string) => Promise<void>;
   planOutboundReply?: (
     markdown: string,
   ) => TelegramAgentEndOutboundReplyPlan<TReplyMarkup>;
@@ -837,6 +838,7 @@ export interface TelegramAgentEndHookRuntimeDeps<
   sendTextReply: TelegramAgentEndRuntimeDeps<TTurn>["sendTextReply"];
   sendQueuedAttachments: (turn: TTurn) => Promise<void>;
   answerGuestQuery?: TelegramAgentEndRuntimeDeps<TTurn>["answerGuestQuery"];
+  sendGuestReply?: TelegramAgentEndRuntimeDeps<TTurn>["sendGuestReply"];
   planOutboundReply?: TelegramAgentEndRuntimeDeps<
     TTurn,
     TReplyMarkup
@@ -958,6 +960,7 @@ export function createTelegramAgentEndHook<
       sendTextReply: deps.sendTextReply,
       sendQueuedAttachments: deps.sendQueuedAttachments,
       answerGuestQuery: deps.answerGuestQuery,
+      sendGuestReply: deps.sendGuestReply,
       planOutboundReply: deps.planOutboundReply,
       sendOutboundReplyArtifacts: deps.sendOutboundReplyArtifacts,
       getDefaultChatId: deps.getDefaultChatId,
@@ -1027,7 +1030,11 @@ export async function handleTelegramAgentEndRuntime<
       return;
     }
     if (finalText) {
-      await deps.answerGuestQuery?.(turn.guestQueryId, finalText);
+      if (deps.sendGuestReply) {
+        await deps.sendGuestReply(turn.guestQueryId, finalText);
+      } else {
+        await deps.answerGuestQuery?.(turn.guestQueryId, finalText);
+      }
     }
     if (endPlan.shouldDispatchNext) deps.dispatchNextQueuedTelegramTurn();
     return;

package/lib/replies.ts

@@ -11,6 +11,12 @@ import {
   type TelegramRenderMode,
 } from "./rendering.ts";
 
+export {
+  renderTelegramMessage,
+  type TelegramRenderedChunk,
+  type TelegramRenderMode,
+};
+
 // --- Reply Dedup ---
 
 /** Non-persistent reply deduplication for a single agent turn.
@@ -420,3 +426,26 @@ export function dedupSendMarkdownReply<TReplyMarkup = unknown>(
     return inner(chatId, effectiveReplyTo, markdown, options);
   };
 }
+
+/**
+ * Guest reply sender: renders Markdown → HTML, sends via answerGuestQuery.
+ * Keeps guest rendering inside the replies domain so the orchestration layer
+ * (index.ts) does not import from rendering.ts directly.
+ */
+export function createGuestMarkdownReplySender(deps: {
+  renderTelegramMessage: (
+    text: string,
+    options?: { mode?: TelegramRenderMode },
+  ) => TelegramRenderedChunk[];
+  answerGuestQuery: (
+    guestQueryId: string,
+    text?: string,
+    options?: { parseMode?: string },
+  ) => Promise<void>;
+}) {
+  return async (guestQueryId: string, markdown: string) => {
+    const chunks = deps.renderTelegramMessage(markdown, { mode: "markdown" });
+    const html = chunks.length > 0 ? chunks[0].text : markdown;
+    await deps.answerGuestQuery(guestQueryId, html, { parseMode: "HTML" });
+  };
+}

package/package.json

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