@bolloon/bolloon-agent 0.3.51 → 0.4.0

package/README.md

@@ -1,135 +1,135 @@
-# Bolloon — P2P AI 智能体平台
-
-Bolloon 是一个本地优先、P2P 协作的 AI 智能体平台。它在你的设备上运行，通过 DHT 网络发现并连接其他节点。
-
-> 中文 · [English](#english)
-
----
-
-## 快速安装
-
-### macOS / Linux
-
-```bash
-# 方式一：npm（需 Node.js ≥ 18）
-npm install -g @bolloon/bolloon-agent
-
-# 方式二：一键脚本
-curl -fsSL https://raw.githubusercontent.com/logos-42/bolloon/master/scripts/install.sh | sh
-```
-
-### Windows
-
-```powershell
-# 方式一：npm（需 Node.js ≥ 18）
-npm install -g @bolloon/bolloon-agent
-
-# 方式二：一键脚本
-# 以管理员身份运行 PowerShell：
-iwr -useb https://raw.githubusercontent.com/logos-42/bolloon/master/scripts/install.ps1 | iex
-```
-
-> **Node.js 安装**：如果尚未安装，访问 [nodejs.org](https://nodejs.org) 下载 LTS 版本，或使用包管理器：
-> - macOS: `brew install node`
-> - Windows: `winget install -e --id OpenJS.NodeJS.LTS`
-> - Linux: `sudo apt install -y nodejs npm`
-
----
-
-## 快速启动
-
-```bash
-bolloon              # CLI 交互模式（默认）
-bolloon --web        # Web UI 模式（浏览器）
-bolloon --cli        # 强制 CLI 模式
-bolloon --help       # 查看所有命令
-```
-
-首次启动会自动配置 LLM（需要 `OPENAI_API_KEY` 或 `DEEPSEEK_API_KEY` 环境变量）。
-
----
-
-## 功能概览
-
-| 功能 | 描述 |
-|------|------|
-| 🤖 AI 对话 | 本地运行的智能体，支持多轮对话 |
-| 🌐 P2P 网络 | 自动发现并连接其他 Bolloon 节点 |
-| 📄 文档处理 | 接收和管理文档，支持 DID 签名验证 |
-| 🔧 工具调用 | shell 命令、文件操作、代码分析等 |
-| 🔄 自我改进 | 自动检查更新、质量门控 |
-
----
-
-## 项目结构
-
-```
-bolloon/
-├── src/
-│   ├── agents/          # 智能体核心（pi-sdk、工具、session）
-│   ├── cli/             # CLI 界面（Ink TUI 渲染引擎）
-│   ├── network/         # P2P 网络（Hyperswarm / DIAP）
-│   ├── security/        # 安全层（工具闸门、守卫）
-│   ├── llm/             # LLM 接入层
-│   └── web/             # Web UI
-├── dist/                # 编译输出
-├── docs/                # 文档
-└── scripts/             # 构建和安装脚本
-```
-
----
-
-## 从源码构建
-
-```bash
-git clone https://github.com/logos-42/bolloon.git
-cd bolloon
-npm install
-npm run build:all
-npm start
-```
-
----
-
-## 环境变量
-
-| 变量 | 说明 |
-|------|------|
-| `OPENAI_API_KEY` | OpenAI 提供商（可选） |
-| `DEEPSEEK_API_KEY` | DeepSeek 提供商（可选） |
-| `ANTHROPIC_API_KEY` | Anthropic 提供商（可选） |
-| `BOLLOON_LLM_PROVIDER` | 指定 LLM 提供商 |
-
----
-
-<a name="english"></a>
-
-## English
-
-**Bolloon** — A local-first, P2P-collaborative AI agent platform that runs on your device and discovers other nodes through a DHT network.
-
-### Quick Install
-
-**macOS / Linux:**
-```bash
-npm install -g @bolloon/bolloon-agent
-```
-
-**Windows (PowerShell):**
-```powershell
-npm install -g @bolloon/bolloon-agent
-```
-
-### Quick Start
-
-```bash
-bolloon            # CLI interactive mode
-bolloon --web      # Web UI mode
-bolloon --help     # All commands
-```
-
-Requires Node.js ≥ 18 and an LLM API key (`OPENAI_API_KEY` or `DEEPSEEK_API_KEY`).
-
-### License
-
-MIT
+# Bolloon — P2P AI 智能体平台
+
+Bolloon 是一个本地优先、P2P 协作的 AI 智能体平台。它在你的设备上运行，通过 DHT 网络发现并连接其他节点。
+
+> 中文 · [English](#english)
+
+---
+
+## 快速安装
+
+### macOS / Linux
+
+```bash
+# 方式一：npm（需 Node.js ≥ 18）
+npm install -g @bolloon/bolloon-agent
+
+# 方式二：一键脚本
+curl -fsSL https://raw.githubusercontent.com/logos-42/bolloon/master/scripts/install.sh | sh
+```
+
+### Windows
+
+```powershell
+# 方式一：npm（需 Node.js ≥ 18）
+npm install -g @bolloon/bolloon-agent
+
+# 方式二：一键脚本
+# 以管理员身份运行 PowerShell：
+iwr -useb https://raw.githubusercontent.com/logos-42/bolloon/master/scripts/install.ps1 | iex
+```
+
+> **Node.js 安装**：如果尚未安装，访问 [nodejs.org](https://nodejs.org) 下载 LTS 版本，或使用包管理器：
+> - macOS: `brew install node`
+> - Windows: `winget install -e --id OpenJS.NodeJS.LTS`
+> - Linux: `sudo apt install -y nodejs npm`
+
+---
+
+## 快速启动
+
+```bash
+bolloon              # CLI 交互模式（默认）
+bolloon --web        # Web UI 模式（浏览器）
+bolloon --cli        # 强制 CLI 模式
+bolloon --help       # 查看所有命令
+```
+
+首次启动会自动配置 LLM（需要 `OPENAI_API_KEY` 或 `DEEPSEEK_API_KEY` 环境变量）。
+
+---
+
+## 功能概览
+
+| 功能 | 描述 |
+|------|------|
+| 🤖 AI 对话 | 本地运行的智能体，支持多轮对话 |
+| 🌐 P2P 网络 | 自动发现并连接其他 Bolloon 节点 |
+| 📄 文档处理 | 接收和管理文档，支持 DID 签名验证 |
+| 🔧 工具调用 | shell 命令、文件操作、代码分析等 |
+| 🔄 自我改进 | 自动检查更新、质量门控 |
+
+---
+
+## 项目结构
+
+```
+bolloon/
+├── src/
+│   ├── agents/          # 智能体核心（pi-sdk、工具、session）
+│   ├── cli/             # CLI 界面（Ink TUI 渲染引擎）
+│   ├── network/         # P2P 网络（Hyperswarm / DIAP）
+│   ├── security/        # 安全层（工具闸门、守卫）
+│   ├── llm/             # LLM 接入层
+│   └── web/             # Web UI
+├── dist/                # 编译输出
+├── docs/                # 文档
+└── scripts/             # 构建和安装脚本
+```
+
+---
+
+## 从源码构建
+
+```bash
+git clone https://github.com/logos-42/bolloon.git
+cd bolloon
+npm install
+npm run build:all
+npm start
+```
+
+---
+
+## 环境变量
+
+| 变量 | 说明 |
+|------|------|
+| `OPENAI_API_KEY` | OpenAI 提供商（可选） |
+| `DEEPSEEK_API_KEY` | DeepSeek 提供商（可选） |
+| `ANTHROPIC_API_KEY` | Anthropic 提供商（可选） |
+| `BOLLOON_LLM_PROVIDER` | 指定 LLM 提供商 |
+
+---
+
+<a name="english"></a>
+
+## English
+
+**Bolloon** — A local-first, P2P-collaborative AI agent platform that runs on your device and discovers other nodes through a DHT network.
+
+### Quick Install
+
+**macOS / Linux:**
+```bash
+npm install -g @bolloon/bolloon-agent
+```
+
+**Windows (PowerShell):**
+```powershell
+npm install -g @bolloon/bolloon-agent
+```
+
+### Quick Start
+
+```bash
+bolloon            # CLI interactive mode
+bolloon --web      # Web UI mode
+bolloon --help     # All commands
+```
+
+Requires Node.js ≥ 18 and an LLM API key (`OPENAI_API_KEY` or `DEEPSEEK_API_KEY`).
+
+### License
+
+MIT

package/bin/bolloon-cli.cjs

@@ -1,183 +1,183 @@
-#!/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() {
-  // bin is in: node_modules/.bin/bolloon
-  // package is in: node_modules/@bolloon/bolloon-agent/
-  // dist is in: node_modules/@bolloon/bolloon-agent/dist/
-  const binPath = require.main.filename; // /tmp/node_modules/.bin/bolloon
-  const binDir = path.dirname(binPath); // /tmp/node_modules/.bin
-  const packageDir = path.dirname(binDir); // /tmp/node_modules/@bolloon/bolloon-agent
-  // 优先用 package.json 'main' 字段 (v0.2.3+ 指向 dist/cli-entry.js).
-  // 真实 npm 安装用户拿到的是编译后的 dist, 不该再依赖 tsx.
-  const pkgJsonPath = path.join(packageDir, "package.json");
-  if (fs.existsSync(pkgJsonPath)) {
-    try {
-      const pkg = JSON.parse(fs.readFileSync(pkgJsonPath, "utf-8"));
-      if (pkg.main) {
-        const mainPath = path.join(packageDir, pkg.main);
-        if (fs.existsSync(mainPath)) return mainPath;
-      }
-    } catch {}
-  }
-  // fallback: 兼容老版本 (dist/index.js 是之前默认)
-  const distIndex = path.join(packageDir, "dist", "index.js");
-  if (fs.existsSync(distIndex)) return distIndex;
-  // 最后才 fallback 到 src (开发环境)
-  return path.join(packageDir, "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 binPath = require.main.filename;
-    const binDir = path.dirname(binPath);
-    const packageDir = path.dirname(binDir);
-    let mainPath = path.join(packageDir, "dist", "electron.js");
-    if (!fs.existsSync(mainPath)) {
-      mainPath = path.join(packageDir, "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() {
-  // Get version from package.json
-  const binPath = require.main.filename;
-  const binDir = path.dirname(binPath);
-  const packageDir = path.dirname(binDir);
-  const packageJson = JSON.parse(fs.readFileSync(path.join(packageDir, "package.json"), "utf-8"));
-  const version = packageJson.version;
-
-  const { mode, args } = parseArgs();
-  switch (mode) {
-    case "version":
-      console.log("Bolloon Agent v" + version);
-      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);
-});
+#!/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() {
+  // bin is in: node_modules/.bin/bolloon
+  // package is in: node_modules/@bolloon/bolloon-agent/
+  // dist is in: node_modules/@bolloon/bolloon-agent/dist/
+  const binPath = require.main.filename; // /tmp/node_modules/.bin/bolloon
+  const binDir = path.dirname(binPath); // /tmp/node_modules/.bin
+  const packageDir = path.dirname(binDir); // /tmp/node_modules/@bolloon/bolloon-agent
+  // 优先用 package.json 'main' 字段 (v0.2.3+ 指向 dist/cli-entry.js).
+  // 真实 npm 安装用户拿到的是编译后的 dist, 不该再依赖 tsx.
+  const pkgJsonPath = path.join(packageDir, "package.json");
+  if (fs.existsSync(pkgJsonPath)) {
+    try {
+      const pkg = JSON.parse(fs.readFileSync(pkgJsonPath, "utf-8"));
+      if (pkg.main) {
+        const mainPath = path.join(packageDir, pkg.main);
+        if (fs.existsSync(mainPath)) return mainPath;
+      }
+    } catch {}
+  }
+  // fallback: 兼容老版本 (dist/index.js 是之前默认)
+  const distIndex = path.join(packageDir, "dist", "index.js");
+  if (fs.existsSync(distIndex)) return distIndex;
+  // 最后才 fallback 到 src (开发环境)
+  return path.join(packageDir, "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 binPath = require.main.filename;
+    const binDir = path.dirname(binPath);
+    const packageDir = path.dirname(binDir);
+    let mainPath = path.join(packageDir, "dist", "electron.js");
+    if (!fs.existsSync(mainPath)) {
+      mainPath = path.join(packageDir, "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() {
+  // Get version from package.json
+  const binPath = require.main.filename;
+  const binDir = path.dirname(binPath);
+  const packageDir = path.dirname(binDir);
+  const packageJson = JSON.parse(fs.readFileSync(path.join(packageDir, "package.json"), "utf-8"));
+  const version = packageJson.version;
+
+  const { mode, args } = parseArgs();
+  switch (mode) {
+    case "version":
+      console.log("Bolloon Agent v" + version);
+      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);
+});