@downcity/agent 1.1.287 → 1.1.310

package/bin/{session/messages → workspace/store}/JsonlSessionMessageStore.js

@@ -1,13 +1,10 @@
 /**
- * Session Message 的 Active + Segment JSONL 存储。
+ * Workspace Session Message 的 Active + Segment JSONL 存储。
  *
  * Active 保存上次 Compact 后产生的真实 Message；Compact 把 Active 前缀写入按
  * sequence 范围命名的不可变 Segment，并在 Segment 末尾追加累计 Summary footer。
  */
-import fs from "fs-extra";
-import { open, readFile, stat } from "node:fs/promises";
 import path from "node:path";
-import { generateId } from "../../utils/Id.js";
 const SEGMENT_FILE_PATTERN = /^(\d+)-(\d+)\.jsonl$/;
 const SEQUENCE_FILE_WIDTH = 12;
 /** Active + Segment JSONL 存储。 */
@@ -17,7 +14,9 @@ export class JsonlSessionMessageStore {
     assistant_message_file_path;
     segments_dir_path;
     lock_file_path;
+    files;
     constructor(options) {
+        this.files = options.files;
         this.session_id = String(options.session_id || "").trim();
         this.active_file_path = path.resolve(options.file_path);
         this.assistant_message_file_path = path.resolve(options.assistant_message_file_path ||
@@ -54,7 +53,7 @@ export class JsonlSessionMessageStore {
                 finalized?.type === "assistant" &&
                 finalized.revision >= draft.revision &&
                 finalized.status !== "streaming") {
-                await fs.remove(this.assistant_message_file_path);
+                await this.files.remove_path(this.assistant_message_file_path);
             }
         });
     }
@@ -107,7 +106,7 @@ export class JsonlSessionMessageStore {
             (latest_range ? (await this.read_segment(latest_range)).messages.at(-1) : null) ||
             null;
         const paths = [this.active_file_path, ...ranges.map((range) => range.file_path)];
-        const sizes = await Promise.all(paths.map(async (file_path) => await stat(file_path).then((value) => value.size).catch(() => 0)));
+        const sizes = await Promise.all(paths.map(async (file_path) => await this.files.file_size(file_path).catch(() => 0)));
         const latest_sequence = Math.max(latest_range?.end_sequence || 0, active_messages.reduce((max, message) => Math.max(max, message.sequence), 0));
         return {
             message_count: latest_sequence,
@@ -131,7 +130,7 @@ export class JsonlSessionMessageStore {
     /** 读取当前运行中的 Assistant 草稿。 */
     async read_assistant_message() {
         try {
-            const value = await fs.readJson(this.assistant_message_file_path);
+            const value = JSON.parse((await this.files.read_file(this.assistant_message_file_path)).toString("utf8"));
             this.validate_message(value);
             return value.type === "assistant" && value.status === "streaming" ? value : null;
         }
@@ -191,7 +190,7 @@ export class JsonlSessionMessageStore {
                 messages: current_messages,
             });
             this.validate_message(message);
-            await fs.appendFile(this.active_file_path, `${JSON.stringify(message)}\n`, "utf8");
+            await this.files.append_file(this.active_file_path, `${JSON.stringify(message)}\n`);
             return message;
         });
     }
@@ -208,8 +207,8 @@ export class JsonlSessionMessageStore {
             if (message.revision !== current.revision + 1) {
                 throw new Error(`Invalid final Assistant revision: ${message.message_id}`);
             }
-            await fs.appendFile(this.active_file_path, `${JSON.stringify(message)}\n`, "utf8");
-            await fs.remove(this.assistant_message_file_path);
+            await this.files.append_file(this.active_file_path, `${JSON.stringify(message)}\n`);
+            await this.files.remove_path(this.assistant_message_file_path);
         });
     }
     /** 把 Active 前缀与累计 Summary 提交为不可变 Segment。 */
@@ -236,7 +235,7 @@ export class JsonlSessionMessageStore {
                 end_sequence,
                 file_path: this.segment_file_path(start_sequence, end_sequence),
             };
