pikiclaw 0.2.62 → 0.2.64

package/README.md

@@ -8,6 +8,8 @@
 
 > npx pikiclaw@latest
 
+<img src="docs/promo-install.gif" alt="Quick install" width="700">
+
 <p align="center">
 <a href="https://www.npmjs.com/package/pikiclaw"><img src="https://img.shields.io/npm/v/pikiclaw" alt="npm"></a>
 <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a>
@@ -45,7 +47,20 @@ pikiclaw 的目标很直接：
        你的电脑
 ```
 
-它适合的不是“演示一次 AI”，而是你离开电脑以后，Agent 还能继续在本机把事做完。
+它适合的不是”演示一次 AI”，而是你离开电脑以后，Agent 还能继续在本机把事做完。
+
+### 在 Telegram 里长这样
+
+<table>
+<tr>
+<td align=”center”><b>命令与 Agent 切换</b><br><img src=”docs/promo-tg-commands.png” alt=”Commands” width=”320”></td>
+<td align=”center”><b>代码审查</b><br><img src=”docs/promo-tg-task.png” alt=”Code review” width=”320”></td>
+</tr>
+<tr>
+<td align=”center”><b>多轮编码 + 文件回传</b><br><img src=”docs/promo-tg-complex.png” alt=”Complex task” width=”320”></td>
+<td align=”center”><b>状态监控 + 会话管理</b><br><img src=”docs/promo-tg-sessions.png” alt=”Sessions” width=”320”></td>
+</tr>
+</table>
 
 ---
 
@@ -76,6 +91,23 @@ npx pikiclaw@latest
 - 工作目录切换
 - 会话和运行状态查看
 
+<details>
+<summary>Dashboard 截图</summary>
+
+**配置管理** — IM 接入、AI Agent、系统权限
+
+<img src="docs/promo-dashboard-config.png" alt="Config" width="700">
+
+**插件中心** — 浏览器操控、桌面自动化
+
+<img src="docs/promo-dashboard-extensions.png" alt="Extensions" width="700">
+
+**会话管理** — 按 Agent 分组的会话泳道
+
+<img src="docs/promo-dashboard-sessions.png" alt="Sessions" width="700">
+
+</details>
+
 如果你更喜欢终端向导：
 
 ```bash
@@ -152,6 +184,13 @@ npx pikiclaw@latest --doctor
 
 普通文本消息会直接转给当前 Agent。
 
+<details>
+<summary>Telegram 命令效果预览</summary>
+
+<img src="docs/promo-tg-commands.png" alt="Commands in Telegram" width="360">
+
+</details>
+
 ---
 
 ## Config And Setup Notes

package/dist/agent-auto-update.js

@@ -3,8 +3,9 @@ import os from 'node:os';
 import path from 'node:path';
 import { spawn } from 'node:child_process';
 import { getAgentLabel, getAgentPackage } from './agent-npm.js';
-const AGENT_UPDATE_LOCK_STALE_MS = 60 * 60_000;
-const AGENT_UPDATE_COMMAND_TIMEOUT_MS = 15 * 60_000;
+import { AGENT_UPDATE_TIMEOUTS } from './constants.js';
+const AGENT_UPDATE_LOCK_STALE_MS = AGENT_UPDATE_TIMEOUTS.lockStale;
+const AGENT_UPDATE_COMMAND_TIMEOUT_MS = AGENT_UPDATE_TIMEOUTS.commandTimeout;
 function updaterLockPath() {
     return path.join(os.homedir(), '.pikiclaw', 'agent-auto-update.lock');
 }
