@bolloon/bolloon-agent 0.1.42 → 0.2.1

package/dist/electron/logger.js

@@ -0,0 +1,77 @@
+/**
+ * 简单 logger: 写日志到 <userData>/logs/bolloon.log, size-based 轮转
+ * (5MB 上限, 保留 .1 .2 .3 共 3 个备份 → ~20MB 上限)
+ *
+ * 同步写是因为 Electron 主进程日志量小, 同步 append 简单可靠, 不丢日志.
+ * 量大的会话级 jsonl 走自己路径 (lifecycle-hooks 等), 跟本 logger 无关.
+ */
+import * as fs from 'fs';
+import { mainLogPath, logsDir } from './paths';
+const MAX_BYTES = 5 * 1024 * 1024;
+const MAX_BACKUPS = 3; // 保留 bolloon.log.1 .2 .3
+let currentSize = 0;
+let initialized = false;
+function ensureLogFile() {
+    if (initialized)
+        return;
+    initialized = true;
+    try {
+        fs.mkdirSync(logsDir(), { recursive: true });
+        try {
+            currentSize = fs.statSync(mainLogPath()).size;
+        }
+        catch {
+            currentSize = 0;
+        }
+    }
+    catch (err) {
+        // 失败也无所谓, log() 内部会 swallow
+        currentSize = 0;
+        console.error('[logger] ensureLogFile failed:', err);
+    }
+}
+function rotate() {
+    const logPath = mainLogPath();
+    for (let i = MAX_BACKUPS; i >= 1; i--) {
+        const src = `${logPath}.${i}`;
+        const dst = `${logPath}.${i + 1}`;
+        if (i === MAX_BACKUPS) {
+            try {
+                fs.unlinkSync(src);
+            }
+            catch { /* missing ok */ }
+        }
+        else {
+            try {
+                fs.renameSync(src, dst);
+            }
+            catch { /* missing ok */ }
+        }
+    }
+    try {
+        fs.renameSync(logPath, `${logPath}.1`);
+    }
+    catch { /* missing ok */ }
+    currentSize = 0;
+}
+export function log(message, level = 'info') {
+    ensureLogFile();
+    const ts = new Date().toISOString();
+    const line = `[${ts}] [${level}] ${message}\n`;
+    if (currentSize + line.length > MAX_BYTES)
+        rotate();
+    try {
+        fs.appendFileSync(mainLogPath(), line);
+        currentSize += line.length;
+    }
+    catch (err) {
+        // 写不进就 console, 不要再递归 log
+        console.error('[logger] appendFileSync failed:', err);
+    }
+    if (level === 'error')
+        console.error(line.trimEnd());
+    else if (level === 'warn')
+        console.warn(line.trimEnd());
+    else
+        console.log(line.trimEnd());
+}

package/dist/electron/main.js

@@ -0,0 +1,60 @@
+/**
+ * Electron 主进程 lifecycle 入口
+ * 单实例锁 → whenReady → createMainWindow → cleanup on quit
+ * 启动时: 装 menu / tray / IPC handlers / 首启引导
+ */
+import { app, BrowserWindow } from 'electron';
+import { log } from './logger';
+import { createMainWindow, focusMainWindow, getMainWindow } from './window';
+import { killWebServer } from './server';
+import { installAppMenu } from './menu';
+import { createTray, destroyTray } from './tray';
+import { registerCoreIpc } from './ipc';
+import { registerDialogIpc } from './dialogs';
+import { registerFirstRunIpc, maybeShowFirstRun } from './first-run';
+log('Bolloon Electron 启动');
+// 单实例锁
+const gotTheLock = app.requestSingleInstanceLock();
+if (!gotTheLock) {
+    log('已有实例在运行，退出');
+    app.quit();
+}
+app.on('second-instance', () => {
+    focusMainWindow();
+});
+app.whenReady().then(async () => {
+    log('Electron 准备好');
+    registerCoreIpc();
+    registerDialogIpc();
+    registerFirstRunIpc();
+    installAppMenu(getMainWindow);
+    createTray(getMainWindow);
+    await createMainWindow();
+    // 首启引导 (在主窗口就绪后弹, 不阻塞 UI)
+    const win = getMainWindow();
+    if (win) {
+        win.webContents.once('did-finish-load', () => {
+            void maybeShowFirstRun(win);
+        });
+    }
+    app.on('activate', async () => {
+        // macOS: dock 图标被点击且没有窗口时, 重开
+        if (BrowserWindow.getAllWindows().length === 0) {
+            await createMainWindow();
+        }
+    });
+});
+app.on('window-all-closed', () => {
+    log('所有窗口已关闭');
+    destroyTray();
+    killWebServer();
+    if (process.platform !== 'darwin') {
+        app.quit();
+    }
+});
+app.on('before-quit', () => {
+    log('应用即将退出');
+    destroyTray();
+    killWebServer();
+});
+log('主进程初始化完成');

