@bolloon/bolloon-agent 0.4.28 → 0.4.29

package/dist/electron-build/documents/reader.js

@@ -0,0 +1,131 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.documentReader = exports.DocumentReader = void 0;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const pdf_parse_1 = require("pdf-parse");
+const mammoth_1 = __importDefault(require("mammoth"));
+class DocumentReader {
+    async read(filePath) {
+        if (!filePath || typeof filePath !== 'string' || !filePath.trim()) {
+            throw new Error('read(filePath): filePath 必填且必须是非空字符串');
+        }
+        const stats = await fs.stat(filePath);
+        const ext = path.extname(filePath).toLowerCase();
+        const filename = path.basename(filePath);
+        let text;
+        switch (ext) {
+            case '.txt':
+            case '.md':
+            case '.html':
+            case '.htm':
+            case '.yaml':
+            case '.yml':
+            case '.json':
+            // M3.5 (2026-06-17): agent 自读源码需要 — 之前 .ts 不支持, LLM 拿到空内容
+            //   .ts/.tsx/.js/.jsx 都是纯文本, 直接 readFile
+            case '.ts':
+            case '.tsx':
+            case '.js':
+            case '.jsx':
+            case '.mjs':
+            case '.cjs':
+            case '.py':
+            case '.go':
+            case '.rs':
+            case '.java':
+            case '.sh':
+            case '.bash':
+                text = await fs.readFile(filePath, 'utf-8');
+                break;
+            case '.pdf':
+                text = await this.readPdf(filePath);
+                break;
+            case '.docx':
+                text = await this.readDocx(filePath);
+                break;
+            default:
+                throw new Error(`Unsupported file type: ${ext}`);
+        }
+        return {
+            text,
+            metadata: {
+                filename,
+                size: stats.size,
+                type: ext
+            }
+        };
+    }
+    async readPdf(filePath) {
+        const dataBuffer = await fs.readFile(filePath);
+        const parser = new pdf_parse_1.PDFParse({ data: dataBuffer });
+        try {
+            const result = await parser.getText();
+            return result.text;
+        }
+        finally {
+            await parser.destroy();
+        }
+    }
+    async readDocx(filePath) {
+        const result = await mammoth_1.default.extractRawText({ path: filePath });
+        return result.value;
+    }
+    chunk(text, maxChunkSize = 4000) {
+        const chunks = [];
+        let current = '';
+        const sentences = text.split(/(?<=[.!?。！？])\s+/);
+        for (const sentence of sentences) {
+            if ((current + sentence).length <= maxChunkSize) {
+                current += (current ? ' ' : '') + sentence;
+            }
+            else {
+                if (current)
+                    chunks.push(current);
+                current = sentence;
+            }
+        }
+        if (current)
+            chunks.push(current);
+        return chunks;
+    }
+}
+exports.DocumentReader = DocumentReader;
+exports.documentReader = new DocumentReader();
+//# sourceMappingURL=reader.js.map

package/dist/electron-build/documents/reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.js","sourceRoot":"","sources":["../../../src/documents/reader.ts"],"names":[],"mappings":"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"}

package/dist/electron-build/documents/store.js

