open-agents-ai 0.187.585 → 0.187.587

package/dist/index.js

@@ -591008,31 +591008,81 @@ function formatTelegramProgressEvent(event) {
   if (event.type === "tool_call" && event.toolName === "task_complete") return null;
   if (event.type === "tool_result" && event.toolName === "task_complete") return null;
   if (event.type === "tool_call") {
-    return `🔧 Using <code>${escapeTelegramHTML(event.toolName || "tool")}</code>`;
+    return `Using ${escapeTelegramHTML(event.toolName || "tool")}`;
   }
   if (event.type === "tool_result") {
-    const icon = event.success ? "✔" : "✘";
     const preview = sanitizeTelegramProgressText(event.content || "", 80);
-    const suffix = preview ? `: ${escapeTelegramHTML(preview)}` : "";
-    return `${icon} <code>${escapeTelegramHTML(event.toolName || "tool")}</code>${suffix}`;
+    const toolName = escapeTelegramHTML(event.toolName || "tool");
+    if (preview) return `${toolName}: ${escapeTelegramHTML(preview)}`;
+    return event.success ? `${toolName} completed` : `${toolName} failed`;
   }
   if (event.type === "status") {
     const content = sanitizeTelegramProgressText(event.content || "", 120);
-    return content ? `⏳ ${escapeTelegramHTML(content)}` : null;
+    return content ? escapeTelegramHTML(content) : null;
   }
   return null;
 }
 function renderTelegramLiveProgressHTML(progressLines, accumulated) {
-  const recentProgress = progressLines.slice(-6);
-  const progressBlock = recentProgress.length > 0 ? recentProgress.join("\n") : "⏳ Starting...";
-  const draft = sanitizeTelegramProgressText(accumulated, 700);
-  const draftBlock = draft ? `
-
-<i>Drafting answer...</i>
-${convertMarkdownToTelegramHTML(draft)}
-<i>▌</i>` : "\n\n<i>Working...</i>";
-  return `<b>✈ Working on this...</b>
-${progressBlock}${draftBlock}`;
+  const draft = stripTelegramHiddenThinking(accumulated).trim();
+  if (draft) {
+    const clipped = draft.length > 2e3 ? `${draft.slice(0, 1997).trimEnd()}...` : draft;
+    return convertMarkdownToTelegramHTML(clipped);
+  }
+  return progressLines.slice(-6).map((line) => line.trim()).filter(Boolean).join("\n");
+}
+function telegramSyntheticHelpSignatures() {
+  return [
+    { signature: "/help", description: "Show Telegram command help" },
+    { signature: "/start", description: "Show Telegram bridge status and authentication instructions" },
+    { signature: "/auth <code>", description: "Authenticate this Telegram user as bot admin using the TUI code" }
+  ];
+}
+function telegramHelpCommandAllowed(cmd, scope) {
+  if (scope === "admin") return cmd.implementationStatus === "implemented";
+  if (TELEGRAM_PUBLIC_HELP_COMMANDS.has(cmd.name)) return true;
+  return cmd.surfaces.agentTool && !cmd.safety.secretBearing && !cmd.safety.destructive && !cmd.safety.profileGated;
+}
+function buildTelegramHelpHTML(scope, maxPublicCommands = 24) {
+  const commands = listCommandRegistry({ includePlanned: false }).filter((cmd) => telegramHelpCommandAllowed(cmd, scope));
+  const signatures = [
+    ...telegramSyntheticHelpSignatures(),
+    ...commands.flatMap((cmd) => cmd.signatures)
+  ];
+  const seen = /* @__PURE__ */ new Set();
+  const unique = signatures.filter((sig) => {
+    if (seen.has(sig.signature)) return false;
+    seen.add(sig.signature);
+    return true;
+  });
+  const visible = scope === "public" ? unique.slice(0, maxPublicCommands) : unique;
+  const lines = [
+    `<b>Commands (${scope === "admin" ? "admin full scope" : "public secure scope"})</b>`,
+    "",
+    ...visible.map(
+      (sig) => `<code>${escapeTelegramHTML(sig.signature)}</code> - ${escapeTelegramHTML(sig.description)}`
+    )
+  ];
+  if (scope === "public" && unique.length > visible.length) {
+    lines.push("");
+    lines.push(`Public scope truncated to ${visible.length} safe commands. Authenticate as admin for full command help.`);
+  }
+  return lines.join("\n");
+}
+function splitTelegramHTMLMessage(html, maxLength = 3600) {
+  const chunks = [];
+  let current = "";
+  for (const line of html.split("\n")) {
+    const candidate = current ? `${current}
+${line}` : line;
+    if (candidate.length > maxLength && current) {
+      chunks.push(current);
+      current = line;
+    } else {
+      current = candidate;
+    }
+  }
+  if (current.trim()) chunks.push(current);
+  return chunks.length > 0 ? chunks : [html];
 }
 function normalizeTelegramChatId(value2) {
   if (typeof value2 === "number" || typeof value2 === "string") return value2;
@@ -591378,7 +591428,7 @@ function renderTelegramSubAgentError(username, error) {
   process.stdout.write(`    ${c3.dim("⎿")} ${c3.red("✘")} @${username}: ${c3.dim(preview)}
 `);
 }
-var TELEGRAM_SAFETY_PROMPT, ADMIN_DM_PROMPT, ADMIN_GROUP_PROMPT, GROUP_REPLY_DISCRETION_PROMPT, TELEGRAM_CHAT_MODE_PROMPT, ADMIN_CHAT_PROFILE_PROMPT, TELEGRAM_ACTION_RESPONSE_CONTRACT, TELEGRAM_ACTION_INTENT_RE, TELEGRAM_CODEBASE_CONTEXT_RE, TELEGRAM_COMMANDISH_RE, TELEGRAM_CHAT_INTENT_RE, MEDIA_CACHE_TTL_MS, TelegramBridge;
+var TELEGRAM_SAFETY_PROMPT, ADMIN_DM_PROMPT, ADMIN_GROUP_PROMPT, GROUP_REPLY_DISCRETION_PROMPT, TELEGRAM_CHAT_MODE_PROMPT, ADMIN_CHAT_PROFILE_PROMPT, TELEGRAM_ACTION_RESPONSE_CONTRACT, TELEGRAM_ACTION_INTENT_RE, TELEGRAM_CODEBASE_CONTEXT_RE, TELEGRAM_COMMANDISH_RE, TELEGRAM_CHAT_INTENT_RE, TELEGRAM_PUBLIC_HELP_COMMANDS, MEDIA_CACHE_TTL_MS, TelegramBridge;
 var init_telegram_bridge = __esm({
   "packages/cli/src/tui/telegram-bridge.ts"() {
     "use strict";
@@ -591388,6 +591438,7 @@ var init_telegram_bridge = __esm({
     init_render();
     init_tool_policy();
     init_media_routing();
+    init_command_registry();
     TELEGRAM_SAFETY_PROMPT = `
 CRITICAL SAFETY NOTICE — PUBLIC TELEGRAM CHANNEL
 
@@ -591469,6 +591520,7 @@ Telegram response contract:
     TELEGRAM_CODEBASE_CONTEXT_RE = /\b(repo|repository|codebase|workspace|working directory|file|files|folder|directory|src|source|test|tests|package|pnpm|npm|node|git|branch|commit|pr|pull request|issue|shell|terminal|cli|command|function|class|component|endpoint|api)\b/i;
     TELEGRAM_COMMANDISH_RE = /(^|\s)(pnpm|npm|node|git|rg|grep|sed|cat|ls|cd|mkdir|rm|mv|cp|curl|docker|pytest|vitest|tsc)\b/i;
     TELEGRAM_CHAT_INTENT_RE = /\b(hi|hello|hey|thanks|thank you|lol|haha|joke|how are you|what's up|whats up|can you hear|are you there|explain|what is|what are|why|how does|tell me|opinion|quick question)\b/i;
+    TELEGRAM_PUBLIC_HELP_COMMANDS = /* @__PURE__ */ new Set(["help", "start", "auth", "call"]);
     MEDIA_CACHE_TTL_MS = 30 * 60 * 1e3;
     TelegramBridge = class {
       constructor(botToken, onMessage, agentConfig, repoRoot, toolPolicyConfig) {
@@ -591636,6 +591688,15 @@ Telegram response contract:
         if (!canonical || canonical === botless) return input;
         return `/${canonical}${trimmed.slice(first2.length)}`;
       }
+      telegramSlashName(input) {
+        const first2 = input.trim().split(/\s+/)[0] ?? "";
+        if (!first2.startsWith("/")) return "";
+        return first2.slice(1).split("@")[0]?.toLowerCase() ?? "";
+      }
+      isTelegramHelpCommand(input) {
+        const name10 = this.telegramSlashName(input);
+        return name10 === "help" || name10 === "h" || name10 === "commands" || name10 === "cmds";
+      }
       isKnownTelegramSlash(input) {
         const first2 = input.trim().split(/\s+/)[0] ?? "";
         const botless = first2.startsWith("/") ? first2.slice(1).split("@")[0]?.toLowerCase() : "";
@@ -591662,6 +591723,25 @@ Telegram response contract:
       canUseChatActions(msg) {
         return !msg.guestQueryId && (typeof msg.chatId === "number" || String(msg.chatId).startsWith("@"));
       }
+      async replyWithTelegramHelp(msg, isAdmin) {
+        const scope = isAdmin ? "admin" : "public";
+        const chunks = splitTelegramHTMLMessage(buildTelegramHelpHTML(scope));
+        if (msg.guestQueryId) {
+          await this.answerGuestQuery(msg.guestQueryId, chunks[0] ?? "", { parseMode: "HTML" });
+          return;
+        }
+        for (let i2 = 0; i2 < chunks.length; i2++) {
+          const chunk = chunks[i2];
+          if (i2 === 0) {
+            await this.replyToTelegramMessage(msg, chunk, {
+              html: true,
+              replyToMessageId: msg.chatType !== "private" ? msg.messageId : void 0
+            });
+          } else {
+            await this.sendMessageHTML(msg.chatId, chunk);
+          }
+        }
+      }
       recordChatHistory(sessionKey, entry) {
         const existing = this.chatHistory.get(sessionKey) ?? [];
         existing.push({ ...entry, ts: entry.ts ?? Date.now() });
@@ -591942,11 +592022,15 @@ ${TELEGRAM_SAFETY_PROMPT}`);
         if (msg.text.trim().startsWith("/") && await this.handleAdminAuthCommand({ ...msg, text: normalizedCommandText })) {
           return;
         }
+        const isAdmin = this.isAdminUser(msg);
+        if (msg.text.trim().startsWith("/") && this.isTelegramHelpCommand(normalizedCommandText)) {
+          await this.replyWithTelegramHelp(msg, isAdmin);
+          return;
+        }
         if (!this.agentConfig || !this.repoRoot) {
           this.onMessage(msg);
           return;
         }
-        const isAdmin = this.isAdminUser(msg);
         const toolContext = this.resolveToolContext(msg, isAdmin);
         const isAdminDM = toolContext === "telegram-admin-dm";
         const sessionKey = this.sessionKeyForMessage(msg);
@@ -592058,6 +592142,7 @@ Join: ${newUrl}`);
           runner: null,
           typingInterval: null,
           liveMessageId: null,
+          liveMessagePromise: null,
           accumulated: "",
           assistantText: "",
           streamText: "",
@@ -592080,14 +592165,6 @@ Join: ${newUrl}`);
         }
         this.tuiWrite(() => renderTelegramSubAgentStart(msg.username, msg.text, isAdminDM));
         try {
-          if (!msg.guestQueryId) {
-            const msgId = await this.sendLiveMessage(
-              msg.chatId,
-              renderTelegramLiveProgressHTML([], ""),
-              msg.chatType !== "private" ? msg.messageId : void 0
-            );
-            subAgent.liveMessageId = msgId;
-          }
           let mediaContext = "";
           if (msg.media) {
             mediaContext = await this.processMedia(msg);
@@ -592108,6 +592185,10 @@ Join: ${newUrl}`);
             return;
           }
           const finalText = stripTelegramHiddenThinking(result || "").trim() || "I couldn't generate a response. Please try again.";
+          if (subAgent.liveMessagePromise) {
+            await subAgent.liveMessagePromise.catch(() => {
+            });
+          }
           this.recordChatHistory(sessionKey, { role: "user", text: msg.text, mode: "action" });
           this.recordChatHistory(sessionKey, { role: "assistant", text: finalText, mode: "action" });
           const finalHtml = convertMarkdownToTelegramHTML(finalText);
@@ -592132,7 +592213,7 @@ Join: ${newUrl}`);
           this.subAgentViewCallbacks?.onWrite(subAgent.viewId, `error: ${errMsg}`);
           this.subAgentViewCallbacks?.onStatus(subAgent.viewId, "failed");
           if (subAgent.liveMessageId && !msg.guestQueryId) {
-            await this.editLiveMessage(msg.chatId, subAgent.liveMessageId, `❌ Error: ${errMsg}`).catch(() => {
+            await this.editLiveMessage(msg.chatId, subAgent.liveMessageId, `Error: ${errMsg}`).catch(() => {
             });
           } else {
             await this.replyToTelegramMessage(msg, "Sorry, I encountered an error processing your message. Please try again.").catch(() => {
@@ -592154,10 +592235,11 @@ Join: ${newUrl}`);
           runner: null,
           typingInterval: null,
           liveMessageId: null,
+          liveMessagePromise: null,
           accumulated: "",
           assistantText: "",
           streamText: "",
-          intermediateLines: ["💬 Contextual admin chat"],
+          intermediateLines: [],
           lastEditMs: 0,
           aborted: false,
           toolContext,
@@ -592178,13 +592260,6 @@ Join: ${newUrl}`);
         }
         this.tuiWrite(() => renderTelegramSubAgentEvent(msg.username, `admin chat with full context/tools (${this.interactionMode})`));
         try {
-          if (!msg.guestQueryId) {
-            subAgent.liveMessageId = await this.sendLiveMessage(
-              msg.chatId,
-              renderTelegramLiveProgressHTML(subAgent.intermediateLines, ""),
-              msg.chatType !== "private" ? msg.messageId : void 0
-            );
-          }
           let mediaContext = "";
           if (msg.media) {
             mediaContext = await this.processMedia(msg);
@@ -592195,6 +592270,10 @@ Join: ${newUrl}`);
             subAgent.typingInterval = null;
           }
           const finalText = stripTelegramHiddenThinking(result || "").trim() || "I heard you.";
+          if (subAgent.liveMessagePromise) {
+            await subAgent.liveMessagePromise.catch(() => {
+            });
+          }
           this.recordChatHistory(sessionKey, { role: "user", text: msg.text, mode: "chat" });
           this.recordChatHistory(sessionKey, { role: "assistant", text: finalText, mode: "chat" });
           const finalHtml = convertMarkdownToTelegramHTML(finalText);
@@ -592218,7 +592297,7 @@ Join: ${newUrl}`);
           this.subAgentViewCallbacks?.onWrite(subAgent.viewId, `error: ${errMsg}`);
           this.subAgentViewCallbacks?.onStatus(subAgent.viewId, "failed");
           if (subAgent.liveMessageId && !msg.guestQueryId) {
-            await this.editLiveMessage(msg.chatId, subAgent.liveMessageId, `❌ Error: ${escapeTelegramHTML(errMsg)}`).catch(() => {
+            await this.editLiveMessage(msg.chatId, subAgent.liveMessageId, `Error: ${escapeTelegramHTML(errMsg)}`).catch(() => {
             });
           } else {
             await this.replyToTelegramMessage(msg, "Sorry, I couldn't process that Telegram chat message.").catch(() => {
@@ -592247,7 +592326,8 @@ Join: ${newUrl}`);
         let accumulated = "";
         let lastEditMs = 0;
         let lastViewWriteMs = 0;
-        const progressLines = [`💬 Quick chat mode (${this.interactionMode})`];
+        let liveMessagePromise = null;
+        const progressLines = [];
         this.activeChatViews.add(viewId);
         this.refreshActiveTelegramInteractionCount();
         this.subAgentViewCallbacks?.onRegister(
@@ -592263,19 +592343,12 @@ Join: ${newUrl}`);
         }
         this.tuiWrite(() => renderTelegramSubAgentEvent(msg.username, `chat-mode fast reply (${this.interactionMode})`));
         try {
-          if (!msg.guestQueryId) {
-            liveMessageId = await this.sendLiveMessage(
-              msg.chatId,
-              renderTelegramLiveProgressHTML(progressLines, ""),
-              msg.chatType !== "private" ? msg.messageId : void 0
-            );
-          }
           const mediaContext = msg.media || msg.livePhoto ? "Attachment received. Quick-chat mode does not inspect media; use action mode for media analysis." : "";
           const finalText = await this.runTelegramChatCompletion(
             msg,
             toolContext,
             mediaContext,
-            (nextText) => {
+            async (nextText) => {
               accumulated = nextText;
               const now = Date.now();
               if (now - lastViewWriteMs > 900) {
@@ -592284,12 +592357,28 @@ Join: ${newUrl}`);
               }
               if (liveMessageId && !msg.guestQueryId && now - lastEditMs > 900) {
                 lastEditMs = now;
-                this.editLiveMessage(
+                await this.editLiveMessage(
                   msg.chatId,
                   liveMessageId,
                   renderTelegramLiveProgressHTML(progressLines, accumulated)
                 ).catch(() => {
                 });
+              } else if (!liveMessageId && !liveMessagePromise && !msg.guestQueryId) {
+                const html = renderTelegramLiveProgressHTML(progressLines, accumulated);
+                if (html.trim()) {
+                  liveMessagePromise = this.sendLiveMessage(
+                    msg.chatId,
+                    html,
+                    msg.chatType !== "private" ? msg.messageId : void 0
+                  ).then((id) => {
+                    liveMessageId = id;
+                    lastEditMs = Date.now();
+                  }).catch(() => {
+                  }).finally(() => {
+                    liveMessagePromise = null;
+                  });
+                  await liveMessagePromise;
+                }
               }
             }
           );
@@ -592298,6 +592387,11 @@ Join: ${newUrl}`);
             typingInterval = null;
           }
           const cleaned = stripTelegramHiddenThinking(finalText || accumulated).trim() || "I heard you.";
+          const pendingLiveMessage = liveMessagePromise;
+          if (pendingLiveMessage) {
+            await pendingLiveMessage.catch(() => {
+            });
+          }
           this.recordChatHistory(sessionKey, { role: "user", text: msg.text, mode: "chat" });
           this.recordChatHistory(sessionKey, { role: "assistant", text: cleaned, mode: "chat" });
           const finalHtml = convertMarkdownToTelegramHTML(cleaned);
@@ -592321,7 +592415,7 @@ Join: ${newUrl}`);
           this.subAgentViewCallbacks?.onWrite(viewId, `error: ${errMsg}`);
           this.subAgentViewCallbacks?.onStatus(viewId, "failed");
           if (liveMessageId && !msg.guestQueryId) {
-            await this.editLiveMessage(msg.chatId, liveMessageId, `❌ Error: ${escapeTelegramHTML(errMsg)}`).catch(() => {
+            await this.editLiveMessage(msg.chatId, liveMessageId, `Error: ${escapeTelegramHTML(errMsg)}`).catch(() => {
             });
           } else {
             await this.replyToTelegramMessage(msg, "Sorry, I couldn't process that quick chat message.").catch(() => {
@@ -592391,14 +592485,14 @@ ${mediaContext}` : ""}`
           for await (const chunk of streamable.chatCompletionStream(request)) {
             if (chunk.type === "content" && !chunk.thinking && chunk.content) {
               accumulated += chunk.content;
-              onToken(accumulated);
+              await onToken(accumulated);
             }
           }
         }
         if (!accumulated.trim()) {
           const result = await backend.chatCompletion(request);
           accumulated = result.choices[0]?.message?.content ?? "";
-          if (accumulated) onToken(accumulated);
+          if (accumulated) await onToken(accumulated);
         }
         return stripTelegramHiddenThinking(accumulated).trim();
       }
@@ -592456,26 +592550,35 @@ ${mediaContext}` : ""}`
           } else if (event.type === "stream_end" && event.content) {
             subAgent.streamText = event.content;
           }
-          if (subAgent.liveMessageId && !msg.guestQueryId) {
-            if (event.type === "stream_token" && event.streamKind === "content" && event.content) {
-              subAgent.accumulated += event.content;
-            }
-            const intermediateLine = formatTelegramProgressEvent(event);
-            if (intermediateLine) {
-              subAgent.intermediateLines.push(intermediateLine);
-            }
+          if (event.type === "stream_token" && event.streamKind === "content" && event.content) {
+            subAgent.accumulated += event.content;
+          }
+          const intermediateLine = formatTelegramProgressEvent(event);
+          if (intermediateLine) {
+            subAgent.intermediateLines.push(intermediateLine);
+          }
+          if (!msg.guestQueryId) {
+            const html = renderTelegramLiveProgressHTML(subAgent.intermediateLines, subAgent.accumulated);
+            if (!html.trim()) return;
             const now = Date.now();
-            if (now - subAgent.lastEditMs > 1e3) {
-              const hasContent = subAgent.accumulated.length > 10 || subAgent.intermediateLines.length > 0;
-              if (hasContent) {
+            if (subAgent.liveMessageId) {
+              if (now - subAgent.lastEditMs > 1e3) {
                 subAgent.lastEditMs = now;
-                this.editLiveMessage(
-                  msg.chatId,
-                  subAgent.liveMessageId,
-                  renderTelegramLiveProgressHTML(subAgent.intermediateLines, subAgent.accumulated)
-                ).catch(() => {
+                this.editLiveMessage(msg.chatId, subAgent.liveMessageId, html).catch(() => {
                 });
               }
+            } else if (!subAgent.liveMessagePromise) {
+              subAgent.liveMessagePromise = this.sendLiveMessage(
+                msg.chatId,
+                html,
+                msg.chatType !== "private" ? msg.messageId : void 0
+              ).then((id) => {
+                subAgent.liveMessageId = id;
+                subAgent.lastEditMs = Date.now();
+              }).catch(() => {
+              }).finally(() => {
+                subAgent.liveMessagePromise = null;
+              });
             }
           }
         });

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "open-agents-ai",
-  "version": "0.187.585",
+  "version": "0.187.587",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "open-agents-ai",
-      "version": "0.187.585",
+      "version": "0.187.587",
       "hasInstallScript": true,
       "license": "CC-BY-NC-4.0",
       "dependencies": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "open-agents-ai",
-  "version": "0.187.585",
+  "version": "0.187.587",
   "description": "AI coding agent powered by open-source models (Ollama/vLLM) — interactive TUI with agentic tool-calling loop",
   "type": "module",
   "main": "./dist/index.js",