@bolloon/bolloon-agent 0.4.10 → 0.4.12

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

@@ -2243,6 +2243,209 @@ export function registerBuiltinTools(ctx) {
         }
     };
     registerUiAgentTools().catch(() => { });
+    // 2026-08-12: A2UI (Agent to UI) 工具 — agent 生成 A2UI 消息 (createSurface/updateComponents),
+    //   经 SSE 广播, 前端用 @a2ui/react renderer 渲染. 见 src/pi-ecosystem-a2ui/.
+    (async () => {
+        try {
+            const a2ui = await import('../pi-ecosystem-a2ui/index.js');
+            for (const t of a2ui.A2UI_TOOL_DEFS) {
+                ctx.tools.set(t.name, {
+                    name: t.name,
+                    description: t.description,
+                    parameters: t.params,
+                    execute: async (args) => {
+                        const r = a2ui.dispatchA2uiMessage(t.build(args));
+                        return r.success ? { success: true, output: r.output } : { success: false, error: r.output };
+                    },
+                });
+            }
+        }
+        catch { /* A2UI 工具注册失败静默 */ }
+    })();
+    // 2026-08-13 (Phase E1): Agent 服务 Registry — 注册/发现服务 (Agent Economic Network Discovery 层)
+    (async () => {
+        try {
+            const registry = await import('../agents/agent-registry.js');
+            // 注册自己为服务提供者
+            ctx.tools.set('registry_register', {
+                name: 'registry_register',
+                description: '在 Agent 服务注册表注册自己的服务 (定价/能力/钱包). 让其他 Agent 能发现并调用你. 参数: service_name(如 research), description, price_amount, price_currency(USDC), price_per(如 query), capabilities(数组), wallet(收款地址)',
+                parameters: {
+                    service_name: '服务名 (必填, 如 research/coding/data)',
+                    description: '服务描述 (必填)',
+                    price_amount: '单价金额 (必填, 如 0.05)',
+                    price_currency: '计价币种 (默认 USDC)',
+                    price_per: '计价单位 (默认 query)',
+                    capabilities: '能力数组 (可选)',
+                    wallet: '收款钱包地址 (必填)',
+                },
+                execute: async (args) => {
+                    const serviceName = String(args.service_name || '').trim();
+                    const wallet = String(args.wallet || '').trim();
+                    if (!serviceName || !wallet)
+                        return { success: false, error: 'service_name 和 wallet 必填' };
+                    const reg = registry.getAgentRegistry();
+                    const r = await reg.register({
+                        agentId: ctx.identity?.did || `did:local:${ctx.identity?.name || 'agent'}`,
+                        name: ctx.identity?.name || 'agent',
+                        wallet,
+                        service: {
+                            name: serviceName,
+                            description: String(args.description || `${serviceName} 服务`).trim(),
+                            price: {
+                                amount: String(args.price_amount || '0'),
+                                currency: String(args.price_currency || 'USDC').toUpperCase(),
+                                per: String(args.price_per || 'query'),
+                            },
+                        },
+                        capabilities: Array.isArray(args.capabilities) ? args.capabilities.map(String) : [serviceName],
+                    });
+                    return r.ok
+                        ? { success: true, output: `✅ 已注册服务: ${serviceName} (${args.price_amount || 0} ${String(args.price_currency || 'USDC').toUpperCase()}/${args.price_per || 'query'}) wallet=${wallet.slice(0, 10)}...` }
+                        : { success: false, error: r.error };
+                },
+            });
+            // 发现可用的 Agent 服务
+            ctx.tools.set('registry_discover', {
+                name: 'registry_discover',
+                description: '在 Agent 服务注册表发现服务 (按名称/能力/描述). 找到服务后可用 x402 支付调用. query: 搜索词 (如 research/compute/data).',
+                parameters: { query: '搜索词 (可选, 空=列出全部)' },
+                execute: async (args) => {
+                    const q = String(args.query || '').trim();
+                    const reg = registry.getAgentRegistry();
+                    const services = await reg.discover(q);
+                    if (services.length === 0)
+                        return { success: true, output: '(注册表无匹配服务)' };
+                    const lines = services.slice(0, 20).map((s) => `  [${s.service.name}] ${s.name} (${s.service.price.amount} ${s.service.price.currency}/${s.service.price.per}) wallet=${String(s.wallet).slice(0, 12)}... agent=${s.agentId.slice(0, 24)}...`);
+                    return { success: true, output: `发现 ${services.length} 个服务:\n${lines.join('\n')}` };
+                },
+            });
+        }
+        catch { /* registry 工具注册失败静默 */ }
+    })();
+    // 2026-08-13 (Phase E2): service_call — 调用 Agent 服务 (x402 402 自动支付闭环)
+    ctx.tools.set('service_call', {
+        name: 'service_call',
+        description: '调用注册表里的 Agent 服务 (x402 支付闭环). 从 registry_discover 找到服务名后调用. service_name: 服务名; args: 服务参数; 有钱包私钥时自动支付 402.',
+        parameters: {
+            service_name: '服务名 (必填, registry_discover 查到的)',
+            args: '服务参数 JSON (可选)',
+            max_payment_amount: '最大支付金额 (可选)',
+        },
+        execute: async (args) => {
+            const serviceName = String(args.service_name || '').trim();
+            if (!serviceName)
+                return { success: false, error: 'service_name 必填 (先用 registry_discover 查)' };
+            try {
+                const { serviceCall } = await import('./agent-service-client.js');
+                // 尝试取 channel 钱包私钥 (autoPay)
+                let privateKey;
+                try {
+                    const wallet = await ctx.getChannelWallet?.();
+                    if (wallet?.encryptedPrivateKey)
+                        privateKey = wallet.encryptedPrivateKey;
+                }
+                catch { /* 无钱包 */ }
+                let argsObj = {};
+                try {
+                    argsObj = JSON.parse(String(args.args || '{}'));
+                }
+                catch {
+                    argsObj = {};
+                }
+                const r = await serviceCall({
+                    serviceName,
+                    args: argsObj,
+                    privateKey,
+                    maxPaymentAmount: String(args.max_payment_amount || '').trim() || undefined,
+                });
+                if (!r.success)
+                    return { success: false, error: r.error, service: r.service?.service?.name };
+                return { success: true, output: r.output, paid: r.paid, txHash: r.txHash };
+            }
+            catch (e) {
+                return { success: false, error: `service_call 失败: ${String(e?.message || e).slice(0, 200)}` };
+            }
+        },
+    });
+    // 2026-08-13 (Phase E3): Policy Engine — 预算/授权 (安全核心, 私钥不暴露给 LLM)
+    ctx.tools.set('policy_config', {
+        name: 'policy_config',
+        description: '查看/更新支付策略 (预算/白名单). LLM 只能查看预算与授权规则, 私钥由 Policy Engine 隔离保管. 查看: 无参数; 更新: 传要改的字段 (per_transaction_limit/daily_limit/allowed_recipients/allowed_services).',
+        parameters: {
+            per_transaction_limit: '可选: 单笔上限 (数字)',
+            daily_limit: '可选: 每日预算 (数字)',
+            allowed_recipients: '可选: 允许收款方数组',
+            allowed_services: '可选: 允许服务数组',
+        },
+        execute: async (args) => {
+            try {
+                const { getEconomicPolicy } = await import('./economic-policy.js');
+                const policy = getEconomicPolicy();
+                const patch = {};
+                if (args.per_transaction_limit !== undefined)
+                    patch.perTransactionLimit = Number(args.per_transaction_limit);
+                if (args.daily_limit !== undefined)
+                    patch.dailyLimit = Number(args.daily_limit);
+                if (Array.isArray(args.allowed_recipients))
+                    patch.allowedRecipients = args.allowed_recipients.map(String);
+                if (Array.isArray(args.allowed_services))
+                    patch.allowedServices = args.allowed_services.map(String);
+                if (Object.keys(patch).length > 0)
+                    policy.updateConfig(patch);
+                const spent = await policy.dailySpent();
+                const c = policy.config();
+                return {
+                    success: true,
+                    output: `支付策略:\n  单笔上限: $${c.perTransactionLimit}\n  每日预算: $${c.dailyLimit} (今日已用 $${spent})\n  允许收款方: ${c.allowedRecipients.length ? c.allowedRecipients.join(', ') : '(全部)'}\n  允许服务: ${c.allowedServices.length ? c.allowedServices.join(', ') : '(全部)'}\n  速率: ${c.rateLimitPerMinute}/min`,
+                };
+            }
+            catch (e) {
+                return { success: false, error: `policy_config 失败: ${String(e?.message || e).slice(0, 200)}` };
+            }
+        },
+    });
+    // 2026-08-13 (Phase M4): Reputation — 服务结果记录 + 信誉查询 (Agent Economic Protocol §7)
+    ctx.tools.set('reputation_update', {
+        name: 'reputation_update',
+        description: '记录一次服务结果, 更新服务提供者的信誉 (success/failed/disputed → score). 服务完成后调用. agent_id: 服务提供者 DID; service_name: 服务名; outcome: success|failed|disputed.',
+        parameters: { agent_id: '服务提供者 agent_id (必填)', service_name: '服务名 (必填)', outcome: '结果: success|failed|disputed (必填)' },
+        execute: async (args) => {
+            try {
+                const { recordServiceOutcome } = await import('./agent-reputation.js');
+                const agentId = String(args.agent_id || '').trim();
+                const serviceName = String(args.service_name || '').trim();
+                const outcome = String(args.outcome || '').trim();
+                if (!agentId || !serviceName || !['success', 'failed', 'disputed'].includes(outcome)) {
+                    return { success: false, error: 'agent_id/service_name/outcome(success|failed|disputed) 必填' };
+                }
+                const r = await recordServiceOutcome(agentId, serviceName, outcome);
+                if (!r.ok)
+                    return { success: false, error: r.error };
+                return { success: true, output: `✅ 已记录 ${outcome}: tasks=${r.reputation?.tasks}, score=${r.reputation?.score}` };
+            }
+            catch (e) {
+                return { success: false, error: `reputation_update 失败: ${String(e?.message || e).slice(0, 200)}` };
+            }
+        },
+    });
+    ctx.tools.set('reputation_query', {
+        name: 'reputation_query',
+        description: '查询 Agent 的信誉 (成功率/任务数). agent_id: 服务提供者 DID; service_name: 可选. 选择服务前先查信誉.',
+        parameters: { agent_id: '服务提供者 agent_id (必填)', service_name: '服务名 (可选)' },
+        execute: async (args) => {
+            try {
+                const { queryReputation, formatReputation } = await import('./agent-reputation.js');
+                const r = await queryReputation(String(args.agent_id || '').trim(), String(args.service_name || '').trim() || undefined);
+                if (!r.ok)
+                    return { success: true, output: r.error || '(无信誉记录)' };
+                return { success: true, output: r.entries.map((e) => `  [${e.service}] ${formatReputation(e.reputation)}`).join('\n') };
+            }
+            catch (e) {
+                return { success: false, error: `reputation_query 失败: ${String(e?.message || e).slice(0, 200)}` };
+            }
+        },
+    });
     // ============================================================
     // publish_did (2026-08-03) — 把当前 agent 的 DID 发布到 IPFS + IPNS
     // 全自动: 自动安装/启动本地 Kubo → 上传 DID 文档 → 发布 IPNS name

