@bolloon/bolloon-agent 0.1.0 → 0.1.2

package/bin/bolloon-cli.cjs

@@ -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/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/bin/bolloon.cmd

@@ -0,0 +1,11 @@
+@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%" %*

package/dist/agents/constraint-layer.js

@@ -1,17 +1,14 @@
-"use strict";
 /**
  * ConstraintLayer - Guardrails for safe autonomous document processing
  * Part of OpenClaw dual-layer architecture (Constraint Layer + Execution Layer)
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ConstraintLayer = exports.CONFIRM_REQUIRED_ACTIONS = exports.AUTONOMOUS_ACTIONS = exports.SYSTEM_PROMPT = void 0;
-const permission_js_1 = require("../constraint-runtime/src/constraint/permission.js");
-const budget_js_1 = require("../constraint-runtime/src/constraint/budget.js");
+import { ToolPermissionContext } from '../constraint-runtime/src/constraint/permission.js';
+import { BudgetTracker } from '../constraint-runtime/src/constraint/budget.js';
 /**
  * System prompt for constraint layer
  * Defines boundaries and autonomous permissions
  */
-exports.SYSTEM_PROMPT = `
+export const SYSTEM_PROMPT = `
 你是一个文档处理Agent，在以下规则下运行：
 
 【边界规则】
@@ -34,23 +31,23 @@ if (操作 === '发送文档' && 对等节点不在已知列表) {
 /**
  * Actions that can be executed autonomously without confirmation
  */
-exports.AUTONOMOUS_ACTIONS = ['summarize', 'chunk', 'improve'];
+export const AUTONOMOUS_ACTIONS = ['summarize', 'chunk', 'improve'];
 /**
  * Actions that require explicit confirmation before execution
  */
-exports.CONFIRM_REQUIRED_ACTIONS = ['send', 'delete'];
+export const CONFIRM_REQUIRED_ACTIONS = ['send', 'delete'];
 /**
  * ConstraintLayer provides guardrails for safe document processing
  * Implements the constraint layer of the OpenClaw dual-layer architecture
  */
-class ConstraintLayer {
+export class ConstraintLayer {
     rules = new Map();
     logs = [];
     permission;
     budget;
     constructor(denyTools = [], denyPrefixes = [], maxBudgetTokens = 2000, maxTurns = 8) {
-        this.permission = permission_js_1.ToolPermissionContext.fromIterables(denyTools, denyPrefixes);
-        this.budget = new budget_js_1.BudgetTracker(maxBudgetTokens, maxTurns);
+        this.permission = ToolPermissionContext.fromIterables(denyTools, denyPrefixes);
+        this.budget = new BudgetTracker(maxBudgetTokens, maxTurns);
         this.registerDefaultRules();
     }
     /**
@@ -192,13 +189,13 @@ class ConstraintLayer {
      * Check if an action is autonomous (no confirmation required)
      */
     isAutonomousAction(action) {
-        return exports.AUTONOMOUS_ACTIONS.includes(action);
+        return AUTONOMOUS_ACTIONS.includes(action);
     }
     /**
      * Check if an action requires confirmation
      */
     requiresConfirmation(action) {
-        return exports.CONFIRM_REQUIRED_ACTIONS.includes(action);
+        return CONFIRM_REQUIRED_ACTIONS.includes(action);
     }
     /**
      * Get all registered rule IDs
@@ -207,5 +204,3 @@ class ConstraintLayer {
         return Array.from(this.rules.keys());
     }
 }
-exports.ConstraintLayer = ConstraintLayer;
-//# sourceMappingURL=constraint-layer.js.map