@bolloon/bolloon-agent 0.4.28 → 0.4.30

package/dist/electron-build/orbitdb/kanban-store.js

@@ -0,0 +1,299 @@
+"use strict";
+/**
+ * kanban-store.ts — Hermes kanban 的 OrbitDB 落地 (2026-08-12, Task5)
+ *
+ * 借鉴 hermes_cli/kanban_db.py 的 9 态任务看板 + 原子认领 (CAS), 存到 OrbitDB
+ * keyvalue store (去中心化, DID 复制可跨设备同步). 每个 board 一个 store:
+ *   bolloon-kanban-<boardId>
+ *
+ * 任务 9 态 (VALID_STATUSES):
+ *   triage → todo → (父全部 done) → ready → running → done / archived
+ *   - scheduled:  定时任务 (本次简化为状态 + dueAt, 到时可 promote)
+ *   - blocked:    主动 block (sticky, 需显式 unblock) 或父依赖未完成 (自动解)
+ *   - review:     request_review 挂起等人工审批, approve → done
+ *   - archived:   终态归档
+ *
+ * 原子认领 (CAS, 至多一个 worker 认领成功): claim_task 只在
+ *   status === 'ready' && claimLock 为空 时置 running + claimLock + claimExpires,
+ *   否则返回输家 (不重试, 无分布式锁).
+ *
+ * 安全:
+ *   - 依赖的 KV store (put/get/all) 可注入 → 单测用内存 map, 生产用 OrbitDB store.
+ *   - 任务字段全部有默认值 (dag-cbor 不支持 undefined).
+ */
+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.KanbanBoard = exports.KANBAN_STATUSES = void 0;
+exports.taskKey = taskKey;
+exports.openKanbanBoard = openKanbanBoard;
+exports.KANBAN_STATUSES = ['triage', 'todo', 'scheduled', 'ready', 'running', 'blocked', 'review', 'done', 'archived'];
+const now = () => Date.now();
+function fresh(id, boardId, title, base = {}) {
+    return {
+        id, boardId, title,
+        body: base.body ?? '',
+        status: base.status ?? 'triage',
+        parentIds: base.parentIds ?? [],
+        createdBy: base.createdBy ?? '',
+        assignee: base.assignee ?? '',
+        dueAt: base.dueAt ?? null,
+        claimLock: base.claimLock ?? '',
+        claimExpires: base.claimExpires ?? 0,
+        consecutiveFailures: base.consecutiveFailures ?? 0,
+        createdRefs: base.createdRefs ?? [],
+        reason: base.reason ?? '',
+        review: base.review ?? '',
+        createdAt: base.createdAt ?? now(),
+        updatedAt: base.updatedAt ?? now(),
+        completedAt: base.completedAt ?? null,
+        archivedAt: base.archivedAt ?? null,
+    };
+}
+function taskKey(id) {
+    return `task:${id}`;
+}
+/**
+ * KanbanBoard — 绑定一个 KV store 的看板.
+ * 所有写都经 readTask→改→put 的 CAS 语义; claim 在内核判赢家.
+ */
+class KanbanBoard {
+    kv;
+    constructor(kv) {
+        this.kv = kv;
+    }
+    st(s) {
+        return JSON.parse(JSON.stringify(s));
+    }
+    async createTask(input) {
+        const id = `t_${Date.now()}_${Math.random().toString(36).substring(2, 8)}`;
+        const task = fresh(id, input.boardId, input.title, {
+            body: input.body ?? '',
+            parentIds: input.parentIds ?? [],
+            createdBy: input.createdBy ?? '',
+            dueAt: input.dueAt ?? null,
+            status: 'triage',
+        });
+        await this.kv.put(taskKey(id), JSON.parse(JSON.stringify(task)));
+        return this.st(task);
+    }
+    async getTask(id) {
+        const v = await this.kv.get(taskKey(id));
+        return v || null;
+    }
+    async listTasks(status) {
+        const all = await this.kv.all();
+        const tasks = [];
+        for (const e of all) {
+            const t = e.value;
+            if (t && typeof t === 'object' && t.title !== undefined) {
+                if (!status || t.status === status)
+                    tasks.push(this.st(t));
+            }
+        }
+        return tasks.sort((a, b) => a.createdAt - b.createdAt);
+    }
+    /** 保存变更 (校验合法) */
+    async persist(task) {
+        task.updatedAt = now();
+        await this.kv.put(taskKey(task.id), JSON.parse(JSON.stringify(task)));
+        return this.st(task);
+    }
+    /**
+     * 状态推进 gate: 只允许合法迁移 (防乱跳). 返回 null 表示禁止.
+     */
+    trans(from, to) {
+        if (from === to)
+            return true;
+        if (from === 'done' || from === 'archived')
+            return false; // 终态不可再动
+        const allowed = {
+            triage: ['todo', 'scheduled', 'blocked', 'archived'],
+            todo: ['scheduled', 'ready', 'blocked', 'archived'],
+            scheduled: ['todo', 'ready', 'blocked', 'archived'],
+            ready: ['running', 'blocked', 'archived'],
+            running: ['review', 'done', 'blocked', 'ready'],
+            blocked: ['todo', 'ready', 'archived'],
+            review: ['done', 'blocked', 'todo'],
+        };
+        const ok = (allowed[from] || []).includes(to);
+        return ok;
+    }
+    /** checking parents status from KV */
+    async allParentsDone(task) {
+        if (!task.parentIds || task.parentIds.length === 0)
+            return true;
+        for (const pid of task.parentIds) {
+            const p = await this.getTask(pid);
+            if (p && p.status !== 'done' && p.status !== 'archived')
+                return false;
+        }
+        return true;
+    }
+    /** 把 todo/scheduled/blocked(父依赖未完成) 任务晋升为 ready (父依赖满足时) — recompute Ready */
+    async promoteReady(taskId) {
+        const t = await this.getTask(taskId);
+        if (!t)
+            return null;
+        // 自动可清 blocked = 因父依赖未完成; sticky blocked (用户主动) 不自动解
+        const autoClearable = t.status === 'blocked' && t.reason === 'parents_not_done';
+        if (!autoClearable && t.status !== 'todo' && t.status !== 'scheduled')
+            return null;
+        if (!(await this.allParentsDone(t))) {
+            if (t.status === 'blocked')
+                return this.st(t);
+            return { ...this.st(t), status: 'blocked', reason: 'parents_not_done' };
+        }
+        return this.persist({ ...t, status: 'ready', reason: '' });
+    }
+    /** 认领 (CAS): 只有 ready 且未被认领的才能成功 → running + claimLock */
+    async claimTask(taskId, worker, ttlMs = 15 * 60 * 1000) {
+        const t = await this.getTask(taskId);
+        if (!t)
+            return { ok: false, reason: `任务不存在: ${taskId}` };
+        if (t.claimLock)
+            return { ok: false, reason: '已被其他 worker 认领' };
+        if (t.status !== 'ready') {
+            // 父依赖不变式: 认领点再强校验一次 (任何写路径把任务置 ready 都可能被这里纠正)
+            if (!(await this.allParentsDone(t))) {
+                await this.persist({ ...t, status: 'blocked', reason: 'parents_not_done' });
+                return { ok: false, reason: '父任务未完成 (降级 blocked)' };
+            }
+            return { ok: false, reason: `状态为 ${t.status}, 只有 ready 可认领` };
+        }
+        const run = fresh(t.id, t.boardId, t.title, { ...t, status: 'running', claimLock: worker, claimExpires: now() + ttlMs, consecutiveFailures: 0 });
+        await this.kv.put(taskKey(taskId), JSON.parse(JSON.stringify(run)));
+        return { ok: true, task: this.st(run) };
+    }
+    /** 认领 TTL 过期释放 — 防崩溃锁泄漏 (重启后旧 claimLock 残留) */
+    async releaseStaleClaims(nowTs = now()) {
+        const tasks = await this.listTasks('running');
+        let freed = 0;
+        for (const t of tasks) {
+            if (t.claimLock && t.claimExpires < nowTs) {
+                await this.persist({ ...t, status: 'ready', claimLock: '', claimExpires: 0 });
+                freed++;
+            }
+        }
+        return freed;
+    }
+    /** 记一次失败 (熔断): 连续失败 > limit → blocked */
+    async registerFailure(taskId, failureLimit = 3) {
+        const t = await this.getTask(taskId);
+        if (!t)
+            return null;
+        let next = t.claimLock ? { ...t, status: 'ready', claimLock: '', claimExpires: 0 } : { ...t };
+        next.consecutiveFailures = (next.consecutiveFailures || 0) + 1;
+        if (next.consecutiveFailures >= failureLimit) {
+            next.status = 'blocked';
+            next.reason = `circuit_break (连续失败 ${next.consecutiveFailures})`;
+        }
+        return this.persist(next);
+    }
+    /** 完成: 校验声称创建的引用 (防幻觉 — 幽灵引用 advisory), 父任务完成则解子依赖 */
+    async completeTask(taskId, worker, createdRefs = []) {
+        const t = await this.getTask(taskId);
+        if (!t)
+            return null;
+        if (t.claimLock && t.claimLock !== worker)
+            return null;
+        // 防幻觉 (advisory): 声称创建的引用逐一验证存在 → 不存在记为 advisory (不阻塞, 但可审计)
+        const missing = [];
+        for (const ref of createdRefs) {
+            const existing = await this.getTask(ref.replace(/^task:/, ''));
+            if (!existing)
+                missing.push(ref);
+        }
+        const task = fresh(t.id, t.boardId, t.title, {
+            ...t, status: 'done', claimLock: '', claimExpires: 0,
+            createdRefs, reason: missing.length ? `advisory_missing_refs: ${missing.join(',')}` : t.reason,
+            completedAt: now(),
+        });
+        await this.kv.put(taskKey(taskId), JSON.parse(JSON.stringify(task)));
+        // 子任务受父完成影响 → 尝试晋升 ready
+        const all = await this.listTasks();
+        for (const c of all) {
+            if (c.parentIds.includes(taskId) && (c.status === 'todo' || c.status === 'blocked')) {
+                await this.promoteReady(c.id);
+            }
+        }
+        return this.st(task);
+    }
+    async requestReview(taskId, note) {
+        const t = await this.getTask(taskId);
+        if (!t || t.status !== 'running')
+            return null;
+        return this.persist({ ...t, status: 'review', claimLock: '', claimExpires: 0, review: note });
+    }
+    async approveReview(taskId) {
+        const t = await this.getTask(taskId);
+        if (!t || t.status !== 'review')
+            return null;
+        return this.persist({ ...t, status: 'done', reason: 'review_approved', completedAt: now() });
+    }
+    async rejectReview(taskId, reason) {
+        const t = await this.getTask(taskId);
+        if (!t || t.status !== 'review')
+            return null;
+        return this.persist({ ...t, status: 'blocked', review: '', reason: `review_rejected: ${reason}` });
+    }
+    async setStatus(taskId, to, reason = '') {
+        const t = await this.getTask(taskId);
+        if (!t || !this.trans(t.status, to))
+            return null;
+        if (to === 'blocked' && !reason && !t.reason)
+            return null; // blocked 需带 reason
+        const next = { ...t, status: to, reason: to === 'blocked' ? (reason || t.reason) : reason || t.reason };
+        if (to === 'archived')
+            next.archivedAt = now();
+        if (to === 'ready') {
+            if (!(await this.allParentsDone(next)))
+                return this.persist({ ...next, status: 'blocked', reason: 'parents_not_done' });
+        }
+        return this.persist(next);
+    }
+}
+exports.KanbanBoard = KanbanBoard;
+/** 打开/缓存指定 board 的 OrbitDB KV store, 返回绑定的 KanbanBoard. 失败抛错. */
+const _boardCache = new Map();
+async function openKanbanBoard(boardId) {
+    if (_boardCache.has(boardId))
+        return _boardCache.get(boardId);
+    const { getCIDDatabase } = await Promise.resolve().then(() => __importStar(require('./cid-database.js')));
+    const store = await (await getCIDDatabase()).openStore(`bolloon-kanban-${boardId}`, 'keyvalue');
+    const board = new KanbanBoard(store);
+    _boardCache.set(boardId, board);
+    return board;
+}
+//# sourceMappingURL=kanban-store.js.map

