@downcity/agent 1.1.430 → 1.1.438

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

@@ -6,13 +6,12 @@
  * - 不暴露具体 Session class，也不包含 Session 集合管理能力。
  */
 import type { ModelClient } from "@downcity/type";
-import type { SessionAssistantResultPart, SessionPromptPart } from "@downcity/type";
+import type { SessionAgentContent, SessionUserContent, SessionMessage } from "@downcity/type";
 import type { SessionExecutor } from "../../types/session/SessionExecution.js";
 import type { AgentSessionPromptInput } from "../../types/sdk/AgentSessionPrompt.js";
 import type { AgentSessionStopResult } from "../../types/sdk/AgentSessionStop.js";
 import type { AgentSessionTurnHandle } from "../../types/sdk/AgentSessionTurn.js";
 import type { SessionMutationSubscriber, SessionMutationUnsubscribe } from "@downcity/type";
-import type { SessionContextSnapshot } from "../../types/session/SessionSegment.js";
 /**
  * 单个 Session 实例端口。
  */
@@ -23,8 +22,8 @@ export interface SessionPort {
     get_model(): ModelClient | undefined;
     /** 获取当前 Session 的执行端口。 */
     get_executor(): SessionExecutor;
-    /** 读取当前 Session 的累计 Summary 与 Active Message 快照。 */
-    context(): Promise<SessionContextSnapshot>;
+    /** 读取全部 canonical Session Message。 */
+    messages(): Promise<SessionMessage[]>;
     /** 向当前 Session actor 追加一条新的 prompt。 */
     prompt(input: AgentSessionPromptInput): Promise<AgentSessionTurnHandle>;
     /** 停止当前 turn，并取消尚未被吸收的排队 prompt。 */
@@ -36,16 +35,16 @@ export interface SessionPort {
      */
     append_user_message(params: {
         /** 已构造好的 User 内容。 */
-        parts?: SessionPromptPart[];
+        parts?: SessionUserContent[];
         /** 未传入结构化内容时使用的文本。 */
         text?: string;
     }): Promise<void>;
     /**
-     * 追加一条 assistant 消息。
+     * 追加一条 Agent 消息。
      */
-    append_assistant_message(params: {
-        /** 已构造好的 Assistant 内容。 */
-        parts?: SessionAssistantResultPart[];
+    append_agent_message(params: {
+        /** 已构造好的 Agent 内容。 */
+        parts?: SessionAgentContent[];
         /** 未传入结构化内容时使用的文本。 */
         text?: string;
     }): Promise<void>;

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

@@ -1 +1 @@
-{"version":3,"file":"SessionPort.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionPort.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EACV,0BAA0B,EAC1B,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,KAAK,EACV,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uBAAuB;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,kCAAkC;IAClC,SAAS,IAAI,WAAW,GAAG,SAAS,CAAC;IAErC,0BAA0B;IAC1B,YAAY,IAAI,eAAe,CAAC;IAEhC,oDAAoD;IACpD,OAAO,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAE3C,uCAAuC;IACvC,MAAM,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAExE,oCAAoC;IACpC,IAAI,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAExC,oCAAoC;IACpC,SAAS,CAAC,UAAU,EAAE,yBAAyB,GAAG,0BAA0B,CAAC;IAE7E;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE;QAC1B,qBAAqB;QACrB,KAAK,CAAC,EAAE,iBAAiB,EAAE,CAAC;QAC5B,sBAAsB;QACtB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElB;;OAEG;IACH,wBAAwB,CAAC,MAAM,EAAE;QAC/B,0BAA0B;QAC1B,KAAK,CAAC,EAAE,0BAA0B,EAAE,CAAC;QACrC,sBAAsB;QACtB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElB,2BAA2B;IAC3B,YAAY,IAAI,OAAO,CAAC;CACzB"}
+{"version":3,"file":"SessionPort.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionPort.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,KAAK,EACV,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,gBAAgB,CAAC;AAExB;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uBAAuB;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,kCAAkC;IAClC,SAAS,IAAI,WAAW,GAAG,SAAS,CAAC;IAErC,0BAA0B;IAC1B,YAAY,IAAI,eAAe,CAAC;IAEhC,sCAAsC;IACtC,QAAQ,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAEtC,uCAAuC;IACvC,MAAM,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAExE,oCAAoC;IACpC,IAAI,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAExC,oCAAoC;IACpC,SAAS,CAAC,UAAU,EAAE,yBAAyB,GAAG,0BAA0B,CAAC;IAE7E;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE;QAC1B,qBAAqB;QACrB,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;QAC7B,sBAAsB;QACtB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElB;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE;QAC3B,sBAAsB;QACtB,KAAK,CAAC,EAAE,mBAAmB,EAAE,CAAC;QAC9B,sBAAsB;QACtB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElB,2BAA2B;IAC3B,YAAY,IAAI,OAAO,CAAC;CACzB"}

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

@@ -4,11 +4,10 @@
  * 这些类型只描述 Session 配置和 Metadata 状态，不承载 Message 行为。
  */
 import type { ModelClient } from "@downcity/type";
-import type { SessionMessages } from "../../session/SessionMessages.js";
 import type { SessionLocalState } from "../../types/session/SessionLocalState.js";
 import type { SessionMutation } from "@downcity/type";
 import type { Logger } from "../../utils/logger/Logger.js";
-import type { SessionDataStore } from "../../types/store/SessionDataStore.js";
+import type { SessionStorage } from "../../types/store/SessionStorage.js";
 import type { SessionOrigin } from "@downcity/type";
 /** SessionState 构造参数。 */
 export interface SessionStateOptions {
@@ -19,9 +18,7 @@ export interface SessionStateOptions {
     /** 当前 Session 的创建来源。 */
     origin: SessionOrigin;
     /** 当前 Session 独享的领域持久化视图。 */
-    store: SessionDataStore;
-    /** 当前 Session 的 canonical Message 入口。 */
-    messages: SessionMessages;
+    store: SessionStorage;
     /** 当前 Session 的可变内存状态。 */
     state: SessionLocalState;
     /** 当前 Session 的运行日志器。 */

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,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,yBAAyB;AACzB,MAAM,WAAW,mBAAmB;IAClC,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,MAAM,EAAE,aAAa,CAAC;IACtB,6BAA6B;IAC7B,KAAK,EAAE,gBAAgB,CAAC;IACxB,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,WAAW,GAAG,SAAS,CAAC;IACzC,+BAA+B;IAC/B,aAAa,EAAE,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,CAAC;CACpD"}
+{"version":3,"file":"SessionState.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionState.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,yBAAyB;AACzB,MAAM,WAAW,mBAAmB;IAClC,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,MAAM,EAAE,aAAa,CAAC;IACtB,6BAA6B;IAC7B,KAAK,EAAE,cAAc,CAAC;IACtB,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,WAAW,GAAG,SAAS,CAAC;IACzC,+BAA+B;IAC/B,aAAa,EAAE,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,CAAC;CACpD"}

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

@@ -4,6 +4,7 @@
  * 该类型只描述默认 Composer 组装 system block 所需的只读输入。
  */
 import type { AgentSessionSystemBlock } from "../../types/agent/SessionTypes.js";
+import type { SessionHookContext, SessionHookRuntime, SessionHookScopeRuntime } from "@downcity/type";
 /** 默认 Session System Block 的组装参数。 */
 export interface BuildSessionSystemBlocksInput {
     /** 当前 Agent 的稳定标识。 */
@@ -23,4 +24,17 @@ export interface BuildSessionSystemBlocksInput {
     /** 读取当前 Session Plugin 的 System Block。 */
     get_plugin_system_blocks: () => Promise<AgentSessionSystemBlock[]>;
 }
+/** 解析 Plugin system blocks 所需的稳定执行输入。 */
+export interface ResolveSessionPluginSystemBlocksInput {
+    /** 当前 Session 的稳定标识。 */
+    session_id: string;
+    /** 当前 Turn 的稳定标识；控制面预览等非 Turn 调用允许为空。 */
+    turn_id?: string;
+    /** 当前调用捕获的 Hook runtime 或 Step scope。 */
+    hooks: SessionHookRuntime | SessionHookScopeRuntime;
+    /** 向 Plugin 暴露的只读 Session 上下文。 */
+    context: SessionHookContext;
+    /** Plugin system 解析失败后的可选降级观测入口。 */
+    on_error?: (error: unknown) => void | Promise<void>;
+}
 //# sourceMappingURL=SessionSystem.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"SessionSystem.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionSystem.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAE7E,qCAAqC;AACrC,MAAM,WAAW,6BAA6B;IAC5C,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,6BAA6B,EAAE,MAAM,uBAAuB,EAAE,CAAC;IAC/D,wCAAwC;IACxC,gCAAgC,EAAE,MAAM,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAC3E,0CAA0C;IAC1C,wBAAwB,EAAE,MAAM,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;CACpE"}
+{"version":3,"file":"SessionSystem.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionSystem.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACxB,MAAM,gBAAgB,CAAC;AAExB,qCAAqC;AACrC,MAAM,WAAW,6BAA6B;IAC5C,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,6BAA6B,EAAE,MAAM,uBAAuB,EAAE,CAAC;IAC/D,wCAAwC;IACxC,gCAAgC,EAAE,MAAM,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAC3E,0CAA0C;IAC1C,wBAAwB,EAAE,MAAM,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;CACpE;AAED,yCAAyC;AACzC,MAAM,WAAW,qCAAqC;IACpD,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,KAAK,EAAE,kBAAkB,GAAG,uBAAuB,CAAC;IACpD,kCAAkC;IAClC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,oCAAoC;IACpC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD"}

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

@@ -3,13 +3,13 @@
  *
  * 这些类型描述 Tool 生命周期协调器与 Recorder 之间的稳定边界。
  */
-import type { SessionAssistantToolPart } from "@downcity/type";
+import type { SessionAgentToolPart } from "@downcity/type";
 /** 当前流式 Assistant 中的 Tool Part 定位结果。 */
 export interface SessionStreamingToolLocation {
     /** Tool Part 所属 Assistant Message。 */
     message_id: string;
     /** 当前 Tool Part 完整快照。 */
-    part: SessionAssistantToolPart;
+    part: SessionAgentToolPart;
 }
 /** Executor 在调用 Tool 实现前提交的完整输入。 */
 export interface SessionToolInputReady {

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,gBAAgB,CAAC;AAE/D,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"}
+{"version":3,"file":"SessionTool.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionTool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,wCAAwC;AACxC,MAAM,WAAW,4BAA4B;IAC3C,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,IAAI,EAAE,oBAAoB,CAAC;CAC5B;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/session/SessionTurnCompletion.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Session Turn 收口领域函数的依赖类型。
+ *
+ * 这些依赖只覆盖 canonical Message、Mutation、Hook 与资源释放，不包含 Queue 或
+ * Executor，避免 Turn 结果提交反向理解调度过程。
+ */
+import type { SessionEventHub } from "../../session/runtime/SessionEventHub.js";
+import type { SessionMessages } from "../../session/SessionMessages.js";
+import type { Logger } from "../../utils/logger/Logger.js";
+/** Turn 收口函数的稳定依赖。 */
+export interface SessionTurnCompletionOptions {
+    /** 当前 Session 的稳定标识。 */
+    session_id: string;
+    /** 当前 Session 的 canonical Message 入口。 */
+    messages: SessionMessages;
+    /** 当前 Session 的 Mutation 发布入口。 */
+    events: SessionEventHub;
+    /** 当前 Session 的统一日志器。 */
+    logger: Logger;
+    /** Turn 停止时对外使用的稳定错误文本。 */
+    stopped_message: string;
+}
+//# sourceMappingURL=SessionTurnCompletion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SessionTurnCompletion.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionTurnCompletion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAEvD,sBAAsB;AACtB,MAAM,WAAW,4BAA4B;IAC3C,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,QAAQ,EAAE,eAAe,CAAC;IAC1B,kCAAkC;IAClC,MAAM,EAAE,eAAe,CAAC;IACxB,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,eAAe,EAAE,MAAM,CAAC;CACzB"}

package/bin/types/session/SessionTurnCompletion.js

@@ -0,0 +1,8 @@
+/**
+ * Session Turn 收口领域函数的依赖类型。
+ *
+ * 这些依赖只覆盖 canonical Message、Mutation、Hook 与资源释放，不包含 Queue 或
+ * Executor，避免 Turn 结果提交反向理解调度过程。
+ */
+export {};
+//# sourceMappingURL=SessionTurnCompletion.js.map

package/bin/types/session/SessionTurnCompletion.js.map

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

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

@@ -0,0 +1,42 @@
+/**
+ * Session Turn 文件修改观测函数的依赖类型。
+ *
+ * 文件 Diff 是辅助观测结果，不参与模型或 Tool 的成功判定；这些类型显式限制它只能
+ * 读取 Turn effects、写入 Assistant 输出并发布摘要 Mutation。
+ */
+import type { RuntimeToolEffect } from "@downcity/type";
+import type { SessionAssistantOutput } from "../../types/executor/SessionAssistantOutput.js";
+import type { SessionTurnContext } from "../../types/executor/SessionTurnContext.js";
+import type { SessionMutation } from "@downcity/type";
+import type { Logger } from "../../utils/logger/Logger.js";
+/** 持久化 Turn 最终文件 Diff 的输入。 */
+export interface AppendSessionTurnFileDiffInput {
+    /** 当前 Session 的稳定标识。 */
+    session_id: string;
+    /** 当前 Turn 的稳定标识。 */
+    turn_id: string;
+    /** 当前 Workspace 的绝对根路径。 */
+    workspace_path: string;
+    /** 当前 Turn 持有的 effects 与生命周期上下文。 */
+    turn_context: SessionTurnContext;
+    /** 当前 Turn 的 canonical Assistant 输出端口。 */
+    assistant_output: SessionAssistantOutput;
+    /** 当前 Session 的统一日志器。 */
+    logger: Logger;
+}
+/** 发布 Turn 实时文件 Diff 摘要的输入。 */
+export interface PublishSessionTurnFileDiffInput {
+    /** 当前 Session 的稳定标识。 */
+    session_id: string;
+    /** 当前 Turn 的稳定标识。 */
+    turn_id: string;
+    /** 当前 Workspace 的绝对根路径。 */
+    workspace_path: string;
+    /** 当前检查点已经发生的 Tool effects。 */
+    effects: readonly RuntimeToolEffect[];
+    /** 发布公开 Session Mutation 的函数。 */
+    publish: (mutation: SessionMutation) => void;
+    /** 当前 Session 的统一日志器。 */
+    logger: Logger;
+}
+//# sourceMappingURL=SessionTurnFileDiff.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SessionTurnFileDiff.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionTurnFileDiff.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AACzF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAEvD,8BAA8B;AAC9B,MAAM,WAAW,8BAA8B;IAC7C,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,YAAY,EAAE,kBAAkB,CAAC;IACjC,0CAA0C;IAC1C,gBAAgB,EAAE,sBAAsB,CAAC;IACzC,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,+BAA+B;AAC/B,MAAM,WAAW,+BAA+B;IAC9C,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,+BAA+B;IAC/B,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACtC,iCAAiC;IACjC,OAAO,EAAE,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,CAAC;IAC7C,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/bin/types/session/SessionTurnFileDiff.js

@@ -0,0 +1,8 @@
+/**
+ * Session Turn 文件修改观测函数的依赖类型。
+ *
+ * 文件 Diff 是辅助观测结果，不参与模型或 Tool 的成功判定；这些类型显式限制它只能
+ * 读取 Turn effects、写入 Assistant 输出并发布摘要 Mutation。
+ */
+export {};
+//# sourceMappingURL=SessionTurnFileDiff.js.map

package/bin/types/session/SessionTurnFileDiff.js.map

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

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

@@ -3,9 +3,9 @@
  *
  * 关键点（中文）
  * - 本地 Store 接收 AgentStorage 创建的私有 FileSystem 与存储根目录。
- * - SessionStore 与 SessionDataStore 不复用项目 WorkspaceTools 的 FileSystem。
+ * - SessionStore 与 SessionStorage 不复用项目 WorkspaceTools 的 FileSystem。
  */
-import type { FileSystem } from "@downcity/type";
+import type { FileSystem, StorageDatabaseLocation } from "@downcity/type";
 import type { SessionOrigin } from "@downcity/type";
 /** LocalSessionStore 构造参数。 */
 export interface LocalSessionStoreOptions {
@@ -15,6 +15,8 @@ export interface LocalSessionStoreOptions {
     storage_root_path: string;
     /** 当前 Session 查询视图所属 Agent 的稳定标识。 */
     agent_id: string;
+    /** Session 数据库使用本地文件还是进程内存。 */
+    database_location: StorageDatabaseLocation;
     /** 当前 Workspace 的稳定标识。 */
     workspace_id?: string;
 }
@@ -26,6 +28,8 @@ export interface LocalSessionDataStoreOptions {
     storage_root_path: string;
     /** 当前 Session 所属 Agent 的稳定标识。 */
     agent_id: string;
+    /** 当前 Session 数据库使用本地文件还是进程内存。 */
+    database_location: StorageDatabaseLocation;
     /** 当前 Session 所属 Workspace 的稳定标识。 */
     workspace_id?: string;
     /** 当前 Session 的稳定标识。 */
@@ -33,15 +37,4 @@ export interface LocalSessionDataStoreOptions {
     /** 当前 Session 的创建来源与物理存储分区。 */
     origin: SessionOrigin;
 }
-/** JsonlSessionMessageStore 构造参数。 */
-export interface JsonlSessionMessageStoreOptions {
-    /** 当前 Message Store 使用的 Agent 私有文件能力。 */
-    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

@@ -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,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,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;IACnB,+BAA+B;IAC/B,MAAM,EAAE,aAAa,CAAC;CACvB;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"}
+{"version":3,"file":"LocalStore.d.ts","sourceRoot":"","sources":["../../../src/types/store/LocalStore.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,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,+BAA+B;IAC/B,iBAAiB,EAAE,uBAAuB,CAAC;IAC3C,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,kCAAkC;IAClC,iBAAiB,EAAE,uBAAuB,CAAC;IAC3C,qCAAqC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,MAAM,EAAE,aAAa,CAAC;CACvB"}

package/bin/types/store/LocalStore.js

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - 本地 Store 接收 AgentStorage 创建的私有 FileSystem 与存储根目录。
- * - SessionStore 与 SessionDataStore 不复用项目 WorkspaceTools 的 FileSystem。
+ * - SessionStore 与 SessionStorage 不复用项目 WorkspaceTools 的 FileSystem。
  */
 export {};
 //# sourceMappingURL=LocalStore.js.map

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

@@ -0,0 +1,103 @@
+/**
+ * 单个 Session 的结构化存储协议。
+ *
+ * SessionStorage 是 Session 状态、Message 聚合和 Composer 派生数据的统一事务边界。
+ * 领域调用方不感知 SQLite 表、文件路径或连接实现。
+ */
+import type { SessionHistoryMeta } from "../../executor/types/SessionHistoryMeta.js";
+import type { SessionAgentMessage, SessionAgentMessagePart, SessionMessage, SessionOrigin, SessionUserMessage, SessionUserMessagePart } from "@downcity/type";
+import type { SessionAttachmentStore } from "../../types/store/SessionAttachmentStore.js";
+/** 在 Message 创建事务中提供的稳定状态。 */
+export interface SessionMessageCreateState {
+    /** 新 Message 应使用的全局线性顺序。 */
+    message_sequence: number;
+}
+/** Message 定向更新事务。 */
+export interface SessionMessageUpdate {
+    /** 更新后的完整领域快照；Storage 只写 envelope 与明确列出的 Part。 */
+    message: SessionMessage;
+    /** 调用方读取快照时的 revision，用于拒绝并发覆盖。 */
+    expected_revision: number;
+    /** 本次新增或内容发生变化的 Part；每项必须属于 message。 */
+    changed_parts: Array<SessionUserMessagePart | SessionAgentMessagePart>;
+}
+/** Session Message 持久化统计。 */
+export interface SessionMessageStorageStats {
+    /** 当前 Session 中的真实 Message 数量。 */
+    message_count: number;
+    /** 当前数据库文件占用字节数；内存数据库返回零。 */
+    storage_bytes: number;
+    /** 当前最新 Message；空 Session 时为空。 */
+    latest_message: SessionMessage | null;
+}
+/** Composer Policy SQL 参数允许的 SQLite 标量。 */
+export type SessionStorageValue = string | number | bigint | Uint8Array | null;
+/** Composer Policy 专属派生表的受限事务。 */
+export interface SessionComposerStorageTransaction {
+    /** 执行一条不返回数据的派生 SQL。 */
+    execute(sql: string, parameters?: readonly SessionStorageValue[]): void;
+    /** 读取第一条派生数据；没有匹配时返回空。 */
+    get<TRow>(sql: string, parameters?: readonly SessionStorageValue[]): TRow | null;
+    /** 读取全部匹配的派生数据。 */
+    all<TRow>(sql: string, parameters?: readonly SessionStorageValue[]): TRow[];
+}
+/** Composer 对 canonical history 和专属派生表的存储视图。 */
+export interface SessionComposerStorage {
+    /** 按 sequence 升序读取全部 canonical Message 聚合。 */
+    list_messages(): Promise<SessionMessage[]>;
+    /** 在短事务中操作当前 Policy 的派生表。 */
+    transaction<T>(operation: (transaction: SessionComposerStorageTransaction) => T): Promise<T>;
+}
+/** 单个 Session 的结构化持久化能力。 */
+export interface SessionStorage {
+    /** 当前 Session 的稳定标识。 */
+    readonly session_id: string;
+    /** 当前 Session 的不可变创建来源。 */
+    readonly origin: SessionOrigin;
+    /** 当前 Session 的附件存储。 */
+    readonly attachments: SessionAttachmentStore;
+    /** 初始化 schema 并校验 Session 身份。 */
+    initialize(): Promise<void>;
+    /** 读取当前 Session 状态。 */
+    read_metadata(): Promise<SessionHistoryMeta>;
+    /** 原子覆盖当前 Session configured 状态。 */
+    write_metadata(metadata: SessionHistoryMeta): Promise<void>;
+    /** 判断 Session 是否存在显式 system snapshot。 */
+    has_instruction(): Promise<boolean>;
+    /** 读取显式 system snapshot。 */
+    read_instruction(): Promise<string | null>;
+    /** 原子写入显式 system snapshot。 */
+    write_instruction(instruction: string): Promise<void>;
+    /** 读取全部 canonical Message 聚合。 */
+    list_messages(): Promise<SessionMessage[]>;
+    /** 读取指定 Message。 */
+    read_message(message_id: string): Promise<SessionMessage | null>;
+    /** 读取最早的 canonical User Message；空 Session 返回 null。 */
+    read_first_user_message(): Promise<SessionUserMessage | null>;
+    /** 在事务中分配 sequence 并创建 Message。 */
+    create_message(build_message: (state: SessionMessageCreateState) => SessionMessage): Promise<SessionMessage>;
+    /** 原子提交 Message envelope 和明确发生变化的 Part。 */
+    update_message(input: SessionMessageUpdate): Promise<void>;
+    /** 按 Message sequence 向前分页。 */
+    list_message_page(input?: {
+        /** 返回该 sequence 之前的 Message。 */
+        before_sequence?: number;
+        /** 单页最大 Message 数量。 */
+        limit?: number;
+        /** 是否包含只供运行时消费的内部 Message。 */
+        include_internal?: boolean;
+    }): Promise<SessionMessage[]>;
+    /** 读取需要由 SessionMessages 收口的非终态 Agent Message。 */
+    list_recoverable_agent_messages(): Promise<SessionAgentMessage[]>;
+    /** 读取指定 Turn 的最后一条 Agent Message。 */
+    read_latest_agent_message(turn_id?: string): Promise<SessionAgentMessage | null>;
+    /** 读取 Message 统计。 */
+    message_stats(): Promise<SessionMessageStorageStats>;
+    /** 清空 canonical Message 与依赖它们的派生数据。 */
+    clear_messages(): Promise<void>;
+    /** 返回当前 Composer Policy 的派生存储视图。 */
+    composer_storage(namespace: string): SessionComposerStorage;
+    /** 关闭数据库连接。 */
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=SessionStorage.d.ts.map

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

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

package/bin/types/store/SessionStorage.js

@@ -0,0 +1,8 @@
+/**
+ * 单个 Session 的结构化存储协议。
+ *
+ * SessionStorage 是 Session 状态、Message 聚合和 Composer 派生数据的统一事务边界。
+ * 领域调用方不感知 SQLite 表、文件路径或连接实现。
+ */
+export {};
+//# sourceMappingURL=SessionStorage.js.map

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

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

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

@@ -6,12 +6,14 @@
  * - 接口不暴露物理目录，避免 Session 领域重新依赖路径约定。
  */
 import type { AgentArchiveSessionResult, AgentArchiveSessionsInput, AgentArchiveSessionsResult, AgentCleanArchiveResult, AgentListSessionsInput, AgentSessionSummaryPage } from "../../types/agent/SessionTypes.js";
-import type { SessionDataStore } from "../../types/store/SessionDataStore.js";
+import type { SessionStorage } from "../../types/store/SessionStorage.js";
 import type { SessionOrigin } from "@downcity/type";
 /** 一个 Agent 所属全部 Session 的持久化入口。 */
 export interface SessionStore {
-    /** 返回指定 Session 的稳定持久化视图。 */
-    session(session_id: string, origin: SessionOrigin, workspace_id?: string): SessionDataStore;
+    /** 为一个新 Session 创建稳定持久化视图；完整来源只在创建时由调用方提供。 */
+    create_session(session_id: string, origin: SessionOrigin, workspace_id?: string): SessionStorage;
+    /** 打开一个已有 Session；完整来源必须从数据库状态恢复。 */
+    open_session(session_id: string, origin_type?: string): Promise<SessionStorage>;
     /** 判断活动 Session 是否存在。 */
     has_session(session_id: string, origin_type?: string): Promise<boolean>;
     /** 永久删除活动 Session 的全部领域数据。 */

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":"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;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,oCAAoC;AACpC,MAAM,WAAW,YAAY;IAC3B,6BAA6B;IAC7B,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAE5F,yBAAyB;IACzB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAExE,8BAA8B;IAC9B,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3E,iCAAiC;IACjC,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEnF,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,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAE9F,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"}
+{"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,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,oCAAoC;AACpC,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC;IAEjG,qCAAqC;IACrC,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAEhF,yBAAyB;IACzB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAExE,8BAA8B;IAC9B,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3E,iCAAiC;IACjC,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEnF,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,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAE9F,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@downcity/agent",
-  "version": "1.1.430",
+  "version": "1.1.438",
   "type": "module",
   "description": "Downcity 单 Agent SDK 与执行运行时",
   "main": "./bin/index.js",
@@ -24,7 +24,7 @@
     }
   },
   "dependencies": {
-    "@downcity/type": "0.1.210",
+    "@downcity/type": "0.1.214",
     "diff": "^8.0.4",
     "fs-extra": "^11.3.5",
     "js-yaml": "^4.1.1",