@downcity/agent 1.1.237 → 1.1.258

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

@@ -0,0 +1,99 @@
+/**
+ * Session Composer 类型。
+ *
+ * Composer 是自定义 Session 的执行策略边界：它只读取 Session 的只读快照，
+ * 负责组装模型输入和生成压缩计划，不持久化 Message、Metadata 或事件。
+ */
+import type { LanguageModel, SystemModelMessage, Tool } from "ai";
+import type { SessionRecordV1 } from "../../executor/types/SessionRecords.js";
+import type { AgentSessionSystemBlock } from "../../types/agent/SessionTypes.js";
+import type { SessionContextSnapshot, SessionSegmentSummary } from "../../types/session/SessionSegment.js";
+/** Composer 可读取的 Session 身份快照。 */
+export interface SessionComposeIdentity {
+    /** 当前 Agent 的稳定标识。 */
+    agent_id: string;
+    /** 当前 Session 的稳定标识。 */
+    session_id: string;
+    /** 当前 Agent 项目的绝对根目录。 */
+    project_root: string;
+    /** 当前 Session 的创建时间戳，单位为毫秒。 */
+    created_at: number;
+    /** 当前 Session 使用的参考时区。 */
+    timezone: string;
+}
+/** Composer 可读取的当前 Step 生效状态。 */
+export interface SessionComposeState {
+    /** 当前 Step 使用的模型实例；只读查询允许为空。 */
+    model?: LanguageModel;
+    /** 当前模型声明的上下文窗口，单位为 token。 */
+    model_context_window?: number;
+    /** 当前 Step 生效的 Agent 环境变量快照。 */
+    env: Readonly<Record<string, string>>;
+    /** 当前 Step 生效的 Agent instruction 文本。 */
+    systems: readonly string[];
+    /** 当前 Step 可使用的工具集合。 */
+    tools: Readonly<Record<string, Tool>>;
+    /** 当前 Step 生效的 instruction system blocks。 */
+    instruction_system_blocks: readonly AgentSessionSystemBlock[];
+    /** 当前 Session 由宿主注入的 system blocks。 */
+    managed_plugin_system_blocks: readonly AgentSessionSystemBlock[];
+    /** 当前 Step 捕获的 Plugin system blocks。 */
+    plugin_system_blocks: readonly AgentSessionSystemBlock[];
+}
+/** Composer 可读取的当前 Turn 快照。 */
+export interface SessionComposeTurn {
+    /** 当前 Turn 标识；只读查询场景允许为空。 */
+    turn_id?: string;
+    /** 当前执行因上下文超限而进行的重试次数。 */
+    retry_count: number;
+}
+/** 单次模型输入组装参数。 */
+export interface SessionComposeInput {
+    /** 当前 Session 身份快照。 */
+    session: SessionComposeIdentity;
+    /** 当前 Step 已生效的运行状态。 */
+    state: SessionComposeState;
+    /** 当前 Session 的累计 Summary 与 Active Message 快照。 */
+    history: Readonly<SessionContextSnapshot>;
+    /** 当前 Turn 快照。 */
+    turn: SessionComposeTurn;
+}
+/** Composer 为一次模型 Step 生成的完整输入。 */
+export interface SessionStepInput {
+    /** 当前 Step 的 system messages。 */
+    system: SystemModelMessage[];
+    /** 当前 Step 的可解释 system block；自定义 Composer 可以省略。 */
+    system_blocks?: AgentSessionSystemBlock[];
+    /** 当前 Step 的历史与用户消息。 */
+    messages: SessionRecordV1[];
+    /** 当前 Step 可调用的工具集合。 */
+    tools: Record<string, Tool>;
+}
+/** 持久化上下文压缩的组装参数。 */
+export interface SessionCompactionInput extends SessionComposeInput {
+    /** 是否由调用方明确要求执行持久化压缩。 */
+    force: boolean;
+}
+/** Composer 生成、等待 SessionMessages 提交的压缩计划。 */
+export interface SessionCompactionPlan {
+    /** Active 中最后一条需要移入 Segment 的 Message sequence。 */
+    through_sequence: number;
+    /** 新 Segment 使用的累计 Summary。 */
+    summary: SessionSegmentSummary;
+    /** 当前计划覆盖到的最后一条 Message 标识。 */
+    boundary_message_id: string;
+    /** Summary 是否因为模型失败而使用了确定性降级内容。 */
+    used_fallback: boolean;
+}
+/** Session 级可替换执行策略。 */
+export interface SessionComposer {
+    /** Composer 的稳定可读名称。 */
+    readonly name: string;
+    /** 组装一次模型 Step 使用的 system、history 与 tools。 */
+    compose(input: SessionComposeInput): Promise<SessionStepInput>;
+    /** 根据只读历史生成压缩计划；无需压缩时返回空。 */
+    compact(input: SessionCompactionInput): Promise<SessionCompactionPlan | null>;
+    /** 判断给定错误是否应在持久化压缩后重试。 */
+    should_compact(error: unknown): boolean;
+}
+//# sourceMappingURL=SessionComposer.d.ts.map

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

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

