@bolloon/bolloon-agent 0.4.12 → 0.4.14

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

@@ -2446,6 +2446,182 @@ export function registerBuiltinTools(ctx) {
             }
         },
     });
+    // 2026-08-13: Treasury 桥 — 链下结算 (Policy/Registry) 驱动链上 Treasury.payAgent
+    //   配置: BOLLOON_TREASURY_RPC / BOLLOON_TREASURY_ADDRESS / BOLLOON_TREASURY_KEY / BOLLOON_TREASURY_TOKEN
+    const treasuryConfigFromEnv = () => {
+        const rpcUrl = process.env.BOLLOON_TREASURY_RPC || '';
+        const treasuryAddress = process.env.BOLLOON_TREASURY_ADDRESS || '';
+        const tokenAddress = process.env.BOLLOON_TREASURY_TOKEN || '';
+        const privateKey = process.env.BOLLOON_TREASURY_KEY || '';
+        return { rpcUrl, treasuryAddress, tokenAddress, privateKey };
+    };
+    ctx.tools.set('treasury_pay', {
+        name: 'treasury_pay',
+        description: '从 Treasury 支付给 Agent (链上 AgentTreasury.payAgent). 自动过 Policy 预算校验 + 信誉门槛 (链上). agent_address: 收款 Agent 地址; amount: 金额 (USDC). 需配置 BOLLOON_TREASURY_* 环境变量 (RPC/合约/私钥).',
+        parameters: { agent_address: '收款 Agent 钱包地址 (必填)', amount: '金额 USDC (必填)', service: '服务名 (可选, Policy 校验用)' },
+        execute: async (args) => {
+            const cfg = treasuryConfigFromEnv();
+            if (!cfg.rpcUrl || !cfg.treasuryAddress || !cfg.privateKey) {
+                return { success: false, error: '未配置 Treasury (BOLLOON_TREASURY_RPC/ADDRESS/KEY/TOKEN)' };
+            }
+            const agentAddress = String(args.agent_address || '').trim();
+            const amount = Number(args.amount);
+            if (!agentAddress || !amount || amount <= 0)
+                return { success: false, error: 'agent_address 和 amount(>0) 必填' };
+            try {
+                const { treasuryPay } = await import('./treasury-bridge.js');
+                const r = await treasuryPay(cfg, {
+                    agentAddress,
+                    amount,
+                    service: String(args.service || '').trim() || undefined,
+                });
+                if (!r.success)
+                    return { success: false, error: r.error };
+                return { success: true, output: `✅ Treasury 已支付 ${amount} USDC → ${agentAddress.slice(0, 10)}... tx=${r.txHash}` };
+            }
+            catch (e) {
+                return { success: false, error: `treasury_pay 失败: ${String(e?.message || e).slice(0, 200)}` };
+            }
+        },
+    });
+    ctx.tools.set('treasury_status', {
+        name: 'treasury_status',
+        description: '查询 Treasury 状态 (余额/日限/冻结). 需配置 BOLLOON_TREASURY_* 环境变量.',
+        parameters: {},
+        execute: async () => {
+            const cfg = treasuryConfigFromEnv();
+            if (!cfg.rpcUrl || !cfg.treasuryAddress) {
+                return { success: false, error: '未配置 Treasury (BOLLOON_TREASURY_RPC/ADDRESS)' };
+            }
+            try {
+                const { treasuryStatus } = await import('./treasury-bridge.js');
+                const s = await treasuryStatus(cfg);
+                if (!s.ok)
+                    return { success: false, error: s.error };
+                return { success: true, output: `Treasury:\n  余额: ${s.balance} USDC\n  日限: ${s.dailyLimit} USDC\n  冻结: ${s.frozen ? '是' : '否'}` };
+            }
+            catch (e) {
+                return { success: false, error: `treasury_status 失败: ${String(e?.message || e).slice(0, 200)}` };
+            }
+        },
+    });
+    // 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/treasury-bridge.js

