@bolloon/bolloon-agent 0.3.37 → 0.3.39

package/bin/bolloon.js

@@ -0,0 +1,157 @@
+#!/usr/bin/env node
+const path = require("path");
+const { spawn } = require("child_process");
+const fs = require("fs");
+
+const RESET = "\x1b[0m";
+const BOLD = "\x1b[1m";
+const CYAN = "\x1b[36m";
+const GREEN = "\x1b[32m";
+const MAGENTA = "\x1b[35m";
+
+function log(msg, color) {
+  console.log((color || RESET) + msg + RESET);
+}
+
+function printBanner() {
+  console.log("\n" + CYAN + BOLD + [
+    "   ╔═══════════════════════════════════════════╗",
+    "   ║      🤖 Bolloon Agent                     ║",
+    "   ║      P2P AI Document Processor            ║",
+    "   ╚═══════════════════════════════════════════╝"
+  ].join("\n") + RESET + "\n");
+}
+
+function getMainEntry() {
+  const distDir = path.dirname(require.main.filename);
+  const distIndex = path.join(distDir, "index.js");
+  if (fs.existsSync(distIndex)) {
+    return distIndex;
+  }
+  return path.join(process.cwd(), "src", "index.ts");
+}
+
+function parseArgs() {
+  const args = process.argv.slice(2);
+  if (args.length === 0) {
+    return { mode: "gui", args: [] };
+  }
+  const first = args[0];
+  switch (first) {
+    case "-v":
+    case "--version":
+      return { mode: "version", args: [] };
+    case "-h":
+    case "--help":
+      return { mode: "help", args: [] };
+    case "-g":
+    case "--gui":
+      return { mode: "gui", args: args.slice(1) };
+    case "-w":
+    case "--web":
+      return { mode: "web", args: args.slice(1) };
+    case "-c":
+    case "--cli":
+      return { mode: "cli", args: args.slice(1) };
+    default:
+      return { mode: "passthrough", args };
+  }
+}
+
+async function startElectron(additionalArgs) {
+  try {
+    const electron = require("electron");
+    const distDir = path.dirname(require.main.filename);
+    let mainPath = path.join(distDir, "electron.js");
+    if (!fs.existsSync(mainPath)) {
+      mainPath = path.join(process.cwd(), "src", "electron.ts");
+    }
+    log("启动 Electron...", CYAN);
+    const child = spawn(electron, [mainPath, ...additionalArgs], {
+      stdio: "inherit",
+      env: { ...process.env, NODE_ENV: "development" }
+    });
+    child.on("error", (err) => {
+      log("Electron 启动失败: " + err.message, MAGENTA);
+      process.exit(1);
+    });
+    child.on("exit", (code) => process.exit(code || 0));
+  } catch (err) {
+    log("Electron 不可用，切换到 Web 模式...", CYAN);
+    await startWebServer(additionalArgs);
+  }
+}
+
+async function startWebServer(additionalArgs) {
+  const mainPath = getMainEntry();
+  const webArgs = ["--web", ...additionalArgs];
+  log("启动 Web 服务...", CYAN);
+  const child = spawn(process.execPath, [mainPath, ...webArgs], { stdio: "inherit" });
+  child.on("error", (err) => {
+    log("Web 服务启动失败: " + err.message, MAGENTA);
+    process.exit(1);
+  });
+  child.on("exit", (code) => process.exit(code || 0));
+}
+
+async function startCLI(additionalArgs) {
+  const mainPath = getMainEntry();
+  log("启动命令行界面...", CYAN);
+  const child = spawn(process.execPath, [mainPath, ...additionalArgs], { stdio: "inherit" });
+  child.on("error", (err) => {
+    log("CLI 启动失败: " + err.message, MAGENTA);
+    process.exit(1);
+  });
+  child.on("exit", (code) => process.exit(code || 0));
+}
+
+async function main() {
+  const { mode, args } = parseArgs();
+  switch (mode) {
+    case "version":
+      console.log("Bolloon Agent v0.1.1");
+      break;
+    case "help":
+      printBanner();
+      console.log(BOLD + "用法:" + RESET + "  bolloon [选项] [命令] [参数]");
+      console.log(BOLD + "选项:" + RESET + "  --gui, -g           启动图形界面");
+      console.log("         --web, -w           启动 Web UI");
+      console.log("         --cli, -c           启动命令行界面");
+      console.log("         --version, -v       显示版本");
+      console.log("         --help, -h          显示帮助");
+      console.log(BOLD + "示例:" + RESET + "  bolloon              # 启动图形界面");
+      console.log("         bolloon --web        # 启动 Web UI");
+      console.log("         bolloon --read file  # 读取文档");
+      break;
+    case "gui":
+      printBanner();
+      await startElectron(args);
+      break;
+    case "web":
+      printBanner();
+      await startWebServer(args);
+      break;
+    case "cli":
+      await startCLI(args);
+      break;
+    case "passthrough":
+      const mainPath = getMainEntry();
+      const child = spawn(process.execPath, [mainPath, ...args], { stdio: "inherit" });
+      child.on("error", (err) => {
+        log("执行失败: " + err.message, MAGENTA);
+        process.exit(1);
+      });
+      child.on("exit", (code) => process.exit(code || 0));
+      break;
+    default:
+      log("未知模式: " + mode, MAGENTA);
+      printBanner();
+      console.log("输入 --help 查看帮助");
+      process.exit(1);
+  }
+}
+
+main().catch((err) => {
+  console.error("Fatal error:", err);
+  process.exit(1);
+});

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/judgment-protocol.js

