chatccc 0.2.151 → 0.2.153

package/im-skills/feishu-skill/receive-send-file.md

@@ -1,67 +1,64 @@
-# Sending & Downloading Files/Videos
-
-## Send Files or Videos
-
-Videos are sent as regular files (not media), which looks cleaner in Feishu.
-
-### Script (recommended)
-```bash
-node "{{send_file_script}}" --url "{{send_file_url}}" --session-id "{{session_id}}" --path "<absolute file path>" --caption "<optional caption>"
-```
-
-### Direct HTTP
-```http
-POST {{send_file_url}}
-Content-Type: application/json; charset=utf-8
-
-{"session_id":"{{session_id}}","path":"<absolute file path>","caption":"<optional caption>"}
-```
-
-### Rules
-
-- Save or choose a local file first.
-- Use an absolute local path.
-- Max file size: 30MB.
-- Supported formats: .mp4 .mov .avi .mkv .webm .flv .mp3 .wav .ogg .aac .m4a .pdf .doc .docx .xls .xlsx .csv .ppt .pptx .txt .zip .tar .gz.
-- Only send a file/video when the user asked for one or when it materially helps the answer.
-
-### Video Compression (when file > 30MB)
-
-If the video exceeds 30MB, compress it with ffmpeg before sending.
-
-**Ensure ffmpeg is available** (install if missing):
-
-| OS | Install command |
-|----|----------------|
-| macOS | `brew install ffmpeg` |
-| Linux (Debian/Ubuntu) | `sudo apt install ffmpeg` |
-| Linux (RHEL/Fedora) | `sudo dnf install ffmpeg` |
-| Windows | `winget install Gyan.FFmpeg` |
-
-**Two-pass compression** (target ~28MB for 30s video, adjust `b:v` for other durations):
-
-```bash
-ffmpeg -y -i "<input>" -c:v libx264 -b:v <bitrate>k -pass 1 -f mp4 NUL
-ffmpeg -y -i "<input>" -c:v libx264 -b:v <bitrate>k -pass 2 -c:a aac -b:a 128k "<output>"
-```
-
-Bitrate formula: `bitrate = 28 × 8 × 1000 ÷ duration_seconds - 128` (target ~28MB, safe under 30MB).
-On Windows replace `NUL` with `NUL` (same); on Linux/macOS use `/dev/null`.
-
-If the compressed file still exceeds 30MB, explain to the user that automatic compression wasn't enough and suggest they manually trim or re-encode the source.
-
-## Download Files or Videos
-
-When the user sends a file or video to the bot, the message contains `message_id` and `file_key`. Download it with:
-
-```bash
-node "{{download_video_script}}" --message-id <message_id> --file-key <file_key> --name <file_name>
-```
-
-If only `chat_id` and `file_key` are available:
-
-```bash
-node "{{download_video_script}}" --chat-id <chat_id> --file-key <file_key> --name <file_name>
-```
-
+# Sending & Downloading Files/Videos
+
+## Send Files or Videos
+
+Videos are sent as regular files (not media), which looks cleaner in Feishu.
+
+**Use the node script below. Do NOT use curl or raw HTTP — the script correctly handles errors and exits non-zero on failure.**
+
+### Script
+
+```bash
+node "{{send_file_script}}" --url "{{send_file_url}}" --session-id "{{session_id}}" --path "<absolute file path>" --caption "<optional caption>"
+```
+
+### Rules
+
+- Use the node script above — never curl or raw HTTP.
+- Save or choose a local file first.
+- Use an absolute local path.
+- Max file size: 30MB.
+- Supported formats: .mp4 .mov .avi .mkv .webm .flv .mp3 .wav .ogg .aac .m4a .pdf .doc .docx .xls .xlsx .csv .ppt .pptx .txt .zip .tar .gz.
+- Only send a file/video when the user asked for one or when it materially helps the answer.
+- **If the script fails (non-zero exit), read stderr for the error. Do NOT retry with the same path. Either fix the problem (wrong extension, missing file, etc.) or tell the user what the error was. Never retry more than once.**
+
+### Video Compression (when file > 30MB)
+
+If the video exceeds 30MB, compress it with ffmpeg before sending.
+
+**Ensure ffmpeg is available** (install if missing):
+
+| OS | Install command |
+|----|----------------|
+| macOS | `brew install ffmpeg` |
+| Linux (Debian/Ubuntu) | `sudo apt install ffmpeg` |
+| Linux (RHEL/Fedora) | `sudo dnf install ffmpeg` |
+| Windows | `winget install Gyan.FFmpeg` |
+
+**Two-pass compression** (target ~28MB for 30s video, adjust `b:v` for other durations):
+
+```bash
+ffmpeg -y -i "<input>" -c:v libx264 -b:v <bitrate>k -pass 1 -f mp4 NUL
+ffmpeg -y -i "<input>" -c:v libx264 -b:v <bitrate>k -pass 2 -c:a aac -b:a 128k "<output>"
+```
+
+Bitrate formula: `bitrate = 28 × 8 × 1000 ÷ duration_seconds - 128` (target ~28MB, safe under 30MB).
+On Windows replace `NUL` with `NUL` (same); on Linux/macOS use `/dev/null`.
+
+If the compressed file still exceeds 30MB, explain to the user that automatic compression wasn't enough and suggest they manually trim or re-encode the source.
+
+## Download Files or Videos
+
+When the user sends a file or video to the bot, the message contains `message_id` and `file_key`. Download it with:
+
+```bash
+node "{{download_video_script}}" --message-id <message_id> --file-key <file_key> --name <file_name>
+```
+
+If only `chat_id` and `file_key` are available:
+
+```bash
+node "{{download_video_script}}" --chat-id <chat_id> --file-key <file_key> --name <file_name>
+```
+
 Downloads are saved under `~/.chatccc/videos/downloads/`.