-            if (await fs.pathExists(range.file_path)) {
+            if (await this.files.path_exists(range.file_path)) {
                 throw new Error(`Session Segment already exists: ${range.file_path}`);
             }
             await this.write_segment_unsafe(range, segment_messages, input.summary);
@@ -250,10 +249,10 @@ export class JsonlSessionMessageStore {
     /** 扫描 Segment 文件名并返回 sequence 升序索引。 */
     async list_segment_ranges() {
         await this.ensure_layout();
-        const entries = await fs.readdir(this.segments_dir_path, { withFileTypes: true });
+        const entries = await this.files.read_directory(this.segments_dir_path);
         const ranges = entries
             .flatMap((entry) => {
-            if (!entry.isFile())
+            if (!entry.is_file)
                 return [];
             const match = SEGMENT_FILE_PATTERN.exec(entry.name);
             if (!match)
@@ -286,7 +285,7 @@ export class JsonlSessionMessageStore {
     }
     /** 读取并验证一个不可变 Segment。 */
     async read_segment(range) {
-        const raw = await fs.readFile(range.file_path, "utf8");
+        const raw = (await this.files.read_file(range.file_path)).toString("utf8");
         const lines = raw.split("\n").map((line) => line.trim()).filter(Boolean);
         const summary_value = JSON.parse(lines.pop() || "null");
         this.validate_summary(summary_value, range.end_sequence);
@@ -313,7 +312,9 @@ export class JsonlSessionMessageStore {
     }
     /** 读取 Active 原始行，并按 Message ID 保留最高 revision。 */
     async read_folded_active_messages_unsafe() {
-        const raw = await fs.readFile(this.active_file_path, "utf8").catch(() => "");
+        const raw = await this.files.read_file(this.active_file_path)
+            .then((value) => value.toString("utf8"))
+            .catch(() => "");
         const by_id = new Map();
         for (const line of raw.split("\n")) {
             if (!line.trim())
@@ -333,28 +334,25 @@ export class JsonlSessionMessageStore {
     }
     /** 原子覆盖 Assistant 草稿。 */
     async write_assistant_message_unsafe(message) {
-        const temporary_path = `${this.assistant_message_file_path}.${process.pid}.${Date.now()}.tmp`;
-        await fs.writeJson(temporary_path, message, { spaces: 2 });
-        await fs.move(temporary_path, this.assistant_message_file_path, { overwrite: true });
+        await this.files.write_file_atomically(this.assistant_message_file_path, `${JSON.stringify(message, null, 2)}\n`);
     }
     /** 原子覆盖 Active，只写入每个 Message 的最终 revision。 */
     async write_active_messages_unsafe(messages) {
-        const temporary_path = `${this.active_file_path}.${process.pid}.${Date.now()}.tmp`;
         const content = messages.length > 0
             ? `${messages.map((message) => JSON.stringify(message)).join("\n")}\n`
             : "";
-        await fs.writeFile(temporary_path, content, "utf8");
-        await fs.move(temporary_path, this.active_file_path, { overwrite: true });
+        await this.files.write_file_atomically(this.active_file_path, content);
     }
     /** 原子创建一个带累计 Summary footer 的 Segment。 */
     async write_segment_unsafe(range, messages, summary) {
-        const temporary_path = `${range.file_path}.${process.pid}.${Date.now()}.tmp`;
         const content = `${[
             ...messages.map((message) => JSON.stringify(message)),
             JSON.stringify(summary),
         ].join("\n")}\n`;
-        await fs.writeFile(temporary_path, content, "utf8");
-        await fs.move(temporary_path, range.file_path, { overwrite: false });
+        if (await this.files.path_exists(range.file_path)) {
+            throw new Error(`Session Segment already exists: ${range.file_path}`);
+        }
+        await this.files.write_file_atomically(range.file_path, content);
     }
     /** 生成稳定的 Segment sequence 范围文件名。 */
     segment_file_path(start_sequence, end_sequence) {
@@ -402,49 +400,16 @@ export class JsonlSessionMessageStore {
     }
     /** 创建 Active、Segment 与锁所需目录。 */
     async ensure_layout() {
-        await fs.ensureDir(path.dirname(this.active_file_path));
-        await fs.ensureDir(this.segments_dir_path);
-        await fs.ensureFile(this.active_file_path);
+        await this.files.ensure_directory(path.dirname(this.active_file_path));
+        await this.files.ensure_directory(this.segments_dir_path);
+        if (!(await this.files.path_exists(this.active_file_path))) {
+            await this.files.write_file_atomically(this.active_file_path, "");
+        }
     }
     /** 使用同目录锁串行化 Active、草稿与 Segment 写入。 */
     async with_write_lock(callback) {
         await this.ensure_layout();
-        const token = `${process.pid}:${Date.now()}:${generateId()}`;
-        const stale_ms = 30_000;
-        const started_at = Date.now();
-        while (true) {
-            try {
-                const file = await open(this.lock_file_path, "wx");
-                await file.writeFile(token, "utf8");
-                await file.close();
-                break;
-            }
-            catch (error) {
-                if (error.code !== "EEXIST")
-                    throw error;
-                try {
-                    const lock_stat = await stat(this.lock_file_path);
-                    if (Date.now() - lock_stat.mtimeMs > stale_ms)
-                        await fs.remove(this.lock_file_path);
-                }
-                catch { /* 锁文件可能刚被释放。 */ }
-                if (Date.now() - started_at > stale_ms * 2) {
-                    throw new Error(`Session message lock timeout: ${this.lock_file_path}`);
-                }
-                await new Promise((resolve) => setTimeout(resolve, 40));
-            }
-        }
-        try {
-            return await callback();
-        }
-        finally {
-            try {
-                if ((await readFile(this.lock_file_path, "utf8")).trim() === token) {
-                    await fs.remove(this.lock_file_path);
-                }
-            }
-            catch { /* 锁已被清理。 */ }
-        }
+        return await this.files.with_file_lock(this.lock_file_path, callback);
     }
 }
 /** 按全局 Message sequence 升序排序。 */

package/bin/workspace/store/JsonlSessionMessageStore.js.map

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

package/bin/workspace/store/LocalAgentStore.d.ts

@@ -0,0 +1,43 @@
+/**
+ * LocalAgentStore：Workspace 内本地 Agent 领域数据入口。
+ *
+ * 职责说明（中文）
+ * - 统一管理 Session 创建判断、删除、列表、归档与清理。
+ * - 缓存稳定的 LocalSessionStore，避免同一 Session 重复创建 Message Store。
+ * - 当前阶段沿用既有本地目录布局；调用方和 Session 不感知该约定。
+ */
+import type { AgentArchiveSessionResult, AgentArchiveSessionsInput, AgentArchiveSessionsResult, AgentCleanArchiveResult, AgentListSessionsInput, AgentSessionSummaryPage } from "../../types/agent/SessionTypes.js";
+import type { AgentStore } from "../../types/store/AgentStore.js";
+import type { SessionStore } from "../../types/store/SessionStore.js";
+import type { LocalAgentStoreOptions } from "../../types/store/LocalStore.js";
+/** 默认本地 Agent Store。 */
+export declare class LocalAgentStore implements AgentStore {
+    /** 当前 Store 与 WorkspaceTools 共用的 Workspace 文件能力。 */
+    private readonly files;
+    /** 当前 Agent 的稳定标识。 */
+    private readonly agent_id;
+    /** 已创建的 Session Store 缓存。 */
+    private readonly sessions;
+    constructor(options: LocalAgentStoreOptions);
+    /** 返回指定 Session 的稳定持久化视图。 */
+    session(session_id: string): SessionStore;
+    /** 判断活动 Session 是否存在。 */
+    has_session(session_id: string): Promise<boolean>;
+    /** 永久删除活动 Session。 */
+    remove_session(session_id: string): Promise<boolean>;
+    /** 清空活动 Session Message 数据。 */
+    clear_session_messages(session_id: string): Promise<boolean>;
+    /** 返回活动 Session 摘要页。 */
+    list_sessions(input: AgentListSessionsInput | undefined, executing_session_ids: ReadonlySet<string>): Promise<AgentSessionSummaryPage>;
+    /** 将活动 Session 迁入归档区。 */
+    archive_session(session_id: string): Promise<AgentArchiveSessionResult>;
+    /** 返回归档 Session 摘要页。 */
+    list_archived_sessions(input?: AgentArchiveSessionsInput): Promise<AgentArchiveSessionsResult>;
+    /** 永久删除全部归档 Session。 */
+    clean_archive(): Promise<AgentCleanArchiveResult>;
+    /** 本地 JSONL Store 当前没有常驻句柄。 */
+    dispose(): Promise<void>;
+    /** 返回活动 Session 物理目录，仅供本地实现内部使用。 */
+    private session_path;
+}
+//# sourceMappingURL=LocalAgentStore.d.ts.map

package/bin/workspace/store/LocalAgentStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalAgentStore.d.ts","sourceRoot":"","sources":["../../../src/workspace/store/LocalAgentStore.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,yBAAyB,EACzB,yBAAyB,EACzB,0BAA0B,EAC1B,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAalE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAW1E,wBAAwB;AACxB,qBAAa,eAAgB,YAAW,UAAU;IAChD,oDAAoD;IACpD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IAEnC,sBAAsB;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC,6BAA6B;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwC;gBAErD,OAAO,EAAE,sBAAsB;IAK3C,6BAA6B;IAC7B,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY;IAgBzC,yBAAyB;IACnB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvD,sBAAsB;IAChB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ1D,+BAA+B;IACzB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYlE,wBAAwB;IAClB,aAAa,CACjB,KAAK,EAAE,sBAAsB,GAAG,SAAS,EACzC,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAAC,GACzC,OAAO,CAAC,uBAAuB,CAAC;IAUnC,yBAAyB;IACnB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAyB7E,wBAAwB;IAClB,sBAAsB,CAC1B,KAAK,CAAC,EAAE,yBAAyB,GAChC,OAAO,CAAC,0BAA0B,CAAC;IAStC,wBAAwB;IAClB,aAAa,IAAI,OAAO,CAAC,uBAAuB,CAAC;IAwBvD,+BAA+B;IACzB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAE9B,oCAAoC;IACpC,OAAO,CAAC,YAAY;CAOrB"}

package/bin/workspace/store/LocalAgentStore.js

@@ -0,0 +1,135 @@
+/**
+ * LocalAgentStore：Workspace 内本地 Agent 领域数据入口。
+ *
+ * 职责说明（中文）
+ * - 统一管理 Session 创建判断、删除、列表、归档与清理。
+ * - 缓存稳定的 LocalSessionStore，避免同一 Session 重复创建 Message Store。
+ * - 当前阶段沿用既有本地目录布局；调用方和 Session 不感知该约定。
+ */
+import { LocalSessionStore } from "../../workspace/store/LocalSessionStore.js";
+import { get_sdk_agent_archived_session_dir_path, get_sdk_agent_archived_sessions_dir_path, get_sdk_agent_session_dir_path, get_sdk_agent_session_messages_dir_path, } from "../../workspace/store/LocalStorePaths.js";
+import { list_archived_agent_session_summary_page, list_agent_session_summary_page, } from "../../session/browse/Browse.js";
+/** 解码目录中经过 URL 编码的 Session 标识。 */
+function decode_session_id(input) {
+    try {
+        return decodeURIComponent(input);
+    }
+    catch {
+        return input;
+    }
+}
+/** 默认本地 Agent Store。 */
+export class LocalAgentStore {
+    /** 当前 Store 与 WorkspaceTools 共用的 Workspace 文件能力。 */
+    files;
+    /** 当前 Agent 的稳定标识。 */
+    agent_id;
+    /** 已创建的 Session Store 缓存。 */
+    sessions = new Map();
+    constructor(options) {
+        this.files = options.files;
+        this.agent_id = options.agent_id;
+    }
+    /** 返回指定 Session 的稳定持久化视图。 */
+    session(session_id) {
+        const resolved_session_id = String(session_id || "").trim();
+        if (!resolved_session_id) {
+            throw new Error("AgentStore.session requires a non-empty session_id");
+        }
+        const cached = this.sessions.get(resolved_session_id);
+        if (cached)
+            return cached;
+        const created = new LocalSessionStore({
+            files: this.files,
+            agent_id: this.agent_id,
+            session_id: resolved_session_id,
+        });
+        this.sessions.set(resolved_session_id, created);
+        return created;
+    }
+    /** 判断活动 Session 是否存在。 */
+    async has_session(session_id) {
+        return await this.files.path_exists(this.session_path(session_id));
+    }
+    /** 永久删除活动 Session。 */
+    async remove_session(session_id) {
+        const session_path = this.session_path(session_id);
+        const existed = await this.files.path_exists(session_path);
+        if (existed)
+            await this.files.remove_path(session_path);
+        this.sessions.delete(session_id);
+        return existed;
+    }
+    /** 清空活动 Session Message 数据。 */
+    async clear_session_messages(session_id) {
+        const messages_path = get_sdk_agent_session_messages_dir_path(this.files.root_path, this.agent_id, session_id);
+        const existed = await this.files.path_exists(messages_path);
+        if (existed)
+            await this.files.remove_path(messages_path);
+        this.sessions.delete(session_id);
+        return existed;
+    }
+    /** 返回活动 Session 摘要页。 */
+    async list_sessions(input, executing_session_ids) {
+        return await list_agent_session_summary_page({
+            project_root: this.files.root_path,
+            agent_id: this.agent_id,
+            input,
+            executingSessionIds: new Set(executing_session_ids),
+            files: this.files,
+        });
+    }
+    /** 将活动 Session 迁入归档区。 */
+    async archive_session(session_id) {
+        const source_path = this.session_path(session_id);
+        if (!(await this.files.path_exists(source_path))) {
+            throw new Error(`Session "${session_id}" not found`);
+        }
+        const target_path = get_sdk_agent_archived_session_dir_path(this.files.root_path, this.agent_id, session_id);
+        if (await this.files.path_exists(target_path)) {
+            throw new Error(`Archived session "${session_id}" already exists`);
+        }
+        await this.files.ensure_directory(get_sdk_agent_archived_sessions_dir_path(this.files.root_path, this.agent_id));
+        await this.files.move_path(source_path, target_path);
+        this.sessions.delete(session_id);
+        return {
+            session_id: session_id,
+            archived_at: Date.now(),
+        };
+    }
+    /** 返回归档 Session 摘要页。 */
+    async list_archived_sessions(input) {
+        return await list_archived_agent_session_summary_page({
+            project_root: this.files.root_path,
+            agent_id: this.agent_id,
+            input,
+            files: this.files,
+        });
+    }
+    /** 永久删除全部归档 Session。 */
+    async clean_archive() {
+        const archive_path = get_sdk_agent_archived_sessions_dir_path(this.files.root_path, this.agent_id);
+        if (!(await this.files.path_exists(archive_path))) {
+            return { removed_session_ids: [] };
+        }
+        const entries = await this.files.read_directory(archive_path);
+        const removed_session_ids = [];
+        for (const entry of entries) {
+            if (!entry.is_directory)
+                continue;
+            const session_id = decode_session_id(entry.name);
+            if (!session_id)
+                continue;
+            await this.files.remove_path(get_sdk_agent_archived_session_dir_path(this.files.root_path, this.agent_id, session_id));
+            removed_session_ids.push(session_id);
+        }
+        return { removed_session_ids: removed_session_ids };
+    }
+    /** 本地 JSONL Store 当前没有常驻句柄。 */
+    async dispose() { }
+    /** 返回活动 Session 物理目录，仅供本地实现内部使用。 */
+    session_path(session_id) {
+        return get_sdk_agent_session_dir_path(this.files.root_path, this.agent_id, session_id);
+    }
+}
+//# sourceMappingURL=LocalAgentStore.js.map

package/bin/workspace/store/LocalAgentStore.js.map

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

package/bin/workspace/store/LocalSessionStore.d.ts

@@ -0,0 +1,38 @@
+/**
+ * LocalSessionStore：Workspace 内单个 Session 的 JSONL 持久化视图。
+ *
+ * 职责说明（中文）
+ * - 集中创建 Message Store，并封装 Metadata 与 Instruction 的物理路径。
+ * - Session 领域只持有本对象，不再自行拼接任何存储路径。
+ */
+import { JsonlSessionMessageStore } from "../../workspace/store/JsonlSessionMessageStore.js";
+import type { SessionHistoryMetaV1 } from "../../executor/types/SessionHistoryMeta.js";
+import type { SessionStore } from "../../types/store/SessionStore.js";
+import type { LocalSessionStoreOptions } from "../../types/store/LocalStore.js";
+/** 本地 Session Store。 */
+export declare class LocalSessionStore implements SessionStore {
+    /** 当前 Session 的稳定标识。 */
+    readonly session_id: string;
+    /** 当前 Session 的 JSONL Message Store。 */
+    readonly messages: JsonlSessionMessageStore;
+    /** 当前 Store 与 WorkspaceTools 共用的 Workspace 文件能力。 */
+    private readonly files;
+    /** 当前 Agent 的稳定标识。 */
+    private readonly agent_id;
+    constructor(options: LocalSessionStoreOptions);
+    /** 读取规范化 Session Metadata。 */
+    read_metadata(): Promise<SessionHistoryMetaV1>;
+    /** 写入完整 Session Metadata。 */
+    write_metadata(metadata: SessionHistoryMetaV1): Promise<void>;
+    /** 判断显式 system 快照是否存在。 */
+    has_instruction(): Promise<boolean>;
+    /** 读取显式 system 快照。 */
+    read_instruction(): Promise<string | null>;
+    /** 写入显式 system 快照。 */
+    write_instruction(instruction: string): Promise<void>;
+    /** 返回当前 Session instruction.md 的 Workspace 路径。 */
+    private instruction_path;
+    /** 返回当前 Session meta.json 的 Workspace 路径。 */
+    private metadata_path;
+}
+//# sourceMappingURL=LocalSessionStore.d.ts.map

package/bin/workspace/store/LocalSessionStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalSessionStore.d.ts","sourceRoot":"","sources":["../../../src/workspace/store/LocalSessionStore.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,+CAA+C,CAAC;AAQzF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AACnF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAE5E,wBAAwB;AACxB,qBAAa,iBAAkB,YAAW,YAAY;IACpD,wBAAwB;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;IAE5C,oDAAoD;IACpD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IAEnC,sBAAsB;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,OAAO,EAAE,wBAAwB;IAoB7C,8BAA8B;IACxB,aAAa,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAWpD,6BAA6B;IACvB,cAAc,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnE,0BAA0B;IACpB,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAIzC,sBAAsB;IAChB,gBAAgB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKhD,sBAAsB;IAChB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS3D,kDAAkD;IAClD,OAAO,CAAC,gBAAgB;IAQxB,6CAA6C;IAC7C,OAAO,CAAC,aAAa;CAOtB"}

package/bin/workspace/store/LocalSessionStore.js

@@ -0,0 +1,70 @@
+/**
+ * LocalSessionStore：Workspace 内单个 Session 的 JSONL 持久化视图。
+ *
+ * 职责说明（中文）
+ * - 集中创建 Message Store，并封装 Metadata 与 Instruction 的物理路径。
+ * - Session 领域只持有本对象，不再自行拼接任何存储路径。
+ */
+import { JsonlSessionMessageStore } from "../../workspace/store/JsonlSessionMessageStore.js";
+import { get_sdk_agent_session_instruction_path, get_sdk_agent_session_meta_path, get_sdk_agent_session_assistant_message_path, get_sdk_agent_session_messages_path, } from "../../workspace/store/LocalStorePaths.js";
+import { normalize_session_metadata } from "../../session/storage/Metadata.js";
+/** 本地 Session Store。 */
+export class LocalSessionStore {
+    /** 当前 Session 的稳定标识。 */
+    session_id;
+    /** 当前 Session 的 JSONL Message Store。 */
+    messages;
+    /** 当前 Store 与 WorkspaceTools 共用的 Workspace 文件能力。 */
+    files;
+    /** 当前 Agent 的稳定标识。 */
+    agent_id;
+    constructor(options) {
+        this.files = options.files;
+        this.agent_id = options.agent_id;
+        this.session_id = options.session_id;
+        this.messages = new JsonlSessionMessageStore({
+            files: this.files,
+            session_id: this.session_id,
+            file_path: get_sdk_agent_session_messages_path(this.files.root_path, this.agent_id, this.session_id),
+            assistant_message_file_path: get_sdk_agent_session_assistant_message_path(this.files.root_path, this.agent_id, this.session_id),
+        });
+    }
+    /** 读取规范化 Session Metadata。 */
+    async read_metadata() {
+        try {
+            const raw = JSON.parse((await this.files.read_file(this.metadata_path())).toString("utf8"));
+            return normalize_session_metadata(raw, this.session_id, this.agent_id);
+        }
+        catch {
+            return normalize_session_metadata({}, this.session_id, this.agent_id);
+        }
+    }
+    /** 写入完整 Session Metadata。 */
+    async write_metadata(metadata) {
+        await this.files.write_file_atomically(this.metadata_path(), `${JSON.stringify(metadata, null, 2)}\n`);
+    }
+    /** 判断显式 system 快照是否存在。 */
+    async has_instruction() {
+        return await this.files.path_exists(this.instruction_path());
+    }
+    /** 读取显式 system 快照。 */
+    async read_instruction() {
+        if (!(await this.has_instruction()))
+            return null;
+        return (await this.files.read_file(this.instruction_path())).toString("utf8");
+    }
+    /** 写入显式 system 快照。 */
+    async write_instruction(instruction) {
+        const instruction_path = get_sdk_agent_session_instruction_path(this.files.root_path, this.agent_id, this.session_id);
+        await this.files.write_file_atomically(instruction_path, instruction);
+    }
+    /** 返回当前 Session instruction.md 的 Workspace 路径。 */
+    instruction_path() {
+        return get_sdk_agent_session_instruction_path(this.files.root_path, this.agent_id, this.session_id);
+    }
+    /** 返回当前 Session meta.json 的 Workspace 路径。 */
+    metadata_path() {
+        return get_sdk_agent_session_meta_path(this.files.root_path, this.agent_id, this.session_id);
+    }
+}
+//# sourceMappingURL=LocalSessionStore.js.map

package/bin/workspace/store/LocalSessionStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalSessionStore.js","sourceRoot":"","sources":["../../../src/workspace/store/LocalSessionStore.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,+CAA+C,CAAC;AACzF,OAAO,EACL,sCAAsC,EACtC,+BAA+B,EAC/B,4CAA4C,EAC5C,mCAAmC,GACpC,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAM3E,wBAAwB;AACxB,MAAM,OAAO,iBAAiB;IAC5B,wBAAwB;IACf,UAAU,CAAS;IAE5B,wCAAwC;IAC/B,QAAQ,CAA2B;IAE5C,oDAAoD;IACnC,KAAK,CAAa;IAEnC,sBAAsB;IACL,QAAQ,CAAS;IAElC,YAAY,OAAiC;QAC3C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,QAAQ,GAAG,IAAI,wBAAwB,CAAC;YAC3C,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,SAAS,EAAE,mCAAmC,CAC5C,IAAI,CAAC,KAAK,CAAC,SAAS,EACpB,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,UAAU,CAChB;YACD,2BAA2B,EAAE,4CAA4C,CACvE,IAAI,CAAC,KAAK,CAAC,SAAS,EACpB,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,UAAU,CAChB;SACF,CAAC,CAAC;IACL,CAAC;IAED,8BAA8B;IAC9B,KAAK,CAAC,aAAa;QACjB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CACpB,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CACnC,CAAC;YACnC,OAAO,0BAA0B,CAAC,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,0BAA0B,CAAC,EAAE,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAED,6BAA6B;IAC7B,KAAK,CAAC,cAAc,CAAC,QAA8B;QACjD,MAAM,IAAI,CAAC,KAAK,CAAC,qBAAqB,CACpC,IAAI,CAAC,aAAa,EAAE,EACpB,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CACzC,CAAC;IACJ,CAAC;IAED,0BAA0B;IAC1B,KAAK,CAAC,eAAe;QACnB,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,sBAAsB;IACtB,KAAK,CAAC,gBAAgB;QACpB,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;YAAE,OAAO,IAAI,CAAC;QACjD,OAAO,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChF,CAAC;IAED,sBAAsB;IACtB,KAAK,CAAC,iBAAiB,CAAC,WAAmB;QACzC,MAAM,gBAAgB,GAAG,sCAAsC,CAC7D,IAAI,CAAC,KAAK,CAAC,SAAS,EACpB,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,UAAU,CAChB,CAAC;QACF,MAAM,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC;IACxE,CAAC;IAED,kDAAkD;IAC1C,gBAAgB;QACtB,OAAO,sCAAsC,CAC3C,IAAI,CAAC,KAAK,CAAC,SAAS,EACpB,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,UAAU,CAChB,CAAC;IACJ,CAAC;IAED,6CAA6C;IACrC,aAAa;QACnB,OAAO,+BAA+B,CACpC,IAAI,CAAC,KAAK,CAAC,SAAS,EACpB,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,UAAU,CAChB,CAAC;IACJ,CAAC;CACF"}

package/bin/workspace/store/LocalStorePaths.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Workspace LocalAgentStore 的 Session 路径规则。
+ *
+ * 关键点（中文）
+ * - 所有 agent session 统一落盘到 `.downcity/agents/<agent_id>/sessions/<session_id>/...`。
+ * - `agent_id` 是唯一隔离维度，不再保留第二套旧 session 根目录。
+ */
+/**
+ * `.downcity` 根目录路径。
+ */
+export declare function get_sdk_downcity_dir_path(workspace_path: string): string;
+/**
+ * SDK agents 根目录路径。
+ */
+export declare function get_sdk_agents_root_dir_path(workspace_path: string): string;
+/**
+ * 单个 agent 根目录路径。
+ */
+export declare function get_sdk_agent_dir_path(workspace_path: string, agent_id: string): string;
+/**
+ * 单个 agent 的 sessions 根目录路径。
+ */
+export declare function get_sdk_agent_sessions_root_dir_path(workspace_path: string, agent_id: string): string;
+/**
+ * 单个 agent 的已归档 sessions 根目录路径。
+ *
+ * 关键点（中文）
+ * - `archive_session` 会把整个 session 目录从 `sessions/<session_id>` 移动到此处。
+ * - `clean_archive` 会永久删除该目录下的全部内容。
+ */
+export declare function get_sdk_agent_archived_sessions_dir_path(workspace_path: string, agent_id: string): string;
+/**
+ * 单个已归档 session 的根目录路径。
+ */
+export declare function get_sdk_agent_archived_session_dir_path(workspace_path: string, agent_id: string, session_id: string): string;
+/**
+ * 单个已归档 session 的消息目录路径。
+ */
+export declare function get_sdk_agent_archived_session_messages_dir_path(workspace_path: string, agent_id: string, session_id: string): string;
+/**
+ * 单个已归档 session 的 Active JSONL 文件路径。
+ */
+export declare function get_sdk_agent_archived_session_messages_path(workspace_path: string, agent_id: string, session_id: string): string;
+/**
+ * 单个已归档 session 的 meta.json 路径。
+ */
+export declare function get_sdk_agent_archived_session_meta_path(workspace_path: string, agent_id: string, session_id: string): string;
+/**
+ * 单个 session 根目录路径。
+ */
+export declare function get_sdk_agent_session_dir_path(workspace_path: string, agent_id: string, session_id: string): string;
+/**
+ * 单个 session 显式固化完整 system 的 instruction.md 路径。
+ *
+ * 关键点（中文）
+ * - 文件不存在表示 Session 恢复时继续采用 Agent 当前 instruction。
+ * - 空文件表示调用方显式固化了空 system。
+ */
+export declare function get_sdk_agent_session_instruction_path(workspace_path: string, agent_id: string, session_id: string): string;
+/**
+ * 单个 session 的消息目录路径。
+ */
+export declare function get_sdk_agent_session_messages_dir_path(workspace_path: string, agent_id: string, session_id: string): string;
+/**
+ * 单个 session 的 Active JSONL 文件路径。
+ */
+export declare function get_sdk_agent_session_messages_path(workspace_path: string, agent_id: string, session_id: string): string;
+/**
+ * 单个 session 的 meta.json 路径。
+ */
+export declare function get_sdk_agent_session_meta_path(workspace_path: string, agent_id: string, session_id: string): string;
+/**
+ * 单个 session 的 inflight assistant 路径。
+ *
+ * 关键点（中文）
+ * - 运行中的 assistant 只保留一份增量快照。
+ * - step / tool 过程会持续重写这个文件，避免中途中断后过程完全丢失。
+ * - 完成后再把最终 assistant 合并进 `active.jsonl`，并清理该文件。
+ */
+export declare function get_sdk_agent_session_assistant_message_path(workspace_path: string, agent_id: string, session_id: string): string;
+//# sourceMappingURL=LocalStorePaths.d.ts.map