@downcity/agent 1.1.337 → 1.1.399

package/bin/types/session/SessionTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionTool.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionTool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAElF,wCAAwC;AACxC,MAAM,WAAW,4BAA4B;IAC3C,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,IAAI,EAAE,wBAAwB,CAAC;CAChC;AAED,oCAAoC;AACpC,MAAM,WAAW,qBAAqB;IACpC,uBAAuB;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wCAAwC;AACxC,MAAM,WAAW,qBAAqB;IACpC,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,yCAAyC;IACzC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,gCAAgC;IAChC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAChC"}
+{"version":3,"file":"SessionTool.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionTool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAElF,wCAAwC;AACxC,MAAM,WAAW,4BAA4B;IAC3C,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,IAAI,EAAE,wBAAwB,CAAC;CAChC;AAED,oCAAoC;AACpC,MAAM,WAAW,qBAAqB;IACpC,uBAAuB;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,mBAAmB;AACnB,MAAM,WAAW,0BAA0B;IACzC,yBAAyB;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,sBAAsB;IACtB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wCAAwC;AACxC,MAAM,WAAW,qBAAqB;IACpC,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,yCAAyC;IACzC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,gCAAgC;IAChC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAChC"}

package/bin/types/store/LocalStore.d.ts

@@ -2,29 +2,37 @@
  * 本地 Workspace Store 实现的构造类型。
  *
  * 关键点（中文）
- * - 本地 Store 只接收 Workspace 已创建的 FileSystem，不单独接收存储根目录。
- * - AgentStore 与 SessionStore 因而始终和 WorkspaceTools 使用同一资源容器。
+ * - 本地 Store 接收 AgentStorage 创建的私有 FileSystem 与存储根目录。
+ * - SessionStore 与 SessionDataStore 不复用项目 WorkspaceTools 的 FileSystem。
  */
