cc-claw 0.20.18 → 0.20.20

package/dist/cli.js

@@ -33,7 +33,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = true ? "0.20.18" : (() => {
+    VERSION = true ? "0.20.20" : (() => {
       try {
         return JSON.parse(readFileSync(join(process.cwd(), "package.json"), "utf-8")).version ?? "unknown";
       } catch {
@@ -7370,11 +7370,6 @@ ${ctx}`);
     } catch {
     }
   }
-  if (tier !== "slim" && tier !== "heartbeat") {
-    sections.push(
-      "[React] Start your response with [REACT:emoji] \u2014 one emoji from the Telegram allowed set matching the message tone. Examples: \u{1F914} question, \u{1FAE1} task/request, \u{1F525} exciting, \u{1F923} funny, \u{1F622} sad, \u{1F4AF} agree, \u{1F389} celebrate, \u{1F468}\u200D\u{1F4BB} coding, \u{1F92F} mind-blown, \u{1F440} interesting, \u{1F91D} thanks, \u{1F60E} chill."
-    );
-  }
   if (sideQuestContext) {
     const { getInFlightMessage: getInFlightMessage3 } = await Promise.resolve().then(() => (init_agent(), agent_exports));
     const inFlightMsg = getInFlightMessage3(sideQuestContext.parentChatId);
@@ -8527,11 +8522,6 @@ function pickFallbackEmoji(userMessage) {
   }
   return "\u{1F44D}";
 }
-function ensureReaction(responseText, userMessage) {
-  if (/\[REACT:.+?\]/.test(responseText)) return responseText;
-  const emoji = pickFallbackEmoji(userMessage);
-  return `[REACT:${emoji}]${responseText}`;
-}
 function isPathAllowed(filePath, cwd) {
   const resolved = resolvePath(cwd ?? process.cwd(), filePath);
   for (const pattern of BLOCKED_PATH_PATTERNS) {
@@ -8709,7 +8699,7 @@ async function sendOrEditKeyboard(chatId, channel, messageId, text, buttons) {
   await channel.sendText(chatId, text, { parseMode: "plain" });
   return void 0;
 }
-var TONE_PATTERNS, ALLOWED_REACTION_EMOJIS, BLOCKED_PATH_PATTERNS, CLI_INSTALL_HINTS, PERM_MODES, VERBOSE_LEVELS, HELP_CATEGORIES, USAGE_WINDOW_MAP, SKILLS_PER_PAGE, MAX_SIDE_QUESTS;
+var TONE_PATTERNS, BLOCKED_PATH_PATTERNS, CLI_INSTALL_HINTS, PERM_MODES, VERBOSE_LEVELS, HELP_CATEGORIES, USAGE_WINDOW_MAP, SKILLS_PER_PAGE, MAX_SIDE_QUESTS;
 var init_helpers = __esm({
   "src/router/helpers.ts"() {
     "use strict";
@@ -8744,77 +8734,6 @@ var init_helpers = __esm({
       // Chill / casual greeting
       { pattern: /^(hey|hi|hello|sup|yo|what'?s up|howdy)\b/i, emoji: "\u{1F60E}" }
     ];
-    ALLOWED_REACTION_EMOJIS = /* @__PURE__ */ new Set([
-      "\u{1F44D}",
-      "\u{1F44E}",
-      "\u2764",
-      "\u{1F525}",
-      "\u{1F970}",
-      "\u{1F44F}",
-      "\u{1F601}",
-      "\u{1F914}",
-      "\u{1F92F}",
-      "\u{1F631}",
-      "\u{1F92C}",
-      "\u{1F622}",
-      "\u{1F389}",
-      "\u{1F929}",
-      "\u{1F92E}",
-      "\u{1F4A9}",
-      "\u{1F64F}",
-      "\u{1F44C}",
-      "\u{1F54A}\uFE0F",
-      "\u{1F921}",
-      "\u{1F971}",
-      "\u{1F974}",
-      "\u{1F60D}",
-      "\u{1F433}",
-      "\u{1F31A}",
-      "\u{1F32D}",
-      "\u{1F4AF}",
-      "\u{1F923}",
-      "\u26A1",
-      "\u{1F34C}",
-      "\u{1F3C6}",
-      "\u{1F494}",
-      "\u{1F928}",
-      "\u{1F610}",
-      "\u{1F353}",
-      "\u{1F37E}",
-      "\u{1F48B}",
-      "\u{1F595}",
-      "\u{1F608}",
-      "\u{1F634}",
-      "\u{1F62D}",
-      "\u{1F913}",
-      "\u{1F47B}",
-      "\u{1F468}\u200D\u{1F4BB}",
-      "\u{1F440}",
-      "\u{1F383}",
-      "\u{1F648}",
-      "\u{1F607}",
-      "\u{1F628}",
-      "\u{1F91D}",
-      "\u{1F917}",
-      "\u{1FAE1}",
-      "\u{1F385}",
-      "\u{1F384}",
-      "\u2603\uFE0F",
-      "\u{1F485}",
-      "\u{1F92A}",
-      "\u{1F5FF}",
-      "\u{1F192}",
-      "\u{1F498}",
-      "\u{1F649}",
-      "\u{1F984}",
-      "\u{1F618}",
-      "\u{1F48A}",
-      "\u{1F64A}",
-      "\u{1F60E}",
-      "\u{1F47E}",
-      "\u{1F937}",
-      "\u{1F621}"
-    ]);
     BLOCKED_PATH_PATTERNS = [
       /\/\.ssh\//,
       /\/\.gnupg\//,
@@ -18096,13 +18015,11 @@ var init_image_gen = __esm({
 // src/router/response.ts
 var response_exports = {};
 __export(response_exports, {
-  ensureReaction: () => ensureReaction,
   handleResponseExhaustion: () => handleResponseExhaustion,
   makeToolActionCallback: () => makeToolActionCallback,
   pendingFallbackMessages: () => pendingFallbackMessages,
   processFileSends: () => processFileSends2,
   processImageGenerations: () => processImageGenerations,
-  processReaction: () => processReaction,
   sendResponse: () => sendResponse
 });
 import { readFile as readFile3 } from "fs/promises";
@@ -18168,25 +18085,8 @@ async function processImageGenerations(chatId, channel, text) {
   }
   return text.replace(pattern, "").trim();
 }
-async function processReaction(chatId, channel, text, messageId) {
-  const reactPatternGlobal = /\[\s*REACT:\s*(.+?)\s*\]/g;
-  if (!reactPatternGlobal.test(text)) return text;
-  let reacted = false;
-  reactPatternGlobal.lastIndex = 0;
-  let match;
-  while ((match = reactPatternGlobal.exec(text)) !== null) {
-    const emoji = match[1].trim();
-    if (!reacted && messageId && typeof channel.reactToMessage === "function" && ALLOWED_REACTION_EMOJIS.has(emoji)) {
-      channel.reactToMessage(chatId, messageId, emoji).catch((err) => {
-        log(`[reaction] Failed for chat=${chatId}: ${err}`);
-      });
-      reacted = true;
-    }
-  }
-  return text.replace(/\[\s*REACT:\s*(.+?)\s*\]/g, "").trim();
-}
 async function sendResponse(chatId, channel, text, messageId, replyToMessageId) {
-  text = await processReaction(chatId, channel, text, messageId);
+  text = text.replace(/\[\s*REACT:\s*(.+?)\s*\]/g, "").trim();
   const { cleanText: afterUpdates, updates } = extractUserUpdates(text);
   for (const { key, value } of updates) {
     if (typeof channel.sendKeyboard === "function") {
@@ -18623,8 +18523,7 @@ async function handleVoice(msg, channel) {
     if (vLiveStatus) await vLiveStatus.finalize(Date.now() - sigT0);
     if (response.usage) addUsage(chatId, response.usage.input, response.usage.output, response.usage.cacheRead, vModel, void 0, response.usage.contextSize);
     if (await handleResponseExhaustion(response.text, chatId, msg, channel)) return;
-    const voiceResponse = ensureReaction(response.text, transcript);
-    await sendResponse(chatId, channel, voiceResponse, msg.messageId);
+    await sendResponse(chatId, channel, response.text, msg.messageId);
   } catch (err) {
     error("[router] Voice error:", err);
     await channel.sendText(chatId, `Voice processing error: ${errorMessage(err)}`, { parseMode: "plain" });
@@ -18638,7 +18537,8 @@ async function handleMedia(msg, channel) {
     await channel.sendText(chatId, mLimitMsg, { parseMode: "plain" });
     return;
   }
-  await channel.sendText(chatId, "Processing your file...", { parseMode: "plain" });
+  const fileCount = 1 + (msg.extraFiles?.length ?? 0);
+  await channel.sendText(chatId, fileCount > 1 ? `Processing ${fileCount} files...` : "Processing your file...", { parseMode: "plain" });
   try {
     if (msg.type === "video") {
       const fileId = msg.metadata?.fileId ?? fileName;
@@ -18706,8 +18606,7 @@ Acknowledge receipt. Do NOT analyze the video unless they ask you to.`;
       if (vidLiveStatus) await vidLiveStatus.finalize(Date.now() - vidT0);
       if (response2.usage) addUsage(chatId, response2.usage.input, response2.usage.output, response2.usage.cacheRead, vidModel, void 0, response2.usage.contextSize);
       if (await handleResponseExhaustion(response2.text, chatId, msg, channel)) return;
-      const vidResponse = ensureReaction(response2.text, caption || "video");
-      await sendResponse(chatId, channel, vidResponse, msg.messageId);
+      await sendResponse(chatId, channel, response2.text, msg.messageId);
       return;
     }
     if (!fileName) {
@@ -18722,13 +18621,39 @@ Acknowledge receipt. Do NOT analyze the video unless they ask you to.`;
     if (msg.type === "photo" || isImageExt(ext)) {
       const imgExt = msg.type === "photo" ? "jpg" : ext || "jpg";
       tempFilePath = await saveMedia(fileBuffer, "img", imgExt);
-      prompt = caption ? `The user sent an image with caption: "${caption}"
+      const allPaths = [tempFilePath];
+      if (msg.extraFiles?.length) {
+        for (const extra of msg.extraFiles) {
+          try {
+            const extraBuffer = await channel.downloadFile(extra.fileName);
+            const extraExt = extra.mimeType.startsWith("image/") ? extra.mimeType.split("/")[1] || "jpg" : "jpg";
+            const extraPath = await saveMedia(extraBuffer, "img", extraExt);
+            allPaths.push(extraPath);
+          } catch (err) {
+            log(`[media] Failed to download extra file: ${errorMessage(err)}`);
+          }
+        }
+      }
+      if (allPaths.length === 1) {
+        prompt = caption ? `The user sent an image with caption: "${caption}"
 
 The image has been saved to: ${tempFilePath}
 
 Please read the image file and respond to their caption/question.` : `The user sent an image. It has been saved to: ${tempFilePath}
 
 Please read the image file and describe what you see.`;
+      } else {
+        const pathList = allPaths.map((p, i) => `${i + 1}. ${p}`).join("\n");
+        prompt = caption ? `The user sent ${allPaths.length} images with caption: "${caption}"
+
+The images have been saved to:
+${pathList}
+
+Please read all image files and respond to their caption/question.` : `The user sent ${allPaths.length} images. They have been saved to:
+${pathList}
+
+Please read all image files and describe what you see.`;
+      }
     } else if (isTextExt(ext)) {
       const MAX_TEXT_FILE_BYTES = 1048576;
       if (fileBuffer.length > MAX_TEXT_FILE_BYTES) {
@@ -18780,8 +18705,7 @@ ${content}
     if (mLiveStatus) await mLiveStatus.finalize(Date.now() - mT0);
     if (response.usage) addUsage(chatId, response.usage.input, response.usage.output, response.usage.cacheRead, mediaModel, void 0, response.usage.contextSize);
     if (await handleResponseExhaustion(response.text, chatId, msg, channel)) return;
-    const mediaResponse = ensureReaction(response.text, caption || "file");
-    await sendResponse(chatId, channel, mediaResponse, msg.messageId);
+    await sendResponse(chatId, channel, response.text, msg.messageId);
   } catch (err) {
     error("[router] Media error:", err);
     const errStr = errorMessage(err);
@@ -24524,7 +24448,9 @@ ${PERM_MODES[chosen]}`,
       return;
     }
     removePendingPlan(chatId);
-    await replaceWithText("\u2705 Approved. Executing...");
+    await replaceWithText(`\u{1F50D} ${plan.plan}
+
+\u2705 Approved. Executing...`);
     bypassBusyCheck.add(chatId);
     const { handleMessage: handleMessage2 } = await Promise.resolve().then(() => (init_router2(), router_exports));
     const overrideMsg = `[SYSTEM: Planning mode disabled. Execution APPROVED. Please execute the plan.]
@@ -24542,7 +24468,9 @@ ${plan.originalMessage}`;
     }
     removePendingPlan(chatId);
     setRejectionMode(chatId);
-    await channel.sendText(chatId, "\u270F\uFE0F Plan rejected. Send your feedback and I'll revise the plan.", { parseMode: "plain" });
+    await replaceWithText(`\u{1F50D} ${plan.plan}
+
+\u274C Rejected \u2014 send feedback to revise.`);
     return;
   } else if (data === "exec:yolo") {
     const plan = getPendingPlan(chatId);
@@ -24552,7 +24480,9 @@ ${plan.originalMessage}`;
     }
     removePendingPlan(chatId);
     setExecMode(chatId, "yolo");
-    await channel.sendText(chatId, "\u26A1 Switched to YOLO mode. Executing without approval gate...", { parseMode: "plain" });
+    await replaceWithText(`\u{1F50D} ${plan.plan}
+
+\u26A1 YOLO mode. Executing...`);
     bypassBusyCheck.add(chatId);
     const { handleMessage: handleMessage2 } = await Promise.resolve().then(() => (init_router2(), router_exports));
     const overrideMsg = `[SYSTEM: Planning mode disabled. YOLO mode enabled. Proceed immediately without asking for approval.]
@@ -26286,6 +26216,12 @@ async function handleText(msg, channel) {
     await channel.sendText(chatId, "Got it, I'll remember that.", { parseMode: "plain" });
     return;
   }
+  if (msg.messageId && typeof channel.reactToMessage === "function") {
+    const ackEmoji = pickFallbackEmoji(text);
+    channel.reactToMessage(chatId, msg.messageId, ackEmoji).catch(() => {
+    });
+  }
+  await channel.sendTyping?.(chatId);
   const model2 = resolveModel(chatId);
   let autoRouted = false;
   let effectiveModel = model2;
@@ -26704,7 +26640,6 @@ Debating: "${question.slice(0, 100)}${question.length > 100 ? "\u2026" : ""}"`,
     if (activeSideQuests.has(chatId) && responseText && !responseText.startsWith("(No response")) {
       responseText = "\u{1F4CB} <b>Main task</b>\n\n" + responseText;
     }
-    responseText = ensureReaction(responseText, cleanText || text);
     await sendResponse(chatId, channel, responseText, msg.messageId);
     try {
       const adapter2 = getAdapterForChat(chatId);
@@ -28101,6 +28036,11 @@ var init_telegram2 = __esm({
       // messageId → chatId
       reactionHandlers = [];
       throttle;
+      // ── Media group debouncing ─────────────────────────────────────────
+      // Telegram sends each photo in a media group as a separate update.
+      // We buffer them by media_group_id and emit one merged IncomingMessage.
+      mediaGroupBuffer = /* @__PURE__ */ new Map();
+      static MEDIA_GROUP_DEBOUNCE_MS = 500;
       // ── Polling health tracking ─────────────────────────────────────────
       /** Timestamp of last update received from Telegram (message, callback, reaction) */
       lastUpdateAt = 0;
@@ -28263,6 +28203,19 @@ var init_telegram2 = __esm({
             return;
           }
           log(`[telegram] Processing ${msg.type}: "${msg.text?.slice(0, 50) || msg.command || "(media)"}"`);
+          const mediaGroupId = ctx.message?.media_group_id;
+          if (mediaGroupId && (msg.type === "photo" || msg.type === "video" || msg.type === "document")) {
+            const existing = this.mediaGroupBuffer.get(mediaGroupId);
+            if (existing) {
+              existing.messages.push(msg);
+              clearTimeout(existing.timer);
+              existing.timer = setTimeout(() => this.flushMediaGroup(mediaGroupId), _TelegramChannel.MEDIA_GROUP_DEBOUNCE_MS);
+            } else {
+              const timer = setTimeout(() => this.flushMediaGroup(mediaGroupId), _TelegramChannel.MEDIA_GROUP_DEBOUNCE_MS);
+              this.mediaGroupBuffer.set(mediaGroupId, { messages: [msg], timer, handler, channel: this });
+            }
+            return;
+          }
           if (isFastPathMessage(msg)) {
             handler(msg, this).catch((err) => {
               error("[telegram] Fast-path handler error:", err);
@@ -28711,6 +28664,30 @@ var init_telegram2 = __esm({
         }
         this.agentMessageIds.set(messageId, chatId);
       }
+      /**
+       * Flush a buffered media group — merge all files into a single IncomingMessage
+       * with the first file as primary and the rest in extraFiles.
+       */
+      flushMediaGroup(groupId) {
+        const group = this.mediaGroupBuffer.get(groupId);
+        if (!group) return;
+        this.mediaGroupBuffer.delete(groupId);
+        const [primary, ...rest] = group.messages;
+        if (rest.length > 0) {
+          primary.extraFiles = rest.map((m) => ({
+            fileName: m.fileName,
+            mimeType: m.mimeType ?? "application/octet-stream"
+          }));
+          if (!primary.caption) {
+            const withCaption = rest.find((m) => m.caption);
+            if (withCaption) primary.caption = withCaption.caption;
+          }
+          log(`[telegram] Media group ${groupId}: merged ${group.messages.length} files into one message`);
+        }
+        group.handler(primary, group.channel).catch((err) => {
+          error("[telegram] Media group handler error:", err);
+        });
+      }
       buildIncomingMessage(ctx) {
         const chatId = ctx.chat.id.toString();
         const messageId = ctx.message?.message_id?.toString() ?? "";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-claw",
-  "version": "0.20.18",
+  "version": "0.20.20",
   "description": "CC-Claw: Personal AI assistant on Telegram — multi-backend (Claude, Gemini, Codex, Cursor), sub-agent orchestration, MCP management",
   "type": "module",
   "main": "dist/cli.js",