pikiclaw 0.2.35 → 0.2.37

package/README.md

@@ -40,6 +40,19 @@ pikiclaw 的思路不同：**只挑最好的，然后把它们组合到极致。
        └──────── 流式进度 / 文件 / 截图 ←──────────┘
 ```
 
+pikiclaw 不是另一个终端包装器，也不是另一个云端 IDE。
+
+它更像一个让官方 coding agent 变得**可远程调度、可持续运行、可回传结果**的本地执行中枢。
+
+当你需要：
+
+- 在手机上发一句话就能派活
+- 任务必须跑在你自己的电脑、现有代码库和本地工具链里
+- 想在 Claude Code / Codex CLI / Gemini CLI 之间自由切换
+- 希望进度、截图、文件自动回到聊天
+
+pikiclaw 会比“守在终端里”“SSH + tmux”或“单厂商云端 agent”更顺。
+
 ---
 
 ## Quick Start
@@ -48,7 +61,7 @@ pikiclaw 的思路不同：**只挑最好的，然后把它们组合到极致。
 
 - Node.js 18+
 - 本机已安装 [`claude`](https://docs.anthropic.com/en/docs/claude-code)、[`codex`](https://github.com/openai/codex) 或 [`gemini`](https://github.com/google-gemini/gemini-cli) 中的任意一个
-- 一个 [Telegram Bot Token](https://t.me/BotFather) 或[飞书应用](https://open.feishu.cn)凭证
+- 一个 [Telegram Bot Token](https://t.me/BotFather) 或 [飞书应用](https://open.feishu.cn) 凭证
 
 ### 一行启动
 
@@ -87,10 +100,10 @@ npx pikiclaw@latest --setup
 
 ### IM Channels
 
-| 渠道 | 消息编辑 | 文件上传 | 回调按钮 | 表情回应 | 消息线程 |
-|------|---------|---------|---------|---------|---------|
-| **Telegram** | ✅ | ✅ | ✅ | — | — |
-| **飞书** | ✅ | ✅ | ✅ | ✅ | ✅ |
+| 渠道 | 消息编辑 | 文件收发 | 回调按钮 | 命令菜单 | 场景 |
+|------|---------|---------|---------|---------|------|
+| **Telegram** | ✅ | ✅ | ✅ | ✅ | 全球 / 个人 |
+| **飞书** | ✅ | ✅ | ✅ | ✅ | 国内 / 团队 |
 
 两个渠道可以**同时启动**。
 
@@ -99,16 +112,15 @@ npx pikiclaw@latest --setup
 | 能力 | 说明 |
 |------|------|
 | 实时流式输出 | Agent 工作时消息持续更新 |
-| Thinking / Reasoning | 实时查看 Agent 的思考和推理过程 |
+| Thinking / Reasoning / Plan | 实时查看 Agent 的思考、推理和计划步骤 |
 | Token 追踪 | 输入/输出/缓存统计，上下文使用率实时显示 |
-| 产物回传 | 截图、日志、生成文件自动发回 |
-| 长程防休眠 | 系统级防休眠，小时级任务不中断 |
-| 守护进程 | 崩溃自动重启，指数退避（3s → 60s） |
+| 产物回传 | 截图、日志、生成文件自动发回聊天 |
+| 长程任务保障 | 系统级防休眠 + 守护进程 + 异常自愈 |
 | 长文本处理 | 超长输出自动拆分或打包为 `.md` |
 | 多会话管理 | 随时切换、恢复历史会话 |
 | 图片/文件输入 | 截图、PDF、文档直接发给 Agent |
 | 项目 Skills | `.pikiclaw/skills/` 自定义技能，兼容 `.claude/commands/` |
-| 安全模式 | 危险操作推送确认卡片，白名单访问控制 |
+| 安全模式 | 白名单访问控制，支持切换更安全的 agent 权限模式 |
 | Web Dashboard | 可视化配置、会话浏览、主机监控 |
 
 ---
@@ -134,24 +146,23 @@ npx pikiclaw@latest --setup
 
 | | 终端直接跑 | SSH + tmux | 云端 Agent | **pikiclaw** |
 |---|---|---|---|---|
-| 执行环境 | ✅ 本地 | ✅ 本地 | ❌ 沙盒 | ✅ 本地 |
+| 执行环境 | ✅ 本地 | ✅ 本地 | ⚠️ 通常是远端或沙盒 | ✅ 本地 |
 | 走开后还能跑 | ❌ 合盖就断 | ⚠️ 要配 tmux | ✅ | ✅ 防休眠 + 守护进程 |
 | 手机可控 | ❌ | ⚠️ 打字痛苦 | ✅ | ✅ IM 原生 |
-| 实时看进度 | ✅ 终端 | ⚠️ 得连上去看 | ❌ 多数是黑盒 | ✅ 流式推到聊天 |
+| 实时看进度 | ✅ 终端 | ⚠️ 得连上去看 | ⚠️ 依平台而定 | ✅ 流式推到聊天 |
 | 结果自动回传 | ❌ | ❌ | ⚠️ 看平台 | ✅ 截图/文件/长文本 |
-| 配置门槛 | 无 | SSH/穿透/tmux | 注册/付费 | `npx` 一行 |
+| 配置门槛 | 无 | SSH/穿透/tmux | 注册并适应平台工作流 | `npx` 一行 |
 
-### pikiclaw vs. 同类项目
+### pikiclaw vs. OpenClaw / 官方入口
 
-| | **pikiclaw** | OpenClaw | cc-connect |
+| 维度 | **pikiclaw** | OpenClaw | 官方入口（Claude / Codex / Gemini） |
 |---|---|---|---|
-| **理念** | **精选最好的工具，组合到极致** | 开源自主 AI 智能体生态 | 多渠道多端连接器 |
-| **Agent** | Claude Code / Codex / Gemini CLI（官方出品） | 内置 Agent（自接模型） | 多种本地 CLI |
-| **IM** | Telegram + 飞书（深度打磨） | Web / 移动端 | Slack / Discord / LINE 等 |
-| **长程任务** | ✅ 防休眠 · 守护进程 · 异常自愈 | ❌ 偏即时任务 | ❌ 偏短对话 |
-| **产物回传** | ✅ 截图 · 文件 · 长文本打包 | ⚠️ 依赖客户端 | ⚠️ 基础附件 |
-| **流式体验** | ✅ IM 内实时流式 | ✅ | ⚠️ 看桥接能力 |
-| **上手成本** | **一行 `npx`** | 需部署后端 | 需安装服务端 |
+| 产品层 | IM 驱动的本地 agent 控制平面 | 通用个人 AI 助手 / 多渠道生态 | 单一厂商的原生 agent 入口 |
+| Agent 策略 | 复用官方 CLI，吃到各家最新能力 | 自带 runtime / agent stack | 只服务自家模型 |
+| 执行环境 | 你的电脑 | 个人设备网络 / 本地节点 | 本地 CLI 或厂商云 |
+| 渠道策略 | Telegram + 飞书深度打磨 | 广覆盖 | Web / App / Slack / CLI 为主 |
+| 锁定程度 | 低，可随时切换引擎 | 中 | 高 |
+| 最强场景 | 远程 coding、长任务、本地自动化 | 全能个人助手 | 原生模型体验、企业集成 |
 
 ---
 
@@ -159,6 +170,8 @@ npx pikiclaw@latest --setup
 
 pikiclaw 不限于编程。你的 Agent 能做什么，pikiclaw 就能远程调度什么。
 
+它尤其适合那些**必须在你自己的环境里执行**、同时又希望**进度和结果直接回到 IM** 的任务。
+
 **工程重构** — "把整个项目从 JS 迁移到 TS，跑测试直到全部通过。搞定告诉我。"
 
 **文档处理** — "把 docs/ 下所有零散文档整理汇总，提取核心指标，输出一份报告。"
@@ -298,7 +311,7 @@ npx pikiclaw@latest --doctor              # 检查环境
 ## Development
 
 ```bash
