@bolloon/bolloon-agent 0.4.13 → 0.4.15

package/bin/bolloon-daemon.sh

@@ -0,0 +1,207 @@
+#!/bin/bash
+# Bolloon Daemon - 守护进程启动脚本
+# 支持自动重启、日志轮转、PID 管理
+
+set -e
+
+APP_NAME="bolloon"
+APP_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+PID_FILE="$HOME/.bolloon/daemon.pid"
+LOG_FILE="$HOME/.bolloon/daemon.log"
+MAX_RESTARTS=5
+RESTART_DELAY=5
+
+# 颜色输出
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+log() {
+    echo -e "${GREEN}[$(date '+%Y-%m-%d %H:%M:%S')]${NC} $1"
+}
+
+warn() {
+    echo -e "${YELLOW}[$(date '+%Y-%m-%d %H:%M:%S')] WARN:${NC} $1"
+}
+
+error() {
+    echo -e "${RED}[$(date '+%Y-%m-%d %H:%M:%S')] ERROR:${NC} $1"
+}
+
+# 获取 PID
+get_pid() {
+    if [ -f "$PID_FILE" ]; then
+        cat "$PID_FILE"
+    fi
+}
+
+# 检查进程是否运行
+is_running() {
+    local pid=$(get_pid)
+    if [ -n "$pid" ] && kill -0 "$pid" 2>/dev/null; then
+        return 0
+    fi
+    return 1
+}
+
+# 启动守护进程
+start() {
+    if is_running; then
+        log "Bolloon 已在运行 (PID: $(get_pid))"
+        return 0
+    fi
+
+    log "启动 Bolloon 守护进程..."
+
+    # 确保日志目录存在
+    mkdir -p "$(dirname "$LOG_FILE")"
+
+    # 启动进程
+    cd "$APP_DIR"
+    nohup npx tsx src/index.ts >> "$LOG_FILE" 2>&1 &
+    local pid=$!
+
+    # 保存 PID
+    echo "$pid" > "$PID_FILE"
+    log "Bolloon 已启动 (PID: $pid)"
+    log "日志文件: $LOG_FILE"
+}
+
+# 停止守护进程
+stop() {
+    local pid=$(get_pid)
+
+    if [ -z "$pid" ]; then
+        warn "Bolloon 未运行"
+        return 0
+    fi
+
+    log "停止 Bolloon (PID: $pid)..."
+
+    # 发送 SIGTERM
+    kill -TERM "$pid" 2>/dev/null || true
+
+    # 等待进程退出
+    local count=0
+    while kill -0 "$pid" 2>/dev/null && [ $count -lt 10 ]; do
+        sleep 1
+        count=$((count + 1))
+    done
+
+    # 如果还在运行，强制终止
+    if kill -0 "$pid" 2>/dev/null; then
+        warn "进程未响应，发送 SIGKILL..."
+        kill -KILL "$pid" 2>/dev/null || true
+    fi
+
+    # 清理 PID 文件
+    rm -f "$PID_FILE"
+    log "Bolloon 已停止"
+}
+
+# 重启守护进程
+restart() {
+    log "重启 Bolloon..."
+    stop
+    sleep 2
+    start
+}
+
+# 查看状态
+status() {
+    if is_running; then
+        log "Bolloon 运行中 (PID: $(get_pid))"
+        # 显示资源使用
+        local pid=$(get_pid)
+        if [ -n "$pid" ]; then
+            ps -p "$pid" -o %cpu,%mem,etime 2>/dev/null | tail -1 || true
+        fi
+    else
+        warn "Bolloon 未运行"
+    fi
+}
+
+# 查看日志
+logs() {
+    if [ -f "$LOG_FILE" ]; then
+        tail -100 "$LOG_FILE"
+    else
+        warn "日志文件不存在: $LOG_FILE"
+    fi
+}
+
+# 健康检查
+health() {
+    local port=${PORT:-54188}
+    local response=$(curl -s -o /dev/null -w "%{http_code}" "http://localhost:$port/api/health" 2>/dev/null || echo "000")
+
+    if [ "$response" = "200" ]; then
+        log "健康检查通过"
+        curl -s "http://localhost:$port/api/health" 2>/dev/null | head -5
+    else
+        error "健康检查失败 (HTTP $response)"
+        return 1
+    fi
+}
+
+# 清理日志
+clean_logs() {
+    if [ -f "$LOG_FILE" ]; then
+        local size=$(du -h "$LOG_FILE" | cut -f1)
+        log "当前日志大小: $size"
+        > "$LOG_FILE"
+        log "日志已清空"
+    fi
+}
+
+# 显示帮助
+show_help() {
+    echo "Bolloon Daemon 守护进程管理脚本"
+    echo ""
+    echo "用法: $0 [命令]"
+    echo ""
+    echo "命令:"
+    echo "  start    启动 Bolloon 守护进程"
+    echo "  stop     停止 Bolloon 守护进程"
+    echo "  restart  重启 Bolloon 守护进程"
+    echo "  status   查看运行状态"
+    echo "  logs     查看最近日志"
+    echo "  health   健康检查"
+    echo "  clean    清空日志"
+    echo "  help     显示帮助"
+    echo ""
+}
+
+# 主逻辑
+case "${1:-help}" in
+    start)
+        start
+        ;;
+    stop)
+        stop
+        ;;
+    restart)
+        restart
+        ;;
+    status)
+        status
+        ;;
+    logs)
+        logs
+        ;;
+    health)
+        health
+        ;;
+    clean)
+        clean_logs
+        ;;
+    help|--help|-h)
+        show_help
+        ;;
+    *)
+        error "未知命令: $1"
+        show_help
+        exit 1
+        ;;
+esac

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/constraint-layer.js

@@ -7,25 +7,25 @@ import { ToolPermissionContext, BudgetTracker } from '@bolloon/constraint-runtim
  * System prompt for constraint layer
  * Defines boundaries and autonomous permissions
  */
-export const SYSTEM_PROMPT = `
-你是一个文档处理Agent，在以下规则下运行：
-
-【边界规则】
-1. 只处理：txt, md, pdf, docx 格式文档
-2. 不修改原始文件，只输出改进版本
-3. 发送前必须记录操作日志
-
-【自主权限】
-- ✅ 自主决定：摘要详细程度、chunk分块策略
-- ✅ 自主决定：重试次数（最多3次）
-- ✅ 自主决定：是否需要补充信息
-- ❌ 必须确认：首次向新对等节点发送文档
-- ❌ 必须确认：删除操作
-
-【敏感操作拦截】
-if (操作 === '发送文档' && 对等节点不在已知列表) {
-  拦截 → 记录 → 等待确认
-}
+export const SYSTEM_PROMPT = `
+你是一个文档处理Agent，在以下规则下运行：
+
+【边界规则】
+1. 只处理：txt, md, pdf, docx 格式文档
+2. 不修改原始文件，只输出改进版本
+3. 发送前必须记录操作日志
+
+【自主权限】
+- ✅ 自主决定：摘要详细程度、chunk分块策略
+- ✅ 自主决定：重试次数（最多3次）
+- ✅ 自主决定：是否需要补充信息
+- ❌ 必须确认：首次向新对等节点发送文档
+- ❌ 必须确认：删除操作
+
+【敏感操作拦截】
+if (操作 === '发送文档' && 对等节点不在已知列表) {
+  拦截 → 记录 → 等待确认
+}
 `;
 /**
  * Actions that can be executed autonomously without confirmation

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 };
+}