@downcity/agent 1.1.228 → 1.1.236

package/src/session/services/SessionViewService.ts

@@ -8,12 +8,7 @@
  */
 
 import { nanoid } from "nanoid";
-import {
-  buildSessionRecordsPage,
-  buildSessionInfo,
-  loadSessionArchiveMessagesFromPath,
-} from "@/session/browse/Browse.js";
-import { getSdkAgentSessionArchiveFilePath } from "@/session/storage/Paths.js";
+import { buildSessionInfo } from "@/session/browse/Browse.js";
 import { ensureSessionTitle } from "@/session/SessionTitle.js";
 import { readSessionMetadata } from "@/session/storage/Metadata.js";
 import { buildSessionSystemBlocks } from "@/session/SessionSystemBuilder.js";
@@ -21,8 +16,6 @@ import type { SessionHistoryStore } from "@/executor/store/history/SessionHistor
 import type { SessionSystemComposer } from "@/executor/composer/system/SessionSystemComposer.js";
 import type {
   AgentSessionForkInput,
-  AgentSessionRecordsInput,
-  AgentSessionRecordsPage,
   AgentSessionInfo,
   AgentSessionSystemBlock,
   AgentSessionSystemSnapshot,
@@ -192,42 +185,6 @@ export class SessionViewService<TSession extends Pick<AgentSession, "set">> {
     });
   }
 
-  /**
-   * 读取当前 session records 分页。
-   */
-  async records(
-    input?: AgentSessionRecordsInput,
-  ): Promise<AgentSessionRecordsPage> {
-    const archive_id = String(input?.archive_id || "").trim();
-    const [metadata, current_messages] = await Promise.all([
-      readSessionMetadata({
-        projectRoot: this.project_root,
-        agentId: this.agent_id,
-        sessionId: this.session_id,
-      }),
-      this.history_store.list_records(),
-    ]);
-    const page_messages = archive_id
-      ? await loadSessionArchiveMessagesFromPath(
-          getSdkAgentSessionArchiveFilePath(
-            this.project_root,
-            this.agent_id,
-            this.session_id,
-            archive_id,
-          ),
-        )
-      : current_messages;
-    const session = await this.build_info({
-      metadata,
-      messages: current_messages,
-    });
-    return buildSessionRecordsPage({
-      session,
-      messages: page_messages,
-      input,
-    });
-  }
-
   /**
    * 读取当前 session 生效的 system 快照。
    */