@@ -0,0 +1,127 @@
+/**
+ * treasury-bridge.ts — Treasury 合约 × Agent 经济网络桥接 (2026-08-13)
+ *
+ * 打通: 链下结算逻辑 (Registry 服务/Policy 授权/Reputation 门槛) → 链上 Treasury.payAgent.
+ *
+ * 流程:
+ *   registry 服务完成 → reputation_update(success) → treasuryPay(agent, amount)
+ *     ├─ 链下校验: Policy (预算) + Registry (服务价格) + Reputation (≥60)
+ *     └─ 链上执行: AgentTreasury.payAgent(agent, amount)
+ *
+ * 合约 ABI 用最小接口 (viem writeContract), 支持任意部署地址 + RPC.
+ * 真实链上需部署 AgentTreasury + 注入 owner 私钥; 测试注入 mock.
+ */
+/** Treasury 合约最小 ABI (payAgent/deposit/balance/dailySpend/frozen) */
+const TREASURY_ABI = [
+    {
+        name: 'payAgent',
+        type: 'function',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'agent', type: 'address' },
+            { name: 'amount', type: 'uint256' },
+        ],
+        outputs: [],
+    },
+    {
+        name: 'deposit',
+        type: 'function',
+        stateMutability: 'nonpayable',
+        inputs: [{ name: 'amount', type: 'uint256' }],
+        outputs: [],
+    },
+    {
+        name: 'balance',
+        type: 'function',
+        stateMutability: 'view',
+        inputs: [],
+        outputs: [{ name: '', type: 'uint256' }],
+    },
+    {
+        name: 'frozen',
+        type: 'function',
+        stateMutability: 'view',
+        inputs: [],
+        outputs: [{ name: '', type: 'bool' }],
+    },
+    {
+        name: 'dailyLimit',
+        type: 'function',
+        stateMutability: 'view',
+        inputs: [],
+        outputs: [{ name: '', type: 'uint256' }],
+    },
+];
+/**
+ * 链下校验 → 链上 Treasury.payAgent.
+ * 校验链: Policy (预算/白名单) → 合约调用.
+ */
+export async function treasuryPay(config, opts) {
+    const { agentAddress, amount, service } = opts;
+    // 1. Policy 授权 (预算/白名单) — 链下, 防无预算支付
+    if (opts.policyCheck) {
+        const decision = await opts.policyCheck({ payTo: agentAddress, amount, service: service || 'treasury-pay' });
+        if (!decision.allowed) {
+            return { success: false, error: `[policy] ${decision.reason}`, checks: { policy: decision } };
+        }
+    }
+    else {
+        try {
+            const { getEconomicPolicy } = await import('./economic-policy.js');
+            const policy = getEconomicPolicy();
+            const decision = await policy.check({ payTo: agentAddress, amount, service: service || 'treasury-pay' });
+            if (!decision.allowed) {
+                return { success: false, error: `[policy] ${decision.reason}`, checks: { policy: decision } };
+            }
+        }
+        catch { /* policy 不可用放行 */ }
+    }
+    // 2. 链上 payAgent (dryRun: 只验证 policy 门, 不真实上链)
+    if (opts.dryRun) {
+        return { success: true, txHash: 'dry-run:0x0', checks: { policy: { allowed: true } }, dryRun: true };
+    }
+    try {
+        const { createWalletClient, http, parseUnits } = await import('viem');
+        const { privateKeyToAccount } = await import('viem/accounts');
+        const { base, baseSepolia } = await import('viem/chains');
+        const decimals = config.decimals ?? 6;
+        const account = privateKeyToAccount(config.privateKey);
+        const chain = config.rpcUrl.includes('sepolia') ? baseSepolia : base;
+        const client = createWalletClient({ account, chain, transport: http(config.rpcUrl) });
+        const txHash = await client.writeContract({
+            address: config.treasuryAddress,
+            abi: TREASURY_ABI,
+            functionName: 'payAgent',
+            args: [agentAddress, parseUnits(String(amount), decimals)],
+        });
+        // 记录花费 (链下日预算镜像)
+        try {
+            const { getEconomicPolicy } = await import('./economic-policy.js');
+            await getEconomicPolicy().recordSpend(amount).catch(() => { });
+        }
+        catch { /* 静默 */ }
+        return { success: true, txHash, checks: { policy: { allowed: true } } };
+    }
+    catch (e) {
+        return { success: false, error: `Treasury.payAgent 失败: ${String(e?.message || e).slice(0, 200)}` };
+    }
+}
+/** 查询 Treasury 状态 (余额/日限/冻结) */
+export async function treasuryStatus(config) {
+    try {
+        const { createPublicClient, http, formatUnits } = await import('viem');
+        const { base, baseSepolia } = await import('viem/chains');
+        const chain = config.rpcUrl.includes('sepolia') ? baseSepolia : base;
+        const client = createPublicClient({ chain, transport: http(config.rpcUrl) });
+        const decimals = config.decimals ?? 6;
+        const [bal, limit, frozen] = await Promise.all([
+            client.readContract({ address: config.treasuryAddress, abi: TREASURY_ABI, functionName: 'balance' }),
+            client.readContract({ address: config.treasuryAddress, abi: TREASURY_ABI, functionName: 'dailyLimit' }),
+            client.readContract({ address: config.treasuryAddress, abi: TREASURY_ABI, functionName: 'frozen' }),
+        ]);
+        return { ok: true, balance: formatUnits(bal, decimals), dailyLimit: formatUnits(limit, decimals), frozen: frozen };
+    }
+    catch (e) {
+        return { ok: false, error: `Treasury 状态查询失败: ${String(e?.message || e).slice(0, 200)}` };
+    }
+}