-import type { FileSystem } from "../../types/workspace/FileSystem.js";
-/** LocalAgentStore 构造参数。 */
-export interface LocalAgentStoreOptions {
-    /** 当前 Store 与 WorkspaceTools 共用的 Workspace 文件能力。 */
+import type { FileSystem } from "@downcity/workspace";
+/** LocalSessionStore 构造参数。 */
+export interface LocalSessionStoreOptions {
+    /** 当前 Agent 内部数据文件能力。 */
     files: FileSystem;
-    /** 当前 Agent 的稳定标识，用于划分 `.downcity/agents` 子目录。 */
+    /** 当前 Agent 内部数据的绝对根路径。 */
+    storage_root_path: string;
+    /** 当前 Session 查询视图所属 Agent 的稳定标识。 */
     agent_id: string;
+    /** 当前 Workspace 的稳定标识。 */
+    workspace_id?: string;
 }
-/** LocalSessionStore 构造参数。 */
-export interface LocalSessionStoreOptions {
-    /** 当前 Store 与 WorkspaceTools 共用的 Workspace 文件能力。 */
+/** LocalSessionDataStore 构造参数。 */
+export interface LocalSessionDataStoreOptions {
+    /** 当前 Agent 私有数据文件能力。 */
     files: FileSystem;
+    /** 当前 Agent 内部数据的绝对根路径。 */
+    storage_root_path: string;
     /** 当前 Session 所属 Agent 的稳定标识。 */
     agent_id: string;
+    /** 当前 Session 所属 Workspace 的稳定标识。 */
+    workspace_id?: string;
     /** 当前 Session 的稳定标识。 */
     session_id: string;
 }
 /** JsonlSessionMessageStore 构造参数。 */
 export interface JsonlSessionMessageStoreOptions {
-    /** 当前 Message Store 与 Session 共用的 Workspace 文件能力。 */
+    /** 当前 Message Store 使用的 Agent 私有文件能力。 */
     files: FileSystem;
     /** 当前 Session 的稳定标识。 */
     session_id: string;

package/bin/types/store/LocalStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LocalStore.d.ts","sourceRoot":"","sources":["../../../src/types/store/LocalStore.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAElE,4BAA4B;AAC5B,MAAM,WAAW,sBAAsB;IACrC,oDAAoD;IACpD,KAAK,EAAE,UAAU,CAAC;IAClB,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,8BAA8B;AAC9B,MAAM,WAAW,wBAAwB;IACvC,oDAAoD;IACpD,KAAK,EAAE,UAAU,CAAC;IAClB,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qCAAqC;AACrC,MAAM,WAAW,+BAA+B;IAC9C,qDAAqD;IACrD,KAAK,EAAE,UAAU,CAAC;IAClB,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,2BAA2B,CAAC,EAAE,MAAM,CAAC;CACtC"}
+{"version":3,"file":"LocalStore.d.ts","sourceRoot":"","sources":["../../../src/types/store/LocalStore.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,8BAA8B;AAC9B,MAAM,WAAW,wBAAwB;IACvC,yBAAyB;IACzB,KAAK,EAAE,UAAU,CAAC;IAClB,2BAA2B;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,kCAAkC;AAClC,MAAM,WAAW,4BAA4B;IAC3C,yBAAyB;IACzB,KAAK,EAAE,UAAU,CAAC;IAClB,2BAA2B;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qCAAqC;AACrC,MAAM,WAAW,+BAA+B;IAC9C,yCAAyC;IACzC,KAAK,EAAE,UAAU,CAAC;IAClB,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,2BAA2B,CAAC,EAAE,MAAM,CAAC;CACtC"}

package/bin/types/store/LocalStore.js

@@ -2,8 +2,8 @@
  * 本地 Workspace Store 实现的构造类型。
  *
  * 关键点（中文）
- * - 本地 Store 只接收 Workspace 已创建的 FileSystem，不单独接收存储根目录。
- * - AgentStore 与 SessionStore 因而始终和 WorkspaceTools 使用同一资源容器。
+ * - 本地 Store 接收 AgentStorage 创建的私有 FileSystem 与存储根目录。
+ * - SessionStore 与 SessionDataStore 不复用项目 WorkspaceTools 的 FileSystem。
  */
 export {};
 //# sourceMappingURL=LocalStore.js.map

package/bin/types/store/SessionAttachmentStore.d.ts

@@ -4,9 +4,9 @@
  * Session Message 只保存附件引用，附件内容由该 Store 在 Session 生命周期内持有。
  *
  * 数据边界（中文）：
- * - 输入边界：`session.prompt()` 接收 `type: "file"`、`mediaType` 和 Data URL。
- * - 存储边界：Store 解码 Data URL，写入 `.downcity/.../attachments/att_<id>.<ext>`。
- * - Message 边界：Session Message 只记录相对 Workspace 根目录的附件路径。
+ * - 输入边界：`session.prompt()` 接收 `type: "file"`、`media_type` 和 Data URL。
+ * - 存储边界：Store 解码 Data URL，写入 Agent 私有附件目录。
+ * - Message 边界：Session Message 只记录附件的稳定绝对路径。
  * - 模型边界：模型转换器读取该路径，在内存中恢复成模型需要的文件内容。
  *
  * 因此，Data URL 不会直接进入 JSONL Message；Session Message 是附件路径的唯一引用。
@@ -14,7 +14,7 @@
 /** 可持久化的 Data URL 附件。 */
 export interface SessionAttachmentStore {
     /**
-     * 保存 Data URL，并返回相对 Workspace 根目录的稳定文件路径。
+     * 保存 Data URL，并返回 Agent 私有目录中的稳定绝对路径。
      * 调用成功后，返回路径对应的附件文件必须已经完整落盘。
      */
     persist_data_url(input: {

package/bin/types/store/SessionAttachmentStore.js

@@ -4,9 +4,9 @@
  * Session Message 只保存附件引用，附件内容由该 Store 在 Session 生命周期内持有。
  *
  * 数据边界（中文）：
- * - 输入边界：`session.prompt()` 接收 `type: "file"`、`mediaType` 和 Data URL。
- * - 存储边界：Store 解码 Data URL，写入 `.downcity/.../attachments/att_<id>.<ext>`。
- * - Message 边界：Session Message 只记录相对 Workspace 根目录的附件路径。
+ * - 输入边界：`session.prompt()` 接收 `type: "file"`、`media_type` 和 Data URL。
+ * - 存储边界：Store 解码 Data URL，写入 Agent 私有附件目录。
+ * - Message 边界：Session Message 只记录附件的稳定绝对路径。
  * - 模型边界：模型转换器读取该路径，在内存中恢复成模型需要的文件内容。
  *
  * 因此，Data URL 不会直接进入 JSONL Message；Session Message 是附件路径的唯一引用。

package/bin/types/store/SessionDataStore.d.ts

@@ -0,0 +1,85 @@
+/**
+ * 单个 Session 数据存储类型。
+ *
+ * 关键点（中文）
+ * - Session 领域只依赖这些持久化能力，不感知 JSONL、目录或文件名。
+ * - Message、Metadata 与 Instruction 共享同一个 Session 生命周期边界。
+ */
+import type { SessionHistoryMetaV1 } from "../../executor/types/SessionHistoryMeta.js";
+import type { SessionAssistantMessage, SessionMessage } from "../session/SessionMessage.js";
+import type { SessionMessageStorageStats, SessionSegmentRange, SessionSegmentSnapshot, SessionSegmentSummary } from "../session/SessionSegment.js";
+import type { SessionAttachmentStore } from "./SessionAttachmentStore.js";
+/** 在 Message Store 写事务中创建新消息所需的稳定状态。 */
+export interface SessionMessageCommitState {
+    /** 下一条真实 Message 应使用的全局线性顺序。 */
+    message_sequence: number;
+    /** 当前 Active 与 Assistant 草稿组成的运行态 Message。 */
+    messages: SessionMessage[];
+}
+/** Active Message 压缩提交参数。 */
+export interface CompactActiveMessagesInput {
+    /** 移入新 Segment 的最后一条真实 Message sequence。 */
+    through_sequence: number;
+    /** 写入新 Segment 末尾的累计上下文摘要。 */
+    summary: SessionSegmentSummary;
+}
+/** Active Message 压缩提交结果。 */
+export interface CompactActiveMessagesResult {
+    /** 本次创建的不可变历史分段。 */
+    segment: SessionSegmentSnapshot;
+    /** 压缩后继续保留在 Active 区域的 Message。 */
+    active_messages: SessionMessage[];
+}
+/** Session Message 持久化能力。 */
+export interface SessionMessageStore {
+    /** 初始化消息存储，并修复可恢复的中断状态。 */
+    initialize(): Promise<void>;
+    /** 读取当前 Active Message 与运行中的 Assistant 草稿。 */
+    list_messages(): Promise<SessionMessage[]>;
+    /** 读取指定 sequence 之前最近的完整历史分段。 */
+    read_segment_before(before_sequence: number): Promise<SessionSegmentSnapshot | null>;
+    /** 读取最新历史分段的累计摘要。 */
+    read_latest_summary(): Promise<SessionSegmentSummary | null>;
+    /** 读取当前 Session 的全部真实历史消息。 */
+    list_history_messages(): Promise<SessionMessage[]>;
+    /** 读取消息数量、存储大小与最新消息统计。 */
+    stats(): Promise<SessionMessageStorageStats>;
+    /** 判断指定 sequence 之前是否存在历史分段。 */
+    has_segment_before(before_sequence: number): Promise<boolean>;
+    /** 计算当前 Active Message 之前的读取边界。 */
+    active_before_sequence(messages: SessionMessage[]): Promise<number | undefined>;
+    /** 读取当前运行中的 Assistant 草稿。 */
+    read_assistant_message(): Promise<SessionAssistantMessage | null>;
+    /** 原子覆盖当前运行中的 Assistant 草稿。 */
+    write_assistant_message(message: SessionAssistantMessage): Promise<void>;
+    /** 在存储事务中创建唯一 Assistant 草稿。 */
+    create_assistant_message(build_message: (state: SessionMessageCommitState) => SessionAssistantMessage): Promise<SessionAssistantMessage>;
+    /** 在存储事务中追加一条 Message。 */
+    append_message(build_message: (state: SessionMessageCommitState) => SessionMessage): Promise<SessionMessage>;
+    /** 提交最终 Assistant Message 并删除运行中草稿。 */
+    finalize_assistant_message(message: SessionAssistantMessage): Promise<void>;
+    /** 将 Active 前缀压缩为不可变历史分段。 */
+    compact_active(input: CompactActiveMessagesInput): Promise<CompactActiveMessagesResult>;
+    /** 读取全部历史分段的 sequence 索引。 */
+    list_segment_ranges(): Promise<SessionSegmentRange[]>;
+}
+/** 单个 Session 的领域持久化视图。 */
+export interface SessionDataStore {
+    /** 当前 Session 的稳定标识。 */
+    readonly session_id: string;
+    /** 当前 Session 的 Message 持久化能力。 */
+    readonly messages: SessionMessageStore;
+    /** 当前 Session 的附件持久化能力。 */
+    readonly attachments: SessionAttachmentStore;
+    /** 读取 Session Metadata；不存在时返回规范化的初始值。 */
+    read_metadata(): Promise<SessionHistoryMetaV1>;
+    /** 原子写入完整 Session Metadata。 */
+    write_metadata(metadata: SessionHistoryMetaV1): Promise<void>;
+    /** 判断 Session 是否存在显式固化的完整 system。 */
+    has_instruction(): Promise<boolean>;
+    /** 读取显式固化的完整 system；不存在时返回 null。 */
+    read_instruction(): Promise<string | null>;
+    /** 原子写入显式固化的完整 system。 */
+    write_instruction(instruction: string): Promise<void>;
+}
+//# sourceMappingURL=SessionDataStore.d.ts.map

package/bin/types/store/SessionDataStore.d.ts.map

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

package/bin/types/store/SessionDataStore.js

@@ -0,0 +1,9 @@
+/**
+ * 单个 Session 数据存储类型。
+ *
+ * 关键点（中文）
+ * - Session 领域只依赖这些持久化能力，不感知 JSONL、目录或文件名。
+ * - Message、Metadata 与 Instruction 共享同一个 Session 生命周期边界。
+ */
+export {};
+//# sourceMappingURL=SessionDataStore.js.map

package/bin/types/store/SessionDataStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionDataStore.js","sourceRoot":"","sources":["../../../src/types/store/SessionDataStore.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/bin/types/store/SessionStore.d.ts

@@ -1,85 +1,31 @@
 /**
- * Session Store 类型。
+ * Session 集合存储类型。
  *
  * 关键点（中文）
- * - Session 领域只依赖这些持久化能力，不感知 JSONL、目录或文件名。
- * - Message、Metadata 与 Instruction 共享同一个 Session 生命周期边界。
+ * - AgentSessions 只通过该接口管理 Session 生命周期和索引。
+ * - 接口不暴露物理目录，避免 Session 领域重新依赖路径约定。
  */
-import type { SessionHistoryMetaV1 } from "../../executor/types/SessionHistoryMeta.js";
-import type { SessionAssistantMessage, SessionMessage } from "../../types/session/SessionMessage.js";
-import type { SessionMessageStorageStats, SessionSegmentRange, SessionSegmentSnapshot, SessionSegmentSummary } from "../../types/session/SessionSegment.js";
-import type { SessionAttachmentStore } from "../../types/store/SessionAttachmentStore.js";
-/** 在 Message Store 写事务中创建新消息所需的稳定状态。 */
-export interface SessionMessageCommitState {
-    /** 下一条真实 Message 应使用的全局线性顺序。 */
-    message_sequence: number;
-    /** 当前 Active 与 Assistant 草稿组成的运行态 Message。 */
-    messages: SessionMessage[];
-}
-/** Active Message 压缩提交参数。 */
-export interface CompactActiveMessagesInput {
-    /** 移入新 Segment 的最后一条真实 Message sequence。 */
-    through_sequence: number;
-    /** 写入新 Segment 末尾的累计上下文摘要。 */
-    summary: SessionSegmentSummary;
-}
-/** Active Message 压缩提交结果。 */
-export interface CompactActiveMessagesResult {
-    /** 本次创建的不可变历史分段。 */
-    segment: SessionSegmentSnapshot;
-    /** 压缩后继续保留在 Active 区域的 Message。 */
-    active_messages: SessionMessage[];
-}
-/** Session Message 持久化能力。 */
-export interface SessionMessageStore {
-    /** 初始化消息存储，并修复可恢复的中断状态。 */
-    initialize(): Promise<void>;
-    /** 读取当前 Active Message 与运行中的 Assistant 草稿。 */
-    list_messages(): Promise<SessionMessage[]>;
-    /** 读取指定 sequence 之前最近的完整历史分段。 */
-    read_segment_before(before_sequence: number): Promise<SessionSegmentSnapshot | null>;
-    /** 读取最新历史分段的累计摘要。 */
-    read_latest_summary(): Promise<SessionSegmentSummary | null>;
-    /** 读取当前 Session 的全部真实历史消息。 */
-    list_history_messages(): Promise<SessionMessage[]>;
-    /** 读取消息数量、存储大小与最新消息统计。 */
-    stats(): Promise<SessionMessageStorageStats>;
-    /** 判断指定 sequence 之前是否存在历史分段。 */
-    has_segment_before(before_sequence: number): Promise<boolean>;
-    /** 计算当前 Active Message 之前的读取边界。 */
-    active_before_sequence(messages: SessionMessage[]): Promise<number | undefined>;
-    /** 读取当前运行中的 Assistant 草稿。 */
-    read_assistant_message(): Promise<SessionAssistantMessage | null>;
-    /** 原子覆盖当前运行中的 Assistant 草稿。 */
-    write_assistant_message(message: SessionAssistantMessage): Promise<void>;
-    /** 在存储事务中创建唯一 Assistant 草稿。 */
-    create_assistant_message(build_message: (state: SessionMessageCommitState) => SessionAssistantMessage): Promise<SessionAssistantMessage>;
-    /** 在存储事务中追加一条 Message。 */
-    append_message(build_message: (state: SessionMessageCommitState) => SessionMessage): Promise<SessionMessage>;
-    /** 提交最终 Assistant Message 并删除运行中草稿。 */
-    finalize_assistant_message(message: SessionAssistantMessage): Promise<void>;
-    /** 将 Active 前缀压缩为不可变历史分段。 */
-    compact_active(input: CompactActiveMessagesInput): Promise<CompactActiveMessagesResult>;
-    /** 读取全部历史分段的 sequence 索引。 */
-    list_segment_ranges(): Promise<SessionSegmentRange[]>;
-}
-/** 单个 Session 的领域持久化视图。 */
+import type { AgentArchiveSessionResult, AgentArchiveSessionsInput, AgentArchiveSessionsResult, AgentCleanArchiveResult, AgentListSessionsInput, AgentSessionSummaryPage } from "../agent/SessionTypes.js";
+import type { SessionDataStore } from "./SessionDataStore.js";
+/** 一个 Agent 所属全部 Session 的持久化入口。 */
 export interface SessionStore {
-    /** 当前 Session 的稳定标识。 */
-    readonly session_id: string;
-    /** 当前 Session 的 Message 持久化能力。 */
-    readonly messages: SessionMessageStore;
-    /** 当前 Session 的附件持久化能力。 */
-    readonly attachments: SessionAttachmentStore;
-    /** 读取 Session Metadata；不存在时返回规范化的初始值。 */
-    read_metadata(): Promise<SessionHistoryMetaV1>;
-    /** 原子写入完整 Session Metadata。 */
-    write_metadata(metadata: SessionHistoryMetaV1): Promise<void>;
-    /** 判断 Session 是否存在显式固化的完整 system。 */
-    has_instruction(): Promise<boolean>;
-    /** 读取显式固化的完整 system；不存在时返回 null。 */
-    read_instruction(): Promise<string | null>;
-    /** 原子写入显式固化的完整 system。 */
-    write_instruction(instruction: string): Promise<void>;
+    /** 返回指定 Session 的稳定持久化视图。 */
+    session(session_id: string, workspace_id?: string): SessionDataStore;
+    /** 判断活动 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>;
+    /** 刷新并释放当前 Store 持有的资源。 */
+    dispose(): Promise<void>;
 }
 //# sourceMappingURL=SessionStore.d.ts.map

package/bin/types/store/SessionStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionStore.d.ts","sourceRoot":"","sources":["../../../src/types/store/SessionStore.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SessionStore.d.ts","sourceRoot":"","sources":["../../../src/types/store/SessionStore.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,yBAAyB,EACzB,yBAAyB,EACzB,0BAA0B,EAC1B,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAE1E,oCAAoC;AACpC,MAAM,WAAW,YAAY;IAC3B,6BAA6B;IAC7B,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAErE,yBAAyB;IACzB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAElD,8BAA8B;IAC9B,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAErD,iCAAiC;IACjC,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE7D,wBAAwB;IACxB,aAAa,CACX,KAAK,EAAE,sBAAsB,GAAG,SAAS,EACzC,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAAC,GACzC,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAEpC,2BAA2B;IAC3B,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAExE,yBAAyB;IACzB,sBAAsB,CACpB,KAAK,CAAC,EAAE,yBAAyB,GAChC,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAEvC,wBAAwB;IACxB,aAAa,IAAI,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAElD,2BAA2B;IAC3B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B"}

package/bin/types/store/SessionStore.js

@@ -1,9 +1,9 @@
 /**
- * Session Store 类型。
+ * Session 集合存储类型。
  *
  * 关键点（中文）
- * - Session 领域只依赖这些持久化能力，不感知 JSONL、目录或文件名。
- * - Message、Metadata 与 Instruction 共享同一个 Session 生命周期边界。
+ * - AgentSessions 只通过该接口管理 Session 生命周期和索引。
+ * - 接口不暴露物理目录，避免 Session 领域重新依赖路径约定。
  */
 export {};
 //# sourceMappingURL=SessionStore.js.map

package/bin/types/tools/ToolActionExecutionContext.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 普通 Tool 一次调用获得的最小执行上下文。
+ *
+ * 该类型只暴露业务 Tool 需要的调用身份、取消、Workspace 快照和可选
+ * Session Interaction，不暴露 SessionTurnContext、消息写入器或 Plugin lease。
+ */
+import type { SessionInteractionPort } from "../session/SessionInteraction.js";
+/** 普通 Tool 所属的 Session 范围。 */
+export interface ToolSessionExecutionScope {
+    /** 当前 Session 标识。 */
+    readonly session_id: string;
+    /** 当前 Turn 标识。 */
+    readonly turn_id: string;
+    /** 当前 Session 的用户交互端口；未启用 Interaction 时为空。 */
+    readonly interactions?: SessionInteractionPort;
+}
+/** 普通 Tool 的单次调用上下文。 */
+export interface ToolActionExecutionContext {
+    /** 当前 Tool Call 标识。 */
+    readonly call_id: string;
+    /** 当前 Tool 调用的取消信号。 */
+    readonly abort_signal: AbortSignal;
+    /** 当前 Tool 所属 Session 范围。 */
+    readonly session: ToolSessionExecutionScope;
+    /** 当前 Workspace 项目根目录。 */
+    readonly workspace_path?: string;
+    /** 当前 Step 已提交生效的 Workspace env。 */
+    readonly workspace_env?: Readonly<Record<string, string>>;
+}
+//# sourceMappingURL=ToolActionExecutionContext.d.ts.map

package/bin/types/tools/ToolActionExecutionContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolActionExecutionContext.d.ts","sourceRoot":"","sources":["../../../src/types/tools/ToolActionExecutionContext.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAEpF,8BAA8B;AAC9B,MAAM,WAAW,yBAAyB;IACxC,qBAAqB;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,kBAAkB;IAClB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,8CAA8C;IAC9C,QAAQ,CAAC,YAAY,CAAC,EAAE,sBAAsB,CAAC;CAChD;AAED,wBAAwB;AACxB,MAAM,WAAW,0BAA0B;IACzC,uBAAuB;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uBAAuB;IACvB,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC;IACnC,6BAA6B;IAC7B,QAAQ,CAAC,OAAO,EAAE,yBAAyB,CAAC;IAC5C,0BAA0B;IAC1B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,oCAAoC;IACpC,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC3D"}

package/bin/types/tools/ToolActionExecutionContext.js

@@ -0,0 +1,8 @@
+/**
+ * 普通 Tool 一次调用获得的最小执行上下文。
+ *
+ * 该类型只暴露业务 Tool 需要的调用身份、取消、Workspace 快照和可选
+ * Session Interaction，不暴露 SessionTurnContext、消息写入器或 Plugin lease。
+ */
+export {};
+//# sourceMappingURL=ToolActionExecutionContext.js.map

package/bin/types/tools/ToolActionExecutionContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolActionExecutionContext.js","sourceRoot":"","sources":["../../../src/types/tools/ToolActionExecutionContext.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/bin/types/tools/ask/AskQuestionsTool.d.ts

@@ -4,7 +4,7 @@
  * 该协议只描述模型发起问题和收到回答时可见的数据；Interaction 标识、Turn 标识与
  * 生命周期状态由 Session 运行时维护，不交给模型生成。
  */
-import type { SessionInteractionAnswer, SessionInteractionOption, SessionInteractionQuestion } from "../../../types/session/SessionInteraction.js";
+import type { SessionInteractionAnswer, SessionInteractionOption, SessionInteractionQuestion } from "../../session/SessionInteraction.js";
 /** 模型调用 ask_question 时提交的一条问题。 */
 export interface AskQuestionsToolQuestion {
     /** 向用户展示的完整问题文本。 */

package/bin/utils/logger/Logger.d.ts

@@ -6,7 +6,7 @@
  * - 结构化字段写入 JSONL，便于后续检索与审计。
  */
 import type { JsonObject } from "../../types/common/Json.js";
-import type { FileSystem } from "../../types/workspace/FileSystem.js";
+import type { FileSystem } from "@downcity/workspace";
 type LogDetails = {
     [key: string]: JsonObject[keyof JsonObject] | undefined;
 };
@@ -17,7 +17,8 @@ type LogDetails = {
  * - Provide a single logger interface usable by both:
  *   - system/runtime components (server, scheduler, tool executor, etc.)
  *   - agent/LLM execution (LLM request/response logging expects `logger.log(...)`)
- * - Persist logs as JSONL to `.downcity/logs/<YYYY-MM-DD>.jsonl` (one line per entry).
+ * - Persist logs as JSONL to the current Agent storage directory
+ *   (`logs/<YYYY-MM-DD>.jsonl`, one line per entry).
  * - Keep console output human-friendly, but make disk logs machine-friendly.
  *
  * Notes:
@@ -27,13 +28,15 @@ type LogDetails = {
  */
 export interface LogEntry {
     id: string;
+    /** 产生日志的 Agent 稳定标识。 */
+    agent_id?: string;
+    /** 产生日志的 Workspace 稳定标识。 */
+    workspace_id?: string;
     timestamp: string;
     type: "info" | "warn" | "error" | "debug" | "action";
     message: string;
     details?: JsonObject;
     duration?: number;
-    /** Back-compat: kept for older code that expects a `level` field. */
-    level?: string;
 }
 /**
  * Logger：项目级日志器。
@@ -48,6 +51,9 @@ export declare class Logger {
     private writeChain;
     private readonly maxInMemoryEntries;
     private workspace_files;
+    private storage_root_path;
+    private agent_id;
+    private workspace_id;
     constructor(logLevel?: string);
     /**
      * 绑定当前 logger 实例的 project_root。
@@ -55,11 +61,16 @@ export declare class Logger {
      * 关键点（中文）
      * - 每个 Agent / workspace 持有独立 Logger，绑定只影响当前实例。
      * - 落盘目录必须在实例初始化后明确指定。
-     * - 未绑定 project_root 时，只打印到 console，不写入 `.downcity/logs/*`。
+     * - 未绑定存储时，只打印到 console，不写入本地文件。
      */
     bind_project_root(project_root: string): void;
-    /** 绑定现有 Workspace FileSystem，避免创建第二套文件入口。 */
-    bind_workspace(files: FileSystem): void;
+    /** 绑定 Agent 内部存储，避免日志写入项目目录。 */
+    bind_storage(files: FileSystem, storage_root_path: string, owner?: {
+        /** 当前 Agent 的稳定标识。 */
+        agent_id: string;
+        /** 当前 Workspace 的稳定标识。 */
+        workspace_id: string;
+    }): void;
     /**
      * Generic async logger used by agent / LLM logging.
      * Accepts `info|warn|error|debug|action` (case-insensitive).
@@ -79,7 +90,7 @@ export declare class Logger {
     private printLog;
     /**
      * 落盘算法（中文）
-     * - 日志按自然日分片：`.downcity/logs/YYYY-MM-DD.jsonl`。
+     * - 日志按自然日分片：`<workspace-data>/logs/YYYY-MM-DD.jsonl`。
      * - 每条日志一行 JSON，便于 grep / 流式消费。
      */
     private saveToFile;
@@ -95,7 +106,8 @@ export declare class Logger {
  *
  * 说明（中文）
  * - 每次调用都返回独立实例，避免不同 Agent / workspace 互相覆盖落盘目录。
- * - 提供 project_root 时立即绑定日志目录；未提供时仅输出到 console。
+ * - 提供 project_root 时绑定项目目录（独立 Logger 用法）；Session
+ *   运行时应使用 `bind_storage` 将日志写入私有数据目录。
  */
 export declare function get_logger(project_root?: string, log_level?: string): Logger;
 export {};

package/bin/utils/logger/Logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../../src/utils/logger/Logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAGlE,KAAK,UAAU,GAAG;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,UAAU,CAAC,GAAG,SAAS,CAAC;CACzD,CAAC;AA+IF;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,IAAI,CAAkB;IAC9B,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAQ;IAC3C,OAAO,CAAC,eAAe,CAA2B;gBAEtC,QAAQ,GAAE,MAAe;IAIrC;;;;;;;OAOG;IACH,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAK7C,6CAA6C;IAC7C,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAIvC;;;OAGG;IACG,GAAG,CACP,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,UAAU,GACnB,OAAO,CAAC,IAAI,CAAC;IAKhB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIlD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIlD,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAInD,OAAO,CAAC,aAAa;IAWrB;;;OAGG;YACW,IAAI;IA2BlB,OAAO,CAAC,QAAQ;IA2BhB;;;;OAIG;YACW,UAAU;IAUxB,OAAO,CAAC,WAAW;IAIb,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpC,QAAQ,IAAI,QAAQ,EAAE;IAItB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,QAAQ,EAAE;IAIpD,eAAe,CAAC,KAAK,GAAE,MAAW,GAAG,QAAQ,EAAE;IAI/C,UAAU,IAAI,IAAI;CAGnB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAK5E"}
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../../src/utils/logger/Logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGtD,KAAK,UAAU,GAAG;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,UAAU,CAAC,GAAG,SAAS,CAAC;CACzD,CAAC;AA+IF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,IAAI,CAAkB;IAC9B,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAQ;IAC3C,OAAO,CAAC,eAAe,CAA2B;IAClD,OAAO,CAAC,iBAAiB,CAAM;IAC/B,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,YAAY,CAAM;gBAEd,QAAQ,GAAE,MAAe;IAIrC;;;;;;;OAOG;IACH,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAM7C,gCAAgC;IAChC,YAAY,CACV,KAAK,EAAE,UAAU,EACjB,iBAAiB,EAAE,MAAM,EACzB,KAAK,CAAC,EAAE;QACN,sBAAsB;QACtB,QAAQ,EAAE,MAAM,CAAC;QACjB,0BAA0B;QAC1B,YAAY,EAAE,MAAM,CAAC;KACtB,GACA,IAAI;IAOP;;;OAGG;IACG,GAAG,CACP,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,UAAU,GACnB,OAAO,CAAC,IAAI,CAAC;IAKhB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIlD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIlD,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAInD,OAAO,CAAC,aAAa;IAWrB;;;OAGG;YACW,IAAI;IA4BlB,OAAO,CAAC,QAAQ;IA2BhB;;;;OAIG;YACW,UAAU;IAUxB,OAAO,CAAC,WAAW;IAIb,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpC,QAAQ,IAAI,QAAQ,EAAE;IAItB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,QAAQ,EAAE;IAIpD,eAAe,CAAC,KAAK,GAAE,MAAW,GAAG,QAAQ,EAAE;IAI/C,UAAU,IAAI,IAAI;CAGnB;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAK5E"}

package/bin/utils/logger/Logger.js

@@ -6,8 +6,8 @@
  * - 结构化字段写入 JSONL，便于后续检索与审计。
  */
 import { get_logs_dir_path } from "../../workspace/WorkspacePaths.js";
-import { get_timestamp } from "../../utils/Time.js";
-import { LocalFileSystem } from "../../workspace/LocalFileSystem.js";
+import { get_timestamp } from "../Time.js";
+import { LocalFileSystem } from "@downcity/workspace";
 const ANSI_RESET = "\x1b[0m";
 const ANSI_BOLD = "\x1b[1m";
 const TASK_BRACKET_COLOR = "\x1b[95m"; // bright magenta
@@ -157,6 +157,9 @@ export class Logger {
     writeChain = Promise.resolve();
     maxInMemoryEntries = 2000;
     workspace_files = null;
+    storage_root_path = "";
+    agent_id = "";
+    workspace_id = "";
     constructor(logLevel = "info") {
         this.logLevel = logLevel;
     }
@@ -166,15 +169,19 @@ export class Logger {
      * 关键点（中文）
      * - 每个 Agent / workspace 持有独立 Logger，绑定只影响当前实例。
      * - 落盘目录必须在实例初始化后明确指定。
-     * - 未绑定 project_root 时，只打印到 console，不写入 `.downcity/logs/*`。
+     * - 未绑定存储时，只打印到 console，不写入本地文件。
      */
     bind_project_root(project_root) {
         const root = String(project_root || "").trim();
         this.workspace_files = root ? new LocalFileSystem(root) : null;
+        this.storage_root_path = root;
     }
-    /** 绑定现有 Workspace FileSystem，避免创建第二套文件入口。 */
-    bind_workspace(files) {
+    /** 绑定 Agent 内部存储，避免日志写入项目目录。 */
+    bind_storage(files, storage_root_path, owner) {
         this.workspace_files = files;
+        this.storage_root_path = String(storage_root_path || "").trim();
+        this.agent_id = String(owner?.agent_id || "").trim();
+        this.workspace_id = String(owner?.workspace_id || "").trim();
     }
     /**
      * Generic async logger used by agent / LLM logging.
@@ -220,11 +227,12 @@ export class Logger {
     async emit(type, message, details) {
         const entry = {
             id: this.generate_id(),
+            ...(this.agent_id ? { agent_id: this.agent_id } : {}),
+            ...(this.workspace_id ? { workspace_id: this.workspace_id } : {}),
             timestamp: get_timestamp(),
             type,
             message: normalizeToAllowedMessageLabels(message),
             details: normalizeLogDetails(details),
-            level: type,
         };
         this.logs.push(entry);
         if (this.logs.length > this.maxInMemoryEntries) {
@@ -264,13 +272,13 @@ export class Logger {
     }
     /**
      * 落盘算法（中文）
-     * - 日志按自然日分片：`.downcity/logs/YYYY-MM-DD.jsonl`。
+     * - 日志按自然日分片：`<workspace-data>/logs/YYYY-MM-DD.jsonl`。
      * - 每条日志一行 JSON，便于 grep / 流式消费。
      */
     async saveToFile(entry) {
         if (!this.workspace_files)
             return;
-        const logsDir = get_logs_dir_path(this.workspace_files.root_path);
+        const logsDir = get_logs_dir_path(this.storage_root_path);
         const date = String(entry.timestamp || "").slice(0, 10) || new Date().toISOString().slice(0, 10);
         const logFile = this.workspace_files.resolve_path(logsDir, `${date}.jsonl`);
         const logLine = JSON.stringify(entry) + "\n";
@@ -300,7 +308,8 @@ export class Logger {
  *
  * 说明（中文）
  * - 每次调用都返回独立实例，避免不同 Agent / workspace 互相覆盖落盘目录。
- * - 提供 project_root 时立即绑定日志目录；未提供时仅输出到 console。
+ * - 提供 project_root 时绑定项目目录（独立 Logger 用法）；Session
+ *   运行时应使用 `bind_storage` 将日志写入私有数据目录。
  */
 export function get_logger(project_root, log_level) {
     const logger = new Logger(log_level);