@@ -95,11 +96,11 @@ async function runCommand(cmd, args, opts = {}) {
     });
 }
 async function getNpmGlobalPrefix() {
-    const result = await runCommand('npm', ['prefix', '-g'], { timeoutMs: 10_000 });
+    const result = await runCommand('npm', ['prefix', '-g'], { timeoutMs: AGENT_UPDATE_TIMEOUTS.npmPrefix });
     return result.ok ? result.stdout.trim().split('\n')[0] || null : null;
 }
 async function getLatestPackageVersion(pkg) {
-    const result = await runCommand('npm', ['view', pkg, 'version', '--json'], { timeoutMs: 20_000 });
+    const result = await runCommand('npm', ['view', pkg, 'version', '--json'], { timeoutMs: AGENT_UPDATE_TIMEOUTS.npmView });
     if (!result.ok)
         return null;
     const raw = result.stdout.trim();

package/dist/bot-feishu-render.js

@@ -5,64 +5,21 @@
  * Also provides a LivePreviewRenderer for streaming output.
  */
 import { encodeCommandAction } from './bot-command-ui.js';
-import { fmtUptime, fmtTokens, fmtBytes, formatThinkingForDisplay, thinkLabel } from './bot.js';
+import { fmtUptime, fmtTokens, fmtBytes } from './bot.js';
 import { summarizePromptForStatus } from './bot-commands.js';
-import { formatProviderUsageLines } from './bot-telegram-render.js';
-import { formatActivityCommandSummary, parseActivitySummary, renderPlanForPreview, summarizeActivityForPreview } from './bot-streaming.js';
+import { footerStatusSymbol, formatFooterSummary, trimActivityForPreview, buildProviderUsageLines, extractFinalReplyData, extractStreamPreviewData, } from './bot-render-shared.js';
 import { currentHumanLoopQuestion, humanLoopAnsweredCount, isHumanLoopAwaitingText, isHumanLoopQuestionAnswered, summarizeHumanLoopAnswer, } from './human-loop.js';
 import path from 'node:path';
 import { listSubdirs } from './bot.js';
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
-function fmtCompactUptime(ms) {
-    return fmtUptime(ms).replace(/\s+/g, '');
-}
-function footerStatusSymbol(status) {
-    switch (status) {
-        case 'running': return '●';
-        case 'done': return '✓';
-        case 'failed': return '✗';
-    }
-}
-function formatFooterSummary(agent, elapsedMs, meta, contextPercent) {
-    const parts = [agent];
-    const ctx = contextPercent ?? meta?.contextPercent ?? null;
-    if (ctx != null)
-        parts.push(`${ctx}%`);
-    parts.push(fmtCompactUptime(Math.max(0, Math.round(elapsedMs))));
-    return parts.join(' · ');
-}
 function formatPreviewFooter(agent, elapsedMs, meta) {
     return `${footerStatusSymbol('running')} ${formatFooterSummary(agent, elapsedMs, meta)}`;
 }
 function formatFinalFooter(status, agent, elapsedMs, contextPercent) {
     return `${footerStatusSymbol(status)} ${formatFooterSummary(agent, elapsedMs, null, contextPercent ?? null)}`;
 }
-function trimActivityForPreview(text, maxChars = 900) {
-    if (text.length <= maxChars)
-        return text;
-    const lines = text.split('\n').filter(l => l.trim());
-    if (lines.length <= 1)
-        return text.slice(0, Math.max(0, maxChars - 3)).trimEnd() + '...';
-    const tailCount = Math.min(2, Math.max(1, lines.length - 1));
-    const tail = lines.slice(-tailCount);
-    const headCandidates = lines.slice(0, Math.max(0, lines.length - tailCount));
-    const reserved = tail.join('\n').length + 5;
-    const budget = Math.max(0, maxChars - reserved);
-    const head = [];
-    let used = 0;
-    for (const line of headCandidates) {
-        const extra = line.length + (head.length ? 1 : 0);
-        if (used + extra > budget)
-            break;
-        head.push(line);
-        used += extra;
-    }
-    if (!head.length)
-        return text.slice(0, Math.max(0, maxChars - 3)).trimEnd() + '...';
-    return [...head, '...', ...tail].join('\n');
-}
 function truncateLabel(label, maxChars = 24) {
     return label.length > maxChars ? `${label.slice(0, Math.max(1, maxChars - 1))}…` : label;
 }
@@ -212,31 +169,22 @@ export function buildInitialPreviewMarkdown(agent, model, effort, waiting = fals
     return parts.join(' · ');
 }
 function buildPreviewMarkdown(input, options) {
-    const maxBody = 2400;
-    const display = input.bodyText.trim();
-    const rawThinking = input.thinking.trim();
-    const thinkDisplay = formatThinkingForDisplay(input.thinking, maxBody);
-    const planDisplay = renderPlanForPreview(input.plan ?? null);
-    const activityDisplay = summarizeActivityForPreview(input.activity);
-    const maxActivity = !display && !thinkDisplay && !planDisplay ? 2400 : 1400;
+    const data = extractStreamPreviewData(input);
     const parts = [];
-    const label = thinkLabel(input.agent);
-    if (planDisplay) {
-        parts.push(`**Plan**\n${planDisplay}`);
+    if (data.planDisplay) {
+        parts.push(`**Plan**\n${data.planDisplay}`);
     }
-    if (activityDisplay) {
-        parts.push(`**Activity**\n${trimActivityForPreview(activityDisplay, maxActivity)}`);
+    if (data.activityDisplay) {
+        parts.push(`**Activity**\n${trimActivityForPreview(data.activityDisplay, data.maxActivity)}`);
     }
-    if (thinkDisplay && !display) {
-        parts.push(`**${label}**\n${thinkDisplay}`);
+    if (data.thinkDisplay && !data.display) {
+        parts.push(`**${data.label}**\n${data.thinkDisplay}`);
     }
-    else if (display) {
-        if (rawThinking) {
-            const thinkSnippet = formatThinkingForDisplay(input.thinking, 600);
-            parts.push(`**${label}**\n${thinkSnippet}`);
+    else if (data.display) {
+        if (data.rawThinking) {
+            parts.push(`**${data.label}**\n${data.thinkSnippet}`);
         }
-        const preview = display.length > maxBody ? '(...truncated)\n' + display.slice(-maxBody) : display;
-        parts.push(preview);
+        parts.push(data.preview);
     }
     if (options?.includeFooter !== false) {
         parts.push(formatPreviewFooter(input.agent, input.elapsedMs, input.meta ?? null));
@@ -260,46 +208,26 @@ export const feishuStreamingPreviewRenderer = {
     renderStream: buildStreamingBodyMarkdown,
 };
 export function buildFinalReplyRender(agent, result) {
-    const footerStatus = result.incomplete || !result.ok ? 'failed' : 'done';
-    const footerText = `\n\n${formatFinalFooter(footerStatus, agent, result.elapsedS * 1000, result.contextPercent ?? null)}`;
+    const data = extractFinalReplyData(agent, result);
+    const footerText = `\n\n${formatFinalFooter(data.footerStatus, agent, data.elapsedMs, result.contextPercent ?? null)}`;
     let activityText = '';
     let activityNoteText = '';
-    if (result.activity) {
-        const summary = parseActivitySummary(result.activity);
-        const narrative = summary.narrative.join('\n');
-        if (narrative) {
-            let display = narrative;
-            if (display.length > 1600)
-                display = '...\n' + display.slice(-1600);
-            activityText = `**Activity**\n${display}\n\n`;
-        }
-        const commandSummary = formatActivityCommandSummary(summary.completedCommands, summary.activeCommands, summary.failedCommands);
-        if (commandSummary)
-            activityNoteText = `*${commandSummary}*\n\n`;
+    if (data.activityNarrative) {
+        activityText = `**Activity**\n${data.activityNarrative}\n\n`;
+    }
+    if (data.activityCommandSummary) {
+        activityNoteText = `*${data.activityCommandSummary}*\n\n`;
     }
     let thinkingText = '';
-    if (result.thinking) {
-        thinkingText = `**${thinkLabel(agent)}**\n${formatThinkingForDisplay(result.thinking, 1600)}\n\n`;
+    if (data.thinkingDisplay) {
+        thinkingText = `**${data.thinkLabel}**\n${data.thinkingDisplay}\n\n`;
     }
     let statusText = '';
-    if (result.incomplete) {
-        const statusLines = [];
-        if (result.stopReason === 'max_tokens')
-            statusLines.push('Output limit reached. Response may be truncated.');
-        if (result.stopReason === 'timeout') {
-            statusLines.push(`Timed out after ${fmtUptime(Math.max(0, Math.round(result.elapsedS * 1000)))} before the agent reported completion.`);
-        }
-        if (!result.ok) {
-            const detail = result.error?.trim();
-            if (detail && detail !== result.message.trim() && !statusLines.includes(detail))
-                statusLines.push(detail);
-            else if (result.stopReason !== 'timeout')
-                statusLines.push('Agent exited before reporting completion.');
-        }
-        statusText = `**⚠ Incomplete Response**\n${statusLines.join('\n')}\n\n`;
+    if (data.statusLines) {
+        statusText = `**⚠ Incomplete Response**\n${data.statusLines.join('\n')}\n\n`;
     }
     const headerText = `${activityText}${activityNoteText}${statusText}${thinkingText}`;
-    const bodyText = result.message;
+    const bodyText = data.bodyMessage;
     return {
         fullText: `${headerText}${bodyText}${footerText}`,
         headerText,
@@ -474,12 +402,11 @@ export function renderStatus(d) {
         lines.push(`**Running:** ${fmtUptime(Date.now() - d.running.startedAt)} - ${summarizePromptForStatus(d.running.prompt)}`);
     }
     // Provider usage
-    const usageLines = formatProviderUsageLines(d.usage);
+    const usageLines = buildProviderUsageLines(d.usage);
     if (usageLines.length > 1) {
         lines.push('');
-        // Strip HTML tags from usage lines (they're HTML-formatted)
         for (const line of usageLines) {
-            lines.push(line.replace(/<\/?[^>]+>/g, '').replace(/&amp;/g, '&').replace(/&lt;/g, '<').replace(/&gt;/g, '>'));
+            lines.push(line.text);
         }
     }
     lines.push('', '**Bot Usage**', `  Turns: ${d.stats.totalTurns}`);

package/dist/bot-feishu.js

@@ -24,6 +24,7 @@ import { currentHumanLoopQuestion, humanLoopOptionSelected } from './human-loop.
 import { FeishuChannel } from './channel-feishu.js';
 import { splitText, supportsChannelCapability } from './channel-base.js';
 import { getActiveUserConfig } from './user-config.js';
+import { FEISHU_BOT_CARD_MAX } from './constants.js';
 const SHUTDOWN_EXIT_CODE = {
     SIGINT: 130,
     SIGTERM: 143,
@@ -640,7 +641,7 @@ export class FeishuBot extends Bot {
     async sendFinalReply(ctx, placeholderId, agent, result) {
         const rendered = buildFinalReplyRender(agent, result);
         const messageIds = [];
-        const MAX_CARD = 25_000;
+        const MAX_CARD = FEISHU_BOT_CARD_MAX;
         if (rendered.fullText.length <= MAX_CARD) {
             // Fits in one card — edit the placeholder
             if (placeholderId) {

package/dist/bot-orchestration.js

@@ -1,5 +1,6 @@
 import { buildDefaultMenuCommands } from './bot-menu.js';
-export const BOT_SHUTDOWN_FORCE_EXIT_MS = 3_000;
+import { BOT_SHUTDOWN_FORCE_EXIT_MS as _BOT_SHUTDOWN_FORCE_EXIT_MS } from './constants.js';
+export const BOT_SHUTDOWN_FORCE_EXIT_MS = _BOT_SHUTDOWN_FORCE_EXIT_MS;
 export function buildBotMenuState(bot) {
     const agents = bot.fetchAgents().agents;
     const installedCount = agents.filter(agent => agent.installed).length;

package/dist/bot-render-shared.js

@@ -0,0 +1,162 @@
+/**
+ * bot-render-shared.ts — Shared rendering logic used by both Telegram and Feishu renderers.
+ *
+ * Contains types, pure-data helpers, and functions that are identical across platforms.
+ * Platform-specific formatting (HTML vs Markdown) stays in the respective render files.
+ */
+import { fmtUptime, formatThinkingForDisplay, thinkLabel } from './bot.js';
+import { formatActivityCommandSummary, parseActivitySummary, renderPlanForPreview, summarizeActivityForPreview } from './bot-streaming.js';
+// ---------------------------------------------------------------------------
+// Footer helpers
+// ---------------------------------------------------------------------------
+export function fmtCompactUptime(ms) {
+    return fmtUptime(ms).replace(/\s+/g, '');
+}
+export function footerStatusSymbol(status) {
+    switch (status) {
+        case 'running': return '●';
+        case 'done': return '✓';
+        case 'failed': return '✗';
+    }
+}
+export function formatFooterSummary(agent, elapsedMs, meta, contextPercent) {
+    const parts = [agent];
+    const ctx = contextPercent ?? meta?.contextPercent ?? null;
+    if (ctx != null)
+        parts.push(`${ctx}%`);
+    parts.push(fmtCompactUptime(Math.max(0, Math.round(elapsedMs))));
+    return parts.join(' · ');
+}
+// ---------------------------------------------------------------------------
+// Activity trimming
+// ---------------------------------------------------------------------------
+export function trimActivityForPreview(text, maxChars = 900) {
+    if (text.length <= maxChars)
+        return text;
+    const lines = text.split('\n').filter(line => line.trim());
+    if (lines.length <= 1)
+        return text.slice(0, Math.max(0, maxChars - 3)).trimEnd() + '...';
+    const tailCount = Math.min(2, Math.max(1, lines.length - 1));
+    const tail = lines.slice(-tailCount);
+    const headCandidates = lines.slice(0, Math.max(0, lines.length - tailCount));
+    const reserved = tail.join('\n').length + 5;
+    const budget = Math.max(0, maxChars - reserved);
+    const head = [];
+    let used = 0;
+    for (const line of headCandidates) {
+        const extra = line.length + (head.length ? 1 : 0);
+        if (used + extra > budget)
+            break;
+        head.push(line);
+        used += extra;
+    }
+    if (!head.length)
+        return text.slice(0, Math.max(0, maxChars - 3)).trimEnd() + '...';
+    return [...head, '...', ...tail].join('\n');
+}
+// ---------------------------------------------------------------------------
+// Provider usage (plain-text builder — caller wraps as needed)
+// ---------------------------------------------------------------------------
+function rawUsageLine(parts) {
+    return parts.filter(part => !!part && String(part).trim()).join(' ');
+}
+export function buildProviderUsageLines(usage) {
+    const lines = [
+        { text: '', bold: false },
+        { text: 'Provider Usage', bold: true },
+    ];
+    if (!usage.ok) {
+        lines.push({ text: `  Unavailable: ${usage.error || 'No recent usage data found.'}` });
+        return lines;
+    }
+    if (usage.capturedAt) {
+        const capturedAtMs = Date.parse(usage.capturedAt);
+        if (Number.isFinite(capturedAtMs)) {
+            lines.push({ text: `  Updated: ${fmtUptime(Math.max(0, Date.now() - capturedAtMs))} ago` });
+        }
+    }
+    if (!usage.windows.length) {
+        lines.push({ text: `  ${usage.status ? `status=${usage.status}` : 'No window data'}` });
+        return lines;
+    }
+    for (const window of usage.windows) {
+        const details = rawUsageLine([
+            window.usedPercent != null ? `${window.usedPercent}% used` : null,
+            window.status ? `status=${window.status}` : null,
+            window.resetAfterSeconds != null ? `resetAfterSeconds=${window.resetAfterSeconds}` : null,
+        ]);
+        lines.push({ text: `  ${window.label}: ${details || 'No details'}` });
+    }
+    return lines;
+}
+export function extractFinalReplyData(agent, result) {
+    const footerStatus = result.incomplete || !result.ok ? 'failed' : 'done';
+    const elapsedMs = result.elapsedS * 1000;
+    const footerSummary = formatFooterSummary(agent, elapsedMs, null, result.contextPercent ?? null);
+    let activityNarrative = null;
+    let activityCommandSummary = null;
+    if (result.activity) {
+        const summary = parseActivitySummary(result.activity);
+        const narrative = summary.narrative.join('\n');
+        if (narrative) {
+            activityNarrative = narrative.length > 1600 ? '...\n' + narrative.slice(-1600) : narrative;
+        }
+        const cmdSummary = formatActivityCommandSummary(summary.completedCommands, summary.activeCommands, summary.failedCommands);
+        if (cmdSummary)
+            activityCommandSummary = cmdSummary;
+    }
+    let thinkingDisplay = null;
+    if (result.thinking) {
+        thinkingDisplay = formatThinkingForDisplay(result.thinking, 1600);
+    }
+    let statusLines = null;
+    if (result.incomplete) {
+        statusLines = [];
+        if (result.stopReason === 'max_tokens')
+            statusLines.push('Output limit reached. Response may be truncated.');
+        if (result.stopReason === 'timeout') {
+            statusLines.push(`Timed out after ${fmtUptime(Math.max(0, Math.round(elapsedMs)))} before the agent reported completion.`);
+        }
+        if (!result.ok) {
+            const detail = result.error?.trim();
+            if (detail && detail !== result.message.trim() && !statusLines.includes(detail))
+                statusLines.push(detail);
+            else if (result.stopReason !== 'timeout')
+                statusLines.push('Agent exited before reporting completion.');
+        }
+    }
+    return {
+        footerStatus,
+        footerSummary,
+        activityNarrative,
+        activityCommandSummary,
+        thinkingDisplay,
+        thinkLabel: thinkLabel(agent),
+        statusLines,
+        bodyMessage: result.message,
+        elapsedMs,
+    };
+}
+export function extractStreamPreviewData(input) {
+    const maxBody = 2400;
+    const display = input.bodyText.trim();
+    const rawThinking = input.thinking.trim();
+    const thinkDisplay = formatThinkingForDisplay(input.thinking, maxBody);
+    const planDisplay = renderPlanForPreview(input.plan ?? null);
+    const activityDisplay = summarizeActivityForPreview(input.activity);
+    const maxActivity = !display && !thinkDisplay && !planDisplay ? 2400 : 1400;
+    const label = thinkLabel(input.agent);
+    const thinkSnippet = rawThinking ? formatThinkingForDisplay(input.thinking, 600) : '';
+    const preview = display.length > maxBody ? '(...truncated)\n' + display.slice(-maxBody) : display;
+    return {
+        display,
+        rawThinking,
+        thinkDisplay,
+        planDisplay,
+        activityDisplay,
+        maxActivity,
+        label,
+        thinkSnippet,
+        preview,
+    };
+}

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

@@ -1,7 +1,8 @@
 import { hasPreviewMeta, samePreviewMeta, samePreviewPlan } from './bot-streaming.js';
-const STREAM_PREVIEW_HEARTBEAT_MS = 5_000;
-const STREAM_TYPING_HEARTBEAT_MS = 4_000;
-const STREAM_STALLED_NOTICE_MS = 15_000;
+import { STREAM_PREVIEW_TIMEOUTS } from './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
 // ---------------------------------------------------------------------------