package/dist/electron/menu.js

@@ -0,0 +1,140 @@
+/**
+ * 应用菜单 — macOS 标准 + File/Edit/View/Window/Help 自定义项
+ * "Open Data Folder" 等会跨平台显示 (mac 也会出现, 不会冲突)
+ */
+import { app, Menu, shell } from 'electron';
+import { dataDir, logsDir } from './paths';
+import { log } from './logger';
+function openDataFolder() {
+    shell.openPath(dataDir()).catch((e) => log(`open data folder 失败: ${e.message}`, 'error'));
+}
+function openLogsFolder() {
+    shell.openPath(logsDir()).catch((e) => log(`open logs folder 失败: ${e.message}`, 'error'));
+}
+function openExternal(url) {
+    shell.openExternal(url).catch((e) => log(`openExternal 失败: ${e.message}`, 'error'));
+}
+export function buildAppMenu(getMainWindow) {
+    const isMac = process.platform === 'darwin';
+    const win = getMainWindow();
+    const appMenu = {
+        label: app.getName(),
+        submenu: [
+            { role: 'about' },
+            { type: 'separator' },
+            { role: 'services' },
+            { type: 'separator' },
+            { role: 'hide' },
+            { role: 'hideOthers' },
+            { role: 'unhide' },
+            { type: 'separator' },
+            { role: 'quit' },
+        ],
+    };
+    const fileMenu = {
+        label: 'File',
+        submenu: [
+            {
+                label: 'Open Data Folder',
+                accelerator: 'CmdOrCtrl+Shift+D',
+                click: () => openDataFolder(),
+            },
+            {
+                label: 'Open Logs Folder',
+                accelerator: 'CmdOrCtrl+Shift+L',
+                click: () => openLogsFolder(),
+            },
+            { type: 'separator' },
+            isMac ? { role: 'close' } : { role: 'quit' },
+        ],
+    };
+    const editMenu = {
+        label: 'Edit',
+        submenu: [
+            { role: 'undo' },
+            { role: 'redo' },
+            { type: 'separator' },
+            { role: 'cut' },
+            { role: 'copy' },
+            { role: 'paste' },
+            { role: 'selectAll' },
+        ],
+    };
+    const viewMenu = {
+        label: 'View',
+        submenu: [
+            {
+                label: 'Reload',
+                accelerator: 'CmdOrCtrl+R',
+                click: () => win?.webContents.reload(),
+            },
+            {
+                label: 'Force Reload',
+                accelerator: 'CmdOrCtrl+Shift+R',
+                click: () => win?.webContents.reloadIgnoringCache(),
+            },
+            {
+                label: 'Toggle DevTools',
+                accelerator: isMac ? 'Alt+Cmd+I' : 'Ctrl+Shift+I',
+                click: () => win?.webContents.toggleDevTools(),
+            },
+            { type: 'separator' },
+            { role: 'resetZoom' },
+            { role: 'zoomIn' },
+            { role: 'zoomOut' },
+            { type: 'separator' },
+            { role: 'togglefullscreen' },
+        ],
+    };
+    const windowMenu = {
+        label: 'Window',
+        submenu: [
+            { role: 'minimize' },
+            { role: 'zoom' },
+            ...(isMac
+                ? [{ type: 'separator' }, { role: 'front' }]
+                : [{ role: 'close' }]),
+        ],
+    };
+    const helpMenu = {
+        role: 'help',
+        submenu: [
+            {
+                label: 'GitHub Repository',
+                click: () => openExternal('https://github.com/bolloon/bolloon'),
+            },
+            {
+                label: 'Report Issue',
+                click: () => openExternal('https://github.com/bolloon/bolloon/issues'),
+            },
+            { type: 'separator' },
+            {
+                label: 'About Bolloon Agent',
+                click: () => {
+                    // 简单 about — 用 dialog 暂代 (避免再造 HTML 窗口)
+                    // 真实 about panel 在 macOS 是 app.role 触发的, 我们走菜单项即可
+                    const { dialog } = require('electron');
+                    dialog.showMessageBox({
+                        type: 'info',
+                        title: 'About Bolloon Agent',
+                        message: `Bolloon Agent v${app.getVersion()}`,
+                        detail: `P2P AI Document Agent\nData: ${dataDir()}\nLogs: ${logsDir()}`,
+                        buttons: ['OK'],
+                    }).catch(() => { });
+                },
+            },
+        ],
+    };
+    const template = [
+        ...(isMac ? [appMenu] : []),
+        fileMenu,
+        editMenu,
+        viewMenu,
+        windowMenu,
+        helpMenu,
+    ];
+    return Menu.buildFromTemplate(template);
+}
+export function installAppMenu(getMainWindow) {
+    Menu.setApplicationMenu(buildAppMenu(getMainWindow));
+}