@@ -0,0 +1,220 @@
+"use strict";
+/**
+ * Document Store - P2P Document Receiving and Storage
+ * 接收并存储来自其他 iroh 节点的文档
+ */
+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.documentStore = exports.DocumentStore = void 0;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+class DocumentStore {
+    baseDir;
+    pendingDocs = new Map();
+    receivedCallback = null;
+    constructor(baseDir) {
+        this.baseDir = baseDir || path.join(process.env.HOME || '/tmp', '.bolloon', 'documents', 'received');
+    }
+    async initialize() {
+        await fs.mkdir(this.baseDir, { recursive: true });
+        await fs.mkdir(path.join(this.baseDir, 'chunks'), { recursive: true });
+        console.log('[DocumentStore] Initialized at', this.baseDir);
+    }
+    onDocumentReceived(callback) {
+        this.receivedCallback = callback;
+    }
+    async receiveChunk(chunk) {
+        const { docId, chunkIndex, totalChunks, fileName, fileSize, mimeType, content, fromNodeId, message, timestamp } = chunk;
+        // 获取或创建 pending document
+        let pending = this.pendingDocs.get(docId);
+        if (!pending) {
+            pending = {
+                docId,
+                fileName,
+                fileSize,
+                mimeType,
+                totalChunks,
+                receivedChunks: new Map(),
+                fromNodeId,
+                message,
+                timestamp,
+            };
+            this.pendingDocs.set(docId, pending);
+        }
+        // 存储分块
+        pending.receivedChunks.set(chunkIndex, content);
+        // 检查是否收齐
+        if (pending.receivedChunks.size >= totalChunks) {
+            return this.assembleDocument(docId);
+        }
+        return null;
+    }
+    async assembleDocument(docId) {
+        const pending = this.pendingDocs.get(docId);
+        if (!pending)
+            return null;
+        try {
+            // 按顺序合并所有分块
+            const allContent = [];
+            for (let i = 0; i < pending.totalChunks; i++) {
+                const chunkContent = pending.receivedChunks.get(i);
+                if (!chunkContent) {
+                    console.warn(`[DocumentStore] Missing chunk ${i} for doc ${docId}`);
+                    return null;
+                }
+                const bytes = Uint8Array.from(atob(chunkContent), c => c.charCodeAt(0));
+                allContent.push(...Array.from(bytes));
+            }
+            // 创建文档目录
+            const docDir = path.join(this.baseDir, docId);
+            await fs.mkdir(docDir, { recursive: true });
+            // 保存文件
+            const filePath = path.join(docDir, pending.fileName);
+            await fs.writeFile(filePath, Buffer.from(allContent));
+            // 保存 manifest
+            const manifest = {
+                id: docId,
+                fileName: pending.fileName,
+                fileSize: pending.fileSize,
+                mimeType: pending.mimeType,
+                fromNodeId: pending.fromNodeId,
+                receivedAt: Date.now(),
+                message: pending.message,
+            };
+            await fs.writeFile(path.join(docDir, 'manifest.json'), JSON.stringify(manifest, null, 2));
+            // 更新索引
+            await this.updateIndex(manifest);
+            // 清理 pending
+            this.pendingDocs.delete(docId);
+            const receivedDoc = {
+                ...manifest,
+                fromNodeIdShort: pending.fromNodeId.substring(0, 16) + '...',
+                path: filePath,
+            };
+            // 触发回调
+            if (this.receivedCallback) {
+                this.receivedCallback(receivedDoc);
+            }
+            console.log(`[DocumentStore] Document assembled: ${pending.fileName} (${pending.fileSize} bytes)`);
+            return receivedDoc;
+        }
+        catch (e) {
+            console.error('[DocumentStore] Failed to assemble document:', e);
+            this.pendingDocs.delete(docId);
+            return null;
+        }
+    }
+    async updateIndex(manifest) {
+        const indexPath = path.join(this.baseDir, 'index.json');
+        let index = [];
+        try {
+            const existing = await fs.readFile(indexPath, 'utf-8');
+            index = JSON.parse(existing);
+        }
+        catch {
+            // Index doesn't exist yet
+        }
+        // 添加新文档
+        index.unshift(manifest); // newest first
+        // 只保留最近 100 条
+        if (index.length > 100) {
+            index = index.slice(0, 100);
+        }
+        await fs.writeFile(indexPath, JSON.stringify(index, null, 2));
+    }
+    async getReceivedDocuments(limit = 50, senderPeerId) {
+        const indexPath = path.join(this.baseDir, 'index.json');
+        try {
+            const data = await fs.readFile(indexPath, 'utf-8');
+            let docs = JSON.parse(data);
+            if (senderPeerId) {
+                docs = docs.filter(d => d.fromNodeId === senderPeerId);
+            }
+            return docs.slice(0, limit).map(doc => ({
+                ...doc,
+                fromNodeIdShort: doc.fromNodeId.substring(0, 16) + '...',
+                path: path.join(this.baseDir, doc.id, doc.fileName),
+            }));
+        }
+        catch {
+            return [];
+        }
+    }
+    async readDocument(docId) {
+        const docDir = path.join(this.baseDir, docId);
+        const manifestPath = path.join(docDir, 'manifest.json');
+        try {
+            const manifestData = await fs.readFile(manifestPath, 'utf-8');
+            const manifest = JSON.parse(manifestData);
+            const filePath = path.join(docDir, manifest.fileName);
+            const fileContent = await fs.readFile(filePath, 'utf-8');
+            return {
+                content: fileContent,
+                metadata: {
+                    ...manifest,
+                    fromNodeIdShort: manifest.fromNodeId.substring(0, 16) + '...',
+                    path: filePath,
+                },
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    async deleteDocument(docId) {
+        const docDir = path.join(this.baseDir, docId);
+        try {
+            await fs.rm(docDir, { recursive: true });
+            // 更新索引
+            const indexPath = path.join(this.baseDir, 'index.json');
+            try {
+                const data = await fs.readFile(indexPath, 'utf-8');
+                let index = JSON.parse(data);
+                index = index.filter(d => d.id !== docId);
+                await fs.writeFile(indexPath, JSON.stringify(index, null, 2));
+            }
+            catch {
+                // Index doesn't exist
+            }
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+exports.DocumentStore = DocumentStore;
+exports.documentStore = new DocumentStore();
+//# sourceMappingURL=store.js.map

package/dist/electron-build/documents/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../src/documents/store.ts"],"names":[],"mappings":"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"}

package/dist/electron-build/external-engines/delegate-handle.js

@@ -0,0 +1,76 @@
+"use strict";
+/**
+ * delegate-handle.ts — 委派句柄 (借鉴 Hermes Agent `agent/subagent_lifecycle.py` 的 handle 设计)
+ *
+ * Hermes 模式: 子任务 handle 是不可变契约 + HMAC 签名 capability,
+ *   `capability = HMAC(secret, subagent_id|parent_session_id|created_at)`,
+ *   校验时 strict 类型检查 + `hmac.compare_digest` 定时安全比对 + 父 session 必须匹配。
+ *   子 agent 拿到 handle 也伪造不了、跨 session 用不了 — 防提权。
+ *
+ * Bolloon 对应物: delegate_to_engine 的委派记录。
+ *   - 父身份用 `ownerDid` (agent 的 DID, 稳定跨重启; 比 sessionId 更适合防跨 channel)
+ *   - handle 写入 sidechain JSONL 落盘, 可事后验证记录真实性 (防伪造委派记录)
+ *   - correlationId 支持幂等去重 (同一 parent+correlation 只允许一次)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DELEGATE_CONTRACT_VERSION = void 0;
+exports.createDelegateHandle = createDelegateHandle;
+exports.verifyDelegateHandle = verifyDelegateHandle;
+const crypto_1 = require("crypto");
+/** 契约版本: 结构不兼容时递增, 旧 handle 直接拒绝而不是猜字段 */
+exports.DELEGATE_CONTRACT_VERSION = 1;
+/**
+ * 进程级随机密钥 (与 Hermes `_SECRET = secrets.token_bytes(32)` 同思路):
+ * 每次启动重新生成 → 重启后的旧 handle 全部失效, 序列化 handle 不可重放。
+ */
+const _SECRET = (0, crypto_1.randomBytes)(32);
+function _capability(delegateId, ownerDid, createdAt) {
+    return (0, crypto_1.createHmac)('sha256', _SECRET)
+        .update(`${delegateId}|${ownerDid}|${createdAt}`)
+        .digest('hex');
+}
+/** 创建委派句柄 (与 Hermes launch() 返回 SubagentHandle 对应) */
+function createDelegateHandle(opts) {
+    const delegateId = (0, crypto_1.randomUUID)();
+    const createdAt = Date.now();
+    return {
+        contractVersion: exports.DELEGATE_CONTRACT_VERSION,
+        delegateId,
+        ownerDid: opts.ownerDid,
+        correlationId: opts.correlationId,
+        createdAt,
+        engineId: opts.engineId,
+        model: opts.model,
+        capability: _capability(delegateId, opts.ownerDid, createdAt),
+    };
+}
+/**
+ * 校验句柄真实性。
+ * @param ownerDid 传当前活跃父 DID → 额外强制匹配 (防跨 channel/跨 agent 使用)
+ */
+function verifyDelegateHandle(handle, ownerDid) {
+    if (!handle || typeof handle !== 'object')
+        return false;
+    const h = handle;
+    // strict 类型检查 (Hermes `_record` 同款): 类型不对直接拒, 不猜
+    if (h.contractVersion !== exports.DELEGATE_CONTRACT_VERSION)
+        return false;
+    if (typeof h.delegateId !== 'string' || h.delegateId === '')
+        return false;
+    if (typeof h.ownerDid !== 'string' || h.ownerDid === '')
+        return false;
+    if (typeof h.createdAt !== 'number' || !Number.isFinite(h.createdAt))
+        return false;
+    if (typeof h.engineId !== 'string' || h.engineId === '')
+        return false;
+    if (typeof h.capability !== 'string' || h.capability === '')
+        return false;
+    if (ownerDid !== undefined && h.ownerDid !== ownerDid)
+        return false;
+    // 定时安全比对 (与 hmac.compare_digest 等价)
+    const expected = _capability(h.delegateId, h.ownerDid, h.createdAt);
+    const a = Buffer.from(h.capability, 'hex');
+    const b = Buffer.from(expected, 'hex');
+    return a.length === b.length && (0, crypto_1.timingSafeEqual)(a, b);
+}
+//# sourceMappingURL=delegate-handle.js.map

package/dist/electron-build/external-engines/delegate-handle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegate-handle.js","sourceRoot":"","sources":["../../../src/external-engines/delegate-handle.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;;;AAEH,mCAA8E;AAE9E,0CAA0C;AAC7B,QAAA,yBAAyB,GAAG,CAAC,CAAC;AAgB3C;;;GAGG;AACH,MAAM,OAAO,GAAW,IAAA,oBAAW,EAAC,EAAE,CAAC,CAAC;AAExC,SAAS,WAAW,CAAC,UAAkB,EAAE,QAAgB,EAAE,SAAiB;IAC1E,OAAO,IAAA,mBAAU,EAAC,QAAQ,EAAE,OAAO,CAAC;SACjC,MAAM,CAAC,GAAG,UAAU,IAAI,QAAQ,IAAI,SAAS,EAAE,CAAC;SAChD,MAAM,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC;AASD,sDAAsD;AACtD,8BAAqC,IAAiC;IACpE,MAAM,UAAU,GAAG,IAAA,mBAAU,GAAE,CAAC;IAChC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,OAAO;QACL,eAAe,EAAE,QAAA,yBAAyB;QAC1C,UAAU;QACV,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,SAAS;QACT,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,UAAU,EAAE,WAAW,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC;KAC9D,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,8BAAqC,MAAe,EAAE,QAAiB;IACrE,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACxD,MAAM,CAAC,GAAG,MAAiC,CAAC;IAC5C,iDAAiD;IACjD,IAAI,CAAC,CAAC,eAAe,KAAK,QAAA,yBAAyB;QAAE,OAAO,KAAK,CAAC;IAClE,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,IAAI,CAAC,CAAC,UAAU,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IAC1E,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IACtE,IAAI,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;QAAE,OAAO,KAAK,CAAC;IACnF,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IACtE,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,IAAI,CAAC,CAAC,UAAU,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IAC1E,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAEpE,oCAAoC;IACpC,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;IACpE,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAC3C,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACvC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,IAAI,IAAA,wBAAe,EAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACxD,CAAC"}