@bolloon/bolloon-agent 0.4.13 → 0.4.15

package/dist/agents/gateway-network.js

@@ -0,0 +1,278 @@
+/**
+ * gateway-network.ts — Agent 网络加入 (2026-08-14 v2)
+ *
+ * joinNetwork(link): 通过链接自动加入共享 Agent 网络.
+ * 链接形式 (三选一):
+ *   - orbitdb://<storeAddress>   共享 registry store (主链路, OrbitDB 复制)
+ *   - ipns://<name>              IPNS 标识 (registry 静态快照)
+ *   - https://.../registry       HTTP 端点 (远程 registry JSON)
+ *
+ * v2 新增:
+ *   - orbitdb:// 真实可开 (CIDDatabase.openStoreByAddress, replica 只读)
+ *   - 成员身份持久化 ~/.bolloon/gateway-networks.json (重启后仍是家庭成员)
+ *   - detectGatewayLink / maybeAutoJoinGateway — 消息里收到链接自动加入 (入口要小)
+ *   - shareNetworkLink — 生成本机可分享的网络链接 (把 registry 发出去)
+ */
+import * as os from 'os';
+import * as path from 'path';
+import { getAgentRegistry, warmAgentRegistry } from './agent-registry.js';
+/** 解析链接字符串 → ParsedLink (剥离 ?name= query) */
+export function parseNetworkLink(link) {
+    const l = String(link || '').trim();
+    if (!l)
+        return null;
+    const [base, query] = l.split('?');
+    let networkName;
+    try {
+        networkName = query ? (new URLSearchParams(query).get('name') || undefined) : undefined;
+    }
+    catch { /* 忽略坏 query */ }
+    if (base.startsWith('ipns://'))
+        return { kind: 'ipns', name: base.slice('ipns://'.length), networkName };
+    if (base.startsWith('orbitdb://')) {
+        // orbitdb:///orbitdb/<addr> 或 orbitdb://orbitdb/<addr> → /orbitdb/<addr>
+        let address = base.slice('orbitdb://'.length);
+        if (!address.startsWith('/'))
+            address = `/${address}`;
+        return { kind: 'orbitdb', address, networkName };
+    }
+    if (base.startsWith('http://') || base.startsWith('https://'))
+        return { kind: 'http', url: base, networkName };
+    return null;
+}
+/** 从消息文本里检测 gateway 链接 (自动加入触发器用) */
+export function detectGatewayLink(text) {
+    const t = String(text || '');
+    // orbitdb:// 地址含 '/' 必须贪婪匹配到空白/引号; https 允许 /registry 后带 ?query
+    const re = /(orbitdb:\/\/\/?orbitdb\/[^\s)'"<>，。；]+|ipns:\/\/[^\s)'"<>，。；]+|https?:\/\/[^\s)'"<>，。；]*\/registry(?:\?[^\s)'"<>，。；]*)?)/;
+    const m = re.exec(t);
+    return m ? m[1].trim() : null;
+}
+// ============ 远端拉取 ============
+/** 从 HTTP 端点拉取远端 registry */
+async function fetchRemoteRegistry(url) {
+    try {
+        const r = await fetch(url, { signal: AbortSignal.timeout(15000) });
+        if (!r.ok)
+            return null;
+        const data = await r.json();
+        // 兼容: {services:[...]} 或 [...]
+        const services = Array.isArray(data) ? data : (data.services ?? null);
+        return Array.isArray(services) ? services : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** 从 IPNS 拉取 registry (需本地 Kubo + 8080 gateway) */
+async function fetchIpnsRegistry(name) {
+    try {
+        const r = await fetch(`http://127.0.0.1:8080/ipns/${name}/registry.json`, { signal: AbortSignal.timeout(15000) });
+        if (!r.ok)
+            return null;
+        const data = await r.json();
+        return Array.isArray(data) ? data : (data.services ?? null);
+    }
+    catch {
+        return null;
+    }
+}
+/** 从 OrbitDB 打开共享 registry store (replica 只读) */
+async function fetchOrbitdbRegistry(address) {
+    try {
+        const { getCIDDatabase } = await import('../orbitdb/cid-database.js');
+        const db = getCIDDatabase();
+        const store = await db.openStoreByAddress(address, 'keyvalue');
+        if (!store)
+            return null;
+        // 先立即读 (同节点 store 已有数据); 没有再等复制 (owner 在线时 pubsub 复制通常 <1s)
+        const first = await store.get('services').catch(() => null);
+        if (Array.isArray(first))
+            return first;
+        await new Promise((resolve) => {
+            let done = false;
+            const finish = () => { if (!done) {
+                done = true;
+                try {
+                    off();
+                }
+                catch { }
+                resolve();
+            } };
+            const off = store.onChange(finish);
+            setTimeout(finish, 4000);
+        });
+        // 单键 'services' (registry 的 OrbitDB 布局: 整个列表存单键)
+        const v = await store.get('services').catch(() => null);
+        if (Array.isArray(v))
+            return v;
+        // 兼容: 遍历 entries 找数组值
+        const all = await store.all().catch(() => null);
+        if (Array.isArray(all)) {
+            for (const entry of all) {
+                if (Array.isArray(entry.value))
+                    return entry.value;
+                const val = entry.value;
+                if (val?.services && Array.isArray(val.services))
+                    return val.services;
+            }
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+const networksFile = () => path.join(os.homedir() || '/tmp', '.bolloon', 'gateway-networks.json');
+async function loadNetworks() {
+    try {
+        const { readFile } = await import('fs/promises');
+        const parsed = JSON.parse(await readFile(networksFile(), 'utf-8'));
+        return Array.isArray(parsed) ? parsed : [];
+    }
+    catch {
+        return [];
+    }
+}
+async function saveNetworks(list) {
+    try {
+        const { mkdir, writeFile } = await import('fs/promises');
+        await mkdir(path.dirname(networksFile()), { recursive: true });
+        await writeFile(networksFile(), JSON.stringify(list, null, 2), 'utf-8');
+    }
+    catch { /* 持久化失败静默 */ }
+}
+/** 列出已加入的网络 */
+export async function listJoinedNetworks() {
+    return loadNetworks();
+}
+/**
+ * 通过链接加入共享网络: 拉取远端服务列表 → 合并到本地 registry (按 agentId+service 去重).
+ * 幂等: 已加入的网络直接返回 already=true.
+ * deps.registry 可注入 (测试用), 默认单例.
+ */
+export async function joinNetwork(link, deps) {
+    const parsed = parseNetworkLink(link);
+    if (!parsed) {
+        return { ok: false, joined: 0, total: 0, error: '无法解析链接 (支持 orbitdb:// / ipns:// / https://)' };
+    }
+    // 幂等: 已加入 (按解析后的网络身份 key 去重, 忽略 ?name 差异)
+    const existing = await loadNetworks();
+    const norm = String(link).trim();
+    const identityKey = parsed.kind === 'orbitdb' ? `orbitdb:${parsed.address}`
+        : parsed.kind === 'ipns' ? `ipns:${parsed.name}`
+            : `http:${parsed.url}`;
+    if (existing.some((n) => n.linkKey === identityKey || n.link === norm)) {
+        return { ok: true, joined: 0, total: 0, already: true, linkKind: parsed.kind, networkName: parsed.networkName };
+    }
+    // 拉取远端服务
+    let remote = null;
+    if (parsed.kind === 'http') {
+        remote = await fetchRemoteRegistry(parsed.url);
+    }
+    else if (parsed.kind === 'ipns') {
+        remote = await fetchIpnsRegistry(parsed.name);
+    }
+    else if (parsed.kind === 'orbitdb') {
+        remote = await fetchOrbitdbRegistry(parsed.address);
+    }
+    if (!remote || remote.length === 0) {
+        return { ok: false, joined: 0, total: 0, error: '远端网络无服务或不可达 (store owner 需在线)', linkKind: parsed.kind };
+    }
+    // 合并到本地 registry (按 agentId + service.name 去重)
+    const registry = deps?.registry ?? getAgentRegistry();
+    const local = await registry.list();
+    let joined = 0;
+    for (const svc of remote) {
+        if (!svc?.agentId || !svc?.service?.name)
+            continue;
+        const exists = local.some((l) => l.agentId === svc.agentId && l.service?.name === svc.service?.name);
+        if (!exists) {
+            await registry.register(svc).catch(() => { });
+            joined++;
+        }
+    }
+    // 记录成员身份 (持久化 → 重启后自动恢复)
+    await saveNetworks([
+        ...existing,
+        {
+            link: norm,
+            linkKey: identityKey,
+            kind: parsed.kind,
+            name: parsed.networkName,
+            joinedAt: new Date().toISOString(),
+            serviceCount: remote.length,
+            lastSyncAt: new Date().toISOString(),
+        },
+    ]);
+    return { ok: true, joined, total: remote.length, linkKind: parsed.kind, networkName: parsed.networkName };
+}
+/** 启动恢复: 重拉所有已加入网络 (失败静默, 保留记录). 返回恢复统计. */
+export async function restoreJoinedNetworks() {
+    const nets = await loadNetworks();
+    if (nets.length === 0)
+        return { restored: 0, failed: 0, total: 0 };
+    let restored = 0;
+    let failed = 0;
+    for (const n of nets) {
+        const r = await joinNetwork(n.link).catch(() => null);
+        if (r?.ok)
+            restored++;
+        else
+            failed++;
+        // 更新 lastSyncAt
+        if (r?.ok) {
+            const updated = (await loadNetworks()).map((m) => m.link === n.link ? { ...m, lastSyncAt: new Date().toISOString(), serviceCount: r.total || m.serviceCount } : m);
+            await saveNetworks(updated);
+        }
+    }
+    return { restored, failed, total: nets.length };
+}
+// ============ 分享链接 ============
+/**
+ * 生成本机可分享的网络链接: orbitdb://<registry storeAddress>?name=<网络名>.
+ * 对方收到链接 → 自动 joinNetwork → 拉取本机注册的服务.
+ * opts.registry 可注入 (测试用), 默认单例.
+ */
+export async function shareNetworkLink(opts) {
+    try {
+        let registry = opts?.registry;
+        if (!registry) {
+            await warmAgentRegistry();
+            registry = getAgentRegistry();
+        }
+        if (!registry.ready || !registry.storeAddress) {
+            return { ok: false, error: 'OrbitDB registry 未就绪 (离线模式). 备选: 把 registry 列表发布成 https://.../registry 端点分享' };
+        }
+        const name = encodeURIComponent(String(opts?.name || registry.storeName || 'bolloon-network'));
+        return { ok: true, link: `orbitdb://${registry.storeAddress}?name=${name}` };
+    }
+    catch (e) {
+        return { ok: false, error: `生成分享链接失败: ${String(e?.message || e).slice(0, 160)}` };
+    }
+}
+// ============ 自动加入 (消息触发) ============
+/**
+ * 自动加入入口: 文本里检测到 gateway 链接 → 幂等 joinNetwork.
+ * 返回给 agent 的通知字符串 (无链接 / 已在网络 → null, 静默).
+ * 设计: 加入是自由的 (只拉服务列表, 不花钱), 支付仍走 payment-gate 安全链.
+ * deps.registry 可注入 (测试用), 默认单例.
+ */
+export async function maybeAutoJoinGateway(text, deps) {
+    const link = detectGatewayLink(text);
+    if (!link)
+        return null;
+    try {
+        const r = await joinNetwork(link, deps);
+        if (r.ok && r.already)
+            return null; // 已在网络, 静默
+        if (r.ok) {
+            const netName = r.networkName ? `「${r.networkName}」` : ''; // URLSearchParams 已 decode
+            return `🆕 已自动加入 Agent 网络${netName} (${r.linkKind}): 拉取 ${r.total} 个服务, 新增 ${r.joined} 个。用 gateway_status 查看, gateway_call 调用网络里的服务。`;
+        }
+        return `⚠️ 检测到 Agent 网络链接 (${r.linkKind || 'unknown'}) 但加入失败: ${r.error}`;
+    }
+    catch (e) {
+        return `⚠️ 自动加入 Agent 网络失败: ${String(e?.message || e).slice(0, 160)}`;
+    }
+}

package/dist/agents/judgment-protocol.js

@@ -148,20 +148,20 @@ export async function distillDissent(ask) {
         .slice(-10)
         .flatMap((j) => j.reasons || [])
         .slice(0, 20);
-    const prompt = `你是用户的判断力代理. 用户发起了一个决定: "${ask.decision}"
-${ask.context ? `\n补充: ${ask.context}` : ''}
-
-[用户价值画像] ${valueHint}
-[相关历史判断 (${relevant.length} 条)] ${relevant.slice(0, 3).map((j) => j.decision || '').join(' | ').slice(0, 300)}
-[历史理由样本] ${recentReasons.join(' | ').slice(0, 400) || '(无)'}
-
-请基于上述判断力, 生成正好 3 个"反方观点" (用户应该考虑但可能忽略的风险/盲点).
-要求:
-- 每个反方 1-2 句, 总长 < 80 字
-- 必须是这个特定决定的"反对声音", 不是通用建议
-- 第 1 个: 历史/经验类风险
-- 第 2 个: 关系/信任类风险
-- 第 3 个: 隐藏代价/时间类风险
+    const prompt = `你是用户的判断力代理. 用户发起了一个决定: "${ask.decision}"
+${ask.context ? `\n补充: ${ask.context}` : ''}
+
+[用户价值画像] ${valueHint}
+[相关历史判断 (${relevant.length} 条)] ${relevant.slice(0, 3).map((j) => j.decision || '').join(' | ').slice(0, 300)}
+[历史理由样本] ${recentReasons.join(' | ').slice(0, 400) || '(无)'}
+
+请基于上述判断力, 生成正好 3 个"反方观点" (用户应该考虑但可能忽略的风险/盲点).
+要求:
+- 每个反方 1-2 句, 总长 < 80 字
+- 必须是这个特定决定的"反对声音", 不是通用建议
+- 第 1 个: 历史/经验类风险
+- 第 2 个: 关系/信任类风险
+- 第 3 个: 隐藏代价/时间类风险
 - 用 JSON 数组返回: ["反方1", "反方2", "反方3"]`;
     // LLM 调用 (OpenAI 兼容, 复用 p2p-chat-tools 的方式)
     let dissents = [];

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

@@ -2505,6 +2505,123 @@ export function registerBuiltinTools(ctx) {
             }
         },
     });
+    // 2026-08-14: Agent Gateway — 经济协调层统一入口 (注册/调用/加入网络/状态)
+    ctx.tools.set('gateway_register', {
+        name: 'gateway_register',
+        description: '把本 Agent 注册为服务提供者 (Agent Gateway 入口). capability: 能力名 (research/coding/data...); price: 价格; per: 计价单位; wallet: 收款地址. 注册后其他 Agent 能发现并调用你.',
+        parameters: {
+            capability: '能力名 (必填, research/coding/data/compute...)',
+            price: '价格 (必填, 如 0.05)',
+            currency: '币种 (默认 USDC)',
+            per: '计价单位 (默认 query)',
+            description: '服务描述 (可选)',
+            wallet: '收款钱包地址 (可选)',
+        },
+        execute: async (args) => {
+            const { gatewayRegisterAgent } = await import('./agent-gateway.js');
+            const r = await gatewayRegisterAgent({
+                capability: String(args.capability || '').trim(),
+                price: String(args.price || '').trim(),
+                currency: String(args.currency || 'USDC'),
+                per: String(args.per || 'query'),
+                description: String(args.description || '').trim() || undefined,
+                wallet: String(args.wallet || '').trim() || undefined,
+            }, { did: ctx.identity?.did || '', name: ctx.identity?.name || 'agent', wallet: String(args.wallet || '') });
+            return r.ok
+                ? { success: true, output: `✅ 已加入 Agent 网络: ${args.capability} @ ${args.price} ${args.currency}/${args.per}` }
+                : { success: false, error: r.error };
+        },
+    });
+    ctx.tools.set('gateway_call', {
+        name: 'gateway_call',
+        description: '通过 Agent Gateway 调用服务 (自动闭环: 发现→预算→验证门→执行→信誉). task: 任务描述; budget: 预算 (USDC); capability: 需要的能力. 需人工确认的支付会返回 approval 待审批.',
+        parameters: {
+            task: '任务描述 (必填)',
+            budget: '预算 USDC (必填)',
+            capability: '需要的能力 (可选, 如 research)',
+            url: '服务端点 URL (可选)',
+        },
+        execute: async (args) => {
+            const task = String(args.task || '').trim();
+            const budget = Number(args.budget);
+            if (!task || !budget || budget <= 0)
+                return { success: false, error: 'task 和 budget(>0) 必填' };
+            try {
+                const { gatewayCallAgent } = await import('./agent-gateway.js');
+                const r = await gatewayCallAgent({
+                    task,
+                    budget,
+                    capability: String(args.capability || '').trim() || undefined,
+                    url: String(args.url || '').trim() || undefined,
+                });
+                if (r.success)
+                    return { success: true, output: `✅ ${r.provider}: ${r.output}` };
+                return { success: false, error: r.error, requiresApproval: r.requiresApproval, approvalId: r.approvalId, provider: r.provider };
+            }
+            catch (e) {
+                return { success: false, error: `gateway_call 失败: ${String(e?.message || e).slice(0, 200)}` };
+            }
+        },
+    });
+    ctx.tools.set('gateway_join', {
+        name: 'gateway_join',
+        description: '通过链接加入共享 Agent 网络 (拉取远端服务合并到本地 registry). link: ipns://<name> 或 orbitdb://<address> 或 https://.../registry. 加入后可用 gateway_call 调用网络里的服务.',
+        parameters: { link: '网络链接 (必填, ipns:// / orbitdb:// / https://)' },
+        execute: async (args) => {
+            const link = String(args.link || '').trim();
+            if (!link)
+                return { success: false, error: 'link 必填 (ipns:// / orbitdb:// / https://)' };
+            try {
+                const { joinNetwork } = await import('./gateway-network.js');
+                const r = await joinNetwork(link);
+                if (!r.ok)
+                    return { success: false, error: r.error };
+                return { success: true, output: `✅ 已加入 Agent 网络: 拉取 ${r.total} 个服务, 新增 ${r.joined} 个 (${r.linkKind})` };
+            }
+            catch (e) {
+                return { success: false, error: `gateway_join 失败: ${String(e?.message || e).slice(0, 200)}` };
+            }
+        },
+    });
+    ctx.tools.set('gateway_status', {
+        name: 'gateway_status',
+        description: '查看 Agent 网络状态 (已注册服务 + 信誉 + 已加入的网络).',
+        parameters: {},
+        execute: async () => {
+            try {
+                const { gatewayStatus } = await import('./agent-gateway.js');
+                const { listJoinedNetworks } = await import('./gateway-network.js');
+                const nets = await listJoinedNetworks();
+                const netLine = nets.length
+                    ? `\n已加入网络 (${nets.length}):\n` + nets.slice(0, 10).map((n) => `  [${n.kind}] ${n.name || n.link.slice(0, 48)} (${n.serviceCount} 服务, ${n.joinedAt.slice(0, 10)})`).join('\n')
+                    : '\n(未加入任何网络, 收到 orbitdb:// 链接会自动加入, 或用 gateway_join)';
+                return { success: true, output: (await gatewayStatus()) + netLine };
+            }
+            catch (e) {
+                return { success: false, error: `gateway_status 失败: ${String(e?.message || e).slice(0, 200)}` };
+            }
+        },
+    });
+    ctx.tools.set('gateway_share', {
+        name: 'gateway_share',
+        description: '生成本 Agent 网络的分享链接 (orbitdb://...). 把链接发给其他 Bolloon/Agent, 对方收到后会自动加入你的网络并发现你注册的服务.',
+        parameters: {
+            name: '网络名 (可选, 默认 registry 名)',
+        },
+        execute: async (args) => {
+            try {
+                const { shareNetworkLink } = await import('./gateway-network.js');
+                const name = String(args.name || '').trim() || undefined;
+                const r = await shareNetworkLink(name ? { name } : undefined);
+                if (!r.ok)
+                    return { success: false, error: r.error };
+                return { success: true, output: `🔗 Agent 网络分享链接 (对方收到后自动加入):\n${r.link}` };
+            }
+            catch (e) {
+                return { success: false, error: `gateway_share 失败: ${String(e?.message || e).slice(0, 200)}` };
+            }
+        },
+    });
     // ============================================================
     // publish_did (2026-08-03) — 把当前 agent 的 DID 发布到 IPFS + IPNS
     // 全自动: 自动安装/启动本地 Kubo → 上传 DID 文档 → 发布 IPNS name

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

@@ -1,13 +1,13 @@
-export const TOOL_DEFINITIONS = `
-可用工具:
-1. read_document(path) - 读取文档内容，支持 .txt, .md, .pdf, .docx
-2. summarize_document(path, context?) - 总结文档内容，可选提供上下文
-3. improve_document(path, requirements) - 改进文档，需提供文件路径和改进要求
-4. list_peers() - 列出已连接的对等节点
-5. send_message(peer_id, message) - 向指定对等节点发送消息
-6. broadcast_message(message) - 向所有对等节点广播消息
-7. get_identity() - 获取当前智能体身份信息
-8. set_persona(persona_json) - 更新智能体 persona，包含 name、description、personality、greeting 等
-9. run_workflow(steps) - 执行预定义工作流
-10. get_operation_logs() - 获取操作日志
+export const TOOL_DEFINITIONS = `
+可用工具:
+1. read_document(path) - 读取文档内容，支持 .txt, .md, .pdf, .docx
+2. summarize_document(path, context?) - 总结文档内容，可选提供上下文
+3. improve_document(path, requirements) - 改进文档，需提供文件路径和改进要求
+4. list_peers() - 列出已连接的对等节点
+5. send_message(peer_id, message) - 向指定对等节点发送消息
+6. broadcast_message(message) - 向所有对等节点广播消息
+7. get_identity() - 获取当前智能体身份信息
+8. set_persona(persona_json) - 更新智能体 persona，包含 name、description、personality、greeting 等
+9. run_workflow(steps) - 执行预定义工作流
+10. get_operation_logs() - 获取操作日志
 `;