@@ -148,20 +148,20 @@ export async function distillDissent(ask) {
         .slice(-10)
         .flatMap((j) => j.reasons || [])
         .slice(0, 20);
-    const prompt = `你是用户的判断力代理. 用户发起了一个决定: "${ask.decision}"
-${ask.context ? `\n补充: ${ask.context}` : ''}
-
-[用户价值画像] ${valueHint}
-[相关历史判断 (${relevant.length} 条)] ${relevant.slice(0, 3).map((j) => j.decision || '').join(' | ').slice(0, 300)}
-[历史理由样本] ${recentReasons.join(' | ').slice(0, 400) || '(无)'}
-
-请基于上述判断力, 生成正好 3 个"反方观点" (用户应该考虑但可能忽略的风险/盲点).
-要求:
-- 每个反方 1-2 句, 总长 < 80 字
-- 必须是这个特定决定的"反对声音", 不是通用建议
-- 第 1 个: 历史/经验类风险
-- 第 2 个: 关系/信任类风险
-- 第 3 个: 隐藏代价/时间类风险
+    const prompt = `你是用户的判断力代理. 用户发起了一个决定: "${ask.decision}"
+${ask.context ? `\n补充: ${ask.context}` : ''}
+
+[用户价值画像] ${valueHint}
+[相关历史判断 (${relevant.length} 条)] ${relevant.slice(0, 3).map((j) => j.decision || '').join(' | ').slice(0, 300)}
+[历史理由样本] ${recentReasons.join(' | ').slice(0, 400) || '(无)'}
+
+请基于上述判断力, 生成正好 3 个"反方观点" (用户应该考虑但可能忽略的风险/盲点).
+要求:
+- 每个反方 1-2 句, 总长 < 80 字
+- 必须是这个特定决定的"反对声音", 不是通用建议
+- 第 1 个: 历史/经验类风险
+- 第 2 个: 关系/信任类风险
+- 第 3 个: 隐藏代价/时间类风险
 - 用 JSON 数组返回: ["反方1", "反方2", "反方3"]`;
     // LLM 调用 (OpenAI 兼容, 复用 p2p-chat-tools 的方式)
     let dissents = [];

package/dist/agents/loop-review.js

@@ -0,0 +1,58 @@
+/**
+ * loop-review.ts — "ReAct loop end" review 续跑决策门
+ *
+ * 动机 (2026-08-08, v0.3.39):
+ *   - LLM 经常"潦草收尾": 达成上一轮成果就输出 <final gen>, 不深挖目标的更多可能.
+ *   - 需求: 每次循环结束前 (LLM 想输出 <final gen> 时), 跑 1-2 次「目标对齐 + 需求深挖」,
+ *     吐出阶段性成果后再启动 review, 判断"是否还有可能继续触发".
+ *   - 天花板: 逻辑上循环能持续最强 (不潦草终止), 时长上限的长循环由迭代上限兜底;
+ *     用户明确"结束指标以用户需求为准, 不过度深挖" — 达成用户需求就放行结束.
+ *   - 工具调用次数无限制 (不在这里限, 由上层 MAX_REACT_ITERATIONS 兜底).
+ *
+ * 本模块是纯判定 + 提示文本生成, 不调 LLM. 由 pi-sdk 的 final gen 分支使用:
+ *   1. decideAfterReview — 判定 final 前该"续跑 review"还是"真正结束"
+ *   2. buildReviewHint    — 构造注入 system 的续跑提示
+ *   3. shouldReviewAgain  — 布尔门 (测试/消融用)
+ *
+ * 设计范式: 与 react-loop.ts 一致 (纯函数), 便于 claude code 独立单测消融边界.
+ */
+/** 每轮最多续跑 review 次数 — "运行一两次目标对齐和深挖" (用户明确) */
+export const DEFAULT_MAX_REVIEWS = 2;
+/**
+ * 判定: LLM 想 <final gen> 时, 该续跑一次 review 还是真正结束.
+ *
+ * 结束条件 (以下任一 → finish):
+ *   - 没有明确用户需求 (无深挖对象, 不硬挖)
+ *   - 已触发 maxReviews 次 review 续跑 (# 不无限续)
+ * 否则 → 续跑一次 (提示 LLM 对齐需求深挖).
+ *
+ * 注意: 续跑不是无限. 达上限即结束, 保证"不过度深挖".
+ */
+export function decideAfterReview(state, maxReviews = DEFAULT_MAX_REVIEWS) {
+    const intent = (state.userIntent || '').trim();
+    if (!intent) {
+        return { kind: 'finish', reason: 'no-user-intent' };
+    }
+    if (state.reviewsDone >= maxReviews) {
+        return { kind: 'finish', reason: `max-reviews-${maxReviews}` };
+    }
+    return {
+        kind: 'continue-review',
+        reason: `${state.reviewsDone + 1}/${maxReviews} 目标对齐`,
+        hint: buildReviewHint(state, maxReviews),
+    };
+}
+/** 构造 review 提示文本 (注入 system context, 让 LLM 深挖或确认完成) */
+export function buildReviewHint(state, maxReviews = DEFAULT_MAX_REVIEWS) {
+    const intent = (state.userIntent || '').trim() || '(无)';
+    const tools = state.completedTools.length ? state.completedTools.join(', ') : '(尚未执行工具)';
+    return (`[目标对齐 review ${state.reviewsDone + 1}/${maxReviews}]\n` +
+        `用户需求: ${intent.slice(0, 300)}\n` +
+        `本轮已完成工具: ${tools}\n` +
+        `请对照需求自查: 是否还有未完成/可深挖的子目标? 若有 → 继续调用工具推进; ` +
+        `若已满足用户原始需求 → 直接输出 <final gen> 结束. 不要再重复已完成的动作.`);
+}
+/** 布尔门: 是否该继续 review (测试/消融快速断言) */
+export function shouldReviewAgain(state, maxReviews = DEFAULT_MAX_REVIEWS) {
+    return decideAfterReview(state, maxReviews).kind === 'continue-review';
+}

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

@@ -2118,6 +2118,113 @@ export function registerBuiltinTools(ctx) {
             }
         }
     });
+    // ============================================================
+    // bolloon_config_get / bolloon_config_set (2026-08-07)
+    // Bolloon 自己读写 ~/.bolloon/bolloon-config.json — 统一配置文件,
+    // 让 agent 有修改自身配置的权限 (模型/供应商/温度等), 不再只能靠用户手改.
+    // ============================================================
+    ctx.tools.set('bolloon_config_get', {
+        name: 'bolloon_config_get',
+        description: '读取 Bolloon 自身配置 (~/.bolloon/bolloon-config.json): 当前激活供应商 + 各供应商 API 配置 (baseUrl/model/温度). 注意: 不输出 apiKey 明文 (脱敏), 只显示是否已配置.',
+        parameters: {},
+        execute: async () => {
+            try {
+                const { llmConfigStore } = await import('../llm/config-store.js');
+                await llmConfigStore.initialize();
+                const cfg = await llmConfigStore.getConfig();
+                const active = cfg.activeProvider;
+                const lines = [`📋 Bolloon 配置 (${active} 激活):`];
+                for (const [name, p] of Object.entries(cfg.providers || {})) {
+                    const pc = p;
+                    if (!pc)
+                        continue;
+                    const mark = name === active ? '●' : '○';
+                    const key = pc.apiKey ? '🔑' : pc.requiresApiKey ? '✗ 无key' : '无key需求';
+                    lines.push(`  ${mark} ${name}: ${key} · model=${pc.model || '?'} · baseUrl=${pc.baseUrl || '?'}${pc.temperature ? ` · temp=${pc.temperature}` : ''}`);
+                }
+                return { success: true, output: lines.join('\n') };
+            }
+            catch (e) {
+                return { success: false, error: `bolloon_config_get 失败: ${String(e.message || e).slice(0, 200)}` };
+            }
+        }
+    });
+    ctx.tools.set('bolloon_config_set', {
+        name: 'bolloon_config_set',
+        description: '修改 Bolloon 自身配置 (~/.bolloon/bolloon-config.json). 可切换激活供应商 (provider) 或改某供应商的 model/baseUrl/temperature/enabled. 修改立即生效 (下次 LLM 调用使用新配置). 例: provider=deepseek; provider=minimax, model=MiniMax-M3; deepseek.temperature=0.3',
+        parameters: {
+            provider: '可选: 切换激活供应商 (如 deepseek / minimax / openai / anthropic / ollama)',
+            'provider.key': '可选: 修改指定供应商字段, 格式 <供应商>.<字段>=<值>, 如 minimax.model=MiniMax-M3',
+            model: '可选: 同时设置激活供应商的 model',
+            temperature: '可选: 同时设置激活供应商的 temperature (0-2)',
+        },
+        execute: async (args) => {
+            try {
+                const { llmConfigStore } = await import('../llm/config-store.js');
+                await llmConfigStore.initialize();
+                const changes = [];
+                // 1. 切换激活供应商
+                if (args.provider) {
+                    const name = String(args.provider).trim().toLowerCase();
+                    const known = ['openai', 'anthropic', 'ollama', 'openrouter', 'gemini', 'minimax', 'deepseek', 'kimi', 'glm', 'qwen', 'mimo', 'grok', 'local'];
+                    if (!known.includes(name))
+                        return { success: false, error: `未知供应商: ${name}. 可用: ${known.join(', ')}` };
+                    await llmConfigStore.setActiveProvider(name);
+                    changes.push(`activeProvider=${name}`);
+                }
+                // 2. 修改指定供应商字段 (provider.key=value)
+                for (const [k, v] of Object.entries(args)) {
+                    if (k === 'provider' || k === 'model' || k === 'temperature')
+                        continue;
+                    if (!k.includes('.'))
+                        continue;
+                    const [prov, field] = k.split('.');
+                    const val = String(v);
+                    if (field === 'temperature' || field === 'maxTokens') {
+                        const num = Number(val);
+                        if (Number.isNaN(num))
+                            return { success: false, error: `${k}=${val} 不是数字` };
+                        await llmConfigStore.updateProvider(prov, { [field]: num });
+                    }
+                    else if (field === 'enabled') {
+                        await llmConfigStore.updateProvider(prov, { enabled: val === 'true' || val === '1' });
+                    }
+                    else if (field === 'apiKey') {
+                        await llmConfigStore.updateProvider(prov, { apiKey: val });
+                    }
+                    else {
+                        await llmConfigStore.updateProvider(prov, { [field]: val });
+                    }
+                    changes.push(`${prov}.${field}=${field === 'apiKey' ? '***' : val}`);
+                }
+                // 3. 激活供应商的 model / temperature
+                if (args.model || args.temperature) {
+                    const active = await llmConfigStore.getActiveProvider();
+                    const patch = {};
+                    if (args.model)
+                        patch.model = String(args.model);
+                    if (args.temperature) {
+                        const t = Number(args.temperature);
+                        if (Number.isNaN(t))
+                            return { success: false, error: `temperature=${args.temperature} 不是数字` };
+                        patch.temperature = t;
+                    }
+                    await llmConfigStore.updateProvider(active, patch);
+                    if (args.model)
+                        changes.push(`${active}.model=${args.model}`);
+                    if (args.temperature)
+                        changes.push(`${active}.temperature=${args.temperature}`);
+                }
+                if (changes.length === 0)
+                    return { success: false, error: '没有要修改的配置项. 例: provider=deepseek 或 minimax.model=MiniMax-M3' };
+                const cfg = await llmConfigStore.getConfig();
+                return { success: true, output: `✅ 配置已更新: ${changes.join(', ')}\n  当前激活: ${cfg.activeProvider}` };
+            }
+            catch (e) {
+                return { success: false, error: `bolloon_config_set 失败: ${String(e.message || e).slice(0, 200)}` };
+            }
+        }
+    });
 }
 // ─── IPFS/IPNS 通用 helper (2026-08-04) ─────────────────────────────────────
 // 复用 publish_did 的 checkKuboSetup 自动安装/启动本地 Kubo (darwin-arm64 v0.28.0)

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

@@ -1,13 +1,13 @@
-export const TOOL_DEFINITIONS = `
-可用工具:
-1. read_document(path) - 读取文档内容，支持 .txt, .md, .pdf, .docx
-2. summarize_document(path, context?) - 总结文档内容，可选提供上下文
-3. improve_document(path, requirements) - 改进文档，需提供文件路径和改进要求
-4. list_peers() - 列出已连接的对等节点
-5. send_message(peer_id, message) - 向指定对等节点发送消息
-6. broadcast_message(message) - 向所有对等节点广播消息
-7. get_identity() - 获取当前智能体身份信息
-8. set_persona(persona_json) - 更新智能体 persona，包含 name、description、personality、greeting 等
-9. run_workflow(steps) - 执行预定义工作流
-10. get_operation_logs() - 获取操作日志
+export const TOOL_DEFINITIONS = `
+可用工具:
+1. read_document(path) - 读取文档内容，支持 .txt, .md, .pdf, .docx
+2. summarize_document(path, context?) - 总结文档内容，可选提供上下文
+3. improve_document(path, requirements) - 改进文档，需提供文件路径和改进要求
+4. list_peers() - 列出已连接的对等节点
+5. send_message(peer_id, message) - 向指定对等节点发送消息
+6. broadcast_message(message) - 向所有对等节点广播消息
+7. get_identity() - 获取当前智能体身份信息
+8. set_persona(persona_json) - 更新智能体 persona，包含 name、description、personality、greeting 等
+9. run_workflow(steps) - 执行预定义工作流
+10. get_operation_logs() - 获取操作日志
 `;