package/dist/electron/paths.js

@@ -0,0 +1,33 @@
+/**
+ * 路径常量 — 单一来源, 避免散落各处
+ *
+ * dataDir: 用户数据 (LLM config / P2P secret / 频道 JSON 等) — 故意保持在 ~/.bolloon/
+ *          与 CLI 共用, 卸载 app 不删数据. 不要改这个路径, 不要做 userData 重定向.
+ * userDataDir: Electron 的 app.getPath('userData'), 用来放日志 / 临时 / 锁文件
+ * logsDir: userData 下的 logs/ 子目录
+ */
+import { app } from 'electron';
+import * as os from 'os';
+import * as path from 'path';
+export function dataDir() {
+    return path.join(os.homedir(), '.bolloon');
+}
+export function userDataDir() {
+    return app.getPath('userData');
+}
+export function logsDir() {
+    return path.join(userDataDir(), 'logs');
+}
+export function mainLogPath() {
+    return path.join(logsDir(), 'bolloon.log');
+}
+export function firstRunFlagPath() {
+    return path.join(userDataDir(), '.bolloon-first-run-seen');
+}
+/** 资源目录: packaged 下是 process.resourcesPath/build, dev 下是 repo/build/ */
+export function buildResourcesDir() {
+    if (app.isPackaged) {
+        return path.join(process.resourcesPath, 'build');
+    }
+    return path.join(app.getAppPath(), 'build');
+}

package/dist/electron/server.js

