@bolloon/bolloon-agent 0.2.7 → 0.2.9

package/dist/web/util/safe-name.js

@@ -0,0 +1,32 @@
+/**
+ * 通用名兜底. fallback 默认 '(未命名)'. 中文场景.
+ */
+export function safeChannelName(input, fallback) {
+    return safeNameInternal(input, fallback ?? '(未命名)', ['undefined', 'null', 'NaN']);
+}
+/**
+ * 英文场景兜底, 默认 'Unknown'.
+ */
+export function safePeerName(input, fallback) {
+    return safeNameInternal(input, fallback ?? 'Unknown', ['undefined', 'null', 'NaN']);
+}
+/**
+ * 兜底任意字段, 由 caller 指定默认 + 无效字面量集合.
+ */
+export function safeName(input, fallback, invalidLiterals = ['undefined', 'null', 'NaN']) {
+    return safeNameInternal(input, fallback, invalidLiterals);
+}
+function safeNameInternal(input, fallback, invalidLiterals) {
+    if (input === undefined || input === null)
+        return fallback;
+    if (typeof input === 'number' && Number.isNaN(input))
+        return fallback;
+    const s = String(input).trim();
+    if (!s)
+        return fallback;
+    for (const lit of invalidLiterals) {
+        if (s === lit)
+            return fallback;
+    }
+    return s;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bolloon/bolloon-agent",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "type": "module",
   "description": "P2P AI Document Agent - 全局安装后执行 `bolloon` 启动产品",
   "main": "dist/cli-entry.js",
@@ -12,7 +12,10 @@
   "license": "MIT",
   "files": [
     "dist",
-    "bin"
+    "bin",
+    "scripts/postinstall.js",
+    "scripts/build-cli.js",
+    "scripts/build-web.ts"
   ],
   "bin": {
     "bolloon": "./bin/bolloon-cli.cjs"

package/scripts/build-cli.js

@@ -0,0 +1,216 @@
+/**
+ * CLI 构建脚本
+ *
+ * 生成 bin/bolloon.js 和 bin/bolloon.cmd 入口文件
+ */
+
+import * as fs from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const rootDir = path.join(__dirname, '..');
+
+const binDir = path.join(rootDir, 'bin');
+if (!fs.existsSync(binDir)) {
+  fs.mkdirSync(binDir, { recursive: true });
+}
+
+// Windows 批处理入口
+const winContent = `@echo off
+set "BOLLOON_ROOT=%~dp0"
+set "BOLLOON_ROOT=%BOLLOON_ROOT:~0,-1%"
+
+REM 确定入口文件
+set "ENTRY=%BOLLOON_ROOT%\\dist\\index.js"
+if not exist "%ENTRY%" (
+    set "ENTRY=%BOLLOON_ROOT%\\src\\index.ts"
+)
+
+node "%ENTRY%" %*
+`;
+
+fs.writeFileSync(path.join(binDir, 'bolloon.cmd'), winContent);
+
+// Unix/Linux/Mac 入口脚本
+const unixContent = `#!/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);
+});
+`;
+
+fs.writeFileSync(path.join(binDir, 'bolloon.cjs'), unixContent);
+
+// 确保 bin/bolloon.js 存在（npm link 需要）
+// 优先用符号链接（POSIX），Windows 上若权限不足则退化为复制文件
+const jsSymlink = path.join(binDir, 'bolloon.js');
+if (fs.existsSync(jsSymlink)) fs.unlinkSync(jsSymlink);
+try {
+  fs.symlinkSync('bolloon.cjs', jsSymlink);
+} catch (err) {
+  if (err && err.code === 'EPERM') {
+    fs.copyFileSync(path.join(binDir, 'bolloon.cjs'), jsSymlink);
+    console.warn('  ⚠ symlink 不支持（Windows），已退化为文件复制');
+  } else {
+    throw err;
+  }
+}
+
+console.log("✓ CLI 构建完成");
+console.log("  bin/bolloon.cjs    - CommonJS 入口");
+console.log("  bin/bolloon.js     - 符号链接 -> bolloon.cjs");
+console.log("  bin/bolloon.cmd    - Windows 入口");

package/scripts/build-web.ts

@@ -0,0 +1,125 @@
+/**
+ * Web 构建脚本
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { execSync } from 'child_process';
+import * as esbuild from 'esbuild';
+
+const ROOT = path.resolve(import.meta.dirname, '..');
+const DIST_WEB = path.join(ROOT, 'dist', 'web');
+
+async function main() {
+  console.log('[build-web] 开始构建...');
+
+  // 重要: 不能 rm -rf 整个 dist/web/, 否则会删掉 build:main 编译出来的
+  // dist/web/server.js. 只清理 web 静态资源, 保留 server.js.
+  for (const f of ['index.html', 'api-config.html', 'style.css', 'client.js', 'components']) {
+    await fs.rm(path.join(DIST_WEB, f), { recursive: true, force: true });
+  }
+  await fs.mkdir(DIST_WEB, { recursive: true });
+  await fs.mkdir(path.join(DIST_WEB, 'components', 'p2p'), { recursive: true });
+
+  // 编译 TypeScript 模块
+  console.log('[build-web] 编译 TypeScript 模块...');
+  const moduleFiles = [
+    'src/web/components/p2p/types.ts',
+    'src/web/components/p2p/p2p-store-memory.ts',
+    'src/web/components/p2p/p2p-identity.ts',
+    'src/web/components/p2p/p2p-connection.ts',
+    'src/web/components/p2p/p2p-messages.ts',
+    'src/web/components/p2p/p2p-manager.ts',
+  ];
+
+  try {
+    execSync(`npx tsc --outDir dist/web/components/p2p --declaration false --skipLibCheck --target ES2022 --module ESNext --moduleResolution bundler ${moduleFiles.join(' ')}`, {
+      cwd: ROOT,
+      stdio: 'inherit'
+    });
+  } catch {
+    console.log('[build-web] TypeScript 编译有警告，继续...');
+  }
+
+  // 编译 P2P Modal UI（esbuild）
+  console.log('[build-web] 编译 P2P Modal UI...');
+  await esbuild.build({
+    entryPoints: [path.join(ROOT, 'src/web/components/p2p/index.ts')],
+    outfile: path.join(DIST_WEB, 'components/p2p/index.js'),
+    format: 'esm',
+    target: 'es2022',
+    platform: 'browser',
+    minify: false,
+  });
+
+  // 2026-06-15: 编译 message-renderer.ts (对话显示 UI 模块)
+  //   esbuild 编译 .ts → dist/web/ui/message-renderer.js (ESM, 浏览器侧 <script type="module"> 加载)
+  console.log('[build-web] 编译 message-renderer.ts...');
+  await fs.mkdir(path.join(DIST_WEB, 'ui'), { recursive: true });
+  await esbuild.build({
+    entryPoints: [path.join(ROOT, 'src/web/ui/message-renderer.ts')],
+    outfile: path.join(DIST_WEB, 'ui/message-renderer.js'),
+    format: 'esm',
+    target: 'es2022',
+    platform: 'browser',
+    minify: false,
+  });
+
+  // 2026-06-15: 编译 step-timeline.ts (气泡内 4 状态步骤条)
+  console.log('[build-web] 编译 step-timeline.ts...');
+  await esbuild.build({
+    entryPoints: [path.join(ROOT, 'src/web/ui/step-timeline.ts')],
+    outfile: path.join(DIST_WEB, 'ui/step-timeline.js'),
+    format: 'esm',
+    target: 'es2022',
+    platform: 'browser',
+    minify: false,
+  });
+
+  // 编译主客户端入口 (classic script, 非 module; 由 index.html 以 /client.js 加载)
+  console.log('[build-web] 编译 client.ts...');
+  await esbuild.build({
+    entryPoints: [path.join(ROOT, 'src/web/client.ts')],
+    outfile: path.join(DIST_WEB, 'client.js'),
+    format: 'iife',
+    target: 'es2022',
+    platform: 'browser',
+    minify: false,
+  });
+
+  // 复制静态文件
+  console.log('[build-web] 复制静态文件...');
+  await fs.copyFile(path.join(ROOT, 'src/web/index.html'), path.join(DIST_WEB, 'index.html'));
+  await fs.copyFile(path.join(ROOT, 'src/web/api-config.html'), path.join(DIST_WEB, 'api-config.html'));
+  await fs.copyFile(path.join(ROOT, 'src/web/style.css'), path.join(DIST_WEB, 'style.css'));
+  // 复制 PWA manifest (index.html 里有 <link rel="manifest">, 否则浏览器会 404)
+  await fs.copyFile(path.join(ROOT, 'src/web/manifest.json'), path.join(DIST_WEB, 'manifest.json'));
+  // 复制 icons 目录 (manifest.json 里引用了 favicon 等)
+  await fs.cp(path.join(ROOT, 'src/web/icons'), path.join(DIST_WEB, 'icons'), { recursive: true });
+
+  // 复制 system-prompt layer .md 文件到 dist/llm/system-prompt/layers/
+  //   原因: tsc 不复制 .md, src/llm/system-prompt/layers/{core,role,channel,tool}/*.md
+  //   在 dist 里完全不存在, registry.ts 用 __dirname + 'layers' 读它们时 100% ENOENT.
+  //   这里全量复制 25 个 .md, 不过滤 'never' 层 — registry.matchesContext 已做过滤.
+  const srcLayers = path.join(ROOT, 'src/llm/system-prompt/layers');
+  const dstLayers = path.join(ROOT, 'dist/llm/system-prompt/layers');
+  await fs.cp(srcLayers, dstLayers, { recursive: true });
+  console.log('[build-web] system-prompt layers copied →', path.relative(ROOT, dstLayers));
+
+  // 复制 components/ 下的独立 ESM 模块 (非 p2p 那些, 已被 esbuild 单独编译)
+  // 例如 wallet-viem.mjs: 浏览器侧 viem 封装, 被 index.html 引用
+  const extraComponentsDir = path.join(ROOT, 'src/web/components');
+  for (const entry of await fs.readdir(extraComponentsDir)) {
+    if (entry === 'p2p') continue;
+    const src = path.join(extraComponentsDir, entry);
+    const dest = path.join(DIST_WEB, 'components', entry);
+    const stat = await fs.stat(src);
+    if (stat.isFile()) {
+      await fs.mkdir(path.dirname(dest), { recursive: true });
+      await fs.copyFile(src, dest);
+    }
+  }
+
+  console.log('[build-web] 完成!');
+}
+
+main().catch(console.error);

package/scripts/postinstall.js

@@ -0,0 +1,153 @@
+/**
+ * Postinstall 脚本
+ * npm 安装后自动执行
+ *
+ * 主要任务：
+ * 1. 确保 bin 目录存在且可执行
+ * 2. 初始化本地配置
+ * 3. 检查依赖完整性
+ */
+
+import * as fs from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const rootDir = path.join(__dirname, '..');
+
+const RESET = '\x1b[0m';
+const GREEN = '\x1b[32m';
+const YELLOW = '\x1b[33m';
+const CYAN = '\x1b[36m';
+
+function log(msg, color = RESET) {
+  console.log(color + msg + RESET);
+}
+
+function initUserDirs() {
+  // 创建用户数据目录
+  const home = process.env.HOME || process.env.USERPROFILE || '/tmp';
+  const bolloonDir = path.join(home, '.bolloon');
+
+  const dirs = [
+    bolloonDir,
+    path.join(bolloonDir, 'sessions'),
+    path.join(bolloonDir, 'peer-store'),
+  ];
+
+  for (const dir of dirs) {
+    if (!fs.existsSync(dir)) {
+      fs.mkdirSync(dir, { recursive: true });
+      log(`  ✓ 创建目录: ${dir}`, GREEN);
+    }
+  }
+
+  // 初始化配置文件
+  const configPath = path.join(bolloonDir, 'config.json');
+  if (!fs.existsSync(configPath)) {
+    const defaultConfig = {
+      version: '0.1.12',
+      initializedAt: new Date().toISOString(),
+      defaults: {
+        port: 54188,
+        theme: 'dark',
+        autoConnect: true,
+      },
+      providers: {
+        minimax: { enabled: false },
+        openai: { enabled: false },
+        anthropic: { enabled: false },
+      }
+    };
+    fs.writeFileSync(configPath, JSON.stringify(defaultConfig, null, 2));
+    log(`  ✓ 创建配置: ${configPath}`, GREEN);
+  }
+
+  return bolloonDir;
+}
+
+function checkNativeDeps() {
+  // 检查必要的原生依赖
+  const nativeDeps = [
+    'libp2p',
+    '@diap/sdk',
+  ];
+
+  let allOk = true;
+
+  for (const dep of nativeDeps) {
+    const depPath = path.join(rootDir, 'node_modules', dep);
+    if (!fs.existsSync(depPath)) {
+      log(`  ⚠ 缺少依赖: ${dep}`, YELLOW);
+      allOk = false;
+    }
+  }
+
+  return allOk;
+}
+
+function setupPlatform() {
+  const platform = process.platform;
+
+  log(`\n  平台: ${platform}`, CYAN);
+
+  if (platform === 'win32') {
+    // Windows: 确保 .cmd 文件存在
+    const binDir = path.join(rootDir, 'bin');
+    const cmdPath = path.join(binDir, 'bolloon.cmd');
+
+    if (fs.existsSync(binDir) && !fs.existsSync(cmdPath)) {
+      const cmdContent = `@echo off
+node "%~dp0..\\dist\\cli.js" %*
+`;
+      fs.writeFileSync(cmdPath, cmdContent);
+      log('  ✓ Windows 入口已创建', GREEN);
+    }
+  } else {
+    // Unix/Linux/Mac: 确保 bin 文件可执行
+    const binDir = path.join(rootDir, 'bin');
+    const binPath = path.join(binDir, 'bolloon.js');
+
+    if (fs.existsSync(binPath)) {
+      try {
+        fs.chmodSync(binPath, 0o755);
+        log('  ✓ bin/bolloon.js 已设为可执行', GREEN);
+      } catch (err) {
+        log(`  ⚠ 无法设置执行权限: ${err.message}`, YELLOW);
+      }
+    }
+  }
+}
+
+function main() {
+  console.log('\n📦 Bolloon 安装后处理...\n');
+
+  try {
+    // 1. 初始化用户目录
+    const bolloonDir = initUserDirs();
+    log(`  ✓ 用户数据目录: ${bolloonDir}`, GREEN);
+
+    // 2. 检查依赖
+    const depsOk = checkNativeDeps();
+    if (!depsOk) {
+      log('\n  ⚠ 部分依赖缺失，建议运行: npm install', YELLOW);
+    }
+
+    // 3. 平台特定设置
+    setupPlatform();
+
+    console.log('\n✅ 安装完成！\n');
+    console.log('  使用方式:');
+    console.log('    bolloon              # 启动 GUI');
+    console.log('    bolloon --web        # 启动 Web UI');
+    console.log('    bolloon --cli        # 命令行模式');
+    console.log('    bolloon --help       # 显示帮助\n');
+    console.log(`  配置文件: ${path.join(bolloonDir, 'config.json')}\n`);
+  } catch (err) {
+    console.error('\n❌ 安装后处理失败:', err.message);
+    console.error('  这通常不影响基本功能，继续安装...\n');
+  }
+}
+
+main();