pikiloom 0.4.26 → 0.4.28

package/dist/channels/telegram/channel.js

@@ -1,55 +1,3 @@
-/**
- * Telegram channel — Telegram Bot API comms with Telegram-specific hooks.
- *
- * ┌─ Lifecycle ─────────────────────────────────────────────────────────────┐
- * │  connect()          — getMe, 获取 bot 信息 (id, username, displayName) │
- * │  listen()           — 启动 long-polling 循环，持续接收更新              │
- * │  disconnect()       — 停止 polling，中断进行中的请求                    │
- * │  drain()            — 跳过所有积压的旧更新，返回跳过数量               │
- * ├─ 发送 (bot → user) ────────────────────────────────────────────────────┤
- * │  send(chatId, text, opts?)         — 发送文本，支持 HTML/Markdown、     │
- * │                                      回复引用、inline keyboard，       │
- * │                                      超长自动分片 (4096 上限)          │
- * │  editMessage(chatId, msgId, text)  — 编辑已发送消息 (流式输出模拟)     │
- * │  deleteMessage(chatId, msgId)      — 删除消息                          │
- * │  sendPhoto(chatId, photo, opts?)   — 发送图片 (Buffer)，支持 caption   │
- * │  sendDocument(chatId, content, filename, opts?) — 发送文件              │
- * │  sendTyping(chatId)                — 发送"正在输入"状态                │
- * │  answerCallback(callbackId, text?) — 响应 inline 按钮回调              │
- * ├─ 菜单管理 ─────────────────────────────────────────────────────────────┤
- * │  setMenu(commands)  — 注册底部菜单命令 (全局 + knownChats 级别)，      │
- * │                       同时 setChatMenuButton 让菜单按钮可见            │
- * │  clearMenu()        — 删除所有命令，重置菜单按钮为默认                 │
- * ├─ 接收 (user → bot) — Hook 注册 ────────────────────────────────────────┤
- * │  onCommand(handler)  — /command args，自动解析命令名和参数；            │
- * │                        无 handler 时 fallthrough 到 onMessage          │
- * │  onMessage(handler)  — 聚合消息 { text, files[] }；                    │
- * │                        图片/文档自动下载到 workdir，提供本地路径        │
- * │  onCallback(handler) — inline keyboard 按钮点击                        │
- * │  onError(handler)    — polling / handler 错误                          │
- * ├─ Handler Context (ctx) ────────────────────────────────────────────────┤
- * │  chatId / messageId / from (id, username, firstName)                   │
- * │  reply(text, opts)            — 直接回复当前消息                       │
- * │  editReply(msgId, text, opts) — 编辑之前的消息                         │
- * │  answerCallback(text?)        — 响应 callback query (仅 callback)      │
- * │  channel                      — channel 实例，可调高级方法             │
- * │  raw                          — 原始 Telegram update 对象              │
- * ├─ 智能行为 ─────────────────────────────────────────────────────────────┤
- * │  knownChats        — 自动记录所有交互过的 chatId，setMenu 自动遍历     │
- * │  消息聚合           — photo/document 自动下载，统一为 { text, files[] } │
- * │  群组过滤           — 群聊默认只响应 @mention / 回复 bot 的消息        │
- * │  Chat 白名单        — allowedChatIds 限制只处理特定聊天                │
- * │  解析失败降级       — HTML 解析失败自动去掉 parseMode 重试             │
- * │  超长消息分片       — 超过 4096 字符按换行符自动分片发送               │
- * └────────────────────────────────────────────────────────────────────────┘
- *
- * Standalone usage:
- *   const ch = new TelegramChannel({ token: 'BOT_TOKEN', workdir: '/tmp' });
- *   await ch.connect();
- *   ch.onCommand((cmd, args, ctx) => ctx.reply(`Got /${cmd} ${args}`));
- *   ch.onMessage((msg, ctx) => ctx.reply(`Echo: ${msg.text} (files: ${msg.files.length})`));
- *   await ch.listen();
- */
 import crypto from 'node:crypto';
 import fs from 'node:fs';
 import path from 'node:path';
