@bolloon/bolloon-agent 0.3.33 → 0.3.35

package/dist/bootstrap/snip-collapse.js

@@ -45,50 +45,54 @@ export function snipHistory(messages, opts = {}) {
         }
         return m;
     });
+    // Step 3 (提前): 窗口内也截断过长 tool 结果 — 2026-08-06 fix: 原来在 Step 2 return 之后,
+    //   窗口内消息永远走不到 tool 截断 (budgeted.length <= maxMessages 时提前返回).
+    //   originalLength 保留最早值 (budget-reduce 已记录原始长度, 不覆盖).
+    const trimToolResults = (list, boundaryProtected = false) => list.map(m => {
+        if (m.role === 'tool' && m.content.length > maxToolResultChars && m.transform !== 'snip') {
+            return {
+                ...m,
+                content: m.content.slice(0, maxToolResultChars) + `\n[...工具结果截断]`,
+                originalLength: m.originalLength ?? m.content.length,
+                transform: m.transform || 'snip-tool',
+            };
+        }
+        return m;
+    });
     // Step 2: Snip — 超过 maxMessages 时裁最老的
     if (budgeted.length <= maxMessages)
-        return budgeted;
-    // 工具调用链保护: 从尾部往前数, 保留最近的 assistant+tool 对
+        return trimToolResults(budgeted);
     const keepCount = maxMessages;
-    const result = [];
     const toRemove = budgeted.length - keepCount;
