open-agents-ai 0.187.586 → 0.187.587

package/dist/index.js

@@ -591030,6 +591030,60 @@ function renderTelegramLiveProgressHTML(progressLines, accumulated) {
   }
   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;
   return 0;
@@ -591374,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";
@@ -591384,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
 
@@ -591465,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) {
@@ -591632,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() : "";
@@ -591658,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() });
@@ -591938,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);

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "open-agents-ai",
-  "version": "0.187.586",
+  "version": "0.187.587",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "open-agents-ai",
-      "version": "0.187.586",
+      "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.586",
+  "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",