@bolloon/bolloon-agent 0.3.44 → 0.3.46

package/dist/llm/tool-manifest/index.js

@@ -48,6 +48,65 @@ export function getToolsByLayer(layerId) {
  *
  * 不包含: 完整 parameters schema (那是 PiAI 客户端在调用时读)
  */
+/**
+ * 把 ToolManifest 转成 OpenAI function calling 格式 (tools 数组)
+ * 用于 native tool_choice: "auto" 模式, 让 LLM 选择调用.
+ *
+ * 注意: 递归处理嵌套参数 (type='object' 的 properties / type='array' 的 items)
+ */
+export function formatForOpenAI(tools) {
+    const list = tools ?? ALL;
+    return list.map((t) => {
+        const properties = {};
+        const required = [];
+        for (const p of t.parameters) {
+            properties[p.name] = convertParameter(p);
+            if (p.required)
+                required.push(p.name);
+        }
+        return {
+            type: 'function',
+            function: {
+                name: t.id,
+                description: t.oneLine,
+                parameters: {
+                    type: 'object',
+                    properties,
+                    required,
+                },
+            },
+        };
+    });
+}
+function convertParameter(p) {
+    const schema = { type: p.type === 'enum' ? 'string' : p.type };
+    if (p.description)
+        schema.description = p.description;
+    if (p.enumValues)
+        schema.enum = p.enumValues;
+    if (p.default !== undefined)
+        schema.default = p.default;
+    if (p.minimum !== undefined)
+        schema.minimum = p.minimum;
+    if (p.maximum !== undefined)
+        schema.maximum = p.maximum;
+    if (p.format)
+        schema.format = p.format;
+    if (p.type === 'object' && p.properties) {
+        schema.properties = {};
+        for (const sub of p.properties) {
+            schema.properties[sub.name] = convertParameter(sub);
+        }
+    }
+    if (p.type === 'array' && p.items) {
+        schema.items = convertParameter(p.items);
+        if (p.minItems !== undefined)
+            schema.minItems = p.minItems;
+        if (p.maxItems !== undefined)
+            schema.maxItems = p.maxItems;
+    }
+    return schema;
+}
 export function formatForPrompt(tools) {
     const list = tools ?? ALL;
     const lines = [

package/dist/llm/tool-manifest/mcp.js

@@ -15,7 +15,7 @@ export const search_mcp_registry = {
     parameters: [
         { name: 'keywords', type: 'array', required: true, description: '搜索关键词', minItems: 1, items: { name: 'kw', type: 'string', required: true, description: '关键词' } }
     ],
-    callExample: `[TOOL:search_mcp_registry]
+    callExample: `[TOOL:search_mcp_registry]
 [P:keywords]${'${'}JSON.stringify(["calendar","schedule"])[ENDTOOL]`,
     layerId: 'tool.mcp_apps',
 };
@@ -37,7 +37,7 @@ export const suggest_connectors = {
     parameters: [
         { name: 'uuids', type: 'array', required: true, description: '从 search_mcp_registry 结果的 directoryUuid 复制', minItems: 1, items: { name: 'u', type: 'string', required: true, description: 'uuid' } }
     ],
-    callExample: `[TOOL:suggest_connectors]
+    callExample: `[TOOL:suggest_connectors]
 [P:uuids]${'${'}JSON.stringify(["uuid-from-search-result"])[ENDTOOL]`,
     layerId: 'tool.mcp_apps',
 };

package/dist/llm/tool-manifest/message_compose.js

@@ -23,9 +23,9 @@ export const message_compose_v1 = {
                 ],
             } },
     ],