package/bin/types/session/SessionComposer.js

@@ -0,0 +1,8 @@
+/**
+ * Session Composer 类型。
+ *
+ * Composer 是自定义 Session 的执行策略边界：它只读取 Session 的只读快照，
+ * 负责组装模型输入和生成压缩计划，不持久化 Message、Metadata 或事件。
+ */
+export {};
+//# sourceMappingURL=SessionComposer.js.map

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

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

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

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - 这里承载本地 Session 在内存中的可变运行态。
- * - state / turn / view 三类 service 通过共享该对象协作，避免彼此复制状态。
+ * - `SessionState` 与 `Session` 共享该对象，避免重复维护配置状态。
  * - 这里只保存运行态，不承载行为逻辑。
  */
 import type { AgentSessionConfigSnapshot } from "../../types/agent/SessionTypes.js";
@@ -14,19 +14,19 @@ export interface SessionLocalState {
     /**
      * 当前 session 配置快照。
      */
-    sessionConfig: AgentSessionConfigSnapshot;
+    session_config: AgentSessionConfigSnapshot;
     /**
      * 当前 Session step 实际使用的 Session 配置。
      *
      * 关键点（中文）
-     * - `sessionConfig` 是配置 API 最近一次成功写入的 configured state。
+     * - `session_config` 是配置 API 最近一次成功写入的 configured state。
      * - 该字段只在 Session step 检查点由队列 mutation 更新。
      */
     effective_session_config: AgentSessionConfigSnapshot;
     /**
      * 当前 session 创建时间（毫秒时间戳）。
      */
-    createdAt: number;
+    created_at: number;
     /**
      * 当前 session 参考时区。
      */
@@ -34,10 +34,10 @@ export interface SessionLocalState {
     /**
      * initialize() 过程中的并发复用 Promise。
      */
-    initializePromise: Promise<void> | null;
+    initialize_promise: Promise<void> | null;
     /**
      * ensureReadyForExecution() 过程中的并发复用 Promise。
      */
-    ensureConfiguredPromise: Promise<void> | null;
+    ensure_configured_promise: Promise<void> | null;
 }
 //# sourceMappingURL=SessionLocalState.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"SessionLocalState.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionLocalState.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,aAAa,EAAE,0BAA0B,CAAC;IAE1C;;;;;;OAMG;IACH,wBAAwB,EAAE,0BAA0B,CAAC;IAErD;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,iBAAiB,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAExC;;OAEG;IACH,uBAAuB,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC/C"}
+{"version":3,"file":"SessionLocalState.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionLocalState.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,cAAc,EAAE,0BAA0B,CAAC;IAE3C;;;;;;OAMG;IACH,wBAAwB,EAAE,0BAA0B,CAAC;IAErD;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,kBAAkB,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAEzC;;OAEG;IACH,yBAAyB,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACjD"}

package/bin/types/session/SessionLocalState.js

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - 这里承载本地 Session 在内存中的可变运行态。
- * - state / turn / view 三类 service 通过共享该对象协作，避免彼此复制状态。
+ * - `SessionState` 与 `Session` 共享该对象，避免重复维护配置状态。
  * - 这里只保存运行态，不承载行为逻辑。
  */
 export {};

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

@@ -5,6 +5,7 @@
  * 均为内部 part，不提升为顶层消息。
  */
 import type { JsonObject, JsonValue } from "../../types/common/Json.js";
+import type { SessionApproval } from "../../types/session/SessionApproval.js";
 /** Message 默认展示范围。 */
 export type SessionMessageVisibility = "visible" | "internal";
 /** 从其他 Session 导入时保留的来源身份。 */
@@ -118,8 +119,8 @@ export interface SessionAssistantToolPart {
     output?: JsonValue;
     /** 工具失败信息。 */
     error?: string;
-    /** 工具审批请求标识。 */
-    approval_id?: string;
+    /** 当前 Tool 等待或已经处理过的完整审批快照。 */
+    approval?: SessionApproval;
 }
 /** Assistant 文件 part。 */
 export interface SessionAssistantFilePart {

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

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

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

@@ -0,0 +1,115 @@
+/**
+ * SessionMessages 输入与构造类型。
+ *
+ * 这些类型只描述 canonical Message 领域入口的参数，不包含持久化行为。
+ */
+import type { JsonObject } from "../../types/common/Json.js";
+import type { SessionRecordV1 } from "../../executor/types/SessionRecords.js";
+import type { JsonlSessionMessageStore } from "../../session/messages/JsonlSessionMessageStore.js";
+import type { AgentSessionPromptInput } from "../../types/sdk/AgentSessionPrompt.js";
+import type { SessionAssistantMessagePart, SessionUserMessagePart } from "../../types/session/SessionMessage.js";
+import type { SessionMutation } from "../../types/session/SessionMutation.js";
+/** SessionMessages 构造参数。 */
+export interface SessionMessagesOptions {
+    /** 当前 Session 标识。 */
+    session_id: string;
+    /** Message 快照持久化 Store。 */
+    store: JsonlSessionMessageStore;
+    /** 持久化成功后的实时 Mutation 发布函数。 */
+    publish: (mutation: SessionMutation) => void;
+}
+/** User Message 创建参数。 */
+export interface AppendSessionUserMessageInput {
+    /** 当前输入所属 Turn。 */
+    turn_id: string;
+    /** 当前输入是普通 Prompt 还是 Steering 输入。 */
+    input_type: "prompt" | "steer";
+    /** User 结构化 Part。 */
+    parts: SessionUserMessagePart[];
+    /** 可选的稳定 Message 标识。 */
+    message_id?: string;
+    /** 当前 Message 的默认展示范围。 */
+    visibility?: "visible" | "internal";
+}
+/** Assistant Message 创建参数。 */
+export interface OpenSessionAssistantMessageInput {
+    /** 当前 Assistant 所属 Turn。 */
+    turn_id: string;
+    /** 当前 Assistant 在 Turn 内的 Segment 序号。 */
+    segment_index: number;
+    /** 当前 Assistant 是普通回复还是压缩 Summary。 */
+    kind?: "normal" | "summary";
+    /** 当前 Message 的默认展示范围。 */
+    visibility?: "visible" | "internal";
+    /** 可选的稳定 Message 标识。 */
+    message_id?: string;
+    /** Summary 已覆盖到的来源 Message 标识。 */
+    summary_through_message_id?: string;
+}
+/** 已完成 Assistant Message 的直接写入参数。 */
+export interface AppendCompletedAssistantMessageInput {
+    /** 当前 Assistant 所属 Turn。 */
+    turn_id?: string;
+    /** Assistant 完整结构化 Part。 */
+    parts: SessionAssistantMessagePart[];
+    /** 当前 Assistant 是普通回复还是压缩 Summary。 */
+    kind?: "normal" | "summary";
+    /** 当前 Message 的默认展示范围。 */
+    visibility?: "visible" | "internal";
+    /** Summary 已覆盖到的来源 Message 标识。 */
+    summary_through_message_id?: string;
+}
+/** Action Message 创建参数。 */
+export interface OpenSessionActionMessageInput {
+    /** 可选的稳定 Message 标识，用于更新同一个 Action 生命周期。 */
+    message_id?: string;
+    /** 当前 Action 所属 Turn。 */
+    turn_id?: string;
+    /** 当前 Action 的业务类型。 */
+    action_type: string;
+    /** 当前 Action 标题。 */
+    title: string;
+    /** 当前 Action 描述。 */
+    description?: string;
+    /** 当前 Action 附加数据。 */
+    data?: JsonObject;
+}
+/** Error Message 创建参数。 */
+export interface AppendSessionErrorMessageInput {
+    /** 当前错误影响 Session 还是单个 Turn。 */
+    scope: "session" | "turn";
+    /** 当前错误所属 Turn。 */
+    turn_id?: string;
+    /** 当前错误的稳定业务码。 */
+    code: string;
+    /** 当前错误的用户可见文本。 */
+    message: string;
+    /** 当前错误是否允许恢复。 */
+    recoverable: boolean;
+}
+/** 公开 Session API 追加 User Message 的输入。 */
+export interface AppendExternalSessionUserMessageInput {
+    /** 可选的结构化 User Record。 */
+    message?: SessionRecordV1 | null;
+    /** 未提供结构化 Record 时使用的纯文本。 */
+    text?: string;
+}
+/** 公开 Session API 追加 Assistant Message 的输入。 */
+export interface AppendExternalSessionAssistantMessageInput {
+    /** 可选的结构化 Assistant Record。 */
+    message?: SessionRecordV1 | null;
+    /** 未提供结构化 Record 时使用的纯文本。 */
+    fallback_text?: string;
+}
+/** Session Prompt 转换并持久化的输入。 */
+export interface AppendSessionPromptMessageInput {
+    /** 当前 Agent 项目的绝对根目录，用于解析本地附件。 */
+    project_root: string;
+    /** 当前 Session Prompt 输入。 */
+    prompt: AgentSessionPromptInput;
+    /** 当前输入所属 Turn。 */
+    turn_id: string;
+    /** 当前输入是普通 Prompt 还是 Steering 输入。 */
+    input_type: "prompt" | "steer";
+}
+//# sourceMappingURL=SessionMessages.d.ts.map

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

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

package/bin/types/session/SessionMessages.js

@@ -0,0 +1,7 @@
+/**
+ * SessionMessages 输入与构造类型。
+ *
+ * 这些类型只描述 canonical Message 领域入口的参数，不包含持久化行为。
+ */
+export {};
+//# sourceMappingURL=SessionMessages.js.map

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

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

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

@@ -4,7 +4,6 @@
  * Mutation 描述订阅之后发生的状态变化，不等同于 Active/Segment 持久化格式。
  */
 import type { SessionAssistantMessagePart, SessionMessage } from "../../types/session/SessionMessage.js";
-import type { ResolveSessionApprovalInput, SessionApprovalResult } from "../../types/session/SessionApproval.js";
 /** 所有 Session Mutation 的公共字段。 */
 export interface SessionMutationBase {
     /** 当前 Mutation 的稳定唯一标识。 */
@@ -99,16 +98,8 @@ export type SessionStateMutation = SessionMutationBase & {
 };
 /** Session 对外唯一实时 Mutation 联合类型。 */
 export type SessionMutation = SessionMessageMutation | SessionPartMutation | SessionDeltaMutation | SessionTurnMutation | SessionStateMutation;
-/** 当前 Mutation 可用的命令回复入口。 */
-export interface SessionMutationReply {
-    /**
-     * 回复当前 Tool Part 的审批请求。
-     * 只有 approval-required Tool Part Mutation 可以成功调用。
-     */
-    approval(input: Pick<ResolveSessionApprovalInput, "decision">): Promise<SessionApprovalResult>;
-}
 /** Session Mutation 订阅回调。 */
-export type SessionMutationSubscriber = (mutation: SessionMutation, reply: SessionMutationReply) => void | Promise<void>;
+export type SessionMutationSubscriber = (mutation: SessionMutation) => void | Promise<void>;
 /** 取消 Session Mutation 订阅的函数。 */
 export type SessionMutationUnsubscribe = () => void;
 /** 判断未知事件是否为 Session Mutation。 */

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"SessionMutation.js","sourceRoot":"","sources":["../../../src/types/session/SessionMutation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA4HH,kCAAkC;AAClC,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,SAAS,GAAG,KAAqE,CAAC;IACxF,IAAI,OAAO,SAAS,CAAC,WAAW,KAAK,QAAQ,IAAI,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClG,OAAO,CACL,SAAS,CAAC,OAAO,KAAK,SAAS;QAC/B,SAAS,CAAC,OAAO,KAAK,MAAM;QAC5B,SAAS,CAAC,OAAO,KAAK,OAAO;QAC7B,SAAS,CAAC,OAAO,KAAK,MAAM;QAC5B,SAAS,CAAC,OAAO,KAAK,SAAS,CAChC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"SessionMutation.js","sourceRoot":"","sources":["../../../src/types/session/SessionMutation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiHH,kCAAkC;AAClC,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,SAAS,GAAG,KAAqE,CAAC;IACxF,IAAI,OAAO,SAAS,CAAC,WAAW,KAAK,QAAQ,IAAI,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClG,OAAO,CACL,SAAS,CAAC,OAAO,KAAK,SAAS;QAC/B,SAAS,CAAC,OAAO,KAAK,MAAM;QAC5B,SAAS,CAAC,OAAO,KAAK,OAAO;QAC7B,SAAS,CAAC,OAAO,KAAK,MAAM;QAC5B,SAAS,CAAC,OAAO,KAAK,SAAS,CAChC,CAAC;AACJ,CAAC"}

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

@@ -7,15 +7,14 @@
  * - Composer 仍然是 Session 级能力，不向 Agent 的执行策略层泄漏。
  */
 import type { Tool } from "ai";
+import type { AgentModel } from "../../agent/AgentModel.js";
 import type { AgentSession } from "../../types/agent/SessionActor.js";
-import type { SessionPort } from "../../types/runtime/agent/AgentContext.js";
+import type { SessionPort } from "../../types/session/SessionPort.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 { AgentSessionCommand } from "../../types/session/SessionQueue.js";
+import type { SessionComposer } from "../../types/session/SessionComposer.js";
 import type { Logger } from "../../utils/logger/Logger.js";
-import type { AgentModel } from "../../model/CityModelAdapter.js";
-import type { ResolveSessionApprovalInput, SessionApproval, SessionApprovalModeSnapshot, SessionApprovalResult, SetSessionApprovalModeInput } from "../../types/session/SessionApproval.js";
 /**
  * Agent 可管理的本地 Session 实例。
  */
@@ -79,27 +78,13 @@ export interface SessionOptions {
      * 读取当前 agent 显式注入的受托管 plugin system blocks。
      */
     getManagedPluginSystemBlocks: () => Promise<AgentSessionSystemBlock[]>;
-    /**
-     * 读取当前 agent 显式注册 plugin 的 system blocks。
-     */
-    getPluginSystemBlocks: () => Promise<AgentSessionSystemBlock[]>;
     /**
      * 在执行前确保当前 session 已完成宿主侧默认配置。
      */
     ensureConfigured?: (session: AgentManagedSession) => Promise<void>;
-    /** 按稳定模型 ID 解析当前 Session 的运行时模型。 */
-    resolve_model?: (model_id: string) => Promise<AgentModel>;
-    /** 列出当前 Session 的 pending 工具审批。 */
-    list_approvals: (session_id: string) => Promise<SessionApproval[]>;
-    /** 读取当前 Session 的工具审批模式。 */
-    get_approval_mode: (session_id: string) => Promise<SessionApprovalModeSnapshot>;
-    /** 更新当前 Session 的工具审批模式。 */
-    set_approval_mode: (session_id: string, input: SetSessionApprovalModeInput) => Promise<SessionApprovalModeSnapshot>;
-    /** 处理当前 Session 的 pending 工具审批。 */
-    resolve_approval: (session_id: string, input: ResolveSessionApprovalInput) => Promise<SessionApprovalResult>;
-    /**
-     * 当前 session 的 Composer 覆盖项。
-     */
-    composers?: SessionComposerOptions;
+    /** 读取 Agent 当前持有的运行时模型实例。 */
+    getAgentModel: () => AgentModel | undefined;
+    /** 当前 Session 使用的统一执行策略；省略时使用默认 Composer。 */
+    composer?: SessionComposer;
 }
 //# sourceMappingURL=SessionOptions.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"SessionOptions.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionOptions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AACnF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAClF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AACxF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EACV,2BAA2B,EAC3B,eAAe,EACf,2BAA2B,EAC3B,qBAAqB,EACrB,2BAA2B,EAC5B,MAAM,oCAAoC,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;OAEG;IACH,cAAc,IAAI,WAAW,CAAC;IAE9B;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC;IAEvB;;OAEG;IACH,qBAAqB,CACnB,OAAO,EAAE,mBAAmB,GAC3B,IAAI,CAAC;CACT;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE5B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,0BAA0B,EAAE,MAAM,uBAAuB,EAAE,CAAC;IAE5D;;;;;;OAMG;IACH,WAAW,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE1C,wDAAwD;IACxD,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;IAErD;;OAEG;IACH,4BAA4B,EAAE,MAAM,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAEvE;;OAEG;IACH,qBAAqB,EAAE,MAAM,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAEhE;;OAEG;IACH,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnE,oCAAoC;IACpC,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAE1D,mCAAmC;IACnC,cAAc,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAEnE,4BAA4B;IAC5B,iBAAiB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAEhF,4BAA4B;IAC5B,iBAAiB,EAAE,CACjB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,2BAA2B,KAC/B,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAE1C,mCAAmC;IACnC,gBAAgB,EAAE,CAChB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,2BAA2B,KAC/B,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAEpC;;OAEG;IACH,SAAS,CAAC,EAAE,sBAAsB,CAAC;CACpC"}
+{"version":3,"file":"SessionOptions.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionOptions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AACnF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;OAEG;IACH,cAAc,IAAI,WAAW,CAAC;IAE9B;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC;IAEvB;;OAEG;IACH,qBAAqB,CACnB,OAAO,EAAE,mBAAmB,GAC3B,IAAI,CAAC;CACT;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE5B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,0BAA0B,EAAE,MAAM,uBAAuB,EAAE,CAAC;IAE5D;;;;;;OAMG;IACH,WAAW,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE1C,wDAAwD;IACxD,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;IAErD;;OAEG;IACH,4BAA4B,EAAE,MAAM,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAEvE;;OAEG;IACH,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnE,6BAA6B;IAC7B,aAAa,EAAE,MAAM,UAAU,GAAG,SAAS,CAAC;IAE5C,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B"}

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

@@ -0,0 +1,72 @@
+/**
+ * Session runtime 端口类型。
+ *
+ * 职责说明（中文）
+ * - 定义 Plugin、transport 与 Agent 内部运行时访问单个 Session 的稳定协议。
+ * - 不暴露具体 Session class，也不包含 Session 集合管理能力。
+ */
+import type { LanguageModel } from "ai";
+import type { SessionMetadataV1, SessionRecordV1 } from "../../executor/types/SessionRecords.js";
+import type { SessionRunInput, SessionRunResult } from "../../executor/types/SessionRun.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 "../../types/session/SessionMutation.js";
+import type { SessionContextSnapshot } from "../../types/session/SessionSegment.js";
+/**
+ * 单个 Session 执行端口。
+ */
+export interface SessionExecutorPort {
+    /** 执行一次 Session run。 */
+    run(params: SessionRunInput): Promise<SessionRunResult>;
+    /**
+     * 请求取消当前正在执行的 turn。
+     *
+     * @returns `true` 表示已发出取消请求；`false` 表示当前没有可取消的执行。
+     */
+    stop(): boolean;
+}
+/**
+ * 单个 Session 实例端口。
+ */
+export interface SessionPort {
+    /** 当前 Session 稳定标识。 */
+    readonly sessionId: string;
+    /** 获取当前 Session 优先解析后的运行时模型实例。 */
+    getModel(): LanguageModel | undefined;
+    /** 获取当前 Session 的执行端口。 */
+    getExecutor(): SessionExecutorPort;
+    /** 读取当前 Session 的累计 Summary 与 Active Message 快照。 */
+    context(): Promise<SessionContextSnapshot>;
+    /** 向当前 Session actor 追加一条新的 prompt。 */
+    prompt(input: AgentSessionPromptInput): Promise<AgentSessionTurnHandle>;
+    /** 停止当前 turn，并取消尚未被吸收的排队 prompt。 */
+    stop(): Promise<AgentSessionStopResult>;
+    /** 订阅当前 Session 后续产生的 future 事件。 */
+    subscribe(subscriber: SessionMutationSubscriber): SessionMutationUnsubscribe;
+    /**
+     * 追加一条 user 消息。
+     */
+    append_user_message(params: {
+        /** 已构造好的完整消息。 */
+        message?: SessionRecordV1 | null;
+        /** 未传入完整消息时使用的兜底文本。 */
+        text?: string;
+        /** 当前消息附加元数据。 */
+        extra?: SessionMetadataV1["extra"];
+    }): Promise<void>;
+    /**
+     * 追加一条 assistant 消息。
+     */
+    append_assistant_message(params: {
+        /** 已构造好的完整消息。 */
+        message?: SessionRecordV1 | null;
+        /** 未传入完整消息时使用的兜底文本。 */
+        fallbackText?: string;
+        /** 当前消息附加元数据。 */
+        extra?: SessionMetadataV1["extra"];
+    }): Promise<void>;
+    /** 返回当前 Session 是否正在执行。 */
+    isExecuting(): boolean;
+}
+//# sourceMappingURL=SessionPort.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SessionPort.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionPort.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxC,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EAChB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EACjB,MAAM,gCAAgC,CAAC;AACxC,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,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,wBAAwB;IACxB,GAAG,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAExD;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uBAAuB;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,kCAAkC;IAClC,QAAQ,IAAI,aAAa,GAAG,SAAS,CAAC;IAEtC,0BAA0B;IAC1B,WAAW,IAAI,mBAAmB,CAAC;IAEnC,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,iBAAiB;QACjB,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;QAEjC,uBAAuB;QACvB,IAAI,CAAC,EAAE,MAAM,CAAC;QAEd,iBAAiB;QACjB,KAAK,CAAC,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC;KACpC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElB;;OAEG;IACH,wBAAwB,CAAC,MAAM,EAAE;QAC/B,iBAAiB;QACjB,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;QAEjC,uBAAuB;QACvB,YAAY,CAAC,EAAE,MAAM,CAAC;QAEtB,iBAAiB;QACjB,KAAK,CAAC,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC;KACpC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElB,2BAA2B;IAC3B,WAAW,IAAI,OAAO,CAAC;CACxB"}

package/bin/types/session/SessionPort.js

@@ -0,0 +1,9 @@
+/**
+ * Session runtime 端口类型。
+ *
+ * 职责说明（中文）
+ * - 定义 Plugin、transport 与 Agent 内部运行时访问单个 Session 的稳定协议。
+ * - 不暴露具体 Session class，也不包含 Session 集合管理能力。
+ */
+export {};
+//# sourceMappingURL=SessionPort.js.map

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

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