@downcity/agent 1.1.32 → 1.1.35

package/src/plugin/builtins/tts/Plugin.ts

@@ -6,6 +6,8 @@
  * - Console 只通过 setup / action 与插件交互，保持极简统一。
  */
 
+import type { AgentRuntime } from "@/core/AgentCoreTypes.js";
+import { BasePlugin } from "@/plugin/core/BasePlugin.js";
 import type { Plugin } from "@/plugin/types/Plugin.js";
 import type {
   TtsInstallInput,
@@ -29,11 +31,9 @@ import {
   toJsonObject,
 } from "@/plugin/builtins/tts/PluginSupport.js";
 
-/**
- * ttsPlugin：文本转语音插件定义。
- */
-export const ttsPlugin: Plugin = {
-  name: "tts",
+function createTtsPluginDefinition(plugin: Plugin): Plugin {
+  return {
+    name: "tts",
   title: "Text To Speech",
   description:
     "Generates local speech audio files from plain text through an installed TTS model, then returns a reusable audio file tag for downstream sending.",
@@ -118,7 +118,7 @@ export const ttsPlugin: Plugin = {
     statusAction: "status",
   },
   async availability(context) {
-    if (!isPluginEnabled({ plugin: ttsPlugin, context })) {
+    if (!isPluginEnabled({ plugin, context })) {
       return {
         enabled: false,
         available: false,
@@ -143,7 +143,7 @@ export const ttsPlugin: Plugin = {
       },
       execute: async ({ context }) => {
         const config = readTtsPluginConfig(context);
-        const availability = await ttsPlugin.availability!(context);
+        const availability = await plugin.availability!(context);
         const synthesizer = await checkTtsSynthesizer(context);
         return {
           success: true,
@@ -446,7 +446,7 @@ export const ttsPlugin: Plugin = {
         },
       },
       execute: async ({ context, payload }) => {
-        const pluginStatus = await ttsPlugin.availability!(context);
+        const pluginStatus = await plugin.availability!(context);
         if (!pluginStatus.enabled || !pluginStatus.available) {
           return {
             success: false,
@@ -477,7 +477,7 @@ export const ttsPlugin: Plugin = {
     },
   },
   system(context) {
-    if (!isPluginEnabled({ plugin: ttsPlugin, context })) {
+    if (!isPluginEnabled({ plugin, context })) {
       return "";
     }
     return [
@@ -493,4 +493,17 @@ export const ttsPlugin: Plugin = {
       "Example: `city tts synthesize \"你好，欢迎来到 Downcity\" --format wav`",
     ].join("\n");
   },
-};
+  };
+}
+
+/**
+ * TtsPlugin：文本转语音插件。
+ */
+export class TtsPlugin extends BasePlugin {
+  readonly name = "tts";
+
+  constructor(agent: AgentRuntime | null = null) {
+    super(agent);
+    Object.assign(this, createTtsPluginDefinition(this));
+  }
+}

package/src/plugin/builtins/web/Plugin.ts

@@ -5,6 +5,8 @@
  * - `web` plugin 不再自实现联网与浏览器能力，只负责 provider 选择、状态检查与提示词注入。
  * - 真正的联网逻辑直接交给外部实现：`web-access` 或 `agent-browser`。
  */
+import type { AgentRuntime } from "@/core/AgentCoreTypes.js";
+import { BasePlugin } from "@/plugin/core/BasePlugin.js";
 import type { Plugin } from "@/plugin/types/Plugin.js";
 import type { JsonObject, JsonValue } from "@/types/common/Json.js";
 import type { WebPluginConfig, WebPluginInstallInput } from "@/plugin/builtins/web/types/WebPlugin.js";
@@ -82,11 +84,9 @@ function getInstallScopeOpt(
   return undefined;
 }
 
-/**
- * webPlugin：provider 选择器与提示词适配层。
- */
-export const webPlugin: Plugin = {
-  name: "web",
+function createWebPluginDefinition(plugin: Plugin): Plugin {
+  return {
+    name: "web",
   title: "Web Access",
   description:
     "Connects the agent to either web-access or agent-browser, checks provider readiness, and injects the matching guidance into the runtime prompt.",
@@ -164,7 +164,7 @@ export const webPlugin: Plugin = {
     statusAction: "status",
   },
   async availability(context) {
-    if (!isPluginEnabled({ plugin: webPlugin, context })) {
+    if (!isPluginEnabled({ plugin, context })) {
       return {
         enabled: false,
         available: false,
@@ -189,7 +189,7 @@ export const webPlugin: Plugin = {
       },
       execute: async ({ context }) => {
         const config = readWebPluginConfig(context);
-        const availability = await webPlugin.availability!(context);
+        const availability = await plugin.availability!(context);
         const source = await inspectWebPluginDependency(context);
         return {
           success: true,
@@ -461,7 +461,7 @@ export const webPlugin: Plugin = {
         },
       },
       execute: async ({ context }) => {
-        const availability = await webPlugin.availability!(context);
+        const availability = await plugin.availability!(context);
         const dependency = await doctorWebPluginDependency(context);
         return {
           success: true,
@@ -482,7 +482,7 @@ export const webPlugin: Plugin = {
   },
   system(context) {
     const config = readWebPluginConfig(context);
-    if (!isPluginEnabled({ plugin: webPlugin, context }) || !config.injectPrompt) {
+    if (!isPluginEnabled({ plugin, context }) || !config.injectPrompt) {
       return "";
     }
     const providerPrompt =
@@ -498,4 +498,17 @@ export const webPlugin: Plugin = {
       providerPrompt,
     ].join("\n");
   },
-};
+  };
+}
+
+/**
+ * WebPlugin：provider 选择器与提示词适配层。
+ */
+export class WebPlugin extends BasePlugin {
+  readonly name = "web";
+
+  constructor(agent: AgentRuntime | null = null) {
+    super(agent);
+    Object.assign(this, createWebPluginDefinition(this));
+  }
+}

package/src/plugin/builtins/workboard/Plugin.ts

@@ -6,76 +6,89 @@
  * - 当前通过 plugin HTTP 注入暴露 `/api/workboard/snapshot`，供 console 代理与 UI 消费。
  */
 
+import type { AgentRuntime } from "@/core/AgentCoreTypes.js";
+import { BasePlugin } from "@/plugin/core/BasePlugin.js";
 import type { Plugin } from "@/plugin/types/Plugin.js";
 import { isPluginEnabled } from "@/plugin/core/Activation.js";
 import { getWorkboardSnapshotStore } from "@/plugin/builtins/workboard/runtime/Store.js";
 import type { WorkboardSnapshotResponse } from "@/plugin/builtins/workboard/types/Workboard.js";
 
-/**
- * Workboard 插件定义。
- */
-export const workboardPlugin: Plugin = {
-  name: "workboard",
-  title: "Workboard Snapshot",
-  description:
-    "Collects structured runtime activity snapshots so console surfaces can show what the current agent is doing now and what it recently worked on.",
-  availability(context) {
-    if (!isPluginEnabled({ plugin: workboardPlugin, context })) {
+function createWorkboardPluginDefinition(plugin: Plugin): Plugin {
+  return {
+    name: "workboard",
+    title: "Workboard Snapshot",
+    description:
+      "Collects structured runtime activity snapshots so console surfaces can show what the current agent is doing now and what it recently worked on.",
+    availability(context) {
+      if (!isPluginEnabled({ plugin, context })) {
+        return {
+          enabled: false,
+          available: false,
+          reasons: ["workboard plugin disabled in city config"],
+        };
+      }
       return {
-        enabled: false,
-        available: false,
-        reasons: ["workboard plugin disabled in city config"],
+        enabled: true,
+        available: true,
+        reasons: [],
       };
-    }
-    return {
-      enabled: true,
-      available: true,
-      reasons: [],
-    };
-  },
-  http: {
-    runtime: {
-      authPolicies: [
-        {
-          path: "/api/workboard/*",
-          method: "GET",
-          requireAuth: true,
-          anyPermissions: ["agent.read"],
-        },
-      ],
-      register({ app, getContext }) {
-        app.get("/api/workboard/snapshot", async (c) => {
-          try {
-            const availability = await workboardPlugin.availability?.(getContext());
-            if (availability && availability.available !== true) {
+    },
+    http: {
+      server: {
+        authPolicies: [
+          {
+            path: "/api/workboard/*",
+            method: "GET",
+            requireAuth: true,
+            anyPermissions: ["agent.read"],
+          },
+        ],
+        register({ app, getContext }) {
+          app.get("/api/workboard/snapshot", async (c) => {
+            try {
+              const availability = await plugin.availability?.(getContext());
+              if (availability && availability.available !== true) {
+                return c.json(
+                  {
+                    success: false,
+                    error: availability.reasons.join("; ") || "workboard unavailable",
+                  },
+                  503,
+                );
+              }
+
+              const snapshot = await getWorkboardSnapshotStore({
+                contextResolver: getContext,
+              }).readSnapshot();
+              const payload: WorkboardSnapshotResponse = {
+                success: true,
+                snapshot,
+              };
+              return c.json(payload);
+            } catch (error) {
               return c.json(
                 {
                   success: false,
-                  error: availability.reasons.join("; ") || "workboard unavailable",
+                  error: error instanceof Error ? error.message : String(error),
                 },
-                503,
+                500,
               );
             }
-
-            const snapshot = await getWorkboardSnapshotStore({
-              contextResolver: getContext,
-            }).readSnapshot();
-            const payload: WorkboardSnapshotResponse = {
-              success: true,
-              snapshot,
-            };
-            return c.json(payload);
-          } catch (error) {
-            return c.json(
-              {
-                success: false,
-                error: error instanceof Error ? error.message : String(error),
-              },
-              500,
-            );
-          }
-        });
+          });
+        },
       },
     },
-  },
-};
+  };
+}
+
+/**
+ * WorkboardPlugin：运行态观测面板插件。
+ */
+export class WorkboardPlugin extends BasePlugin {
+  readonly name = "workboard";
+
+  constructor(agent: AgentRuntime | null = null) {
+    super(agent);
+    Object.assign(this, createWorkboardPluginDefinition(this));
+  }
+}

package/src/plugin/builtins/workboard/runtime/Collector.ts

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - 这里只做确定性采集，不引入 LLM 推理。
- * - 内部仍聚合 session、task、runtime plugin 三类运行事实，但最终只输出对外安全的模糊状态。
+ * - 内部仍聚合 session、task、plugin runtime 三类运行事实，但最终只输出对外安全的模糊状态。
  */
 
 import { listTaskDefinitions } from "@/plugin/builtins/task/Action.js";
@@ -72,7 +72,7 @@ export async function collectWorkboardSnapshot(
     signals: toWorkboardSignals({
       currentCount: current.length,
       recentCount: recent.length,
-      services: runtimePlugins,
+      plugins: runtimePlugins,
       taskResult,
     }),
   };

package/src/plugin/builtins/workboard/runtime/Normalizer.ts

@@ -7,7 +7,7 @@
  */
 
 import type { ControlSessionSummary } from "@/runtime/server/http/control/types/ControlViewData.js";
-import type { ServiceStateSnapshot } from "@/plugin/types/PluginState.js";
+import type { PluginStateSnapshot } from "@/plugin/types/PluginState.js";
 import type { TaskListResponse } from "@/plugin/builtins/task/types/TaskCommand.js";
 import type {
   WorkboardActivityItem,
@@ -181,10 +181,10 @@ export function toWorkboardSummary(params: {
 export function toWorkboardSignals(params: {
   currentCount: number;
   recentCount: number;
-  services: ServiceStateSnapshot[];
+  plugins: PluginStateSnapshot[];
   taskResult: TaskListResponse;
 }): WorkboardSignalItem[] {
-  const degradedCount = params.services.filter((item) => item.state !== "running").length;
+  const degradedCount = params.plugins.filter((item) => item.state !== "running").length;
   const taskCount = Array.isArray(params.taskResult.tasks) ? params.taskResult.tasks.length : 0;
 
   return [

package/src/plugin/core/BasePlugin.ts

@@ -4,7 +4,7 @@
  * 关键点（中文）
  * - 主动运行型能力与被动扩展型能力统一收敛到 plugin 概念。
  * - plugin 的长期状态归属于实例本身，而不是模块级单例。
- * - 旧 service 生命周期模型暂时通过 `lifecycle` 兼容，后续可逐步收敛到 `start/stop/command`。
+ * - 旧生命周期模型暂时通过 `lifecycle` 兼容，后续可逐步收敛到 `start/stop/command`。
  */
 
 import type { AgentContext } from "@/core/AgentContextTypes.js";
@@ -98,7 +98,7 @@ export abstract class BasePlugin implements Plugin {
   readonly http?: PluginHttpDefinition;
 
   /**
-   * 旧生命周期兼容层。
+   * 生命周期兼容层。
    */
   lifecycle?: PluginLifecycle;
 

package/src/plugin/core/BuiltinPluginClasses.ts

@@ -1,9 +1,20 @@
 /**
- * 内建主动型 plugin 类清单。
+ * 内建 plugin class 清单。
+ *
+ * 关键点（中文）
+ * - 所有内建 plugin 统一收敛到一套 `BasePlugin` class 注册表。
+ * - 不再保留“plugin runtime / static plugin”两套定义源。
+ * - 运行方式差异只通过 plugin 自身能力体现，例如是否声明 `lifecycle`。
  */
 
 import type { AgentRuntime } from "@/core/AgentCoreTypes.js";
 import type { BasePlugin } from "@/plugin/core/BasePlugin.js";
+import { AuthPlugin } from "@/plugin/builtins/auth/Plugin.js";
+import { SkillPlugin } from "@/plugin/builtins/skill/Plugin.js";
+import { WebPlugin } from "@/plugin/builtins/web/Plugin.js";
+import { AsrPlugin } from "@/plugin/builtins/asr/Plugin.js";
+import { TtsPlugin } from "@/plugin/builtins/tts/Plugin.js";
+import { WorkboardPlugin } from "@/plugin/builtins/workboard/Plugin.js";
 import { ChatPlugin } from "@/plugin/builtins/chat/ChatPlugin.js";
 import { ContactPlugin } from "@/plugin/builtins/contact/ContactPlugin.js";
 import { SchedulePlugin } from "@/plugin/builtins/schedule/SchedulePlugin.js";
@@ -12,16 +23,22 @@ import { MemoryPlugin } from "@/plugin/builtins/memory/MemoryPlugin.js";
 import { ShellPlugin } from "@/plugin/builtins/shell/ShellPlugin.js";
 
 /**
- * 单个主动型 plugin class 构造器。
+ * 单个内建 plugin class 构造器。
  */
 export type BuiltinPluginClass<T extends BasePlugin = BasePlugin> = new (
   agent: AgentRuntime | null,
 ) => T;
 
 /**
- * 全部内建主动型 plugin classes。
+ * 全部内建 plugin classes。
  */
 export const BUILTIN_PLUGIN_CLASSES: BuiltinPluginClass[] = [
+  AuthPlugin,
+  SkillPlugin,
+  WebPlugin,
+  AsrPlugin,
+  TtsPlugin,
+  WorkboardPlugin,
   ChatPlugin,
   ContactPlugin,
   SchedulePlugin,

package/src/plugin/core/Catalog.ts

@@ -3,11 +3,12 @@
  *
  * 关键点（中文）
  * - 这里承载 console 侧的静态 plugin 元数据视图。
- * - 目标是把“控制面可见的 plugin 定义”从 agent 执行态里拆出来复用。
+ * - 全部视图统一来源于 `BasePlugin` class 注册表，不再维护独立静态定义。
  * - 当前先服务 Console 与 `city plugin` CLI 的静态回退场景。
  */
 
-import { PLUGINS } from "@/plugin/core/Plugins.js";
+import { listRegisteredPlugins } from "@/plugin/core/PluginClassRegistry.js";
+import type { BasePlugin } from "@/plugin/core/BasePlugin.js";
 import { isPluginEnabled } from "@/plugin/core/Activation.js";
 import type {
   Plugin,
@@ -44,8 +45,8 @@ export function toStaticPluginView(plugin: Plugin): PluginView {
 /**
  * 列出全部内建 plugin 定义。
  */
-export function listBuiltinPlugins(): Plugin[] {
-  return [...PLUGINS];
+export function listBuiltinPlugins(): BasePlugin[] {
+  return listRegisteredPlugins();
 }
 
 /**
@@ -60,7 +61,7 @@ export function listStaticPluginViews(): PluginView[] {
 /**
  * 按名称查找内建 plugin 定义。
  */
-export function findBuiltinPlugin(pluginName: string): Plugin | null {
+export function findBuiltinPlugin(pluginName: string): BasePlugin | null {
   const key = String(pluginName || "").trim();
   if (!key) return null;
   return listBuiltinPlugins().find((plugin) => plugin.name === key) || null;

package/src/plugin/core/HttpRoutes.ts

@@ -2,12 +2,12 @@
  * Plugin HTTP 路由装配。
  *
  * 关键点（中文）
- * - 这里统一装配内建 plugin 的 runtime HTTP 路由与鉴权策略。
+ * - 这里统一装配内建 plugin 的 HTTP 路由与鉴权策略。
  * - plugin 自己声明路由；server 与 console 只负责消费这份声明。
  */
 
 import type { Hono } from "hono";
-import { PLUGINS } from "@/plugin/core/Plugins.js";
+import { listRegisteredPlugins } from "@/plugin/core/PluginClassRegistry.js";
 import type { AgentContext } from "@/core/AgentContextTypes.js";
 import type { AuthRoutePolicy } from "@/types/runtime/auth/AuthRoute.js";
 
@@ -27,9 +27,9 @@ function dedupeAuthPolicies(policies: AuthRoutePolicy[]): AuthRoutePolicy[] {
 /**
  * 列出全部内建 plugin runtime 鉴权策略。
  */
-export function listBuiltinPluginRuntimeAuthPolicies(): AuthRoutePolicy[] {
+export function listBuiltinPluginAuthPolicies(): AuthRoutePolicy[] {
   return dedupeAuthPolicies(
-    PLUGINS.flatMap((plugin) => plugin.http?.runtime?.authPolicies || []),
+    listRegisteredPlugins().flatMap((plugin) => plugin.http?.server?.authPolicies || []),
   );
 }
 
@@ -40,8 +40,8 @@ export function registerBuiltinPluginHttpRoutes(params: {
   app: Hono;
   getContext: () => AgentContext;
 }): void {
-  for (const plugin of PLUGINS) {
-    plugin.http?.runtime?.register({
+  for (const plugin of listRegisteredPlugins()) {
+    plugin.http?.server?.register({
       app: params.app,
       getContext: params.getContext,
       pluginName: plugin.name,

package/src/plugin/core/LocalExecution.ts

@@ -12,6 +12,7 @@ import { logger as defaultLogger } from "@/utils/logger/Logger.js";
 import { loadAgentEnvSnapshot, loadDowncityConfig, loadGlobalEnvFromStore } from "@/config/Config.js";
 import { isPluginEnabled } from "@/plugin/core/Activation.js";
 import { findBuiltinPlugin, listStaticPluginViews } from "@/plugin/core/Catalog.js";
+import { isManagedPlugin } from "@/plugin/core/PluginClassRegistry.js";
 import {
   createAgentPathRuntime,
   createAgentPluginConfigRuntime,
@@ -99,6 +100,13 @@ export async function getLocalPluginAvailability(
       reasons: [`Unknown plugin: ${pluginName}`],
     };
   }
+  if (isManagedPlugin(plugin)) {
+    return {
+      enabled: false,
+      available: false,
+      reasons: [`Plugin "${plugin.name}" must run through an active agent.`],
+    };
+  }
 
   const context = createLocalPluginCommandContext(projectRoot);
   if (plugin.availability) {
@@ -138,6 +146,13 @@ export async function runLocalPluginAction(params: {
       message: `Unknown plugin: ${params.pluginName}`,
     };
   }
+  if (isManagedPlugin(plugin)) {
+    return {
+      success: false,
+      error: `Plugin "${plugin.name}" must run through an active agent`,
+      message: `Plugin "${plugin.name}" must run through an active agent`,
+    };
+  }
 
   const actionName = String(params.actionName || "").trim();
   if (!actionName) {

package/src/plugin/core/PluginActionRunner.ts

@@ -62,7 +62,6 @@ export async function invokePluginAction(params: {
       context: params.context,
       payload: (params.payload ?? {}) as JsonValue,
       pluginName: params.plugin.name,
-      serviceName: params.plugin.name,
       actionName: params.actionName,
     });
   } catch (error) {

package/src/plugin/core/PluginClassRegistry.ts

@@ -1,5 +1,9 @@
 /**
- * PluginClassRegistry：主动型 plugin 类注册表。
+ * PluginClassRegistry：统一内建 plugin 类注册表。
+ *
+ * 关键点（中文）
+ * - 所有内建 plugin 都通过这里暴露实例与名称。
+ * - “是否由运行中的 agent 承载”不再由独立类型区分，而是从 plugin 能力推导。
  */
 
 import type { AgentRuntime } from "@/core/AgentCoreTypes.js";
@@ -16,19 +20,44 @@ function createPluginInstance(
 }
 
 /**
- * 返回全部已注册内建主动型 plugin 名称。
+ * 判断 plugin 是否需要运行中的 agent 来承载生命周期/命令。
+ */
+export function isManagedPlugin(plugin: BasePlugin): boolean {
+  return Boolean(plugin.lifecycle);
+}
+
+/**
+ * 返回全部已注册内建 plugin 名称。
  */
 export function listRegisteredPluginNames(): string[] {
   return BUILTIN_PLUGIN_CLASSES.map((PluginClass) => new PluginClass(null).name);
 }
 
 /**
- * 返回全部已注册内建主动型 plugin 实例视图。
+ * 返回全部已注册内建 plugin 实例视图。
  */
 export function listRegisteredPlugins(): BasePlugin[] {
   return BUILTIN_PLUGIN_CLASSES.map((PluginClass) => new PluginClass(null));
 }
 
+/**
+ * 返回全部本地 plugin 实例视图。
+ *
+ * 关键点（中文）
+ * - 本地 plugin 指“不依赖运行中 agent lifecycle”的那一类。
+ * - 这类 plugin 可直接由 CLI / 控制面在本进程执行。
+ */
+export function listLocalPlugins(): BasePlugin[] {
+  return listRegisteredPlugins().filter((plugin) => !isManagedPlugin(plugin));
+}
+
+/**
+ * 返回全部受 agent 托管的 plugin 实例视图。
+ */
+export function listManagedPlugins(): BasePlugin[] {
+  return listRegisteredPlugins().filter((plugin) => isManagedPlugin(plugin));
+}
+
 /**
  * 返回无宿主静态 plugin 实例集合。
  */
@@ -39,7 +68,7 @@ export function getRegisteredStaticPluginInstances(): Map<string, BasePlugin> {
 }
 
 /**
- * 为当前 agent 创建一组主动型 plugin instances。
+ * 为当前 agent 创建一组内建 plugin instances。
  */
 export function createRegisteredPluginInstances(
   agent: AgentRuntime | null,

package/src/plugin/core/PluginCommand.ts

@@ -2,14 +2,14 @@
  * Plugin Action CLI 注册器。
  *
  * 关键点（中文）
- * - 负责把 plugin actions 挂到 commander（`city <plugin> <action>`）。
- * - plugin 命令默认直接在当前 CLI 进程内执行，不再桥接到 agent transport。
+ * - 负责把“本地可执行”的 plugin actions 挂到 commander（`city <plugin> <action>`）。
+ * - 需要运行中 agent 的 plugin 不在这里注册，避免和受托管命令桥接冲突。
  */
 
 import path from "node:path";
 import type { Command } from "commander";
 import type { JsonObject, JsonValue } from "@/types/common/Json.js";
-import { PLUGINS } from "@/plugin/core/Plugins.js";
+import { listLocalPlugins } from "@/plugin/core/PluginClassRegistry.js";
 import type { Plugin, PluginAction } from "@/plugin/types/Plugin.js";
 import { runLocalPluginAction } from "@/plugin/core/LocalExecution.js";
 import { printResult } from "@/utils/cli/CliOutput.js";
@@ -206,7 +206,7 @@ function registerPluginActionCommand(params: {
  * 注册全部 plugin actions 的 CLI 命令。
  */
 export function registerAllPluginsForCli(program: Command): void {
-  for (const plugin of PLUGINS) {
+  for (const plugin of listLocalPlugins()) {
     for (const [actionName, action] of Object.entries(plugin.actions || {})) {
       registerPluginActionCommand({
         program,

package/src/plugin/core/PluginCommandRequest.ts

@@ -1,9 +1,9 @@
 /**
- * PluginCommandRequest：统一 runtime plugin command 请求解析模块。
+ * PluginCommandRequest：统一 plugin runtime command 请求解析模块。
  *
  * 关键点（中文）
  * - 统一收口 HTTP / RPC 两种入口的请求体解析。
- * - runtime plugin 远程调用统一走 runtime command 协议，不再让 action 自带 HTTP route。
+ * - plugin runtime 远程调用统一走 runtime command 协议，不再让 action 自带 HTTP route。
  * - 通用调度参数（`schedule` / `delay` / `time`）也在这里一次性归一化。
  */
 
@@ -17,7 +17,7 @@ import {
 type JsonRecord = Record<string, unknown>;
 
 /**
- * 统一 runtime plugin command 请求体。
+ * 统一 plugin runtime command 请求体。
  */
 export type PluginCommandRequestBody = {
   /**
@@ -77,7 +77,7 @@ function readScheduleInput(
 }
 
 /**
- * 解析统一 runtime plugin command 请求体。
+ * 解析统一 plugin runtime command 请求体。
  */
 export function parsePluginCommandRequestBody(
   rawBody: JsonValue | undefined,

package/src/plugin/core/PluginStateController.ts

@@ -35,11 +35,11 @@ export function listPluginInstances(input?: {
   context?: AgentContext;
   runtime?: AgentRuntime;
 }): BasePlugin[] {
-  const contextPlugins = input?.context?.agent?.runtimePlugins;
+  const contextPlugins = input?.context?.agent?.pluginInstances;
   if (contextPlugins instanceof Map && contextPlugins.size > 0) {
     return [...contextPlugins.values()];
   }
-  const runtimePlugins = input?.runtime?.runtimePlugins;
+  const runtimePlugins = input?.runtime?.pluginInstances;
   if (runtimePlugins instanceof Map && runtimePlugins.size > 0) {
     return [...runtimePlugins.values()];
   }