@bolloon/bolloon-agent 0.4.18 → 0.4.20

package/dist/agents/agent-registry.js

@@ -13,6 +13,8 @@ import * as path from 'path';
 import { getCIDDatabase } from '../orbitdb/cid-database.js';
 const home = () => process.env.HOME || os.homedir() || '/tmp';
 export const REGISTRY_ORBIT_KEY = 'services';
+/** 网络启动包 meta 键 (networkId/name/version/capacityOfMembers/sharedContextCid) */
+export const REGISTRY_ORBIT_META_KEY = 'meta';
 /** OrbitDB store 名 (按 did 短名确定性) */
 export function registryStoreName(did) {
     const short = String(did || 'local').replace(/[^a-zA-Z0-9-]/g, '_').slice(0, 40) || 'local';
@@ -118,6 +120,28 @@ export class OrbitDBAgentRegistry {
             return orbit;
         return this.loadLocalFromDisk();
     }
+    async writeMeta(meta) {
+        if (!this.ready || !this._store)
+            return { ok: false, error: 'registry store 未就绪 (离线模式)' };
+        try {
+            await this._store.put(REGISTRY_ORBIT_META_KEY, meta);
+            return { ok: true };
+        }
+        catch (e) {
+            return { ok: false, error: String(e?.message || e).slice(0, 120) };
+        }
+    }
+    async readMeta() {
+        if (!this.ready || !this._store)
+            return null;
+        try {
+            const v = await this._store.get(REGISTRY_ORBIT_META_KEY);
+            return v && typeof v === 'object' ? v : null;
+        }
+        catch {
+            return null;
+        }
+    }
     async discover(query) {
         const all = await this.list();
         const q = String(query || '').trim().toLowerCase();

package/dist/agents/gateway-network.js

@@ -182,30 +182,34 @@ export async function joinNetwork(link, deps) {
     // 合并到本地 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) {
+    const remoteServices = Array.isArray(remote) ? remote : [];
+    const { merged, joined } = mergeRemoteServices(remoteServices, local);
+    for (const svc of merged) {
+        if (!local.some((l) => l.agentId === svc.agentId && l.service?.name === svc.service?.name)) {
             await registry.register(svc).catch(() => { });
-            joined++;
         }
     }
-    // 记录成员身份 (持久化 → 重启后自动恢复)
+    // ① 网络启动包 (meta): 拉网络声明 (networkId/名称/版本/容量/共享context CID), 尽力而为
+    const meta = await fetchNetworkMeta(parsed).catch(() => null);
+    const bootstrap = buildNetworkBootstrap(meta);
+    // 记录成员身份 (持久化 → 重启后自动恢复) + 网络启动包信息
     await saveNetworks([
         ...existing,
         {
             link: norm,
             linkKey: identityKey,
             kind: parsed.kind,
-            name: parsed.networkName,
+            name: bootstrap.name || parsed.networkName,
             joinedAt: new Date().toISOString(),
-            serviceCount: remote.length,
+            serviceCount: remoteServices.length,
             lastSyncAt: new Date().toISOString(),
+            networkId: bootstrap.networkId,
+            version: bootstrap.version,
+            capacityOfMembers: bootstrap.capacityOfMembers,
+            sharedContextCid: bootstrap.sharedContextCid,
         },
     ]);
-    return { ok: true, joined, total: remote.length, linkKind: parsed.kind, networkName: parsed.networkName };
+    return { ok: true, joined, total: remoteServices.length, linkKind: parsed.kind, networkName: bootstrap.name || parsed.networkName, networkId: bootstrap.networkId, sharedContextCid: bootstrap.sharedContextCid };
 }
 /** 启动恢复: 重拉所有已加入网络 (失败静默, 保留记录). 返回恢复统计. */
 export async function restoreJoinedNetworks() {
@@ -228,6 +232,156 @@ export async function restoreJoinedNetworks() {
     }
     return { restored, failed, total: nets.length };
 }
+/** 把任意 meta 对象规整成 NetworkBootstrap (纯函数, 容错) */
+export function buildNetworkBootstrap(meta) {
+    const m = meta && typeof meta === 'object' ? meta : {};
+    const str = (v) => (typeof v === 'string' && v.trim() ? v.trim() : undefined);
+    return {
+        networkId: str(m.networkId),
+        name: str(m.name),
+        version: str(m.version),
+        capacityOfMembers: typeof m.capacityOfMembers === 'number' ? m.capacityOfMembers : undefined,
+        sharedContextCid: str(m.sharedContextCid),
+    };
+}
+/** 拉取网络 meta (尽力而为, 失败返回 null): orbitdb('meta' 键) / ipns(network.json) / http(doc.meta) */
+async function fetchNetworkMeta(parsed) {
+    try {
+        if (parsed.kind === 'http') {
+            const r = await fetch(parsed.url, { signal: AbortSignal.timeout(15000) });
+            if (!r.ok)
+                return null;
+            const d = await r.json();
+            return d?.meta ?? null;
+        }
+        if (parsed.kind === 'ipns') {
+            const r = await fetch(`http://127.0.0.1:8080/ipns/${parsed.name}/network.json`, { signal: AbortSignal.timeout(15000) });
+            if (!r.ok)
+                return null;
+            const d = await r.json();
+            return d?.meta ?? d;
+        }
+        if (parsed.kind === 'orbitdb') {
+            const { getCIDDatabase } = await import('../orbitdb/cid-database.js');
+            const db = getCIDDatabase();
+            const store = await db.openStoreByAddress(parsed.address, 'keyvalue');
+            if (!store)
+                return null;
+            const v = await store.get('meta').catch(() => null);
+            return v ?? null;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/** 纯函数: 远端服务并入本地 (按 agentId + service.name 去重), 返回合并结果 + 新增数 */
+export function mergeRemoteServices(remote, local) {
+    const out = local.slice();
+    let joined = 0;
+    for (const svc of remote) {
+        if (!svc?.agentId || !svc?.service?.name)
+            continue;
+        const exists = out.some((l) => l.agentId === svc.agentId && l.service?.name === svc.service?.name);
+        if (!exists) {
+            out.push(svc);
+            joined++;
+        }
+    }
+    return { merged: out, joined };
+}
+/** ② 拉取网络画像 (只读, 不落盘): 供 on-join 告知 agent "网络里有什么" */
+export async function pullNetworkProfile(link) {
+    const parsed = parseNetworkLink(link);
+    if (!parsed)
+        return null;
+    let services = null;
+    if (parsed.kind === 'http')
+        services = await fetchRemoteRegistry(parsed.url);
+    else if (parsed.kind === 'ipns')
+        services = await fetchIpnsRegistry(parsed.name);
+    else if (parsed.kind === 'orbitdb')
+        services = await fetchOrbitdbRegistry(parsed.address);
+    const meta = await fetchNetworkMeta(parsed).catch(() => null);
+    if (!services || services.length === 0)
+        return null;
+    return { bootstrap: buildNetworkBootstrap(meta), members: services };
+}
+/**
+ * ③ 成员自描述广播: 把本机服务声明(list .agentId 匹配 self)写回共享网络 store ('services' 合并 self).
+ *   ① ipns/http 无回写 → 只本地登记 (返回 note); ② orbitdb replica 只读时写穿失败 → 非致命 (返回 note).
+ *   opts.members: 本机要广播的成员声明 (通常 = 自己注册的 AgentService 列表).
+ */
+export async function networkShareSelf(link, members, opts) {
+    if (!members || members.length === 0)
+        return { ok: true, note: '无本机成员声明可广播' };
+    const parsed = parseNetworkLink(link);
+    if (!parsed)
+        return { ok: false, error: '链接无法解析' };
+    if (parsed.kind !== 'orbitdb') {
+        return { ok: true, note: `${parsed.kind} 无回写能力, 已本地登记 (发起方自托管 registry 应含本机)` };
+    }
+    try {
+        const { getCIDDatabase } = await import('../orbitdb/cid-database.js');
+        const db = getCIDDatabase();
+        const store = await db.openStoreByAddress(parsed.address, 'keyvalue');
+        if (!store)
+            return { ok: false, error: '网络 store 不可达' };
+        const cur = (await store.get('services').catch(() => null));
+        const arr = Array.isArray(cur) ? cur.slice() : [];
+        for (const m of members) {
+            const i = arr.findIndex((s) => s.agentId === m.agentId && s.service?.name === m.service?.name);
+            const entry = { ...m, updatedAt: new Date().toISOString(), registeredAt: m.registeredAt || new Date().toISOString() };
+            if (i >= 0)
+                arr[i] = entry;
+            else
+                arr.push(entry);
+        }
+        await store.put('services', arr);
+        return { ok: true, note: `已广播 ${members.length} 条本机声明到网络` };
+    }
+    catch (e) {
+        return { ok: false, error: `写穿失败(疑似只读 replica): ${String(e?.message || e).slice(0, 120)}`, note: '已在本地登记, 可在你的分享链接中带上本机' };
+    }
+}
+/**
+ * ① 拉取共享 context (由启动包 sharedContextCid 指向): 从本地 IPFS 网关读文本返回,
+ *   调用方负责注入本地 context (了解"所有信息"的最后一段).
+ */
+export async function pullNetworkSharedContext(cid) {
+    try {
+        const r = await fetch(`http://127.0.0.1:8080/ipfs/${cid}`, { signal: AbortSignal.timeout(15000) });
+        if (!r.ok)
+            return null;
+        return await r.text();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * ① 发布共享 context 到 OrbitDB (内容寻址), 返回 CID — 供 shareNetworkLink 的 sharedContextCid,
+ *   手机/PC 入网后拉取即"近期上下文同步". opts.share=true 时把块放入 helia blockstore 供网络拉取.
+ */
+export async function publishNetworkSharedContext(text, opts) {
+    try {
+        const { getCIDDatabase } = await import('../orbitdb/cid-database.js');
+        const db = getCIDDatabase();
+        const rec = await db.save({ agentId: opts?.agentId || 'bolloon-network', type: 'context', content: text });
+        let cid = rec.id;
+        if (opts?.share !== false) {
+            try {
+                cid = await db.share(cid);
+            }
+            catch { /* 分享失败仍可用 CID 读 */ }
+        }
+        return { ok: true, cid };
+    }
+    catch (e) {
+        return { ok: false, error: String(e?.message || e).slice(0, 140) };
+    }
+}
 // ============ 分享链接 ============
 /**
  * 生成本机可分享的网络链接: orbitdb://<registry storeAddress>?name=<网络名>.
@@ -244,8 +398,24 @@ export async function shareNetworkLink(opts) {
         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}` };
+        // ① 全量启动包: 把 networkId/名称/版本/容量/共享context CID 写进共享 store (尽力而为, 失败仍分享)
+        const networkId = opts?.meta?.networkId || registry.storeName;
+        const name = String(opts?.name || opts?.meta?.name || registry.storeName || 'bolloon-network');
+        const metaObj = {
+            networkId,
+            name,
+            version: opts?.meta?.version,
+            capacityOfMembers: opts?.meta?.capacityOfMembers,
+            sharedContextCid: opts?.meta?.sharedContextCid,
+        };
+        let note;
+        if (registry.writeMeta) {
+            const w = await registry.writeMeta(metaObj).catch(() => ({ ok: false, error: 'writeMeta 异常' }));
+            if (!w.ok)
+                note = `meta 写共享库失败 (${w.error || '未知'}) — 读方仍可拉到服务, 但拿不到启动包`;
+        }
+        const encodedName = encodeURIComponent(name);
+        return { ok: true, link: `orbitdb://${registry.storeAddress}?name=${encodedName}`, note };
     }
     catch (e) {
         return { ok: false, error: `生成分享链接失败: ${String(e?.message || e).slice(0, 160)}` };
@@ -268,7 +438,15 @@ export async function maybeAutoJoinGateway(text, deps) {
             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 调用网络里的服务。`;
+            // ② on-join 广播: 写入自己的服务声明 (orbitdb 可回写时), 非致命
+            let selfNote = '';
+            if (deps?.self && deps.self.length > 0) {
+                const s = await networkShareSelf(link, deps.self, deps).catch(() => null);
+                selfNote = s?.ok ? ' · 已广播本机声明' : (s?.note ? ` · ${s.note}` : ' · 本机声明广播失败');
+            }
+            const bootPart = r.networkId ? ` (net=${String(r.networkId).slice(0, 16)})` : '';
+            const ctxPart = r.sharedContextCid ? ` · 共享ctx:${String(r.sharedContextCid).slice(0, 12)}` : '';
+            return `🆕 已自动加入 Agent 网络${netName}${bootPart} (${r.linkKind}): 拉取 ${r.total} 个服务, 新增 ${r.joined} 个${ctxPart}${selfNote}。用 gateway_status 查看, gateway_call 调用网络里的服务。`;
         }
         return `⚠️ 检测到 Agent 网络链接 (${r.linkKind || 'unknown'}) 但加入失败: ${r.error}`;
     }

package/dist/agents/network-link.js

@@ -0,0 +1,33 @@
+// ─── 网络链接纯函数 (无 Node 依赖, 桌面/手机浏览器共用) ────────────────────
+//   parseNetworkLink / detectGatewayLink 从 gateway-network.ts 抽出,
+//   供 browser 端 (mobile-gateway) 复用, 不拖 OrbitDB/fs 进 WebView.
+/** 解析链接字符串 → ParsedNetworkLink (剥离 ?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', value: base.slice('ipns://'.length), url: base, networkName };
+    if (base.startsWith('orbitdb://')) {
+        let address = base.slice('orbitdb://'.length);
+        if (!address.startsWith('/'))
+            address = `/${address}`;
+        return { kind: 'orbitdb', value: address, url: base, networkName };
+    }
+    if (base.startsWith('http://') || base.startsWith('https://'))
+        return { kind: 'http', value: base, url: base, networkName };
+    return null;
+}
+/** 从消息文本检测 gateway 链接 (自动加入触发器用) */
+export function detectGatewayLink(text) {
+    const t = String(text || '');
+    const re = /(orbitdb:\/\/\/?orbitdb\/[^\s)'"<>，。；]+|ipns:\/\/[^\s)'"<>，。；]+|https?:\/\/[^\s)'"<>，。；]*\/registry(?:\?[^\s)'"<>，。；]*)?)/;
+    const m = re.exec(t);
+    return m ? m[1].trim() : null;
+}

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

@@ -2083,6 +2083,261 @@ export function registerBuiltinTools(ctx) {
         }
     });
     // ============================================================
+    // 数字资源资产化 (Stage 1-4): 注册→运营(发现/匹配)→交易(x402)→清算(信誉)
+    // ============================================================
+    ctx.tools.set('resource_register', {
+        name: 'resource_register',
+        description: '注册一个数字资源 (A 轻版: 内容CID寻址 + 元数据同步网络 registry; 预留 chain=evm 可升级 tokenURI). type: data|art_product|product_image|tx_link; 内容寻址存 content, 定价/授权/交易链接/收款钱包进资源记录, 供网络内智能体 resource_discover/match/purchase 发现并交易.',
+        parameters: {
+            type: 'data | art_product | product_image | tx_link',
+            title: '资源标题',
+            content: '资源内容 (文本/JSON; 图片 base64 dataURL)',
+            wallet: '可选收款钱包地址 (Stage 3 交易用)',
+            price: '可选 {amount,currency:USDC|token,token?,per?} 字符串或JSON',
+            license: '可选授权 (personal/commercial)',
+            txLink: '可选交易链接',
+            chain: '可选 none|evm (预留升级)',
+            tokenUriTemplate: '可选 evm 时 tokenURI 模板, 如 {base}/{id}',
+        },
+        execute: async (args) => {
+            try {
+                const { getCIDDatabase } = await import('../orbitdb/cid-database.js');
+                const db = getCIDDatabase();
+                const cidd = {
+                    save: async (t) => (await db.save({ agentId: String(ctx.agentId || ''), type: 'knowledge', content: t })).id,
+                    load: async (c) => { const rec = await db.load(c); return rec ? String(rec.content ?? '') : null; },
+                };
+                const { getAgentRegistry } = await import('./agent-registry.js');
+                const { registerResource } = await import('./resource-store.js');
+                let price;
+                if (args.price) {
+                    try {
+                        price = typeof args.price === 'string' ? JSON.parse(args.price) : args.price;
+                    }
+                    catch {
+                        price = undefined;
+                    }
+                }
+                const { loadOrCreateWallet } = await import('./resource-wallet.js');
+                const nw = await loadOrCreateWallet().catch(() => null);
+                const walletAddr = nw?.address || '';
+                const r = await registerResource({
+                    ownerDid: String(ctx.agentId || ''),
+                    type: String(args.type || ''),
+                    title: String(args.title || ''),
+                    content: String(args.content || ''),
+                    wallet: args.wallet ? String(args.wallet) : walletAddr || undefined,
+                    price,
+                    license: args.license ? String(args.license) : undefined,
+                    txLink: args.txLink ? String(args.txLink) : undefined,
+                    chain: args.chain,
+                    tokenUriTemplate: args.tokenUriTemplate ? String(args.tokenUriTemplate) : undefined,
+                }, { cid: cidd, registry: getAgentRegistry() });
+                if (!r.ok)
+                    return { success: false, error: r.error };
+                const res = r.resource;
+                return { success: true, output: `✅ 资源已注册 (A 轻版上链): ${res.resourceId}\n  ${res.title} · ${res.type} · CID: ${res.contentCid}${res.wallet ? ` · 钱包 ${res.wallet}` : ''}${res.price ? ` · 价格 ${res.price.amount} ${res.price.currency}${res.price.token ? `(${res.price.token})` : ''}` : ''}${res.license ? ` · ${res.license}` : ''}${res.txLink ? ` · 交易:${res.txLink}` : ''}${res.chain === 'evm' ? ` · ${res.chain}` : ''}\n已同步网络 registry: 智能体可用 resource_discover/match 找到, resource_purchase 交易/访问。` };
+            }
+            catch (e) {
+                return { success: false, error: `resource_register 失败: ${String(e).slice(0, 200)}` };
+            }
+        },
+    });
+    ctx.tools.set('resource_discover', {
+        name: 'resource_discover',
+        description: '发现数字资源 (本机 + 网络 registry): 按 type 或 owner 列出 (谁注册了什么, 定价/授权/交易链接), 供分配/交易决策.',
+        parameters: { type: '可选过滤 type', owner: '可选过滤 owner DID' },
+        execute: async (args) => {
+            try {
+                const { getAgentRegistry } = await import('./agent-registry.js');
+                const { listResources } = await import('./resource-store.js');
+                const list = await listResources({
+                    type: args.type ? String(args.type) : undefined,
+                    owner: args.owner ? String(args.owner) : undefined,
+                }, { registry: getAgentRegistry() });
+                if (!list.length)
+                    return { success: true, output: '暂无资源 (用 resource_register 注册)' };
+                return { success: true, output: list.map((r) => `${r.resourceId} · ${r.title} · ${r.type}${r.price ? ` · ${r.price.amount} ${r.price.currency}${r.price.token ? `(${r.price.token})` : ''}${r.price.per ? `/${r.price.per}` : ''}` : ''}${r.license ? ` · ${r.license}` : ''}${r.txLink ? ` · 🔗${r.txLink}` : ''}${r.wallet ? ` · 钱包 ${String(r.wallet).slice(0, 10)}…` : ''}${r.chain === 'evm' ? ' · evm' : ''}`).join('\n') + '\n（resource_purchase <id> 交易/访问）' };
+            }
+            catch (e) {
+                return { success: false, error: `resource_discover 失败: ${String(e).slice(0, 200)}` };
+            }
+        },
+    });
+    ctx.tools.set('resource_match', {
+        name: 'resource_match',
+        description: '自动分配匹配: 按需求关键词对资源打分 (标题/类型/授权 + 提供者信誉加权), 返回推荐排序. 用于智能体自动分配资源.',
+        parameters: { query: '需求关键词' },
+        execute: async (args) => {
+            try {
+                const { getAgentRegistry } = await import('./agent-registry.js');
+                const { queryReputation } = await import('./agent-reputation.js');
+                const registry = getAgentRegistry();
+                const { matchResources } = await import('./resource-store.js');
+                const repQuery = async (owner, type) => {
+                    try {
+                        const q = await queryReputation(owner, type, registry);
+                        const e = q.entries?.[0];
+                        return { score: e?.reputation?.score ?? 0, tasks: e?.reputation?.tasks ?? 0, success: e?.reputation?.success ?? 0, failed: e?.reputation?.failed ?? 0 };
+                    }
+                    catch {
+                        return { score: 0, tasks: 0, success: 0, failed: 0 };
+                    }
+                };
+                const scored = await matchResources(String(args.query || ''), { registry, repQuery });
+                if (!scored.length)
+                    return { success: true, output: '无匹配资源' };
+                return { success: true, output: scored.map((s) => `${s.resource.resourceId} · ${s.resource.title} · ${s.resource.type} · 得分 ${Math.round(s.score * 10) / 10}${s.resource.license ? ` · ${s.resource.license}` : ''}`).join('\n') };
+            }
+            catch (e) {
+                return { success: false, error: `resource_match 失败: ${String(e).slice(0, 200)}` };
+            }
+        },
+    });
+    ctx.tools.set('resource_purchase', {
+        name: 'resource_purchase',
+        description: '交易/访问资源: 付费资源走 x402 支付后解锁内容 (结算更新提供者信誉), 免费资源直接取回内容.',
+        parameters: { resourceId: '资源 id' },
+        execute: async (args) => {
+            try {
+                const { getCIDDatabase } = await import('../orbitdb/cid-database.js');
+                const db = getCIDDatabase();
+                const cidd = {
+                    save: async (t) => (await db.save({ agentId: String(ctx.agentId || ''), type: 'knowledge', content: t })).id,
+                    load: async (c) => { const rec = await db.load(c); return rec ? String(rec.content ?? '') : null; },
+                };
+                const { getAgentRegistry } = await import('./agent-registry.js');
+                const { queryReputation } = await import('./agent-reputation.js');
+                const registry = getAgentRegistry();
+                const { purchaseResource } = await import('./resource-store.js');
+                const pay = async (spec) => {
+                    try {
+                        const { x402Pay } = await import('./x402/x402Pay.js');
+                        const { loadOrCreateWallet } = await import('./resource-wallet.js');
+                        const w = await loadOrCreateWallet().catch(() => null);
+                        if (!w?.privateKey)
+                            return { success: false, error: '需自动生成 x402 钱包 (~/.bolloon/wallet.json) 才能购买付费资源' };
+                        const r = await x402Pay({ privateKey: w.privateKey, amount: String(spec.amount), to: spec.recipient, currency: spec.currency === 'USDC' ? 'USDC' : 'ETH', memo: spec.memo });
+                        return { success: r.success, txHash: r.txHash, error: r.error };
+                    }
+                    catch (e) {
+                        return { success: false, error: `x402 支付失败: ${String(e?.message || e).slice(0, 120)}` };
+                    }
+                };
+                const repQuery = async (owner, type) => {
+                    try {
+                        const q = await queryReputation(owner, type, registry);
+                        const e = q.entries?.[0];
+                        return { score: e?.reputation?.score ?? 0, tasks: e?.reputation?.tasks ?? 0, success: e?.reputation?.success ?? 0, failed: e?.reputation?.failed ?? 0 };
+                    }
+                    catch {
+                        return { score: 0, tasks: 0, success: 0, failed: 0 };
+                    }
+                };
+                const onSettle = (outcome, resource) => {
+                    void import('./agent-reputation.js').then((m) => m.recordServiceOutcome(resource.ownerDid, `resource:${resource.type}`, outcome, registry)).catch(() => { });
+                };
+                const r = await purchaseResource(String(args.resourceId || ''), { cid: cidd, pay, repQuery, onSettle });
+                if (!r.ok)
+                    return { success: false, error: r.error || (r.needPay ? '需要支付' : '失败') };
+                return { success: true, output: `${r.txHash ? `💰 已支付 (tx ${String(r.txHash).slice(0, 16)}…) · ` : ''}📄 ${r.resource.title} (${r.resource.type})\n${String(r.content || '').slice(0, 3000)}` };
+            }
+            catch (e) {
+                return { success: false, error: `resource_purchase 失败: ${String(e).slice(0, 200)}` };
+            }
+        },
+    });
+    ctx.tools.set('resource_reputation', {
+        name: 'resource_reputation',
+        description: '清算/信誉: 查资源提供者信誉 (成交记录+score), 供自动分配加权决策.',
+        parameters: { owner: 'owner DID (缺省=本机)' },
+        execute: async (args) => {
+            try {
+                const { getAgentRegistry } = await import('./agent-registry.js');
+                const { queryReputation } = await import('./agent-reputation.js');
+                const registry = getAgentRegistry();
+                const owner = String(args.owner || ctx.agentId || '');
+                const q = await queryReputation(owner, undefined, registry);
+                if (!q.entries?.length)
+                    return { success: true, output: `${owner.slice(0, 16)}… 暂无信誉记录` };
+                return { success: true, output: q.entries.map((e) => `  ${e.service} · ${e.reputation.score} (${e.reputation.success}/${e.reputation.tasks} 成交)`).join('\n') };
+            }
+            catch (e) {
+                return { success: false, error: `resource_reputation 失败: ${String(e).slice(0, 200)}` };
+            }
+        },
+    });
+    // ── Stage 1-B: EVM 资产合约 (ERC-721, CID 作 tokenURI) 铸造/流转/查询 ──
+    ctx.tools.set('resource_mint', {
+        name: 'resource_mint',
+        description: '把已注册数字资源铸成 ERC-721 token (内容 CID 作 tokenURI, 不可变随 token 流转). 需配置 EVM executor (部署 contracts/ResourceERC721.sol + 设 __bolloonEvmExecutor 或用 ethers/viem).',
+        parameters: { resourceId: '资源 id' },
+        execute: async (args) => {
+            try {
+                const { getResource } = await import('./resource-store.js');
+                const { mintResourceToken } = await import('./resource-token.js');
+                const r = await getResource(String(args.resourceId || ''));
+                if (!r)
+                    return { success: false, error: '资源不存在' };
+                const evm = globalThis.__bolloonEvmExecutor;
+                if (!evm)
+                    return { success: false, error: '需配置 EVM executor (__bolloonEvmExecutor) 才能铸造. 部署 contracts/ResourceERC721.sol + 配置 ~/.bolloon/evm-config.json / ethers.' };
+                const { walletAddress } = await import('./resource-wallet.js');
+                const naddr = await walletAddress().catch(() => '');
+                const to = r.wallet || naddr;
+                if (!to)
+                    return { success: false, error: '无收款钱包 (部署后设 __bolloonEvmExecutor + 资源 wallet)' };
+                const m = await mintResourceToken({ resourceId: r.resourceId, ownerDid: r.ownerDid, contentCid: r.contentCid, wallet: to, title: r.title }, { evm });
+                if (!m.ok)
+                    return { success: false, error: m.error || (m.needConfig ? '需配置 EVM' : '铸造失败') };
+                return { success: true, output: `✅ 已铸造 tokenId=${m.tokenId} · tokenURI=ipfs://${r.contentCid} · 资源 ${r.resourceId}\n(resource_transfer <tokenId> <to> 流转 · resource_token <tokenId> 查询)` };
+            }
+            catch (e) {
+                return { success: false, error: `resource_mint 失败: ${String(e).slice(0, 200)}` };
+            }
+        },
+    });
+    ctx.tools.set('resource_transfer', {
+        name: 'resource_transfer',
+        description: '流转 ERC-721 token 所有权 (safeTransferFrom) 到新地址.',
+        parameters: { tokenId: 'token id', to: '接收 EVM 地址' },
+        execute: async (args) => {
+            try {
+                const { transferResourceToken } = await import('./resource-token.js');
+                const evm = globalThis.__bolloonEvmExecutor;
+                if (!evm)
+                    return { success: false, error: '需配置 EVM executor (__bolloonEvmExecutor)' };
+                const r = await transferResourceToken(String(args.tokenId || ''), String(args.to || ''), { evm });
+                if (!r.ok)
+                    return { success: false, error: r.error || '流转失败' };
+                return { success: true, output: `✅ 已流转 token ${r.tokenId} → ${args.to}` };
+            }
+            catch (e) {
+                return { success: false, error: `resource_transfer 失败: ${String(e).slice(0, 200)}` };
+            }
+        },
+    });
+    ctx.tools.set('resource_token', {
+        name: 'resource_token',
+        description: '查询 ERC-721 token: owner + tokenURI (内容 CID).',
+        parameters: { tokenId: 'token id' },
+        execute: async (args) => {
+            try {
+                const { queryResourceToken } = await import('./resource-token.js');
+                const evm = globalThis.__bolloonEvmExecutor;
+                if (!evm)
+                    return { success: false, error: '需配置 EVM executor (__bolloonEvmExecutor)' };
+                const r = await queryResourceToken(String(args.tokenId || ''), { evm });
+                if (!r.ok)
+                    return { success: false, error: r.error || '查询失败' };
+                return { success: true, output: `🔎 token ${args.tokenId}\n  owner: ${r.owner || 'n/a'}\n  tokenURI: ${r.tokenUri || 'n/a'}` };
+            }
+            catch (e) {
+                return { success: false, error: `resource_token 失败: ${String(e).slice(0, 200)}` };
+            }
+        },
+    });
+    // ============================================================
     // MCP 工具 (2026-08-03) — 外部 MCP server 接入 agent 工具系统
     // 配置: ~/.mcp.json (mcpServers), 启动时 initializeMcpAdapter 自动握手发现工具
     // mcp_list_tools: 列出已发现的 MCP 工具