@bolloon/bolloon-agent 0.4.12 → 0.4.14

package/dist/agents/agent-gateway.js

@@ -0,0 +1,130 @@
+/**
+ * agent-gateway.ts — Agent Gateway 协调层 (2026-08-14)
+ *
+ * Agent Economy 的"经济路由器": 统一入口, 内部编排所有已有层.
+ * 定位: 入口层 + 协调层 + 安全边界 (不是新系统, 是把 Registry/DIAP/x402/Policy/Reputation/Treasury 粘起来).
+ *
+ * 简单用法 (入口要小):
+ *   gateway.registerAgent({ capability: "research", price: "0.05 USDC" })
+ *   gateway.callAgent({ task: "analyze paper", budget: 1, capability: "research" })
+ *   gateway.joinNetwork(link)   // 通过链接自动加入共享网络
+ *
+ * callAgent 自动闭环:
+ *   Discovery (registry) → Identity (DIAP) → Negotiation (价格/预算匹配)
+ *   → Policy (预算/白名单) → Payment (x402/审批) → Execution → Reputation
+ */
+import { getAgentRegistry, warmAgentRegistry } from './agent-registry.js';
+import { getEconomicPolicy } from './economic-policy.js';
+import { getPaymentGate } from './payment-gate.js';
+import { getApprovalStore } from './payment-approval.js';
+import { recordServiceOutcome } from './agent-reputation.js';
+// ============ 协调层 ============
+/**
+ * 注册本 Agent 为服务提供者 (身份 + Registry + 信誉初始化).
+ */
+export async function gatewayRegisterAgent(config, identity, deps) {
+    // 2026-08-14: 生产路径先 warm OrbitDB — 否则注册只落本地文件, 分享链接指向的 store 是空的.
+    // 离线/测试环境 warm 失败不阻塞 (注册仍落本地 fallback).
+    let registry = deps?.registry;
+    if (!registry) {
+        try {
+            await warmAgentRegistry();
+        }
+        catch { /* 离线模式 */ }
+        registry = getAgentRegistry();
+    }
+    const r = await registry.register({
+        agentId: identity.did || `did:local:${identity.name}`,
+        name: identity.name,
+        wallet: config.wallet || identity.wallet,
+        service: {
+            name: config.capability,
+            description: config.description || `${config.capability} 服务`,
+            price: {
+                amount: config.price,
+                currency: (config.currency || 'USDC').toUpperCase(),
+                per: config.per || 'query',
+            },
+        },
+        capabilities: [config.capability],
+    });
+    return { ok: r.ok, error: r.error };
+}
+/**
+ * 调用 Agent 服务 (自动闭环).
+ * Discovery → Policy → Payment gate → Approval → Execution → Reputation.
+ */
+export async function gatewayCallAgent(opts) {
+    const { task, budget, capability, url, privateKey } = opts;
+    // 1. Discovery: 从 Registry 找 provider
+    const registry = getAgentRegistry();
+    const providers = capability ? await registry.discover(capability) : await registry.list();
+    if (providers.length === 0) {
+        return { success: false, error: `未找到能力为 '${capability || 'any'}' 的 Agent (先 joinNetwork 或注册)` };
+    }
+    const provider = providers[0]; // 简版: 取第一个 (完整版按信誉/价格排序)
+    const price = parseFloat(provider.service?.price?.amount || '0');
+    // 2. Negotiation: 预算检查
+    if (price > budget) {
+        return { success: false, error: `价格 ${price} 超预算 ${budget}`, provider: provider.agentId };
+    }
+    // 3. Payment gate (YAML 验证门): allow/confirm/deny
+    const gate = getPaymentGate();
+    const verdict = gate.evaluate({ service: provider.service?.name, amount: price, recipient: provider.wallet });
+    if (verdict.decision === 'deny') {
+        return { success: false, error: `[payment-gate] ${verdict.reason}`, provider: provider.agentId, decision: 'deny' };
+    }
+    // 4. Policy (预算/白名单)
+    const policy = getEconomicPolicy();
+    const pol = await policy.check({ payTo: provider.wallet, amount: price, service: provider.service?.name });
+    if (!pol.allowed) {
+        return { success: false, error: `[policy] ${pol.reason}`, provider: provider.agentId, decision: 'deny' };
+    }
+    // 5. confirm → 创建人工审批 (不自动执行)
+    if (verdict.decision === 'confirm') {
+        const store = getApprovalStore();
+        const approval = await store.create({
+            service: provider.service?.name || capability || 'service',
+            amount: price,
+            recipient: provider.wallet,
+            reason: verdict.reason,
+            retryPayload: { task, url, privateKey, serviceName: provider.service?.name, args: { task } },
+        });
+        return {
+            success: false,
+            error: `需人工确认: ${verdict.reason} (approval=${approval.id})`,
+            provider: provider.agentId,
+            decision: 'confirm',
+            requiresApproval: true,
+            approvalId: approval.id,
+        };
+    }
+    // 6. Execution (x402 支付 + 调用服务)
+    try {
+        const { serviceCall } = await import('./agent-service-client.js');
+        const r = await serviceCall({
+            serviceName: provider.service?.name || capability || 'service',
+            args: { task },
+            privateKey,
+            url,
+            registry,
+        });
+        if (!r.success)
+            return { success: false, error: r.error, provider: provider.agentId, decision: 'allow' };
+        // 7. Reputation: 记录成功
+        await recordServiceOutcome(provider.agentId, provider.service?.name || 'service', 'success', registry).catch(() => { });
+        return { success: true, provider: provider.agentId, decision: 'allow', output: r.output };
+    }
+    catch (e) {
+        return { success: false, error: `执行失败: ${String(e?.message || e).slice(0, 200)}`, provider: provider.agentId };
+    }
+}
+/**
+ * 查询网络状态 (注册表 + 信誉概览).
+ */
+export async function gatewayStatus() {
+    const registry = getAgentRegistry();
+    const services = await registry.list();
+    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}) rep=${s.reputation?.score ?? 'n/a'}`);
+    return `Agent 网络 (${services.length} 服务):\n${lines.join('\n') || '  (空, 先 joinNetwork 或注册)'}`;
+}

package/dist/agents/agent-service-client.js

@@ -30,12 +30,38 @@ export async function serviceCall(opts) {
     // 3. 调服务 (x402 自动支付: 402 → 签名 → 重试)
     try {
         const { x402Fetch } = await import('./x402/x402Pay.js');
+        // 2026-08-13: YAML 验证门 (不全部交给 AI) — 支付前先过 payment-policy.yaml 规则链
+        const { getPaymentGate } = await import('./payment-gate.js');
+        const gate = getPaymentGate();
+        const amount = parseFloat(service.service?.price?.amount || '0');
+        const gateVerdict = gate.evaluate({ service: service.service?.name, amount, recipient: service.wallet });
+        if (gateVerdict.decision === 'deny') {
+            return { success: false, error: `[payment-gate] ${gateVerdict.reason}`, service };
+        }
+        if (gateVerdict.decision === 'confirm') {
+            // 2026-08-13: 人工审批 — 创建 pending 审批请求 (不自动执行), UI/CLI 批准后重试
+            const { getApprovalStore } = await import('./payment-approval.js');
+            const store = getApprovalStore();
+            const approval = await store.create({
+                service: service.service?.name || serviceName,
+                amount,
+                recipient: service.wallet,
+                reason: gateVerdict.reason,
+                retryPayload: { serviceName, args, privateKey, maxPaymentAmount: maxPaymentAmount || service.service?.price?.amount },
+            });
+            return {
+                success: false,
+                error: `[payment-gate] 需人工确认: ${gateVerdict.reason} (approval=${approval.id}, 批准后自动执行)`,
+                service,
+                requiresApproval: true,
+                approvalId: approval.id,
+            };
+        }
         // Phase E3: Policy Engine 授权 (预算/白名单) — 通过才允许自动支付
         let effectiveKey = privateKey;
         if (privateKey) {
             const { getEconomicPolicy } = await import('./economic-policy.js');
             const policy = getEconomicPolicy();
-            const amount = parseFloat(service.service?.price?.amount || '0');
             const decision = await policy.check({
                 payTo: service.wallet,
                 amount,

package/dist/agents/gateway-group.js

@@ -0,0 +1,261 @@
+/**
+ * gateway-group.ts — Agent Gateway P2P 群组 (2026-08-14)
+ *
+ * 群组 = OrbitDB events store (accessController write:'*'), 任何成员可广播消息,
+ * 全成员通过 OrbitDB pubsub 复制实时同步. 链接: orbitdb://<addr>?type=group&name=<群名>.
+ *
+ * 符合用户习惯: 群组 = 微信式群聊 — 加入链接即进群, 发消息全网同步.
+ * 持久化: ~/.bolloon/gateway-groups.json (重启后仍是群成员, 自动重开 store).
+ */
+import * as os from 'os';
+import * as path from 'path';
+import { getCIDDatabase } from '../orbitdb/cid-database.js';
+// ============ 依赖注入 (测试用, 避免单测起真实 OrbitDB 节点) ============
+let _dbOverride = null;
+/** 测试用: 注入 fake CIDDatabase */
+export function setGroupTestDb(db) { _dbOverride = db; }
+function getDb() { return _dbOverride ?? getCIDDatabase(); }
+/** 测试用: 清空 store 缓存 / 订阅 (避免测试间污染) */
+export function resetGroupState() {
+    storeCache.clear();
+    onChangeCallbacks.clear();
+}
+// ============ 持久化 ============
+const groupsFile = () => path.join(os.homedir() || '/tmp', '.bolloon', 'gateway-groups.json');
+async function loadGroups() {
+    try {
+        const { readFile } = await import('fs/promises');
+        const parsed = JSON.parse(await readFile(groupsFile(), 'utf-8'));
+        return Array.isArray(parsed) ? parsed : [];
+    }
+    catch {
+        return [];
+    }
+}
+async function saveGroups(list) {
+    try {
+        const { mkdir, writeFile } = await import('fs/promises');
+        await mkdir(path.dirname(groupsFile()), { recursive: true });
+        await writeFile(groupsFile(), JSON.stringify(list, null, 2), 'utf-8');
+    }
+    catch { /* 持久化失败静默 */ }
+}
+// ============ 链接解析 ============
+/** 解析群组链接: orbitdb://<addr>?type=group&name=<群名> (type 非 group 返回 null) */
+export function parseGroupLink(link) {
+    const l = String(link || '').trim();
+    if (!l.startsWith('orbitdb://'))
+        return null;
+    const [base, query] = l.split('?');
+    let params = null;
+    try {
+        params = query ? new URLSearchParams(query) : null;
+    }
+    catch { /* 忽略 */ }
+    if (params && params.get('type') === 'group') {
+        let address = base.slice('orbitdb://'.length);
+        if (!address.startsWith('/'))
+            address = `/${address}`;
+        return { address, name: params.get('name') || undefined };
+    }
+    return null;
+}
+/** 从消息文本检测群组链接 */
+export function detectGroupLink(text) {
+    const t = String(text || '');
+    const re = /(orbitdb:\/\/\/?orbitdb\/[^\s)'"<>，。；]*\?[^\s)'"<>，。；]*type=group[^\s)'"<>，。；]*)/;
+    const m = re.exec(t);
+    return m ? m[1].trim() : null;
+}
+// ============ store 缓存 (避免重复 open) ============
+const storeCache = new Map();
+/** 订阅回调注册 (server 层挂 SSE 广播) */
+const onChangeCallbacks = new Map();
+function groupIdOf(address) {
+    // /orbitdb/zdpu... → zdpu... (地址后 12 位做短 id)
+    const m = /\/orbitdb\/(.{8,})/.exec(address);
+    return m ? m[1] : address;
+}
+/** 打开群组 store (缓存) — 可写 (replica=false, write:'*') */
+async function openGroupStore(address) {
+    const id = groupIdOf(address);
+    if (storeCache.has(id))
+        return storeCache.get(id);
+    const db = getDb();
+    const store = await db.openStoreByAddress(address, 'events', {
+        replica: false,
+        accessController: { write: ['*'] },
+    });
+    if (!store)
+        return null;
+    storeCache.set(id, store);
+    // 订阅: 新消息 → 通知回调 (server SSE)
+    store.onChange(() => {
+        groupMessages(id, 5).then((msgs) => {
+            if (msgs.length === 0)
+                return;
+            const cb = onChangeCallbacks.get(id);
+            if (cb)
+                for (const fn of cb) {
+                    try {
+                        fn(msgs[msgs.length - 1]);
+                    }
+                    catch { /* 忽略 */ }
+                }
+        }).catch(() => { });
+    });
+    return store;
+}
+/** 注册群组消息回调 (返回退订函数) */
+export function onGroupMessage(groupId, fn) {
+    if (!onChangeCallbacks.has(groupId))
+        onChangeCallbacks.set(groupId, new Set());
+    onChangeCallbacks.get(groupId).add(fn);
+    return () => { onChangeCallbacks.get(groupId)?.delete(fn); };
+}
+// ============ 群组操作 ============
+/**
+ * 创建群组: 新 events store (write:'*') + 持久化 + 生成邀请链接.
+ */
+export async function createGroup(name, opts) {
+    const groupName = String(name || '').trim() || `group-${Date.now().toString(36).slice(-4)}`;
+    try {
+        const db = getDb();
+        const store = await db.openStore(`bolloon-gw-group-${groupName}`, 'events', {
+            accessController: { write: ['*'] },
+        });
+        const address = store.address;
+        const id = groupIdOf(address);
+        const link = `orbitdb://${address}?type=group&name=${encodeURIComponent(groupName)}`;
+        const info = {
+            id, name: groupName, address, link,
+            createdAt: new Date().toISOString(),
+            lastSyncAt: new Date().toISOString(),
+        };
+        storeCache.set(id, store);
+        // 欢迎消息 (群主自我介绍)
+        const from = opts?.from || 'group-owner';
+        await store.add({ from, text: opts?.hello || `📢 群主创建了群「${groupName}」, 分享链接邀请成员加入`, ts: Date.now() });
+        const groups = await loadGroups();
+        await saveGroups([...groups.filter((g) => g.id !== id), info]);
+        return { ok: true, group: info };
+    }
+    catch (e) {
+        return { ok: false, error: `创建群组失败: ${String(e?.message || e).slice(0, 160)}` };
+    }
+}
+/**
+ * 通过链接加入群组: 打开 store (可写) + 持久化 + 幂等.
+ * 失败静默返回错误, 不影响本地.
+ */
+export async function joinGroup(link) {
+    const parsed = parseGroupLink(link);
+    if (!parsed) {
+        return { ok: false, error: '不是群组链接 (需要 orbitdb://...?type=group&name=...)' };
+    }
+    // 幂等: 按地址去重
+    const existing = await loadGroups();
+    const id = groupIdOf(parsed.address);
+    if (existing.some((g) => g.id === id)) {
+        return { ok: true, already: true, group: existing.find((g) => g.id === id) };
+    }
+    const store = await openGroupStore(parsed.address);
+    if (!store) {
+        return { ok: false, error: '群组 store 不可达 (群主节点需在线), 稍后重试或让群主分享最新链接' };
+    }
+    const name = parsed.name || id.slice(0, 12);
+    const info = {
+        id, name, address: parsed.address,
+        link: `orbitdb://${parsed.address}?type=group&name=${encodeURIComponent(name)}`,
+        createdAt: new Date().toISOString(),
+        lastSyncAt: new Date().toISOString(),
+    };
+    await saveGroups([...existing, info]);
+    return { ok: true, group: info };
+}
+/** 列出已加入的群组 */
+export async function listGroups() {
+    return loadGroups();
+}
+/** 获取群组 store 的最新消息 (ts 升序, 取最后 N 条) */
+export async function groupMessages(groupId, limit = 50) {
+    let store = storeCache.get(groupId) ?? null;
+    if (!store) {
+        const groups = await loadGroups();
+        const g = groups.find((x) => x.id === groupId);
+        if (!g)
+            return [];
+        store = await openGroupStore(g.address);
+        if (!store)
+            return [];
+    }
+    const all = await store.all().catch(() => []);
+    const msgs = [];
+    for (const entry of all) {
+        const v = entry.value;
+        if (v && typeof v.text === 'string' && typeof v.from === 'string') {
+            msgs.push({ from: v.from, text: v.text, ts: typeof v.ts === 'number' ? v.ts : 0 });
+        }
+    }
+    msgs.sort((a, b) => a.ts - b.ts);
+    return msgs.slice(-limit);
+}
+/** 群成员: 从消息里提取 from 去重 */
+export async function groupMembers(groupId) {
+    const msgs = await groupMessages(groupId, 500);
+    return Array.from(new Set(msgs.map((m) => m.from)));
+}
+/** 发送群消息 (广播给所有成员) */
+export async function groupSend(groupId, text, from) {
+    const msg = String(text || '').trim();
+    if (!msg)
+        return { ok: false, error: '消息不能为空' };
+    let store = storeCache.get(groupId) ?? null;
+    if (!store) {
+        const groups = await loadGroups();
+        const g = groups.find((x) => x.id === groupId);
+        if (!g)
+            return { ok: false, error: '群组不存在 (先 joinGroup)' };
+        store = await openGroupStore(g.address);
+        if (!store)
+            return { ok: false, error: '群组 store 不可达' };
+    }
+    try {
+        await store.add({ from: String(from || 'anonymous'), text: msg, ts: Date.now() });
+        return { ok: true };
+    }
+    catch (e) {
+        return { ok: false, error: `发送失败: ${String(e?.message || e).slice(0, 160)}` };
+    }
+}
+/** 群组邀请链接 */
+export async function groupLink(groupId) {
+    const groups = await loadGroups();
+    return groups.find((g) => g.id === groupId)?.link ?? null;
+}
+/** 群组信息 (含成员数/消息数) */
+export async function groupInfo(groupId) {
+    const groups = await loadGroups();
+    const g = groups.find((x) => x.id === groupId);
+    if (!g)
+        return null;
+    const msgs = await groupMessages(groupId, 500);
+    const members = await groupMembers(groupId);
+    return { ...g, messageCount: msgs.length, memberCount: members.length };
+}
+/** 重启恢复: 重开所有已加入群组的 store (失败静默) */
+export async function restoreGroups() {
+    const groups = await loadGroups();
+    if (groups.length === 0)
+        return { restored: 0, failed: 0, total: 0 };
+    let restored = 0;
+    let failed = 0;
+    for (const g of groups) {
+        const store = await openGroupStore(g.address).catch(() => null);
+        if (store)
+            restored++;
+        else
+            failed++;
+    }
+    return { restored, failed, total: groups.length };
+}