@downcity/agent 1.1.337 → 1.1.399

package/bin/plugin/core/PluginHttpRoutes.js.map

@@ -1 +1 @@
-{"version":3,"file":"PluginHttpRoutes.js","sourceRoot":"","sources":["../../../src/plugin/core/PluginHttpRoutes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,SAAS,kBAAkB,CAAC,QAA2B;IACrD,MAAM,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAC;IACnD,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACvG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAyB;IACjE,OAAO,kBAAkB,CACvB,CAAC,GAAG,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,IAAI,EAAE,CAAC,CAC3E,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAI3C;IACC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACpC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC;YAC5B,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,WAAW,EAAE,MAAM,CAAC,IAAI;SACzB,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}
+{"version":3,"file":"PluginHttpRoutes.js","sourceRoot":"","sources":["../../../src/plugin/core/PluginHttpRoutes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,SAAS,kBAAkB,CAAC,QAA2B;IACrD,MAAM,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAC;IACnD,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACvG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAyB;IACjE,OAAO,kBAAkB,CACvB,CAAC,GAAG,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,IAAI,EAAE,CAAC,CAC3E,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAI3C;IACC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACpC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC;YAC5B,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC;YAClD,WAAW,EAAE,MAAM,CAAC,IAAI;SACzB,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

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

@@ -11,34 +11,39 @@ import type { PluginActionResult } from "../../types/plugin/PluginAction.js";
 import type { AgentPlugins, AgentPluginExecutionRuntime, PluginAvailability, PluginReadView, PluginView } from "../../types/plugin/PluginRuntime.js";
 import type { AgentSessionSystemBlock } from "../../types/agent/SessionTypes.js";
 import type { PluginContext } from "../../types/plugin/PluginContext.js";
+import type { AgentPluginContext } from "../../types/plugin/AgentPluginContext.js";
 import type { JsonValue } from "../../types/common/Json.js";
 import type { PluginSnapshot } from "../../types/plugin/PluginState.js";
 import type { PluginExecutionContext } from "../../types/plugin/PluginExecutionContext.js";
-import type { Tool } from "ai";
+import type { SessionInteractionPort } from "../../types/session/SessionInteraction.js";
+import type { RuntimeTool as Tool } from "@downcity/type";
 import type { PluginRegistrySubscriber, PluginRegistryUnsubscribe } from "../../types/plugin/PluginRegistry.js";
+/** 为当前 Workspace 的指定 Plugin 创建专属运行时 Context。 */
+type PluginContextFactory = (plugin_name: string) => PluginContext;
 /**
  * PluginRegistry：Agent plugin 注册、卸载与调用实现。
  */
-export declare class PluginRegistry implements AgentPlugins {
-    private context?;
+export declare class PluginRegistry {
     private readonly hookRegistry;
     private readonly records;
+    /** 当前 Registry 所属 Agent 的生命周期上下文。 */
+    private readonly agent_context;
+    /** Agent 当前已进入 Workspace 的 Plugin Context 工厂。 */
+    private readonly workspace_context_factories;
+    /** 初始 Plugin lifecycle 的唯一启动流程。 */
+    private initial_start_promise?;
     private readonly retired_records;
     /** Plugin 配置变化订阅器。 */
     private readonly change_subscribers;
-    constructor(plugins?: Plugin[]);
-    /**
-     * 绑定当前 Registry 所属的唯一 PluginContext。
-     *
-     * 关键点（中文）
-     * - 初始 Plugin 可以在 Context 创建前同步挂载。
-     * - lifecycle、action、hook 首次执行前必须完成绑定。
-     */
-    bind_context(context: PluginContext): void;
-    /** 返回已经绑定的 PluginContext。 */
-    private require_context;
+    constructor(agent_context: AgentPluginContext, plugins?: Plugin[]);
     /** 订阅 Plugin 配置的后续变化。 */
     subscribe_change(subscriber: PluginRegistrySubscriber): PluginRegistryUnsubscribe;
+    /** 绑定当前 Workspace 的 Plugin Context 工厂。 */
+    bind_workspace_context(context: PluginContext, factory: PluginContextFactory): void;
+    /** 解除当前 Workspace 的 Plugin Context 工厂。 */
+    unbind_workspace_context(context: PluginContext): void;
+    /** 返回指定 Plugin 的运行时 Context；未绑定工厂时回退到传入 Context。 */
+    plugin_context(context: PluginContext, plugin_name: string): PluginContext;
     /**
      * 返回当前 Registry 向 Agent 提供的 Plugin Tools。
      *
@@ -46,7 +51,14 @@ export declare class PluginRegistry implements AgentPlugins {
      * - 没有任何 Action 时不暴露空壳 Tool。
      * - Tool 闭包绑定当前 Registry，动态 Plugin 变化无需重建 bridge。
      */
-    tools(): Record<string, Tool>;
+    tools(context: PluginContext): Record<string, Tool>;
+    /**
+     * 创建绑定当前 Session Workspace 上下文的 Plugin 调用面。
+     *
+     * Registry 只保存 Agent 注册的 Plugin；Action、Hook、System 与 availability 在
+     * 调用时显式使用这里捕获的 Workspace Context。
+     */
+    contextual(context: PluginContext): AgentPlugins;
     /**
      * 注册单个 plugin。
      *
@@ -78,6 +90,10 @@ export declare class PluginRegistry implements AgentPlugins {
      * 启动全部已挂载 plugin。
      */
     start_all(): Promise<PluginSnapshot[]>;
+    /** 串行启动构造期挂载的 Plugin，并隔离单个 lifecycle 失败。 */
+    private start_initial_records;
+    /** 确保任何异步 Plugin 执行都发生在初始 lifecycle 启动完成后。 */
+    private ensure_initial_started;
     /**
      * 卸载全部 plugin。
      */
@@ -101,19 +117,19 @@ export declare class PluginRegistry implements AgentPlugins {
     /**
      * 运行 pipeline 点。
      */
-    pipeline<T = JsonValue>(point_name: string, value: T): Promise<T>;
+    pipeline<T = JsonValue>(context: PluginContext, point_name: string, value: T): Promise<T>;
     /**
      * 运行 guard 点。
      */
-    guard<T = JsonValue>(point_name: string, value: T): Promise<void>;
+    guard<T = JsonValue>(context: PluginContext, point_name: string, value: T): Promise<void>;
     /**
      * 运行 effect 点。
      */
-    effect<T = JsonValue>(point_name: string, value: T): Promise<void>;
+    effect<T = JsonValue>(context: PluginContext, point_name: string, value: T): Promise<void>;
     /**
      * 运行 resolve 点。
      */
-    resolve<TInput = JsonValue, TOutput = JsonValue>(point_name: string, value: TInput): Promise<TOutput>;
+    resolve<TInput = JsonValue, TOutput = JsonValue>(context: PluginContext, point_name: string, value: TInput): Promise<TOutput>;
     /**
      * 获取单个 plugin 定义。
      */
@@ -146,19 +162,17 @@ export declare class PluginRegistry implements AgentPlugins {
     /**
      * 检查 plugin 可用性。
      */
-    availability(plugin_name: string): Promise<PluginAvailability>;
-    /**
-     * 按 action schema 校验 payload。
-     */
-    private parseActionPayload;
+    availability(context: PluginContext, plugin_name: string): Promise<PluginAvailability>;
     /**
      * 运行 plugin action。
      */
     run_action(params: {
+        context: PluginContext;
         plugin: string;
         action: string;
         payload?: JsonValue;
         execution_context?: PluginExecutionContext;
+        interactions?: SessionInteractionPort;
     }): Promise<PluginActionResult<JsonValue>>;
     /**
      * 从指定记录视图运行 plugin action。
@@ -167,7 +181,7 @@ export declare class PluginRegistry implements AgentPlugins {
     /**
      * 读取当前生效的 plugin system blocks。
      */
-    system_blocks(execution_context?: PluginExecutionContext): Promise<AgentSessionSystemBlock[]>;
+    system_blocks(context: PluginContext, execution_context?: PluginExecutionContext): Promise<AgentSessionSystemBlock[]>;
     /**
      * 从指定记录视图解析 plugin system blocks。
      */
@@ -175,7 +189,7 @@ export declare class PluginRegistry implements AgentPlugins {
     /**
      * 创建当前 configured registry 的 Session step 执行视图。
      */
-    execution_view(): AgentPluginExecutionRuntime;
+    execution_view(context: PluginContext): AgentPluginExecutionRuntime;
     /**
      * 为单次 Session step 获取 Plugin execution lease。
      */
@@ -189,4 +203,5 @@ export declare class PluginRegistry implements AgentPlugins {
      */
     private try_finalize_retired_record;
 }
+export {};
 //# sourceMappingURL=PluginRegistry.d.ts.map

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

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

package/bin/plugin/core/PluginRegistry.js

@@ -6,9 +6,10 @@
  * - 注册时自动启动 plugin lifecycle；卸载时自动停止 plugin lifecycle。
  * - action、system、hook、resolve 都统一以“已注册且 ready”为生效边界。
  */
-import { to_plugin_view } from "../../plugin/core/PluginCatalog.js";
-import { HookRegistry } from "../../plugin/core/HookRegistry.js";
-import { create_plugin_tools } from "../../plugin/tool/PluginTools.js";
+import { to_plugin_view } from "./PluginCatalog.js";
+import { HookRegistry } from "./HookRegistry.js";
+import { execute_plugin_action } from "./PluginActionExecution.js";
+import { create_plugin_tools } from "../tool/PluginTools.js";
 function now_ms() {
     return Date.now();
 }
@@ -19,7 +20,7 @@ function create_record(plugin) {
     const current_time = now_ms();
     return {
         plugin,
-        state: "ready",
+        state: "initializing",
         registered_at: current_time,
         updated_at: current_time,
         chain: Promise.resolve(),
@@ -62,41 +63,26 @@ async function run_serial(record, step) {
  * PluginRegistry：Agent plugin 注册、卸载与调用实现。
  */
 export class PluginRegistry {
-    context;
     hookRegistry;
     records = new Map();
+    /** 当前 Registry 所属 Agent 的生命周期上下文。 */
+    agent_context;
+    /** Agent 当前已进入 Workspace 的 Plugin Context 工厂。 */
+    workspace_context_factories = new Map();
+    /** 初始 Plugin lifecycle 的唯一启动流程。 */
+    initial_start_promise;
     retired_records = new Set();
     /** Plugin 配置变化订阅器。 */
     change_subscribers = new Set();
-    constructor(plugins = []) {
+    constructor(agent_context, plugins = []) {
+        this.agent_context = agent_context;
         this.hookRegistry = new HookRegistry({
-            get_context: () => this.require_context(),
             is_plugin_ready: (plugin_name) => this.is_ready(plugin_name),
         });
         for (const plugin of plugins) {
             this.mount(plugin);
         }
     }
-    /**
-     * 绑定当前 Registry 所属的唯一 PluginContext。
-     *
-     * 关键点（中文）
-     * - 初始 Plugin 可以在 Context 创建前同步挂载。
-     * - lifecycle、action、hook 首次执行前必须完成绑定。
-     */
-    bind_context(context) {
-        if (this.context && this.context !== context) {
-            throw new Error("PluginRegistry context is already bound");
-        }
-        this.context = context;
-    }
-    /** 返回已经绑定的 PluginContext。 */
-    require_context() {
-        if (!this.context) {
-            throw new Error("PluginRegistry context is not bound");
-        }
-        return this.context;
-    }
     /** 订阅 Plugin 配置的后续变化。 */
     subscribe_change(subscriber) {
         this.change_subscribers.add(subscriber);
@@ -104,6 +90,19 @@ export class PluginRegistry {
             this.change_subscribers.delete(subscriber);
         };
     }
+    /** 绑定当前 Workspace 的 Plugin Context 工厂。 */
+    bind_workspace_context(context, factory) {
+        this.workspace_context_factories.set(context.workspace_id, factory);
+    }
+    /** 解除当前 Workspace 的 Plugin Context 工厂。 */
+    unbind_workspace_context(context) {
+        this.workspace_context_factories.delete(context.workspace_id);
+    }
+    /** 返回指定 Plugin 的运行时 Context；未绑定工厂时回退到传入 Context。 */
+    plugin_context(context, plugin_name) {
+        const key = normalize_plugin_name(plugin_name);
+        return this.workspace_context_factories.get(context.workspace_id)?.(key) || context;
+    }
     /**
      * 返回当前 Registry 向 Agent 提供的 Plugin Tools。
      *
@@ -111,10 +110,37 @@ export class PluginRegistry {
      * - 没有任何 Action 时不暴露空壳 Tool。
      * - Tool 闭包绑定当前 Registry，动态 Plugin 变化无需重建 bridge。
      */
-    tools() {
+    tools(context) {
         if (!this.list().some((plugin) => plugin.actions.length > 0))
             return {};
-        return { ...create_plugin_tools({ plugins: this }) };
+        return { ...create_plugin_tools({ plugins: this.contextual(context) }) };
+    }
+    /**
+     * 创建绑定当前 Session Workspace 上下文的 Plugin 调用面。
+     *
+     * Registry 只保存 Agent 注册的 Plugin；Action、Hook、System 与 availability 在
+     * 调用时显式使用这里捕获的 Workspace Context。
+     */
+    contextual(context) {
+        return {
+            register: async (plugin) => await this.register(plugin),
+            unregister: async (plugin_name) => await this.unregister(plugin_name),
+            start_all: async () => await this.start_all(),
+            unregister_all: async () => await this.unregister_all(),
+            has: (plugin_name) => this.has(plugin_name),
+            get: (plugin_name) => this.get(plugin_name),
+            status: (plugin_name) => this.status(plugin_name),
+            snapshots: () => this.snapshots(),
+            list: () => this.list(),
+            read: (params) => this.read(params),
+            availability: async (plugin_name) => await this.availability(context, plugin_name),
+            run_action: async (params) => await this.run_action({ context, ...params }),
+            system_blocks: async (execution_context) => await this.system_blocks(context, execution_context),
+            pipeline: async (point_name, value) => await this.pipeline(context, point_name, value),
+            guard: async (point_name, value) => await this.guard(context, point_name, value),
+            effect: async (point_name, value) => await this.effect(context, point_name, value),
+            resolve: async (point_name, value) => await this.resolve(context, point_name, value),
+        };
     }
     /**
      * 注册单个 plugin。
@@ -142,6 +168,7 @@ export class PluginRegistry {
         catch (error) {
             this.unregister_hooks(key);
             this.records.delete(key);
+            await this.stop_record(record).catch(() => undefined);
             throw error;
         }
     }
@@ -201,17 +228,25 @@ export class PluginRegistry {
      * 启动全部已挂载 plugin。
      */
     async start_all() {
-        const snapshots = [];
-        for (const record of this.records.values()) {
+        this.initial_start_promise ??= this.start_initial_records();
+        return await this.initial_start_promise;
+    }
+    /** 串行启动构造期挂载的 Plugin，并隔离单个 lifecycle 失败。 */
+    async start_initial_records() {
+        const initial_records = [...this.records.values()];
+        for (const record of initial_records) {
             try {
                 await this.start_record(record);
             }
             catch {
-                // 关键点（中文）：单个 plugin 启动失败只影响自身，不能阻断其他 plugin 与 Agent ready。
+                // 关键点（中文）：单个 Plugin 启动失败只影响自身，不能阻断其他 Plugin 与 Agent ready。
             }
-            snapshots.push(to_plugin_snapshot(record));
         }
-        return snapshots;
+        return initial_records.map(to_plugin_snapshot);
+    }
+    /** 确保任何异步 Plugin 执行都发生在初始 lifecycle 启动完成后。 */
+    async ensure_initial_started() {
+        await this.start_all();
     }
     /**
      * 卸载全部 plugin。
@@ -280,7 +315,7 @@ export class PluginRegistry {
                 return;
             }
             try {
-                await record.plugin.lifecycle?.start?.(this.require_context());
+                await record.plugin.lifecycle?.start?.(this.agent_context);
                 record.lifecycle_started = true;
                 update_record_state(record, "ready");
             }
@@ -294,38 +329,51 @@ export class PluginRegistry {
         await run_serial(record, async () => {
             if (!record.lifecycle_started)
                 return;
+            const errors = [];
             try {
-                await record.plugin.lifecycle?.stop?.(this.require_context());
+                try {
+                    await record.plugin.lifecycle?.stop?.(this.agent_context);
+                }
+                catch (error) {
+                    errors.push(error);
+                }
             }
             finally {
                 record.lifecycle_started = false;
                 record.updated_at = now_ms();
             }
+            if (errors.length > 0) {
+                throw new AggregateError(errors, `Plugin cleanup failed: ${record.plugin.name}`);
+            }
         });
     }
     /**
      * 运行 pipeline 点。
      */
-    async pipeline(point_name, value) {
-        return this.hookRegistry.pipelineValue(point_name, value);
+    async pipeline(context, point_name, value) {
+        await this.ensure_initial_started();
+        return this.hookRegistry.pipelineValue(context, point_name, value, (plugin_name) => this.plugin_context(context, plugin_name));
     }
     /**
      * 运行 guard 点。
      */
-    async guard(point_name, value) {
-        return this.hookRegistry.guardValue(point_name, value);
+    async guard(context, point_name, value) {
+        await this.ensure_initial_started();
+        return this.hookRegistry.guardValue(context, point_name, value, (plugin_name) => this.plugin_context(context, plugin_name));
     }
     /**
      * 运行 effect 点。
      */
-    async effect(point_name, value) {
-        return this.hookRegistry.effectValue(point_name, value);
+    async effect(context, point_name, value) {
+        await this.ensure_initial_started();
+        return this.hookRegistry.effectValue(context, point_name, value, (plugin_name) => this.plugin_context(context, plugin_name));
     }
     /**
      * 运行 resolve 点。
      */
-    async resolve(point_name, value) {
-        return this.hookRegistry.resolveValue(point_name, value);
+    async resolve(context, point_name, value) {
+        await this.ensure_initial_started();
+        return this.hookRegistry.resolveValue(context, point_name, value, (plugin_name) => this.plugin_context(context, plugin_name));
     }
     /**
      * 获取单个 plugin 定义。
@@ -405,7 +453,8 @@ export class PluginRegistry {
     /**
      * 检查 plugin 可用性。
      */
-    async availability(plugin_name) {
+    async availability(context, plugin_name) {
+        await this.ensure_initial_started();
         const key = normalize_plugin_name(plugin_name);
         const record = this.records.get(key);
         if (!record) {
@@ -423,7 +472,7 @@ export class PluginRegistry {
             };
         }
         if (record.plugin.availability) {
-            return await record.plugin.availability(this.require_context());
+            return await record.plugin.availability(this.plugin_context(context, key));
         }
         return {
             enabled: true,
@@ -431,33 +480,17 @@ export class PluginRegistry {
             reasons: [],
         };
     }
-    /**
-     * 按 action schema 校验 payload。
-     */
-    parseActionPayload(params) {
-        const schema = params.action.input_schema?.zod;
-        if (!schema)
-            return { input: params.payload };
-        const parsed = schema.safeParse(params.payload);
-        if (parsed.success) {
-            return { input: parsed.data };
-        }
-        return {
-            success: false,
-            error: `Invalid payload for ${params.plugin_name}.${params.action_name}: ${parsed.error.message}`,
-            message: `Invalid payload for ${params.plugin_name}.${params.action_name}`,
-        };
-    }
     /**
      * 运行 plugin action。
      */
     async run_action(params) {
-        return await this.run_action_from_records(this.records, params);
+        await this.ensure_initial_started();
+        return await this.run_action_from_records(this.records, params.context, params);
     }
     /**
      * 从指定记录视图运行 plugin action。
      */
-    async run_action_from_records(records, params) {
+    async run_action_from_records(records, context, params) {
         const key = normalize_plugin_name(params.plugin);
         const record = records.get(key);
         if (!record) {
@@ -490,46 +523,29 @@ export class PluginRegistry {
                 message: `Plugin "${record.plugin.name}" does not implement action "${action_name}"`,
             };
         }
-        try {
-            const parsed_payload = this.parseActionPayload({
-                plugin_name: record.plugin.name,
-                action_name,
-                payload: (params.payload ?? {}),
-                action,
-            });
-            if (!("input" in parsed_payload)) {
-                return parsed_payload;
-            }
-            const result = await action.execute({
-                context: this.require_context(),
-                input: parsed_payload.input,
-                plugin_name: record.plugin.name,
-                action_name,
-                ...(params.execution_context
-                    ? { execution_context: params.execution_context }
-                    : {}),
-            });
-            return result;
-        }
-        catch (error) {
-            return {
-                success: false,
-                error: String(error),
-                message: String(error),
-            };
-        }
+        return await execute_plugin_action({
+            context: this.plugin_context(context, record.plugin.name),
+            plugin_name: record.plugin.name,
+            action_name,
+            action,
+            payload: (params.payload ?? {}),
+            ...(params.execution_context
+                ? { snapshot: params.execution_context }
+                : {}),
+            ...(params.interactions ? { interactions: params.interactions } : {}),
+        });
     }
     /**
      * 读取当前生效的 plugin system blocks。
      */
-    async system_blocks(execution_context) {
-        return await this.system_blocks_from_records(this.records, execution_context);
+    async system_blocks(context, execution_context) {
+        await this.ensure_initial_started();
+        return await this.system_blocks_from_records(this.records, context, execution_context);
     }
     /**
      * 从指定记录视图解析 plugin system blocks。
      */
-    async system_blocks_from_records(records, execution_context) {
-        const context = this.require_context();
+    async system_blocks_from_records(records, context, execution_context) {
         const out = [];
         for (const record of records.values()) {
             const plugin = record.plugin;
@@ -539,11 +555,12 @@ export class PluginRegistry {
                 continue;
             try {
                 if (typeof plugin.availability === "function") {
-                    const availability = await plugin.availability(context);
+                    const plugin_context = this.plugin_context(context, plugin.name);
+                    const availability = await plugin.availability(plugin_context);
                     if (!availability.available)
                         continue;
                 }
-                const text = String(await plugin.system(context, execution_context)).trim();
+                const text = String(await plugin.system(this.plugin_context(context, plugin.name), execution_context)).trim();
                 if (!text)
                     continue;
                 out.push({
@@ -561,19 +578,19 @@ export class PluginRegistry {
     /**
      * 创建当前 configured registry 的 Session step 执行视图。
      */
-    execution_view() {
+    execution_view(context) {
         const records = new Map(this.records);
         return {
             read: (params) => this.read_from_records(records, params),
-            run_action: async (params) => await this.run_action_from_records(records, params),
-            system_blocks: async (execution_context) => await this.system_blocks_from_records(records, execution_context),
-            acquire: () => this.acquire_execution_view(records),
+            run_action: async (params) => await this.run_action_from_records(records, context, params),
+            system_blocks: async (execution_context) => await this.system_blocks_from_records(records, context, execution_context),
+            acquire: () => this.acquire_execution_view(records, context),
         };
     }
     /**
      * 为单次 Session step 获取 Plugin execution lease。
      */
-    acquire_execution_view(records) {
+    acquire_execution_view(records, context) {
         const leased_records = new Map();
         for (const [name, record] of records) {
             if (record.retired ||
@@ -587,8 +604,8 @@ export class PluginRegistry {
         let released = false;
         return {
             read: (params) => this.read_from_records(leased_records, params),
-            run_action: async (params) => await this.run_action_from_records(leased_records, params),
-            system_blocks: async (execution_context) => await this.system_blocks_from_records(leased_records, execution_context),
+            run_action: async (params) => await this.run_action_from_records(leased_records, context, params),
+            system_blocks: async (execution_context) => await this.system_blocks_from_records(leased_records, context, execution_context),
             release: async () => {
                 if (released)
                     return;
@@ -631,13 +648,14 @@ export class PluginRegistry {
         }
         record.retirement_started = true;
         void (async () => {
+            const logger = this.agent_context.logger;
             try {
                 await this.stop_record(record);
             }
             catch (error) {
                 update_record_state(record, "error", String(error));
                 try {
-                    await this.require_context().logger.log("error", "[plugin] lifecycle.stop failed after execution release", {
+                    await logger?.log("error", "[plugin] lifecycle.stop failed after execution release", {
                         plugin: record.plugin.name,
                         error: String(error),
                     });