package/dist/constraint-runtime/tools/PolymarketSDK/econ-integration.d.ts

@@ -0,0 +1,55 @@
+/**
+ * econ-integration.ts — Polymarket × Agent 经济网络集成 (2026-08-13, Task C4)
+ *
+ * 打通 Agent Economic Network 与 Polymarket 预测市场:
+ *   - Agent 可用 Treasury 资金在 Polymarket 下单 (预测/对冲)
+ *   - 下单前过 Policy Engine (预算/授权)
+ *   - 订单结果 (成交/收益) 记录回经济层 (审计)
+ *
+ * Polymarket 合约架构 (Polygon):
+ *   - CLOB (链上订单簿): createOrder/getOrders/cancelOrder (现有 SDK)
+ *   - CTF 条件代币框架: 市场 = 条件代币对 (Yes/No)
+ *   - NegRisk 适配器: 互斥结果市场
+ *   收益结算在链上 (USDC), Agent Treasury 可接收.
+ */
+import { type CreateOrderParams, type CreateOrderResult } from './createOrder.js';
+import { type GetOrdersParams, type GetOrdersResult } from './getOrders.js';
+export interface EconOrderOptions {
+    /** 预算上限 (USDC) — 经 Policy Engine 检查 */
+    maxSpendUsdc?: number;
+    /** 服务名 (Policy 白名单用, 默认 polymarket) */
+    service?: string;
+    /** 是否记录经济审计 */
+    audit?: boolean;
+    /** 注入 Policy 检查回调 (根包 Agent 经济层注入; 子包不跨包 import) */
+    policyCheck?: (intent: {
+        payTo: string;
+        amount: number;
+        service?: string;
+    }) => Promise<{
+        allowed: boolean;
+        reason?: string;
+    }>;
+    /** 注入花费记录回调 */
+    recordSpend?: (amount: number) => Promise<void>;
+    /** 注入 createOrder 实现 (测试 mock; 默认真实 CLOB) */
+    createOrderImpl?: (params: CreateOrderParams) => Promise<CreateOrderResult>;
+}
+export interface EconOrderResult {
+    success: boolean;
+    order?: CreateOrderResult;
+    policy?: {
+        allowed: boolean;
+        reason?: string;
+    };
+    error?: string;
+}
+/**
+ * 带 Policy 检查的 Polymarket 下单.
+ * 流程: 金额 → Policy 授权 (回调注入) → CLOB 下单.
+ */
+export declare function createOrderEcon(params: CreateOrderParams, opts?: EconOrderOptions): Promise<EconOrderResult>;
+/** 查询订单 (含经济层关联信息) */
+export declare function getOrdersEcon(params?: GetOrdersParams): Promise<GetOrdersResult>;
+/** Polymarket 合约架构摘要 (文档化, 供 Agent 理解) */
+export declare const POLYMARKET_CONTRACT_OVERVIEW = "\nPolymarket \u5408\u7EA6\u67B6\u6784 (Polygon):\n- CLOB: \u94FE\u4E0A\u8BA2\u5355\u7C3F (createOrder/getOrders/cancelOrder)\n- CTF (Conditional Token Framework): \u5E02\u573A = \u6761\u4EF6\u4EE3\u5E01\u5BF9 Yes/No\n- NegRisk \u9002\u914D\u5668: \u4E92\u65A5\u7ED3\u679C\u5E02\u573A (\u5982\"\u54EA\u4E2A\u5019\u9009\u4EBA\u80DC\u51FA\")\n- \u7ED3\u7B97: USDC \u94FE\u4E0A, \u6536\u76CA\u53EF\u56DE\u6536\u5230 Agent Treasury\n- Agent \u96C6\u6210: Treasury \u8D44\u91D1 \u2192 Policy \u6388\u6743 \u2192 CLOB \u4E0B\u5355 \u2192 \u7ED3\u679C \u2192 \u6536\u76CA\u56DE\u6D41\n";