-    callExample: `[TOOL:message_compose_v1]
-[P:kind]email
-[P:summary_title]Follow-up on Q3 review
+    callExample: `[TOOL:message_compose_v1]
+[P:kind]email
+[P:summary_title]Follow-up on Q3 review
 [P:variants]${'${'}JSON.stringify([{"label":"direct","subject":"Quick follow-up","body":"..."}])[ENDTOOL]`,
     layerId: 'tool.manifest',
 };

package/dist/llm/tool-manifest/places.js

@@ -23,7 +23,7 @@ export const places_search = {
         { name: 'location_bias_lng', type: 'number', required: false, description: '可选经度' },
         { name: 'location_bias_radius', type: 'number', required: false, description: '米 (默认 5000)', default: 5000 }
     ],
-    callExample: `[TOOL:places_search]
+    callExample: `[TOOL:places_search]
 [P:queries]${'${'}JSON.stringify([{"query":"ramen restaurants Tokyo"}])[ENDTOOL]`,
     layerId: 'tool.manifest',
 };
@@ -77,7 +77,7 @@ export const places_map_display_v0 = {
         { name: 'title', type: 'string', required: false, description: '行程标题' },
         { name: 'narrative', type: 'string', required: false, description: '行程叙述' },
     ],
-    callExample: `[TOOL:places_map_display_v0]
+    callExample: `[TOOL:places_map_display_v0]
 [P:locations]${'${'}JSON.stringify([{"name":"Senso-ji","latitude":35.7148,"longitude":139.7967,"place_id":"ChIJ..."}])[ENDTOOL]`,
     layerId: 'tool.manifest',
 };

package/dist/llm/tool-manifest/present_files.js

@@ -15,7 +15,7 @@ export const present_files = {
     parameters: [
         { name: 'filepaths', type: 'array', required: true, description: '至少 1 个文件路径', minItems: 1, items: { name: 'path', type: 'string', required: true, description: '容器内路径' } },
     ],
-    callExample: `[TOOL:present_files]
+    callExample: `[TOOL:present_files]
 [P:filepaths]${'${'}JSON.stringify(["/home/bolloon/report.md"])[ENDTOOL]`,
     layerId: 'tool.manifest',
 };

package/dist/llm/tool-manifest/recipe.js

@@ -33,8 +33,8 @@ export const recipe_display_v0 = {
             } },
         { name: 'notes', type: 'string', required: false, description: '附加说明' },
     ],
-    callExample: `[TOOL:recipe_display_v0]
-[P:title]Pasta
+    callExample: `[TOOL:recipe_display_v0]
+[P:title]Pasta
 [P:ingredients]${'${'}JSON.stringify([{"id":"a1","amount":500,"name":"pasta"}])[ENDTOOL]`,
     layerId: 'tool.manifest',
 };

package/dist/llm/tool-manifest/str_replace.js

@@ -17,11 +17,11 @@ export const str_replace = {
         { name: 'new_str', type: 'string', required: true, description: '新字符串 (空字符串 = 删除)', default: '' },
         { name: 'path', type: 'string', required: true, description: '文件路径' },
     ],
-    callExample: `[TOOL:str_replace]
-[P:description]修复 typo
-[P:old_str]recieve
-[P:new_str]receive
-[P:path]/home/bolloon/main.py
+    callExample: `[TOOL:str_replace]
+[P:description]修复 typo
+[P:old_str]recieve
+[P:new_str]receive
+[P:path]/home/bolloon/main.py
 [ENDTOOL]`,
     layerId: 'tool.manifest',
 };

package/dist/llm/tool-manifest/view.js

@@ -16,9 +16,9 @@ export const view = {
         { name: 'path', type: 'string', required: true, description: '绝对路径' },
         { name: 'view_range', type: 'array', required: false, description: '[start, end] 1-indexed, end=-1 表示到末尾', minItems: 2, maxItems: 2, items: { name: 'r', type: 'integer', required: true, description: '行号' } }
     ],
-    callExample: `[TOOL:view]
-[P:description]读 README
-[P:path]/home/bolloon/README.md
+    callExample: `[TOOL:view]
+[P:description]读 README
+[P:path]/home/bolloon/README.md
 [ENDTOOL]`,
     layerId: 'tool.manifest',
 };

package/dist/llm/tool-manifest/weather.js

@@ -18,10 +18,10 @@ export const weather_fetch = {
         { name: 'latitude', type: 'number', required: true, description: '纬度' },
         { name: 'longitude', type: 'number', required: true, description: '经度' },
     ],
-    callExample: `[TOOL:weather_fetch]
-[P:location_name]San Francisco, CA
-[P:latitude]37.78
-[P:longitude]-122.41
+    callExample: `[TOOL:weather_fetch]
+[P:location_name]San Francisco, CA
+[P:latitude]37.78
+[P:longitude]-122.41
 [ENDTOOL]`,
     layerId: 'tool.manifest',
 };