@@ -0,0 +1,73 @@
+/**
+ * Spawns dist/web/server.js as a child Node process (via Electron's
+ * ELECTRON_RUN_AS_NODE=1) and parses BOLLOON_PORT=NNNN to learn the
+ * actually-bound port (which may have drifted from the preferred port
+ * due to EADDRINUSE auto-bump).
+ */
+import { spawn } from 'child_process';
+import * as path from 'path';
+import { log } from './logger';
+import { WEB_SERVER_STARTUP_TIMEOUT_MS, DEFAULT_HOST } from './config';
+let webServerProcess = null;
+export function getWebServerProcess() {
+    return webServerProcess;
+}
+export function killWebServer() {
+    if (webServerProcess && !webServerProcess.killed) {
+        log('终止 Web 服务器进程');
+        webServerProcess.kill();
+    }
+    webServerProcess = null;
+}
+export function startWebServer(preferredPort) {
+    return new Promise((resolve, reject) => {
+        const serverScript = path.join(__dirname, '..', 'web', 'server.js');
+        log(`启动 Web 服务器进程: ${serverScript}`);
+        // ELECTRON_RUN_AS_NODE=1 — packaged 时 process.execPath 是 Electron 二进制,
+        // 没这行 require() 会失败. Dev 模式 (electron dist/electron.js) 同样情况.
+        webServerProcess = spawn(process.execPath, [serverScript], {
+            env: {
+                ...process.env,
+                ELECTRON_RUN_AS_NODE: '1',
+                NODE_ENV: 'production',
+                PORT: String(preferredPort),
+                ELECTRON_PORT: String(preferredPort),
+                BOLLOON_HOST: DEFAULT_HOST,
+            },
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let stdoutBuf = '';
+        let stderrData = '';
+        webServerProcess.stdout?.on('data', (data) => {
+            stdoutBuf += data.toString();
+            process.stdout.write(`[WebServer] ${data}`);
+            const m = stdoutBuf.match(/^BOLLOON_PORT=(\d+)/m);
+            if (m) {
+                const actualPort = parseInt(m[1], 10);
+                log(`Web 服务器就绪: 实际端口=${actualPort} (preferred=${preferredPort})`);
+                resolve({ port: actualPort });
+            }
+        });
+        webServerProcess.stderr?.on('data', (data) => {
+            stderrData += data.toString();
+            process.stderr.write(`[WebServer ERR] ${data}`);
+        });
+        webServerProcess.on('error', (err) => {
+            log(`Web 服务器启动失败: ${err.message}`, 'error');
+            reject(err);
+        });
+        webServerProcess.on('exit', (code, signal) => {
+            log(`Web 服务器退出: code=${code} signal=${signal}`);
+            if (code !== 0 && code !== null) {
+                log(`Web 服务器 stderr: ${stderrData}`, 'error');
+            }
+            webServerProcess = null;
+        });
+        setTimeout(() => {
+            if (webServerProcess && !webServerProcess.killed) {
+                log(`Web 服务器启动超时 (${WEB_SERVER_STARTUP_TIMEOUT_MS}ms)`, 'error');
+                reject(new Error('Web server startup timeout'));
+            }
+        }, WEB_SERVER_STARTUP_TIMEOUT_MS);
+    });
+}

package/dist/electron/tray.js

@@ -0,0 +1,73 @@
+/**
+ * 系统托盘 — Show / Hide / Quit
+ *
+ * 图标资源要求 (需用户自备):
+ *   build/trayTemplate.png  (mac, 16x16 + 32x32 @2x, 单色 alpha, 自动暗/亮)
+ *   build/tray.png          (win/linux, 16x16 + 32x32)
+ *
+ * 若 build 目录没有 tray 图标, 降级为不创建托盘 (主菜单和窗口关闭行为不变)
+ */
+import { Tray, Menu, nativeImage, app } from 'electron';
+import * as path from 'path';
+import * as fs from 'fs';
+import { buildResourcesDir } from './paths';
+import { log } from './logger';
+let trayInstance = null;
+function loadTrayIcon() {
+    const isMac = process.platform === 'darwin';
+    const file = isMac ? 'trayTemplate.png' : 'tray.png';
+    const iconPath = path.join(buildResourcesDir(), file);
+    if (!fs.existsSync(iconPath)) {
+        log(`托盘图标缺失: ${iconPath} (跳过托盘创建)`, 'warn');
+        return null;
+    }
+    const img = nativeImage.createFromPath(iconPath);
+    if (isMac)
+        img.setTemplateImage(true);
+    return img;
+}
+export function createTray(getMainWindow) {
+    if (trayInstance)
+        return;
+    const icon = loadTrayIcon();
+    if (!icon)
+        return;
+    trayInstance = new Tray(icon);
+    trayInstance.setToolTip(`Bolloon Agent v${app.getVersion()}`);
+    const toggle = () => {
+        const w = getMainWindow();
+        if (!w)
+            return;
+        if (w.isVisible() && w.isFocused()) {
+            w.hide();
+        }
+        else {
+            if (w.isMinimized())
+                w.restore();
+            w.show();
+            w.focus();
+        }
+    };
+    const menu = Menu.buildFromTemplate([
+        { label: 'Show / Hide', click: () => toggle() },
+        { type: 'separator' },
+        {
+            label: 'Quit',
+            click: () => {
+                log('托盘菜单 Quit');
+                app.quit();
+            },
+        },
+    ]);
+    trayInstance.setContextMenu(menu);
+    // mac 默认 click 弹菜单, win/linux 默认 click 触发自定义
+    if (process.platform !== 'darwin') {
+        trayInstance.on('click', () => toggle());
+    }
+}
+export function destroyTray() {
+    if (trayInstance) {
+        trayInstance.destroy();
+        trayInstance = null;
+    }
+}

package/dist/electron/window.js

@@ -0,0 +1,69 @@
+/**
+ * 主窗口工厂 — preload 路径解析 + dev/prod loadURL + 外部链接走系统浏览器
+ */
+import { BrowserWindow, shell } from 'electron';
+import * as path from 'path';
+import { log } from './logger';
+import { isDev, MAIN_WINDOW_DEFAULT, MAIN_WINDOW_MIN, preferredPort } from './config';
+import { startWebServer } from './server';
+let mainWindow = null;
+export function getMainWindow() {
+    return mainWindow;
+}
+export async function createMainWindow() {
+    log('创建主窗口...');
+    mainWindow = new BrowserWindow({
+        width: MAIN_WINDOW_DEFAULT.width,
+        height: MAIN_WINDOW_DEFAULT.height,
+        minWidth: MAIN_WINDOW_MIN.width,
+        minHeight: MAIN_WINDOW_MIN.height,
+        title: 'Bolloon Agent',
+        webPreferences: {
+            nodeIntegration: false,
+            contextIsolation: true,
+            sandbox: false, // MCP/spawn 等需要 fs; 真正的隔离靠 preload 边界
+            preload: path.join(__dirname, '..', 'electron-preload.js'),
+        },
+        show: false,
+    });
+    if (isDev) {
+        // dev:web 用 tsx 起 server, 端口固定 preferredPort, 不会 EADDRINUSE 自增
+        const port = preferredPort();
+        mainWindow.loadURL(`http://localhost:${port}`);
+        mainWindow.webContents.openDevTools();
+    }
+    else {
+        try {
+            log('启动内置 Web 服务器...');
+            const { port: actualPort } = await startWebServer(preferredPort());
+            mainWindow.loadURL(`http://localhost:${actualPort}`);
+        }
+        catch (err) {
+            log(`启动服务器失败: ${err.message}`, 'error');
+            console.error('启动服务器失败:', err);
+        }
+    }
+    mainWindow.once('ready-to-show', () => {
+        mainWindow?.show();
+        log('窗口已显示');
+    });
+    // 外部链接走系统浏览器, 不在 app 内开新窗口
+    mainWindow.webContents.setWindowOpenHandler(({ url }) => {
+        if (url.startsWith('http://') || url.startsWith('https://')) {
+            shell.openExternal(url);
+        }
+        return { action: 'deny' };
+    });
+    mainWindow.on('closed', () => {
+        mainWindow = null;
+    });
+    log('窗口创建完成');
+}
+export function focusMainWindow() {
+    if (!mainWindow)
+        return;
+    if (mainWindow.isMinimized())
+        mainWindow.restore();
+    mainWindow.show();
+    mainWindow.focus();
+}

package/dist/index.js

@@ -1928,9 +1928,12 @@ async function main() {
         }
         const { createWebServer, openBrowser } = await import('./web/server.js');
         s.info(`启动 Web 服务端口 ${port}...`);
-        const { port: actualPort } = await createWebServer(port, { selfImprove });
-        s.success(`浏览器已打开 → http://localhost:${actualPort}`);
-        openBrowser(`http://localhost:${actualPort}`);
+        // 2026-06-24: CLI 默认 loopback bind (安全), LAN 访问需 BOLLOON_HOST=0.0.0.0
+        const bindHost = process.env.BOLLOON_HOST;
+        const { port: actualPort } = await createWebServer(port, { selfImprove, ...(bindHost ? { host: bindHost } : {}) });
+        const displayHost = bindHost ?? '127.0.0.1';
+        s.success(`浏览器已打开 → http://${displayHost}:${actualPort}`);
+        openBrowser(`http://${displayHost}:${actualPort}`);
     }
     else if (isNonInteractive) {
         console.log = originalLog;

package/dist/security/tool-gate.js

@@ -32,6 +32,10 @@ const TOOL_WHITELIST = new Set([
     'vitest_run', 'tsc_check',
     // 2026-06-19: Agent Mesh 通信工具 (跟 pi-sdk.ts registerTools 同步)
     'check_inbox', 'send_to_peer', 'p2p_broadcast', 'send_to_local_agent', 'list_local_agents', 'agent_call',
+    // 2026-06-24: Wallet + Polymarket + Safe 工具 (跟 pi-sdk.ts _registerWalletTools 同步)
+    'wallet_create', 'wallet_import', 'wallet_get_balance', 'wallet_sign_message', 'wallet_send_tx', 'wallet_transfer_token', 'wallet_autopay',
+    'polymarket_list_markets', 'polymarket_get_market', 'polymarket_get_orders', 'polymarket_create_order', 'polymarket_cancel_order',
+    'safe_deploy',
     // MCP 注册的工具
     'mcp_tool',
 ]);