@downcity/agent 1.1.287 → 1.1.310

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

@@ -1 +1 @@
-{"version":3,"file":"SessionToolExecutionContext.d.ts","sourceRoot":"","sources":["../../../src/types/executor/SessionToolExecutionContext.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AACjF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE/E;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,8BAA8B;IAC9B,iBAAiB,EAAE,mBAAmB,CAAC;IACvC,mCAAmC;IACnC,mBAAmB,EAAE,iBAAiB,CAAC;CACxC"}
+{"version":3,"file":"SessionToolExecutionContext.d.ts","sourceRoot":"","sources":["../../../src/types/executor/SessionToolExecutionContext.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AACjF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAEjF;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,8BAA8B;IAC9B,iBAAiB,EAAE,mBAAmB,CAAC;IACvC,oCAAoC;IACpC,oBAAoB,EAAE,kBAAkB,CAAC;CAC1C"}

package/bin/types/executor/SessionToolExecutionContext.js

@@ -3,8 +3,8 @@
  *
  * 关键点（中文）
  * - 该对象由 Executor 在每个 Session step 绑定到 tool.execute。
- * - Agent 工具读取 session_run_context，Shell 工具只读取 shell_run_context。
- * - 上下文归属单次 run，不通过进程级或异步全局容器共享。
+ * - Agent 工具读取 session_turn_context，Shell 工具只读取 shell_run_context。
+ * - 上下文归属当前 Turn，不通过进程级或异步全局容器共享。
  */
 export {};
 //# sourceMappingURL=SessionToolExecutionContext.js.map

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

@@ -0,0 +1,125 @@
+/**
+ * SessionTurnContext：一次 Session Turn 的统一执行上下文契约。
+ *
+ * 关键点（中文）
+ * - 根对象统一承载一个 Turn 的身份、生命周期、Step、输入和输出协作能力。
+ * - 分区用于表达领域职责，不引入多套彼此独立的 Context。
+ * - 可变状态只能通过行为方法更新，消费者不能直接操作内部数组、lease 或 callback。
+ */
+import type { UIMessage } from "ai";
+import type { ShellApprovalGateway } from "@downcity/shell";
+import type { SessionUserMessageV1 } from "../../executor/types/SessionRecords.js";
+import type { SessionAssistantOutput } from "../../types/executor/SessionAssistantOutput.js";
+import type { AgentPluginExecutionLease } from "../../types/plugin/PluginRuntime.js";
+import type { PluginExecutionContext } from "../../types/plugin/PluginExecutionContext.js";
+import type { AgentSessionActionCallback, AgentSessionActionEvent, AgentSessionActionRecord } from "../../types/sdk/AgentSessionAction.js";
+import type { SessionInteractionPort } from "../../types/session/SessionInteraction.js";
+/**
+ * 创建一个 Session Turn 上下文所需的稳定输入。
+ *
+ * 该类型只服务 SDK 内部装配，不代表另一种运行上下文。
+ */
+export interface SessionTurnContextInit {
+    /** 当前执行所属的 Session 标识。 */
+    session_id: string;
+    /** 当前执行所属的非空 Turn 标识。 */
+    turn_id: string;
+    /** 当前 Agent 绑定的项目根目录。 */
+    project_root?: string;
+    /** 上游取消信号；上下文会把它转发到自身拥有的运行生命周期。 */
+    abort_signal?: AbortSignal;
+    /** 在 Step 检查点消费 Session 队列，并返回应并入模型上下文的 User 消息。 */
+    merge_step_input?: () => Promise<SessionUserMessageV1[]>;
+    /** 判断是否仍有等待下一个 Step 消费的 User prompt。 */
+    has_pending_step_input?: () => boolean;
+    /** 消费一次 canonical history 重载请求。 */
+    consume_history_reload?: () => boolean;
+    /** Executor 写入 canonical Assistant Message 使用的唯一输出端口。 */
+    assistant_output?: SessionAssistantOutput;
+    /** 当前 Session 执行面创建用户异步交互的端口。 */
+    interactions?: SessionInteractionPort;
+    /** 当前 Session 拥有的 unrestricted Shell 审批网关。 */
+    shell_approval_gateway?: ShellApprovalGateway;
+    /** 把辅助 Action 持久化并发布为 Session 事件的回调。 */
+    publish_action?: AgentSessionActionCallback;
+}
+/**
+ * 一个 Session Turn 的执行上下文中台。
+ */
+export interface SessionTurnContext {
+    /** 当前运行的稳定身份与项目归属。 */
+    readonly session: {
+        /** 当前执行所属的 Session 标识。 */
+        readonly session_id: string;
+        /** 当前执行所属的 Turn 标识。 */
+        readonly turn_id: string;
+        /** 当前 Agent 绑定的项目根目录。 */
+        readonly project_root?: string;
+    };
+    /** 当前运行的取消与清理生命周期。 */
+    readonly lifecycle: {
+        /** 模型、Tool 与长耗时任务共同监听的取消信号。 */
+        readonly abort_signal: AbortSignal;
+        /** 请求停止当前运行；重复调用保持幂等。 */
+        abort(reason?: unknown): void;
+        /** 释放上游信号监听与当前 Step 资源；重复调用保持幂等。 */
+        dispose(): Promise<void>;
+    };
+    /** 在明确 Step 检查点提交和读取的有效运行快照。 */
+    readonly step: {
+        /** 当前 Step 已提交生效的 Workspace env 快照。 */
+        readonly workspace_env?: Readonly<Record<string, string>>;
+        /** 当前 Step 已提交生效的 Agent instruction 快照。 */
+        readonly agent_systems: readonly string[];
+        /** 当前 Step 持有的 Plugin execution lease；仅供内核执行边界使用。 */
+        readonly plugins?: AgentPluginExecutionLease;
+        /** 原子提交当前 Step 使用的 env 与 instruction 快照。 */
+        commit(input: {
+            /** 即将在当前 Step 生效的 Workspace env。 */
+            workspace_env: Readonly<Record<string, string>>;
+            /** 即将在当前 Step 生效的 Agent instruction。 */
+            agent_systems: readonly string[];
+        }): void;
+        /** 切换当前 Step 的 Plugin lease，并先释放前一个 lease。 */
+        replace_plugins(plugins?: AgentPluginExecutionLease): Promise<void>;
+        /** 释放当前 Step 持有的 Plugin lease。 */
+        release(): Promise<void>;
+        /** 为 Plugin 生成只包含稳定、只读运行快照的新对象。 */
+        plugin_execution_context(): PluginExecutionContext;
+    };
+    /** 当前运行的动态 User 输入及延迟持久化输入。 */
+    readonly input: {
+        /** 在 Step 边界消费运行期注入消息与 Session 队列消息。 */
+        checkpoint(): Promise<SessionUserMessageV1[]>;
+        /** 判断是否有等待下一个 Step 消费的 Session prompt。 */
+        has_pending(): boolean;
+        /** 注入一条只影响当前运行、在下一 Step 生效的 User 消息。 */
+        inject_user_message(message: SessionUserMessageV1): void;
+        /** 延迟到 Assistant 结果落盘后再持久化一条 User 消息。 */
+        defer_user_message(message: SessionUserMessageV1): void;
+        /** 返回延迟持久化 User 消息的不可变快照。 */
+        deferred_user_messages(): readonly SessionUserMessageV1[];
+        /** 消费一次 canonical history 重载请求。 */
+        consume_history_reload(): boolean;
+    };
+    /** 当前运行的 Assistant Message 与辅助 Action 输出能力。 */
+    readonly output: {
+        /** canonical Assistant Message 的唯一写入端口。 */
+        readonly assistant?: SessionAssistantOutput;
+        /** 把 Action 产生的 Assistant Parts 加入当前 Step 收口队列。 */
+        enqueue_assistant_parts(parts: readonly UIMessage["parts"][number][]): void;
+        /** 消费当前 Step 中等待写入 canonical Assistant Message 的 Parts。 */
+        take_assistant_parts(): UIMessage["parts"];
+        /** 发布一条不进入 LLM 输入的 Session Action。 */
+        publish_action(event: AgentSessionActionEvent): Promise<void>;
+    };
+    /** 当前 Session 执行面创建用户异步交互的端口。 */
+    readonly interactions?: SessionInteractionPort;
+    /** 当前运行可使用的 Shell 协作能力。 */
+    readonly shell: {
+        /** 当前 Session 拥有的 unrestricted 审批网关。 */
+        readonly approval_gateway?: ShellApprovalGateway;
+    };
+}
+export type { AgentSessionActionCallback, AgentSessionActionEvent, AgentSessionActionRecord, };
+//# sourceMappingURL=SessionTurnContext.d.ts.map

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

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

package/bin/types/executor/SessionTurnContext.js

@@ -0,0 +1,10 @@
+/**
+ * SessionTurnContext：一次 Session Turn 的统一执行上下文契约。
+ *
+ * 关键点（中文）
+ * - 根对象统一承载一个 Turn 的身份、生命周期、Step、输入和输出协作能力。
+ * - 分区用于表达领域职责，不引入多套彼此独立的 Context。
+ * - 可变状态只能通过行为方法更新，消费者不能直接操作内部数组、lease 或 callback。
+ */
+export {};
+//# sourceMappingURL=SessionTurnContext.js.map

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

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

package/bin/types/plugin/PluginAction.d.ts

@@ -8,9 +8,10 @@
 import type { Command } from "commander";
 import type { Context as HonoContext } from "hono";
 import type { z } from "zod";
-import type { AgentContext } from "../../agent/AgentContext.js";
-import type { PluginRunContext } from "../../types/plugin/PluginRunContext.js";
+import type { PluginContext } from "../../types/plugin/PluginContext.js";
+import type { PluginExecutionContext } from "../../types/plugin/PluginExecutionContext.js";
 import type { JsonObject, JsonValue } from "../../types/common/Json.js";
+import type { ActionResultMessage } from "../../types/action/ActionResult.js";
 /**
  * Plugin action 调用参数。
  */
@@ -52,6 +53,8 @@ export interface PluginActionResult<R extends JsonValue = JsonValue> {
     error?: string;
     /** 人类可读消息（可选）。 */
     message?: string;
+    /** Action 执行后应写入 Session 的真实 User / Assistant Messages。 */
+    messages?: ActionResultMessage[];
 }
 /**
  * Plugin Action 命令输入。
@@ -71,7 +74,7 @@ export interface PluginActionCommand<P extends JsonValue = JsonValue> {
     /** 额外 commander 配置（可选）。 */
     configure?: (command: Command) => void;
     /** 将 CLI 输入映射为 payload。 */
-    mapInput: (input: PluginActionCommandInput) => P | Promise<P>;
+    map_input: (input: PluginActionCommandInput) => P | Promise<P>;
 }
 /**
  * Plugin Action HTTP 定义。
@@ -82,7 +85,7 @@ export interface PluginActionApi<P extends JsonValue = JsonValue> {
     /** HTTP 路径。 */
     path?: string;
     /** 将 HTTP 输入映射为 payload（可选）。 */
-    mapInput?: (ctx: HonoContext) => P | Promise<P>;
+    map_input?: (ctx: HonoContext) => P | Promise<P>;
 }
 /**
  * Plugin Action 示例。
@@ -130,27 +133,27 @@ export interface PluginAction<P extends JsonValue = JsonValue, R extends JsonVal
     /** Action 执行器。 */
     execute: (params: {
         /** 当前执行上下文。 */
-        context: AgentContext;
+        context: PluginContext;
         /**
-         * 当前 action 所属的 Session run 上下文。
+         * 当前 action 所属 Session Turn 的只读 Plugin 执行快照。
          *
          * 关键点（中文）
          * - 模型 tool 调用时必定提供。
          * - CLI、HTTP 或定时任务等非 Session 入口可能不提供。
          */
-        run_context?: PluginRunContext;
+        execution_context?: PluginExecutionContext;
         /** 已通过 schema 校验后的输入。 */
         input: P;
         /** 当前插件名称。 */
-        pluginName: string;
+        plugin_name: string;
         /** 当前 Action 名称。 */
-        actionName: string;
+        action_name: string;
     }) => Promise<PluginActionResult<R>> | PluginActionResult<R>;
 }
 /**
  * Plugin Action 集合。
  */
 export type PluginActions = {
-    [actionName: string]: PluginAction<JsonValue, JsonValue>;
+    [action_name: string]: PluginAction<JsonValue, JsonValue>;
 };
 //# sourceMappingURL=PluginAction.d.ts.map

