@bolloon/bolloon-agent 0.5.2 → 0.5.4

package/dist/agents/pi-sdk-tools.js

@@ -1,4 +1,5 @@
 import * as fs from 'fs/promises';
+import { loadWalletTool } from './wallet-tools.js';
 import * as fsSync from 'fs';
 import * as path from 'path';
 import { currentPackageRoot } from '../utils/version-info.js';
@@ -2980,13 +2981,16 @@ export function registerBuiltinTools(ctx) {
                 const { KeyManager } = await import('@diap/sdk');
                 const kp = KeyManager.fromPrivateKey(Buffer.from(identity.privateKey, 'hex'));
                 const displayName = args.name ? String(args.name) : agentId || 'bolloon-agent';
-                // 1. 确保本地 Kubo (自动安装 + 启动)
+                // 1. 确保本地 Kubo (自动安装 + 启动) —— **已经在跑就别调 SDK 那次注定失败的 init**
+                //    (`sdk` 后面发布 IPNS 还要用, 所以模块导入留在函数作用域, 只把这一次调用关进短路里)
                 const sdk = await import('@diap/sdk');
-                const checkKuboSetup = sdk.checkKuboSetup;
-                if (typeof checkKuboSetup === 'function') {
-                    const setup = await checkKuboSetup(true, true);
-                    if (!setup?.ready || !setup?.daemonRunning) {
-                        return { success: false, error: '本地 Kubo 不可用 (自动安装失败), 无法发布到 IPFS' };
+                if (!(await kuboAlreadyRunning())) {
+                    const checkKuboSetup = sdk.checkKuboSetup;
+                    if (typeof checkKuboSetup === 'function') {
+                        const setup = await checkKuboSetup(true, true);
+                        if (!setup?.ready || !setup?.daemonRunning) {
+                            return { success: false, error: '本地 Kubo 不可用 (自动安装失败), 无法发布到 IPFS' };
+                        }
                     }
                 }
                 // 2. 注册 agent → 上传 DID 文档 → CID
@@ -3443,7 +3447,26 @@ export function registerBuiltinTools(ctx) {
 }
 // ─── IPFS/IPNS 通用 helper (2026-08-04) ─────────────────────────────────────
 // 复用 publish_did 的 checkKuboSetup 自动安装/启动本地 Kubo (darwin-arm64 v0.28.0)
+/**
+ * Kubo 本地节点已经在跑吗 (只读探测: POST /api/v0/version —— Kubo 只接受 POST).
+ *
+ * 2026-09-30 新增 (leo 报「开启过程的日志没去掉」): SDK 的 `checkKuboSetup(true, true)` 即使守护进程
+ * 已经在跑, 仍会跑一遍 `ipfs init` ⇒ 抛 "daemon is running" ⇒ **打一行 [warn](消息里含"失败"二字,
+ * 于是被启动日志门按"错误不许被吞"放行到屏上)** 外加子进程输出, 两行都落在启动面板之前.
+ * 启动路径上所有调用点都先用这个探测短路: 已经在跑就没有任何可装配的.
+ */
+export async function kuboAlreadyRunning(timeoutMs = 1500) {
+    try {
+        await kuboApi('/api/v0/version', undefined, timeoutMs);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
 export async function ensureKuboReady() {
+    if (await kuboAlreadyRunning())
+        return; // 已在跑 ⇒ 没有可装配的, 也别触发那次注定失败的 init
     const sdk = await import('@diap/sdk');
     const checkKuboSetup = sdk.checkKuboSetup;
     if (typeof checkKuboSetup === 'function') {
@@ -3483,9 +3506,24 @@ export function registerWalletTools(ctx) {
         parameters: {},
         execute: async () => {
             try {
-                const { createWallet } = await import('../constraint-runtime/dist/tools/WalletTools/createWallet.js').catch(() => import('../constraint-runtime/src/tools/WalletTools/createWallet.js'));
+                const { createWallet } = await loadWalletTool('createWallet');
                 const r = await createWallet();
-                return { success: true, output: `✅ 钱包创建成功:\n  address: ${r.address}\n  privateKey: ${r.privateKey}\n  mnemonic: ${r.mnemonic}\n  createdAt: ${r.createdAt}` };
+                // 2026-09-30: **落台账** (以前只生成不存 ⇒ /wallet 永远「钱包 (0)」)。
+                //   落 ~/.bolloon/wallets/<名字>.json (0600); 输出只给地址 + 路径, 私钥/助记词不回显。
+                let savedPath = '';
+                try {
+                    const { addWallet } = await import('../cli/wallet-store.js');
+                    const { file } = await addWallet({
+                        name: `agent-${new Date().toISOString().slice(0, 19).replace(/[:T]/g, '')}`,
+                        address: r.address, network: '—', source: 'created',
+                        createdAt: r.createdAt || new Date().toISOString(), privateKey: r.privateKey, mnemonic: r.mnemonic,
+                    });
+                    savedPath = file;
+                }
+                catch (e) {
+                    return { success: true, output: `⚠️ 钱包已生成但**没落台账**: ${String(e?.message || e).slice(0, 120)}\n  address: ${r.address}\n  (私钥只在本次输出里, 请立刻自己存好)` };
+                }
+                return { success: true, output: `✅ 钱包创建成功 (已落台账)\n  address: ${r.address}\n  台账: ${savedPath} (0600 — 私钥/助记词已存, 不回显)\n  createdAt: ${r.createdAt}` };
             }
             catch (e) {
                 return { success: false, error: `创建失败: ${String(e.message || e)}` };
@@ -3498,9 +3536,23 @@ export function registerWalletTools(ctx) {
         parameters: { mnemonic: '可选, 12/15/18/21/24 词助记词', privateKey: '可选, 0x 开头的私钥' },
         execute: async (args) => {
             try {
-                const { importWallet } = await import('../constraint-runtime/dist/tools/WalletTools/importWallet.js').catch(() => import('../constraint-runtime/src/tools/WalletTools/importWallet.js'));
+                const { importWallet } = await loadWalletTool('importWallet');
                 const r = await importWallet({ mnemonic: args.mnemonic, privateKey: args.privateKey });
-                return { success: true, output: `✅ 钱包导入成功:\n  address: ${r.address}\n  privateKey: ${r.privateKey}\n  source: ${r.source}` };
+                // 2026-09-30: 同 wallet_create —— 导入也落台账 (0600), 输出不回显私钥
+                let impPath = '';
+                try {
+                    const { addWallet } = await import('../cli/wallet-store.js');
+                    const { file } = await addWallet({
+                        name: `imported-${new Date().toISOString().slice(0, 19).replace(/[:T]/g, '')}`,
+                        address: r.address, network: '—', source: 'imported',
+                        createdAt: new Date().toISOString(), privateKey: args.privateKey, mnemonic: args.mnemonic,
+                    });
+                    impPath = file;
+                }
+                catch (e) {
+                    return { success: true, output: `⚠️ 钱包已导入但**没落台账**: ${String(e?.message || e).slice(0, 120)}\n  address: ${r.address}\n  (私钥请自己存好, 不会再有第二遍)` };
+                }
+                return { success: true, output: `✅ 钱包导入成功 (已落台账)\n  address: ${r.address}\n  台账: ${impPath} (0600 — 私钥已存, 不回显)\n  source: ${r.source}` };
             }
             catch (e) {
                 return { success: false, error: `导入失败: ${String(e.message || e)}` };
@@ -3513,7 +3565,7 @@ export function registerWalletTools(ctx) {
         parameters: { address: '0x 开头的 EVM 地址 (必填)', rpcUrl: '可选 RPC URL (默认 eth.llamarpc.com)' },
         execute: async (args) => {
             try {
-                const { getBalance } = await import('../constraint-runtime/dist/tools/WalletTools/getBalance.js').catch(() => import('../constraint-runtime/src/tools/WalletTools/getBalance.js'));
+                const { getBalance } = await loadWalletTool('getBalance');
                 const r = await getBalance({ address: String(args.address), rpcUrl: args.rpcUrl });
                 return { success: true, output: `💰 ${r.address}\n  ${r.balanceEth} ${r.symbol} (${r.balance} wei)` };
             }
@@ -3528,7 +3580,7 @@ export function registerWalletTools(ctx) {
         parameters: { message: '要签名的消息 (必填)', privateKey: '0x 开头的私钥 (必填)' },
         execute: async (args) => {
             try {
-                const { signMessage } = await import('../constraint-runtime/dist/tools/WalletTools/signMessage.js').catch(() => import('../constraint-runtime/src/tools/WalletTools/signMessage.js'));
+                const { signMessage } = await loadWalletTool('signMessage');
                 const r = await signMessage({ message: String(args.message), privateKey: String(args.privateKey) });
                 return { success: true, output: `✅ 签名完成:\n  address: ${r.address}\n  message: ${r.message}\n  signature: ${r.signature}` };
             }
@@ -3543,7 +3595,7 @@ export function registerWalletTools(ctx) {
         parameters: { privateKey: '私钥 (必填)', to: '接收地址 (必填)', value: '发送 wei 数量 (必填)', data: '可选 0x 开头的 calldata', rpcUrl: '可选 RPC URL' },
         execute: async (args) => {
             try {
-                const { sendTransaction } = await import('../constraint-runtime/dist/tools/WalletTools/sendTransaction.js').catch(() => import('../constraint-runtime/src/tools/WalletTools/sendTransaction.js'));
+                const { sendTransaction } = await loadWalletTool('sendTransaction');
                 const r = await sendTransaction({
                     privateKey: String(args.privateKey),
                     to: String(args.to),
@@ -3564,7 +3616,7 @@ export function registerWalletTools(ctx) {
         parameters: { privateKey: '私钥 (必填)', tokenAddress: 'ERC20 合约地址 (必填)', to: '接收地址 (必填)', amount: 'token 数量', decimals: '可选 token decimals', rpcUrl: '可选 RPC URL' },
         execute: async (args) => {
             try {
-                const { transferToken } = await import('../constraint-runtime/dist/tools/WalletTools/transferToken.js').catch(() => import('../constraint-runtime/src/tools/WalletTools/transferToken.js'));
+                const { transferToken } = await loadWalletTool('transferToken');
                 const r = await transferToken({
                     privateKey: String(args.privateKey),
                     tokenAddress: String(args.tokenAddress),
@@ -3586,7 +3638,7 @@ export function registerWalletTools(ctx) {
         parameters: { from: '付款方地址 (必填)', to: '收款方地址 (必填)', amount: '金额 (必填)', interval: '周期 (e.g. daily/weekly/monthly)', token: '可选, 默认 ETH' },
         execute: async (args) => {
             try {
-                const mod = await import('../constraint-runtime/dist/tools/WalletTools/autoPay.js').catch(() => import('../constraint-runtime/src/tools/WalletTools/autoPay.js'));
+                const mod = await loadWalletTool('autoPay');
                 const fn = mod.autoPay || mod.setAutoPay || mod.default;
                 if (!fn)
                     return { success: false, error: 'autoPay 接口未找到' };

package/dist/agents/pi-sdk.js

@@ -466,7 +466,13 @@ export class PiAgentSession {
             }
         }
         catch (err) {
-            console.warn(`[PiAgent] hydrateMessageHistory 失败 (non-fatal): ${err.message?.slice(0, 100)}`);
+            // 2026-09-30: "会话文件不存在" 不是失败 —— 新 channel / 还没落过盘的会话就是这种情况
+            //   (真机噪声: `hydrateMessageHistory 失败 (non-fatal): session not found: ch_bolloon:default`)。
+            //   只有**非** not-found 的错误才值得 warn。
+            const __msg = String(err?.message || err);
+            if (!/session not found|ENOENT/i.test(__msg)) {
+                console.warn(`[PiAgent] hydrateMessageHistory 失败 (non-fatal): ${__msg.slice(0, 100)}`);
+            }
         }
     }
     /**

package/dist/agents/session-store.js

@@ -102,6 +102,59 @@ export class SessionStore {
      * fs.writeFile 抛 EINVAL. 修法: filename 层 escape `:` → `__`, key 保持不变
      * (load/save/listKeys/deleteKey 全部透明).
      */
+    /**
+     * **写**的时候用这个 —— 与 resolveExisting 的区别: 不存在**不抛错**, 返回规范路径 (等于新建)。
+     *
+     * 2026-09-30 回归事故: 我把 resolveExisting (读语义, 不存在就抛 not found) 批量替换进了
+     *   saveMessages ⇒ 退出存档对"还没落盘的新会话"直接抛 `session not found`
+     *   (leo 贴的 `⚠ session 存档失败: SessionStore: session not found: 20260930_175348_870c70`)。
+     *   写路径必须容忍"还没有文件" —— 那正是它要创建的东西。
+     */
+    async resolveWritePath(key) {
+        const canonical = this.pathFor(key);
+        try {
+            await fs.access(canonical);
+            return canonical;
+        }
+        catch { /* 试老名 */ }
+        const legacy = path.join(this.cacheDir, `${key}.json`);
+        try {
+            await fs.access(legacy);
+            return legacy;
+        }
+        catch { /* 新会话 */ }
+        return canonical;
+    }
+    /**
+     * 读的时候用这个 —— 兼容**老文件名**。
+     *
+     * 2026-09-30 发现: 早期版本直接把 `channelId:sessionId` 当文件名写盘 (`real-123:default.json`),
+     *   后来 Windows 兼容改成 filenameEscape (`:` → `__`), 但**老文件没迁移** ⇒ 用 pathFor 去读
+     *   老会话一律 ENOENT (`/sessions` 里那些 `real-*:default` 全是 Preview `—`, 也续不上)。
+     *   这里: 先试新名, 不存在再试老名; 老名存在时**顺手迁移**成新名 (迁移失败就继续读老名)。
+     */
+    async resolveExisting(key) {
+        const canonical = this.pathFor(key);
+        try {
+            await fs.access(canonical);
+            return canonical;
+        }
+        catch { /* 试老名 */ }
+        const legacy = path.join(this.cacheDir, `${key}.json`);
+        try {
+            await fs.access(legacy);
+            try {
+                await fs.rename(legacy, canonical);
+            }
+            catch {
+                return legacy;
+            } // 迁移失败也能读
+            return canonical;
+        }
+        catch {
+            throw new Error(`SessionStore: session not found: ${key}`);
+        }
+    }
     pathFor(key) {
         if (!key || key.includes('/') || key.includes('..')) {
             throw new Error(`SessionStore: invalid key ${JSON.stringify(key)}`);
@@ -135,7 +188,7 @@ export class SessionStore {
                 totalCount: messages.length,
             },
         };
-        const filePath = this.pathFor(key);
+        const filePath = await this.resolveWritePath(key); // 写路径: 新会话就建 (不抛 not found)
         const tmpPath = `${filePath}.tmp`;
         await fs.writeFile(tmpPath, JSON.stringify(payload, null, 2), 'utf-8');
         await fs.rename(tmpPath, filePath);
@@ -177,7 +230,7 @@ export class SessionStore {
                 totalCount: messages.length,
             },
         };
-        const filePath = this.pathFor(key);
+        const filePath = this.pathFor(key); // 同步保存一律写规范文件名
         const tmpPath = `${filePath}.tmp`;
         fsSyncWrite(tmpPath, JSON.stringify(payload, null, 2));
         fsSyncRename(tmpPath, filePath);
@@ -192,7 +245,11 @@ export class SessionStore {
         if (!key || key.includes('/') || key.includes('..')) {
             throw new Error(`SessionStore: invalid key ${JSON.stringify(key)}`);
         }
-        const filePath = this.pathFor(key);
+        // 2026-09-30 回归修复: 读路径**不许**在"会话不存在"时抛错 —— 仓里的契约是
+        //   `loadMessages('cli:nonexistent') === null` (见 src/test/session-store.test.ts)。
+        //   用容错解析 (不存在 ⇒ 返回规范路径), 随后的 readFile 命中 ENOENT ⇒ return null。
+        //   老文件名(`real-123:default.json` 那批)由 resolveWritePath 兼容: 存在就返回老路径。
+        const filePath = await this.resolveWritePath(key);
         let raw;
         try {
             raw = await fs.readFile(filePath, 'utf-8');
@@ -222,6 +279,90 @@ export class SessionStore {
             return [];
         }
     }
+    /**
+     * 列最近改动的会话 (按 mtime 倒序), 带条数与首条用户消息预览。
+     *
+     * 2026-09-30 (leo: 「/session 没有反应, 没展示最新记录, 无法选择继续」): 只为"选一个继续"服务 ——
+     *   **只解析最新的 limit 个文件**(缓存目录可能上千个, 全量解析会卡住输入), 解析失败的那条如实记 0。
+     */
+    async listRecent(limit = 10) {
+        const out = [];
+        let files = [];
+        try {
+            files = await fs.readdir(this.cacheDir);
+        }
+        catch {
+            return out;
+        }
+        const cands = [];
+        for (const f of files) {
+            if (!f.endsWith('.json') || f.endsWith('.tmp'))
+                continue;
+            try {
+                const st = await fs.stat(path.join(this.cacheDir, f));
+                cands.push({ key: SessionStore.filenameUnescape(f.slice(0, -'.json'.length)), mtimeMs: st.mtimeMs });
+            }
+            catch { /* 单条 stat 失败跳过 */ }
+        }
+        cands.sort((a, b) => b.mtimeMs - a.mtimeMs);
+        for (const c of cands.slice(0, Math.max(1, limit))) {
+            let messages = 0;
+            let preview = '';
+            let title = c.key; // 会话文件里没有 title 字段 ⇒ 默认就是 key (web 侧才有会话名)
+            try {
+                // 兼容老文件名 (`real-123:default.json` 未转义那批) —— 读不到规范名就试原名
+                let text = '';
+                try {
+                    text = await fs.readFile(this.pathFor(c.key), 'utf-8');
+                }
+                catch {
+                    text = await fs.readFile(path.join(this.cacheDir, `${c.key}.json`), 'utf-8');
+                }
+                const raw = JSON.parse(text);
+                const arr = Array.isArray(raw) ? raw : (raw?.messages || []);
+                messages = Array.isArray(arr) ? arr.length : 0;
+                const md = (!Array.isArray(raw) && raw?.metadata) || {};
+                if (typeof md.title === 'string' && md.title.trim())
+                    title = md.title.trim();
+                const mdPreview = typeof md.preview === 'string' ? md.preview.trim() : '';
+                // 预览要用**真实用户话**, 跳过自动注入的上下文块 (否则全是 <!-- current-turn … -->)
+                const isInjected = (x) => !!x && (/^<!--/.test(x.trim()) || /^#\s*你的项目上下文/.test(x.trim()) || /^\[cron\]/.test(x.trim()));
+                const first = (Array.isArray(arr) ? arr : []).find((m) => m && m.role === 'user' && m.content && !isInjected(String(m.content)));
+                preview = mdPreview || String(first?.content || '').replace(/\s+/g, ' ').trim().slice(0, 120);
+            }
+            catch { /* 损坏文件: 仍列出, 只是 0 条无预览 */ }
+            out.push({ key: c.key, title, mtimeMs: c.mtimeMs, messages, preview });
+        }
+        return out;
+    }
+    /**
+     * 合并写回会话文件的 metadata (原子: 先写 .tmp 再 rename)。
+     *   2026-09-30 (leo: 「Title/Preview 要有内容, 使用 AI 来总结进去」): AI 总结结果落在
+     *   `metadata.{title,preview,summarizedAt}`, **只算一次**, 后续 /sessions 直接读。
+     *   原子写是硬要求 —— 会话文件是用户的会话历史, 半截文件比没有标题糟得多。
+     */
+    async updateMetadata(key, patch) {
+        if (!key || key.includes('/') || key.includes('..'))
+            throw new Error(`SessionStore: invalid key ${JSON.stringify(key)}`);
+        const file = await this.resolveWritePath(key);
+        let raw = null;
+        try {
+            raw = JSON.parse(await fs.readFile(file, 'utf-8'));
+        }
+        catch (e) {
+            if (e?.code !== 'ENOENT')
+                throw new Error(`会话文件读不了 (${file}): ${String(e?.message || e).slice(0, 120)}`);
+            // 还没有文件 ⇒ 建成只有 metadata 的会话 (元数据更新对新会话应当有效, 不是错误)
+        }
+        const next = raw === null
+            ? { key, messages: [], metadata: { ...patch } }
+            : Array.isArray(raw)
+                ? { key, messages: raw, metadata: { ...patch } }
+                : { ...raw, metadata: { ...(raw?.metadata || {}), ...patch } };
+        const tmp = `${file}.tmp`;
+        await fs.writeFile(tmp, JSON.stringify(next, null, 2), 'utf-8');
+        await fs.rename(tmp, file);
+    }
     /** 删一条 session — 失败抛错. */
     async deleteKey(key) {
         if (!key || key.includes('/') || key.includes('..')) {

package/dist/agents/wallet-tools.js

@@ -0,0 +1,63 @@
+/**
+ * wallet-tools.ts — 钱包工具的**双布局加载器** (2026-09-30)
+ *
+ * 为什么要有这个文件:
+ *   钱包真身是 `constraint-runtime` 里的 `tools/WalletTools/*`。构建 (`npm run build:main` =
+ *   `tsc && node scripts/copy-constraint-runtime.mjs`) 把 `src/constraint-runtime/dist/*`
+ *   复制成 `dist/constraint-runtime/*` —— **少一层 `dist/`**。于是同一句相对导入:
+ *       `../constraint-runtime/dist/tools/WalletTools/createWallet.js`
+ *   在源码态 (src/agents) 能解析 ✓, 构建后 (dist/agents) 解析到 `dist/constraint-runtime/dist/…` ✗
+ *   ⇒ `wallet_create` 报 `Cannot find module '…/dist/constraint-runtime/src/tools/…'` (leo 2026-09-30 贴的屏),
+ *   而 `/wallet` 又因为"从来没写过文件"显示「钱包 (0)」—— 两个毛病叠在一起, 看着像"钱包功能不存在"。
+ *
+ * 规则: **按存在的路径挑**, 挑不到就抛错并**列出试过的路径** (不许含糊成"未知错误")。
+ * 注意: 这里用**变量**给 `import()` ⇒ 不做静态解析 (跨布局本来就不能静态解析)。
+ */
+import * as path from 'path';
+import { pathToFileURL } from 'url';
+// 2026-09-30: 不用 import.meta —— 本文件会被 electron 那条 CJS 链间接引到,
+//   `tsc -p tsconfig.electron.json` 会报 TS1343 (module: CommonJS 下不允许 import.meta),
+//   而 `npm publish` 的 prepublishOnly (build:all → build:electron) 会因此挂住。
+//   仓里现成的替代: cjsModuleDir() (CJS/ESM 都能用) + currentPackageRoot() + firstExisting()。
+import { cjsModuleDir, firstExisting } from '../utils/module-context.js';
+import { currentPackageRoot } from '../utils/version-info.js';
+/** 候选路径 (先近后远; 覆盖 dev / dist 两种布局) */
+export function walletToolCandidates(name) {
+    const root = (() => { try {
+        return currentPackageRoot();
+    }
+    catch {
+        return process.cwd();
+    } })();
+    const here = cjsModuleDir() || path.join(root, 'dist', 'agents'); // src/agents 或 dist/agents
+    return [
+        // ① 构建后布局: dist/constraint-runtime/tools/… (从 dist/agents 出发)
+        path.join(here, '..', 'constraint-runtime', 'tools', 'WalletTools', `${name}.js`),
+        // ② 源码态布局: src/constraint-runtime/dist/tools/… (从 src/agents 出发)
+        path.join(here, '..', 'constraint-runtime', 'dist', 'tools', 'WalletTools', `${name}.js`),
+        // ③ 兜底: 从仓根分别按两种布局找
+        path.join(root, 'dist', 'constraint-runtime', 'tools', 'WalletTools', `${name}.js`),
+        path.join(root, 'src', 'constraint-runtime', 'dist', 'tools', 'WalletTools', `${name}.js`),
+    ];
+}
+/** 加载一个钱包工具模块 (挑第一个真实存在的; 都不在就带着"试过哪些"报错) */
+export async function loadWalletTool(name) {
+    const tried = walletToolCandidates(name);
+    const hit = firstExisting(tried);
+    if (hit)
+        return (await import(pathToFileURL(hit).href));
+    throw new Error(`找不到钱包工具 ${name} (试过 ${tried.length} 个路径):\n    ${tried.join('\n    ')}`);
+}
+/** 给诊断用: 当前各自解析到哪 (打印用的字符串, 不加载) */
+export function walletToolLayout() {
+    const names = ['createWallet', 'getBalance', 'signMessage'];
+    const out = [];
+    for (const n of names) {
+        for (const c of walletToolCandidates(n)) {
+            if (out.some(o => o.pattern === c))
+                continue;
+            out.push({ pattern: c, exists: firstExisting([c]) !== null });
+        }
+    }
+    return out;
+}