@downcity/agent 1.1.287 → 1.1.310

package/bin/types/agent/AgentOptions.d.ts

@@ -6,15 +6,15 @@
  * - RemoteAgent 与 Session 数据结构拆到独立类型文件。
  */
 import type { Tool } from "ai";
-import type { Shell } from "@downcity/shell";
 import type { AgentModel } from "../../agent/AgentModel.js";
+import type { Workspace } from "../../workspace/Workspace.js";
 import type { Plugin } from "../../types/plugin/PluginDefinition.js";
 import type { AgentManagedSession, SessionOptions } from "../../types/session/SessionOptions.js";
 /**
  * Agent 可使用的 Session 类。
  *
  * 关键点（中文）
- * - 传 class，而不是传实例，保证 Agent 可以按 sessionId 创建多个 session。
+ * - 传 class，而不是传实例，保证 Agent 可以按 session_id 创建多个 session。
  * - 自定义类可继承默认 `Session`，并在构造函数里注入自己的 Composer。
  */
 export type AgentSessionConstructor = new (options: SessionOptions) => AgentManagedSession;
@@ -26,28 +26,27 @@ export interface AgentOptions {
      * 当前 agent 的稳定标识。
      *
      * 关键点（中文）
-     * - 用于 `.downcity/agents/<agentId>/...` 目录分区。
+     * - 用于 `.downcity/agents/<agent_id>/...` 目录分区。
      * - 应保持稳定、可 URL 编码、尽量不要依赖展示名称。
      */
     id: string;
-    /** 当前 agent 绑定的项目根目录。 */
-    path: string;
     /**
-     * 当前 agent 默认可用的工具集合。
+     * 当前 Agent 可以访问的项目资源与安全边界。
      *
      * 关键点（中文）
-     * - tools 归属于 agent 级，而不是 session 级。
-     * - session 运行时会直接复用这份工具集合。
+     * - Workspace 统一持有项目根目录、文件/搜索能力与可选 Shell。
+     * - 每个 Workspace 实例只能绑定一个 Agent，并由 Agent dispose 统一释放。
+     * - 多个 Agent 可以指向同一物理目录，但必须分别创建 Workspace 实例。
      */
-    tools?: Record<string, Tool>;
+    workspace: Workspace;
     /**
-     * 当前 agent 内建 shell 能力。
+     * 当前 agent 默认可用的工具集合。
      *
      * 关键点（中文）
-     * - Shell 不是 plugin，而是 agent 直接挂载的内建工具对象。
-     * - 未传入时，Agent 不会自动注入 shell tools。
+     * - tools 归属于 agent 级，而不是 session 级。
+     * - session 运行时会直接复用这份工具集合。
      */
-    shell?: Shell;
+    tools?: Record<string, Tool>;
     /**
      * 调用方显式传入的静态基础指令。
      *
@@ -83,15 +82,6 @@ export interface AgentOptions {
      * - 如果需要自定义 Composer，请在自定义 Session 类内部传给 `super({ composer })`。
      * - 该能力仅适用于本地 `Agent`。
      */
-    Session?: AgentSessionConstructor;
-    /**
-     * 当前 agent 的显式环境变量覆盖项。
-     *
-     * 关键点（中文）
-     * - 这里表示宿主显式注入给 agent 的基础 env。
-     * - `Agent` 会在这份基础 env 之上继续叠加项目 `.env`。
-     * - 覆盖后的最终值会成为 Agent 运行时 env，但不会回写到宿主环境。
-     */
-    env?: Record<string, string>;
+    session_class?: AgentSessionConstructor;
 }
 //# sourceMappingURL=AgentOptions.d.ts.map