@@ -61,9 +9,6 @@ import { TELEGRAM_LIMITS } from '../../core/constants.js';
 import { ChannelHealth } from '../health.js';
 import { formatScopedLogLine, shouldLog, writeScopedLog } from '../../core/logging.js';
 import { recordKnownChatId } from '../../core/config/user-config.js';
-// ---------------------------------------------------------------------------
-// Proxy support — automatically respects HTTPS_PROXY / HTTP_PROXY / NO_PROXY
-// ---------------------------------------------------------------------------
 setGlobalDispatcher(new EnvHttpProxyAgent());
 export { TelegramChannel };
 const TG_MAX = TELEGRAM_LIMITS.maxMessageLength;
@@ -177,9 +122,6 @@ function isPollingConflictError(err) {
     const msg = err instanceof Error ? err.message : String(err ?? '');
     return msg.startsWith('Telegram polling conflict:');
 }
-// ---------------------------------------------------------------------------
-// TelegramChannel
-// ---------------------------------------------------------------------------
 class TelegramChannel extends Channel {
     capabilities = {
         ...DEFAULT_CHANNEL_CAPABILITIES,
@@ -189,9 +131,6 @@ class TelegramChannel extends Channel {
         messageReactions: true,
         sendImage: true,
     };
-    /** Implementation of Channel.sendImage — wraps sendPhoto with an explicit
-     *  byte buffer + MIME. Used by the bot's final-reply dispatcher for image
-     *  MessageBlocks produced by the agent. */
     async sendImage(chatId, bytes, opts) {
         const filename = opts.filename || `image${extForMime(opts.mime)}`;
         return this.sendPhoto(chatId, bytes, {
@@ -218,9 +157,7 @@ class TelegramChannel extends Channel {
     _hMessage = null;
     _hCallback = null;
     _hError = null;
-    /** Chat IDs seen from incoming updates. */
     knownChats = new Set();
-    /** Cached menu commands for applying to newly discovered chats. */
     _menuCommands = null;
     constructor(opts) {
         super();
@@ -234,14 +171,10 @@ class TelegramChannel extends Channel {
         if (opts.botUsername)
             this.bot = { id: 0, username: opts.botUsername, displayName: '' };
     }
-    // ---- Telegram-specific hook registration ----------------------------------
     onCommand(h) { this._hCommand = h; }
     onMessage(h) { this._hMessage = h; }
     onCallback(h) { this._hCallback = h; }
     onError(h) { this._hError = h; }
-    // ========================================================================
-    // Lifecycle
-    // ========================================================================
     async connect() {
         let delay = 2000;
         for (let attempt = 1;; attempt++) {
@@ -337,9 +270,6 @@ class TelegramChannel extends Channel {
             });
         }
     }
-    // ========================================================================
-    // Outgoing primitives (Channel interface)
-    // ========================================================================
     _applyThreadId(payload, opts) {
         if (opts?.messageThreadId != null)
             payload.message_thread_id = opts.messageThreadId;
@@ -415,7 +345,7 @@ class TelegramChannel extends Channel {
                 try {
                     await this.api('editMessageText', p);
                 }
-                catch { /* ignore */ }
+                catch { }
             }
         }
     }
@@ -434,16 +364,13 @@ class TelegramChannel extends Channel {
         try {
             await this.api('deleteMessage', { chat_id: chatId, message_id: msgId });
         }
-        catch { /* ignore */ }
+        catch { }
     }
     async sendTyping(chatId, opts = {}) {
         const payload = { chat_id: chatId, action: 'typing' };
         this._applyThreadId(payload, opts);
         await this.api('sendChatAction', payload).catch(() => { });
     }
-    // ========================================================================
-    // Telegram-specific outgoing
-    // ========================================================================
     async answerCallback(callbackId, text) {
         if (text)
             this._logOutgoingText('answerCallbackQuery', `callback_id=${callbackId}`, text);
@@ -542,8 +469,6 @@ class TelegramChannel extends Channel {
             messageThreadId: opts.messageThreadId,
         });
     }
-    /** Set bottom menu commands and ensure the menu button is visible.
-     *  Automatically applies to all known chats (from incoming updates). */
     async setMenu(commands) {
         this._menuCommands = commands;
         await this.api('setMyCommands', { commands });
@@ -552,7 +477,6 @@ class TelegramChannel extends Channel {
             await this._applyMenuToChat(cid);
         }
     }
-    /** Track a chat ID; apply menu on first discovery and persist for restart. */
     _trackChat(chatId) {
         if (this.knownChats.has(chatId))
             return;
@@ -563,7 +487,6 @@ class TelegramChannel extends Channel {
         catch { }
         this._applyMenuToChat(chatId).catch(() => { });
     }
-    /** Apply cached menu commands to a single chat. */
     async _applyMenuToChat(chatId) {
         if (!this._menuCommands)
             return;
@@ -576,7 +499,6 @@ class TelegramChannel extends Channel {
             menu_button: { type: 'commands' },
         }).catch(() => { });
     }
-    /** Remove all bot commands and reset menu button to default. */
     async clearMenu() {
         this._menuCommands = null;
         await this.api('deleteMyCommands', {}).catch(() => { });
@@ -586,7 +508,6 @@ class TelegramChannel extends Channel {
             await this.api('setChatMenuButton', { chat_id: cid, menu_button: { type: 'default' } }).catch(() => { });
         }
     }
-    /** Drain pending updates (call before listen to skip stale messages). */
     async drain() {
         const data = await this.api('getUpdates', { offset: -1, timeout: 0 });
         const results = data.result || [];
@@ -594,7 +515,6 @@ class TelegramChannel extends Channel {
             this.offset = results[results.length - 1].update_id + 1;
         return results.length;
     }
-    /** Get the chat ID from the most recent incoming message (useful for 1v1 bot setup). */
     async getRecentChatId() {
         const data = await this.api('getUpdates', { offset: -1, timeout: 0 });
         const results = data.result || [];
@@ -603,7 +523,6 @@ class TelegramChannel extends Channel {
         const u = results[results.length - 1];
         return u.message?.chat?.id ?? u.callback_query?.message?.chat?.id ?? null;
     }
-    /** Download a Telegram file to a local path. Returns the local path. */
     async downloadFile(fileId, destFilename) {
         const meta = await this.api('getFile', { file_id: fileId });
         const filePath = meta.result.file_path;
@@ -624,7 +543,6 @@ class TelegramChannel extends Channel {
             const buf = Buffer.from(await resp.arrayBuffer());
             fs.writeFileSync(localPath, buf);
         }
-        // Check downloaded file size
         const stat = fs.statSync(localPath);
         if (stat.size > FILE_MAX_BYTES) {
             fs.rmSync(localPath, { force: true });
@@ -632,9 +550,6 @@ class TelegramChannel extends Channel {
         }
         return localPath;
     }
-    // ========================================================================
-    // Low-level API
-    // ========================================================================
     async api(method, payload) {
         const timeout = method === 'getUpdates' ? (this.pollTimeout + 10) * 1000 : this.apiTimeout * 1000;
         const resp = await this._fetchResponse(`Telegram API ${method}`, `${this.base}/${method}`, {
@@ -654,9 +569,6 @@ class TelegramChannel extends Channel {
         }
         return data;
     }
-    // ========================================================================
-    // Internal: dispatch
-    // ========================================================================
     async _dispatch(update) {
         const key = this._queueKey(update);
         if (!key) {
@@ -685,7 +597,6 @@ class TelegramChannel extends Channel {
         return String(raw.chat.id);
     }
     async _dispatchNow(update) {
-        // callback query
         if (update.callback_query) {
             const cq = update.callback_query;
             const chatId = cq.message?.chat?.id;
@@ -703,7 +614,6 @@ class TelegramChannel extends Channel {
             await this._hCallback(cq.data || '', ctx);
             return;
         }
-        // message
         const raw = update.message || update.edited_message;
         if (!raw || !raw.chat?.id)
             return;
@@ -722,7 +632,6 @@ class TelegramChannel extends Channel {
         }
         const from = { id: raw.from?.id, username: raw.from?.username, firstName: raw.from?.first_name };
         const ctx = this._makeCtx(chatId, raw.message_id, from, raw);
-        // command — if no command handler registered, fall through to message handler
         const entities = raw.entities || [];
         const cmdEntity = entities.find((e) => e.type === 'bot_command' && e.offset === 0);
         if (cmdEntity) {
@@ -735,12 +644,10 @@ class TelegramChannel extends Channel {
                 return;
             }
         }
-        // message (text + files aggregation)
         if (!this._hMessage)
             return;
         const text = this._cleanMention(raw.text || raw.caption || '');
         const files = [];
-        // download photo
         if (raw.photo?.length) {
             const best = raw.photo[raw.photo.length - 1];
             this._debug(`[recv] downloading photo file_id=${best.file_id} size=${best.width}x${best.height}`);
@@ -754,7 +661,6 @@ class TelegramChannel extends Channel {
                 this._hError?.(e);
             }
         }
-        // download document
         if (raw.document) {
             const origName = raw.document.file_name || `doc_${raw.message_id}`;
             this._debug(`[recv] downloading document "${origName}" file_id=${raw.document.file_id}`);
@@ -771,9 +677,6 @@ class TelegramChannel extends Channel {
         this._debug(`[dispatch] -> onMessage text="${text.slice(0, 80)}" files=${files.length} chat=${chatId}`);
         await this._hMessage({ text, files }, ctx);
     }
-    // ========================================================================
-    // Internal: helpers
-    // ========================================================================
     _makeCtx(chatId, messageId, from, raw) {
         const messageThreadId = typeof raw?.message_thread_id === 'number' ? raw.message_thread_id : undefined;
         return {

package/dist/channels/telegram/directory.js

@@ -1,6 +1,3 @@
-/**
- * Telegram workdir browser for interactive directory navigation.
- */
 import path from 'node:path';
 import { listSubdirs } from '../../bot/bot.js';
 import { buildCompactSelectionTitle, compactCode, truncateMiddle } from './render.js';

package/dist/channels/telegram/live-preview.js

@@ -1,14 +1,8 @@
-/**
- * Channel-agnostic live preview controller for streaming updates.
- */
 import { hasPreviewMeta, samePreviewMeta, samePreviewPlan } from '../../bot/streaming.js';
 import { STREAM_PREVIEW_TIMEOUTS } from '../../core/constants.js';
 const STREAM_PREVIEW_HEARTBEAT_MS = STREAM_PREVIEW_TIMEOUTS.heartbeat;
 const STREAM_TYPING_HEARTBEAT_MS = STREAM_PREVIEW_TIMEOUTS.typing;
 const STREAM_STALLED_NOTICE_MS = STREAM_PREVIEW_TIMEOUTS.stalledNotice;
-// ---------------------------------------------------------------------------
-// LivePreview — generic streaming preview controller
-// ---------------------------------------------------------------------------
 export class LivePreview {
     initialText;
     agent;
@@ -200,8 +194,6 @@ export class LivePreview {
             }
         });
     }
-    /** True when streaming gave up on the placeholder (e.g. Feishu rejected too many
-     *  consecutive edits). The owner should send the final reply as a fresh card. */
     isPlaceholderAbandoned() {
         return this.placeholderAbandoned;
     }

package/dist/channels/telegram/render.js

@@ -1,6 +1,3 @@
-/**
- * Telegram-specific message rendering and formatting.
- */
 import { encodeCommandAction } from '../../bot/command-ui.js';
 import { currentHumanLoopQuestion, humanLoopAnsweredCount, isHumanLoopAwaitingText, isHumanLoopQuestionAnswered, summarizeHumanLoopAnswer, } from '../../bot/human-loop.js';
 import { footerStatusSymbol, formatFooterParts, trimActivityForPreview, buildProviderUsageLines, extractFinalReplyData, extractStreamPreviewData, parseGfmTable, } from '../../bot/render-shared.js';
@@ -85,15 +82,6 @@ export function renderCommandSelectionHtml(view) {
         lines.push('', `<i>${escapeHtml(view.helperText)}</i>`);
     return lines.join('\n');
 }
-/**
- * Telegram caps `callback_data` at 64 bytes. Most encoded actions fit easily,
- * but BYOK model rows encode as `md:p:<uuid>:<modelId>` (~42 bytes of overhead
- * before the model id even starts), so a single long provider/model id blows
- * the limit — and Telegram then rejects the *entire* message with
- * BUTTON_DATA_INVALID, killing the whole menu. Mirror the PathRegistry idiom
- * from directory.ts: stash the over-length payload and ship a short `r:<id>`
- * token instead, resolving it back on the callback round-trip.
- */
 const TELEGRAM_CALLBACK_LIMIT = 64;
 class CallbackDataRegistry {
     idToData = new Map();
@@ -127,7 +115,6 @@ class CallbackDataRegistry {
     }
 }
 const callbackDataRegistry = new CallbackDataRegistry();
-/** Resolve a `r:<id>` token back to its original encoded action payload. */
 export function unpackCallbackData(data) {
     return callbackDataRegistry.unpack(data);
 }
@@ -179,11 +166,6 @@ export function buildHumanLoopPromptHtml(prompt) {
     }
     return lines.join('\n');
 }
-/**
- * Closed-state rendering for a resolved human-loop card. The original prompt
- * collapses to a single header line plus one line per question showing the
- * answer — no buttons, no "submit hint", just the decision frozen in place.
- */
 export function buildAnsweredHumanLoopPromptHtml(prompt, summary) {
     const symbol = summary.status === 'cancelled' ? '⊘' : '✓';
     const lines = [`<b>${symbol} ${escapeHtml(prompt.title)}</b>`];
@@ -195,7 +177,6 @@ export function buildAnsweredHumanLoopPromptHtml(prompt, summary) {
     return lines.join('\n');
 }
 function mdInline(line) {
-    // Strip inline backtick code — IM channels render them with heavy styling
     const stripped = line.replace(/`([^`\n]+)`/g, '$1');
     return formatMarkdownSegment(stripped);
 }
@@ -331,9 +312,6 @@ export function formatProviderUsageLines(usage) {
     return buildProviderUsageLines(usage).map(line => line.bold ? `<b>${escapeHtml(line.text)}</b>` : escapeHtml(line.text));
 }
 export function buildInitialPreviewHtml(agent, modelOrWaiting, effortOrQueuePosition, waitingArg = false, queuePositionArg = 0) {
-    // Backwards-compat shim: legacy calls pass `(agent, waiting, queuePosition)`,
-    // new calls pass `(agent, model, effort, waiting, queuePosition)`. Normalise
-    // both shapes here so existing tests + callsites keep working.
     let model = null;
     let effort = null;
     let waiting = waitingArg;
@@ -359,9 +337,6 @@ export function buildStreamPreviewHtml(input) {
     const data = extractStreamPreviewData(input);
     const parts = [];
     if (data.planDisplay) {
-        // The first line of planDisplay is already "Plan N/M" (rendered by
-        // renderPlanForPreview). Promote it to the bold heading and inline the
-        // rest, so the card doesn't show a redundant "Plan" line above "Plan N/M".
         const planText = data.planDisplay;
         const nl = planText.indexOf('\n');
         const head = nl >= 0 ? planText.slice(0, nl) : planText;
@@ -375,7 +350,6 @@ export function buildStreamPreviewHtml(input) {
         parts.push(`<blockquote><b>Sub-agent</b>\n${escapeHtml(data.subAgentsDisplay)}</blockquote>`);
     }
     if (data.thinkDisplay && !data.display) {
-        // Elapsed lives in the footer only (single timer). Header is the bare label.
         parts.push(`<blockquote><b>${escapeHtml(data.label)}</b>\n${escapeHtml(data.thinkDisplay)}</blockquote>`);
     }
     else if (data.display) {
@@ -385,10 +359,6 @@ export function buildStreamPreviewHtml(input) {
         parts.push(mdToTgHtml(data.preview));
     }
     else if (data.thinkingProgressText) {
-        // Thinking phase with no streamed thinking/body text yet — show the bare
-        // "{thinkLabel}" so the card isn't blank. The elapsed tick lives in the
-        // footer only (one timer, not two); the footer re-renders on the channel
-        // heartbeat, so the card still visibly advances.
         parts.push(`<blockquote><b>${escapeHtml(data.label)}</b></blockquote>`);
     }
     parts.push(formatPreviewFooterHtml(input.agent, input.elapsedMs, input.meta ?? null, {

package/dist/channels/wecom/bot.js

@@ -1,6 +1,3 @@
-/**
- * WeChat Work / 企业微信 智能机器人 bot orchestration.
- */
 import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';

package/dist/channels/wecom/channel.js

@@ -1,31 +1,3 @@
-/**
- * WeChat Work / 企业微信 智能机器人 channel transport — Smart Bot WebSocket.
- *
- * Endpoint:   wss://openws.work.weixin.qq.com
- * Frame envelope:
- *   { cmd, headers: { req_id }, body }
- *   responses omit `cmd` and may carry { errcode, errmsg }
- *
- * Outbound:
- *   - aibot_subscribe { bot_id, secret }              — auth + register
- *   - ping                                              — heartbeat (30s)
- *   - aibot_respond_msg (stream, finish=true)         — reply to a callback
- *   - aibot_send_msg (markdown)                        — proactive send
- *
- * Inbound:
- *   - aibot_msg_callback { msgid, chatid, chattype, from.userid, msgtype, text/voice/image/file/mixed/quote }
- *
- * Caveats:
- *   - text/voice messages are dispatched as text. Image/file/mixed payloads
- *     reference encrypted URLs that require a separate corp-secret + AES key
- *     to download — out of scope for this minimal transport.
- *   - The protocol has no edit primitive. editMessage is a no-op.
- *   - Plain text messages may be sent via aibot_respond_msg (in conversation,
- *     when we still hold the original req_id) or aibot_send_msg (proactive
- *     send to a known chatid). We use the original req_id for the first
- *     reply and switch to aibot_send_msg for follow-up messages in the same
- *     conversation (e.g. streaming result deliveries).
- */
 import { EventEmitter } from 'node:events';
 import { WebSocket } from 'ws';
 import { Channel, DEFAULT_CHANNEL_CAPABILITIES, splitText, sleep, } from '../base.js';
@@ -40,7 +12,6 @@ function describeError(err) {
 export class WeComChannel extends Channel {
     capabilities = {
         ...DEFAULT_CHANNEL_CAPABILITIES,
-        // Smart Bot WS protocol has no edit primitive.
     };
     knownChats = new Set();
     botId;
@@ -54,13 +25,10 @@ export class WeComChannel extends Channel {
     missedPong = 0;
     reqSeq = 0;
     chatMeta = new Map();
-    /** req_id -> deferred ack handler. */
     pendingAcks = new Map();
-    /** Dedup by msgid. */
     seenMsgIds = new Set();
     seenMsgQueue = [];
     static SEEN_CAP = 256;
-    /** Subscribe ack waiter — only set during initial handshake. */
     subscribeAck = null;
     internalEmitter = new EventEmitter();
     messageHandlers = new Set();
@@ -75,9 +43,6 @@ export class WeComChannel extends Channel {
     }
     onMessage(handler) { this.messageHandlers.add(handler); return this; }
     onError(handler) { this.errorHandlers.add(handler); return this; }
-    // ========================================================================
-    // Lifecycle
-    // ========================================================================
     async connect() {
         const shortId = this.botId.length > 12 ? `${this.botId.slice(0, 6)}...${this.botId.slice(-4)}` : this.botId;
         this.bot = {
@@ -109,9 +74,6 @@ export class WeComChannel extends Channel {
             }
             if (!this.running)
                 break;
-            // A connection that survived >2 heartbeats counts as "healthy session
-            // ended" → reset backoff and reconnect quickly. Anything shorter is
-            // treated as a failed attempt that advances exponential backoff.
             const wasLongLived = Date.now() - connectedAt > 2 * WC_HEARTBEAT_MS;
             const delayMs = wasLongLived
                 ? (health.recordSuccess(), WECOM_LIMITS.initialRetryDelay)
@@ -132,9 +94,6 @@ export class WeComChannel extends Channel {
         this.listenResolve?.();
         this.listenResolve = null;
     }
-    // ========================================================================
-    // Single-connection lifecycle
-    // ========================================================================
     runConnection() {
         return new Promise((resolve, reject) => {
             let settled = false;
@@ -194,7 +153,6 @@ export class WeComChannel extends Channel {
                 this.subscribeAck = null;
                 reject(err instanceof Error ? err : new Error(describeError(err)));
             });
-            // Defensive timeout — server should ack within seconds.
             const timer = setTimeout(() => {
                 if (!this.subscribeAck)
                     return;
@@ -229,9 +187,6 @@ export class WeComChannel extends Channel {
             clearInterval(this.heartbeatTimer);
         this.heartbeatTimer = null;
     }
-    // ========================================================================
-    // Frame dispatch
-    // ========================================================================
     handleFrame(frame) {
         const cmd = frame.cmd || '';
         const reqId = frame.headers?.req_id || '';
@@ -244,7 +199,6 @@ export class WeComChannel extends Channel {
             return;
         }
         if (!cmd) {
-            // Response frame; route by req_id prefix.
             if (reqId.startsWith('ping')) {
                 this.missedPong = 0;
                 return;
@@ -358,9 +312,6 @@ export class WeComChannel extends Channel {
             }
         }
     }
-    // ========================================================================
-    // Outgoing primitives
-    // ========================================================================
     async send(chatId, text, _opts) {
         const chat = String(chatId);
         const trimmed = (text || '').trim() || '(empty)';
@@ -370,7 +321,6 @@ export class WeComChannel extends Channel {
         const replyReqId = meta?.pendingReqId;
         for (let i = 0; i < chunks.length; i++) {
             const chunk = chunks[i];
-            // First chunk: prefer aibot_respond_msg if we hold a fresh req_id.
             if (i === 0 && replyReqId) {
                 const streamId = this.makeReqId('stream');
                 const frame = {
@@ -382,7 +332,6 @@ export class WeComChannel extends Channel {
                     },
                 };
                 await this.writeFrame(frame);
-                // The server treats the req_id as consumed after stream finish=true.
                 if (meta)
                     meta.pendingReqId = null;
                 lastReqId = replyReqId;
@@ -404,17 +353,11 @@ export class WeComChannel extends Channel {
         return lastReqId;
     }
     async editMessage(_chatId, _msgId, _text, _opts) {
-        // No edit primitive in the Smart Bot WS protocol.
     }
     async deleteMessage(_chatId, _msgId) {
-        // No delete primitive.
     }
     async sendTyping(_chatId, _opts) {
-        // No typing indicator.
     }
-    // ========================================================================
-    // Frame writing helpers
-    // ========================================================================
     writeFrame(frame) {
         return new Promise((resolve, reject) => {
             const ws = this.ws;
@@ -434,7 +377,6 @@ export class WeComChannel extends Channel {
         return new Promise((resolve, reject) => {
             const timer = setTimeout(() => {
                 this.pendingAcks.delete(reqId);
-                // Fall back to non-blocking on timeout to avoid deadlocks.
                 this.debug(`[ws] ack timeout req_id=${reqId} — proceeding`);
                 resolve();
             }, timeoutMs);

package/dist/channels/weixin/api.js

@@ -1,6 +1,3 @@
-/**
- * WeChat official account API integration.
- */
 import crypto from 'node:crypto';
 import QRCode from 'qrcode';
 import { VALIDATION_TIMEOUTS, WEIXIN_LIMITS } from '../../core/constants.js';
@@ -43,12 +40,6 @@ function withTimeoutSignal(timeoutMs) {
         dispose: () => clearTimeout(timer),
     };
 }
-/**
- * Combine a timeout signal with an optional external "stop" signal so that
- * either source can abort the in-flight request. Used by long-poll callers
- * to cut over immediately when the channel is being torn down (config change,
- * channel removal) without waiting out the long-poll timeout.
- */
 function combineAbortSignals(timeoutMs, external) {
     const timeout = withTimeoutSignal(timeoutMs);
     if (!external)