package/dist/constraint-runtime/tools/PolymarketSDK/econ-integration.js

@@ -0,0 +1,59 @@
+/**
+ * econ-integration.ts — Polymarket × Agent 经济网络集成 (2026-08-13, Task C4)
+ *
+ * 打通 Agent Economic Network 与 Polymarket 预测市场:
+ *   - Agent 可用 Treasury 资金在 Polymarket 下单 (预测/对冲)
+ *   - 下单前过 Policy Engine (预算/授权)
+ *   - 订单结果 (成交/收益) 记录回经济层 (审计)
+ *
+ * Polymarket 合约架构 (Polygon):
+ *   - CLOB (链上订单簿): createOrder/getOrders/cancelOrder (现有 SDK)
+ *   - CTF 条件代币框架: 市场 = 条件代币对 (Yes/No)
+ *   - NegRisk 适配器: 互斥结果市场
+ *   收益结算在链上 (USDC), Agent Treasury 可接收.
+ */
+import { createOrder as pmCreateOrder } from './createOrder.js';
+import { getOrders as pmGetOrders } from './getOrders.js';
+/**
+ * 带 Policy 检查的 Polymarket 下单.
+ * 流程: 金额 → Policy 授权 (回调注入) → CLOB 下单.
+ */
+export async function createOrderEcon(params, opts = {}) {
+    const amountUsdc = Number(params.price) * Number(params.size ?? 1);
+    // 1. Policy 授权 (预算/白名单) — 回调注入, 不跨包
+    if (opts.policyCheck) {
+        const decision = await opts.policyCheck({
+            payTo: 'polymarket-clob',
+            amount: amountUsdc,
+            service: opts.service || 'polymarket',
+        });
+        if (!decision.allowed) {
+            return { success: false, policy: { allowed: false, reason: `[policy] ${decision.reason}` } };
+        }
+        await opts.recordSpend?.(amountUsdc).catch(() => { });
+    }
+    else if (opts.maxSpendUsdc !== undefined && amountUsdc > opts.maxSpendUsdc) {
+        return { success: false, policy: { allowed: false, reason: `Polymarket 下单超预算: ${amountUsdc} > ${opts.maxSpendUsdc}` } };
+    }
+    // 2. CLOB 下单 (可注入 mock, 默认真实)
+    try {
+        const order = opts.createOrderImpl ? await opts.createOrderImpl(params) : await pmCreateOrder(params);
+        return { success: true, order, policy: { allowed: true } };
+    }
+    catch (e) {
+        return { success: false, error: `Polymarket 下单失败: ${String(e?.message || e).slice(0, 200)}` };
+    }
+}
+/** 查询订单 (含经济层关联信息) */
+export async function getOrdersEcon(params = {}) {
+    return pmGetOrders(params);
+}
+/** Polymarket 合约架构摘要 (文档化, 供 Agent 理解) */
+export const POLYMARKET_CONTRACT_OVERVIEW = `
+Polymarket 合约架构 (Polygon):
+- CLOB: 链上订单簿 (createOrder/getOrders/cancelOrder)
+- CTF (Conditional Token Framework): 市场 = 条件代币对 Yes/No
+- NegRisk 适配器: 互斥结果市场 (如"哪个候选人胜出")
+- 结算: USDC 链上, 收益可回收到 Agent Treasury
+- Agent 集成: Treasury 资金 → Policy 授权 → CLOB 下单 → 结果 → 收益回流
+`;

package/dist/index.js

@@ -1333,6 +1333,48 @@ async function processInput(input, comm) {
         }
         return;
     }