@@ -290,14 +247,11 @@ export class SessionViewService<TSession extends Pick<AgentSession, "set">> {
       typeof input === "string"
         ? String(input || "").trim() || undefined
         : String(input?.messageId || "").trim() || undefined;
-    const message_page = await this.recorder.list_messages({
-      limit: 500,
-      include_internal: true,
-    });
+    const messages = await this.recorder.list_history_messages();
     const fork_messages =
       !message_id
-        ? message_page.items
-        : this.resolve_fork_messages(message_page.items, message_id);
+        ? messages
+        : this.resolve_fork_messages(messages, message_id);
     const action_id = `history-forking:${this.session_id}:${Date.now()}:${nanoid(8)}`;
 
     await this.state_service.emit_action_event({

package/src/session/storage/Paths.ts

@@ -88,7 +88,7 @@ export function getSdkAgentArchivedSessionMessagesDirPath(
 }
 
 /**
- * 单个已归档 session 的消息 JSONL 文件路径。
+ * 单个已归档 session 的 Active JSONL 文件路径。
  */
 export function getSdkAgentArchivedSessionMessagesPath(
   projectRoot: string,
@@ -97,7 +97,7 @@ export function getSdkAgentArchivedSessionMessagesPath(
 ): string {
   return path.join(
     getSdkAgentArchivedSessionMessagesDirPath(projectRoot, agentId, sessionId),
-    "messages.jsonl",
+    "active.jsonl",
   );
 }
 
@@ -144,7 +144,7 @@ export function getSdkAgentSessionMessagesDirPath(
 }
 
 /**
- * 单个 session 的消息 JSONL 文件路径。
+ * 单个 session 的 Active JSONL 文件路径。
  */
 export function getSdkAgentSessionMessagesPath(
   projectRoot: string,
@@ -153,7 +153,7 @@ export function getSdkAgentSessionMessagesPath(
 ): string {
   return path.join(
     getSdkAgentSessionMessagesDirPath(projectRoot, agentId, sessionId),
-    "messages.jsonl",
+    "active.jsonl",
   );
 }
 
@@ -171,46 +171,13 @@ export function getSdkAgentSessionMetaPath(
   );
 }
 
-/**
- * 单个 session 的 archive 目录路径。
- */
-export function getSdkAgentSessionArchiveDirPath(
-  projectRoot: string,
-  agentId: string,
-  sessionId: string,
-): string {
-  return path.join(
-    getSdkAgentSessionMessagesDirPath(projectRoot, agentId, sessionId),
-    "archive",
-  );
-}
-
-/**
- * 单个 session 的 compact archive JSON 文件路径。
- *
- * 关键点（中文）
- * - `archiveId` 来自 compact summary metadata，不由调用方拼接扩展名。
- * - 这里统一 encode，避免 archiveId 中的特殊字符影响文件路径。
- */
-export function getSdkAgentSessionArchiveFilePath(
-  projectRoot: string,
-  agentId: string,
-  sessionId: string,
-  archiveId: string,
-): string {
-  return path.join(
-    getSdkAgentSessionArchiveDirPath(projectRoot, agentId, sessionId),
-    `${encodeURIComponent(String(archiveId || "").trim())}.json`,
-  );
-}
-
 /**
  * 单个 session 的 inflight assistant 路径。
  *
  * 关键点（中文）
  * - 运行中的 assistant 只保留一份增量快照。
  * - step / tool 过程会持续重写这个文件，避免中途中断后过程完全丢失。
- * - 完成后再把最终 assistant 合并进 `messages.jsonl`，并清理该文件。
+ * - 完成后再把最终 assistant 合并进 `active.jsonl`，并清理该文件。
  */
 export function getSdkAgentSessionAssistantMessagePath(
   projectRoot: string,

package/src/types/agent/SessionActor.ts

@@ -79,6 +79,15 @@ export interface AgentSessionActor {
   /** 停止当前 turn，并取消尚未被吸收的排队 prompt。 */
   stop(): Promise<AgentSessionStopResult>;
 
+  /**
+   * 把一次显式历史压缩加入当前 Session 的有序输入队列。
+   *
+   * 关键点（中文）
+   * - 返回表示 command 已成功入队，不表示压缩已经执行完成。
+   * - 实际结果通过 Session action message 对外观测。
+   */
+  compact(): Promise<void>;
+
   /** 订阅当前 session 的未来事件。 */
   subscribe(
     subscriber: SessionMutationSubscriber,

package/src/types/agent/SessionTypes.ts

@@ -90,6 +90,8 @@ export interface AgentSessionConfigSnapshot {
   modelLabel?: string;
   /** 当前 session 绑定的稳定模型 ID。 */
   modelId?: string;
+  /** 当前模型支持的总上下文窗口长度，单位为 token。 */
+  model_context_window?: number;
 }
 
 /**
@@ -305,14 +307,6 @@ export interface AgentSessionRecordsInput {
   limit?: number;
   /** 分页游标。 */
   cursor?: string;
-  /**
-   * 要读取的 compact archive 层 ID。
-   *
-   * 说明（中文）
-   * - 省略时读取当前 `messages.jsonl`。
-   * - 传入时读取 `messages/archive/<archive_id>.json` 中保存的上一层历史。
-   */
-  archive_id?: string;
   /**
    * 返回顺序。
    *
@@ -359,22 +353,6 @@ export interface AgentSessionRecordsPage {
   next_cursor?: string;
   /** 是否仍有更多数据。 */
   has_more: boolean;
-  /**
-   * 当前读取的 compact archive 层 ID。
-   *
-   * 说明（中文）
-   * - 省略表示当前页来自主历史 `messages.jsonl`。
-   * - 有值表示当前页来自指定 compact archive。
-   */
-  archive_id?: string;
-  /**
-   * 当前层更早一次 compact 对应的 archive ID。
-   *
-   * 关键点（中文）
-   * - compact summary 不会出现在 `items` 中。
-   * - 若当前层包含 compact summary，则这里暴露其 archive ID，供调用方继续 `session.records({ archive_id })`。
-   */
-  previous_archive_id?: string;
 }
 
 /**

package/src/types/executor/SessionRunContext.ts

@@ -18,6 +18,7 @@ import type {
 } from "@/executor/types/SessionRun.js";
 import type { SessionUserMessageV1 } from "@/executor/types/SessionRecords.js";
 import type { FileUIPart } from "ai";
+import type { AgentPluginExecutionLease } from "@/types/plugin/PluginRuntime.js";
 
 /**
  * 单次 session run 的运行上下文。
@@ -55,6 +56,39 @@ export interface SessionRunContext {
    */
   onStepCallback?: () => Promise<SessionUserMessageV1[]>;
 
+  /**
+   * 判断是否仍有等待并入下一 Session step 的 steer prompt。
+   *
+   * 关键点（中文）
+   * - 只检查 prompt，不把单独的 command 当成继续调用模型的理由。
+   * - 真正的队列消费统一发生在 `onStepCallback`。
+   */
+  hasPendingStepInput?: () => boolean;
+
+  /**
+   * 消费一次 canonical history 重载请求。
+   *
+   * 关键点（中文）
+   * - QueueCommand 重写持久化历史后返回 true。
+   * - CoreEngine 必须在下一次 provider 调用前重新读取 records，并且每次请求只能消费一次。
+   */
+  consume_history_reload?: () => boolean;
+
+  /**
+   * 当前 Session step 实际使用的 Agent env。
+   *
+   * 关键点（中文）
+   * - 由 Session 统一输入队列在 step 检查点更新。
+   * - tool/plugin 深层调用通过 run scope 读取，避免看到刚写入但尚未生效的 env。
+   */
+  agentEnv?: Readonly<Record<string, string>>;
+
+  /** 当前 Session step 已提交生效的 Agent instruction 文本。 */
+  agentSystems?: readonly string[];
+
+  /** 当前 Session step 持有的 Plugin 执行 lease。 */
+  agentPlugins?: AgentPluginExecutionLease;
+
   /**
    * assistant step 完成回调。
    *

package/src/types/plugin/PluginRuntime.ts

@@ -95,11 +95,17 @@ export interface PluginAvailability {
 export interface AgentPlugins {
   /** 注册或替换一个 plugin。 */
   register(plugin: Plugin): Promise<PluginSnapshot>;
-  /** 卸载一个 plugin。 */
+  /**
+   * 从 configured registry 卸载一个 plugin。
+   *
+   * 关键点（中文）
+   * - 返回值表示 configured registry 是否发生删除。
+   * - 活跃 Session step 仍可使用已捕获的 execution lease，lifecycle.stop 在 lease 释放后执行。
+   */
   unregister(pluginName: string): Promise<boolean>;
   /** 启动全部已挂载 plugin lifecycle。 */
   startAll(): Promise<PluginSnapshot[]>;
-  /** 卸载全部 plugin。 */
+  /** 卸载全部 plugin，并等待所有 execution lease 释放后的 lifecycle.stop 完成。 */
   unregisterAll(): Promise<void>;
   /** 判断 plugin 是否已注册。 */
   has(pluginName: string): boolean;
@@ -142,6 +148,61 @@ export interface AgentPlugins {
     pointName: string,
     value: TInput,
   ): Promise<TOutput>;
+
+}
+
+/**
+ * Plugin execution view 的只读调用能力。
+ */
+export interface AgentPluginExecutionView {
+  /** 读取当前视图中的 plugin/action metadata。 */
+  read(params: {
+    /** Plugin 名称（可选）。 */
+    plugin?: string;
+    /** Action 名称（可选）。 */
+    action?: string;
+  }): PluginReadView | { plugins: PluginView[] };
+
+  /** 运行当前视图中捕获的 plugin action。 */
+  runAction(params: {
+    /** Plugin 名称。 */
+    plugin: string;
+    /** Action 名称。 */
+    action: string;
+    /** Action Payload（可选）。 */
+    payload?: JsonValue;
+  }): Promise<PluginActionResult<JsonValue>>;
+
+  /** 解析当前视图中捕获的 plugin system blocks。 */
+  systemBlocks(): Promise<AgentSessionSystemBlock[]>;
+}
+
+/**
+ * 单次 Session step 持有的 Plugin 执行 lease。
+ */
+export interface AgentPluginExecutionLease extends AgentPluginExecutionView {
+  /**
+   * 释放当前 step 对捕获 Plugin lifecycle 的占用。
+   *
+   * 关键点（中文）
+   * - 必须幂等，重复释放不会重复停止 lifecycle。
+   * - 若 Plugin 已从 configured registry 移除，最后一个 lease 释放时完成延迟 stop。
+   */
+  release(): Promise<void>;
+}
+
+/**
+ * Session effective 配置持有的 Plugin 执行 runtime。
+ */
+export interface AgentPluginExecutionRuntime extends AgentPluginExecutionView {
+  /**
+   * 为当前 Session step 获取独立的 Plugin 执行 lease。
+   *
+   * 关键点（中文）
+   * - lease 只捕获创建 runtime 时存在的 Plugin records。
+   * - 已退休或 lifecycle 未就绪的 Plugin 不会进入新 lease。
+   */
+  acquire(): AgentPluginExecutionLease;
 }
 
 /**

package/src/types/plugin/PluginState.ts

@@ -32,6 +32,16 @@ export interface PluginRuntimeRecord {
   chain: Promise<void>;
   /** lifecycle.start 是否已经执行成功。 */
   lifecycle_started: boolean;
+  /** 当前正在使用该 Plugin 的 Session step lease 数量。 */
+  active_execution_leases: number;
+  /** 当前 Plugin 是否已从 configured registry 移除并等待释放。 */
+  retired: boolean;
+  /** 当前 Plugin 的延迟 lifecycle.stop 是否已经开始。 */
+  retirement_started: boolean;
+  /** 当前 Plugin 完成延迟 lifecycle.stop 后兑现的 Promise。 */
+  retirement_promise?: Promise<void>;
+  /** 兑现当前 Plugin retirement Promise 的内部回调。 */
+  resolve_retirement?: () => void;
 }
 
 /**

package/src/types/rpc/RpcProtocol.ts

@@ -126,6 +126,17 @@ export type RpcRequest =
         sessionId: string;
       };
     }
+  | {
+      /** 请求 id，用于匹配响应。 */
+      id: string;
+      /** 把显式历史压缩加入 Session 的有序输入队列。 */
+      method: "sdk.sessions.compact";
+      /** 目标 Session 参数。 */
+      params: {
+        /** 目标 session id。 */
+        sessionId: string;
+      };
+    }
   | {
       /** 请求 id，用于匹配响应。 */
       id: string;

package/src/types/runtime/agent/AgentContext.ts

@@ -34,6 +34,7 @@ import type {
 } from "@/types/session/SessionMutation.js";
 import type { SessionApprovalRuntimeEvent } from "@/types/session/SessionApproval.js";
 import type { AgentSessionTurnHandle } from "@/types/sdk/AgentSessionTurn.js";
+import { getSessionRunContext } from "@/executor/SessionRunScope.js";
 
 /**
  * 跨 plugin runtime 调用参数。
@@ -233,7 +234,7 @@ export interface AgentContextOptions {
    *
    * 关键点（中文）
    * - 必须是 Agent 持有的同一个 mutable 引用，不要克隆后再传入。
-   * - 通过 `agent.setEnv` / `agent.patchEnv` 原地更新会被本 context 立即感知。
+   * - Session step 内优先读取队列已经提交的 effective env。
    */
   env: Record<string, string>;
   /** 当前生效的 system 文本集合。 */
@@ -267,10 +268,10 @@ export class AgentContext {
   readonly logger: Logger;
   /** 当前运行时已解析配置。 */
   readonly config: DowncityConfig;
-  /** 当前项目环境变量共享视图。 */
-  readonly env: Record<string, string>;
-  /** 当前生效的 system 文本集合。 */
-  readonly systems: string[];
+  /** 当前 Agent configured env 共享对象。 */
+  private readonly configured_env: Record<string, string>;
+  /** 当前 Agent configured system 文本。 */
+  private readonly configured_systems: string[];
   /** 当前可见的路径能力集合。 */
   readonly paths: AgentPathRuntime;
   /** 当前可见的 plugin 配置持久化能力集合。 */
@@ -289,8 +290,8 @@ export class AgentContext {
     this.rootPath = options.rootPath;
     this.logger = options.logger;
     this.config = options.config;
-    this.env = options.env;
-    this.systems = options.systems;
+    this.configured_env = options.env;
+    this.configured_systems = options.systems;
     this.paths = options.paths;
     this.pluginConfig = options.pluginConfig;
     this.pluginInstances = options.pluginInstances;
@@ -301,6 +302,30 @@ export class AgentContext {
     };
   }
 
+  /**
+   * 读取当前调用链可见的 Agent env。
+   *
+   * 关键点（中文）
+   * - Session step 内优先返回统一输入队列已经提交的 effective env。
+   * - Session 运行外返回 Agent 配置 API 最近一次成功写入的 configured env。
+   */
+  get env(): Record<string, string> {
+    const effective_env = getSessionRunContext()?.agentEnv;
+    return effective_env
+      ? { ...effective_env }
+      : this.configured_env;
+  }
+
+  /**
+   * 读取当前调用链可见的 Agent instruction。
+   */
+  get systems(): string[] {
+    const effective_systems = getSessionRunContext()?.agentSystems;
+    return effective_systems
+      ? [...effective_systems]
+      : this.configured_systems;
+  }
+
   /**
    * 读取指定 sessionId 对应的 session 端口。
    *

package/src/types/session/SessionLocalState.ts

@@ -18,6 +18,15 @@ export interface SessionLocalState {
    */
   sessionConfig: AgentSessionConfigSnapshot;
 
+  /**
+   * 当前 Session step 实际使用的 Session 配置。
+   *
+   * 关键点（中文）
+   * - `sessionConfig` 是配置 API 最近一次成功写入的 configured state。
+   * - 该字段只在 Session step 检查点由队列 mutation 更新。
+   */
+  effective_session_config: AgentSessionConfigSnapshot;
+
   /**
    * 当前 session 创建时间（毫秒时间戳）。
    */

package/src/types/session/SessionMessage.ts

@@ -228,26 +228,30 @@ export type SessionMessage =
 
 /** 读取 Session Message snapshot 的分页输入。 */
 export interface ListSessionMessagesInput {
-  /** 单页数量上限。 */
-  limit?: number;
-  /** 上一页返回的透明游标。 */
-  cursor?: string;
-  /** 只返回 sequence 严格小于该值的 Message，供向前翻页。 */
+  /**
+   * 返回该 sequence 之前的最近一个完整历史 Segment。
+   *
+   * 必须是正整数；省略时直接返回 Active 中的全部 Message。
+   */
   before_sequence?: number;
   /** 是否包含 internal Message。 */
   include_internal?: boolean;
-  /** 只返回不大于该 sequence 的 Message。 */
-  through_sequence?: number;
 }
 
 /** Session Message snapshot 分页结果。 */
 export interface SessionMessagePage {
-  /** 当前页按 sequence 升序排列的 Message。 */
+  /** 当前 Active 或 Segment 中按 sequence 升序排列的 Message。 */
   items: SessionMessage[];
-  /** 当前过滤条件下的 Message 总数。 */
+  /** 当前 Session 已分配的真实 Message 总数。 */
   total: number;
-  /** 下一页透明游标。 */
-  next_cursor?: string;
-  /** 是否仍有更多 Message。 */
+  /** 当前结果来自 Active 还是已关闭 Segment。 */
+  source: "active" | "segment";
+  /** 当前结果覆盖的第一条真实 Message sequence。 */
+  start_sequence?: number;
+  /** 当前结果覆盖的最后一条真实 Message sequence。 */
+  end_sequence?: number;
+  /** 继续向前读取时应作为 before_sequence 传入的边界。 */
+  next_before_sequence?: number;
+  /** 当前结果之前是否仍有更早 Segment。 */
   has_more: boolean;
 }

package/src/types/session/SessionMutation.ts

@@ -1,7 +1,7 @@
 /**
  * Session 的统一实时 Mutation 协议。
  *
- * Mutation 描述订阅之后发生的状态变化，不等同于 messages.jsonl 持久化格式。
+ * Mutation 描述订阅之后发生的状态变化，不等同于 Active/Segment 持久化格式。
  */
 
 import type { SessionAssistantMessagePart, SessionMessage } from "@/types/session/SessionMessage.js";

package/src/types/session/SessionOptions.ts

@@ -11,6 +11,8 @@ import type { Tool } from "ai";
 import type { AgentSession } from "@/types/agent/SessionActor.js";
 import type { SessionPort } from "@/types/runtime/agent/AgentContext.js";
 import type { AgentSessionSystemBlock } from "@/types/agent/SessionTypes.js";
+import type { AgentPluginExecutionRuntime } from "@/types/plugin/PluginRuntime.js";
+import type { AgentSessionCommand } from "@/types/session/SessionQueueCommand.js";
 import type { SessionComposerOptions } from "@/types/session/SessionComposerOptions.js";
 import type { Logger } from "@/utils/logger/Logger.js";
 import type { AgentModel } from "@/model/CityModelAdapter.js";
@@ -40,6 +42,13 @@ export interface AgentManagedSession extends AgentSession {
    * 返回当前 session 是否正在执行。
    */
   isExecuting(): boolean;
+
+  /**
+   * 把 Agent configured state command 加入当前 Session 的统一输入队列。
+   */
+  enqueue_agent_command(
+    command: AgentSessionCommand,
+  ): void;
 }
 
 /**
@@ -76,6 +85,18 @@ export interface SessionOptions {
    */
   getInstructionSystemBlocks: () => AgentSessionSystemBlock[];
 
+  /**
+   * 读取当前 Agent configured env。
+   *
+   * 关键点（中文）
+   * - Session 创建时用它建立初始 effective env。
+   * - 后续 Agent env 修改通过 Session command 在 step 检查点执行。
+   */
+  getAgentEnv: () => Record<string, string>;
+
+  /** 创建当前 Agent configured plugin 的 Session step 执行视图。 */
+  get_agent_plugins: () => AgentPluginExecutionRuntime;
+
   /**
    * 读取当前 agent 显式注入的受托管 plugin system blocks。
    */

package/src/types/session/SessionQueueCommand.ts

@@ -0,0 +1,78 @@
+/**
+ * Session queue command 运行时类型。
+ *
+ * 关键点（中文）
+ * - 配置 API 负责把 configured state 修改成功后创建 command。
+ * - command 与 steer 共用 Session 输入队列，并在下一次 Session step 检查点执行。
+ * - 这里只描述进程内提交协议，不属于持久化格式或公开 SDK 协议。
+ */
+
+import type { AgentSessionSystemBlock } from "@/types/agent/SessionTypes.js";
+import type { AgentPluginExecutionRuntime } from "@/types/plugin/PluginRuntime.js";
+
+/**
+ * Session queue command 的归属作用域。
+ */
+export type SessionQueueCommandScope = "agent" | "session";
+
+/**
+ * Session queue command 执行时的 step 上下文。
+ */
+export interface SessionQueueCommandContext {
+  /** 当前公开 Session turn 标识。 */
+  turn_id: string;
+}
+
+/**
+ * 等待在 Session step 检查点执行的 command。
+ */
+export interface SessionQueueCommand {
+  /** 当前队列项固定为 command。 */
+  type: "command";
+
+  /** 当前 command 的稳定唯一标识。 */
+  command_id: string;
+
+  /** 当前配置修改属于 Agent 还是 Session。 */
+  scope: SessionQueueCommandScope;
+
+  /**
+   * 把 configured state 提交为当前 Session 的 effective state。
+   *
+   * 关键点（中文）
+   * - effective state 提交失败时可以抛错，但不能让后续 command 静默丢失。
+   * - action message 是提交后的观测记录，写入失败不能回滚已经生效的配置。
+   */
+  execute(context: SessionQueueCommandContext): Promise<void>;
+}
+
+/**
+ * Agent configured state 广播给已有 Session 的 command。
+ */
+export type AgentSessionCommand =
+  | {
+      /** 当前修改固定为 instruction。 */
+      type: "instruction";
+      /** 当前 command 唯一标识。 */
+      command_id: string;
+      /** 下一 Session step 使用的 instruction blocks。 */
+      instruction_blocks: AgentSessionSystemBlock[];
+    }
+  | {
+      /** 当前修改固定为 env。 */
+      type: "env";
+      /** 当前 command 唯一标识。 */
+      command_id: string;
+      /** 下一 Session step 使用的完整 Agent env。 */
+      env: Record<string, string>;
+    }
+  | {
+      /** 当前修改固定为 plugin registry。 */
+      type: "plugins";
+      /** 当前 command 唯一标识。 */
+      command_id: string;
+      /** 当前 plugin 配置修改的用户可读标题。 */
+      title: string;
+      /** 下一 Session step 使用的 Plugin 执行视图。 */
+      plugins: AgentPluginExecutionRuntime;
+    };