@bolloon/bolloon-agent 0.6.1 → 0.6.3

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

@@ -67,6 +67,11 @@ const computer_use_js_1 = require("./computer-use.js");
 const skill_share_js_1 = require("./skill-share.js");
 // 2026-09-13: 微支付信息服务 (x402 付费信息 + 验真信封)
 const paid_info_tools_js_1 = require("./x402/paid-info-tools.js");
+// 2026-10-02: 群聊的四个 AI 工具 —— 原语来自群模块与"唯一发送出口"(带隐私闸)
+const gateway_group_js_1 = require("./gateway-group.js");
+const task_group_js_1 = require("./task-group.js");
+// 2026-10-02: 群聊自主回路 (读 → 自己判断 → 自己发言) —— AI 用 group_autopilot 工具驱动
+const group_autopilot_js_1 = require("./group-autopilot.js");
 /**
  * Tools 模块 — 从 pi-sdk.ts 抽出的 registerTools() / _registerWalletTools() / _setupInboxListener()
  * / wrapToolsWithIdempotency() (2026-07-06).
@@ -229,6 +234,8 @@ async function runTerminalCommand(raw, opts = {}) {
     }
     return { success: true, output: allOutput, count: list.length, parallel: true };
 }
+/** 2026-10-02: 群聊自主回路的常驻句柄 (同进程共享; stop 后置 null) */
+let autopilotHandle = null;
 function registerBuiltinTools(ctx) {
     ctx.tools.set('read_document', {
         name: 'read_document',
@@ -996,6 +1003,301 @@ function registerBuiltinTools(ctx) {
             return await runTerminalCommand(raw, { timeoutMs, cwd: ctx.cwd, commands: commands.length > 0 ? commands : undefined, background: String(args.background).toLowerCase() === 'true' });
         }
     });
+    /**
+     * 2026-10-02: @ 的归一入口 —— 模型给 `['a','b']` / `'a,b'` / `'a b'` / `'a'` 都收
+     *   (别因为形状不符就把 @ 静默丢掉: 真机第一次跑, 模型传的正是字符串 ⇒ @ 丢了)。
+     *   trim + 去 `@` 前缀 + 去空 + 去重 + 上限 20 (与记录层同一口径)。
+     */
+    const normalizeMentions = (raw) => {
+        const flat = Array.isArray(raw) ? raw : typeof raw === 'string' ? raw.split(/[,，;；\s]+/) : raw == null ? [] : [raw];
+        const out = Array.from(new Set(flat.map((x) => String(x ?? '').replace(/^@/, '').trim()).filter(Boolean))).slice(0, 20);
+        return out.length ? out : undefined;
+    };
+    // 2026-10-02 (leo: 希望人工智能自己搞定): 群聊工具 —— 原语来自群模块 + 唯一发送出口(带隐私闸)
+    ctx.tools.set('group_create', {
+        name: 'group_create',
+        description: '新建一个 OrbitDB 群聊并拿到邀请链接 —— **用于**你要开一个话题把别人拉进来（建好后把邀请链接发出去, 对方用 group_join 入群）。acl 默认 creator: 只有你自己能发言; 想让**谁拿到链接都能发言**就传 acl="open"（产品语义如此, 两种都合法）。',
+        parameters: { name: '群名（必填）', acl: 'creator | open —— 默认 creator(创建者独占写入); open = 谁拿链接都能发言', from: '你的署名（可选; 默认本机身份）' },
+        execute: async (args) => {
+            const name = String(args?.name ?? '').trim();
+            if (!name)
+                return { success: false, error: 'name 必填（群名）' };
+            const who = await (0, task_group_js_1.resolveSenderTag)(null);
+            // 只认 'open'; 其它一律走产品默认 (创建者独占) —— 不猜、不替调用方放开权限
+            const acl = String(args?.acl ?? '').trim() === 'open' ? 'open' : undefined;
+            const r = await (0, gateway_group_js_1.createGroup)(name, { ...(who.ok ? { from: who.tag } : {}), ...(acl ? { acl } : {}) });
+            const g = r.group;
+            if (!g?.id)
+                return { success: false, error: '建群没返回 groupId（如实报告, 不假装成功）' };
+            const link = await (0, gateway_group_js_1.groupLink)(g.id).catch(() => null);
+            return { success: true, output: `已建群「${g.name}」(${g.id})${acl ? ' · 开放写入(谁拿链接都能发言)' : ' · 创建者独占写入'}\n` + (link ? `邀请链接: ${link}\n把这个链接发给对方, 他用 group_join 入群。` : '(没拿到邀请链接 —— 用 group_list 再看一次)') };
+        },
+    });
+    ctx.tools.set('group_join', {
+        name: 'group_join',
+        description: '加入一个 OrbitDB 群聊 —— **用于**拿到邀请链接后自助入群（幂等: 已在群里 ⇒ already）。link 传邀请链接（orbitdb:///orbitdb/<addr>?type=group&name=…）或 groupId。入群后先用 group_read 读消息、再用 group_say 发言。',
+        parameters: { link: '邀请链接 或 groupId（必填）' },
+        execute: async (args) => {
+            const link = String(args?.link ?? '').trim();
+            if (!link)
+                return { success: false, error: '缺 link（邀请链接或 groupId）' };
+            const r = await (0, gateway_group_js_1.joinGroup)(link);
+            if (!r.ok)
+                return { success: false, error: r.error || '入群失败' };
+            const g = r.group;
+            return {
+                success: true,
+                output: (r.already ? '已在群里「' : '已入群「') + String(g?.name ?? '') + '」(' + String(g?.id ?? '') + ')'
+                    + (g?.link ? ' · 邀请链接 ' + g.link : ''),
+            };
+        }
+    });
+    // 2026-10-02 (leo: 希望人工智能自己搞定): 群聊工具 —— 原语来自群模块 + 唯一发送出口(带隐私闸)
+    ctx.tools.set('group_list', {
+        name: 'group_list',
+        description: '列出本机已加入的群（群名 / groupId / 加入时间 / 邀请链接）—— **用于**不知道有哪些群时先摸清楚。先用它拿 groupId, 再用 group_read / group_say。',
+        parameters: {},
+        execute: async (args) => {
+            const groups = await (0, gateway_group_js_1.listGroups)();
+            if (!groups.length)
+                return { success: true, output: '（本机还没有加入任何群）' };
+            const lines = [];
+            for (const g of groups) {
+                const link = await (0, gateway_group_js_1.groupLink)(g.id).catch(() => null);
+                lines.push(`${g.name}  ${g.id}  加入于 ${g.createdAt}` + (link ? `\n  邀请链接: ${link}` : ''));
+            }
+            return { success: true, output: lines.join('\n') };
+        }
+    });
+    // 2026-10-02 (leo: 希望人工智能自己搞定): 群聊工具 —— 原语来自群模块 + 唯一发送出口(带隐私闸)
+    ctx.tools.set('group_read', {
+        name: 'group_read',
+        description: '读一个群里的消息（最近 N 条, 默认 30）—— **用于**看群里发生过什么、拉取要阅读的内容。group 可直接给 groupId, 也可给邀请链接 / 群名。',
+        parameters: { group: 'groupId | 邀请链接 | 群名（必填）', limit: '最多读多少条, 默认 30', branch: '只看某个分支（可选; 缺省 = 全部）' },
+        execute: async (args) => {
+            const res = await (0, task_group_js_1.resolveGroupRef)(String(args?.group ?? ''));
+            if (!res.ok)
+                return { success: false, error: res.message };
+            const limit = Number(args?.limit ?? 30) || 30;
+            let msgs = await (0, gateway_group_js_1.groupMessages)(res.group.groupId, limit);
+            const branch = String(args?.branch ?? '').trim();
+            if (branch)
+                msgs = msgs.filter((m) => String(m.branch ?? '') === branch);
+            if (!msgs.length)
+                return { success: true, output: `（群「${res.group.name ?? res.group.groupId}」里还没有消息${branch ? ` (分支 ${branch})` : ''}）` };
+            // 2026-10-02: 把 @/回复/附件/分支都渲染出来 —— 只给纯文本, 模型看不出结构就没法正确回复
+            const fmt = (m) => {
+                const bits = [`[${new Date(m.ts).toLocaleString('zh-CN')}]`];
+                if (m.id)
+                    bits.push(`#${m.id.slice(0, 8)}`);
+                if (m.kind === 'branch')
+                    bits.push('[分支]');
+                if (m.branch)
+                    bits.push(`⎇${m.branch}`);
+                if (m.replyTo)
+                    bits.push(`↩#${String(m.replyTo).slice(0, 8)}`);
+                bits.push(`${m.mentions?.length ? '@' + m.mentions.join(' @') + ' ' : ''}${m.from}:`);
+                bits.push(m.text);
+                if (m.attachments?.length) {
+                    bits.push(m.attachments.map((a) => `[${a.kind === 'image' ? '图片' : a.kind === 'audio' ? '音频' : '文件'} ${a.cid.slice(0, 14)}${a.name ? ' ' + a.name : ''}]`).join(' '));
+                }
+                return bits.join(' ');
+            };
+            return { success: true, output: msgs.map(fmt).join('\n') };
+        }
+    });
+    // 2026-10-02 (leo: 希望人工智能自己搞定): 群聊工具 —— 原语来自群模块 + 唯一发送出口(带隐私闸)
+    ctx.tools.set('group_say', {
+        name: 'group_say',
+        description: '在一个群里发言（写进 OrbitDB 群 store, 成员都能读到）—— **用于**把你的结论/请求讲给群成员。group 可直接给 groupId, 也可给邀请链接 / 群名。消息**先过隐私红线闸**: 不许出现地址 / DID / peerId / multiaddr / IP / 私钥形态。',
+        parameters: {
+            group: 'groupId | 邀请链接 | 群名（必填）',
+            text: '要说的内容（必填）',
+            mentions: '@ 谁 —— 短显示名数组, 例如 ["委托方","审稿人"]（可选）',
+            replyTo: '回复哪条 —— 该消息的 id（group_read 的输出里带）（可选）',
+            branch: '发到哪个分支（可选; 缺省 = 主线）',
+        },
+        execute: async (args) => {
+            const res = await (0, task_group_js_1.resolveGroupRef)(String(args?.group ?? ''));
+            if (!res.ok)
+                return { success: false, error: res.message };
+            const text = String(args?.text ?? '').trim();
+            if (!text)
+                return { success: false, error: 'text 不能为空' };
+            const who = await (0, task_group_js_1.resolveSenderTag)(null);
+            if (!who.ok)
+                return { success: false, error: who.message };
+            const mentions = normalizeMentions(args?.mentions);
+            const r = await (0, task_group_js_1.sendTrailMessage)(res.group.groupId, text, who.tag, {
+                ...(mentions?.length ? { mentions } : {}),
+                ...(args?.replyTo ? { replyTo: String(args.replyTo) } : {}),
+                ...(args?.branch ? { branch: String(args.branch) } : {}),
+            });
+            if (!r.ok)
+                return { success: false, error: r.error || '发送失败' };
+            const extra = mentions?.length ? `（@ ${mentions.join(' ')}）` : '';
+            return { success: true, output: `已发到群「${res.group.name ?? res.group.groupId}」（署名 ${who.tag}）${extra}: ${text}` };
+        }
+    });
+    ctx.tools.set('group_reply', {
+        name: 'group_reply',
+        description: '回复群里**某一条**消息（在群里形成对话）—— **用于**回答特定的人/特定那条话，而不是发一条孤立的消息。group 给 groupId/链接/群名；replyTo 给那条消息的 id（group_read 输出里的 `#xxxxxxxx`）。',
+        parameters: { group: 'groupId | 邀请链接 | 群名（必填）', replyTo: '被回复消息的 id（必填, group_read 输出里的 #xxxxxxxx）', text: '回复内容（必填）', mentions: '@ 谁（短显示名数组, 可选）' },
+        execute: async (args) => {
+            const res = await (0, task_group_js_1.resolveGroupRef)(String(args?.group ?? ''));
+            if (!res.ok)
+                return { success: false, error: res.message };
+            const replyTo = String(args?.replyTo ?? '').trim().replace(/^#/, '');
+            const text = String(args?.text ?? '').trim();
+            if (!replyTo)
+                return { success: false, error: 'replyTo 必填（被回复消息的 id）' };
+            if (!text)
+                return { success: false, error: 'text 不能为空' };
+            const who = await (0, task_group_js_1.resolveSenderTag)(null);
+            if (!who.ok)
+                return { success: false, error: who.message };
+            const mentions = normalizeMentions(args?.mentions);
+            const r = await (0, task_group_js_1.sendTrailMessage)(res.group.groupId, text, who.tag, { replyTo, ...(mentions?.length ? { mentions } : {}) });
+            if (!r.ok)
+                return { success: false, error: r.error || '回复失败' };
+            return { success: true, output: `已回复 #${replyTo.slice(0, 8)}（署名 ${who.tag}）: ${text}` };
+        },
+    });
+    ctx.tools.set('group_attach', {
+        name: 'group_attach',
+        description: '往群里发**图片/音频/文件**（消息里只放内容寻址的 CID, 字节进内容寻址层, 成员按 CID 取）—— **用于**要把一张图/一段录音/一个文件交给群里的人。给 path（本机文件, 自动算 CID 并入库）或 cid（已经在内容寻址层里）。',
+        parameters: { group: 'groupId | 邀请链接 | 群名（必填）', path: '本机文件路径（与 cid 二选一）', cid: '已在内容寻址层的 CID（与 path 二选一）', kind: 'image | audio | file（默认 file; 给 path 时会按扩展名猜）', text: '随附件说的话（可选）', branch: '发到哪个分支（可选）' },
+        execute: async (args) => {
+            const res = await (0, task_group_js_1.resolveGroupRef)(String(args?.group ?? ''));
+            if (!res.ok)
+                return { success: false, error: res.message };
+            const kindArg = String(args?.kind ?? '').trim();
+            let cid = String(args?.cid ?? '').trim();
+            let name = '';
+            let bytes;
+            let kind = /^(image|audio|file)$/.test(kindArg) ? kindArg : 'file';
+            const p = String(args?.path ?? '').trim();
+            if (p) {
+                const fsp = await Promise.resolve().then(() => __importStar(require('node:fs/promises')));
+                const pathMod = await Promise.resolve().then(() => __importStar(require('node:path')));
+                try {
+                    const buf = await fsp.readFile(p);
+                    name = pathMod.basename(p);
+                    if (!kindArg) {
+                        const ext = pathMod.extname(p).toLowerCase();
+                        kind = ['.png', '.jpg', '.jpeg', '.gif', '.webp'].includes(ext) ? 'image' : ['.mp3', '.wav', '.m4a', '.ogg', '.aac'].includes(ext) ? 'audio' : 'file';
+                    }
+                    const { getCIDDatabase } = await Promise.resolve().then(() => __importStar(require('../orbitdb/cid-database.js')));
+                    const db = getCIDDatabase();
+                    if (!db.putBytes)
+                        return { success: false, error: '内容寻址层不支持 putBytes（该构建缺这个入口）' };
+                    const put = await db.putBytes(new Uint8Array(buf));
+                    cid = put.cid;
+                    bytes = put.bytes;
+                }
+                catch (e) {
+                    return { success: false, error: `读取/入库失败: ${String(e?.message || e).slice(0, 160)}` };
+                }
+            }
+            if (!cid)
+                return { success: false, error: 'path 或 cid 至少给一个' };
+            const who = await (0, task_group_js_1.resolveSenderTag)(null);
+            if (!who.ok)
+                return { success: false, error: who.message };
+            const text = String(args?.text ?? '').trim() || `[${kind === 'image' ? '图片' : kind === 'audio' ? '音频' : '文件'}] ${name || cid.slice(0, 14)}`;
+            const r = await (0, task_group_js_1.sendTrailMessage)(res.group.groupId, text, who.tag, {
+                attachments: [{ kind, cid, ...(name ? { name } : {}), ...(typeof bytes === 'number' ? { bytes } : {}) }],
+                ...(args?.branch ? { branch: String(args.branch) } : {}),
+            });
+            if (!r.ok)
+                return { success: false, error: r.error || '发送失败' };
+            return { success: true, output: `已发附件到群「${res.group.name ?? res.group.groupId}」: ${kind} ${cid.slice(0, 14)}${name ? ' (' + name + ')' : ''}${typeof bytes === 'number' ? ' ' + bytes + 'B' : ''}（署名 ${who.tag}）` };
+        },
+    });
+    ctx.tools.set('group_branch', {
+        name: 'group_branch',
+        description: '在群里**开一个分支话题**（像一条独立讨论线）—— **用于**一个群里同时聊多件事, 免得主线互相打断。之后用 group_say/group_reply 带 branch 参数就发进这个分支; group_read 带 branch 只看这一支。',
+        parameters: { group: 'groupId | 邀请链接 | 群名（必填）', title: '分支话题名（必填, 简短; 之后作为 branch 参数用它）' },
+        execute: async (args) => {
+            const res = await (0, task_group_js_1.resolveGroupRef)(String(args?.group ?? ''));
+            if (!res.ok)
+                return { success: false, error: res.message };
+            const title = String(args?.title ?? '').trim();
+            if (!title)
+                return { success: false, error: 'title 必填（分支话题名）' };
+            const who = await (0, task_group_js_1.resolveSenderTag)(null);
+            if (!who.ok)
+                return { success: false, error: who.message };
+            const r = await (0, task_group_js_1.sendTrailMessage)(res.group.groupId, `分支话题: ${title}`, who.tag, { kind: 'branch', branch: title });
+            if (!r.ok)
+                return { success: false, error: r.error || '建分支失败' };
+            return { success: true, output: `已开分支「${title}」${r.id ? ' #' + r.id.slice(0, 8) : ''} —— 之后 group_say/group_reply 带 branch="${title}" 发言即可, group_read 带 branch="${title}" 只看这一支。` };
+        },
+    });
+    ctx.tools.set('group_members', {
+        name: 'group_members',
+        description: '列一个群里出现过的成员（从消息里提取) —— **用于**想知道这个群有谁、要 @ 谁之前先看一眼。',
+        parameters: { group: 'groupId | 邀请链接 | 群名（必填）' },
+        execute: async (args) => {
+            const res = await (0, task_group_js_1.resolveGroupRef)(String(args?.group ?? ''));
+            if (!res.ok)
+                return { success: false, error: res.message };
+            const members = await (0, gateway_group_js_1.groupMembers)(res.group.groupId);
+            return { success: true, output: members.length ? `群「${res.group.name ?? res.group.groupId}」成员/发言者 ${members.length} 个: ${members.join(' · ')}` : `（群「${res.group.name ?? res.group.groupId}」里还没有成员发过言）` };
+        },
+    });
+    ctx.tools.set('group_autopilot', {
+        name: 'group_autopilot',
+        description: '群聊自主回路 —— **用于**让 AI 自己读群、自己判断该不该开口、自己在群里发言（不用人盯着）。action: run(立刻跑一轮) / start(挂成常驻, 每 intervalMs 一轮) / stop / status。默认只在「被 @」或「有人提问/请人做事」时说话, 冷却 60s、每小时每群最多 6 次, 处理过的消息不会重复回应。',
+        parameters: { action: 'run | start | stop | status（必填）', intervalMs: '常驻时的间隔 ms（默认 60000）', mode: 'quiet | active | maintenance（可选; maintenance 专门维护 Bolloon）', group: '只盯某个群（groupId/链接/群名, 可选; 缺省 = 全部已加入的群）' },
+        execute: async (args) => {
+            const action = String(args?.action ?? 'run').trim();
+            const who = await (0, task_group_js_1.resolveSenderTag)(null);
+            if (!who.ok)
+                return { success: false, error: who.message };
+            const only = String(args?.group ?? '').trim();
+            const state = (0, group_autopilot_js_1.loadAutopilotState)();
+            const ports = {
+                me: who.tag,
+                listGroups: async () => {
+                    const gs = await (0, gateway_group_js_1.listGroups)();
+                    if (!only)
+                        return gs.map((g) => ({ id: g.id, name: g.name }));
+                    const r = await (0, task_group_js_1.resolveGroupRef)(only);
+                    return r.ok ? [{ id: r.group.groupId, name: r.group.name }] : [];
+                },
+                readMessages: (gid, limit) => (0, gateway_group_js_1.groupMessages)(gid, limit),
+                speak: (gid, text, opts) => (0, task_group_js_1.sendTrailMessage)(gid, text, who.tag, opts ?? {}),
+                state,
+                policy: { mode: String(args?.mode ?? 'quiet') },
+            };
+            if (action === 'stop') {
+                if (!autopilotHandle)
+                    return { success: true, output: '没有在跑的常驻回路（无需停）' };
+                autopilotHandle.stop();
+                const runs = autopilotHandle.runs();
+                autopilotHandle = null;
+                return { success: true, output: `已停常驻回路（本次共跑 ${runs} 轮）` };
+            }
+            if (action === 'status') {
+                const last = autopilotHandle?.lastReport() ?? null;
+                return { success: true, output: autopilotHandle
+                        ? `常驻回路在跑: 已 ${autopilotHandle.runs()} 轮；最近一轮: 发言 ${last?.spoke ?? 0} · 静默 ${last?.silent ?? 0}${last?.errors.length ? ' · 错误 ' + last.errors.length : ''}`
+                        : `没有常驻回路在跑。状态文件: ${Object.keys(state.groups).length} 个群有记录` };
+            }
+            if (action === 'start') {
+                if (autopilotHandle)
+                    return { success: true, output: '常驻回路已经在跑了' };
+                const intervalMs = Number(args?.intervalMs ?? 60_000) || 60_000;
+                autopilotHandle = (0, group_autopilot_js_1.startGroupAutopilot)({ ...ports, intervalMs });
+                return { success: true, output: `已挂常驻回路（每 ${Math.round(intervalMs / 1000)}s 一轮；被 @ 或在有人提问时发言）。要停用 group_autopilot action=stop。` };
+            }
+            const r = await (0, group_autopilot_js_1.runGroupAutopilotOnce)(ports);
+            const head = `跑了一轮: 发言 ${r.spoke} · 静默 ${r.silent}${r.errors.length ? ` · 错误 ${r.errors.length}` : ''}`;
+            const tail = [...r.details, ...r.errors.map((e) => `⚠ ${e}`)].slice(0, 8).join('\n');
+            return { success: true, output: tail ? `${head}\n${tail}` : head };
+        },
+    });
     // 2026-08-12 (TaskD): process — 后台进程管理 (学 hermes terminal background session + poll/wait/kill).
     //   长命令不阻塞对话: terminal(background=true) 启动 → process 工具轮询/等待/终止.
     ctx.tools.set('process', {