@downcity/agent 1.1.287 → 1.1.310

package/bin/types/session/SessionState.d.ts

@@ -7,16 +7,16 @@ import type { LanguageModel } from "ai";
 import type { SessionMessages } from "../../session/SessionMessages.js";
 import type { SessionLocalState } from "../../types/session/SessionLocalState.js";
 import type { SessionMutation } from "../../types/session/SessionMutation.js";
-import type { SessionQueueCommand } from "../../types/session/SessionQueue.js";
 import type { Logger } from "../../utils/logger/Logger.js";
+import type { SessionStore } from "../../types/store/SessionStore.js";
 /** SessionState 构造参数。 */
 export interface SessionStateOptions {
     /** 当前 Agent 的稳定标识。 */
     agent_id: string;
-    /** 当前项目的绝对根目录。 */
-    project_root: string;
     /** 当前 Session 的稳定标识。 */
     session_id: string;
+    /** 当前 Session 独享的领域持久化视图。 */
+    store: SessionStore;
     /** 当前 Session 的 canonical Message 入口。 */
     messages: SessionMessages;
     /** 当前 Session 的可变内存状态。 */
@@ -30,14 +30,4 @@ export interface SessionStateOptions {
     /** 发布 Session Mutation 的函数。 */
     publish_event: (mutation: SessionMutation) => void;
 }
-/** Session 配置写入选项。 */
-export interface SessionSetOptions {
-    /** 是否为本次配置变化生成 Model Switching Action。 */
-    emit_action?: boolean;
-}
-/** Session 配置成功写入后的队列提交结果。 */
-export interface SessionConfiguredCommandResult {
-    /** 等待在下一 Session Step 检查点执行的 Command。 */
-    command?: SessionQueueCommand;
-}
 //# sourceMappingURL=SessionState.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"SessionState.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionState.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAEvD,yBAAyB;AACzB,MAAM,WAAW,mBAAmB;IAClC,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,QAAQ,EAAE,eAAe,CAAC;IAC1B,0BAA0B;IAC1B,KAAK,EAAE,iBAAiB,CAAC;IACzB,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,sBAAsB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,qCAAqC;IACrC,SAAS,EAAE,MAAM,aAAa,GAAG,SAAS,CAAC;IAC3C,+BAA+B;IAC/B,aAAa,EAAE,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,CAAC;CACpD;AAED,sBAAsB;AACtB,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,8BAA8B;AAC9B,MAAM,WAAW,8BAA8B;IAC7C,yCAAyC;IACzC,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B"}
+{"version":3,"file":"SessionState.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionState.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE,yBAAyB;AACzB,MAAM,WAAW,mBAAmB;IAClC,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,KAAK,EAAE,YAAY,CAAC;IACpB,yCAAyC;IACzC,QAAQ,EAAE,eAAe,CAAC;IAC1B,0BAA0B;IAC1B,KAAK,EAAE,iBAAiB,CAAC;IACzB,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,sBAAsB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,qCAAqC;IACrC,SAAS,EAAE,MAAM,aAAa,GAAG,SAAS,CAAC;IAC3C,+BAA+B;IAC/B,aAAa,EAAE,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,CAAC;CACpD"}

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

@@ -0,0 +1,31 @@
+/**
+ * Agent Store 类型。
+ *
+ * 关键点（中文）
+ * - AgentSessions 只通过该接口管理 Session 生命周期和索引。
+ * - 接口不暴露物理目录，避免 Session 领域重新依赖路径约定。
+ */
+import type { AgentArchiveSessionResult, AgentArchiveSessionsInput, AgentArchiveSessionsResult, AgentCleanArchiveResult, AgentListSessionsInput, AgentSessionSummaryPage } from "../../types/agent/SessionTypes.js";
+import type { SessionStore } from "../../types/store/SessionStore.js";
+/** Agent 领域持久化入口。 */
+export interface AgentStore {
+    /** 返回指定 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>;
+    /** 刷新并释放当前 Store 持有的资源。 */
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=AgentStore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AgentStore.d.ts","sourceRoot":"","sources":["../../../src/types/store/AgentStore.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,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE,qBAAqB;AACrB,MAAM,WAAW,UAAU;IACzB,6BAA6B;IAC7B,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,CAAC;IAE1C,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/AgentStore.js

@@ -0,0 +1,9 @@
+/**
+ * Agent Store 类型。
+ *
+ * 关键点（中文）
+ * - AgentSessions 只通过该接口管理 Session 生命周期和索引。
+ * - 接口不暴露物理目录，避免 Session 领域重新依赖路径约定。
+ */
+export {};
+//# sourceMappingURL=AgentStore.js.map

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

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

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

@@ -0,0 +1,36 @@
+/**
+ * 本地 Workspace Store 实现的构造类型。
+ *
+ * 关键点（中文）
+ * - 本地 Store 只接收 Workspace 已创建的 FileSystem，不单独接收存储根目录。
+ * - AgentStore 与 SessionStore 因而始终和 WorkspaceTools 使用同一资源容器。
+ */
+import type { FileSystem } from "../../types/workspace/FileSystem.js";
+/** LocalAgentStore 构造参数。 */
+export interface LocalAgentStoreOptions {
+    /** 当前 Store 与 WorkspaceTools 共用的 Workspace 文件能力。 */
+    files: FileSystem;
+    /** 当前 Agent 的稳定标识，用于划分 `.downcity/agents` 子目录。 */
+    agent_id: string;
+}
+/** LocalSessionStore 构造参数。 */
+export interface LocalSessionStoreOptions {
+    /** 当前 Store 与 WorkspaceTools 共用的 Workspace 文件能力。 */
+    files: FileSystem;
+    /** 当前 Session 所属 Agent 的稳定标识。 */
+    agent_id: string;
+    /** 当前 Session 的稳定标识。 */
+    session_id: string;
+}
+/** JsonlSessionMessageStore 构造参数。 */
+export interface JsonlSessionMessageStoreOptions {
+    /** 当前 Message Store 与 Session 共用的 Workspace 文件能力。 */
+    files: FileSystem;
+    /** 当前 Session 的稳定标识。 */
+    session_id: string;
+    /** Active JSONL 文件的绝对路径。 */
+    file_path: string;
+    /** Assistant 运行中快照的可选绝对路径。 */
+    assistant_message_file_path?: string;
+}
+//# sourceMappingURL=LocalStore.d.ts.map

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

@@ -0,0 +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"}

package/bin/types/store/LocalStore.js

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

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

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

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

@@ -0,0 +1,82 @@
+/**
+ * Session Store 类型。
+ *
+ * 关键点（中文）
+ * - Session 领域只依赖这些持久化能力，不感知 JSONL、目录或文件名。
+ * - Message、Metadata 与 Instruction 共享同一个 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";
+/** 在 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 SessionStore {
+    /** 当前 Session 的稳定标识。 */
+    readonly session_id: string;
+    /** 当前 Session 的 Message 持久化能力。 */
+    readonly messages: SessionMessageStore;
+    /** 读取 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=SessionStore.d.ts.map

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

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

package/bin/types/store/SessionStore.js

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

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

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

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

@@ -0,0 +1,22 @@
+/**
+ * ask_question Tool 的输入与输出协议。
+ *
+ * 该协议只描述模型发起问题和收到回答时可见的数据；Interaction 标识、Turn 标识与
+ * 生命周期状态由 Session 运行时维护，不交给模型生成。
+ */
+import type { SessionInteractionAnswer, SessionInteractionQuestion } from "../../../types/session/SessionInteraction.js";
+/** 模型调用 ask_question 时提交的结构化输入。 */
+export interface AskQuestionsToolInput {
+    /** 问题卡片向用户展示的简短标题。 */
+    title: string;
+    /** 本次需要用户完整回答的一到多条问题。 */
+    questions: SessionInteractionQuestion[];
+}
+/** 用户完成回答后返回给模型的结构化 Tool Result。 */
+export interface AskQuestionsToolOutput {
+    /** 当前提问已由用户完整回答。 */
+    status: "resolved";
+    /** 按 question_id 关联的完整回答集合。 */
+    answers: SessionInteractionAnswer[];
+}
+//# sourceMappingURL=AskQuestionsTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AskQuestionsTool.d.ts","sourceRoot":"","sources":["../../../../src/types/tools/ask/AskQuestionsTool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,wBAAwB,EACxB,0BAA0B,EAC3B,MAAM,uCAAuC,CAAC;AAE/C,mCAAmC;AACnC,MAAM,WAAW,qBAAqB;IACpC,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,SAAS,EAAE,0BAA0B,EAAE,CAAC;CACzC;AAED,oCAAoC;AACpC,MAAM,WAAW,sBAAsB;IACrC,oBAAoB;IACpB,MAAM,EAAE,UAAU,CAAC;IACnB,+BAA+B;IAC/B,OAAO,EAAE,wBAAwB,EAAE,CAAC;CACrC"}

package/bin/types/tools/ask/AskQuestionsTool.js

@@ -0,0 +1,8 @@
+/**
+ * ask_question Tool 的输入与输出协议。
+ *
+ * 该协议只描述模型发起问题和收到回答时可见的数据；Interaction 标识、Turn 标识与
+ * 生命周期状态由 Session 运行时维护，不交给模型生成。
+ */
+export {};
+//# sourceMappingURL=AskQuestionsTool.js.map

package/bin/types/tools/ask/AskQuestionsTool.js.map

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

package/bin/types/workspace/FileSystem.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Workspace 文件系统类型。
+ *
+ * 关键点（中文）
+ * - 文件与搜索共享同一个已解析项目根目录。
+ * - WorkspaceTools 与 AgentStore 共用这一文件能力，不建立额外存储根目录。
+ */
+import type { FileToolActionRequest, FileToolActionResult } from "../../types/workspace/FileTool.js";
+import type { SearchToolActionRequest, SearchToolActionResult } from "../../types/workspace/SearchTool.js";
+/** Workspace 目录中的稳定条目摘要。 */
+export interface WorkspaceDirectoryEntry {
+    /** 当前条目的原始文件名。 */
+    name: string;
+    /** 当前条目是否为普通目录。 */
+    is_directory: boolean;
+    /** 当前条目是否为普通文件。 */
+    is_file: boolean;
+}
+/** Workspace 内统一的文件与搜索能力。 */
+export interface FileSystem {
+    /** 已解析且不可变的项目根目录。 */
+    readonly root_path: string;
+    /** 将 Workspace 内的相对路径片段解析为本地绝对路径。 */
+    resolve_path(...segments: string[]): string;
+    /** 判断 Workspace 内的文件或目录是否存在。 */
+    path_exists(file_path: string): Promise<boolean>;
+    /** 读取 Workspace 内文件的完整字节内容。 */
+    read_file(file_path: string): Promise<Buffer>;
+    /** 读取 Workspace 内普通文件的字节大小。 */
+    file_size(file_path: string): Promise<number>;
+    /** 创建 Workspace 内目录及缺失的父目录。 */
+    ensure_directory(directory_path: string): Promise<void>;
+    /** 删除 Workspace 内文件或目录；目标不存在时视为成功。 */
+    remove_path(target_path: string): Promise<void>;
+    /** 原子移动 Workspace 内的文件或目录，不覆盖已有目标。 */
+    move_path(source_path: string, target_path: string): Promise<void>;
+    /** 读取 Workspace 内目录的直接子条目。 */
+    read_directory(directory_path: string): Promise<WorkspaceDirectoryEntry[]>;
+    /** 原子创建或覆盖 Workspace 内的完整文件内容。 */
+    write_file_atomically(file_path: string, content: string | Buffer): Promise<void>;
+    /** 向 Workspace 文件末尾追加完整字节内容。 */
+    append_file(file_path: string, content: string | Buffer): Promise<void>;
+    /**
+     * 使用 Workspace 内的独占锁串行执行文件事务。
+     *
+     * @param lock_path 锁文件路径；调用完成后由 FileSystem 自动释放。
+     * @param action 获得锁后执行的事务；异常会原样向调用方抛出。
+     */
+    with_file_lock<T>(lock_path: string, action: () => Promise<T>): Promise<T>;
+    /** 执行一次受项目根目录限制的结构化文件操作。 */
+    run_file_action(request: FileToolActionRequest): Promise<FileToolActionResult>;
+    /** 执行一次受项目根目录限制的结构化搜索操作。 */
+    run_search_action(request: SearchToolActionRequest): Promise<SearchToolActionResult>;
+}
+//# sourceMappingURL=FileSystem.d.ts.map

package/bin/types/workspace/FileSystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileSystem.d.ts","sourceRoot":"","sources":["../../../src/types/workspace/FileSystem.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,iCAAiC,CAAC;AAEzC,4BAA4B;AAC5B,MAAM,WAAW,uBAAuB;IACtC,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,mBAAmB;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,6BAA6B;AAC7B,MAAM,WAAW,UAAU;IACzB,qBAAqB;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,qCAAqC;IACrC,YAAY,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAE5C,gCAAgC;IAChC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjD,+BAA+B;IAC/B,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE9C,+BAA+B;IAC/B,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE9C,+BAA+B;IAC/B,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExD,sCAAsC;IACtC,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD,sCAAsC;IACtC,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnE,8BAA8B;IAC9B,cAAc,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAE3E,kCAAkC;IAClC,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElF,gCAAgC;IAChC,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExE;;;;;OAKG;IACH,cAAc,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAE3E,4BAA4B;IAC5B,eAAe,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAE/E,4BAA4B;IAC5B,iBAAiB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACtF"}

package/bin/types/workspace/FileSystem.js

@@ -0,0 +1,9 @@
+/**
+ * Workspace 文件系统类型。
+ *
+ * 关键点（中文）
+ * - 文件与搜索共享同一个已解析项目根目录。
+ * - WorkspaceTools 与 AgentStore 共用这一文件能力，不建立额外存储根目录。
+ */
+export {};
+//# sourceMappingURL=FileSystem.js.map

package/bin/types/workspace/FileSystem.js.map

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

package/bin/types/workspace/FileTool.d.ts

@@ -0,0 +1,181 @@
+/**
+ * 文件工具公开类型。
+ *
+ * 关键点（中文）
+ * - 文件工具由 Workspace 持有，与 Shell/PTY action 分离。
+ * - 所有模型可见字段统一使用 snake_case。
+ * - 成功与失败均返回结构化结果，避免依赖异常文本判断执行状态。
+ */
+import type { Tool } from "ai";
+/** 文件工具支持的结构化错误码。 */
+export type FileToolErrorCode = "invalid_path" | "sandbox_denied" | "file_not_found" | "not_a_file" | "permission_denied" | "file_exists" | "file_too_large" | "content_too_large" | "line_too_large" | "encoding_error" | "binary_file" | "no_edits" | "too_many_edits" | "duplicate_match" | "not_found" | "overlapping_edits" | "edit_too_large" | "file_changed" | "internal_error";
+/** 文件读取工具输入。 */
+export interface ReadFileToolInput {
+    /** 要读取的项目内相对路径或绝对路径。 */
+    file_path: string;
+    /** 从第几行开始读取，使用 0-based 行号。 */
+    offset?: number;
+    /** 本次最多返回的行数。 */
+    limit?: number;
+}
+/** 文件写入工具输入。 */
+export interface WriteFileToolInput {
+    /** 要创建或覆盖的项目内相对路径或绝对路径。 */
+    file_path: string;
+    /** 要写入的 UTF-8 文本内容。 */
+    content: string;
+    /** 文件存在时是否允许覆盖，默认不允许。 */
+    overwrite?: boolean;
+}
+/** 单项精确文本编辑。 */
+export interface FileEditOperation {
+    /** 必须在原文件中唯一匹配的原始文本。 */
+    old_text: string;
+    /** 用于替换唯一匹配区域的新文本。 */
+    new_text: string;
+}
+/** 文件编辑工具输入。 */
+export interface EditFileToolInput {
+    /** 要编辑的项目内相对路径或绝对路径。 */
+    file_path: string;
+    /** 一次原子应用的精确文本编辑列表。 */
+    edits: FileEditOperation[];
+    /** 可选的读取时 SHA-256；文件变化后拒绝编辑。 */
+    expected_sha256?: string;
+}
+/** 文件工具统一失败结果。 */
+export interface FileToolFailure {
+    /** 表示本次文件操作失败。 */
+    success: false;
+    /** 供模型和调用方稳定解析的错误码。 */
+    error_code: FileToolErrorCode;
+    /** 面向模型和日志的人类可读错误信息。 */
+    message: string;
+    /** 已完成解析时的目标绝对路径。 */
+    file_path?: string;
+    /** 编辑失败时每项匹配的详细结果。 */
+    details?: FileEditDetail[];
+}
+/** 文件读取成功结果。 */
+export interface ReadFileToolSuccess {
+    /** 表示本次文件读取成功。 */
+    success: true;
+    /** 解析并校验后的目标绝对路径。 */
+    file_path: string;
+    /** 原始文件总字节数。 */
+    total_bytes: number;
+    /** 文本文件总行数；图片和其他二进制文件固定为 0。 */
+    total_lines: number;
+    /** 本次返回内容的 0-based 起始行。 */
+    start_line: number;
+    /** 本次返回内容的 0-based 结束行；没有返回行时小于 start_line。 */
+    end_line: number;
+    /** 返回给模型的文本内容；图片和其他二进制文件为空字符串。 */
+    content: string;
+    /** 是否还有后续文本行未返回。 */
+    truncated: boolean;
+    /** 有后续文本时建议下一次使用的 offset。 */
+    next_offset?: number;
+    /** 当前文件被识别为文本、图片还是其他二进制文件。 */
+    type: "text" | "image" | "binary";
+    /** 当前文件的 MIME 类型。 */
+    mime_type?: string;
+    /** 文本文件实际采用的解码格式。 */
+    encoding?: "utf-8" | "utf-16le" | "utf-16be";
+    /** 原始文件内容的 SHA-256，可传给 edit 防止并发覆盖。 */
+    sha256: string;
+}
+/** 文件写入成功结果。 */
+export interface WriteFileToolSuccess {
+    /** 表示本次文件写入成功。 */
+    success: true;
+    /** 解析并校验后的目标绝对路径。 */
+    file_path: string;
+    /** 实际写入的 UTF-8 字节数。 */
+    bytes_written: number;
+    /** 实际写入的文本行数。 */
+    lines_written: number;
+    /** 本次操作是否覆盖了已有文件。 */
+    overwritten: boolean;
+    /** 写入完成后的 ISO 时间戳。 */
+    timestamp: string;
+    /** 写入后文件内容的 SHA-256。 */
+    sha256: string;
+}
+/** 单项编辑匹配详情。 */
+export interface FileEditDetail {
+    /** 当前编辑项的原始索引。 */
+    index: number;
+    /** 当前编辑项的匹配与应用状态。 */
+    status: "applied" | "not_found" | "duplicate";
+    /** 当前 old_text 在原文件中的匹配次数。 */
+    match_count: number;
+    /** 唯一匹配成功时的 0-based 起始行。 */
+    line_start?: number;
+}
+/** 文件编辑成功结果。 */
+export interface EditFileToolSuccess {
+    /** 表示全部编辑已原子应用。 */
+    success: true;
+    /** 解析并校验后的目标绝对路径。 */
+    file_path: string;
+    /** 成功应用的编辑数量。 */
+    applied: number;
+    /** 每项编辑的匹配与应用详情。 */
+    details: FileEditDetail[];
+    /** 编辑后文件的总行数。 */
+    new_total_lines: number;
+    /** 编辑前文件内容的 SHA-256。 */
+    previous_sha256: string;
+    /** 编辑后文件内容的 SHA-256。 */
+    sha256: string;
+}
+/** 文件读取工具结果。 */
+export type ReadFileToolResult = ReadFileToolSuccess | FileToolFailure;
+/** 文件写入工具结果。 */
+export type WriteFileToolResult = WriteFileToolSuccess | FileToolFailure;
+/** 文件编辑工具结果。 */
+export type EditFileToolResult = EditFileToolSuccess | FileToolFailure;
+/** 文件工具内部 action 名称。 */
+export type FileToolAction = "read" | "write" | "edit";
+/** 文件 action 的判别式请求。 */
+export type FileToolActionRequest = {
+    /** 指定执行文件读取。 */
+    action: "read";
+    /** 文件读取输入。 */
+    input: ReadFileToolInput;
+} | {
+    /** 指定执行文件写入。 */
+    action: "write";
+    /** 文件写入输入。 */
+    input: WriteFileToolInput;
+} | {
+    /** 指定执行文件编辑。 */
+    action: "edit";
+    /** 文件编辑输入。 */
+    input: EditFileToolInput;
+};
+/** 文件 action 的统一结果。 */
+export type FileToolActionResult = ReadFileToolResult | WriteFileToolResult | EditFileToolResult;
+/** 文件工具运行器协议。 */
+export interface FileToolRunner {
+    /** 执行一个独立文件 action。 */
+    run_file_action(request: FileToolActionRequest): Promise<FileToolActionResult>;
+}
+/** `@downcity/shell` 对模型暴露的文件工具集合。 */
+export interface FileToolSet {
+    /** 分页读取文本并识别二进制文件。 */
+    read: Tool;
+    /** 创建或显式覆盖 UTF-8 文本文件。 */
+    write: Tool;
+    /** 通过唯一文本匹配原子编辑单个文件。 */
+    edit: Tool;
+}
+/** 已通过项目根目录约束的文件工具路径。 */
+export interface ResolvedFileToolPath {
+    /** 解析后的目标绝对路径。 */
+    file_path: string;
+    /** 解析后的项目根目录绝对路径。 */
+    root_path: string;
+}
+//# sourceMappingURL=FileTool.d.ts.map

package/bin/types/workspace/FileTool.d.ts.map

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

package/bin/types/workspace/FileTool.js

@@ -0,0 +1,10 @@
+/**
+ * 文件工具公开类型。
+ *
+ * 关键点（中文）
+ * - 文件工具由 Workspace 持有，与 Shell/PTY action 分离。
+ * - 所有模型可见字段统一使用 snake_case。
+ * - 成功与失败均返回结构化结果，避免依赖异常文本判断执行状态。
+ */
+export {};
+//# sourceMappingURL=FileTool.js.map

package/bin/types/workspace/FileTool.js.map

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