package/bin/types/agent/AgentOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentOptions.d.ts","sourceRoot":"","sources":["../../../src/types/agent/AgentOptions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EACf,MAAM,mCAAmC,CAAC;AAE3C;;;;;;GAMG;AACH,MAAM,MAAM,uBAAuB,GAAG,KACpC,OAAO,EAAE,cAAc,KACpB,mBAAmB,CAAC;AAEzB;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;OAMG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE7B;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IAEd;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAEhC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;IAEnB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAElC;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAE9B"}
+{"version":3,"file":"AgentOptions.d.ts","sourceRoot":"","sources":["../../../src/types/agent/AgentOptions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EACf,MAAM,mCAAmC,CAAC;AAE3C;;;;;;GAMG;AACH,MAAM,MAAM,uBAAuB,GAAG,KACpC,OAAO,EAAE,cAAc,KACpB,mBAAmB,CAAC;AAEzB;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;OAMG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;;;;;OAOG;IACH,SAAS,EAAE,SAAS,CAAC;IAErB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE7B;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAEhC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;IAEnB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,uBAAuB,CAAC;CAEzC"}

package/bin/types/agent/AgentState.d.ts

@@ -2,27 +2,18 @@
  * AgentState 内部装配参数。
  *
  * 职责说明（中文）
- * - 只描述 AgentState 连接 PluginRegistry、Session、tools 与 Shell 所需的稳定引用。
- * - 这些对象都由 Agent 先完成创建，AgentState 只负责运行时连接和生命周期。
+ * - 只描述 AgentState 启动 PluginRegistry 长期运行时所需的稳定引用。
+ * - 工具注册与 Session 同步由 Agent 负责，AgentState 只负责生命周期。
  */
-import type { Tool } from "ai";
-import type { Shell } from "@downcity/shell";
-import type { AgentSessions } from "../../agent/AgentSessions.js";
 import type { PluginRegistry } from "../../plugin/core/PluginRegistry.js";
-import type { AgentContext } from "../../agent/AgentContext.js";
+import type { PluginContext } from "../../types/plugin/PluginContext.js";
 /**
  * AgentState 构造参数。
  */
 export interface AgentStateOptions {
     /** 当前 Agent 共用的执行上下文。 */
-    context: AgentContext;
+    context: PluginContext;
     /** 当前 Agent 唯一的 PluginRegistry 实例。 */
     plugins: PluginRegistry;
-    /** 当前 Agent 唯一的 Session 集合。 */
-    sessions: AgentSessions;
-    /** 当前 Agent 与 Session 共享的可变工具集合。 */
-    tools: Record<string, Tool>;
-    /** 当前 Agent 持有的可选 Shell 实例。 */
-    shell?: Shell;
 }
 //# sourceMappingURL=AgentState.d.ts.map

package/bin/types/agent/AgentState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentState.d.ts","sourceRoot":"","sources":["../../../src/types/agent/AgentState.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,OAAO,EAAE,YAAY,CAAC;IAEtB,sCAAsC;IACtC,OAAO,EAAE,cAAc,CAAC;IAExB,+BAA+B;IAC/B,QAAQ,EAAE,aAAa,CAAC;IAExB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE5B,+BAA+B;IAC/B,KAAK,CAAC,EAAE,KAAK,CAAC;CACf"}
+{"version":3,"file":"AgentState.d.ts","sourceRoot":"","sources":["../../../src/types/agent/AgentState.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,OAAO,EAAE,aAAa,CAAC;IAEvB,sCAAsC;IACtC,OAAO,EAAE,cAAc,CAAC;CAEzB"}

package/bin/types/agent/AgentState.js

@@ -2,8 +2,8 @@
  * AgentState 内部装配参数。
  *
  * 职责说明（中文）
- * - 只描述 AgentState 连接 PluginRegistry、Session、tools 与 Shell 所需的稳定引用。
- * - 这些对象都由 Agent 先完成创建，AgentState 只负责运行时连接和生命周期。
+ * - 只描述 AgentState 启动 PluginRegistry 长期运行时所需的稳定引用。
+ * - 工具注册与 Session 同步由 Agent 负责，AgentState 只负责生命周期。
  */
 export {};
 //# sourceMappingURL=AgentState.js.map

package/bin/types/agent/RemoteAgentPluginAction.d.ts

@@ -37,10 +37,10 @@ export type RemoteAgentPluginActionResult = PluginActionResult<JsonValue> & {
     /**
      * Runtime 回传的 plugin 名称。
      */
-    pluginName?: string;
+    plugin_name?: string;
     /**
      * Runtime 回传的 action 名称。
      */
-    actionName?: string;
+    action_name?: string;
 };
 //# sourceMappingURL=RemoteAgentPluginAction.d.ts.map

package/bin/types/agent/RemoteAgentPluginAction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RemoteAgentPluginAction.d.ts","sourceRoot":"","sources":["../../../src/types/agent/RemoteAgentPluginAction.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,6BAA6B,GACvC,kBAAkB,CAAC,SAAS,CAAC,GAAG;IAC9B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC"}
+{"version":3,"file":"RemoteAgentPluginAction.d.ts","sourceRoot":"","sources":["../../../src/types/agent/RemoteAgentPluginAction.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,6BAA6B,GACvC,kBAAkB,CAAC,SAAS,CAAC,GAAG;IAC9B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC"}

package/bin/types/agent/SessionActor.d.ts

@@ -5,12 +5,13 @@
  * - 这里只描述 session 的可调用能力。
  * - session 的数据结构、history/system payload 放在 `SessionTypes.ts`。
  */
-import type { AgentCreateSessionInput, AgentArchiveSessionInput, AgentArchiveSessionsInput, AgentArchiveSessionResult, AgentArchiveSessionsResult, AgentCleanArchiveResult, AgentListSessionsInput, AgentSessionConfigSnapshot, AgentSessionForkInput, AgentSessionInfo, AgentSessionSetInput, AgentSessionSummaryPage, AgentSessionSystemSnapshot } from "../../types/agent/SessionTypes.js";
+import type { AgentCreateSessionInput, AgentArchiveSessionInput, AgentArchiveSessionsInput, AgentArchiveSessionResult, AgentArchiveSessionsResult, AgentCleanArchiveResult, AgentListSessionsInput, AgentSessionConfigSnapshot, AgentSessionForkInput, AgentSessionInfo, AgentSessionSetInput, AgentSessionStatus, AgentSessionSummaryPage, AgentSessionSystemSnapshot, RemoteSessionSetInput } from "../../types/agent/SessionTypes.js";
 import type { SessionMutationSubscriber, SessionMutationUnsubscribe } from "../../types/session/SessionMutation.js";
-import type { ResolveSessionApprovalInput, SessionApproval, SessionApprovalModeSnapshot, SessionApprovalResult, SetSessionApprovalModeInput } from "../../types/session/SessionApproval.js";
+import type { RespondSessionInteractionInput, SessionInteractionResult, SessionPendingInteraction } from "../../types/session/SessionInteraction.js";
 import type { ListSessionMessagesInput, SessionMessagePage } from "../../types/session/SessionMessage.js";
 import type { AgentSessionPromptInput } from "../../types/sdk/AgentSessionPrompt.js";
 import type { AgentSessionStopResult } from "../../types/sdk/AgentSessionStop.js";
+import type { AgentSessionCompactHandle } from "../../types/sdk/AgentSessionCompact.js";
 import type { AgentSessionTurnHandle } from "../../types/sdk/AgentSessionTurn.js";
 /**
  * SDK Session 集合入口。
@@ -45,31 +46,29 @@ export interface AgentSessionActor {
      * 把一次显式历史压缩加入当前 Session 的有序输入队列。
      *
      * 关键点（中文）
-     * - 返回表示 command 已成功入队，不表示压缩已经执行完成。
-     * - 实际结果通过 Session action message 对外观测。
+     * - 返回句柄表示 Command 已成功入队。
+     * - `handle.finished` 在压缩真正完成或失败后兑现。
      */
-    compact(): Promise<void>;
+    compact(): Promise<AgentSessionCompactHandle>;
     /** 订阅当前 session 的未来事件。 */
     subscribe(subscriber: SessionMutationSubscriber): SessionMutationUnsubscribe;
     /** 读取当前 session messages 分页。 */
     messages(input?: ListSessionMessagesInput): Promise<SessionMessagePage>;
     /** 读取当前 session 生效的 system 快照。 */
     system(): Promise<AgentSessionSystemSnapshot>;
-    /** 列出当前 Session 的 pending 工具审批。 */
-    approvals(): Promise<SessionApproval[]>;
-    /** 读取当前 Session 的工具审批模式。 */
-    approval_mode(): Promise<SessionApprovalModeSnapshot>;
-    /** 更新当前 Session 的工具审批模式。 */
-    set_approval_mode(input: SetSessionApprovalModeInput): Promise<SessionApprovalModeSnapshot>;
-    /** 处理当前 Session 的 pending 工具审批。 */
-    resolve_approval(input: ResolveSessionApprovalInput): Promise<SessionApprovalResult>;
+    /** 列出当前 Session 正在等待用户响应的 Interaction。 */
+    interactions(): Promise<SessionPendingInteraction[]>;
+    /** 读取当前 Session 的运行与安全状态。 */
+    status(): Promise<AgentSessionStatus>;
+    /** 提交当前 Session 的 Interaction 用户响应。 */
+    respond(input: RespondSessionInteractionInput): Promise<SessionInteractionResult>;
 }
 /**
  * 本地 Agent 返回的公开 session 接口。
  */
 export interface AgentSession extends AgentSessionActor {
-    /** 当前 session 所属 agentId。 */
-    readonly agentId: string;
+    /** 当前 session 所属 agent_id。 */
+    readonly agent_id: string;
     /** 当前 session 配置快照。 */
     readonly config: AgentSessionConfigSnapshot;
     /** 写入当前 session 默认配置。 */
@@ -85,6 +84,8 @@ export interface AgentSession extends AgentSessionActor {
  * 远程 Agent 返回的公开 session 接口。
  */
 export interface RemoteAgentSession extends AgentSessionActor {
+    /** 写入当前远程 Session 的可序列化动态配置。 */
+    set(input: RemoteSessionSetInput): Promise<void>;
     /** 从当前远程 session 创建一个分叉会话。 */
     fork(input?: AgentSessionForkInput | string): Promise<RemoteAgentSession>;
 }

package/bin/types/agent/SessionActor.d.ts.map

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

package/bin/types/agent/SessionTypes.d.ts

@@ -6,20 +6,20 @@
  * - session actor 方法接口拆到 `SessionActor.ts`。
  */
 import type { AgentModel } from "../../agent/AgentModel.js";
-import type { SessionRecordV1 } from "../../executor/types/SessionRecords.js";
+import type { SessionApprovalMode } from "../../types/session/SessionInteraction.js";
 /**
  * 新建 session 的输入参数。
  */
 export interface AgentCreateSessionInput {
     /**
-     * 可选显式 sessionId。
+     * 可选显式 session_id。
      *
      * 关键点（中文）
      * - 传入时表达“创建意图”。
      * - 若该 session 已存在，SDK 应直接报错，而不是静默复用。
-     * - 省略时由 SDK 自动生成稳定且不可推导的 sessionId。
+     * - 省略时由 SDK 自动生成稳定且不可推导的 session_id。
      */
-    sessionId?: string;
+    session_id?: string;
 }
 /**
  * Session 列表查询输入。
@@ -45,7 +45,7 @@ export interface AgentListSessionsInput {
      * 关键词过滤。
      *
      * 说明（中文）
-     * - 推荐用于匹配 `sessionId`、标题与预览文本。
+     * - 推荐用于匹配 `session_id`、标题与预览文本。
      * - 属于轻量包含匹配，不承诺复杂搜索语义。
      */
     query?: string;
@@ -61,7 +61,43 @@ export interface AgentSessionSetInput {
      * - SDK 只接受宿主已经解析完成的运行时模型实例。
      * - 模型选择、ID 与持久化全部由宿主负责。
      */
-    model: AgentModel;
+    model?: AgentModel;
+    /**
+     * 当前 Session 的安全策略。
+     *
+     * 关键点（中文）
+     * - configured 值在 `set()` 返回前被 Session 接受。
+     * - 执行面在下一 Session Step 检查点原子提交该值。
+     */
+    security?: AgentSessionSecurityConfig;
+}
+/** 可通过本地或远程 Session 动态更新的安全策略。 */
+export interface AgentSessionSecurityConfig {
+    /** 高风险操作是否需要用户逐次审批。 */
+    approval_mode: SessionApprovalMode;
+}
+/** 远程 Session 可序列化的动态配置输入。 */
+export interface RemoteSessionSetInput {
+    /** 当前远程 Session 的安全策略。 */
+    security: AgentSessionSecurityConfig;
+}
+/** Session 当前安全状态。 */
+export interface AgentSessionSecurityStatus {
+    /** Session 已接受的 configured 审批模式。 */
+    approval_mode: SessionApprovalMode;
+    /** 执行面在最近 Step 检查点提交的审批模式。 */
+    effective_approval_mode: SessionApprovalMode;
+}
+/** Session 当前运行状态。 */
+export interface AgentSessionStatus {
+    /** 当前状态所属 Session 标识。 */
+    session_id: string;
+    /** Session 当前是否正在执行 Turn。 */
+    state: "idle" | "running";
+    /** 当前正在执行的 Turn 标识；空闲时省略。 */
+    active_turn_id?: string;
+    /** 当前 Session 的安全状态。 */
+    security: AgentSessionSecurityStatus;
 }
 /**
  * Session 当前配置快照。
@@ -70,14 +106,10 @@ export interface AgentSessionConfigSnapshot {
     /** 当前 session 绑定的默认模型实例。 */
     model?: AgentModel;
     /** 当前模型的轻量可读标签。 */
-    modelLabel?: string;
+    model_label?: string;
     /** 当前模型支持的总上下文窗口长度，单位为 token。 */
     model_context_window?: number;
 }
-/**
- * Session records视图类型。
- */
-export type AgentSessionRecordsView = "message" | "timeline";
 /**
  * Session 时间线事件。
  */
@@ -105,28 +137,28 @@ export interface AgentSessionTimelineEvent {
      * 说明（中文）
      * - 仅 `tool-call` / `tool-result` 这类事件通常会携带该字段。
      */
-    toolName?: string;
+    tool_name?: string;
     /**
      * 当前 action 标题。
      *
      * 说明（中文）
      * - 仅 `role=action` 的事件通常会携带该字段。
      */
-    actionTitle?: string;
+    action_title?: string;
     /**
      * 当前 action 描述。
      *
      * 说明（中文）
      * - 仅 `role=action` 的事件通常会携带该字段。
      */
-    actionDescription?: string;
+    action_description?: string;
     /**
      * 当前 action 状态。
      *
      * 说明（中文）
      * - 仅 `role=action` 的事件通常会携带该字段。
      */
-    actionState?: string;
+    action_state?: string;
 }
 /**
  * Session system block 来源类型。
@@ -161,12 +193,12 @@ export interface AgentSessionSystemBlock {
  * 当前 session 的稳定上下文信息。
  */
 export interface AgentSessionSystemSessionInfo {
-    /** 当前 session 所属 agentId。 */
-    agentId: string;
+    /** 当前 session 所属 agent_id。 */
+    agent_id: string;
     /** 当前 session 唯一标识。 */
-    sessionId: string;
+    session_id: string;
     /** 当前 agent 绑定的项目根目录。 */
-    projectRoot: string;
+    project_root: string;
     /**
      * 当前 session 首次创建时间。
      *
@@ -174,7 +206,7 @@ export interface AgentSessionSystemSessionInfo {
      * - 这是 session 初始化时落盘的稳定参考时间，按 Date/ISO 字符串对外展示。
      * - 它不是每轮运行的当前时间，不会随着后续 turn 执行而改变。
      */
-    createdAt: string;
+    created_at: string;
     /**
      * 当前 session 初始化时解析到的系统时区。
      *
@@ -188,8 +220,8 @@ export interface AgentSessionSystemSessionInfo {
  * 当前 session 首次生成后固定的完整 system prompt 快照。
  */
 export interface AgentSessionSystemSnapshot {
-    /** 当前 sessionId。 */
-    sessionId: string;
+    /** 当前 session_id。 */
+    session_id: string;
     /**
      * 当前 session 的稳定上下文信息。
      *
@@ -206,17 +238,17 @@ export interface AgentSessionSystemSnapshot {
  * Session 摘要。
  */
 export interface AgentSessionSummary {
-    /** 当前 session 所属 agentId。 */
-    agentId: string;
+    /** 当前 session 所属 agent_id。 */
+    agent_id: string;
     /** 当前 session 唯一标识。 */
-    sessionId: string;
+    session_id: string;
     /**
      * 当前 session 可读标题。
      *
      * 说明（中文）
      * - 标题持久化在 session `meta.json` 顶层。
      * - SDK 只在模型成功生成标题时写入，不再从首条用户消息生成 fallback。
-     * - 标题允许为空，调用方需要展示占位文案时可自行回退到 `sessionId`。
+     * - 标题允许为空，调用方需要展示占位文案时可自行回退到 `session_id`。
      */
     title?: string;
     /**
@@ -226,15 +258,15 @@ export interface AgentSessionSummary {
      * - 通常来自最后一条用户可见消息的裁剪文本。
      * - 适合用于侧边栏、列表卡片或 session picker。
      */
-    previewText?: string;
+    preview_text?: string;
     /** 当前 session 首次创建时间（ms）。 */
-    createdAt?: number;
+    created_at?: number;
     /** 当前 session 最近一次更新时间（ms）。 */
-    updatedAt?: number;
+    updated_at?: number;
     /** 当前 session 已落盘消息数。 */
-    messageCount: number;
+    message_count: number;
     /** 当前 session 绑定模型的可读标签。 */
-    modelLabel?: string;
+    model_label?: string;
     /** 当前 session 是否处于执行中。 */
     executing?: boolean;
 }
@@ -260,62 +292,8 @@ export interface AgentSessionSummaryPage {
      */
     total: number;
     /** 下一页游标。 */
-    nextCursor?: string;
-    /** 是否仍有更多结果。 */
-    hasMore: boolean;
-}
-/**
- * Session records 读取输入。
- */
-export interface AgentSessionRecordsInput {
-    /** 当前页返回上限。 */
-    limit?: number;
-    /** 分页游标。 */
-    cursor?: string;
-    /**
-     * 返回顺序。
-     *
-     * 说明（中文）
-     * - `asc`：从旧到新
-     * - `desc`：从新到旧
-     */
-    order?: "asc" | "desc";
-    /**
-     * 返回视图类型。
-     *
-     * 说明（中文）
-     * - `message`：原始 session 消息
-     * - `timeline`：适合直接渲染 UI 的平铺事件
-     */
-    view?: AgentSessionRecordsView;
-}
-/**
- * Session records 分页结果。
- */
-export interface AgentSessionRecordsPage {
-    /** 当前读取所对应的 session 信息。 */
-    session: AgentSessionInfo;
-    /** 当前页实际返回视图。 */
-    view: AgentSessionRecordsView;
-    /**
-     * 当前页数据列表。
-     *
-     * 说明（中文）
-     * - `view=message` 时返回 `SessionRecordV1[]`
-     * - `view=timeline` 时返回 `AgentSessionTimelineEvent[]`
-     */
-    items: SessionRecordV1[] | AgentSessionTimelineEvent[];
-    /**
-     * 过滤前后的总条数。
-     *
-     * 说明（中文）
-     * - 对 `view=message` 表示消息条数。
-     * - 对 `view=timeline` 表示时间线事件条数。
-     */
-    total: number;
-    /** 下一页游标。 */
     next_cursor?: string;
-    /** 是否仍有更多数据。 */
+    /** 是否仍有更多结果。 */
     has_more: boolean;
 }
 /**
@@ -329,7 +307,7 @@ export interface AgentSessionForkInput {
      * - 省略时复制当前 session 的完整消息历史。
      * - 传入时复制到该消息为止（包含该消息）。
      */
-    messageId?: string;
+    message_id?: string;
 }
 /**
  * 归档单个 session 的输入参数。
@@ -367,7 +345,7 @@ export interface AgentArchiveSessionsInput {
      * 关键词过滤。
      *
      * 说明（中文）
-     * - 推荐用于匹配 `sessionId`、标题与预览文本。
+     * - 推荐用于匹配 `session_id`、标题与预览文本。
      * - 属于轻量包含匹配，不承诺复杂搜索语义。
      */
     query?: string;
@@ -377,9 +355,9 @@ export interface AgentArchiveSessionsInput {
  */
 export interface AgentArchiveSessionResult {
     /** 被归档的 session id。 */
-    sessionId: string;
+    session_id: string;
     /** 归档时间戳（ms）。 */
-    archivedAt: number;
+    archived_at: number;
 }
 /**
  * 列出已归档 session 的结果。
@@ -391,6 +369,6 @@ export interface AgentArchiveSessionsResult extends AgentSessionSummaryPage {
  */
 export interface AgentCleanArchiveResult {
     /** 被永久删除的归档 session id 列表。 */
-    removedSessionIds: string[];
+    removed_session_ids: string[];
 }
 //# sourceMappingURL=SessionTypes.d.ts.map

package/bin/types/agent/SessionTypes.d.ts.map

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

package/bin/types/executor/SessionAssistantOutput.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Executor 到 Session canonical Message 的 Assistant 输出端口。
+ *
+ * 该端口集中隔离 AI SDK 流协议。SessionLoop 只装配端口，不解析 Chunk，具体转换
+ * 由 execution Adapter 完成，SessionMessages 仍是唯一 Assistant Message 事实源。
+ */
+import type { UIMessage, UIMessageChunk } from "ai";
+import type { SessionMessageRecordV1 } from "../../executor/types/SessionRecords.js";
+import type { SessionToolInputReady } from "../../types/session/SessionTool.js";
+/** 单次 Turn 的 Assistant 输出写入端口。 */
+export interface SessionAssistantOutput {
+    /** 开始一个 Provider Step 的独立 Part 作用域。 */
+    begin_step(): Promise<void>;
+    /** 写入一个 AI SDK 流式 Chunk。 */
+    write_chunk(chunk: UIMessageChunk): Promise<void>;
+    /** 使用 Provider 最终快照校验并补齐当前 Step metadata。 */
+    finish_step(message: SessionMessageRecordV1): Promise<void>;
+    /** 放弃当前未完成 Step 的临时作用域。 */
+    abort_step(): Promise<void>;
+    /** 在 Tool 实现执行前提交完整输入。 */
+    prepare_tool_input(input: SessionToolInputReady): Promise<void>;
+    /** User steer 已插入会话后，关闭它之前的当前 Assistant Message。 */
+    close_current_message(): Promise<void>;
+    /** 把 Action 产生的完整 Parts 追加到当前 canonical Assistant Message。 */
+    append_parts(parts: UIMessage["parts"]): Promise<void>;
+    /** 按 Turn 最终结果收口 Assistant 输出。 */
+    finish(input: {
+        /** Assistant 最终状态。 */
+        status: "completed" | "failed" | "stopped";
+        /** 失败时写入 Assistant Message 的错误文本。 */
+        error?: string;
+    }): Promise<void>;
+}
+//# sourceMappingURL=SessionAssistantOutput.d.ts.map

package/bin/types/executor/SessionAssistantOutput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionAssistantOutput.d.ts","sourceRoot":"","sources":["../../../src/types/executor/SessionAssistantOutput.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,IAAI,CAAC;AACpD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AACjF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAE5E,kCAAkC;AAClC,MAAM,WAAW,sBAAsB;IACrC,uCAAuC;IACvC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,4BAA4B;IAC5B,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,6CAA6C;IAC7C,WAAW,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,2BAA2B;IAC3B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,0BAA0B;IAC1B,kBAAkB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,oDAAoD;IACpD,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,8DAA8D;IAC9D,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,kCAAkC;IAClC,MAAM,CAAC,KAAK,EAAE;QACZ,sBAAsB;QACtB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;QAC3C,qCAAqC;QACrC,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB"}

package/bin/types/executor/SessionAssistantOutput.js

@@ -0,0 +1,8 @@
+/**
+ * Executor 到 Session canonical Message 的 Assistant 输出端口。
+ *
+ * 该端口集中隔离 AI SDK 流协议。SessionLoop 只装配端口，不解析 Chunk，具体转换
+ * 由 execution Adapter 完成，SessionMessages 仍是唯一 Assistant Message 事实源。
+ */
+export {};
+//# sourceMappingURL=SessionAssistantOutput.js.map

package/bin/types/executor/SessionAssistantOutput.js.map

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

package/bin/types/executor/SessionToolExecutionContext.d.ts

@@ -3,18 +3,18 @@
  *
  * 关键点（中文）
  * - 该对象由 Executor 在每个 Session step 绑定到 tool.execute。
- * - Agent 工具读取 session_run_context，Shell 工具只读取 shell_run_context。
- * - 上下文归属单次 run，不通过进程级或异步全局容器共享。
+ * - Agent 工具读取 session_turn_context，Shell 工具只读取 shell_run_context。
+ * - 上下文归属当前 Turn，不通过进程级或异步全局容器共享。
  */
 import type { ShellToolRunContext } from "@downcity/shell/types/ShellRuntime.js";
-import type { SessionRunContext } from "../../types/executor/SessionRunContext.js";
+import type { SessionTurnContext } from "../../types/executor/SessionTurnContext.js";
 /**
  * Agent 与 Shell 工具共用的单次执行上下文。
  */
 export interface SessionToolExecutionContext {
     /** 当前 Shell tool 调用的显式上下文。 */
     shell_run_context: ShellToolRunContext;
-    /** 当前工具调用所属的完整 Session run 上下文。 */
-    session_run_context: SessionRunContext;
+    /** 当前工具调用所属的完整 Session Turn 上下文。 */
+    session_turn_context: SessionTurnContext;
 }
 //# sourceMappingURL=SessionToolExecutionContext.d.ts.map