@downcity/agent 1.1.287 → 1.1.310

package/src/plugin/tool/PluginToolRuntime.ts

@@ -0,0 +1,121 @@
+/**
+ * Plugin Tool 运行时。
+ *
+ * 关键点（中文）
+ * - Plugin Action 自己完成业务输出和本地文件保存。
+ * - 本模块不猜测 `data` 是否为 UIMessage，也不下载、复制或挂载文件。
+ * - Action 的普通字段成为 `plugin_call` output，messages 交给统一 Session Tool 边界。
+ */
+
+import type { JsonObject, JsonValue } from "@/types/common/Json.js";
+import type { ActionResult } from "@/types/action/ActionResult.js";
+import type {
+  PluginCallInput,
+  PluginCallToolResult,
+  InvokePluginCallToolOptions,
+  InvokePluginReadToolOptions,
+  PluginReadInput,
+  PluginReadToolResult,
+} from "@/types/plugin/PluginTool.js";
+
+/** 判断值是否为普通 JSON 对象。 */
+function to_json_object(value: unknown): JsonObject | null {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  return value as JsonObject;
+}
+
+/** 调用 Plugin Action，并把 Action messages 原样交给统一 Tool Result。 */
+export async function invoke_plugin_call_tool(
+  params: InvokePluginCallToolOptions,
+): Promise<ActionResult<PluginCallToolResult>> {
+  const input: PluginCallInput = params.input;
+  const plugin = String(input.plugin || "").trim();
+  const action = String(input.action || "").trim();
+  const payload = to_json_object(input.payload ?? {}) ?? {};
+  if (!plugin || !action) {
+    const error = !plugin ? "plugin is required" : "action is required";
+    return {
+      output: {
+        success: false,
+        plugin,
+        action,
+        message: error,
+        error,
+      },
+      messages: [],
+    };
+  }
+
+  try {
+    const turn_context = params.turn_context;
+    const plugins = turn_context.step.plugins || params.plugins;
+    const result = await plugins.run_action({
+      plugin,
+      action,
+      payload,
+      execution_context: turn_context.step.plugin_execution_context(),
+    });
+    return {
+      output: {
+        success: result.success,
+        plugin,
+        action,
+        message:
+          String(result.message || result.error || "").trim() ||
+          (result.success ? "plugin action completed" : "plugin action failed"),
+        ...(result.error ? { error: result.error } : {}),
+        ...(result.data === undefined
+          ? {}
+          : {
+              data: to_json_object(result.data) || {
+                kind: "json",
+                value: result.data as JsonValue,
+              },
+            }),
+      },
+      messages: result.messages || [],
+    };
+  } catch (error) {
+    return {
+      output: {
+        success: false,
+        plugin,
+        action,
+        message: String(error),
+        error: String(error),
+      },
+      messages: [],
+    };
+  }
+}
+
+/** 读取 Plugin metadata，并作为普通 JSON Tool Result 返回。 */
+export async function invoke_plugin_read_tool(
+  params: InvokePluginReadToolOptions,
+): Promise<ActionResult<PluginReadToolResult>> {
+  const input: PluginReadInput = params.input;
+  try {
+    const plugins = params.turn_context.step.plugins || params.plugins;
+    const data = plugins.read({
+      plugin: typeof input.plugin === "string" ? input.plugin : undefined,
+      action: typeof input.action === "string" ? input.action : undefined,
+    });
+    return {
+      output: {
+        success: true,
+        message: "plugin metadata read",
+        data: data as unknown as JsonObject,
+      },
+      messages: [],
+    };
+  } catch (error) {
+    return {
+      output: {
+        success: false,
+        message: String(error),
+        data: { error: String(error) },
+      },
+      messages: [],
+    };
+  }
+}

package/src/{executor/tools/plugin → plugin/tool}/PluginToolSchemas.ts

@@ -2,7 +2,7 @@
  * Plugin tool 输入 schema。
  *
  * 关键点（中文）