package/im-skills/feishu-skill/receive-send-image.md

@@ -1,28 +1,25 @@
-# Sending & Receiving Images
-
-## Send Images
-
-### Script (recommended)
-```bash
-node "{{send_image_script}}" --url "{{send_image_url}}" --session-id "{{session_id}}" --path "<absolute image path>" --caption "<optional caption>"
-```
-
-### Direct HTTP
-```http
-POST {{send_image_url}}
-Content-Type: application/json; charset=utf-8
-
-{"session_id":"{{session_id}}","path":"<absolute image path>","caption":"<optional caption>"}
-```
-
-### Rules
-
-- Save or choose a local image file first.
-- Use an absolute local path.
-- Supported formats: .png, .jpg, .jpeg, .webp, .gif, .bmp.
-- Max image size: 10MB.
-- Only send an image when the user asked for one or when it materially helps the answer.
-
-## Receive Images
-
+# Sending & Receiving Images
+
+## Send Images
+
+**Use the node script below. Do NOT use curl or raw HTTP — the script correctly handles errors and exits non-zero on failure.**
+
+### Script
+
+```bash
+node "{{send_image_script}}" --url "{{send_image_url}}" --session-id "{{session_id}}" --path "<absolute image path>" --caption "<optional caption>"
+```
+
+### Rules
+
+- Use the node script above — never curl or raw HTTP.
+- Save or choose a local image file first.
+- Use an absolute local path.
+- Supported formats: .png, .jpg, .jpeg, .webp, .gif, .bmp.
+- Max image size: 10MB.
+- Only send an image when the user asked for one or when it materially helps the answer.
+- **If the script fails (non-zero exit), read stderr for the error. Do NOT retry with the same path. Either fix the problem (wrong extension, missing file, etc.) or tell the user what the error was. Never retry more than once.**
+
+## Receive Images
+
 Images sent to the bot are automatically downloaded to `~/.chatccc/images/downloads/`. The message contains an `image_key` that maps to the cached file.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chatccc",
-  "version": "0.2.151",
+  "version": "0.2.153",
   "description": "Feishu bot bridge for Claude Code",
   "license": "Apache-2.0",
   "type": "module",

package/src/adapters/adapter-interface.ts

@@ -128,6 +128,10 @@ export interface ToolPromptOptions {
   onProcessStart?: (info: ToolProcessInfo) => void;
   /** Called when the adapter leaves the prompt process scope normally or by abort. */
   onProcessExit?: (info: ToolProcessInfo) => void;
+  /** Called when the adapter creates an SDK session internally.
+   *  The callback receives a close function that terminates the underlying
+   *  subprocess. Used by stop-stuck-loop to kill the CLI process immediately. */
+  onSessionCreated?: (closeSession: () => void) => void;
 }
 
 // ---------------------------------------------------------------------------

package/src/adapters/claude-adapter.ts

@@ -490,6 +490,8 @@ class ClaudeAdapter implements ToolAdapter {
       })),
     );
 
+    options?.onSessionCreated?.(() => session.close());
+
     try {
       await session.send(buildClaudePromptText(userText, undefined, sessionId));
       for await (const raw of session.stream()) {

package/src/agent-stop-stuck.ts

@@ -116,6 +116,8 @@ export async function handleAgentStopStuckRequest(
     }
   })();
 
+  // 先关闭底层 SDK session，终止 CLI 子进程，然后再 abort 清理 adapter 层
+  prompt.closeSession?.();
   // 不设 stopped 标记 → finally block 写 "done" → 卡片正常结束
   prompt.controller.abort();
 

package/src/session-chat-binding.ts

@@ -73,6 +73,10 @@ export interface ActivePrompt {
   abnormalExitNotified?: boolean;
   /** Set when the resource monitor detects CPU + memory unchanged for 3 minutes. */
   resourceStuck?: boolean;
+  /** Adapter-provided callback to close the underlying SDK session / subprocess.
+   *  Called by stop-stuck-loop before controller.abort() to terminate the CLI
+   *  process immediately, rather than waiting for the async generator to unblock. */
+  closeSession?: () => void;
 }
 
 export const activePrompts = new Map<string, ActivePrompt>();

package/src/session.ts

@@ -1110,6 +1110,10 @@ export async function runAgentSession(
         clearPromptProcessMonitor(sessionId);
         if (exitInfo.pid !== undefined) unregisterProcess(exitInfo.pid);
       },
+      onSessionCreated: (closeSession) => {
+        const prompt = activePrompts.get(sessionId);
+        if (prompt) prompt.closeSession = closeSession;
+      },
     })) {
       for (const block of unifiedMsg.blocks) {
         accumulateBlockContent(block, state, toolCallMap);