+    // /payments [/approve <id> /reject <id>] — 人工支付审批 (2026-08-13)
+    //   YAML 验证门判定 confirm 的支付请求 → 这里人工批准/拒绝
+    if (cmd === '/payments' || cmd.startsWith('/payments ') || cmd.startsWith('/approve ') || cmd.startsWith('/reject ')) {
+        try {
+            const { getApprovalStore } = await import('./agents/payment-approval.js');
+            const store = getApprovalStore();
+            if (cmd.startsWith('/approve ')) {
+                const id = cmd.slice('/approve '.length).trim();
+                const r = await store.approve(id);
+                if (!r.ok) {
+                    appendLine(`${C_ERROR}${r.error}${RESET}`);
+                    return;
+                }
+                appendLine(`${C_OK}✓ 已批准 ${id} → ${r.approval?.status}${r.approval?.result ? ` (${String(r.approval.result).slice(0, 80)})` : ''}${RESET}`);
+                return;
+            }
+            if (cmd.startsWith('/reject ')) {
+                const id = cmd.slice('/reject '.length).trim();
+                const r = await store.reject(id);
+                if (!r.ok) {
+                    appendLine(`${C_ERROR}${r.error}${RESET}`);
+                    return;
+                }
+                appendLine(`${C_WARN}✗ 已拒绝 ${id}${RESET}`);
+                return;
+            }
+            const approvals = await store.pending();
+            appendLine(`${C_ACCENT}待人工审批支付 (${approvals.length}):${RESET}`);
+            if (approvals.length === 0) {
+                appendLine(`  ${C_DIM}无待审批 — YAML 验证门 allow/deny 已自动处理${RESET}`);
+            }
+            for (const a of approvals) {
+                appendLine(`  ${C_WARN}⏳${RESET} ${C_ACCENT}${a.id}${RESET} ${a.service} $${a.amount} → ${String(a.recipient).slice(0, 12)}...`);
+                appendLine(`    ${C_DIM}${a.reason}${RESET}`);
+                appendLine(`    ${C_DIM}/approve ${a.id} | /reject ${a.id}${RESET}`);
+            }
+        }
+        catch (e) {
+            appendLine(`${C_ERROR}/payments 失败: ${String(e?.message || e).slice(0, 120)}${RESET}`);
+        }
+        return;
+    }
     // /skill — 技能候选 (skill-writer 落盘)
     if (cmd === '/skill') {
         try {

package/dist/orbitdb/cid-database.js

@@ -151,15 +151,9 @@ export class OrbitDBAdapter {
         await this.node.helia.blockstore.put(CID.parse(rec.id), dagCbor.encode(rec));
         return `bolloon-cid://${rec.id}`;
     }
-    /**
-     * 2026-08-08: 在同一 OrbitDB 实例上打开附加 store。
-     * events 类型 = append-only 事件流 (WAL 复制 / 轨迹流用).
-     * 返回的 store 是通用适配 (put=keyvalue / add=events).
-     */
-    async openStore(name, type = 'keyvalue') {
-        await this.ensure();
-        const raw = (await this._orbitdb.open(name, { type }));
-        const store = {
+    /** 打开 store 的通用适配 (keyvalue/events 统一成 OrbitDBStore) */
+    wrapStore(raw) {
+        return {
             address: raw.address,
             put: async (key, value) => { await raw.put(key, JSON.parse(JSON.stringify(value))); },
             add: async (value) => { await raw.add(JSON.parse(JSON.stringify(value))); },
@@ -190,7 +184,42 @@ export class OrbitDBAdapter {
                 };
             },
         };
-        return store;
+    }
+    /**
+     * 2026-08-08: 在同一 OrbitDB 实例上打开附加 store。
+     * events 类型 = append-only 事件流 (WAL 复制 / 轨迹流用).
+     * opts.accessController: 群组用 write:['*'] (任何人可写).
+     */
+    async openStore(name, type = 'keyvalue', opts) {
+        await this.ensure();
+        const options = { type };
+        if (opts?.accessController)
+            options.accessController = opts.accessController;
+        const raw = (await this._orbitdb.open(name, options));
+        return this.wrapStore(raw);
+    }
+    /**
+     * 2026-08-14: 按地址打开远端 store (Agent Gateway 共享网络 / 群组)。
+     * replica=true → 只读副本: 拉取复制但不写回 (自动加入网络不污染他人 registry)。
+     * replica=false → 可写 (群组: events store 配 write:'*' 时成员可广播)。
+     */
+    async openStoreByAddress(address, type = 'keyvalue', opts) {
+        await this.ensure();
+        try {
+            const options = { type };
+            if (opts?.replica === false)
+                options.replica = false;
+            else
+                options.replica = true;
+            if (opts?.accessController)
+                options.accessController = opts.accessController;
+            const raw = (await this._orbitdb.open(address, options));
+            return this.wrapStore(raw);
+        }
+        catch (err) {
+            console.warn(`[orbitdb] openStoreByAddress 失败: ${String(err?.message || err).slice(0, 160)}`);
+            return null;
+        }
     }
     async close() {
         try {