@bolloon/bolloon-agent 0.4.26 → 0.4.28

package/dist/index.js

@@ -1449,6 +1449,109 @@ async function processInputInner(input, comm) {
         }
         return;
     }
+    // 2026-09-18 (Phase 4): /tx [transactionId] —— 交易审计 (里程碑/争议/责任/结算事实)
+    if (cmd === '/tx' || cmd.startsWith('/tx ')) {
+        const id = trimmed.slice('/tx'.length).trim().split(/\s+/).filter(Boolean)[0];
+        try {
+            const { listTransactions, readTransaction, replayTransaction } = await import('./agents/x402/transaction-store.js');
+            const MILE = await import('./agents/x402/milestone-settlement.js');
+            if (!id) {
+                const txs = await listTransactions();
+                if (!txs.length) {
+                    appendLine(`${C_DIM}还没有交易记录 (~/.bolloon/transactions/)${RESET}`);
+                    return;
+                }
+                appendLine(`${C_DIM}最近 ${txs.length} 笔交易 (生命周期 + 结算事实 两层):${RESET}`);
+                for (const t of txs.slice(-12)) {
+                    const agg = t.milestones?.length ? MILE.aggregateMilestones(t.milestones) : null;
+                    appendLine(`  ${C_DIM}${t.transactionId} ${RESET}${String(t.status).padEnd(18)} 结算=${String(t.settlementFact || '?').padEnd(18)} ${t.amount || '?'} ${t.currency || ''}${agg ? ` · 里程碑 ${agg.verified}/${agg.total}` : ''}${t.dispute ? ' · ⚠争议' : ''}`);
+                }
+                appendLine(`${C_DIM}/tx <transactionId> 看完整审计 (含证据链回放)${RESET}`);
+                return;
+            }
+            const rec = await readTransaction(id);
+            if (!rec) {
+                appendLine(`${C_ERROR}没有这笔交易: ${id}${RESET}`);
+                return;
+            }
+            appendLine(`  ${C_DIM}交易 ${rec.transactionId} · ${rec.status} · 结算 ${rec.settlementFact} · 链上=${rec.chainSettled === true} txHash=${rec.txHash || '(无)'}${RESET}`);
+            appendLine(`  ${C_DIM}资源 ${rec.itemId} · ${rec.amount} ${rec.currency} · ${rec.network} · 付款方式 ${rec.paymentMode}${RESET}`);
+            if (rec.milestones?.length) {
+                const agg = MILE.aggregateMilestones(rec.milestones);
+                appendLine(`  ${C_DIM}里程碑 ${agg.verified}/${agg.total} 完成 → ${agg.settlementFact}: ${agg.reason}${RESET}`);
+                for (const m of rec.milestones)
+                    appendLine(`    ${C_DIM}${m.milestoneId} ${m.title} ${m.amount} [付:${m.paymentStatus} 交:${m.deliveryStatus} 验:${m.verificationStatus}]${RESET}`);
+            }
+            if (rec.dispute)
+                appendLine(`  ${C_ERROR}争议: ${rec.dispute.reason} (缺证据 ${rec.dispute.missingEvidence.length} 项, ${rec.dispute.resolution ? `已收尾: ${rec.dispute.resolution.decision}` : '未收尾'})${RESET}`);
+            if (rec.responsibility)
+                appendLine(`  ${C_DIM}责任候选: ${rec.responsibility.type} — ${rec.responsibility.reason}${RESET}`);
+            const elig = MILE.milestoneGoalEligibility(rec, { executionOk: rec.execution?.ok === true, goalCriteriaHit: rec.goalCriteriaMet === true });
+            appendLine(`  ${C_DIM}Goal 成功证据资格: ${elig.eligible ? '✓' : '✗'} ${elig.reason}${RESET}`);
+            const lines = await replayTransaction(id);
+            appendLine(`  ${C_DIM}证据链 (${lines.length} 条):${RESET}`);
+            for (const l of lines)
+                appendLine(`    ${C_DIM}${l}${RESET}`);
+        }
+        catch (e) {
+            appendLine(`${C_ERROR}/tx 失败: ${String(e?.message || e).slice(0, 200)}${RESET}`);
+        }
+        return;
+    }
+    // 2026-09-18: /trace [runId] [--json] —— 智能体工具执行轨迹 (真跑过什么工具/结果/耗时), 可复制交换
+    if (cmd === '/trace' || cmd.startsWith('/trace ')) {
+        const rest = trimmed.slice('/trace'.length).trim();
+        try {
+            const { listRuns, readRun } = await import('./agents/run-store.js');
+            const { runToTraceText, runToTraceJson, summarizeTrace } = await import('./agents/trace-export.js');
+            const wantJson = rest.includes('--json');
+            const runId = rest.split(/\s+/).find((a) => a && !a.startsWith('--'));
+            if (!runId) {
+                const runs = await listRuns({ limit: 12 });
+                if (!runs.length) {
+                    appendLine(`${C_DIM}还没有运行记录 (每次智能体运行都落盘 ~/.bolloon/runs/)${RESET}`);
+                    return;
+                }
+                appendLine(`${C_DIM}最近 ${runs.length} 次运行的工具执行轨迹:${RESET}`);
+                for (const r of runs)
+                    appendLine(`  ${C_DIM}${r.runId} [${r.status}] ${RESET}${summarizeTrace(r)}`);
+                appendLine(`${C_DIM}/trace <runId> 看完整轨迹 (文本可复制交换) · /trace <runId> --json 机器可读${RESET}`);
+                return;
+            }
+            const run = await readRun(runId);
+            if (!run) {
+                appendLine(`${C_ERROR}没有这个运行: ${runId}${RESET}`);
+                return;
+            }
+            if (wantJson) {
+                appendLine(JSON.stringify(runToTraceJson(run), null, 2));
+                return;
+            }
+            for (const line of runToTraceText(run).split('\n'))
+                appendLine(`  ${C_DIM}${line}${RESET}`);
+        }
+        catch (e) {
+            appendLine(`${C_ERROR}/trace 失败: ${String(e?.message || e).slice(0, 200)}${RESET}`);
+        }
+        return;
+    }
+    // 2026-09-18: /p2p [--json] —— 本机 P2P 连接信息 (peerId + 可拨入地址), 抄进名片/小工具递给对方
+    if (cmd === '/p2p' || cmd.startsWith('/p2p ')) {
+        try {
+            const { getLocalP2pInfo, formatP2pInfoText, formatP2pInfoJson } = await import('./agents/p2p-info.js');
+            const info = await getLocalP2pInfo();
+            if (trimmed.includes('--json')) {
+                appendLine(formatP2pInfoJson(info));
+                return;
+            }
+            for (const line of formatP2pInfoText(info).split('\n'))
+                appendLine(`  ${C_DIM}${line}${RESET}`);
+        }
+        catch (e) {
+            appendLine(`${C_ERROR}/p2p 失败: ${String(e?.message || e).slice(0, 200)}${RESET}`);
+        }
+        return;
+    }
     // 2026-09-16 (2-F): /criteria <goalId> [confirm|propose <text...>] —— 判据：看/确认/改/让 agent 提候选
     if (cmd === '/criteria' || cmd.startsWith('/criteria ')) {
         const rest = trimmed.slice('/criteria'.length).trim();

package/dist/web/routes-x402-info.js

@@ -107,6 +107,7 @@ export function registerX402InfoRoutes(app) {
             const pay = await checkAndSettlePayment({
                 paymentHeader: String(paymentHeader),
                 requirements,
+                expectedItemId: stored.item.id, // 凭据必须绑定这条资源 (防跨资源复用)
             });
             if (!pay.ok) {
                 return res.status(402).json({ ...requirements, error: pay.error });

package/dist/web/server.js

@@ -2949,6 +2949,88 @@ ${goalDesc}
         }
     });
     // 2026-09-16: 运行记录 (持久化 harness) — 当前 + 历史 agent 运行。跨重载可读。
