@tachu/extensions 1.0.0-alpha.1

package/dist/mcp/stdio-adapter.js

@@ -0,0 +1,203 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport, } from "@modelcontextprotocol/sdk/client/stdio.js";
+/** D1-LOW-08：默认 30s 的工具调用超时窗口。 */
+const DEFAULT_CALL_TIMEOUT_MS = 30_000;
+const createRequestId = () => `mcp-stdio-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
+/**
+ * MCP stdio 传输适配器。
+ */
+export class McpStdioAdapter {
+    transport = "stdio";
+    options;
+    maxReconnectAttempts = 3;
+    defaultTimeoutMs;
+    client = null;
+    transportImpl = null;
+    reconnecting = false;
+    closedManually = false;
+    connected = false;
+    serverUri = "";
+    pendingRequests = new Map();
+    /**
+     * 创建 stdio MCP 适配器。
+     *
+     * @param options stdio 启动参数
+     */
+    constructor(options) {
+        this.options = options;
+        this.defaultTimeoutMs =
+            options.defaultTimeoutMs === undefined
+                ? DEFAULT_CALL_TIMEOUT_MS
+                : Math.max(0, options.defaultTimeoutMs);
+    }
+    /**
+     * 建立 MCP 连接。
+     *
+     * @param serverUri 服务端 URI（可留空）
+     */
+    async connect(serverUri) {
+        this.serverUri = serverUri;
+        this.closedManually = false;
+        await this.connectInternal();
+    }
+    /**
+     * 断开连接。
+     */
+    async disconnect() {
+        this.closedManually = true;
+        this.connected = false;
+        for (const controller of this.pendingRequests.values()) {
+            controller.abort(new Error("MCP stdio adapter disconnected"));
+        }
+        this.pendingRequests.clear();
+        await this.transportImpl?.close().catch(() => undefined);
+        this.transportImpl = null;
+        this.client = null;
+    }
+    /**
+     * 列出远端工具并映射为引擎 ToolDescriptor。
+     *
+     * @returns 工具描述符数组
+     */
+    async listTools() {
+        if (!this.client) {
+            throw new Error("MCP stdio adapter not connected");
+        }
+        const response = await this.client.listTools();
+        return response.tools.map((tool) => ({
+            kind: "tool",
+            name: tool.name,
+            description: tool.description ?? `mcp tool: ${tool.name}`,
+            sideEffect: tool.annotations?.readOnlyHint
+                ? "readonly"
+                : tool.annotations?.destructiveHint
+                    ? "irreversible"
+                    : "write",
+            idempotent: tool.annotations?.idempotentHint ?? false,
+            requiresApproval: tool.annotations?.destructiveHint ?? false,
+            timeout: 30_000,
+            inputSchema: tool.inputSchema,
+            outputSchema: tool.outputSchema,
+            execute: `mcp:${this.options.serverId ?? "stdio"}:${tool.name}`,
+        }));
+    }
+    /**
+     * 调用远端工具（core 协议方法）。
+     *
+     * @param name 工具名
+     * @param input 入参
+     * @returns 工具执行结果
+     */
+    async executeTool(name, input, options) {
+        return this.callTool(name, input, options?.signal, options?.requestId);
+    }
+    /**
+     * 调用远端工具（支持 AbortSignal）。
+     *
+     * @param name 工具名
+     * @param input 入参
+     * @param signal 取消信号
+     * @param requestId 请求 ID（可选；用于后续 cancel 显式取消）
+     * @returns 工具执行结果
+     */
+    async callTool(name, input, signal, requestId) {
+        if (!this.client) {
+            throw new Error("MCP stdio adapter not connected");
+        }
+        const mappedRequestId = requestId?.trim() ? requestId : createRequestId();
+        if (this.pendingRequests.has(mappedRequestId)) {
+            throw new Error(`MCP stdio request already in progress: ${mappedRequestId}`);
+        }
+        const controller = new AbortController();
+        const onAbort = () => {
+            controller.abort(signal?.reason ?? new Error(`MCP stdio request aborted: ${mappedRequestId}`));
+        };
+        if (signal?.aborted) {
+            onAbort();
+        }
+        else {
+            signal?.addEventListener("abort", onAbort, { once: true });
+        }
+        // D1-LOW-08：为 callTool 套上 adapter 层默认超时，避免远端挂起拖垮引擎。
+        let timeoutHandle = null;
+        let timedOut = false;
+        if (this.defaultTimeoutMs > 0) {
+            timeoutHandle = setTimeout(() => {
+                timedOut = true;
+                controller.abort(new Error(`MCP stdio request timed out after ${this.defaultTimeoutMs}ms: ${mappedRequestId}`));
+            }, this.defaultTimeoutMs);
+        }
+        this.pendingRequests.set(mappedRequestId, controller);
+        try {
+            const result = await this.client.callTool({ name, arguments: (input ?? {}) }, undefined, { signal: controller.signal });
+            return result;
+        }
+        catch (error) {
+            if (timedOut) {
+                throw new Error(`MCP stdio request timed out after ${this.defaultTimeoutMs}ms: ${mappedRequestId}`);
+            }
+            throw error;
+        }
+        finally {
+            if (timeoutHandle !== null) {
+                clearTimeout(timeoutHandle);
+            }
+            signal?.removeEventListener("abort", onAbort);
+            this.pendingRequests.delete(mappedRequestId);
+        }
+    }
+    /**
+     * 按 requestId 取消请求（通过信号机制由调用方透传）。
+     *
+     * @param _requestId 请求 ID
+     */
+    async cancel(requestId) {
+        const controller = this.pendingRequests.get(requestId);
+        if (!controller) {
+            return;
+        }
+        controller.abort(new Error(`MCP stdio request cancelled: ${requestId}`));
+    }
+    async connectInternal() {
+        const serverParams = {
+            command: this.options.command,
+            ...(this.options.args ? { args: this.options.args } : {}),
+            ...(this.options.env ? { env: this.options.env } : {}),
+            ...(this.options.cwd ? { cwd: this.options.cwd } : {}),
+            stderr: "pipe",
+        };
+        this.client = new Client({ name: "tachu-mcp-stdio", version: "1.0.0" });
+        this.transportImpl = new StdioClientTransport(serverParams);
+        this.transportImpl.onclose = () => {
+            this.connected = false;
+            if (!this.closedManually) {
+                void this.reconnectWithBackoff();
+            }
+        };
+        await this.client.connect(this.transportImpl);
+        this.connected = true;
+    }
+    async reconnectWithBackoff() {
+        if (this.reconnecting || this.closedManually) {
+            return;
+        }
+        this.reconnecting = true;
+        try {
+            for (let attempt = 0; attempt < this.maxReconnectAttempts; attempt += 1) {
+                const delay = 200 * 2 ** attempt;
+                await new Promise((resolve) => setTimeout(resolve, delay));
+                try {
+                    await this.connectInternal();
+                    return;
+                }
+                catch {
+                    // retry
+                }
+            }
+        }
+        finally {
+            this.reconnecting = false;
+        }
+    }
+}
+//# sourceMappingURL=stdio-adapter.js.map

package/dist/mcp/stdio-adapter.js.map

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

package/dist/memory/fs-memory-system.d.ts

@@ -0,0 +1,147 @@
+import { InMemoryMemorySystem, type ContextWindow, type MemoryEntry, type MemorySystem } from "@tachu/core";
+/**
+ * `FsMemorySystem` 构造依赖（来自 `@tachu/core` 的 `MemorySystemFactoryDeps`）。
+ *
+ * 解耦设计：extensions 不强依赖 core 的 `MemorySystemFactoryDeps` 类型签名变动，
+ * 内部自描述只取真正需要的字段。
+ */
+export interface FsMemorySystemOptions {
+    /**
+     * 持久化根目录，每个 session 对应 `<persistDir>/<sanitizedId>.jsonl`。
+     */
+    persistDir: string;
+    /**
+     * 内部组合的 `InMemoryMemorySystem` 实例。由调用方（通常为 engine-factory
+     * 通过 core 的 factory 回调）构造好后传入，以复用 core 的 tokenizer /
+     * modelRouter / providers / vectorStore 等运行时依赖。
+     */
+    inner: InMemoryMemorySystem;
+    /**
+     * 压缩触发阈值（0-1）。默认读 `config.memory.compressionThreshold`。
+     * 超过 `contextTokenLimit * threshold` 时在 `append` 中触发 `compress`。
+     */
+    compressionThreshold: number;
+}
+/**
+ * 将任意 session ID 标准化为文件名安全形式。
+ *
+ * 规则：
+ * - 仅保留 `[A-Za-z0-9._-]`，其余一律替换为 `_`
+ * - 首位不允许为 `.`（防止写隐藏文件 / 触发 shell 点号展开）
+ * - 空串兜底为 `default`
+ * - 超长截断到 120 字符（绝大多数 UUID / nanoid 场景足够）
+ */
+export declare function sanitizeSessionId(raw: string): string;
+/**
+ * 基于文件系统的 `MemorySystem` 实现 —— `@tachu/core` `MemorySystem` 抽象的
+ * **跨进程持久化** 参考实现（patch-02-session-persistence）。
+ *
+ * ## 职责
+ *
+ * - 每次 `append` 先把单条 entry 以 append-only JSON line 写入
+ *   `<persistDir>/<sid>.jsonl`（crash-safe），再同步进内部
+ *   `InMemoryMemorySystem` 的运行时 window
+ * - 首次 `load(sid)` 命中时从磁盘 hydrate 上次进程遗留的历史，注入内部
+ *   `InMemoryMemorySystem`（走 public `hydrate()`，旁路 per-entry compress 触发）
+ * - `compress()` 完成后 atomic rewrite 持久化文件，保证"盘 = 内存"一致
+ * - `recall` / `archive` / `getSize` / `trim` 全部代理内部 `InMemoryMemorySystem`
+ *   （只要 load 阶段已 hydrate，这些读路径天然拿到跨进程数据）
+ *
+ * ## 并发
+ *
+ * 单 session 上的 `load` / `append` / `compress` / `trim` 通过 per-session promise
+ * chain 串行化，避免两个 runStream 并发交错写出错乱 jsonl。跨 session 完全独立。
+ *
+ * ## 与 `archivePath` 的职责分离
+ *
+ * - `config.memory.persistDir`（本类）= 热路径：每次 append 即落盘，用于跨进程 `--resume`
+ * - `config.memory.archivePath`（内部 `InMemoryMemorySystem` 拥有）= 冷路径：
+ *   仅在 `compress()` 时一次性追加到单个大 jsonl，供长期记忆向量召回
+ *
+ * 两者**不重叠**，保留现有 archivePath 语义不动。
+ */
+export declare class FsMemorySystem implements MemorySystem {
+    private readonly persistDir;
+    private readonly inner;
+    private readonly compressionThreshold;
+    private readonly hydrated;
+    private readonly pending;
+    /**
+     * 构造文件持久化 MemorySystem。
+     *
+     * @param options 参见 {@link FsMemorySystemOptions}
+     */
+    constructor(options: FsMemorySystemOptions);
+    /**
+     * @inheritdoc
+     */
+    load(sessionId: string): Promise<ContextWindow>;
+    /**
+     * @inheritdoc
+     *
+     * 流程：
+     * 1. 确保 session 已 hydrate（使 window 与磁盘一致）
+     * 2. append-only 将 entry 序列化为单行 JSON 落盘（崩溃安全；即便本次进程 crash，
+     *    磁盘文件仍是合法 jsonl 的前缀）
+     * 3. 将 entry 通过 `inner.hydrate()` 注入内存 window（旁路 per-entry compress）
+     * 4. 手动检查 tokenCount 是否越过阈值；若越线：
+     *    - `inner.compress(sid)` 触发 LLM 摘要
+     *    - atomic rewrite jsonl，保持盘与内存一致
+     */
+    append(sessionId: string, entry: MemoryEntry): Promise<void>;
+    /**
+     * @inheritdoc
+     */
+    compress(sessionId: string): Promise<void>;
+    /**
+     * @inheritdoc
+     */
+    recall(sessionId: string, query: string, topK?: number): Promise<MemoryEntry[]>;
+    /**
+     * @inheritdoc
+     */
+    archive(sessionId: string): Promise<void>;
+    /**
+     * @inheritdoc
+     */
+    getSize(sessionId: string): Promise<{
+        entries: number;
+        tokens: number;
+    }>;
+    /**
+     * @inheritdoc
+     */
+    trim(sessionId: string, options?: {
+        keepHead?: number;
+        keepTail?: number;
+    }): Promise<void>;
+    /**
+     * @inheritdoc
+     *
+     * 先清内存 window，再幂等删除磁盘 jsonl。未找到文件视为 no-op。
+     */
+    clear(sessionId: string): Promise<void>;
+    /**
+     * 获取某 session 的持久化文件绝对 / 相对路径（便于外层 CLI 做迁移、/history 展示）。
+     */
+    pathFor(sessionId: string): string;
+    /**
+     * 从磁盘读取 session 的原始 entries 快照（不经 inner hydrate）。
+     *
+     * 外层 CLI 可借此在 `/history` / `/export` 命令中直接列出原始条目顺序，
+     * 不必先 `load` 触发 hydrate 副作用。
+     */
+    readRaw(sessionId: string): Promise<MemoryEntry[]>;
+    private parseJsonl;
+    private hydrateIfNeeded;
+    private writeJsonlLine;
+    private rewriteJsonl;
+    /**
+     * 串行化某 session 的关键操作 —— 通过 promise chain 保证同一 sessionId 上的
+     * load / append / compress / trim 不交错。
+     *
+     * 失败不阻塞队列：下一个 task 无论前一个 resolve 还是 reject 都会启动。
+     */
+    private serialize;
+}
+//# sourceMappingURL=fs-memory-system.d.ts.map

package/dist/memory/fs-memory-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-memory-system.d.ts","sourceRoot":"","sources":["../../src/memory/fs-memory-system.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,aAAa,CAAC;AAErB;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,KAAK,EAAE,oBAAoB,CAAC;IAC5B;;;OAGG;IACH,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AA0BD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKrD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,cAAe,YAAW,YAAY;IACjD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;IAC7C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAE/D;;;;OAIG;gBACS,OAAO,EAAE,qBAAqB;IAM1C;;OAEG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAOrD;;;;;;;;;;;OAWG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAalE;;OAEG;IACG,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQhD;;OAEG;IACG,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,WAAW,EAAE,CAAC;IAOzB;;OAEG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/C;;OAEG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAK9E;;OAEG;IACG,IAAI,CACR,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GACjD,OAAO,CAAC,IAAI,CAAC;IAQhB;;;;OAIG;IACG,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa7C;;OAEG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAIlC;;;;;OAKG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAcxD,OAAO,CAAC,UAAU;YAgBJ,eAAe;YASf,cAAc;YAMd,YAAY;IAY1B;;;;;OAKG;YACW,SAAS;CAYxB"}

package/dist/memory/fs-memory-system.js

@@ -0,0 +1,266 @@
+import { existsSync } from "node:fs";
+import { appendFile, mkdir, readFile, rename, rm, writeFile, } from "node:fs/promises";
+import { join } from "node:path";
+const JSONL_SEP = "\n";
+function isObject(x) {
+    return typeof x === "object" && x !== null && !Array.isArray(x);
+}
+function parseMemoryEntry(raw) {
+    if (!isObject(raw))
+        return null;
+    const { role, content, timestamp, anchored } = raw;
+    if ((role !== "user" && role !== "assistant" && role !== "system" && role !== "tool") ||
+        typeof timestamp !== "number" ||
+        !Number.isFinite(timestamp)) {
+        return null;
+    }
+    return {
+        role,
+        content: content,
+        timestamp,
+        anchored: Boolean(anchored),
+    };
+}
+/**
+ * 将任意 session ID 标准化为文件名安全形式。
+ *
+ * 规则：
+ * - 仅保留 `[A-Za-z0-9._-]`，其余一律替换为 `_`
+ * - 首位不允许为 `.`（防止写隐藏文件 / 触发 shell 点号展开）
+ * - 空串兜底为 `default`
+ * - 超长截断到 120 字符（绝大多数 UUID / nanoid 场景足够）
+ */
+export function sanitizeSessionId(raw) {
+    const replaced = raw.replace(/[^A-Za-z0-9._-]/g, "_");
+    const stripped = replaced.replace(/^\.+/, "_");
+    const bounded = stripped.length > 120 ? stripped.slice(0, 120) : stripped;
+    return bounded.length === 0 ? "default" : bounded;
+}
+/**
+ * 基于文件系统的 `MemorySystem` 实现 —— `@tachu/core` `MemorySystem` 抽象的
+ * **跨进程持久化** 参考实现（patch-02-session-persistence）。
+ *
+ * ## 职责
+ *
+ * - 每次 `append` 先把单条 entry 以 append-only JSON line 写入
+ *   `<persistDir>/<sid>.jsonl`（crash-safe），再同步进内部
+ *   `InMemoryMemorySystem` 的运行时 window
+ * - 首次 `load(sid)` 命中时从磁盘 hydrate 上次进程遗留的历史，注入内部
+ *   `InMemoryMemorySystem`（走 public `hydrate()`，旁路 per-entry compress 触发）
+ * - `compress()` 完成后 atomic rewrite 持久化文件，保证"盘 = 内存"一致
+ * - `recall` / `archive` / `getSize` / `trim` 全部代理内部 `InMemoryMemorySystem`
+ *   （只要 load 阶段已 hydrate，这些读路径天然拿到跨进程数据）
+ *
+ * ## 并发
+ *
+ * 单 session 上的 `load` / `append` / `compress` / `trim` 通过 per-session promise
+ * chain 串行化，避免两个 runStream 并发交错写出错乱 jsonl。跨 session 完全独立。
+ *
+ * ## 与 `archivePath` 的职责分离
+ *
+ * - `config.memory.persistDir`（本类）= 热路径：每次 append 即落盘，用于跨进程 `--resume`
+ * - `config.memory.archivePath`（内部 `InMemoryMemorySystem` 拥有）= 冷路径：
+ *   仅在 `compress()` 时一次性追加到单个大 jsonl，供长期记忆向量召回
+ *
+ * 两者**不重叠**，保留现有 archivePath 语义不动。
+ */
+export class FsMemorySystem {
+    persistDir;
+    inner;
+    compressionThreshold;
+    hydrated = new Set();
+    pending = new Map();
+    /**
+     * 构造文件持久化 MemorySystem。
+     *
+     * @param options 参见 {@link FsMemorySystemOptions}
+     */
+    constructor(options) {
+        this.persistDir = options.persistDir;
+        this.inner = options.inner;
+        this.compressionThreshold = options.compressionThreshold;
+    }
+    /**
+     * @inheritdoc
+     */
+    async load(sessionId) {
+        return this.serialize(sessionId, async () => {
+            await this.hydrateIfNeeded(sessionId);
+            return this.inner.load(sessionId);
+        });
+    }
+    /**
+     * @inheritdoc
+     *
+     * 流程：
+     * 1. 确保 session 已 hydrate（使 window 与磁盘一致）
+     * 2. append-only 将 entry 序列化为单行 JSON 落盘（崩溃安全；即便本次进程 crash，
+     *    磁盘文件仍是合法 jsonl 的前缀）
+     * 3. 将 entry 通过 `inner.hydrate()` 注入内存 window（旁路 per-entry compress）
+     * 4. 手动检查 tokenCount 是否越过阈值；若越线：
+     *    - `inner.compress(sid)` 触发 LLM 摘要
+     *    - atomic rewrite jsonl，保持盘与内存一致
+     */
+    async append(sessionId, entry) {
+        await this.serialize(sessionId, async () => {
+            await this.hydrateIfNeeded(sessionId);
+            await this.writeJsonlLine(sessionId, entry);
+            await this.inner.hydrate(sessionId, [entry]);
+            const window = await this.inner.load(sessionId);
+            if (window.tokenCount > window.limit * this.compressionThreshold) {
+                await this.inner.compress(sessionId);
+                await this.rewriteJsonl(sessionId);
+            }
+        });
+    }
+    /**
+     * @inheritdoc
+     */
+    async compress(sessionId) {
+        await this.serialize(sessionId, async () => {
+            await this.hydrateIfNeeded(sessionId);
+            await this.inner.compress(sessionId);
+            await this.rewriteJsonl(sessionId);
+        });
+    }
+    /**
+     * @inheritdoc
+     */
+    async recall(sessionId, query, topK) {
+        await this.hydrateIfNeeded(sessionId);
+        return topK === undefined
+            ? this.inner.recall(sessionId, query)
+            : this.inner.recall(sessionId, query, topK);
+    }
+    /**
+     * @inheritdoc
+     */
+    async archive(sessionId) {
+        await this.hydrateIfNeeded(sessionId);
+        await this.inner.archive(sessionId);
+    }
+    /**
+     * @inheritdoc
+     */
+    async getSize(sessionId) {
+        await this.hydrateIfNeeded(sessionId);
+        return this.inner.getSize(sessionId);
+    }
+    /**
+     * @inheritdoc
+     */
+    async trim(sessionId, options) {
+        await this.serialize(sessionId, async () => {
+            await this.hydrateIfNeeded(sessionId);
+            await this.inner.trim(sessionId, options);
+            await this.rewriteJsonl(sessionId);
+        });
+    }
+    /**
+     * @inheritdoc
+     *
+     * 先清内存 window，再幂等删除磁盘 jsonl。未找到文件视为 no-op。
+     */
+    async clear(sessionId) {
+        await this.serialize(sessionId, async () => {
+            this.hydrated.delete(sessionId);
+            await this.inner.clear(sessionId);
+            const path = this.pathFor(sessionId);
+            try {
+                await rm(path, { force: true });
+            }
+            catch {
+                // ignore
+            }
+        });
+    }
+    /**
+     * 获取某 session 的持久化文件绝对 / 相对路径（便于外层 CLI 做迁移、/history 展示）。
+     */
+    pathFor(sessionId) {
+        return join(this.persistDir, `${sanitizeSessionId(sessionId)}.jsonl`);
+    }
+    /**
+     * 从磁盘读取 session 的原始 entries 快照（不经 inner hydrate）。
+     *
+     * 外层 CLI 可借此在 `/history` / `/export` 命令中直接列出原始条目顺序，
+     * 不必先 `load` 触发 hydrate 副作用。
+     */
+    async readRaw(sessionId) {
+        const path = this.pathFor(sessionId);
+        if (!existsSync(path)) {
+            return [];
+        }
+        let raw;
+        try {
+            raw = await readFile(path, "utf8");
+        }
+        catch {
+            return [];
+        }
+        return this.parseJsonl(raw);
+    }
+    parseJsonl(raw) {
+        const entries = [];
+        for (const line of raw.split(JSONL_SEP)) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            try {
+                const parsed = JSON.parse(trimmed);
+                const entry = parseMemoryEntry(parsed);
+                if (entry)
+                    entries.push(entry);
+            }
+            catch {
+                continue;
+            }
+        }
+        return entries;
+    }
+    async hydrateIfNeeded(sessionId) {
+        if (this.hydrated.has(sessionId))
+            return;
+        this.hydrated.add(sessionId);
+        const entries = await this.readRaw(sessionId);
+        if (entries.length === 0)
+            return;
+        await this.inner.hydrate(sessionId, entries);
+    }
+    async writeJsonlLine(sessionId, entry) {
+        await mkdir(this.persistDir, { recursive: true });
+        const line = `${JSON.stringify(entry)}${JSONL_SEP}`;
+        await appendFile(this.pathFor(sessionId), line, "utf8");
+    }
+    async rewriteJsonl(sessionId) {
+        const window = await this.inner.load(sessionId);
+        const path = this.pathFor(sessionId);
+        const tmp = `${path}.tmp`;
+        await mkdir(this.persistDir, { recursive: true });
+        const body = window.entries.length === 0
+            ? ""
+            : window.entries.map((entry) => JSON.stringify(entry)).join(JSONL_SEP) + JSONL_SEP;
+        await writeFile(tmp, body, "utf8");
+        await rename(tmp, path);
+    }
+    /**
+     * 串行化某 session 的关键操作 —— 通过 promise chain 保证同一 sessionId 上的
+     * load / append / compress / trim 不交错。
+     *
+     * 失败不阻塞队列：下一个 task 无论前一个 resolve 还是 reject 都会启动。
+     */
+    async serialize(sessionId, fn) {
+        const prev = this.pending.get(sessionId) ?? Promise.resolve();
+        const next = prev.then(fn, fn);
+        this.pending.set(sessionId, next);
+        try {
+            return await next;
+        }
+        finally {
+            if (this.pending.get(sessionId) === next) {
+                this.pending.delete(sessionId);
+            }
+        }
+    }
+}
+//# sourceMappingURL=fs-memory-system.js.map

package/dist/memory/fs-memory-system.js.map

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

package/dist/memory/index.d.ts

@@ -0,0 +1,2 @@
+export { FsMemorySystem, sanitizeSessionId, type FsMemorySystemOptions, } from "./fs-memory-system";
+//# sourceMappingURL=index.d.ts.map

package/dist/memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,KAAK,qBAAqB,GAC3B,MAAM,oBAAoB,CAAC"}

package/dist/memory/index.js

@@ -0,0 +1,2 @@
+export { FsMemorySystem, sanitizeSessionId, } from "./fs-memory-system";
+//# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,iBAAiB,GAElB,MAAM,oBAAoB,CAAC"}

package/dist/observability/index.d.ts

@@ -0,0 +1,3 @@
+export { OtelEmitter } from "./otel-emitter";
+export { JsonlEmitter } from "./jsonl-emitter";
+//# sourceMappingURL=index.d.ts.map

package/dist/observability/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/observability/index.js

@@ -0,0 +1,3 @@
+export { OtelEmitter } from "./otel-emitter";
+export { JsonlEmitter } from "./jsonl-emitter";
+//# sourceMappingURL=index.js.map