package/dist/pi-ecosystem-a2ui/index.js

@@ -0,0 +1,81 @@
+/**
+ * a2ui.ts — A2UI (Agent to UI) 协议集成 (2026-08-12)
+ *
+ * bolloon agent 生成 A2UI 消息 (createSurface / updateComponents / updateDataModel / deleteSurface),
+ * 经 SSE 广播给前端 (web / 手机端 Capacitor), 前端用 @a2ui/react renderer 渲染.
+ *
+ * 参考: https://a2ui.org/specification/v1.0-a2ui/ + D:\AI\A2UI (本地 spec 源码)
+ *
+ * 机制:
+ *   - agent 工具 (a2ui_create_surface 等) 生成 A2UI JSON 消息
+ *   - dispatchA2uiMessage → broadcast({ type: 'a2ui', message }) 给前端
+ *   - 前端 MessageProcessor 接收渲染 (A2uiSurface)
+ */
+/** broadcast 注入点 (server 调用 setA2uiBroadcast 注入, 关联 SSE /events) */
+let a2uiBroadcast = null;
+export function setA2uiBroadcast(fn) {
+    a2uiBroadcast = fn;
+}
+/** 广播一条 A2UI 消息给所有前端 */
+export function broadcastA2uiMessage(message) {
+    if (!a2uiBroadcast)
+        return false;
+    a2uiBroadcast({ type: 'a2ui', message });
+    return true;
+}
+/** 校验 + 广播一条 A2UI 消息 (agent 工具 execute 调用) */
+export function dispatchA2uiMessage(message) {
+    const type = message?.type;
+    const surfaceId = String(message?.surfaceId || '').trim();
+    if (!type || !['createSurface', 'updateComponents', 'updateDataModel', 'deleteSurface'].includes(type)) {
+        return { success: false, output: 'type 必须是 createSurface/updateComponents/updateDataModel/deleteSurface' };
+    }
+    if (!surfaceId)
+        return { success: false, output: 'surfaceId 必填' };
+    const ok = broadcastA2uiMessage({ type, surfaceId, ...message });
+    return { success: ok, output: ok ? `已广播 A2UI ${type} (surface=${surfaceId})` : 'A2UI 广播未连接' };
+}
+/**
+ * agent 工具注册表 (a2ui-* 工具定义). 由 pi-sdk-tools 注册为 agent 工具.
+ */
+export const A2UI_TOOL_DEFS = [
+    {
+        name: 'a2ui_create_surface',
+        description: '创建 A2UI surface (前端渲染区). surfaceId: 渲染区标识. 用户想要一个动态 UI 面板/表单/卡片时先创建 surface.',
+        params: { surfaceId: '渲染区 id (必填)', title: 'surface 标题 (可选)' },
+        build: (a) => ({ type: 'createSurface', surfaceId: String(a.surfaceId || ''), title: String(a.title || '') }),
+    },
+    {
+        name: 'a2ui_update_components',
+        description: '向 A2UI surface 添加/更新组件 (componentTree JSON). 前端用 @a2ui/react 渲染. components: 组件树 JSON 数组 (Text/Column/Button 等 basicCatalog 组件).',
+        params: { surfaceId: '渲染区 id (必填)', components: '组件树 JSON (必填, e.g. [{"type":"text","data":{"text":"你好"}}])' },
+        build: (a) => {
+            let components = a.components;
+            if (typeof components === 'string') {
+                try {
+                    components = JSON.parse(components);
+                }
+                catch {
+                    components = [];
+                }
+            }
+            return { type: 'updateComponents', surfaceId: String(a.surfaceId || ''), components };
+        },
+    },
+    {
+        name: 'a2ui_update_data',
+        description: '更新 A2UI surface 的数据模型. path: 数据路径 (如 /user/name), value: 数据值.',
+        params: { surfaceId: '渲染区 id (必填)', path: '数据路径 (必填)', value: '数据值' },
+        build: (a) => ({ type: 'updateDataModel', surfaceId: String(a.surfaceId || ''), path: String(a.path || ''), value: a.value }),
+    },
+    {
+        name: 'a2ui_delete_surface',
+        description: '删除 A2UI surface (移除前端渲染区). surfaceId: 渲染区 id.',
+        params: { surfaceId: '渲染区 id (必填)' },
+        build: (a) => ({ type: 'deleteSurface', surfaceId: String(a.surfaceId || '') }),
+    },
+];
+/** 工具名 → build 函数 */
+export function a2uiToolDef(name) {
+    return A2UI_TOOL_DEFS.find((t) => t.name === name);
+}