- * - plugin_call 是 agent 内置的最低层 plugin action 桥。
+ * - plugin_call 是 agent 内置的最低层 plugin action 入口。
  * - plugin_call.payload 是透传给具体 plugin action 的 JSON object。
  * - 这里不用 Zod 表达 payload 的开放对象语义，避免 AI SDK zodSchema
  *   转换后把 additionalProperties 收窄为 false。

package/src/{executor/tools/plugin/PluginToolDefinition.ts → plugin/tool/PluginTools.ts}

@@ -1,60 +1,58 @@
 /**
- * Plugin tools。
+ * Plugin AI SDK tools。
  *
  * 设计目标（中文）
- * - plugin_call 是 agent 内置 plugin action 桥，类似 shell tool 的底层能力入口。
+ * - plugin_call 是 agent 内置 plugin action 的底层能力入口。
  * - tool 只负责 AI SDK 工具协议适配，不理解具体 plugin 的业务语义。
- * - 插件业务输出若包含 UIMessage file parts，会由 bridge 并入最终 assistant 消息。
+ * - Plugin Action 返回的 messages 由 Executor 的统一 ActionResult 边界分流。
  */
 
 import { tool, type ToolExecutionOptions } from "ai";
-import type {
-  PluginCallInput,
-  PluginReadInput,
-} from "@/executor/tools/plugin/types/PluginTool.js";
 import type {
   AgentPluginTools,
   CreatePluginToolsOptions,
-} from "@/types/plugin/PluginToolRuntime.js";
+  PluginCallInput,
+  PluginReadInput,
+} from "@/types/plugin/PluginTool.js";
 import {
-  invokePluginCallTool,
-  invokePluginReadTool,
-} from "./PluginToolBridge.js";
+  invoke_plugin_call_tool,
+  invoke_plugin_read_tool,
+} from "./PluginToolRuntime.js";
 import {
   plugin_call_input_schema,
   plugin_read_input_schema,
 } from "./PluginToolSchemas.js";
 import type { SessionToolExecutionContext } from "@/types/executor/SessionToolExecutionContext.js";
-import type { SessionRunContext } from "@/types/executor/SessionRunContext.js";
+import type { SessionTurnContext } from "@/types/executor/SessionTurnContext.js";
 
 /**
  * 要求当前 plugin tool 具有 Executor 显式绑定的 Session 上下文。
  */
