@downcity/agent 1.1.287 → 1.1.310

package/src/types/session/SessionQueue.ts

@@ -1,102 +0,0 @@
-/**
- * Session 输入队列类型。
- *
- * 队列只保存明确的输入事实，不保存可执行闭包。SessionTurn 是这些输入的唯一解释者。
- */
-
-import type { AgentSessionConfigSnapshot } from "@/types/agent/SessionTypes.js";
-import type { AgentPluginExecutionRuntime } from "@/types/plugin/PluginRuntime.js";
-import type { AgentSessionPromptInput } from "@/types/sdk/AgentSessionPrompt.js";
-import type { AgentSessionTurnHandle } from "@/types/sdk/AgentSessionTurn.js";
-
-/** Session 模型配置在 Step 检查点生效的命令。 */
-export interface SessionModelQueueCommand {
-  /** 命令种类固定为 Session 模型更新。 */
-  type: "session_model";
-  /** 当前命令的稳定唯一标识。 */
-  command_id: string;
-  /** 等待提交为 effective state 的完整 Session 配置。 */
-  config: AgentSessionConfigSnapshot;
-  /** 配置生效后需要写入的可选 Action 标识。 */
-  action_id?: string;
-  /** 配置生效后需要写入的可选 Action 标题。 */
-  action_title?: string;
-}
-
-/** Agent env 在 Session Step 检查点生效的命令。 */
-export interface SessionEnvQueueCommand {
-  /** 命令种类固定为 Agent env 更新。 */
-  type: "agent_env";
-  /** 当前命令的稳定唯一标识。 */
-  command_id: string;
-  /** 下一 Step 使用的完整环境变量快照。 */
-  env: Record<string, string>;
-}
-
-/** Agent Plugin 视图在 Session Step 检查点生效的命令。 */
-export interface SessionPluginsQueueCommand {
-  /** 命令种类固定为 Agent Plugin 更新。 */
-  type: "agent_plugins";
-  /** 当前命令的稳定唯一标识。 */
-  command_id: string;
-  /** 当前 Plugin 修改的用户可读标题。 */
-  title: string;
-  /** 下一 Step 使用的 Plugin 执行视图。 */
-  plugins: AgentPluginExecutionRuntime;
-}
-
-/** 显式持久化历史压缩命令。 */
-export interface SessionCompactQueueCommand {
-  /** 命令种类固定为 compact。 */
-  type: "compact";
-  /** 当前命令的稳定唯一标识。 */
-  command_id: string;
-}
-
-/** Session FIFO 中允许出现的领域命令。 */
-export type SessionQueueCommand =
-  | SessionModelQueueCommand
-  | SessionEnvQueueCommand
-  | SessionPluginsQueueCommand
-  | SessionCompactQueueCommand;
-
-/** Agent configured state 广播给既有 Session 的输入。 */
-export type AgentSessionCommand = {
-    /** 当前修改固定为 env。 */
-    type: "env";
-    /** 当前命令唯一标识。 */
-    command_id: string;
-    /** 下一 Session Step 使用的完整 Agent env。 */
-    env: Record<string, string>;
-  }
-  | {
-      /** 当前修改固定为 plugins。 */
-      type: "plugins";
-      /** 当前命令唯一标识。 */
-      command_id: string;
-      /** 当前 Plugin 修改的用户可读标题。 */
-      title: string;
-      /** 下一 Session Step 使用的 Plugin 执行视图。 */
-      plugins: AgentPluginExecutionRuntime;
-    };
-
-/** Promise 的显式兑现控制器。 */
-export interface SessionQueueDeferred<T> {
-  /** 调用方等待的 Promise。 */
-  promise: Promise<T>;
-  /** 成功兑现 Promise。 */
-  resolve: (value: T) => void;
-}
-
-/** FIFO 中等待创建或并入 Turn 的 Prompt。 */
-export interface SessionQueuedPrompt {
-  /** 队列项种类固定为 prompt。 */
-  type: "prompt";
-  /** 当前 Prompt 的结构化输入。 */
-  input: AgentSessionPromptInput;
-  /** 等待 SessionTurn 返回 Turn Handle 的控制器。 */
-  deferred_handle: SessionQueueDeferred<AgentSessionTurnHandle>;
-}
-
-/** Session FIFO 中的全部输入类型。 */
-export type SessionQueueItem = SessionQueuedPrompt | SessionQueueCommand;

package/src/types/session/SessionTurn.ts

@@ -1,56 +0,0 @@
-/**
- * SessionTurn 构造参数与内部运行态类型。
- *
- * 这些类型描述 Turn 编排所依赖的领域对象，不实现任何调度行为。
- */
-
-import type { Executor } from "@/executor/Executor.js";
-import type { SessionApprovalBroker } from "@/session/approval/SessionApprovalBroker.js";
-import type { SessionEventHub } from "@/session/runtime/SessionEventHub.js";
-import type { SessionMessages } from "@/session/SessionMessages.js";
-import type { SessionState } from "@/session/SessionState.js";
-import type { AgentSessionTurnResult } from "@/types/sdk/AgentSessionTurn.js";
-import type { SessionQueueCommand } from "@/types/session/SessionQueue.js";
-
-/** Promise 延迟控制器。 */
-export interface SessionDeferred<T> {
-  /** 等待兑现的 Promise。 */
-  promise: Promise<T>;
-  /** 兑现 Promise 的函数。 */
-  resolve: (value: T) => void;
-}
-
-/** 当前活跃 Turn 的内存状态。 */
-export interface ActiveSessionTurnState {
-  /** 当前 Turn 的稳定标识。 */
-  turn_id: string;
-  /** 当前 Turn 的最终结果快照。 */
-  result: AgentSessionTurnResult | null;
-  /** 当前 Turn 完成状态的延迟控制器。 */
-  deferred_finished: SessionDeferred<AgentSessionTurnResult>;
-  /** 当前 Turn 的取消控制器。 */
-  abort_controller: AbortController;
-}
-
-/** SessionTurn 构造参数。 */
-export interface SessionTurnOptions {
-  /** 当前 Session 的稳定标识。 */
-  session_id: string;
-  /** 当前项目的绝对根目录。 */
-  project_root: string;
-  /** 当前 Session 的模型执行器。 */
-  executor: Executor;
-  /** 当前 Session 的配置与 Metadata 状态。 */
-  state: SessionState;
-  /** 当前 Session 的 canonical Message 入口。 */
-  messages: SessionMessages;
-  /** 当前 Session 的 Mutation 总线。 */
-  events: SessionEventHub;
-  /** 当前 Session 的 Tool 审批入口。 */
-  approvals: SessionApprovalBroker;
-  /** 在 Step 检查点提交 Session 或 Agent 状态 Command。 */
-  apply_command: (
-    command: Exclude<SessionQueueCommand, { type: "compact" }>,
-    turn_id: string,
-  ) => Promise<void>;
-}