-    // 策略: 从最老的开始裁, 但要保证不会裁掉未配对的 assistant (tool_calls)
-    // 遍历时追踪 "悬空的 tool 消息" 保护
-    let removed = 0;
-    let protectedToolChain = 0; // 从尾部连续 tool 消息不裁
-    for (let i = budgeted.length - 1; i >= 0; i--) {
-        const m = budgeted[i];
-        if (m.role === 'tool' && protectedToolChain < 5) {
-            protectedToolChain++;
-        }
-        else if (m.role === 'assistant' && protectedToolChain > 0) {
-            // 遇到 assistant 代表这个工具链结束了
+    // 2026-08-06 重写: 原实现 protectedToolChain 计数逻辑混乱 (assistant 分支不重置,
+    //   条件 `budgeted.length - i > protectedToolChain` 语义错误), 且占位符路径只在
+    //   removed<=toRemove 时生效导致被裁消息数与实际不符.
+    //   新语义:
+    //     - 从头部裁 toRemove 条 (最老历史), 占位区间 = [0, removedIndex)
+    //     - 裁剪边界保护: 若保留区第一条是 tool 且前一条是 assistant, assistant 天然在
+    //       移除区 → 它变成占位符, 保持 [assistant占位, tool] 相邻, 不产生悬空 tool
+    //       (原生 tool_calls 路径要求 assistant→tool 相邻; 占位保留 role 序列形状)
+    //     - 被裁消息 → '[已裁减, Snip]' 占位符 (保留 role 顺序, 防配对错乱)
+    const result = [];
+    const removedIndex = budgeted.length - keepCount; // 保留区起点 (含)
+    // 边界保护 (2026-08-06 fix): 只验证不改变 cutAt —
+    //   之前 `cutAt -= 1` 把占位区间缩窄, 导致边界 assistant 反而保留 (悬空 tool 依旧).
+    //   assistant 本来就在移除区 [0, removedIndex), 转占位后 tool 前紧邻占位 assistant, 配对形状保持.
+    const firstKept = budgeted[removedIndex];
+    const before = removedIndex > 0 ? budgeted[removedIndex - 1] : undefined;
+    // boundaryProtected 仅语义标记 (测试/日志用), 占位区间不变
+    const boundaryProtected = firstKept.role === 'tool' && before?.role === 'assistant';
+    if (boundaryProtected) { /* 保护生效: tool 前紧邻占位 assistant */ }
+    for (let i = 0; i < budgeted.length; i++) {
+        if (i < removedIndex) {
+            result.push({ ...budgeted[i], content: '[已裁减, Snip]', originalLength: budgeted[i].content.length, transform: 'snip' });
         }
         else {
-            protectedToolChain = 0;
+            result.push(budgeted[i]);
         }
-        // 如果在保护区内, 不裁
-        if (i < budgeted.length - keepCount && budgeted.length - i > protectedToolChain) {
-            removed++;
-            if (removed <= toRemove) {
-                result.unshift({ ...m, content: '[已裁减, Snip]', transform: 'snip' });
-                continue;
-            }
-        }
-        result.unshift(m);
     }
     // Step 3: 如果 tool result 仍然太长, 进一步截断
-    return result.map(m => {
-        if (m.role === 'tool' && m.content.length > maxToolResultChars) {
-            return {
-                ...m,
-                content: m.content.slice(0, maxToolResultChars) + `\n[...工具结果截断]`,
-                originalLength: m.content.length,
-                transform: m.transform || 'snip-tool',
-            };
-        }
-        return m;
-    });
+    return trimToolResults(result);
 }
 /**
  * Phase 3: Context Collapse — 读时虚拟投影.

package/dist/cli/ink-app.js

@@ -251,6 +251,10 @@ const InkApp = ({ onPrompt, initialStatus, getStatusUpdate, terminalW, terminalH
     const [tiKey, setTiKey] = useState(0);
     // 全局: 思考动画控制
     useEffect(() => {
+        // 2026-08-06: 防御 — 某些环境 (tsx/完整 CLI 初始化) 下 stdin 会处于 paused,
+        // 不恢复则 useInput 收不到任何输入 (实测 isPaused=true, listeners=0)
+        if (process.stdin.isPaused())
+            process.stdin.resume();
         globalThis.__inkSetThinking = (v) => setThinking(v);
         globalThis.__inkAppend = (line) => {
             setMsgs(prev => [...prev, line]);
@@ -308,6 +312,15 @@ const InkApp = ({ onPrompt, initialStatus, getStatusUpdate, terminalW, terminalH
                     acceptMention(it);
                 return;
             }
+            if (key.return && filtered.length === 0) {
+                // 弹窗无匹配项: Enter = 提交当前输入 (否则 /channel 无参 + Enter 永远提交不了 — 2026-08-06)
+                const v = input.trim();
+                if (v)
+                    onSubmit(v);
+                else
+                    setDismissed(mentionKey);
+                return;
+            }
             if (key.escape) {
                 if (tabState)
                     setTabState(null);
@@ -346,11 +359,11 @@ const InkApp = ({ onPrompt, initialStatus, getStatusUpdate, terminalW, terminalH
                 });
                 return;
             }
-            if (_input && !key.ctrl && !key.meta) {
+            if (_input && !key.ctrl && !key.meta && !key.return) {
                 setInput(cur => cur + _input);
                 return;
             }
-            return; // 其余键忽略
+            return; // 其余键忽略 (return/tab/esc 等由 TextInput 或上层处理)
         }
         // ── 正常模式 ──
         // Tab 命令补齐 (无触发符的普通 token 也补)
@@ -443,7 +456,7 @@ const InkApp = ({ onPrompt, initialStatus, getStatusUpdate, terminalW, terminalH
         }, 600);
         return () => clearInterval(timer);
     }, [thinking]);
-    return (_jsxs(Box, { flexDirection: "column", height: "100%", children: [_jsxs(Box, { flexGrow: 1, flexDirection: "column", justifyContent: "flex-start", children: [_jsx(LogoBox, { width: terminalW }), _jsx(Messages, { msgs: msgs }), thinking && (_jsx(Box, { children: _jsxs(Text, { color: "yellow", children: [KAOMOJI[thinkingIdx.current], " \u601D\u8003\u4E2D..."] }) }))] }), _jsx(Box, { children: _jsx(Text, { bold: true, color: "white", children: '─'.repeat(terminalW) }) }), _jsx(Box, { children: _jsx(Text, { children: status }) }), _jsx(Box, { children: _jsx(Text, { bold: true, color: "white", children: '─'.repeat(terminalW) }) }), popupOpen && (tabState || mention) && (_jsx(MentionPopup, { title: popupTitle, items: filtered, sel: safeSel, width: terminalW, loading: loadingFiles })), _jsxs(Box, { children: [_jsx(Text, { bold: true, color: "green", children: "\u276F " }), _jsx(TextInput, { value: input, onChange: setInput, onSubmit: onSubmit, focus: !popupOpen, placeholder: "\u8F93\u5165\u6D88\u606F... @\u667A\u80FD\u4F53 /\u547D\u4EE4 #\u6587\u4EF6 \u00B7 Esc \u53CC\u51FB\u9000\u51FA \u00B7 /queue \u6392\u961F \u00B7 !\u7EC8\u7AEF\u547D\u4EE4" }, tiKey)] }), _jsx(Box, { children: _jsx(Text, { bold: true, color: "white", children: '─'.repeat(terminalW) }) })] }));
+    return (_jsxs(Box, { flexDirection: "column", height: "100%", children: [_jsxs(Box, { flexGrow: 1, flexDirection: "column", justifyContent: "flex-start", children: [_jsx(LogoBox, { width: terminalW }), _jsx(Messages, { msgs: msgs }), thinking && (_jsx(Box, { children: _jsxs(Text, { color: "yellow", children: [KAOMOJI[thinkingIdx.current], " \u601D\u8003\u4E2D..."] }) }))] }), _jsx(Box, { children: _jsx(Text, { bold: true, color: "#c4d640", children: '─'.repeat(terminalW) }) }), _jsx(Box, { children: _jsx(Text, { children: status }) }), _jsx(Box, { children: _jsx(Text, { bold: true, color: "#c4d640", children: '─'.repeat(terminalW) }) }), popupOpen && (tabState || mention) && (_jsx(MentionPopup, { title: popupTitle, items: filtered, sel: safeSel, width: terminalW, loading: loadingFiles })), _jsxs(Box, { children: [_jsx(Text, { bold: true, color: "#c4d640", children: "\u276F " }), _jsx(TextInput, { value: input, onChange: setInput, onSubmit: onSubmit, focus: !popupOpen, placeholder: "\u8F93\u5165\u6D88\u606F... @\u667A\u80FD\u4F53 /\u547D\u4EE4 #\u6587\u4EF6 \u00B7 Esc \u53CC\u51FB\u9000\u51FA \u00B7 /queue \u6392\u961F \u00B7 !\u7EC8\u7AEF\u547D\u4EE4" }, tiKey)] }), _jsx(Box, { children: _jsx(Text, { bold: true, color: "#c4d640", children: '─'.repeat(terminalW) }) })] }));
 };
 export { InkApp };
 // ─── 启动 ────────────────────────────────────────────────────────────────────

package/dist/cli/loading-tui.js

@@ -287,10 +287,11 @@ export function renderMessageBox(opts) {
     const inner = Math.max(20, dispWidth(title) + 4, maxLine);
     const width = Math.min(termWidth() - 2, opts.width ?? inner + 4);
     const lines = [];
-    lines.push(boxTop(`${color}${title}${RESET}`, width, RD));
+    // 2026-08-06: 边框改 bolloon 色系 (C_BORDER #3a3a36 暗色描边, 标题色不变)
+    lines.push(`${C_BORDER}${boxTop(`${color}${title}${RESET}`, width, RD)}${RESET}`);
     for (const l of wrapText(opts.body, width - 4))
-        lines.push(boxRow(l, width, 'left', RD));
-    lines.push(boxBottom(width, RD));
+        lines.push(`${C_BORDER}${boxRow(l, width, 'left', RD)}${RESET}`);
+    lines.push(`${C_BORDER}${boxBottom(width, RD)}${RESET}`);
     return lines.join('\n');
 }
 /** 取首条非空行作为预览 (按可见宽度截断, 加省略号) */

package/dist/index.js

@@ -354,28 +354,69 @@ function rpcErr(code, msg) {
 // CLI with persistent bottom prompt
 // 2026-07-28: 改用 readline.createInterface + replReadline 循环
 let isRunning = false;
-let cliContextPct = 0;
 let queueMode = false;
 const pendingQueue = [];
 let cliStartTime = 0;
 let cliModelName = '…';
 let cliAgentName = '…';
+let cliActiveChannelId = null;
 function fmtDuration(ms) {
     const s = Math.floor(ms / 1000);
+    if (s < 60)
+        return `${s}s`;
     const m = Math.floor(s / 60);
+    if (m < 60)
+        return `${m}m ${s % 60}s`;
     const h = Math.floor(m / 60);
-    if (h > 0)
-        return `${h}h${m % 60}m`;
-    if (m > 0)
-        return `${m}m${s % 60}s`;
-    return `${s}s`;
+    return `${h}h ${m % 60}m`;
+}
+/** 2026-08-06: 从 ContextManager 读上下文用量 (CLI 状态栏数据源, 失败退化 0/1M) */
+function getCliCtxUsage() {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const cm = require('./bootstrap/context-manager.js').getContextManager();
+        const u = cm.getUsage();
+        return {
+            // 保留浮点 (0-100), 由 buildContextBar 格式化 — round 会让 <0.5% 全变 0, 状态栏像死代码
+            pct: Math.min(100, u.pct * 100),
+            usedTokens: u.usedTokens,
+            maxTokens: u.maxTokens,
+            stage: u.stage,
+        };
+    }
+    catch {
+        return { pct: 0, usedTokens: 0, maxTokens: 1_000_000, stage: 'normal' };
+    }
+}
+/** 上下文进度条: 320k/1M │ [██████░░░░] 32% (bolloon 色系: #c4d640 主色) */
+function buildContextBar(usage) {
+    const barLen = 10;
+    const filled = Math.min(barLen, Math.max(0, Math.round((usage.pct / 100) * barLen)));
+    const barColor = usage.stage === 'warning' || usage.stage === 'compressing' ? C_WARN : C_ACCENT;
+    const bar = `${C_DIM}[${RESET}${barColor}${'█'.repeat(filled)}${RESET}${C_DIM}${'░'.repeat(barLen - filled)}${RESET}${C_DIM}]${RESET}`;
+    const fmtK = (n) => (n >= 1_000_000 ? (n % 1_000_000 === 0 ? `${n / 1_000_000}M` : `${(n / 1_000_000).toFixed(1)}M`) : n >= 1000 ? `${Math.round(n / 1000)}k` : String(n));
+    const usageTxt = `${C_TEXT}${fmtK(usage.usedTokens)}/${fmtK(usage.maxTokens)}${RESET}`;
+    // 百分比: >=10% 整数, >=1% 一位小数, <1% 两位小数 (1M 窗口下小 token 数也可见变化)
+    const pctTxt = usage.pct >= 10 ? `${Math.round(usage.pct)}%` : usage.pct >= 1 ? `${usage.pct.toFixed(1)}%` : `${usage.pct.toFixed(2)}%`;
+    let suffix = '';
+    if (usage.stage === 'warning')
+        suffix = ` ${C_WARN}⚠ 即将压缩${RESET}`;
+    else if (usage.stage === 'compressing')
+        suffix = ` ${C_WARN}🗜️ 压缩中...${RESET}`;
+    else if (usage.stage === 'compressed')
+        suffix = ` ${C_OK}✓ 已压缩${RESET}`;
+    return `${usageTxt} ${C_DIM}│${RESET} ${bar} ${barColor}${pctTxt}${RESET}${suffix}`;
+}
+/** 状态栏: 模型 │ 当前智能体 (含 channel) │ ⏱ 时间 │ 320k/1M │ [██████░░░░] 32% (bolloon 色系) */
+function getStatus() {
+    const usage = getCliCtxUsage();
+    const agentPart = cliActiveChannelId ? `${cliAgentName} ${C_DIM}(ch:${cliActiveChannelId.slice(0, 10)})${RESET}` : cliAgentName;
+    return `${C_ACCENT}${cliModelName}${RESET}${C_DIM}  │${RESET} ${agentPart} ${C_DIM}│${RESET} ⏱ ${C_TEXT}${fmtDuration(Date.now() - cliStartTime)}${RESET}${C_DIM} │${RESET} ${buildContextBar(usage)}`;
 }
 function statusBarLine() {
     const dur = cliStartTime ? fmtDuration(Date.now() - cliStartTime) : '0s';
-    const barLen = 12;
-    const filled = Math.round((cliContextPct / 100) * barLen);
-    const bar = C_OK + '█'.repeat(filled) + C_DIM + '░'.repeat(barLen - filled) + RESET;
-    return `${C_ACCENT}${cliModelName}${RESET}${C_DIM}  │${RESET} ${cliAgentName} ${C_DIM}│${RESET} ⏱ ${C_ACCENT}${dur}${RESET} ${C_DIM}│${RESET} ${bar} ${C_DIM}${cliContextPct}%${RESET}`;
+    const usage = getCliCtxUsage();
+    return `${C_ACCENT}${cliModelName}${RESET}${C_DIM}  │${RESET} ${cliAgentName} ${C_DIM}│${RESET} ⏱ ${C_ACCENT}${dur}${RESET} ${C_DIM}│${RESET} ${buildContextBar(usage)}`;
 }
 async function startCLI(comm) {
     isRunning = true;
@@ -412,14 +453,23 @@ async function startCLI(comm) {
     cliModelName = foundProvider ? foundProvider[1] : '未配置';
     cliAgentName = agentIdentity?.name || 'bolloon';
     cliStartTime = Date.now();
+    // 恢复上次 active channel (session 恢复: CLI 与 Web 共用 active-channel.json)
+    try {
+        const { getIdentityStore } = await import('./agents/agent-identity-store.js');
+        const store = getIdentityStore();
+        await store.load();
+        const active = await store.getActive();
+        if (active) {
+            cliAgentName = active.name;
+            cliActiveChannelId = active.channelId ?? null;
+        }
+    }
+    catch {
+        /* 无 channels/active 记录时保持默认 */
+    }
     // 进入 Ink TUI 输入循环
-    const initialStatus = `${C_ACCENT}${cliModelName}\x1b[0m\x1b[90m  │\x1b[0m ${cliAgentName} \x1b[90m│\x1b[0m ⏱ 0s`;
-    const getStatus = () => {
-        const barLen = 12;
-        const filled = Math.round((cliContextPct / 100) * barLen);
-        const bar = '█'.repeat(filled) + '░'.repeat(barLen - filled);
-        return `${C_ACCENT}${cliModelName}\x1b[0m\x1b[90m  │\x1b[0m ${cliAgentName} \x1b[90m│\x1b[0m ⏱ ${fmtDuration(Date.now() - cliStartTime)}\x1b[90m │\x1b[0m ${bar} ${cliContextPct}%`;
-    };
+    // 2026-08-06: 初始状态栏也带上下文显示 (0/1M │ [░░░░░░░░░░] 0%)
+    const initialStatus = `${C_ACCENT}${cliModelName}${RESET}${C_DIM}  │${RESET} ${cliAgentName} ${C_DIM}│${RESET} ⏱ 0s${C_DIM} │${RESET} ${buildContextBar(getCliCtxUsage())}`;
     startInk((text) => { processInput(text, comm); }, initialStatus, getStatus);
     // Wait on a promise that resolves on Ctrl+C / 双击 Esc
     // (ink-app 的 requestExit 调 __inkRequestExit → resolve, 清理后 process.exit)
@@ -461,6 +511,49 @@ async function processInput(input, comm) {
         appendLine(`${C_DIM}──${RESET}`);
         return;
     }
+    // /channel — 切换当前智能体 (agent channel), 参数 name/id/number 自动解析
+    if (trimmed.toLowerCase().startsWith('/channel')) {
+        const q = trimmed.slice('/channel'.length).trim();
+        try {
+            const { getIdentityStore } = await import('./agents/agent-identity-store.js');
+            const store = getIdentityStore();
+            await store.load();
+            if (!q) {
+                // 无参: 列出所有 channel + active
+                const list = await store.listForDisplay();
+                const active = await store.getActive();
+                if (list.length === 0) {
+                    appendLine(`${C_DIM}暂无智能体 channel (channels.json 为空)${RESET}`);
+                    return;
+                }
+                appendLine(`${C_ACCENT}智能体列表:${RESET} (${active ? `当前: ${active.name}` : ''})`);
+                for (const { index, identity, active: isActive } of list) {
+                    const mark = isActive ? '●' : '○';
+                    appendLine(`  ${mark} ${index}. ${identity.name}  ${C_DIM}${identity.id.slice(0, 24)}${RESET}`);
+                }
+                appendLine(`${C_DIM}用法: /channel <名字|id|序号>${RESET}`);
+                return;
+            }
+            const r = await store.resolve(q);
+            if (!r) {
+                appendLine(`${C_ERROR}未找到智能体: '${q}'${RESET} (可用 /channel 查看列表)`);
+                return;
+            }
+            const prev = await store.getActive();
+            await store.setActive(r.channel.id);
+            cliAgentName = r.identity.name;
+            cliActiveChannelId = r.channel.id;
+            inkSetStatus(getStatus()); // 触发状态栏立即重绘 (无需等 1s 定时器)
+            const extra = prev && prev.name !== r.identity.name ? ` (从 ${prev.name} 切换)` : '';
+            appendLine(`${C_ACCENT}→ 当前智能体: ${r.identity.name}${RESET}${extra}`);
+            appendLine(`${C_DIM}  channel: ${r.channel.id}  [${r.match}]${RESET}`);
+            appendLine(`${C_DIM}  persona: ${r.channel.persona?.description || r.channel.persona?.personality || '无'}${RESET}`);
+        }
+        catch (e) {
+            appendLine(`${C_ERROR}/channel 失败: ${String(e.message || e).slice(0, 200)}${RESET}`);
+        }
+        return;
+    }
     // /queue — 切换队列模式
     if (trimmed.toLowerCase() === '/queue') {
         queueMode = !queueMode;
@@ -493,6 +586,7 @@ async function processInput(input, comm) {
         appendLine(`  ${C_ACCENT}!<cmd>${RESET}  执行终端命令  ${C_DIM}如 !ls -la${RESET}`);
         appendLine(`  ${C_ACCENT}/queue${RESET}  切换队列模式  ${C_DIM}输入排队, 当前结束后自动执行${RESET}`);
         appendLine(`  ${C_ACCENT}/dequeue${RESET} 出队一条`);
+        appendLine(`  ${C_ACCENT}/channel [名字|id|序号]${RESET} 切换当前智能体  ${C_DIM}无参列出所有; 支持名字/ID/序号三种解析${RESET}`);
         appendLine(`  ${C_ACCENT}@名字${RESET}     @ 命中智能体  ${C_DIM}弹出窗选择后发送给智能体${RESET}`);
         appendLine(`  ${C_ACCENT}/名字${RESET}     / 命中命令/技能/插件  ${C_DIM}输入 / 自动弹出${RESET}`);
         appendLine(`  ${C_ACCENT}#路径${RESET}     # 命中文件  ${C_DIM}输入 # 自动弹出文件列表${RESET}`);
@@ -617,14 +711,31 @@ async function processInput(input, comm) {
                 catch { /* 非致命, 静默 */ }
             });
         }
-        // 更新状态栏: 上下文进度
+        // 更新状态栏: 上下文进度 (2026-08-06: 每轮按当前 messageHistory 重算并写回 ContextManager,
+        //   保证状态栏按需更新 — 不依赖 pi-sdk loop 内部上报, 1s 定时器读到的一定是最新值)
         try {
-            const msgLen = JSON.stringify(a.messageHistory ?? []).length;
-            cliContextPct = Math.min(100, Math.round((msgLen / 240_000) * 100));
-            const barLen = 12;
-            const filled = Math.round((cliContextPct / 100) * barLen);
-            const bar = '█'.repeat(filled) + '░'.repeat(barLen - filled);
-            const statusText = `${C_ACCENT}${cliModelName}\x1b[0m\x1b[90m  │\x1b[0m ${cliAgentName} \x1b[90m│\x1b[0m ⏱ ${fmtDuration(Date.now() - cliStartTime)} \x1b[90m│\x1b[0m ${msgLen.toLocaleString()}B/240K │ ${bar} ${cliContextPct}%`;
+            const { getContextManager } = await import('./bootstrap/context-manager.js');
+            const cm = getContextManager();
+            // 用 context-compaction 的估算器 (与 pi-sdk estimateHistoryTokens 同源: 4 字符 ≈ 1 token)
+            const history = a.messageHistory ?? [];
+            let usedTokens = 0;
+            try {
+                const { estimateTokens } = require('./context-compaction/index.js');
+                usedTokens = estimateTokens(history);
+            }
+            catch {
+                usedTokens = Math.max(0, Math.round(JSON.stringify(history).length / 4));
+            }
+            // 写回数据源 — 状态栏/Web/任何订阅方都拿到新鲜值
+            const usage = cm.updateUsage(usedTokens);
+            const usageView = {
+                // 保留浮点 (0-100), buildContextBar 内部格式化
+                pct: Math.min(100, (usage.usedTokens / Math.max(1, usage.maxTokens)) * 100),
+                usedTokens: usage.usedTokens,
+                maxTokens: usage.maxTokens,
+                stage: usage.stage,
+            };
+            const statusText = `${C_ACCENT}${cliModelName}${RESET}${C_DIM}  │${RESET} ${cliAgentName} ${C_DIM}│${RESET} ⏱ ${fmtDuration(Date.now() - cliStartTime)}${C_DIM} │${RESET} ${buildContextBar(usageView)}`;
             inkSetStatus(statusText);
         }
         catch { /* 降级容忍 */ }

package/dist/orbitdb/agent-tools.js

@@ -0,0 +1,225 @@
+/**
+ * agent-tools.ts — OrbitDB/CID 数据层的 agent 工具注册 (2026-08-06)
+ *
+ * 注册 10 个工具 (懒加载: 首次调用才拉起 helia, 不阻塞启动):
+ *   cid_save / cid_load / cid_update / cid_version / cid_list / cid_share
+ *   context_save_snapshot / context_restore
+ *   ui_save_component / ui_load_component
+ *
+ * 对应 Step 7 能力: agent.createMemory (cid_save type=memory),
+ *   context.saveSnapshot (context_save_snapshot), ui.loadCID (ui_load_component),
+ *   share(cid) (cid_share).
+ */
+/** 包装: 动态 import cid-database (首调拉起 helia) */
+async function db() {
+    const { getCIDDatabase } = await import('./cid-database.js');
+    return getCIDDatabase();
+}
+async function contextStore() {
+    const { getContextStore } = await import('./context-store.js');
+    return getContextStore();
+}
+async function uiStore() {
+    const { getUICidStore } = await import('./ui-cid.js');
+    return getUICidStore();
+}
+const fmt = (o) => JSON.stringify(o, null, 2).slice(0, 3000);
+export function registerOrbitdbTools(ctx) {
+    ctx.tools.set('cid_save', {
+        name: 'cid_save',
+        description: '保存数据到去中心化数据库 (OrbitDB), 返回内容寻址 CID. type 支持 memory/context/state/ui/knowledge. 同内容同 CID, 可用 cid_load 读回、cid_share 分享、cid_update 更新版本.',
+        parameters: { agentId: '所属智能体 id (必填)', type: '记录类型: memory/context/state/ui/knowledge (必填)', content: '要保存的数据 (JSON 对象, 必填)', metadata: '可选元数据 (JSON 对象)' },
+        execute: async (args) => {
+            try {
+                const agentId = String(args.agentId || '').trim();
+                const type = String(args.type || '').trim();
+                if (!agentId || !type)
+                    return { success: false, error: 'agentId 和 type 必填' };
+                const content = args.content ?? {};
+                const metadata = typeof args.metadata === 'object' && args.metadata ? args.metadata : undefined;
+                const rec = await (await db()).save({ agentId, type: type, content, metadata });
+                return { success: true, output: `✅ 已保存 (type=${type}):\n  CID: ${rec.id}\n  version: ${rec.version}\n  读回: cid_load(cid="${rec.id}")\n  分享: cid_share(cid="${rec.id}")` };
+            }
+            catch (e) {
+                return { success: false, error: `cid_save 失败: ${String(e.message || e).slice(0, 200)}` };
+            }
+        }
+    });
+    ctx.tools.set('cid_load', {
+        name: 'cid_load',
+        description: '按 CID 从去中心化数据库加载记录 (含跨节点分享的). 返回完整记录: id/agentId/timestamp/type/content/metadata/version.',
+        parameters: { cid: '记录 CID (必填)' },
+        execute: async (args) => {
+            try {
+                const cid = String(args.cid || '').trim();
+                if (!cid)
+                    return { success: false, error: 'cid 必填' };
+                const rec = await (await db()).load(cid);
+                if (!rec)
+                    return { success: false, error: `记录不存在: ${cid}` };
+                return { success: true, output: `📄 ${cid}\n${fmt(rec)}` };
+            }
+            catch (e) {
+                return { success: false, error: `cid_load 失败: ${String(e.message || e).slice(0, 200)}` };
+            }
+        }
+    });
+    ctx.tools.set('cid_update', {
+        name: 'cid_update',
+        description: '更新记录 → 生成新版本 (parentId 指向旧 CID). 用 cid_version 查看版本链.',
+        parameters: { cid: '旧记录 CID (必填)', content: '新内容 (JSON, 必填)', metadata: '可选新元数据' },
+        execute: async (args) => {
+            try {
+                const cid = String(args.cid || '').trim();
+                if (!cid)
+                    return { success: false, error: 'cid 必填' };
+                const rec = await (await db()).update(cid, args.content ?? {}, typeof args.metadata === 'object' && args.metadata ? args.metadata : undefined);
+                if (!rec)
+                    return { success: false, error: `记录不存在: ${cid}` };
+                return { success: true, output: `✅ 已更新 v${rec.version}:\n  新 CID: ${rec.id}\n  版本链: cid_version(cid="${rec.id}")` };
+            }
+            catch (e) {
+                return { success: false, error: `cid_update 失败: ${String(e.message || e).slice(0, 200)}` };
+            }
+        }
+    });
+    ctx.tools.set('cid_version', {
+        name: 'cid_version',
+        description: '查看记录的完整版本链 (从旧到新).',
+        parameters: { cid: '任意版本 CID (必填)' },
+        execute: async (args) => {
+            try {
+                const cid = String(args.cid || '').trim();
+                if (!cid)
+                    return { success: false, error: 'cid 必填' };
+                const chain = await (await db()).version(cid);
+                if (chain.length === 0)
+                    return { success: false, error: `记录不存在: ${cid}` };
+                return { success: true, output: `📚 版本链 (${chain.length} 个版本):\n${chain.map(r => `  v${r.version} ${r.id} ${new Date(r.timestamp).toISOString()}${r.parentId ? '' : ' (根)'}`).join('\n')}` };
+            }
+            catch (e) {
+                return { success: false, error: `cid_version 失败: ${String(e.message || e).slice(0, 200)}` };
+            }
+        }
+    });
+    ctx.tools.set('cid_list', {
+        name: 'cid_list',
+        description: '列出数据库记录 (可按 agentId / type 过滤). 适合查看某个智能体的全部记忆/状态/组件.',
+        parameters: { agentId: '可选: 按智能体过滤', type: '可选: 按类型过滤 (memory/context/state/ui/knowledge)' },
+        execute: async (args) => {
+            try {
+                const agentId = String(args.agentId || '').trim() || undefined;
+                const type = String(args.type || '').trim() || undefined;
+                const list = await (await db()).list({ agentId, type });
+                if (list.length === 0)
+                    return { success: true, output: '📭 无记录' };
+                return { success: true, output: `📋 ${list.length} 条记录:\n${list.slice(-20).map(r => `  v${r.version} [${r.type}] ${r.id.slice(0, 24)}… ${new Date(r.timestamp).toISOString().slice(0, 19)}`).join('\n')}` };
+            }
+            catch (e) {
+                return { success: false, error: `cid_list 失败: ${String(e.message || e).slice(0, 200)}` };
+            }
+        }
+    });
+    ctx.tools.set('cid_share', {
+        name: 'cid_share',
+        description: '分享记录: 把记录块写入 IPFS 网络 (helia blockstore), 返回 bolloon-cid:// 引用, 其他节点可用 cid_load 拉取.',
+        parameters: { cid: '记录 CID (必填)' },
+        execute: async (args) => {
+            try {
+                const cid = String(args.cid || '').trim();
+                if (!cid)
+                    return { success: false, error: 'cid 必填' };
+                const ref = await (await db()).share(cid);
+                return { success: true, output: `🔗 已分享: ${ref}` };
+            }
+            catch (e) {
+                return { success: false, error: `cid_share 失败: ${String(e.message || e).slice(0, 200)}` };
+            }
+        }
+    });
+    ctx.tools.set('context_save_snapshot', {
+        name: 'context_save_snapshot',
+        description: '保存 Context OS 快照: 抓取当前资产层 + 可选记忆摘要/focus → CID 版本化. 用 context_restore 恢复.',
+        parameters: { agentId: '智能体 id (必填)', memorySummary: '可选: 当前记忆摘要', focus: '可选: 当前 focus' },
+        execute: async (args) => {
+            try {
+                const agentId = String(args.agentId || '').trim();
+                if (!agentId)
+                    return { success: false, error: 'agentId 必填' };
+                const store = await contextStore();
+                const snap = await store.captureCurrentContext(agentId, {
+                    memorySummary: String(args.memorySummary || '').trim() || undefined,
+                    focus: String(args.focus || '').trim() || undefined,
+                });
+                const rec = await store.saveSnapshot(snap);
+                return { success: true, output: `📸 Context 快照已保存:\n  CID: ${rec.id}\n  layers: ${Object.keys(snap.layers).filter(k => snap.layers[k].length).length} 层有资产\n  恢复: context_restore(agentId="${agentId}")` };
+            }
+            catch (e) {
+                return { success: false, error: `context_save_snapshot 失败: ${String(e.message || e).slice(0, 200)}` };
+            }
+        }
+    });
+    ctx.tools.set('context_restore', {
+        name: 'context_restore',
+        description: '恢复某智能体最近一次 Context 快照 (含资产层/记忆摘要/focus). 用于跨会话恢复上下文.',
+        parameters: { agentId: '智能体 id (必填)' },
+        execute: async (args) => {
+            try {
+                const agentId = String(args.agentId || '').trim();
+                if (!agentId)
+                    return { success: false, error: 'agentId 必填' };
+                const snap = await (await contextStore()).restoreContext(agentId);
+                if (!snap)
+                    return { success: false, error: `无快照: ${agentId}` };
+                return { success: true, output: `♻️ 已恢复 ${agentId} 的 Context 快照 (${new Date(snap.capturedAt).toISOString()}):\n${fmt(snap).slice(0, 2500)}` };
+            }
+            catch (e) {
+                return { success: false, error: `context_restore 失败: ${String(e.message || e).slice(0, 200)}` };
+            }
+        }
+    });
+    ctx.tools.set('ui_save_component', {
+        name: 'ui_save_component',
+        description: '保存 UI 组件到去中心化存储 (CID 化). code 是 React 函数组件源码 (function Name(props){ return React.createElement(...) }), framework 默认 react. 之后可用 ui_load_component 按 CID 动态加载渲染.',
+        parameters: { agentId: '智能体 id (必填)', name: '组件名 (必填)', code: 'React 组件源码 (必填)', framework: '可选: react/vanilla', theme: '可选: 主题 JSON', description: '可选: 组件说明' },
+        execute: async (args) => {
+            try {
+                const agentId = String(args.agentId || '').trim();
+                const name = String(args.name || '').trim();
+                const code = String(args.code || '').trim();
+                if (!agentId || !name || !code)
+                    return { success: false, error: 'agentId/name/code 必填' };
+                const rec = await (await uiStore()).saveComponent(agentId, {
+                    name,
+                    code,
+                    framework: args.framework === 'vanilla' ? 'vanilla' : 'react',
+                    theme: typeof args.theme === 'object' && args.theme ? args.theme : undefined,
+                    description: String(args.description || '').trim() || undefined,
+                });
+                return { success: true, output: `🖼️ UI 组件已保存: ${name}\n  CID: ${rec.id}\n  加载: ui_load_component(cid="${rec.id}")` };
+            }
+            catch (e) {
+                return { success: false, error: `ui_save_component 失败: ${String(e.message || e).slice(0, 200)}` };
+            }
+        }
+    });
+    ctx.tools.set('ui_load_component', {
+        name: 'ui_load_component',
+        description: '按 CID 加载 UI 组件定义 (代码/theme/propsSchema). 配合 React 前端可动态渲染.',
+        parameters: { cid: '组件 CID (必填)' },
+        execute: async (args) => {
+            try {
+                const cid = String(args.cid || '').trim();
+                if (!cid)
+                    return { success: false, error: 'cid 必填' };
+                const def = await (await uiStore()).loadComponent(cid);
+                if (!def)
+                    return { success: false, error: `组件不存在: ${cid}` };
+                return { success: true, output: `🖼️ ${def.name} (${def.framework})\n  CID: ${cid}\n  theme: ${def.theme ? fmt(def.theme) : '无'}\n  code:\n${String(def.code).slice(0, 1500)}` };
+            }
+            catch (e) {
+                return { success: false, error: `ui_load_component 失败: ${String(e.message || e).slice(0, 200)}` };
+            }
+        }
+    });
+}