package/dist/llm/tool-manifest/web.js

@@ -15,8 +15,8 @@ export const web_search = {
     parameters: [
         { name: 'query', type: 'string', required: true, description: '搜索查询 (1-6 词最佳)' },
     ],
-    callExample: `[TOOL:web_search]
-[P:query]S&P 500 current price
+    callExample: `[TOOL:web_search]
+[P:query]S&P 500 current price
 [ENDTOOL]`,
     layerId: 'tool.web_search',
 };
@@ -44,8 +44,8 @@ export const web_fetch = {
         { name: 'web_fetch_rate_limit_key', type: 'string', required: false, description: '速率限制键' },
         { name: 'web_fetch_rate_limit_dark_launch', type: 'boolean', required: false, description: '速率限制暗启动模式' },
     ],
-    callExample: `[TOOL:web_fetch]
-[P:url]https://example.com/article
+    callExample: `[TOOL:web_fetch]
+[P:url]https://example.com/article
 [ENDTOOL]`,
     layerId: 'tool.manifest',
 };

package/dist/orbitdb/cid-database.js

@@ -151,6 +151,47 @@ export class OrbitDBAdapter {
         await this.node.helia.blockstore.put(CID.parse(rec.id), dagCbor.encode(rec));
         return `bolloon-cid://${rec.id}`;
     }