+    // 2026-09-18: 智能体工具执行轨迹 + 本机 P2P 信息 (与小工具/名片交换用, 结构化)
+    // 2026-09-18 (Phase 4): 交易审计 — 里程碑 / 争议 / 责任 / 事件链 一眼可查
+    app.get('/api/x402/transactions', async (_req, res) => {
+        try {
+            const { listTransactions } = await import('../agents/x402/transaction-store.js');
+            const { aggregateMilestones } = await import('../agents/x402/milestone-settlement.js');
+            const txs = await listTransactions();
+            res.json({
+                count: txs.length,
+                transactions: txs.map((t) => ({
+                    transactionId: t.transactionId, status: t.status, settlementFact: t.settlementFact,
+                    itemId: t.itemId, amount: t.amount, currency: t.currency, network: t.network,
+                    paymentMode: t.paymentMode, chainSettled: t.chainSettled === true, txHash: t.txHash,
+                    milestones: t.milestones?.length ? aggregateMilestones(t.milestones) : null,
+                    disputed: !!t.dispute, disputeResolved: t.dispute?.resolution?.decision || null,
+                    responsibility: t.responsibility?.type || null,
+                    partial: t.settlementFact === 'partially_settled',
+                })),
+            });
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err?.message || err).slice(0, 200) });
+        }
+    });
+    app.get('/api/x402/transactions/:id', async (req, res) => {
+        try {
+            const { readTransaction, replayTransaction } = await import('../agents/x402/transaction-store.js');
+            const { aggregateMilestones, milestoneGoalEligibility } = await import('../agents/x402/milestone-settlement.js');
+            const rec = await readTransaction(req.params.id);
+            if (!rec)
+                return res.status(404).json({ error: '交易不存在' });
+            res.json({
+                transaction: rec,
+                milestones: rec.milestones?.length ? { list: rec.milestones, aggregate: aggregateMilestones(rec.milestones) } : null,
+                dispute: rec.dispute || null,
+                responsibility: rec.responsibility || null,
+                goalEligibility: milestoneGoalEligibility(rec, { executionOk: rec.execution?.ok === true, goalCriteriaHit: rec.goalCriteriaMet === true }),
+                replay: await replayTransaction(req.params.id),
+            });
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err?.message || err).slice(0, 200) });
+        }
+    });
+    app.get('/api/trace', async (req, res) => {
+        try {
+            const { listRuns } = await import('../agents/run-store.js');
+            const { runToTraceJson } = await import('../agents/trace-export.js');
+            const runs = await listRuns({ limit: Number(req.query.limit) || 20 });
+            res.json({ runs: runs.map((r) => runToTraceJson(r)) });
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err?.message || err).slice(0, 200) });
+        }
+    });
+    app.get('/api/trace/:runId', async (req, res) => {
+        try {
+            const { readRun } = await import('../agents/run-store.js');
+            const { runToTraceText, runToTraceJson } = await import('../agents/trace-export.js');
+            const run = await readRun(req.params.runId);
+            if (!run)
+                return res.status(404).json({ error: 'run 不存在' });
+            if (String(req.query.format || 'json') === 'text') {
+                res.type('text/plain; charset=utf-8').send(runToTraceText(run));
+                return;
+            }
+            res.json(runToTraceJson(run));
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err?.message || err).slice(0, 200) });
+        }
+    });
+    app.get('/api/p2p/info', async (_req, res) => {
+        try {
+            const { getLocalP2pInfo, formatP2pInfoJson } = await import('../agents/p2p-info.js');
+            const info = await getLocalP2pInfo();
+            res.type('application/json').send(formatP2pInfoJson(info));
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err?.message || err).slice(0, 200) });
+        }
+    });
     // 2026-09-16 (2-F/2-H): 判据 (criteria) + 长期执行面板 API —— CLI/Web 读同一份 Goal 事实
     app.get('/api/goals/:id/criteria', async (req, res) => {
         try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bolloon/bolloon-agent",
-  "version": "0.4.26",
+  "version": "0.4.28",
   "type": "module",
   "description": "P2P AI Document Agent - 全局安装后执行 `bolloon` 启动产品",
   "main": "dist/cli-entry.js",