-function require_run_context(
+function require_turn_context(
   options: ToolExecutionOptions,
-): SessionRunContext {
+): SessionTurnContext {
   const execution_context = options.experimental_context as
     | Partial<SessionToolExecutionContext>
     | undefined;
-  const run_context = execution_context?.session_run_context;
-  if (!run_context) {
-    throw new Error("plugin tool requires an explicit session run context");
+  const turn_context = execution_context?.session_turn_context;
+  if (!turn_context) {
+    throw new Error("plugin tool requires an explicit Session Turn context");
   }
-  return run_context;
+  return turn_context;
 }
 
 /**
  * 创建 `plugin_call`：调用当前 Agent 已注册 plugin action。
  */
-export function createPluginCallTool(options: CreatePluginToolsOptions) {
+export function create_plugin_call_tool(options: CreatePluginToolsOptions) {
   return tool({
     description:
       "Call a registered agent plugin action. Use plugin_read first when you need the action list, input schema, or examples. Generated files may be attached to the final assistant message automatically.",
     inputSchema: plugin_call_input_schema,
     execute: async (input, execution_options) =>
-      await invokePluginCallTool({
+      await invoke_plugin_call_tool({
         plugins: options.plugins,
-        run_context: require_run_context(execution_options),
+        turn_context: require_turn_context(execution_options),
         input: input as PluginCallInput,
       }),
   });
@@ -63,15 +61,15 @@ export function createPluginCallTool(options: CreatePluginToolsOptions) {
 /**
  * 创建 `plugin_read`：读取当前 Agent 已注册 plugin / action metadata。
  */
-export function createPluginReadTool(options: CreatePluginToolsOptions) {
+export function create_plugin_read_tool(options: CreatePluginToolsOptions) {
   return tool({
     description:
       "Read registered agent plugin metadata, including action names, descriptions, input schemas, and examples. Use this before plugin_call when the payload shape is unclear.",
     inputSchema: plugin_read_input_schema,
     execute: async (input, execution_options) =>
-      await invokePluginReadTool({
+      await invoke_plugin_read_tool({
         plugins: options.plugins,
-        run_context: require_run_context(execution_options),
+        turn_context: require_turn_context(execution_options),
         input: input as PluginReadInput,
       }),
   });
@@ -80,11 +78,11 @@ export function createPluginReadTool(options: CreatePluginToolsOptions) {
 /**
  * 创建当前 Agent 专属 Plugin 工具集合。
  */
-export function createPluginTools(
+export function create_plugin_tools(
   options: CreatePluginToolsOptions,
 ): AgentPluginTools {
   return {
-    plugin_call: createPluginCallTool(options),
-    plugin_read: createPluginReadTool(options),
+    plugin_call: create_plugin_call_tool(options),
+    plugin_read: create_plugin_read_tool(options),
   };
 }

package/src/plugin/types/ActionSchedule.ts

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - 这里描述的是“某个 plugin action 在未来某个时间执行”的通用记录。
- * - 它不是独立 plugin，也不表达业务语义，只服务于 plugin command/action 协议。
+ * - 它不是独立 Plugin，也不表达业务语义，只服务于 Plugin Action 调度。
  * - 外部请求字段仍可叫 `schedule`，但内部类型统一归入 ActionSchedule 模块。
  */
 
@@ -30,11 +30,11 @@ export interface ActionScheduleJobRecord {
   /**
    * 目标 plugin 名称。
    */
-  pluginName: string;
+  plugin_name: string;
   /**
    * 目标 action 名称。
    */
-  actionName: string;
+  action_name: string;
   /**
    * 原始 action payload。
    */
@@ -42,7 +42,7 @@ export interface ActionScheduleJobRecord {
   /**
    * 计划执行时间（毫秒时间戳）。
    */
-  runAtMs: number;
+  run_at_ms: number;
   /**
    * 当前任务状态。
    */
@@ -54,11 +54,11 @@ export interface ActionScheduleJobRecord {
   /**
    * 创建时间（毫秒时间戳）。
    */
-  createdAt: number;
+  created_at: number;
   /**
    * 最近更新时间（毫秒时间戳）。
    */
-  updatedAt: number;
+  updated_at: number;
 }
 
 /**
@@ -68,11 +68,11 @@ export interface CreateActionScheduleJobInput {
   /**
    * 目标 plugin 名称。
    */
-  pluginName: string;
+  plugin_name: string;
   /**
    * 目标 action 名称。
    */
-  actionName: string;
+  action_name: string;
   /**
    * 目标 action payload。
    */
@@ -80,7 +80,7 @@ export interface CreateActionScheduleJobInput {
   /**
    * 计划执行时间（毫秒时间戳）。
    */
-  runAtMs: number;
+  run_at_ms: number;
 }
 
 /**
@@ -90,5 +90,5 @@ export interface PluginActionScheduleInput {
   /**
    * 计划执行时间（毫秒时间戳）。
    */
-  runAtMs: number;
+  run_at_ms: number;
 }

package/src/plugin/types/PluginApi.ts

@@ -44,7 +44,7 @@ export interface PluginAvailabilityResponse {
   /**
    * Plugin 名称（可选）。
    */
-  pluginName?: string;
+  plugin_name?: string;
   /**
    * Plugin 可用性视图（可选）。
    */
@@ -66,11 +66,11 @@ export interface PluginActionResponse {
   /**
    * Plugin 名称（可选）。
    */
-  pluginName?: string;
+  plugin_name?: string;
   /**
    * Action 名称（可选）。
    */
-  actionName?: string;
+  action_name?: string;
   /**
    * 返回数据（可选）。
    */

package/src/remote/RemoteAgent.ts

@@ -51,16 +51,16 @@ export class RemoteAgent {
    * - 这是 RemoteAgent 顶层能力，不绑定某个 session。
    * - Shell approval 通过具体 RemoteSession 处理。
    */
-  async runPluginAction(
+  async run_plugin_action(
     input: RemoteAgentPluginActionInput,
   ): Promise<RemoteAgentPluginActionResult> {
     const plugin = String(input.plugin || "").trim();
     const action = String(input.action || "").trim();
     if (!plugin) {
-      throw new Error("runPluginAction requires a non-empty plugin");
+      throw new Error("run_plugin_action requires a non-empty plugin");
     }
     if (!action) {
-      throw new Error("runPluginAction requires a non-empty action");
+      throw new Error("run_plugin_action requires a non-empty action");
     }
     return await this.transport.run_plugin_action({
       plugin,

package/src/remote/RemoteSession.ts

@@ -8,16 +8,16 @@ import type {
   AgentSessionConfigSnapshot,
   AgentSessionForkInput,
   AgentSessionInfo,
+  AgentSessionStatus,
   AgentSessionSystemSnapshot,
+  RemoteSessionSetInput,
 } from "@/types/agent/SessionTypes.js";
 import type { RemoteAgentSession } from "@/types/agent/SessionActor.js";
 import type {
-  ResolveSessionApprovalInput,
-  SessionApproval,
-  SessionApprovalModeSnapshot,
-  SessionApprovalResult,
-  SetSessionApprovalModeInput,
-} from "@/types/session/SessionApproval.js";
+  RespondSessionInteractionInput,
+  SessionInteractionResult,
+  SessionPendingInteraction,
+} from "@/types/session/SessionInteraction.js";
 import type {
   SessionMutation,
   SessionMutationSubscriber,
@@ -27,9 +27,13 @@ import type {
   ListSessionMessagesInput,
   SessionMessagePage,
 } from "@/types/session/SessionMessage.js";
-import { isAgentSessionPromptInputEmpty } from "@/types/sdk/AgentSessionPrompt.js";
+import { is_agent_session_prompt_input_empty } from "@/types/sdk/AgentSessionPrompt.js";
 import type { AgentSessionPromptInput } from "@/types/sdk/AgentSessionPrompt.js";
 import type { AgentSessionStopResult } from "@/types/sdk/AgentSessionStop.js";
+import type {
+  AgentSessionCompactHandle,
+  AgentSessionCompactResult,
+} from "@/types/sdk/AgentSessionCompact.js";
 import type {
   AgentSessionTurnHandle,
   AgentSessionTurnResult,
@@ -56,16 +60,27 @@ type RemoteTurnLifecycle = {
   deferred_finished: Deferred<AgentSessionTurnResult>;
 };
 
+type RemoteCompactLifecycle = {
+  /** 当前显式压缩请求标识。 */
+  compact_id: string;
+  /** 当前压缩请求的最终结果；运行中为 null。 */
+  result: AgentSessionCompactResult | null;
+  /** 当前压缩完成 Promise 控制器。 */
+  deferred_finished: Deferred<AgentSessionCompactResult>;
+};
+
 /** 远程 Session 客户端。 */
 export class RemoteSession implements RemoteAgentSession {
   readonly id: string;
-  readonly agentId: string;
+  readonly agent_id: string;
   readonly config: AgentSessionConfigSnapshot;
 
   private readonly transport: RemoteSessionTransport;
   private readonly event_hub: SessionEventHub;
   private readonly turns_by_id = new Map<string, RemoteTurnLifecycle>();
+  private readonly compacts_by_id = new Map<string, RemoteCompactLifecycle>();
   private readonly completed_turn_ids: string[] = [];
+  private readonly completed_compact_ids: string[] = [];
   private event_pump_connect_promise: Promise<void> | null = null;
   private event_pump_running = false;
   private event_subscriber_count = 0;
@@ -73,10 +88,10 @@ export class RemoteSession implements RemoteAgentSession {
 
   constructor(transport: RemoteSessionTransport, info: AgentSessionInfo) {
     this.transport = transport;
-    this.id = info.sessionId;
-    this.agentId = info.agentId;
+    this.id = info.session_id;
+    this.agent_id = info.agent_id;
     this.config = {
-      ...(info.modelLabel ? { modelLabel: info.modelLabel } : {}),
+      ...(info.model_label ? { model_label: info.model_label } : {}),
     };
     this.event_hub = new SessionEventHub();
   }
@@ -88,7 +103,7 @@ export class RemoteSession implements RemoteAgentSession {
 
   /** 向当前远程 Session 追加 Prompt。 */
   async prompt(input: AgentSessionPromptInput): Promise<AgentSessionTurnHandle> {
-    if (isAgentSessionPromptInputEmpty(input)) {
+    if (is_agent_session_prompt_input_empty(input)) {
       throw new Error("remote session.prompt requires a non-empty query");
     }
     await this.ensure_event_pump();
@@ -103,8 +118,10 @@ export class RemoteSession implements RemoteAgentSession {
   }
 
   /** 把一次显式历史压缩加入当前远程 Session 的有序输入队列。 */
-  async compact(): Promise<void> {
-    await this.transport.compact(this.id);
+  async compact(): Promise<AgentSessionCompactHandle> {
+    await this.ensure_event_pump();
+    const compact = await this.transport.compact(this.id);
+    return create_compact_handle(this.ensure_compact_lifecycle(compact.id));
   }
 
   /** 订阅当前 Session 的全部未来 Mutation。 */
@@ -131,24 +148,24 @@ export class RemoteSession implements RemoteAgentSession {
     return await this.transport.system(this.id);
   }
 
-  /** 列出当前远程 Session 的 pending 工具审批。 */
-  async approvals(): Promise<SessionApproval[]> {
-    return await this.transport.approvals(this.id);
+  /** 列出当前远程 Session 正在等待用户响应的 Interaction。 */
+  async interactions(): Promise<SessionPendingInteraction[]> {
+    return await this.transport.interactions(this.id);
   }
 
-  /** 读取当前远程 Session 的工具审批模式。 */
-  async approval_mode(): Promise<SessionApprovalModeSnapshot> {
-    return await this.transport.approval_mode(this.id);
+  /** 读取当前远程 Session 的运行与安全状态。 */
+  async status(): Promise<AgentSessionStatus> {
+    return await this.transport.status(this.id);
   }
 
-  /** 更新当前远程 Session 的工具审批模式。 */
-  async set_approval_mode(input: SetSessionApprovalModeInput): Promise<SessionApprovalModeSnapshot> {
-    return await this.transport.set_approval_mode(this.id, input);
+  /** 更新当前远程 Session 的可序列化动态配置。 */
+  async set(input: RemoteSessionSetInput): Promise<void> {
+    await this.transport.set(this.id, input);
   }
 
-  /** 处理当前远程 Session 的 pending 工具审批。 */
-  async resolve_approval(input: ResolveSessionApprovalInput): Promise<SessionApprovalResult> {
-    return await this.transport.resolve_approval(this.id, input);
+  /** 提交当前远程 Session 的 Interaction 用户响应。 */
+  async respond(input: RespondSessionInteractionInput): Promise<SessionInteractionResult> {
+    return await this.transport.respond(this.id, input);
   }
 
   /** 从当前远程 Session 创建分支。 */
@@ -185,7 +202,7 @@ export class RemoteSession implements RemoteAgentSession {
     if (mutation.variant === "turn" && mutation.type === "finish") {
       const lifecycle = this.ensure_turn_lifecycle(mutation.turn_id);
       const result: AgentSessionTurnResult = {
-        turnId: mutation.turn_id,
+        turn_id: mutation.turn_id,
         text: mutation.text || "",
         success: mutation.status === "completed",
         ...(mutation.error ? { error: mutation.error } : {}),
@@ -195,6 +212,20 @@ export class RemoteSession implements RemoteAgentSession {
       this.remember_completed_turn(mutation.turn_id);
       void this.maybe_stop_event_pump();
     }
+    if (mutation.variant === "compact" && mutation.type === "finish") {
+      const lifecycle = this.ensure_compact_lifecycle(mutation.compact_id);
+      const result: AgentSessionCompactResult = {
+        compact_id: mutation.compact_id,
+        success: mutation.status === "completed",
+        compacted: mutation.compacted === true,
+        reason: mutation.reason || "compact_failed",
+        ...(mutation.error ? { error: mutation.error } : {}),
+      };
+      lifecycle.result = result;
+      lifecycle.deferred_finished.resolve(result);
+      this.remember_completed_compact(mutation.compact_id);
+      void this.maybe_stop_event_pump();
+    }
     this.event_hub.publish(mutation);
   }
 
@@ -222,7 +253,7 @@ export class RemoteSession implements RemoteAgentSession {
     for (const lifecycle of this.turns_by_id.values()) {
       if (lifecycle.result) continue;
       const result: AgentSessionTurnResult = {
-        turnId: lifecycle.turn_id,
+        turn_id: lifecycle.turn_id,
         text: "",
         success: false,
         error: message,
@@ -231,6 +262,19 @@ export class RemoteSession implements RemoteAgentSession {
       lifecycle.deferred_finished.resolve(result);
       this.remember_completed_turn(lifecycle.turn_id);
     }
+    for (const lifecycle of this.compacts_by_id.values()) {
+      if (lifecycle.result) continue;
+      const result: AgentSessionCompactResult = {
+        compact_id: lifecycle.compact_id,
+        success: false,
+        compacted: false,
+        reason: "compact_failed",
+        error: message,
+      };
+      lifecycle.result = result;
+      lifecycle.deferred_finished.resolve(result);
+      this.remember_completed_compact(lifecycle.compact_id);
+    }
   }
 
   private remember_completed_turn(turn_id: string): void {
@@ -241,9 +285,21 @@ export class RemoteSession implements RemoteAgentSession {
     }
   }
 
+  /** 有界保留已完成压缩，覆盖 finish Mutation 早于 transport 响应到达的竞态。 */
+  private remember_completed_compact(compact_id: string): void {
+    if (!this.completed_compact_ids.includes(compact_id)) {
+      this.completed_compact_ids.push(compact_id);
+    }
+    while (this.completed_compact_ids.length > 200) {
+      const oldest_compact_id = this.completed_compact_ids.shift();
+      if (oldest_compact_id) this.compacts_by_id.delete(oldest_compact_id);
+    }
+  }
+
   private async maybe_stop_event_pump(): Promise<void> {
     if (this.event_subscriber_count > 0) return;
     if ([...this.turns_by_id.values()].some((item) => item.result === null)) return;
+    if ([...this.compacts_by_id.values()].some((item) => item.result === null)) return;
     const current = this.event_subscription;
     this.event_subscription = null;
     this.event_pump_running = false;
@@ -252,6 +308,20 @@ export class RemoteSession implements RemoteAgentSession {
       this.fail_pending_turns(error instanceof Error ? error.message : String(error));
     });
   }
+
+  private ensure_compact_lifecycle(
+    compact_id: string,
+  ): RemoteCompactLifecycle {
+    const cached = this.compacts_by_id.get(compact_id);
+    if (cached) return cached;
+    const created: RemoteCompactLifecycle = {
+      compact_id,
+      result: null,
+      deferred_finished: create_deferred<AgentSessionCompactResult>(),
+    };
+    this.compacts_by_id.set(compact_id, created);
+    return created;
+  }
 }
 
 function create_deferred<T>(): Deferred<T> {
@@ -271,3 +341,15 @@ function create_turn_handle(lifecycle: RemoteTurnLifecycle): AgentSessionTurnHan
     finished: lifecycle.deferred_finished.promise,
   };
 }
+
+function create_compact_handle(
+  lifecycle: RemoteCompactLifecycle,
+): AgentSessionCompactHandle {
+  return {
+    id: lifecycle.compact_id,
+    get result() {
+      return lifecycle.result;
+    },
+    finished: lifecycle.deferred_finished.promise,
+  };
+}

package/src/remote/RemoteTransport.ts

@@ -16,8 +16,10 @@ import type {
   AgentCleanArchiveResult,
   AgentSessionForkInput,
   AgentSessionInfo,
+  AgentSessionStatus,
   AgentSessionSummaryPage,
   AgentSessionSystemSnapshot,
+  RemoteSessionSetInput,
 } from "@/types/agent/SessionTypes.js";
 import type {
   RemoteAgentPluginActionInput,
@@ -25,12 +27,10 @@ import type {
 } from "@/types/agent/RemoteAgentPluginAction.js";
 import type { SessionMutation } from "@/types/session/SessionMutation.js";
 import type {
-  ResolveSessionApprovalInput,
-  SessionApproval,
-  SessionApprovalModeSnapshot,
-  SessionApprovalResult,
-  SetSessionApprovalModeInput,
-} from "@/types/session/SessionApproval.js";
+  RespondSessionInteractionInput,
+  SessionInteractionResult,
+  SessionPendingInteraction,
+} from "@/types/session/SessionInteraction.js";
 import type { AgentSessionPromptInput } from "@/types/sdk/AgentSessionPrompt.js";
 import type { AgentSessionStopResult } from "@/types/sdk/AgentSessionStop.js";
 import type {
@@ -60,7 +60,7 @@ export type RemoteSessionTransport = {
   /** 停止当前 session turn，并取消未吸收队列。 */
   stop(session_id: string): Promise<AgentSessionStopResult>;
   /** 把一次显式历史压缩加入远程 Session 的有序输入队列。 */
-  compact(session_id: string): Promise<void>;
+  compact(session_id: string): Promise<{ id: string }>;
   /** 订阅 session 事件。 */
   subscribe(params: {
     session_id: string;
@@ -81,20 +81,17 @@ export type RemoteSessionTransport = {
     session_id: string,
     input?: AgentSessionForkInput | string,
   ): Promise<AgentSessionInfo>;
-  /** 列出指定 Session 的 pending 工具审批。 */
-  approvals(session_id: string): Promise<SessionApproval[]>;
-  /** 读取指定 Session 的工具审批模式。 */
-  approval_mode(session_id: string): Promise<SessionApprovalModeSnapshot>;
-  /** 更新指定 Session 的工具审批模式。 */
-  set_approval_mode(
+  /** 列出指定 Session 正在等待用户响应的 Interaction。 */
+  interactions(session_id: string): Promise<SessionPendingInteraction[]>;
+  /** 读取指定 Session 的运行与安全状态。 */
+  status(session_id: string): Promise<AgentSessionStatus>;
+  /** 更新指定 Session 的可序列化动态配置。 */
+  set(session_id: string, input: RemoteSessionSetInput): Promise<void>;
+  /** 提交指定 Session 的 Interaction 用户响应。 */
+  respond(
     session_id: string,
-    input: SetSessionApprovalModeInput,
-  ): Promise<SessionApprovalModeSnapshot>;
-  /** 处理指定 Session 的 pending 工具审批。 */
-  resolve_approval(
-    session_id: string,
-    input: ResolveSessionApprovalInput,
-  ): Promise<SessionApprovalResult>;
+    input: RespondSessionInteractionInput,
+  ): Promise<SessionInteractionResult>;
 };
 
 /**