@downcity/agent 1.1.174 → 1.1.178

package/bin/plugin/core/PluginLocalExecution.js

@@ -4,21 +4,25 @@
  * 关键点（中文）
  * - 这里不创建或维护任何全局注册表，调用方必须显式传入 plugin 集合。
  * - 用于 CLI / 控制面这类没有运行中 Agent 实例、但需要执行 setup action 的场景。
- * - 真正运行中的 Agent 仍应优先使用 `PluginRegistry.runAction`。
+ * - 真正运行中的 Agent 仍应优先使用 `Agent.plugins.runAction`。
  */
 import path from "node:path";
 import { logger as defaultLogger } from "../../utils/logger/Logger.js";
-import { loadDowncityConfig, resolveAgentEnv } from "../../config/Config.js";
-import { isPluginEnabled } from "../../plugin/core/Activation.js";
+import { resolveAgentEnv } from "../../config/Config.js";
 import { findPluginByName } from "../../plugin/core/PluginCatalog.js";
 import { createAgentPathRuntime, createAgentPluginConfigRuntime, } from "../../agent/local/AgentRuntimeAssembly.js";
+import { createFallbackSdkConfig } from "../../agent/local/AgentInstructions.js";
 /**
  * 创建本地 plugin 命令上下文。
  */
-export function createLocalPluginCommandContext(projectRoot) {
+export function createLocalPluginCommandContext(input) {
+    const projectRoot = typeof input === "string" ? input : input.projectRoot;
     const rootPath = path.resolve(String(projectRoot || "").trim() || ".");
     const env = resolveAgentEnv(rootPath);
-    const config = loadDowncityConfig(rootPath);
+    const config = typeof input === "string" || !input.config
+        ? createFallbackSdkConfig(path.basename(rootPath) || "agent")
+        : input.config;
+    const agent_id = String(config.id || "").trim() || path.basename(rootPath) || "agent";
     defaultLogger.bindProjectRoot(rootPath);
     return {
         cwd: rootPath,
@@ -26,7 +30,7 @@ export function createLocalPluginCommandContext(projectRoot) {
         logger: defaultLogger,
         config,
         env,
-        paths: createAgentPathRuntime(rootPath, String(config.id || "").trim() || path.basename(rootPath) || "agent"),
+        paths: createAgentPathRuntime(rootPath, agent_id),
         pluginConfig: createAgentPluginConfigRuntime(rootPath),
     };
 }
@@ -42,18 +46,13 @@ export async function getLocalPluginAvailability(params) {
             reasons: [`Unknown plugin: ${params.pluginName}`],
         };
     }
-    const context = createLocalPluginCommandContext(params.projectRoot);
+    const context = createLocalPluginCommandContext({
+        projectRoot: params.projectRoot,
+        config: params.config,
+    });
     if (plugin.availability) {
         return await plugin.availability(context);
     }
-    const enabled = isPluginEnabled({ plugin, context });
-    if (!enabled) {
-        return {
-            enabled: false,
-            available: false,
-            reasons: [`Plugin "${plugin.name}" is disabled`],
-        };
-    }
     return {
         enabled: true,
         available: true,
@@ -88,15 +87,10 @@ export async function runLocalPluginAction(params) {
             message: `Plugin "${plugin.name}" does not implement action "${actionName}"`,
         };
     }
-    const context = createLocalPluginCommandContext(params.projectRoot);
-    const enabled = isPluginEnabled({ plugin, context });
-    if (!enabled && action.allowWhenDisabled !== true) {
-        return {
-            success: false,
-            error: `Plugin "${plugin.name}" is disabled`,
-            message: `Plugin "${plugin.name}" is disabled`,
-        };
-    }
+    const context = createLocalPluginCommandContext({
+        projectRoot: params.projectRoot,
+        config: params.config,
+    });
     try {
         const payload = (params.payload ?? {});
         const schema = action.input_schema?.zod;

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

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

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

@@ -1,30 +1,75 @@
 /**
- * Plugin 注册表。
+ * Agent plugin runtime。
  *
  * 关键点（中文）
- * - 统一管理 plugin 注册、可用性检查与显式 action 运行。
- * - Plugin 自身不维护独立状态机；可用性由 enabled 配置与 plugin 自定义 availability 决定。
+ * - Plugin 只属于 Agent：注册即生效，卸载即不可见。
+ * - 注册时自动启动 plugin lifecycle；卸载时自动停止 plugin lifecycle。
+ * - action、system、hook、resolve 都统一以“已注册且 ready”为生效边界。
  */
 import type { HookRegistry } from "../../plugin/core/HookRegistry.js";
 import type { Plugin, PluginActionResult, AgentPlugins, PluginAvailability, PluginReadView, PluginView } from "../../plugin/types/Plugin.js";
+import type { AgentSessionSystemBlock } from "../../types/agent/AgentTypes.js";
 import type { AgentContext } from "../../types/runtime/agent/AgentContext.js";
 import type { JsonValue } from "../../types/common/Json.js";
+import type { PluginSnapshot } from "../../types/plugin/PluginState.js";
 type ContextResolver = () => AgentContext;
 /**
- * PluginRegistry：plugin 注册与调度实现。
+ * PluginRegistry：Agent plugin 注册、卸载与调用实现。
  */
 export declare class PluginRegistry implements AgentPlugins {
     private readonly contextResolver;
     private readonly hookRegistry;
-    private readonly plugins;
+    private readonly pluginInstances;
+    private readonly records;
     constructor(params: {
         contextResolver: ContextResolver;
         hookRegistry: HookRegistry;
+        pluginInstances: Map<string, Plugin>;
     });
     /**
-     * 注册单个 Plugin。
+     * 注册单个 plugin。
+     *
+     * 说明（中文）
+     * - 同名注册表示替换：先卸载旧实例，再注册并启动新实例。
+     * - 如果新实例启动失败，会自动回滚为未注册状态并抛错。
      */
-    register(plugin: Plugin): void;
+    register(plugin: Plugin): Promise<PluginSnapshot>;
+    /**
+     * 同步挂载 plugin 元信息。
+     *
+     * 说明（中文）
+     * - 仅供 Agent 构造期使用，避免构造函数里 await。
+     * - 后续 `startAll()` 会统一启动这些初始 plugin。
+     */
+    mount(plugin: Plugin): PluginSnapshot;
+    /**
+     * 卸载指定 plugin。
+     */
+    unregister(pluginName: string): Promise<boolean>;
+    /**
+     * 启动全部已挂载 plugin。
+     */
+    startAll(): Promise<PluginSnapshot[]>;
+    /**
+     * 卸载全部 plugin。
+     */
+    unregisterAll(): Promise<void>;
+    /**
+     * 判断 plugin 是否已注册且 ready。
+     */
+    isReady(pluginName: string): boolean;
+    /**
+     * 读取单个 plugin 快照。
+     */
+    status(pluginName: string): PluginSnapshot | null;
+    /**
+     * 判断 plugin 是否已注册。
+     */
+    has(pluginName: string): boolean;
+    private register_hooks;
+    private unregister_hooks;
+    private start_record;
+    private stop_record;
     /**
      * 运行 pipeline 点。
      */
@@ -49,6 +94,10 @@ export declare class PluginRegistry implements AgentPlugins {
      * 列出全部 plugin 概览视图。
      */
     list(): PluginView[];
+    /**
+     * 列出全部 plugin 注册快照。
+     */
+    snapshots(): PluginSnapshot[];
     /**
      * 读取 action metadata。
      */
@@ -78,6 +127,10 @@ export declare class PluginRegistry implements AgentPlugins {
         action: string;
         payload?: JsonValue;
     }): Promise<PluginActionResult<JsonValue>>;
+    /**
+     * 读取当前生效的 plugin system blocks。
+     */
+    systemBlocks(): Promise<AgentSessionSystemBlock[]>;
 }
 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":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EACV,MAAM,EACN,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAElB,cAAc,EACd,UAAU,EACX,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,KAAK,eAAe,GAAG,MAAM,YAAY,CAAC;AAE1C;;GAEG;AACH,qBAAa,cAAe,YAAW,YAAY;IACjD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAElD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAE5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;gBAEzC,MAAM,EAAE;QAClB,eAAe,EAAE,eAAe,CAAC;QACjC,YAAY,EAAE,YAAY,CAAC;KAC5B;IAKD;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAuC9B;;OAEG;IACG,QAAQ,CAAC,CAAC,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAItE;;OAEG;IACG,KAAK,CAAC,CAAC,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAItE;;OAEG;IACG,MAAM,CAAC,CAAC,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvE;;OAEG;IACG,OAAO,CAAC,MAAM,GAAG,SAAS,EAAE,OAAO,GAAG,SAAS,EACnD,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,OAAO,CAAC;IAInB;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAItC;;OAEG;IACH,IAAI,IAAI,UAAU,EAAE;IAMpB;;OAEG;IACH,OAAO,CAAC,UAAU;IAkBlB;;OAEG;IACH,IAAI,CAAC,MAAM,EAAE;QACX,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,cAAc,GAAG;QAAE,OAAO,EAAE,UAAU,EAAE,CAAA;KAAE;IA2B9C;;OAEG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA+BnE;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAmB1B;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,SAAS,CAAC;KACrB,GAAG,OAAO,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;CA+D3C"}
+{"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

@@ -1,35 +1,181 @@
 /**
- * Plugin 注册表。
+ * Agent plugin runtime。
  *
  * 关键点（中文）
- * - 统一管理 plugin 注册、可用性检查与显式 action 运行。
- * - Plugin 自身不维护独立状态机；可用性由 enabled 配置与 plugin 自定义 availability 决定。
+ * - Plugin 只属于 Agent：注册即生效，卸载即不可见。
+ * - 注册时自动启动 plugin lifecycle；卸载时自动停止 plugin lifecycle。
+ * - action、system、hook、resolve 都统一以“已注册且 ready”为生效边界。
  */
-import { isPluginEnabled } from "../../plugin/core/Activation.js";
 import { toPluginView } from "../../plugin/core/PluginCatalog.js";
+function now_ms() {
+    return Date.now();
+}
+function normalize_plugin_name(plugin_name) {
+    return String(plugin_name || "").trim();
+}
+function create_record(plugin) {
+    const current_time = now_ms();
+    return {
+        plugin,
+        state: "ready",
+        registered_at: current_time,
+        updated_at: current_time,
+        chain: Promise.resolve(),
+        lifecycle_started: false,
+    };
+}
+function to_plugin_snapshot(record) {
+    const plugin = record.plugin;
+    const last_error = String(record.last_error || "").trim();
+    return {
+        name: plugin.name,
+        title: String(plugin.title || plugin.name || "").trim(),
+        description: String(plugin.description || "").trim(),
+        status: record.state,
+        state: record.state,
+        registered_at: record.registered_at,
+        updated_at: record.updated_at,
+        updatedAt: record.updated_at,
+        ...(last_error ? { last_error, lastError: last_error } : {}),
+    };
+}
+function update_record_state(record, state, error) {
+    record.state = state;
+    record.updated_at = now_ms();
+    const normalized_error = String(error || "").trim();
+    if (normalized_error) {
+        record.last_error = normalized_error;
+    }
+    else {
+        delete record.last_error;
+    }
+}
+async function run_serial(record, step) {
+    const next = record.chain.then(() => Promise.resolve(step()));
+    record.chain = next.then(() => undefined, () => undefined);
+    await next;
+}
 /**
- * PluginRegistry：plugin 注册与调度实现。
+ * PluginRegistry：Agent plugin 注册、卸载与调用实现。
  */
 export class PluginRegistry {
     contextResolver;
     hookRegistry;
-    plugins = new Map();
+    pluginInstances;
+    records = new Map();
     constructor(params) {
         this.contextResolver = params.contextResolver;
         this.hookRegistry = params.hookRegistry;
+        this.pluginInstances = params.pluginInstances;
+    }
+    /**
+     * 注册单个 plugin。
+     *
+     * 说明（中文）
+     * - 同名注册表示替换：先卸载旧实例，再注册并启动新实例。
+     * - 如果新实例启动失败，会自动回滚为未注册状态并抛错。
+     */
+    async register(plugin) {
+        const key = normalize_plugin_name(plugin.name);
+        if (!key) {
+            throw new Error("Plugin name is required");
+        }
+        if (this.records.has(key)) {
+            await this.unregister(key);
+        }
+        const record = create_record(plugin);
+        this.records.set(key, record);
+        this.register_hooks(plugin);
+        this.pluginInstances.set(key, plugin);
+        try {
+            await this.start_record(record);
+            return to_plugin_snapshot(record);
+        }
+        catch (error) {
+            this.unregister_hooks(key);
+            this.records.delete(key);
+            this.pluginInstances.delete(key);
+            throw error;
+        }
     }
     /**
-     * 注册单个 Plugin。
+     * 同步挂载 plugin 元信息。
+     *
+     * 说明（中文）
+     * - 仅供 Agent 构造期使用，避免构造函数里 await。
+     * - 后续 `startAll()` 会统一启动这些初始 plugin。
      */
-    register(plugin) {
-        const key = String(plugin.name || "").trim();
+    mount(plugin) {
+        const key = normalize_plugin_name(plugin.name);
         if (!key) {
             throw new Error("Plugin name is required");
         }
-        if (this.plugins.has(key)) {
+        if (this.records.has(key)) {
             throw new Error(`Plugin already registered: ${key}`);
         }
-        this.plugins.set(key, plugin);
+        const record = create_record(plugin);
+        this.records.set(key, record);
+        this.register_hooks(plugin);
+        this.pluginInstances.set(key, plugin);
+        return to_plugin_snapshot(record);
+    }
+    /**
+     * 卸载指定 plugin。
+     */
+    async unregister(pluginName) {
+        const key = normalize_plugin_name(pluginName);
+        if (!key)
+            return false;
+        const record = this.records.get(key);
+        if (!record)
+            return false;
+        await this.stop_record(record);
+        this.unregister_hooks(key);
+        this.records.delete(key);
+        this.pluginInstances.delete(key);
+        return true;
+    }
+    /**
+     * 启动全部已挂载 plugin。
+     */
+    async startAll() {
+        const snapshots = [];
+        for (const record of this.records.values()) {
+            await this.start_record(record);
+            snapshots.push(to_plugin_snapshot(record));
+        }
+        return snapshots;
+    }
+    /**
+     * 卸载全部 plugin。
+     */
+    async unregisterAll() {
+        for (const name of Array.from(this.records.keys())) {
+            await this.unregister(name);
+        }
+    }
+    /**
+     * 判断 plugin 是否已注册且 ready。
+     */
+    isReady(pluginName) {
+        const record = this.records.get(normalize_plugin_name(pluginName));
+        return Boolean(record && record.state === "ready");
+    }
+    /**
+     * 读取单个 plugin 快照。
+     */
+    status(pluginName) {
+        const record = this.records.get(normalize_plugin_name(pluginName));
+        return record ? to_plugin_snapshot(record) : null;
+    }
+    /**
+     * 判断 plugin 是否已注册。
+     */
+    has(pluginName) {
+        return this.records.has(normalize_plugin_name(pluginName));
+    }
+    register_hooks(plugin) {
+        const key = normalize_plugin_name(plugin.name);
         for (const [hookName, handlers] of Object.entries(plugin.hooks?.pipeline || {})) {
             for (const handler of handlers) {
                 this.hookRegistry.pipeline(hookName, key, handler);
@@ -49,6 +195,43 @@ export class PluginRegistry {
             this.hookRegistry.resolve(pointName, key, handler);
         }
     }
+    unregister_hooks(pluginName) {
+        this.hookRegistry.unregisterPlugin(pluginName);
+    }
+    async start_record(record) {
+        if (record.lifecycle_started) {
+            update_record_state(record, "ready");
+            return;
+        }
+        await run_serial(record, async () => {
+            if (record.lifecycle_started) {
+                update_record_state(record, "ready");
+                return;
+            }
+            try {
+                await record.plugin.lifecycle?.start?.(this.contextResolver());
+                record.lifecycle_started = true;
+                update_record_state(record, "ready");
+            }
+            catch (error) {
+                update_record_state(record, "error", String(error));
+                throw error;
+            }
+        });
+    }
+    async stop_record(record) {
+        await run_serial(record, async () => {
+            if (!record.lifecycle_started)
+                return;
+            try {
+                await record.plugin.lifecycle?.stop?.(this.contextResolver());
+            }
+            finally {
+                record.lifecycle_started = false;
+                record.updated_at = now_ms();
+            }
+        });
+    }
     /**
      * 运行 pipeline 点。
      */
@@ -77,14 +260,22 @@ export class PluginRegistry {
      * 获取单个 plugin 定义。
      */
     get(pluginName) {
-        return this.plugins.get(String(pluginName || "").trim()) || null;
+        return this.records.get(normalize_plugin_name(pluginName))?.plugin || null;
     }
     /**
      * 列出全部 plugin 概览视图。
      */
     list() {
-        return Array.from(this.plugins.values())
-            .map((plugin) => toPluginView(plugin))
+        return Array.from(this.records.values())
+            .map((record) => toPluginView(record.plugin))
+            .sort((a, b) => a.name.localeCompare(b.name));
+    }
+    /**
+     * 列出全部 plugin 注册快照。
+     */
+    snapshots() {
+        return Array.from(this.records.values())
+            .map((record) => to_plugin_snapshot(record))
             .sort((a, b) => a.name.localeCompare(b.name));
     }
     /**
@@ -108,7 +299,7 @@ export class PluginRegistry {
      * 读取 plugin / action metadata。
      */
     read(params) {
-        const pluginName = String(params.plugin || "").trim();
+        const pluginName = normalize_plugin_name(params.plugin || "");
         if (!pluginName) {
             return { plugins: this.list() };
         }
@@ -121,7 +312,7 @@ export class PluginRegistry {
                 actions: [],
             };
         }
-        const actionName = String(params.action || "").trim();
+        const actionName = normalize_plugin_name(params.action || "");
         const actions = Object.entries(plugin.actions || {})
             .filter(([name]) => !actionName || name === actionName)
             .sort(([left], [right]) => left.localeCompare(right))
@@ -137,26 +328,25 @@ export class PluginRegistry {
      * 检查 plugin 可用性。
      */
     async availability(pluginName) {
-        const plugin = this.get(pluginName);
-        if (!plugin) {
+        const key = normalize_plugin_name(pluginName);
+        const record = this.records.get(key);
+        if (!record) {
             return {
                 enabled: false,
                 available: false,
                 reasons: [`Unknown plugin: ${pluginName}`],
             };
         }
-        if (plugin.availability) {
-            return await plugin.availability(this.contextResolver());
-        }
-        const context = this.contextResolver();
-        const enabled = isPluginEnabled({ plugin, context });
-        if (!enabled) {
+        if (record.state !== "ready") {
             return {
-                enabled: false,
+                enabled: true,
                 available: false,
-                reasons: [`Plugin "${plugin.name}" is disabled`],
+                reasons: [record.last_error || `Plugin "${record.plugin.name}" is not ready`],
             };
         }
+        if (record.plugin.availability) {
+            return await record.plugin.availability(this.contextResolver());
+        }
         return {
             enabled: true,
             available: true,
@@ -184,15 +374,16 @@ export class PluginRegistry {
      * 运行 plugin action。
      */
     async runAction(params) {
-        const plugin = this.get(params.plugin);
-        if (!plugin) {
+        const key = normalize_plugin_name(params.plugin);
+        const record = this.records.get(key);
+        if (!record) {
             return {
                 success: false,
                 error: `Unknown plugin: ${params.plugin}`,
                 message: `Unknown plugin: ${params.plugin}`,
             };
         }
-        const actionName = String(params.action || "").trim();
+        const actionName = normalize_plugin_name(params.action);
         if (!actionName) {
             return {
                 success: false,
@@ -200,26 +391,24 @@ export class PluginRegistry {
                 message: "action is required",
             };
         }
-        const action = plugin.actions?.[actionName];
-        if (!action) {
+        if (record.state !== "ready") {
             return {
                 success: false,
-                error: `Plugin "${plugin.name}" does not implement action "${actionName}"`,
-                message: `Plugin "${plugin.name}" does not implement action "${actionName}"`,
+                error: `Plugin "${record.plugin.name}" is not ready`,
+                message: `Plugin "${record.plugin.name}" is not ready`,
             };
         }
-        const context = this.contextResolver();
-        const enabled = isPluginEnabled({ plugin, context });
-        if (!enabled && action.allowWhenDisabled !== true) {
+        const action = record.plugin.actions?.[actionName];
+        if (!action) {
             return {
                 success: false,
-                error: `Plugin "${plugin.name}" is disabled`,
-                message: `Plugin "${plugin.name}" is disabled`,
+                error: `Plugin "${record.plugin.name}" does not implement action "${actionName}"`,
+                message: `Plugin "${record.plugin.name}" does not implement action "${actionName}"`,
             };
         }
         try {
             const parsed_payload = this.parseActionPayload({
-                pluginName: plugin.name,
+                pluginName: record.plugin.name,
                 actionName,
                 payload: (params.payload ?? {}),
                 action,
@@ -227,15 +416,20 @@ export class PluginRegistry {
             if (!("input" in parsed_payload)) {
                 return parsed_payload;
             }
-            return await action.execute({
-                context,
+            const result = await action.execute({
+                context: this.contextResolver(),
                 payload: parsed_payload.input,
                 input: parsed_payload.input,
-                pluginName: plugin.name,
+                pluginName: record.plugin.name,
                 actionName,
             });
+            if (!result.success) {
+                update_record_state(record, "error", result.error || result.message);
+            }
+            return result;
         }
         catch (error) {
+            update_record_state(record, "error", String(error));
             return {
                 success: false,
                 error: String(error),
@@ -243,5 +437,38 @@ export class PluginRegistry {
             };
         }
     }
+    /**
+     * 读取当前生效的 plugin system blocks。
+     */
+    async systemBlocks() {
+        const context = this.contextResolver();
+        const out = [];
+        for (const record of this.records.values()) {
+            const plugin = record.plugin;
+            if (record.state !== "ready")
+                continue;
+            if (typeof plugin.system !== "function")
+                continue;
+            try {
+                if (typeof plugin.availability === "function") {
+                    const availability = await plugin.availability(context);
+                    if (!availability.available)
+                        continue;
+                }
+                const text = String(await plugin.system(context)).trim();
+                if (!text)
+                    continue;
+                out.push({
+                    source: "plugin",
+                    name: plugin.name,
+                    content: text,
+                });
+            }
+            catch {
+                // 单个 plugin system 失败不应阻断 session 主链路。
+            }
+        }
+        return out;
+    }
 }
 //# sourceMappingURL=PluginRegistry.js.map