-git clone https://github.com/nicepkg/pikiclaw.git
+git clone https://github.com/xiaotonng/pikiclaw.git
 cd pikiclaw
 npm install
 echo "TELEGRAM_BOT_TOKEN=your_token" > .env

package/dist/bot-feishu-render.js

@@ -176,7 +176,7 @@ export function buildStreamPreviewMarkdown(input) {
     const thinkDisplay = formatThinkingForDisplay(input.thinking, maxBody);
     const planDisplay = renderPlanForPreview(input.plan ?? null);
     const activityDisplay = summarizeActivityForPreview(input.activity);
-    const maxActivity = !display && !thinkDisplay && !planDisplay ? 1800 : 900;
+    const maxActivity = !display && !thinkDisplay && !planDisplay ? 2400 : 1400;
     const parts = [];
     const label = thinkLabel(input.agent);
     if (planDisplay) {
@@ -189,8 +189,10 @@ export function buildStreamPreviewMarkdown(input) {
         parts.push(`**${label}**\n${thinkDisplay}`);
     }
     else if (display) {
-        if (rawThinking)
-            parts.push(`*${label} (${rawThinking.length} chars)*`);
+        if (rawThinking) {
+            const thinkSnippet = formatThinkingForDisplay(input.thinking, 600);
+            parts.push(`**${label}**\n${thinkSnippet}`);
+        }
         const preview = display.length > maxBody ? '(...truncated)\n' + display.slice(-maxBody) : display;
         parts.push(preview);
     }
@@ -211,8 +213,8 @@ export function buildFinalReplyRender(agent, result) {
         const narrative = summary.narrative.join('\n');
         if (narrative) {
             let display = narrative;
-            if (display.length > 800)
-                display = '...\n' + display.slice(-800);
+            if (display.length > 1600)
+                display = '...\n' + display.slice(-1600);
             activityText = `**Activity**\n${display}\n\n`;
         }
         const commandSummary = formatActivityCommandSummary(summary.completedCommands, summary.activeCommands, summary.failedCommands);
@@ -221,7 +223,7 @@ export function buildFinalReplyRender(agent, result) {
     }
     let thinkingText = '';
     if (result.thinking) {
-        thinkingText = `**${thinkLabel(agent)}**\n${formatThinkingForDisplay(result.thinking, 800)}\n\n`;
+        thinkingText = `**${thinkLabel(agent)}**\n${formatThinkingForDisplay(result.thinking, 1600)}\n\n`;
     }
     let statusText = '';
     if (result.incomplete) {

package/dist/bot-feishu.js

@@ -437,14 +437,19 @@ export class FeishuBot extends Bot {
                     livePreview?.update(nextText, nextThinking, nextActivity, meta, plan);
                 }, undefined, mcpSendFile);
                 await livePreview?.settle();
-                // End streaming mode — finalize the card before sending final reply
-                if (placeholderId) {
-                    const summary = result.message.slice(0, 80).replace(/\s+/g, ' ').trim() || 'Response complete.';
-                    await this.channel.endStreaming(placeholderId, summary);
-                }
                 this.log(`[handleMessage] done agent=${session.agent} ok=${result.ok} elapsed=${result.elapsedS.toFixed(1)}s ` +
                     `tokens=in:${fmtTokens(result.inputTokens)}/out:${fmtTokens(result.outputTokens)}`);
-                const finalReplyIds = await this.sendFinalReply(ctx, placeholderId, session.agent, result);
+                // For streaming cards: push final content via CardKit before ending stream,
+                // then send any overflow chunks as new messages.
+                // Regular cards: edit placeholder with final content as before.
+                const wasStreaming = placeholderId && this.channel.isStreamingCard(placeholderId);
+                let finalReplyIds;
+                if (wasStreaming) {
+                    finalReplyIds = await this.finalizeStreamingCard(ctx, placeholderId, session.agent, result);
+                }
+                else {
+                    finalReplyIds = await this.sendFinalReply(ctx, placeholderId, session.agent, result);
+                }
                 this.registerSessionMessages(ctx.chatId, finalReplyIds, session);
                 this.log(`[handleMessage] final reply sent to chat=${ctx.chatId}`);
             }
@@ -455,6 +460,10 @@ export class FeishuBot extends Bot {
                 if (placeholderId) {
                     try {
                         await this.channel.editMessage(ctx.chatId, placeholderId, errorText);
+                        // End streaming if this was a streaming card
+                        if (this.channel.isStreamingCard(placeholderId)) {
+                            await this.channel.endStreaming(placeholderId, 'Error');
+                        }
                     }
                     catch {
                         await this.channel.send(ctx.chatId, errorText).catch(() => null);
@@ -474,6 +483,51 @@ export class FeishuBot extends Bot {
             this.finishTask(taskId);
         });
     }
+    /**
+     * Finalize a streaming card: push final content via CardKit, end streaming,
+     * then send any overflow chunks as new messages.
+     * This avoids the "schemaV2 card can not change schemaV1" error that occurs
+     * when trying to PATCH a CardKit v2 card with a v1 interactive card.
+     */
+    async finalizeStreamingCard(ctx, placeholderId, agent, result) {
+        const rendered = buildFinalReplyRender(agent, result);
+        const messageIds = [placeholderId];
+        const MAX_CARD = 25_000;
+        let firstText;
+        let remaining = '';
+        if (rendered.fullText.length <= MAX_CARD) {
+            firstText = rendered.fullText;
+        }
+        else {
+            const maxFirst = MAX_CARD - rendered.headerText.length - rendered.footerText.length;
+            if (maxFirst > 200) {
+                let cut = rendered.bodyText.lastIndexOf('\n', maxFirst);
+                if (cut < maxFirst * 0.3)
+                    cut = maxFirst;
+                firstText = `${rendered.headerText}${rendered.bodyText.slice(0, cut)}${rendered.footerText}`;
+                remaining = rendered.bodyText.slice(cut);
+            }
+            else {
+                firstText = `${rendered.headerText}${rendered.footerText}`;
+                remaining = rendered.bodyText;
+            }
+        }
+        // Push final content while card is still in streaming mode (CardKit v2 API)
+        await this.channel.editMessage(ctx.chatId, placeholderId, firstText);
+        // Finalize the streaming card
+        const summary = result.message.slice(0, 80).replace(/\s+/g, ' ').trim() || 'Response complete.';
+        await this.channel.endStreaming(placeholderId, summary);
+        // Send overflow chunks as new messages
+        if (remaining.trim()) {
+            const chunks = splitText(remaining, MAX_CARD);
+            for (const chunk of chunks) {
+                const sent = await this.channel.send(ctx.chatId, chunk);
+                if (sent)
+                    messageIds.push(sent);
+            }
+        }
+        return messageIds;
+    }
     async sendFinalReply(ctx, placeholderId, agent, result) {
         const rendered = buildFinalReplyRender(agent, result);
         const messageIds = [];
@@ -542,6 +596,7 @@ export class FeishuBot extends Bot {
             try {
                 await this.channel.sendFile(ctx.chatId, filePath, {
                     caption: opts?.caption,
+                    replyTo: ctx.messageId,
                     asPhoto: opts?.kind === 'photo',
                 });
                 return { ok: true };

package/dist/bot-telegram-render.js

@@ -298,7 +298,7 @@ export function buildStreamPreviewHtml(input) {
     const thinkDisplay = formatThinkingForDisplay(input.thinking, maxBody);
     const planDisplay = renderPlanForPreview(input.plan ?? null);
     const activityDisplay = summarizeActivityForPreview(input.activity);
-    const maxActivity = !display && !thinkDisplay && !planDisplay ? 1800 : 900;
+    const maxActivity = !display && !thinkDisplay && !planDisplay ? 2400 : 1400;
     const parts = [];
     const label = thinkLabel(input.agent);
     if (planDisplay) {
@@ -311,8 +311,10 @@ export function buildStreamPreviewHtml(input) {
         parts.push(`<blockquote><b>${escapeHtml(label)}</b>\n${escapeHtml(thinkDisplay)}</blockquote>`);
     }
     else if (display) {
-        if (rawThinking)
-            parts.push(`<i>${escapeHtml(`${label} (${rawThinking.length} chars)`)}</i>`);
+        if (rawThinking) {
+            const thinkSnippet = formatThinkingForDisplay(input.thinking, 600);
+            parts.push(`<blockquote><b>${escapeHtml(label)}</b>\n${escapeHtml(thinkSnippet)}</blockquote>`);
+        }
         const preview = display.length > maxBody ? '(...truncated)\n' + display.slice(-maxBody) : display;
         parts.push(mdToTgHtml(preview));
     }
@@ -329,8 +331,8 @@ export function buildFinalReplyRender(agent, result) {
         const narrative = summary.narrative.join('\n');
         if (narrative) {
             let display = narrative;
-            if (display.length > 800)
-                display = '...\n' + display.slice(-800);
+            if (display.length > 1600)
+                display = '...\n' + display.slice(-1600);
             activityHtml = `<blockquote><b>Activity</b>\n${escapeHtml(display)}</blockquote>\n\n`;
         }
         const commandSummary = formatActivityCommandSummary(summary.completedCommands, summary.activeCommands, summary.failedCommands);
@@ -339,7 +341,7 @@ export function buildFinalReplyRender(agent, result) {
     }
     let thinkingHtml = '';
     if (result.thinking) {
-        thinkingHtml = `<blockquote><b>${thinkLabel(agent)}</b>\n${escapeHtml(formatThinkingForDisplay(result.thinking, 800))}</blockquote>\n\n`;
+        thinkingHtml = `<blockquote><b>${thinkLabel(agent)}</b>\n${escapeHtml(formatThinkingForDisplay(result.thinking, 1600))}</blockquote>\n\n`;
     }
     let statusHtml = '';
     if (result.incomplete) {

package/dist/bot.js

@@ -8,20 +8,20 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { execSync, spawn } from 'node:child_process';
 import { getActiveUserConfig, onUserConfigChange, resolveUserWorkdir, setUserWorkdir } from './user-config.js';
-import { doStream, getSessions, getSessionTail, getUsage, initializeProjectSkills, listAgents, listModels, listSkills, } from './code-agent.js';
+import { doStream, getSessions, getSessionTail, getUsage, initializeProjectSkills, listAgents, listModels, listSkills, isPendingSessionId, } from './code-agent.js';
 import { getDriver, hasDriver, allDriverIds } from './agent-driver.js';
 import { terminateProcessTree } from './process-control.js';
-export const VERSION = '0.2.35';
+export const VERSION = '0.2.37';
 const MACOS_USER_ACTIVITY_PULSE_INTERVAL_MS = 20_000;
 const MACOS_USER_ACTIVITY_PULSE_TIMEOUT_S = 30;
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
 /**
- * If `dir` has a .gitignore, ensure runtime state is ignored while `.pikiclaw/skills`
- * stays trackable as the canonical project skill location.
+ * If `dir` has a .gitignore, ignore managed `.pikiclaw` state without hiding
+ * `.pikiclaw/skills`, which may be committed as project skills.
  */
-function ensureGitignore(dir) {
+export function ensureGitignore(dir) {
     try {
         const gi = path.join(dir, '.gitignore');
         if (!fs.existsSync(gi))
@@ -30,10 +30,12 @@ function ensureGitignore(dir) {
             '.pikiclaw/*',
             '!.pikiclaw/skills/',
             '!.pikiclaw/skills/**',
+        ];
+        const legacyLines = new Set([
+            '.pikiclaw/',
             '.claude/skills/',
             '.agents/skills/',
-        ];
-        const legacyLines = new Set(['.pikiclaw/']);
+        ]);
         const rawLines = fs.readFileSync(gi, 'utf8').split(/\r?\n/);
         const normalized = rawLines.filter(line => {
             const trimmed = line.trim();
@@ -171,25 +173,19 @@ export function thinkLabel(agent) {
         return 'Thinking';
     }
 }
-export function extractThinkingTail(text, maxLines = 3) {
+export function extractThinkingTail(text, maxLines = 10) {
     const normalized = text.replace(/\r\n?/g, '\n').trim();
     if (!normalized)
         return '';
-    const blocks = normalized
-        .split(/\n\s*\n+/)
-        .map(block => block.trim())
-        .filter(Boolean);
-    if (blocks.length > 1)
-        return blocks[blocks.length - 1];
     const lines = normalized
         .split('\n')
         .map(line => line.trimEnd())
         .filter(line => line.trim());
-    if (lines.length > 1)
-        return lines.slice(-Math.min(maxLines, lines.length)).join('\n').trim();
+    if (lines.length > maxLines)
+        return lines.slice(-maxLines).join('\n').trim();
     return normalized;
 }
-export function formatThinkingForDisplay(text, maxChars = 800) {
+export function formatThinkingForDisplay(text, maxChars = 1600) {
     let display = extractThinkingTail(text);
     if (display.length > maxChars)
         display = '...\n' + display.slice(-maxChars);
@@ -200,6 +196,21 @@ export function buildPrompt(text, files) {
         return text;
     return `${text || 'Please analyze this.'}\n\n[Files: ${files.map(f => path.basename(f)).join(', ')}]`;
 }
+function appendExtraPrompt(base, extra) {
+    const lhs = String(base || '').trim();
+    const rhs = String(extra || '').trim();
+    if (!lhs)
+        return rhs;
+    if (!rhs)
+        return lhs;
+    return `${lhs}\n\n${rhs}`;
+}
+function buildMcpDeliveryPrompt() {
+    return [
+        '[Artifact Return]',
+        'This is an IM conversation, so pay attention to the IM tools.',
+    ].join('\n');
+}
 function configModelValue(config, agent) {
     switch (agent) {
         case 'claude': return String(config.claudeModel || process.env.CLAUDE_MODEL || 'claude-opus-4-6').trim();
@@ -791,6 +802,10 @@ export class Bot {
         const extraArgs = agentConfig.extraArgs || [];
         this.log(`[runStream] agent=${cs.agent} session=${cs.sessionId || '(new)'} workdir=${this.workdir} timeout=${this.runTimeout}s attachments=${attachments.length}`);
         this.log(`[runStream] ${cs.agent} config: model=${resolvedModel} extraArgs=[${extraArgs.join(' ')}]`);
+        const isFirstTurnOfSession = !cs.sessionId || isPendingSessionId(cs.sessionId);
+        const effectiveSystemPrompt = isFirstTurnOfSession
+            ? (mcpSendFile ? appendExtraPrompt(systemPrompt, buildMcpDeliveryPrompt()) : systemPrompt)
+            : undefined;
         const opts = {
             agent: cs.agent, prompt, workdir: this.workdir, timeout: this.runTimeout,
             sessionId: cs.sessionId, model: null,
@@ -799,13 +814,13 @@ export class Bot {
             // codex-specific
             codexModel: cs.agent === 'codex' ? resolvedModel : this.codexModel,
             codexFullAccess: this.codexFullAccess,
-            codexDeveloperInstructions: systemPrompt || undefined,
+            codexDeveloperInstructions: effectiveSystemPrompt || undefined,
             codexExtraArgs: this.codexExtraArgs.length ? this.codexExtraArgs : undefined,
             codexPrevCumulative: cs.codexCumulative,
             // claude-specific
             claudeModel: cs.agent === 'claude' ? resolvedModel : this.claudeModel,
             claudePermissionMode: this.claudePermissionMode,
-            claudeAppendSystemPrompt: systemPrompt || undefined,
+            claudeAppendSystemPrompt: effectiveSystemPrompt || undefined,
             claudeExtraArgs: this.claudeExtraArgs.length ? this.claudeExtraArgs : undefined,
             // gemini-specific
             geminiModel: cs.agent === 'gemini' ? resolvedModel : (this.agentConfigs.gemini?.model || ''),

package/dist/channel-feishu.js

@@ -15,6 +15,7 @@ import path from 'node:path';
 import { Channel, DEFAULT_CHANNEL_CAPABILITIES, sleep, } from './channel-base.js';
 export { FeishuChannel };
 const FEISHU_CARD_MAX = 28_000; // card markdown budget (card JSON limit ~30KB)
+const FILE_MAX_BYTES = 20 * 1024 * 1024; // 20MB max for file send/receive
 const PHOTO_EXTS = new Set(['.jpg', '.jpeg', '.png', '.webp', '.gif']);
 const FEISHU_WS_START_RETRY_MAX_DELAY_MS = 60_000;
 function describeError(err) {
@@ -647,7 +648,8 @@ class FeishuChannel extends Channel {
                 throw new Error('no card_id returned');
         }
         catch (e) {
-            this._log(`[streaming] CardKit create failed: ${e?.message || e}, falling back to regular card`);
+            const detail = e?.response?.data ? ` resp=${JSON.stringify(e.response.data)}` : '';
+            this._log(`[streaming] CardKit create failed: ${e?.message || e}${detail}, falling back to regular card`);
             return this.send(chatId, initialContent);
         }
         // Step 2: Send card as message (reply to user's message if replyTo is set)
@@ -679,6 +681,10 @@ class FeishuChannel extends Channel {
             return this.send(chatId, initialContent);
         }
     }
+    /** Check if a message is currently a streaming card (CardKit v2). */
+    isStreamingCard(messageId) {
+        return this.cardStates.has(messageId);
+    }
     /**
      * End streaming mode on a card and finalize it.
      * After this, `editMessage()` falls through to the regular PATCH path.
@@ -759,20 +765,21 @@ class FeishuChannel extends Channel {
     }
     /** Upload and send a local file. */
     async sendFile(chatId, filePath, opts = {}) {
+        const stat = fs.statSync(filePath);
+        if (stat.size > FILE_MAX_BYTES) {
+            throw new Error(`file too large (${(stat.size / 1024 / 1024).toFixed(1)}MB, max ${FILE_MAX_BYTES / 1024 / 1024}MB)`);
+        }
         const content = fs.readFileSync(filePath);
         const filename = path.basename(filePath);
         const isPhoto = opts.asPhoto ?? PHOTO_EXTS.has(path.extname(filename).toLowerCase());
+        const replyTo = opts.replyTo ? String(opts.replyTo) : undefined;
         if (isPhoto) {
             try {
                 const imageKey = await this.uploadImage(content);
-                const resp = await this.client.im.message.create({
-                    params: { receive_id_type: 'chat_id' },
-                    data: {
-                        receive_id: String(chatId),
-                        msg_type: 'image',
-                        content: JSON.stringify({ image_key: imageKey }),
-                    },
-                });
+                const msgContent = JSON.stringify({ image_key: imageKey });
+                const resp = replyTo
+                    ? await this.client.im.message.reply({ path: { message_id: replyTo }, data: { msg_type: 'image', content: msgContent } })
+                    : await this.client.im.message.create({ params: { receive_id_type: 'chat_id' }, data: { receive_id: String(chatId), msg_type: 'image', content: msgContent } });
                 return resp?.data?.message_id ?? null;
             }
             catch (err) {
@@ -782,14 +789,10 @@ class FeishuChannel extends Channel {
             }
         }
         const fileKey = await this.uploadFile(content, filename);
-        const resp = await this.client.im.message.create({
-            params: { receive_id_type: 'chat_id' },
-            data: {
-                receive_id: String(chatId),
-                msg_type: 'file',
-                content: JSON.stringify({ file_key: fileKey }),
-            },
-        });
+        const msgContent = JSON.stringify({ file_key: fileKey });
+        const resp = replyTo
+            ? await this.client.im.message.reply({ path: { message_id: replyTo }, data: { msg_type: 'file', content: msgContent } })
+            : await this.client.im.message.create({ params: { receive_id_type: 'chat_id' }, data: { receive_id: String(chatId), msg_type: 'file', content: msgContent } });
         return resp?.data?.message_id ?? null;
     }
     // ========================================================================
@@ -805,6 +808,12 @@ class FeishuChannel extends Channel {
         const localPath = path.join(this.workdir, `_feishu_${name}`);
         fs.mkdirSync(this.workdir, { recursive: true });
         await resp.writeFile(localPath);
+        // Check downloaded file size
+        const stat = fs.statSync(localPath);
+        if (stat.size > FILE_MAX_BYTES) {
+            fs.rmSync(localPath, { force: true });
+            throw new Error(`file too large (${(stat.size / 1024 / 1024).toFixed(1)}MB, max ${FILE_MAX_BYTES / 1024 / 1024}MB)`);
+        }
         return localPath;
     }
     // ========================================================================

package/dist/channel-telegram.js

@@ -63,6 +63,7 @@ import { Channel, DEFAULT_CHANNEL_CAPABILITIES, splitText, sleep, } from './chan
 setGlobalDispatcher(new EnvHttpProxyAgent());
 export { TelegramChannel };
 const TG_MAX = 4096;
+const FILE_MAX_BYTES = 20 * 1024 * 1024; // 20MB max for file send/receive
 const PHOTO_EXTS = new Set(['.jpg', '.jpeg', '.png', '.webp']);
 function previewText(value, max = 280) {
     const normalized = value.replace(/\s+/g, ' ').trim();
@@ -489,6 +490,10 @@ class TelegramChannel extends Channel {
         return data?.result?.message_id ?? null;
     }
     async sendFile(chatId, filePath, opts = {}) {
+        const stat = fs.statSync(filePath);
+        if (stat.size > FILE_MAX_BYTES) {
+            throw new Error(`file too large (${(stat.size / 1024 / 1024).toFixed(1)}MB, max ${FILE_MAX_BYTES / 1024 / 1024}MB)`);
+        }
         const content = fs.readFileSync(filePath);
         const filename = path.basename(filePath);
         const wantsPhoto = opts.asPhoto ?? PHOTO_EXTS.has(path.extname(filename).toLowerCase());
@@ -585,6 +590,12 @@ 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 });
+            throw new Error(`file too large (${(stat.size / 1024 / 1024).toFixed(1)}MB, max ${FILE_MAX_BYTES / 1024 / 1024}MB)`);
+        }
         return localPath;
     }
     // ========================================================================