@bolloon/bolloon-agent 0.1.41 → 0.2.0

package/dist/electron/logger.js

@@ -0,0 +1,114 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.log = log;
+/**
+ * 简单 logger: 写日志到 <userData>/logs/bolloon.log, size-based 轮转
+ * (5MB 上限, 保留 .1 .2 .3 共 3 个备份 → ~20MB 上限)
+ *
+ * 同步写是因为 Electron 主进程日志量小, 同步 append 简单可靠, 不丢日志.
+ * 量大的会话级 jsonl 走自己路径 (lifecycle-hooks 等), 跟本 logger 无关.
+ */
+const fs = __importStar(require("fs"));
+const paths_1 = require("./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((0, paths_1.logsDir)(), { recursive: true });
+        try {
+            currentSize = fs.statSync((0, paths_1.mainLogPath)()).size;
+        }
+        catch {
+            currentSize = 0;
+        }
+    }
+    catch (err) {
+        // 失败也无所谓, log() 内部会 swallow
+        currentSize = 0;
+        console.error('[logger] ensureLogFile failed:', err);
+    }
+}
+function rotate() {
+    const logPath = (0, paths_1.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;
+}
+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((0, paths_1.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());
+}
+//# sourceMappingURL=logger.js.map

package/dist/electron/main.js

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

package/dist/electron/menu.js

@@ -0,0 +1,145 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildAppMenu = buildAppMenu;
+exports.installAppMenu = installAppMenu;
+/**
+ * 应用菜单 — macOS 标准 + File/Edit/View/Window/Help 自定义项
+ * "Open Data Folder" 等会跨平台显示 (mac 也会出现, 不会冲突)
+ */
+const electron_1 = require("electron");
+const paths_1 = require("./paths");
+const logger_1 = require("./logger");
+function openDataFolder() {
+    electron_1.shell.openPath((0, paths_1.dataDir)()).catch((e) => (0, logger_1.log)(`open data folder 失败: ${e.message}`, 'error'));
+}
+function openLogsFolder() {
+    electron_1.shell.openPath((0, paths_1.logsDir)()).catch((e) => (0, logger_1.log)(`open logs folder 失败: ${e.message}`, 'error'));
+}
+function openExternal(url) {
+    electron_1.shell.openExternal(url).catch((e) => (0, logger_1.log)(`openExternal 失败: ${e.message}`, 'error'));
+}
+function buildAppMenu(getMainWindow) {
+    const isMac = process.platform === 'darwin';
+    const win = getMainWindow();
+    const appMenu = {
+        label: electron_1.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${electron_1.app.getVersion()}`,
+                        detail: `P2P AI Document Agent\nData: ${(0, paths_1.dataDir)()}\nLogs: ${(0, paths_1.logsDir)()}`,
+                        buttons: ['OK'],
+                    }).catch(() => { });
+                },
+            },
+        ],
+    };
+    const template = [
+        ...(isMac ? [appMenu] : []),
+        fileMenu,
+        editMenu,
+        viewMenu,
+        windowMenu,
+        helpMenu,
+    ];
+    return electron_1.Menu.buildFromTemplate(template);
+}
+function installAppMenu(getMainWindow) {
+    electron_1.Menu.setApplicationMenu(buildAppMenu(getMainWindow));
+}
+//# sourceMappingURL=menu.js.map

package/dist/electron/paths.js

@@ -0,0 +1,75 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dataDir = dataDir;
+exports.userDataDir = userDataDir;
+exports.logsDir = logsDir;
+exports.mainLogPath = mainLogPath;
+exports.firstRunFlagPath = firstRunFlagPath;
+exports.buildResourcesDir = buildResourcesDir;
+/**
+ * 路径常量 — 单一来源, 避免散落各处
+ *
+ * dataDir: 用户数据 (LLM config / P2P secret / 频道 JSON 等) — 故意保持在 ~/.bolloon/
+ *          与 CLI 共用, 卸载 app 不删数据. 不要改这个路径, 不要做 userData 重定向.
+ * userDataDir: Electron 的 app.getPath('userData'), 用来放日志 / 临时 / 锁文件
+ * logsDir: userData 下的 logs/ 子目录
+ */
+const electron_1 = require("electron");
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+function dataDir() {
+    return path.join(os.homedir(), '.bolloon');
+}
+function userDataDir() {
+    return electron_1.app.getPath('userData');
+}
+function logsDir() {
+    return path.join(userDataDir(), 'logs');
+}
+function mainLogPath() {
+    return path.join(logsDir(), 'bolloon.log');
+}
+function firstRunFlagPath() {
+    return path.join(userDataDir(), '.bolloon-first-run-seen');
+}
+/** 资源目录: packaged 下是 process.resourcesPath/build, dev 下是 repo/build/ */
+function buildResourcesDir() {
+    if (electron_1.app.isPackaged) {
+        return path.join(process.resourcesPath, 'build');
+    }
+    return path.join(electron_1.app.getAppPath(), 'build');
+}
+//# sourceMappingURL=paths.js.map

package/dist/electron/server.js

@@ -0,0 +1,112 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getWebServerProcess = getWebServerProcess;
+exports.killWebServer = killWebServer;
+exports.startWebServer = startWebServer;
+/**
+ * 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).
+ */
+const child_process_1 = require("child_process");
+const path = __importStar(require("path"));
+const logger_1 = require("./logger");
+const config_1 = require("./config");
+let webServerProcess = null;
+function getWebServerProcess() {
+    return webServerProcess;
+}
+function killWebServer() {
+    if (webServerProcess && !webServerProcess.killed) {
+        (0, logger_1.log)('终止 Web 服务器进程');
+        webServerProcess.kill();
+    }
+    webServerProcess = null;
+}
+function startWebServer(preferredPort) {
+    return new Promise((resolve, reject) => {
+        const serverScript = path.join(__dirname, '..', 'web', 'server.js');
+        (0, logger_1.log)(`启动 Web 服务器进程: ${serverScript}`);
+        // ELECTRON_RUN_AS_NODE=1 — packaged 时 process.execPath 是 Electron 二进制,
+        // 没这行 require() 会失败. Dev 模式 (electron dist/electron.js) 同样情况.
+        webServerProcess = (0, child_process_1.spawn)(process.execPath, [serverScript], {
+            env: {
+                ...process.env,
+                ELECTRON_RUN_AS_NODE: '1',
+                NODE_ENV: 'production',
+                PORT: String(preferredPort),
+                ELECTRON_PORT: String(preferredPort),
+                BOLLOON_HOST: config_1.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);
+                (0, logger_1.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) => {
+            (0, logger_1.log)(`Web 服务器启动失败: ${err.message}`, 'error');
+            reject(err);
+        });
+        webServerProcess.on('exit', (code, signal) => {
+            (0, logger_1.log)(`Web 服务器退出: code=${code} signal=${signal}`);
+            if (code !== 0 && code !== null) {
+                (0, logger_1.log)(`Web 服务器 stderr: ${stderrData}`, 'error');
+            }
+            webServerProcess = null;
+        });
+        setTimeout(() => {
+            if (webServerProcess && !webServerProcess.killed) {
+                (0, logger_1.log)(`Web 服务器启动超时 (${config_1.WEB_SERVER_STARTUP_TIMEOUT_MS}ms)`, 'error');
+                reject(new Error('Web server startup timeout'));
+            }
+        }, config_1.WEB_SERVER_STARTUP_TIMEOUT_MS);
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/electron/tray.js

@@ -0,0 +1,111 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTray = createTray;
+exports.destroyTray = destroyTray;
+/**
+ * 系统托盘 — Show / Hide / Quit
+ *
+ * 图标资源要求 (需用户自备):
+ *   build/trayTemplate.png  (mac, 16x16 + 32x32 @2x, 单色 alpha, 自动暗/亮)
+ *   build/tray.png          (win/linux, 16x16 + 32x32)
+ *
+ * 若 build 目录没有 tray 图标, 降级为不创建托盘 (主菜单和窗口关闭行为不变)
+ */
+const electron_1 = require("electron");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const paths_1 = require("./paths");
+const logger_1 = require("./logger");
+let trayInstance = null;
+function loadTrayIcon() {
+    const isMac = process.platform === 'darwin';
+    const file = isMac ? 'trayTemplate.png' : 'tray.png';
+    const iconPath = path.join((0, paths_1.buildResourcesDir)(), file);
+    if (!fs.existsSync(iconPath)) {
+        (0, logger_1.log)(`托盘图标缺失: ${iconPath} (跳过托盘创建)`, 'warn');
+        return null;
+    }
+    const img = electron_1.nativeImage.createFromPath(iconPath);
+    if (isMac)
+        img.setTemplateImage(true);
+    return img;
+}
+function createTray(getMainWindow) {
+    if (trayInstance)
+        return;
+    const icon = loadTrayIcon();
+    if (!icon)
+        return;
+    trayInstance = new electron_1.Tray(icon);
+    trayInstance.setToolTip(`Bolloon Agent v${electron_1.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 = electron_1.Menu.buildFromTemplate([
+        { label: 'Show / Hide', click: () => toggle() },
+        { type: 'separator' },
+        {
+            label: 'Quit',
+            click: () => {
+                (0, logger_1.log)('托盘菜单 Quit');
+                electron_1.app.quit();
+            },
+        },
+    ]);
+    trayInstance.setContextMenu(menu);
+    // mac 默认 click 弹菜单, win/linux 默认 click 触发自定义
+    if (process.platform !== 'darwin') {
+        trayInstance.on('click', () => toggle());
+    }
+}
+function destroyTray() {
+    if (trayInstance) {
+        trayInstance.destroy();
+        trayInstance = null;
+    }
+}
+//# sourceMappingURL=tray.js.map