+    /**
+     * 2026-08-08: 在同一 OrbitDB 实例上打开附加 store。
+     * events 类型 = append-only 事件流 (WAL 复制 / 轨迹流用).
+     * 返回的 store 是通用适配 (put=keyvalue / add=events).
+     */
+    async openStore(name, type = 'keyvalue') {
+        await this.ensure();
+        const raw = (await this._orbitdb.open(name, { type }));
+        const store = {
+            address: raw.address,
+            put: async (key, value) => { await raw.put(key, JSON.parse(JSON.stringify(value))); },
+            add: async (value) => { await raw.add(JSON.parse(JSON.stringify(value))); },
+            all: async () => {
+                const entries = (await raw.all());
+                // events store 的 all() 返回 { hash, payload } — 统一成 { key, value }
+                return entries.map(e => ({
+                    key: String(e.key ?? e.hash ?? ''),
+                    value: e.payload !== undefined ? e.payload : e.value,
+                }));
+            },
+            get: async (key) => { return (await raw.get(key)); },
+            onChange: (fn) => {
+                const on = () => { try {
+                    fn();
+                }
+                catch { /* 回调异常忽略 */ } };
+                raw.events?.on?.('join', on);
+                raw.events?.on?.('write', on);
+                raw.events?.on?.('replicate', on);
+                return () => {
+                    try {
+                        raw.events?.off?.('join', on);
+                        raw.events?.off?.('write', on);
+                        raw.events?.off?.('replicate', on);
+                    }
+                    catch { /* 忽略 */ }
+                };
+            },
+        };
+        return store;
+    }
     async close() {
         try {
             await this._orbitdb?.stop();

package/dist/orbitdb/did-catalog-replication.js

@@ -0,0 +1,199 @@
+/**
+ * did-catalog-replication.ts — 把 DID 目录的 WAL 事件流挂进 OrbitDB 自动复制 (2026-08-08)
+ *
+ * 用户需求: "把 DID catalog 挂进 OrbitDB 的自动 replication, 并用 OrbitDB 事件流驱动跨设备复制".
+ *
+ * 机制:
+ *   1. 打开 events store (append-only 事件流): `bolloon-did-wal-<did短名>`
+ *      — 与 bolloon-cid-store 共享同一 helia + OrbitDB 实例 (openStore).
+ *   2. 发布 (publish): 本地 catalog 每有新 WAL 事件 (seq > lastPublishedSeq) → store.add(ev)
+ *      — OrbitDB 自动把事件流同步到订阅同地址的 peers (libp2p pubsub + IPFS 块).
+ *   3. 拉取 (sync): 订阅 store 变更 (join/write/replicate) + 定时轮询 →
+ *      读 store 全量事件 → 过滤 seq > lastAppliedSeq → catalog.syncRemote(events)
+ *      → persist → 推进 lastAppliedSeq. (LWW 合并, 幂等)
+ *   4. 状态: lastPublishedSeq / lastAppliedSeq / storeAddress 持久化在
+ *      ~/.bolloon/did-catalog/<did>/replication.json, 重启续传.
+ *
+ * 失败静默: 复制是增强层 — OrbitDB 不可用 (离线/首次启动) 时 DID 目录本身照常工作,
+ *           网络恢复后按 seq 增量补齐 (断点续传语义).
+ */
+import * as fs from 'fs/promises';
+import * as os from 'os';
+import * as path from 'path';
+import { registryOpen, didDirName } from '../storage/did-catalog.js';
+import { getCIDDatabase } from './cid-database.js';
+const homeRoot = (h) => h || process.env.HOME || os.homedir() || '/tmp';
+/** events store 名: 按 DID 确定性命名 (跨设备同名 → 同一复制流) */
+export function replicationStoreName(did) {
+    return `bolloon-did-wal-${didDirName(did)}`;
+}
+function statePath(home, did) {
+    return path.join(homeRoot(home), '.bolloon', 'did-catalog', didDirName(did), 'replication.json');
+}
+async function loadState(home, did) {
+    try {
+        const raw = JSON.parse(await fs.readFile(statePath(home, did), 'utf-8'));
+        return {
+            // WAL seq 从 0 开始 → 游标默认 -1 (否则 seq=0 的首条事件永远不发布/不应用)
+            lastPublishedSeq: Number(raw.lastPublishedSeq) || -1,
+            lastAppliedSeq: Number(raw.lastAppliedSeq) || -1,
+            storeAddress: String(raw.storeAddress || ''),
+            updatedAt: Number(raw.updatedAt) || Date.now(),
+        };
+    }
+    catch {
+        return { lastPublishedSeq: -1, lastAppliedSeq: -1, storeAddress: '', updatedAt: Date.now() };
+    }
+}
+async function saveState(home, did, s) {
+    try {
+        const p = statePath(home, did);
+        await fs.mkdir(path.dirname(p), { recursive: true });
+        await fs.writeFile(p, JSON.stringify({ ...s, updatedAt: Date.now() }, null, 2), 'utf-8');
+    }
+    catch { /* 状态写失败不致命 */ }
+}
+/** WAL 事件是否属于本 DID (跨设备只合并本用户数据) */
+function eventOfDid(e, did) {
+    return !e.did || e.did === did;
+}
+/**
+ * 启动 DID 目录 → OrbitDB 自动复制.
+ * 单例: 同一 did 只开一个复制流 (进程级 map, 复用 store).
+ */
+export async function startDidCatalogReplication(did, opts = {}) {
+    const state = await loadState(opts.home, did);
+    const stats = { published: 0, applied: 0, merged: 0 };
+    let store = null;
+    let stopFns = [];
+    let timer = null;
+    let syncing = false;
+    let stopped = false;
+    const open = async () => {
+        if (store)
+            return store;
+        const db = opts.db || getCIDDatabase();
+        const s = await db.openStore(replicationStoreName(did), 'events');
+        store = s;
+        if (state.storeAddress && state.storeAddress !== s.address) {
+            // 远端地址已有记录而本地地址不同 → 以本地为准 (state 会在 publish 后刷新)
+        }
+        state.storeAddress = s.address;
+        await saveState(opts.home, did, state);
+        return s;
+    };
+    const catalog = async () => {
+        try {
+            return await registryOpen(did, opts.home ? { home: opts.home } : undefined);
+        }
+        catch {
+            return null;
+        }
+    };
+    const publishPending = async () => {
+        try {
+            const cat = await catalog();
+            if (!cat)
+                return 0;
+            const s = await open();
+            const pending = cat.walEvents.filter(e => e.seq > state.lastPublishedSeq && eventOfDid(e, did));
+            if (pending.length === 0)
+                return 0;
+            for (const ev of pending) {
+                await s.add(ev);
+                state.lastPublishedSeq = Math.max(state.lastPublishedSeq, ev.seq);
+            }
+            stats.published += pending.length;
+            await saveState(opts.home, did, state);
+            return pending.length;
+        }
+        catch {
+            return 0; // OrbitDB 不可用 → 静默, 下次轮询重试 (断点续传)
+        }
+    };
+    const syncNow = async () => {
+        if (syncing || stopped)
+            return { applied: 0, merged: 0 };
+        syncing = true;
+        try {
+            const cat = await catalog();
+            if (!cat)
+                return { applied: 0, merged: 0 };
+            const s = await open();
+            const entries = await s.all();
+            const events = entries
+                .map(e => e.value)
+                .filter((e) => !!e && typeof e === 'object' && typeof e.seq === 'number')
+                .filter(e => e.seq > state.lastAppliedSeq && eventOfDid(e, did))
+                .sort((a, b) => a.seq - b.seq);
+            if (events.length === 0)
+                return { applied: 0, merged: 0 };
+            const r = cat.syncRemote(events);
+            await cat.persist();
+            state.lastAppliedSeq = Math.max(state.lastAppliedSeq, ...events.map(e => e.seq));
+            stats.applied += r.applied;
+            stats.merged += r.merged;
+            await saveState(opts.home, did, state);
+            return r;
+        }
+        catch {
+            return { applied: 0, merged: 0 };
+        }
+        finally {
+            syncing = false;
+        }
+    };
+    // 订阅 store 变更 (远端 join/写) → 拉取合并 (去抖, 事件可能密集)
+    const unsub = await (async () => {
+        try {
+            const s = await open();
+            let debounce = null;
+            const on = () => {
+                if (debounce)
+                    clearTimeout(debounce);
+                debounce = setTimeout(() => { syncNow().catch(() => { }); }, 500);
+            };
+            const off = s.onChange(on);
+            return () => { off(); if (debounce)
+                clearTimeout(debounce); };
+        }
+        catch {
+            return () => { };
+        }
+    })();
+    stopFns.push(unsub);
+    // 首次: 拉一次远端 (重启续传) + 发布本地积压
+    await syncNow().catch(() => { });
+    await publishPending().catch(() => { });
+    if (opts.auto !== false) {
+        timer = setInterval(() => {
+            publishPending().catch(() => { });
+            syncNow().catch(() => { });
+        }, opts.intervalMs || 30_000);
+        // 不阻止进程退出
+        timer.unref?.();
+    }
+    const stop = async () => {
+        stopped = true;
+        if (timer)
+            clearInterval(timer);
+        for (const f of stopFns) {
+            try {
+                f();
+            }
+            catch { /* 忽略 */ }
+        }
+        stopFns = [];
+        // 停前最后发布一次 (尽力而为)
+        await publishPending().catch(() => { });
+    };
+    return {
+        did,
+        storeName: replicationStoreName(did),
+        storeAddress: state.storeAddress,
+        stats,
+        publishPending,
+        syncNow,
+        stop,
+    };
+}

package/dist/orbitdb/trajectory-store.js

@@ -0,0 +1,150 @@
+/**
+ * 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 主流程.
+ */
+import * as fs from 'fs/promises';
+import * as os from 'os';
+import * as path from 'path';
+import { getCIDDatabase } from './cid-database.js';
+import { didDirName } from '../storage/did-catalog.js';
+const homeRoot = (h) => h || process.env.HOME || os.homedir() || '/tmp';
+export 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 */
+export 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-${didDirName(did)}`;
+}
+/** 2. OrbitDB: keyvalue store `bolloon-trajectories-<did>`, key=runId */
+export 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 : 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 (各自失败静默, 返回落盘路径) */
+export 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, 新→旧) */
+export 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 [];
+    }
+}
+/** 读一轮轨迹 */
+export 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) */
+export 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; }
+}