package/dist/electron-build/orbitdb/kanban-store.js.map

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

package/dist/electron-build/orbitdb/task-store.js

@@ -0,0 +1,155 @@
+"use strict";
+/**
+ * task-store.ts — Task 队列的 OrbitDB 主存储 (2026-08-12, Task6)
+ *
+ * 把 hermes kanban 用 OrbitDB 实现: 任务队列以 OrbitDB keyvalue store 为主存储,
+ * 支持跨设备/去中心化同步 (与 did-catalog-replication 同模式, 共享同一 helia 节点).
+ *
+ * 设计:
+ *   - store 名: `bolloon-tasks-<did短名>` (确定性, 跨设备同名 → 同一复制流)
+ *   - 存整个任务数组到单键 `tasks` (兼容 server-storage 现有 loadTaskQueue/saveTaskQueue)
+ *   - 懒初始化 + 幂等: 首次 warm 时打开 store; 失败静默 → 回退本地文件 (增强层, 不阻塞)
+ *   - 生产由 server 启动时 warmTaskOrbitStore() 预热; 测试环境 (临时 HOME) 不预热 → 走本地
+ *
+ * 失败静默: OrbitDB 不可用 (离线/首次/测试) 时任务照常走本地文件, 不阻塞主路径.
+ */
+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.OrbitDBTaskStore = exports.TASK_ORBIT_STORE_KEY = void 0;
+exports.taskStoreName = taskStoreName;
+exports.getTaskOrbitStore = getTaskOrbitStore;
+exports.warmTaskOrbitStore = warmTaskOrbitStore;
+exports.resetTaskOrbitStore = resetTaskOrbitStore;
+exports.taskStorePath = taskStorePath;
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const cid_database_js_1 = require("./cid-database.js");
+const homeRoot = () => process.env.HOME || os.homedir() || '/tmp';
+exports.TASK_ORBIT_STORE_KEY = 'tasks';
+/** store 名: 按 did 短名确定性命名 */
+function taskStoreName(did) {
+    const short = String(did || 'local').replace(/[^a-zA-Z0-9-]/g, '_').slice(0, 40) || 'local';
+    return `bolloon-tasks-${short}`;
+}
+/** 真实实现 (OrbitDB). 单例: 同一进程共享 CID 数据库单例. */
+class OrbitDBTaskStore {
+    did;
+    db;
+    _store = null;
+    ready = false;
+    storeName;
+    storeAddress = '';
+    constructor(did, db = (0, cid_database_js_1.getCIDDatabase)()) {
+        this.did = did;
+        this.db = db;
+        this.storeName = taskStoreName(did);
+    }
+    async warm() {
+        if (this.ready && this._store)
+            return true;
+        try {
+            this._store = await this.db.openStore(this.storeName, 'keyvalue');
+            this.storeAddress = this._store.address;
+            this.ready = true;
+            return true;
+        }
+        catch (err) {
+            // OrbitDB 不可用 (离线/首次/测试环境) → 静默回退本地
+            try {
+                console.warn(`[task-store] OrbitDB 任务存储不可用, 回退本地: ${err?.message?.slice(0, 120)}`);
+            }
+            catch { /* 忽略 */ }
+            this.ready = false;
+            return false;
+        }
+    }
+    async loadTasks() {
+        if (!this.ready || !this._store)
+            return null;
+        try {
+            const v = await this._store.get(exports.TASK_ORBIT_STORE_KEY);
+            if (v == null)
+                return null;
+            if (Array.isArray(v))
+                return v;
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+    async saveTasks(tasks) {
+        if (!this.ready || !this._store)
+            return false;
+        try {
+            await this._store.put(exports.TASK_ORBIT_STORE_KEY, tasks);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async close() {
+        this._store = null;
+        this.ready = false;
+    }
+}
+exports.OrbitDBTaskStore = OrbitDBTaskStore;
+let _instance = null;
+let _warmPromise = null;
+/** 获取任务 OrbitDB 存储单例 (首次调用时 warm). did 为 '' 时用 'local'. */
+function getTaskOrbitStore(did = '') {
+    if (!_instance)
+        _instance = new OrbitDBTaskStore(did || 'local');
+    return _instance;
+}
+/** 预热任务 OrbitDB 存储 (server 启动时调用, 幂等). 返回是否就绪. */
+function warmTaskOrbitStore(did = '') {
+    if (!_warmPromise) {
+        const store = getTaskOrbitStore(did);
+        _warmPromise = store.warm().then((ok) => ok).catch(() => false);
+    }
+    return _warmPromise;
+}
+/** 重置单例 (测试用) */
+function resetTaskOrbitStore() {
+    _instance = null;
+    _warmPromise = null;
+}
+/** 用 did 短名构造 task store 名 (供 server 组装 store name 展示) */
+function taskStorePath(did, home = homeRoot()) {
+    return path.join(home, '.bolloon', 'orbitdb', 'stores', taskStoreName(did));
+}
+//# sourceMappingURL=task-store.js.map

package/dist/electron-build/orbitdb/task-store.js.map

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

package/dist/electron-build/orbitdb/trajectory-store.js

@@ -0,0 +1,194 @@
+"use strict";
+/**
+ * trajectory-store.ts — 智能体运行轨迹 (trajectory) 记录 (2026-08-08)
+ *
+ * 用户需求: "把 bolloon agent 运行过程产生的轨迹保存进 orbitdb. 智能体运行的轨迹也可以落盘."
+ *
+ * 双层持久化:
+ *   1. 落盘: ~/.bolloon/trajectories/<runId>.json (审计/离线可读)
+ *   2. OrbitDB: keyvalue store `bolloon-trajectories-<did>`, key=runId
+ *      (与 bolloon-cid-store 共享 helia/OrbitDB 实例; 跨设备复制 + 内容寻址)
+ *
+ * 轨迹内容: 一轮运行 (用户输入 → 事件/工具调用步骤 → AI 回复) 的完整回放.
+ * 失败静默: recorder 是增强层, 任何持久化失败都不影响 agent 主流程.
+ */
+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.TrajectoryRecorder = void 0;
+exports.newRunId = newRunId;
+exports.saveTrajectoryToDisk = saveTrajectoryToDisk;
+exports.saveTrajectoryToOrbit = saveTrajectoryToOrbit;
+exports.recordTrajectory = recordTrajectory;
+exports.listTrajectories = listTrajectories;
+exports.loadTrajectory = loadTrajectory;
+const fs = __importStar(require("fs/promises"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const cid_database_js_1 = require("./cid-database.js");
+const did_catalog_js_1 = require("../storage/did-catalog.js");
+const homeRoot = (h) => h || process.env.HOME || os.homedir() || '/tmp';
+function newRunId(agentId) {
+    const ts = new Date().toISOString().replace(/[:.]/g, '-');
+    return `${ts}__${String(agentId).replace(/[^a-zA-Z0-9_-]/g, '_').slice(0, 40)}`;
+}
+function trajectoriesDir(home) {
+    return path.join(homeRoot(home), '.bolloon', 'trajectories');
+}
+/** 1. 落盘: ~/.bolloon/trajectories/<runId>.json */
+async function saveTrajectoryToDisk(run, home) {
+    const dir = trajectoriesDir(home);
+    await fs.mkdir(dir, { recursive: true });
+    const file = path.join(dir, `${run.runId}.json`);
+    await fs.writeFile(file, JSON.stringify(run, null, 2), 'utf-8');
+    return file;
+}
+function trajectoryStoreName(did) {
+    return `bolloon-trajectories-${(0, did_catalog_js_1.didDirName)(did)}`;
+}
+/** 2. OrbitDB: keyvalue store `bolloon-trajectories-<did>`, key=runId */
+async function saveTrajectoryToOrbit(run, opts = {}) {
+    try {
+        const did = run.did;
+        if (!did)
+            return false;
+        if (opts.orbit === false)
+            return false;
+        const db = opts.db !== undefined ? opts.db : (0, cid_database_js_1.getCIDDatabase)();
+        if (!db)
+            return false;
+        const store = await db.openStore(trajectoryStoreName(did), 'keyvalue');
+        await store.put(run.runId, run);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** 一步到位: 落盘 + OrbitDB (各自失败静默, 返回落盘路径) */
+async function recordTrajectory(run, opts = {}) {
+    let file = null;
+    try {
+        file = await saveTrajectoryToDisk(run, opts.home);
+    }
+    catch { /* 落盘失败静默 */ }
+    await saveTrajectoryToOrbit(run, opts).catch(() => false);
+    return file;
+}
+/** 列出一轮轨迹 (文件名 → runId, 新→旧) */
+async function listTrajectories(home, limit = 50) {
+    try {
+        const dir = trajectoriesDir(home);
+        const files = (await fs.readdir(dir)).filter(f => f.endsWith('.json')).sort().reverse().slice(0, limit);
+        return files.map(f => ({ runId: f.replace(/\.json$/, ''), file: path.join(dir, f) }));
+    }
+    catch {
+        return [];
+    }
+}
+/** 读一轮轨迹 */
+async function loadTrajectory(runId, home) {
+    try {
+        const raw = await fs.readFile(path.join(trajectoriesDir(home), `${runId}.json`), 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/** 内存版 recorder: 采集步骤/消息, endRun 时产出 TrajectoryRun (持久化交给 recordTrajectory) */
+class TrajectoryRecorder {
+    runId;
+    agentId;
+    channelId;
+    did;
+    input;
+    startedAt;
+    model;
+    steps = [];
+    messages = [];
+    ended = false;
+    constructor(opts) {
+        this.runId = opts.runId || newRunId(opts.agentId);
+        this.agentId = opts.agentId;
+        this.channelId = opts.channelId;
+        this.did = opts.did;
+        this.input = opts.input;
+        this.model = opts.model;
+        this.startedAt = Date.now();
+    }
+    /** 记录一个流事件 (tool/status/error/thinking/phase/done) */
+    recordStep(ev) {
+        if (this.ended)
+            return;
+        const type = String(ev.type || 'status');
+        const kind = (['tool', 'status', 'error', 'thinking', 'phase', 'done'].includes(type) ? type : 'status');
+        const name = kind === 'tool' ? String(ev.tool || 'tool') : kind;
+        const content = typeof ev.content === 'string' ? ev.content : '';
+        // 同类型连续状态压缩 (防步骤爆炸): 只保留 content 变化的
+        const last = this.steps[this.steps.length - 1];
+        if (last && last.name === name && last.kind === kind && last.content === content)
+            return;
+        this.steps.push({ name, kind, content: content.slice(0, 2000), ts: Date.now() });
+    }
+    /** 记录一条消息 (输入/中间/回复) */
+    recordMessage(role, content) {
+        if (this.ended)
+            return;
+        this.messages.push({ role, content: content.slice(0, 8000), ts: Date.now() });
+    }
+    /** 结束一轮 → 产出 TrajectoryRun (不可再 record) */
+    endRun(reply, status = 'ok') {
+        this.ended = true;
+        const endedAt = Date.now();
+        return {
+            runId: this.runId,
+            did: this.did,
+            agentId: this.agentId,
+            channelId: this.channelId,
+            input: this.input,
+            reply,
+            status,
+            model: this.model,
+            startedAt: this.startedAt,
+            endedAt,
+            durationMs: endedAt - this.startedAt,
+            steps: this.steps,
+            messages: this.messages,
+        };
+    }
+    get stepCount() { return this.steps.length; }
+}
+exports.TrajectoryRecorder = TrajectoryRecorder;
+//# sourceMappingURL=trajectory-store.js.map