@cmdop/bot 2026.2.26 → 2026.2.28

package/README.md

@@ -279,6 +279,12 @@ All errors extend `BotError` and expose a `code` string:
 - `@cmdop/node` (peer dependency, installed automatically)
 - Platform libraries are **optional peer dependencies** — install only what you use
 
+## Links
+
+- [Homepage](https://cmdop.com/sdk/python/bot)
+- [Documentation](https://cmdop.com/docs/sdk/node/bot)
+- [npm](https://www.npmjs.com/package/@cmdop/bot)
+
 ## License
 
 MIT

package/dist/index.cjs

@@ -5,6 +5,7 @@ var grammy = require('grammy');
 var discord_js = require('discord.js');
 var bolt = require('@slack/bolt');
 var node = require('@cmdop/node');
+var consola = require('consola');
 
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -161,6 +162,95 @@ var init_errors = __esm({
   }
 });
 
+// src/models/command.ts
+var command_exports = {};
+__export(command_exports, {
+  ParsedCommandSchema: () => exports.ParsedCommandSchema,
+  parseCommand: () => parseCommand
+});
+function parseCommand(text) {
+  const trimmed = text.trim();
+  const match = /^[/!](\w+)(?:\s+(.*))?$/s.exec(trimmed);
+  if (!match) return null;
+  const name = (match[1] ?? "").toLowerCase();
+  const rest = (match[2] ?? "").trim();
+  const args = rest ? rest.split(/\s+/) : [];
+  return exports.ParsedCommandSchema.parse({ name, args, rawText: trimmed });
+}
+exports.ParsedCommandSchema = void 0;
+var init_command = __esm({
+  "src/models/command.ts"() {
+    exports.ParsedCommandSchema = v4.z.object({
+      name: v4.z.string().min(1),
+      args: v4.z.array(v4.z.string()),
+      rawText: v4.z.string()
+    });
+  }
+});
+
+// src/core/base-channel.ts
+exports.BaseChannel = void 0;
+var init_base_channel = __esm({
+  "src/core/base-channel.ts"() {
+    init_command();
+    init_errors();
+    exports.BaseChannel = class {
+      constructor(id, name, permissions, dispatcher, logger) {
+        this.id = id;
+        this.name = name;
+        this.permissions = permissions;
+        this.dispatcher = dispatcher;
+        this.logger = logger;
+      }
+      /**
+       * Process an incoming message: parse command → check permission → dispatch → send result.
+       * Plain text (non-command) is routed to the agent handler automatically.
+       * Channels call this from their platform event handler.
+       */
+      async processMessage(msg) {
+        const parsed = parseCommand(msg.text);
+        const ctx = parsed ? {
+          userId: msg.userId,
+          command: parsed.name,
+          args: parsed.args,
+          channelId: msg.channelId,
+          message: msg
+        } : {
+          userId: msg.userId,
+          command: "agent",
+          args: [msg.text],
+          channelId: msg.channelId,
+          message: msg
+        };
+        let result;
+        try {
+          result = await this.dispatcher.dispatch(ctx);
+        } catch (err2) {
+          const botErr = err2 instanceof exports.BotError ? err2 : new exports.BotError("Unexpected error", { cause: err2 instanceof Error ? err2 : void 0 });
+          result = { ok: false, error: botErr };
+        }
+        if (result.ok) {
+          await this.send(msg.userId, result.value);
+        } else {
+          await this.send(msg.userId, {
+            type: "error",
+            message: this.formatErrorMessage(result.error)
+          });
+        }
+      }
+      formatErrorMessage(error) {
+        if (error instanceof exports.CommandNotFoundError) {
+          return `Unknown command. Type /help for available commands.`;
+        }
+        return error.message;
+      }
+      logEvent(event, meta = {}) {
+        this.logger.info(`[${this.name}] ${event}`, { channel: this.id, ...meta });
+      }
+    };
+  }
+});
+
 // ../../node_modules/.pnpm/bottleneck@2.19.5/node_modules/bottleneck/lib/parser.js
 var require_parser = __commonJS({
   "../../node_modules/.pnpm/bottleneck@2.19.5/node_modules/bottleneck/lib/parser.js"(exports2) {
@@ -3011,9 +3101,9 @@ var require_lib = __commonJS({
   }
 });
 
-// ../../node_modules/.pnpm/@grammyjs+transformer-throttler@1.2.1_grammy@1.40.0/node_modules/@grammyjs/transformer-throttler/dist/deps.node.js
+// ../../node_modules/.pnpm/@grammyjs+transformer-throttler@1.2.1_grammy@1.40.1/node_modules/@grammyjs/transformer-throttler/dist/deps.node.js
 var require_deps_node = __commonJS({
-  "../../node_modules/.pnpm/@grammyjs+transformer-throttler@1.2.1_grammy@1.40.0/node_modules/@grammyjs/transformer-throttler/dist/deps.node.js"(exports2) {
+  "../../node_modules/.pnpm/@grammyjs+transformer-throttler@1.2.1_grammy@1.40.1/node_modules/@grammyjs/transformer-throttler/dist/deps.node.js"(exports2) {
     var __importDefault = exports2 && exports2.__importDefault || function(mod2) {
       return mod2 && mod2.__esModule ? mod2 : { "default": mod2 };
     };
@@ -3026,9 +3116,9 @@ var require_deps_node = __commonJS({
   }
 });
 
-// ../../node_modules/.pnpm/@grammyjs+transformer-throttler@1.2.1_grammy@1.40.0/node_modules/@grammyjs/transformer-throttler/dist/mod.js
+// ../../node_modules/.pnpm/@grammyjs+transformer-throttler@1.2.1_grammy@1.40.1/node_modules/@grammyjs/transformer-throttler/dist/mod.js
 var require_mod = __commonJS({
-  "../../node_modules/.pnpm/@grammyjs+transformer-throttler@1.2.1_grammy@1.40.0/node_modules/@grammyjs/transformer-throttler/dist/mod.js"(exports2) {
+  "../../node_modules/.pnpm/@grammyjs+transformer-throttler@1.2.1_grammy@1.40.1/node_modules/@grammyjs/transformer-throttler/dist/mod.js"(exports2) {
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.bypassThrottler = exports2.apiThrottler = exports2.BottleneckStrategy = void 0;
     var deps_node_js_1 = require_deps_node();
@@ -3091,90 +3181,10 @@ var require_mod = __commonJS({
   }
 });
 
-// src/models/command.ts
-var command_exports = {};
-__export(command_exports, {
-  ParsedCommandSchema: () => exports.ParsedCommandSchema,
-  parseCommand: () => parseCommand
-});
-function parseCommand(text) {
-  const trimmed = text.trim();
-  const match = /^[/!](\w+)(?:\s+(.*))?$/s.exec(trimmed);
-  if (!match) return null;
-  const name = (match[1] ?? "").toLowerCase();
-  const rest = (match[2] ?? "").trim();
-  const args = rest ? rest.split(/\s+/) : [];
-  return exports.ParsedCommandSchema.parse({ name, args, rawText: trimmed });
-}
-exports.ParsedCommandSchema = void 0;
-var init_command = __esm({
-  "src/models/command.ts"() {
-    exports.ParsedCommandSchema = v4.z.object({
-      name: v4.z.string().min(1),
-      args: v4.z.array(v4.z.string()),
-      rawText: v4.z.string()
-    });
-  }
-});
-
-// src/core/base-channel.ts
-exports.BaseChannel = void 0;
-var init_base_channel = __esm({
-  "src/core/base-channel.ts"() {
-    init_command();
-    init_errors();
-    exports.BaseChannel = class {
-      constructor(id, name, permissions, dispatcher, logger) {
-        this.id = id;
-        this.name = name;
-        this.permissions = permissions;
-        this.dispatcher = dispatcher;
-        this.logger = logger;
-      }
-      /**
-       * Process an incoming message: parse command → check permission → dispatch → send result.
-       * Channels call this from their platform event handler.
-       */
-      async processMessage(msg) {
-        const parsed = parseCommand(msg.text);
-        if (!parsed) return;
-        const ctx = {
-          userId: msg.userId,
-          command: parsed.name,
-          args: parsed.args,
-          channelId: msg.channelId,
-          message: msg
-        };
-        let result;
-        try {
-          result = await this.dispatcher.dispatch(ctx);
-        } catch (err2) {
-          const botErr = err2 instanceof exports.BotError ? err2 : new exports.BotError("Unexpected error", { cause: err2 instanceof Error ? err2 : void 0 });
-          result = { ok: false, error: botErr };
-        }
-        if (result.ok) {
-          await this.send(msg.userId, result.value);
-        } else {
-          await this.send(msg.userId, {
-            type: "error",
-            message: this.formatErrorMessage(result.error)
-          });
-        }
-      }
-      formatErrorMessage(error) {
-        if (error instanceof exports.CommandNotFoundError) {
-          return `Unknown command. Type /help for available commands.`;
-        }
-        return error.message;
-      }
-      logEvent(event, meta = {}) {
-        this.logger.info(`[${this.name}] ${event}`, { channel: this.id, ...meta });
-      }
-    };
-  }
-});
-
 // src/channels/telegram/formatter.ts
+function escapeHtml(text) {
+  return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
 function formatBytes(bytes) {
   if (bytes < 1024) return `${bytes}B`;
   if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)}K`;
@@ -3244,6 +3254,51 @@ ${this.formatText(error.message)}`;
         const sizeStr = size !== void 0 && !isDir ? ` \\(${this.formatText(formatBytes(size))}\\)` : "";
         return `${icon} \`${this.escapeInline(name)}\`${sizeStr}`;
       }
+      // ─── HTML formatting (preferred — avoids MarkdownV2 escaping hell) ────────
+      /**
+       * Escape HTML special chars, then convert basic markdown to HTML tags.
+       * Handles: **bold**, `code`, ```code blocks```, _italic_
+       */
+      formatTextHtml(text) {
+        let html = escapeHtml(text);
+        html = html.replace(/```(\w*)\n([\s\S]*?)```/g, (_m, lang, code) => {
+          const cls = lang ? ` class="language-${lang}"` : "";
+          return `<pre><code${cls}>${code}</code></pre>`;
+        });
+        html = html.replace(/`([^`]+)`/g, "<code>$1</code>");
+        html = html.replace(/\*\*(.+?)\*\*/g, "<b>$1</b>");
+        html = html.replace(/__(.+?)__/g, "<b>$1</b>");
+        html = html.replace(/(?<!\w)\*([^*]+?)\*(?!\w)/g, "<i>$1</i>");
+        html = html.replace(/(?<!\w)_([^_]+?)_(?!\w)/g, "<i>$1</i>");
+        return html;
+      }
+      /**
+       * Format code block as HTML <pre>.
+       */
+      formatCodeHtml(code, language) {
+        const escaped = escapeHtml(code);
+        const cls = language ? ` class="language-${language}"` : "";
+        const wrapped = `<pre><code${cls}>${escaped}</code></pre>`;
+        if (wrapped.length <= TELEGRAM_MAX_MESSAGE_LENGTH) return wrapped;
+        const overhead = 40 + (language?.length ?? 0);
+        const maxCode = TELEGRAM_MAX_MESSAGE_LENGTH - overhead;
+        return `<pre><code${cls}>${escaped.slice(0, maxCode)}
+\u2026(truncated)</code></pre>`;
+      }
+      /**
+       * Format error message as HTML.
+       */
+      formatErrorHtml(message) {
+        return `\u274C <b>Error:</b> ${escapeHtml(message)}`;
+      }
+      /**
+       * Format file entry as HTML.
+       */
+      formatFileEntryHtml(name, isDir, size) {
+        const icon = isDir ? "\u{1F4C1}" : "\u{1F4C4}";
+        const sizeStr = size !== void 0 && !isDir ? ` (${formatBytes(size)})` : "";
+        return `${icon} <code>${escapeHtml(name)}</code>${sizeStr}`;
+      }
       // Escape text that appears inside inline code (backtick context)
       escapeInline(text) {
         return text.replace(/`/g, "'");
@@ -3282,8 +3337,18 @@ var init_channel = __esm({
         bot.on("message:text", async (ctx) => {
           const msg = this.normalizeContext(ctx);
           if (!msg) return;
-          for (const h3 of this.messageHandlers) await h3(msg);
-          await this.processMessage(msg);
+          const typingInterval = setInterval(() => {
+            ctx.api.sendChatAction(ctx.chat.id, "typing").catch(() => {
+            });
+          }, 4e3);
+          await ctx.api.sendChatAction(ctx.chat.id, "typing").catch(() => {
+          });
+          try {
+            for (const h3 of this.messageHandlers) await h3(msg);
+            await this.processMessage(msg);
+          } finally {
+            clearInterval(typingInterval);
+          }
         });
         bot.on("callback_query:data", async (ctx) => {
           await ctx.answerCallbackQuery();
@@ -3331,20 +3396,18 @@ var init_channel = __esm({
         try {
           switch (message.type) {
             case "text": {
-              const text = this.truncate(this.formatter.formatText(message.text));
-              await this.bot.api.sendMessage(chatId, text, { parse_mode: "MarkdownV2" });
+              const text = this.truncate(this.formatter.formatTextHtml(message.text));
+              await this.bot.api.sendMessage(chatId, text, { parse_mode: "HTML" });
               break;
             }
             case "code": {
-              const code = this.formatter.formatCode(message.code, message.language);
-              await this.bot.api.sendMessage(chatId, code, { parse_mode: "MarkdownV2" });
+              const code = this.formatter.formatCodeHtml(message.code, message.language);
+              await this.bot.api.sendMessage(chatId, code, { parse_mode: "HTML" });
               break;
             }
             case "error": {
-              const errText = this.formatter.formatError(
-                Object.assign(new Error(message.message), { code: "BOT_ERROR", context: {}, toLog: () => ({}) })
-              );
-              await this.bot.api.sendMessage(chatId, errText, { parse_mode: "MarkdownV2" });
+              const errText = this.formatter.formatErrorHtml(message.message);
+              await this.bot.api.sendMessage(chatId, errText, { parse_mode: "HTML" });
               break;
             }
           }
@@ -3371,7 +3434,7 @@ var init_channel = __esm({
       }
       truncate(text) {
         if (text.length <= this.maxLength) return text;
-        return text.slice(0, this.maxLength - 20) + "\n\\.\\.\\. *\\(truncated\\)*";
+        return text.slice(0, this.maxLength - 20) + "\n... <i>(truncated)</i>";
       }
     };
   }
@@ -16580,21 +16643,34 @@ var PermissionManager = class {
     return this.identityMap;
   }
 };
-
-// src/core/logger.ts
-var LEVELS = { debug: 0, info: 1, warn: 2, error: 3 };
+var CONSOLA_LEVELS = {
+  debug: 4,
+  info: 3,
+  warn: 2,
+  error: 1
+};
 function createLogger(level = "info") {
-  const minLevel = LEVELS[level];
-  function log(lvl, msg, meta = {}) {
-    if (LEVELS[lvl] < minLevel) return;
-    const entry = { ts: (/* @__PURE__ */ new Date()).toISOString(), level: lvl, msg, ...meta };
-    process.stderr.write(JSON.stringify(entry) + "\n");
-  }
+  const consola$1 = consola.createConsola({
+    level: CONSOLA_LEVELS[level],
+    formatOptions: {
+      date: true,
+      colors: true
+    }
+  }).withTag("bot");
   return {
-    debug: (msg, meta) => log("debug", msg, meta ?? {}),
-    info: (msg, meta) => log("info", msg, meta ?? {}),
-    warn: (msg, meta) => log("warn", msg, meta ?? {}),
-    error: (msg, meta) => log("error", msg, meta ?? {})
+    consola: consola$1,
+    debug(msg, meta) {
+      meta ? consola$1.debug(msg, meta) : consola$1.debug(msg);
+    },
+    info(msg, meta) {
+      meta ? consola$1.info(msg, meta) : consola$1.info(msg);
+    },
+    warn(msg, meta) {
+      meta ? consola$1.warn(msg, meta) : consola$1.warn(msg);
+    },
+    error(msg, meta) {
+      meta ? consola$1.error(msg, meta) : consola$1.error(msg);
+    }
   };
 }
 
@@ -16701,7 +16777,21 @@ var AgentHandler = class extends BaseHandler {
       const text = result.text.length > this.maxOutput ? result.text.slice(0, this.maxOutput) + "\n...(truncated)" : result.text;
       return ok({ type: "text", text });
     } catch (e3) {
-      return err(new exports.CMDOPError("Agent execution failed", e3 instanceof Error ? e3 : void 0));
+      const errMsg = e3 instanceof Error ? e3.message : String(e3);
+      this.logger.error("Agent execution failed", { error: errMsg });
+      if (errMsg.includes("session_id") || errMsg.includes("No active session")) {
+        return err(new exports.CMDOPError("Machine is offline or CMDOP agent is not running.\nhttps://cmdop.com/downloads/"));
+      }
+      if (errMsg.includes("context canceled") || errMsg.includes("CANCELLED")) {
+        return err(new exports.CMDOPError("Request was interrupted. Please try again."));
+      }
+      if (errMsg.includes("DEADLINE_EXCEEDED") || errMsg.includes("timeout")) {
+        return err(new exports.CMDOPError("Request timed out. The task may be too complex \u2014 try a simpler prompt."));
+      }
+      if (errMsg.includes("UNAVAILABLE") || errMsg.includes("Connection refused")) {
+        return err(new exports.CMDOPError("Server unavailable. Check your connection and try again."));
+      }
+      return err(new exports.CMDOPError(`Agent error: ${errMsg}`, e3 instanceof Error ? e3 : void 0));
     }
   }
 };
@@ -16822,6 +16912,63 @@ function loadSettings(env = process.env) {
   return result.data;
 }
 
+// src/channels/demo/channel.ts
+init_base_channel();
+var DemoChannel = class extends exports.BaseChannel {
+  messageHandlers = [];
+  onOutput;
+  constructor(permissions, dispatcher, logger, options2 = {}) {
+    super("demo", "Demo", permissions, dispatcher, logger);
+    this.onOutput = options2.onOutput ?? ((text) => process.stdout.write(text + "\n"));
+  }
+  async start() {
+    this.logEvent("started");
+  }
+  async stop() {
+    this.messageHandlers = [];
+    this.logEvent("stopped");
+  }
+  send(_userId, message) {
+    const text = formatOutgoing(message);
+    this.onOutput(text, message);
+    return Promise.resolve();
+  }
+  onMessage(handler) {
+    this.messageHandlers.push(handler);
+  }
+  /**
+   * Inject a message as if it came from a real platform user.
+   * Primarily used in tests and CLI demos.
+   */
+  async injectMessage(input) {
+    const msg = {
+      id: `demo-${Date.now()}`,
+      userId: input.userId ?? "demo-user",
+      channelId: this.id,
+      text: input.text,
+      timestamp: /* @__PURE__ */ new Date(),
+      attachments: []
+    };
+    for (const handler of this.messageHandlers) {
+      await handler(msg);
+    }
+    await this.processMessage(msg);
+  }
+};
+function formatOutgoing(message) {
+  switch (message.type) {
+    case "text":
+      return message.text;
+    case "code":
+      return `\`\`\`${message.language ?? ""}
+${message.code}
+\`\`\``;
+    case "error":
+      return `\u274C ${message.message}${message.hint ? `
+\u{1F4A1} ${message.hint}` : ""}`;
+  }
+}
+
 // src/hub.ts
 var IntegrationHub = class _IntegrationHub {
   constructor(_client, _logger, _settings, permissions, dispatcher, channelStartMode) {
@@ -16847,11 +16994,12 @@ var IntegrationHub = class _IntegrationHub {
     Object.assign(settings2, options2.settings ?? {});
     if (options2.defaultMachine) settings2.defaultMachine = options2.defaultMachine;
     const logger = options2.logger ?? createLogger(settings2.logLevel);
-    const client = options2.apiKey ? await node.CMDOPClient.remote(options2.apiKey) : await node.CMDOPClient.local();
+    const client = options2.apiKey ? node.CMDOPClient.remote(options2.apiKey) : node.CMDOPClient.local();
     const store = options2.permissionStore ?? new InMemoryPermissionStore();
     const identityMap = new IdentityMap();
     const permissions = new PermissionManager(store, {
       adminUsers: [...options2.adminUsers ?? [], ...settings2.allowedUsers],
+      defaultLevel: options2.defaultPermission,
       identityMap
     });
     const dispatcher = new MessageDispatcher(permissions, logger);
@@ -16898,6 +17046,15 @@ var IntegrationHub = class _IntegrationHub {
     const channel = new SlackChannel2(options2, this._permissions, this._dispatcher, this._logger);
     return this.registerChannel(channel);
   }
+  /**
+   * Create and register a DemoChannel for CLI testing.
+   * No external dependencies — messages are injected via the returned channel's `injectMessage()`.
+   */
+  addDemo(options2) {
+    const channel = new DemoChannel(this._permissions, this._dispatcher, this._logger, options2);
+    this.registerChannel(channel);
+    return channel;
+  }
   registerHandler(handler) {
     this._dispatcher.register(handler);
     return this;
@@ -16906,6 +17063,17 @@ var IntegrationHub = class _IntegrationHub {
   async start() {
     if (this.started) return;
     this.started = true;
+    if (this._settings.defaultMachine) {
+      try {
+        await this._client.setMachine(this._settings.defaultMachine);
+        this._logger.info("Machine routing initialized", { machine: this._settings.defaultMachine });
+      } catch (err2) {
+        this._logger.error("Failed to initialize machine routing", {
+          machine: this._settings.defaultMachine,
+          err: err2 instanceof Error ? err2.message : String(err2)
+        });
+      }
+    }
     if (this.channelStartMode === "strict") {
       await Promise.all([...this.channels.values()].map(async (ch) => {
         await ch.start();
@@ -17168,63 +17336,6 @@ var SlackStream = class _SlackStream {
   }
 };
 
-// src/channels/demo/channel.ts
-init_base_channel();
-var DemoChannel = class extends exports.BaseChannel {
-  messageHandlers = [];
-  onOutput;
-  constructor(permissions, dispatcher, logger, options2 = {}) {
-    super("demo", "Demo", permissions, dispatcher, logger);
-    this.onOutput = options2.onOutput ?? ((text) => process.stdout.write(text + "\n"));
-  }
-  async start() {
-    this.logEvent("started");
-  }
-  async stop() {
-    this.messageHandlers = [];
-    this.logEvent("stopped");
-  }
-  send(_userId, message) {
-    const text = formatOutgoing(message);
-    this.onOutput(text, message);
-    return Promise.resolve();
-  }
-  onMessage(handler) {
-    this.messageHandlers.push(handler);
-  }
-  /**
-   * Inject a message as if it came from a real platform user.
-   * Primarily used in tests and CLI demos.
-   */
-  async injectMessage(input) {
-    const msg = {
-      id: `demo-${Date.now()}`,
-      userId: input.userId ?? "demo-user",
-      channelId: this.id,
-      text: input.text,
-      timestamp: /* @__PURE__ */ new Date(),
-      attachments: []
-    };
-    for (const handler of this.messageHandlers) {
-      await handler(msg);
-    }
-    await this.processMessage(msg);
-  }
-};
-function formatOutgoing(message) {
-  switch (message.type) {
-    case "text":
-      return message.text;
-    case "code":
-      return `\`\`\`${message.language ?? ""}
-${message.code}
-\`\`\``;
-    case "error":
-      return `\u274C ${message.message}${message.hint ? `
-\u{1F4A1} ${message.hint}` : ""}`;
-  }
-}
-
 // src/channels/telegram/index.ts
 init_channel();
 init_formatter();