package/bin/types/plugin/PluginAction.d.ts.map

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

package/bin/types/plugin/PluginCommand.d.ts

@@ -1,71 +1,14 @@
 /**
- * Plugin command 与 lifecycle 类型。
+ * Plugin 生命周期类型。
  *
- * 关键点（中文）
- * - command 面向显式 CLI/control 调用。
- * - lifecycle 面向 runtime 主动 start/stop 钩子。
- */
-import type { AgentContext } from "../../agent/AgentContext.js";
-import type { Logger } from "../../utils/logger/Logger.js";
-import type { JsonValue } from "../../types/common/Json.js";
-/**
- * Plugin 命令执行上下文。
- *
- * 关键点（中文）
- * - 这里表达的是“CLI 命令执行 plugin 时真正需要的最小上下文”。
- * - plugin 命令不应依赖 session、plugin invoke、agent runtime 等长期宿主对象。
- * - agent runtime 在需要复用 action 时，直接传入自身更完整的 AgentContext 即可。
- */
-export interface PluginCommandContext {
-    /** 当前 Agent 稳定标识。 */
-    agent_id: string;
-    /** 当前项目根目录。 */
-    rootPath: string;
-    /** 当前统一日志器。 */
-    logger: Logger;
-    /**
-     * 当前项目环境变量快照。
-     *
-     * 关键点（中文）
-     * - 这里约定为宿主已经整理好的最终可见 env 视图。
-     * - plugin 不再区分 global env 与 agent env，避免上下文语义膨胀。
-     */
-    env: Record<string, string>;
-}
-/**
- * Plugin 非 action 命令执行参数。
- */
-export interface PluginCommandParams {
-    /** 当前统一执行上下文。 */
-    context: AgentContext;
-    /** 当前命令名称。 */
-    command: string;
-    /** 命令附带 payload（可选）。 */
-    payload?: JsonValue;
-}
-/**
- * Plugin 非 action 命令执行结果。
- */
-export interface PluginCommandResult {
-    /** 本次命令是否成功。 */
-    success: boolean;
-    /** 人类可读消息。 */
-    message?: string;
-    /** 结构化返回数据。 */
-    data?: JsonValue;
-}
-/**
- * Plugin 生命周期定义。
- *
- * 关键点（中文）
- * - 生命周期只描述 plugin 启动、停止和非 action 命令处理。
+ * 关键点（中文）：生命周期只负责启动和停止；所有显式能力调用统一使用 Action。
  */
+import type { PluginContext } from "../../types/plugin/PluginContext.js";
+/** Plugin 生命周期定义。 */
 export interface PluginLifecycle {
-    /** plugin 启动钩子。 */
-    start?(context: AgentContext): Promise<void> | void;
-    /** plugin 停止钩子。 */
-    stop?(context: AgentContext): Promise<void> | void;
-    /** plugin 非 action 命令钩子。 */
-    command?(params: PluginCommandParams): Promise<PluginCommandResult> | PluginCommandResult;
+    /** Plugin 启动钩子。 */
+    start?(context: PluginContext): Promise<void> | void;
+    /** Plugin 停止钩子。 */
+    stop?(context: PluginContext): Promise<void> | void;
 }
 //# sourceMappingURL=PluginCommand.d.ts.map

package/bin/types/plugin/PluginCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PluginCommand.d.ts","sourceRoot":"","sources":["../../../src/types/plugin/PluginCommand.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACnC,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe;IACf,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;OAMG;IACH,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iBAAiB;IACjB,OAAO,EAAE,YAAY,CAAC;IACtB,cAAc;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gBAAgB;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe;IACf,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,mBAAmB;IACnB,KAAK,CAAC,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACpD,mBAAmB;IACnB,IAAI,CAAC,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACnD,4BAA4B;IAC5B,OAAO,CAAC,CACN,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,GAAG,mBAAmB,CAAC;CACvD"}
+{"version":3,"file":"PluginCommand.d.ts","sourceRoot":"","sources":["../../../src/types/plugin/PluginCommand.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAErE,qBAAqB;AACrB,MAAM,WAAW,eAAe;IAC9B,mBAAmB;IACnB,KAAK,CAAC,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACrD,mBAAmB;IACnB,IAAI,CAAC,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACrD"}

package/bin/types/plugin/PluginCommand.js

@@ -1,9 +1,7 @@
 /**
- * Plugin command 与 lifecycle 类型。
+ * Plugin 生命周期类型。
  *
- * 关键点（中文）
- * - command 面向显式 CLI/control 调用。
- * - lifecycle 面向 runtime 主动 start/stop 钩子。
+ * 关键点（中文）：生命周期只负责启动和停止；所有显式能力调用统一使用 Action。
  */
 export {};
 //# sourceMappingURL=PluginCommand.js.map

package/bin/types/plugin/PluginCommand.js.map

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

package/bin/types/plugin/PluginContext.d.ts

@@ -0,0 +1,34 @@
+/**
+ * PluginContext：Agent 向 Plugin 投影的稳定能力视图。
+ *
+ * 边界说明（中文）
+ * - Plugin 只依赖本接口，不持有 Agent 实例，也不参与 Session 内核编排。
+ * - 动态状态通过只读 getter 暴露，保证 Workspace env 与 instruction 始终来自唯一状态源。
+ */
+import type { AgentSessions } from "../../agent/AgentSessions.js";
+import type { AgentPlugins } from "../../types/plugin/PluginRuntime.js";
+import type { FileSystem } from "../../types/workspace/FileSystem.js";
+import type { Logger } from "../../utils/logger/Logger.js";
+import type { Shell } from "@downcity/shell";
+/** Agent 向 Plugin 开放的最小、稳定运行时能力。 */
+export interface PluginContext {
+    /** 当前 Agent 的稳定标识。 */
+    readonly agent_id: string;
+    /** 当前 Workspace 的绝对根目录。 */
+    readonly workspace_path: string;
+    /** 当前 Workspace 的统一文件能力。 */
+    readonly files: FileSystem;
+    /** 当前 Workspace 显式挂载的 Shell；未启用时为空。 */
+    readonly shell?: Shell;
+    /** 当前 Agent 独享的统一日志器。 */
+    readonly logger: Logger;
+    /** 当前 Agent 的 Session 集合入口。 */
+    readonly sessions: AgentSessions;
+    /** 当前 Agent 唯一的 Plugin 调用与注册入口。 */
+    readonly plugins: AgentPlugins;
+    /** 当前 Workspace 已配置环境变量的只读快照。 */
+    readonly workspace_env: Readonly<Record<string, string>>;
+    /** 当前 Agent 已配置静态指令的只读快照。 */
+    readonly instructions: readonly string[];
+}
+//# sourceMappingURL=PluginContext.d.ts.map

package/bin/types/plugin/PluginContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginContext.d.ts","sourceRoot":"","sources":["../../../src/types/plugin/PluginContext.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C,oCAAoC;AACpC,MAAM,WAAW,aAAa;IAC5B,sBAAsB;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,2BAA2B;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC,4BAA4B;IAC5B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAE3B,uCAAuC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IAEvB,yBAAyB;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,+BAA+B;IAC/B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IAEjC,mCAAmC;IACnC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAE/B,iCAAiC;IACjC,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAEzD,6BAA6B;IAC7B,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C"}

package/bin/types/plugin/PluginContext.js

@@ -0,0 +1,9 @@
+/**
+ * PluginContext：Agent 向 Plugin 投影的稳定能力视图。
+ *
+ * 边界说明（中文）
+ * - Plugin 只依赖本接口，不持有 Agent 实例，也不参与 Session 内核编排。
+ * - 动态状态通过只读 getter 暴露，保证 Workspace env 与 instruction 始终来自唯一状态源。
+ */
+export {};
+//# sourceMappingURL=PluginContext.js.map

package/bin/types/plugin/PluginContext.js.map

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

package/bin/types/plugin/PluginDefinition.d.ts

@@ -3,16 +3,14 @@
  *
  * 关键点（中文）
  * - 这里只组合 plugin 的各类能力，不展开每个能力的细节。
- * - 细节类型分散在 State / Command / Action / Runtime / Setup / HTTP 模块。
+ * - 细节类型分散在 State / Action / Runtime / Lifecycle / HTTP 模块。
  */
-import type { AgentContext } from "../../agent/AgentContext.js";
-import type { StructuredConfig } from "../../types/plugin/PluginConfig.js";
+import type { PluginContext } from "../../types/plugin/PluginContext.js";
 import type { PluginActions } from "../../types/plugin/PluginAction.js";
-import type { PluginAvailability, PluginConfigDefinition, PluginHooks, PluginResolves } from "../../types/plugin/PluginRuntime.js";
-import type { PluginCommandContext, PluginLifecycle } from "../../types/plugin/PluginCommand.js";
-import type { PluginSetupDefinition, PluginUsageDefinition } from "../../types/plugin/PluginSetup.js";
+import type { PluginAvailability, PluginHooks, PluginResolves } from "../../types/plugin/PluginRuntime.js";
+import type { PluginLifecycle } from "../../types/plugin/PluginCommand.js";
 import type { PluginHttpDefinition } from "../../types/plugin/PluginHttp.js";
-import type { PluginRunContext } from "../../types/plugin/PluginRunContext.js";
+import type { PluginExecutionContext } from "../../types/plugin/PluginExecutionContext.js";
 /**
  * Plugin 定义。
  */
@@ -23,26 +21,8 @@ export interface Plugin {
     title: string;
     /** Plugin 面向人类的用途说明。 */
     description: string;
-    /** Plugin 配置定义（可选）。 */
-    config?: PluginConfigDefinition<StructuredConfig>;
     /** Plugin 显式 Action 集合（可选）。 */
     actions?: PluginActions;
-    /**
-     * Plugin setup 定义（可选）。
-     *
-     * 说明（中文）
-     * - 这是 Console 面向用户的安装/配置协议。
-     * - plugin 内部仍可复用 asset/helper，但 UI 只读取这层抽象。
-     */
-    setup?: PluginSetupDefinition;
-    /**
-     * Plugin usage 定义（可选）。
-     *
-     * 说明（中文）
-     * - 这是 agent 侧如何使用该 plugin 的配置协议。
-     * - 与 setup 不同，这里不负责依赖安装，只负责行为选择与运行参数。
-     */
-    usage?: PluginUsageDefinition;
     /** Plugin Hook 集合（可选）。 */
     hooks?: PluginHooks;
     /** Plugin resolve 点集合（可选）。 */
@@ -51,13 +31,13 @@ export interface Plugin {
      * Plugin system 文本构建器（可选）。
      *
      * @param context Agent 稳定能力上下文。
-     * @param run_context 当前 Session run 上下文；非 Session 快照读取时可缺省。
+     * @param execution_context 当前 Session Turn 的只读 Plugin 执行快照；非 Session 调用时可缺省。
      */
-    system?: (context: AgentContext, run_context?: PluginRunContext) => string | Promise<string>;
+    system?: (context: PluginContext, execution_context?: PluginExecutionContext) => string | Promise<string>;
     /** Plugin 生命周期定义（可选）。 */
     lifecycle?: PluginLifecycle;
     /** Plugin 可用性检查器（可选）。 */
-    availability?: (context: PluginCommandContext | AgentContext) => Promise<PluginAvailability> | PluginAvailability;
+    availability?: (context: PluginContext) => Promise<PluginAvailability> | PluginAvailability;
     /** Plugin HTTP 注入定义（可选）。 */
     http?: PluginHttpDefinition;
 }

package/bin/types/plugin/PluginDefinition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PluginDefinition.d.ts","sourceRoot":"","sources":["../../../src/types/plugin/PluginDefinition.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,KAAK,EACV,kBAAkB,EAClB,sBAAsB,EACtB,WAAW,EACX,cAAc,EACf,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EACV,oBAAoB,EACpB,eAAe,EAChB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EACV,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB;IACvB,MAAM,CAAC,EAAE,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;IAClD,+BAA+B;IAC/B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B,0BAA0B;IAC1B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,CACP,OAAO,EAAE,YAAY,EACrB,WAAW,CAAC,EAAE,gBAAgB,KAC3B,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9B,yBAAyB;IACzB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,yBAAyB;IACzB,YAAY,CAAC,EAAE,CACb,OAAO,EAAE,oBAAoB,GAAG,YAAY,KACzC,OAAO,CAAC,kBAAkB,CAAC,GAAG,kBAAkB,CAAC;IACtD,4BAA4B;IAC5B,IAAI,CAAC,EAAE,oBAAoB,CAAC;CAC7B"}
+{"version":3,"file":"PluginDefinition.d.ts","sourceRoot":"","sources":["../../../src/types/plugin/PluginDefinition.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,KAAK,EACV,kBAAkB,EAClB,WAAW,EACX,cAAc,EACf,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAEvF;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,CACP,OAAO,EAAE,aAAa,EACtB,iBAAiB,CAAC,EAAE,sBAAsB,KACvC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9B,yBAAyB;IACzB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,yBAAyB;IACzB,YAAY,CAAC,EAAE,CACb,OAAO,EAAE,aAAa,KACnB,OAAO,CAAC,kBAAkB,CAAC,GAAG,kBAAkB,CAAC;IACtD,4BAA4B;IAC5B,IAAI,CAAC,EAAE,oBAAoB,CAAC;CAC7B"}

package/bin/types/plugin/PluginDefinition.js

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - 这里只组合 plugin 的各类能力，不展开每个能力的细节。
- * - 细节类型分散在 State / Command / Action / Runtime / Setup / HTTP 模块。
+ * - 细节类型分散在 State / Action / Runtime / Lifecycle / HTTP 模块。
  */
 export {};
 //# sourceMappingURL=PluginDefinition.js.map

package/bin/types/plugin/PluginExecutionContext.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Plugin 单次调用的执行上下文。
+ *
+ * 关键点（中文）
+ * - 只暴露 plugin 业务需要的只读 Session 快照。
+ * - 不暴露 Executor 内部队列、callback 或 plugin lease。
+ * - CLI、HTTP 与 scheduler 等非 Session 调用可能不提供该对象。
+ */
+/**
+ * Plugin action 与 system provider 可读取的执行快照。
+ *
+ * Session 调用时，该对象是当前 Turn 的只读 Plugin 投影；CLI、HTTP 与
+ * scheduler 等非 Session 调用也可以提供自己的调用快照或完全缺省。
+ */
+export interface PluginExecutionContext {
+    /** 当前调用所属的 Session 标识。 */
+    readonly session_id: string;
+    /** 当前调用所属的 Turn 标识。 */
+    readonly turn_id?: string;
+    /** 当前 Agent 绑定的项目根目录。 */
+    readonly project_root?: string;
+    /** 当前 Session Step 已提交生效的 Workspace env 快照。 */
+    readonly workspace_env?: Readonly<Record<string, string>>;
+    /** 当前 Session Step 已提交生效的 instruction 快照。 */
+    readonly agent_systems?: readonly string[];
+    /** 当前 Turn 的取消信号。 */
+    readonly abort_signal?: AbortSignal;
+}
+//# sourceMappingURL=PluginExecutionContext.d.ts.map

package/bin/types/plugin/PluginExecutionContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginExecutionContext.d.ts","sourceRoot":"","sources":["../../../src/types/plugin/PluginExecutionContext.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,0BAA0B;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,uBAAuB;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B,yBAAyB;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAE/B,+CAA+C;IAC/C,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAE1D,6CAA6C;IAC7C,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAE3C,qBAAqB;IACrB,QAAQ,CAAC,YAAY,CAAC,EAAE,WAAW,CAAC;CACrC"}

package/bin/types/plugin/{PluginRunContext.js → PluginExecutionContext.js}

@@ -1,5 +1,5 @@
 /**
- * Plugin 单次调用的运行上下文。
+ * Plugin 单次调用的执行上下文。
  *
  * 关键点（中文）
  * - 只暴露 plugin 业务需要的只读 Session 快照。
@@ -7,4 +7,4 @@
  * - CLI、HTTP 与 scheduler 等非 Session 调用可能不提供该对象。
  */
 export {};
-//# sourceMappingURL=PluginRunContext.js.map
+//# sourceMappingURL=PluginExecutionContext.js.map

package/bin/types/plugin/PluginExecutionContext.js.map

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

package/bin/types/plugin/PluginHttp.d.ts

@@ -6,22 +6,22 @@
  * - server 装配、代理和鉴权执行仍由宿主负责。
  */
 import type { Hono } from "hono";
-import type { AgentContext } from "../../agent/AgentContext.js";
-import type { AuthRoutePolicy } from "../../types/runtime/auth/AuthRoute.js";
+import type { PluginContext } from "../../types/plugin/PluginContext.js";
+import type { AuthRoutePolicy } from "@downcity/type";
 /**
  * Plugin HTTP 注入参数。
  */
 export interface PluginHttpRegistration {
     /** 该组路由对应的鉴权策略列表。 */
-    authPolicies?: AuthRoutePolicy[];
+    auth_policies?: AuthRoutePolicy[];
     /** 向 runtime Hono 应用注册路由。 */
     register(params: {
         /** 当前 Hono 应用实例。 */
         app: Hono;
         /** 获取当前统一执行上下文。 */
-        getContext: () => AgentContext;
+        get_context: () => PluginContext;
         /** 当前 plugin 稳定名称。 */
-        pluginName: string;
+        plugin_name: string;
     }): void;
 }
 /**

package/bin/types/plugin/PluginHttp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PluginHttp.d.ts","sourceRoot":"","sources":["../../../src/types/plugin/PluginHttp.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,qBAAqB;IACrB,YAAY,CAAC,EAAE,eAAe,EAAE,CAAC;IACjC,6BAA6B;IAC7B,QAAQ,CAAC,MAAM,EAAE;QACf,oBAAoB;QACpB,GAAG,EAAE,IAAI,CAAC;QACV,mBAAmB;QACnB,UAAU,EAAE,MAAM,YAAY,CAAC;QAC/B,sBAAsB;QACtB,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,IAAI,CAAC;CACV;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,4BAA4B;IAC5B,MAAM,CAAC,EAAE,sBAAsB,CAAC;CACjC"}
+{"version":3,"file":"PluginHttp.d.ts","sourceRoot":"","sources":["../../../src/types/plugin/PluginHttp.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,qBAAqB;IACrB,aAAa,CAAC,EAAE,eAAe,EAAE,CAAC;IAClC,6BAA6B;IAC7B,QAAQ,CAAC,MAAM,EAAE;QACf,oBAAoB;QACpB,GAAG,EAAE,IAAI,CAAC;QACV,mBAAmB;QACnB,WAAW,EAAE,MAAM,aAAa,CAAC;QACjC,sBAAsB;QACtB,WAAW,EAAE,MAAM,CAAC;KACrB,GAAG,IAAI,CAAC;CACV;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,4BAA4B;IAC5B,MAAM,CAAC,EAAE,sBAAsB,CAAC;CACjC"}

package/bin/types/plugin/PluginRegistry.d.ts

@@ -0,0 +1,21 @@
+/**
+ * PluginRegistry 变化订阅类型。
+ *
+ * 关键点（中文）
+ * - Agent 订阅 Registry 变化后同步 Plugin Tools 与 Session execution view。
+ * - PluginRegistry 不直接修改 Agent 持有的工具集合。
+ */
+/** PluginRegistry 的单次配置变化。 */
+export interface PluginRegistryChange {
+    /** 当前修改是注册还是卸载。 */
+    type: "register" | "unregister";
+    /** 当前发生修改的 Plugin 稳定名称。 */
+    plugin_name: string;
+}
+/** PluginRegistry 变化监听器。 */
+export type PluginRegistrySubscriber = (
+/** 当前 Plugin 配置变化。 */
+change: PluginRegistryChange) => void;
+/** 取消 PluginRegistry 变化订阅的函数。 */
+export type PluginRegistryUnsubscribe = () => void;
+//# sourceMappingURL=PluginRegistry.d.ts.map

package/bin/types/plugin/PluginRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginRegistry.d.ts","sourceRoot":"","sources":["../../../src/types/plugin/PluginRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,8BAA8B;AAC9B,MAAM,WAAW,oBAAoB;IACnC,mBAAmB;IACnB,IAAI,EAAE,UAAU,GAAG,YAAY,CAAC;IAEhC,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,4BAA4B;AAC5B,MAAM,MAAM,wBAAwB,GAAG;AACrC,sBAAsB;AACtB,MAAM,EAAE,oBAAoB,KACzB,IAAI,CAAC;AAEV,iCAAiC;AACjC,MAAM,MAAM,yBAAyB,GAAG,MAAM,IAAI,CAAC"}

package/bin/types/plugin/PluginRegistry.js

@@ -0,0 +1,9 @@
+/**
+ * PluginRegistry 变化订阅类型。
+ *
+ * 关键点（中文）
+ * - Agent 订阅 Registry 变化后同步 Plugin Tools 与 Session execution view。
+ * - PluginRegistry 不直接修改 Agent 持有的工具集合。
+ */
+export {};
+//# sourceMappingURL=PluginRegistry.js.map