@downcity/city 1.1.29 → 1.1.39

package/src/cli/shared/Plugins.ts

@@ -13,30 +13,31 @@ import type { Command } from "commander";
 import prompts from "prompts";
 import {
   buildStaticPluginAvailability,
-  findBuiltinPlugin,
-  findStaticPluginView,
-  listRegisteredPlugins,
-  listStaticPluginViews,
+  findPluginByName,
+  listPluginViews,
+  listPluginsWithLifecycle,
+  listPluginsWithoutLifecycle,
   runLocalPluginAction,
 } from "@downcity/agent";
+import { createBuiltinPlugins } from "@downcity/plugins";
 import { printResult } from "@/utils/cli/CliOutput.js";
 import type { JsonValue } from "@downcity/agent";
 import { getDowncityJsonPath } from "@/config/Paths.js";
 import type { PluginCliBaseOptions } from "@downcity/agent";
 import { emitCliBlock } from "./CliReporter.js";
 import { parseBoolean, parsePort } from "./IndexSupport.js";
-import { resolveProjectRoot } from "./PluginRuntimeSupport.js";
+import { resolveProjectRoot } from "./PluginTargetSupport.js";
 import {
-  runPluginRuntimeCommandBridge,
-  runPluginRuntimeControlCommand,
-} from "./PluginRuntimeRemote.js";
+  runManagedPluginCommandBridge,
+  runManagedPluginControlCommand,
+} from "./ManagedPluginRemote.js";
 import { registerPluginScheduleCommands } from "./PluginScheduleCommand.js";
 import { setCityPluginEnabled } from "@/platform/PluginLifecycle.js";
 
 type StaticCatalogEntry = {
   name: string;
   title: string;
-  kind: "runtime" | "extension";
+  kind: "managed" | "local";
   enabled: boolean;
   available: boolean;
   actionCount: number;
@@ -45,6 +46,10 @@ type StaticCatalogEntry = {
   note?: string;
 };
 
+function createPluginCatalog() {
+  return createBuiltinPlugins();
+}
+
 async function resolvePluginProjectRoot(options: PluginCliBaseOptions): Promise<{
   projectRoot?: string;
   error?: string;
@@ -79,6 +84,7 @@ function buildSafeStaticPluginAvailability(pluginName: string): {
 } {
   try {
     const availability = buildStaticPluginAvailability({
+      plugins: createPluginCatalog(),
       pluginName,
     });
     const normalizedReasons = availability.reasons.map((reason) => {
@@ -122,7 +128,7 @@ function truncateCell(input: string, width: number): string {
 function renderPluginCatalogTable(rows: Array<{
   name: string;
   title: string;
-  kind: "runtime" | "extension";
+  kind: "managed" | "local";
   enabled: boolean;
   available: boolean;
   actionCount: number;
@@ -166,24 +172,27 @@ function renderPluginCatalogTable(rows: Array<{
 }
 
 function listStaticCatalogEntries(): StaticCatalogEntry[] {
-  const runtimeEntries = listRegisteredPlugins().map((plugin) => ({
+  const plugins = createPluginCatalog();
+  const managedEntries = listPluginsWithLifecycle(plugins).map((plugin) => ({
     name: plugin.name,
-    title: `${plugin.name} runtime plugin`,
-    kind: "runtime" as const,
+    title: String(plugin.title || plugin.name || "").trim() || plugin.name,
+    kind: "managed" as const,
     enabled: true,
     available: true,
     actionCount: Object.keys(plugin.actions || {}).length,
     actions: Object.keys(plugin.actions || {}).sort((left, right) => left.localeCompare(right)),
     hasSystem: typeof plugin.system === "function",
-    note: "Runtime plugin. Use `city plugin start/stop/restart/status` with an agent target for live state.",
+    note: "Managed plugin. Use `city plugin start/stop/restart/status` with an agent target for live state.",
   }));
 
-  const extensionEntries = listStaticPluginViews().map((plugin) => {
+  const localPlugins = listPluginsWithoutLifecycle(plugins);
+  const localEntries = listPluginViews(localPlugins)
+    .map((plugin) => {
     const availability = buildSafeStaticPluginAvailability(plugin.name);
     return {
       name: plugin.name,
       title: plugin.title,
-      kind: "extension" as const,
+      kind: "local" as const,
       enabled: availability.enabled,
       available: availability.available,
       actionCount: plugin.actions.length,
@@ -193,7 +202,7 @@ function listStaticCatalogEntries(): StaticCatalogEntry[] {
     };
   });
 
-  const merged = [...runtimeEntries, ...extensionEntries];
+  const merged = [...managedEntries, ...localEntries];
   const unique = new Map<string, StaticCatalogEntry>();
   for (const entry of merged) {
     if (!unique.has(entry.name)) {
@@ -416,7 +425,7 @@ async function runPluginLifecycleCommand(params: {
   enabled: boolean;
   asJson?: boolean;
 }): Promise<void> {
-  const plugin = findBuiltinPlugin(params.pluginName);
+  const plugin = findPluginByName(createPluginCatalog(), params.pluginName);
   if (!plugin) {
     printResult({
       asJson: params.asJson === true,
@@ -552,6 +561,7 @@ async function runPluginActionCommand(params: {
 
   const payload = parseCommandPayload(params.payload);
   const local = await runLocalPluginAction({
+    plugins: createPluginCatalog(),
     projectRoot: resolved.projectRoot,
     pluginName: params.pluginName,
     actionName: params.actionName,
@@ -609,7 +619,7 @@ export function registerPluginsCommand(program: Command): void {
 
   plugin
     .command("status <pluginName>")
-    .description("按 agent 目标查看 runtime plugin 运行状态")
+    .description("按 agent 目标查看托管 plugin 运行状态")
     .option("--path <path>", "项目根目录（默认当前目录）", ".")
     .option("--agent <name>", "agent 名称（从 managed agent registry 解析）")
     .option("--host <host>", "Server host（覆盖自动解析）")
@@ -617,7 +627,7 @@ export function registerPluginsCommand(program: Command): void {
     .option("--token <token>", "覆盖 Bearer Token（仅远程 HTTP 调用需要；默认本地走 IPC）")
     .option("--json [enabled]", "以 JSON 输出", parseBoolean, true)
     .action(async (pluginName: string, opts: PluginCliBaseOptions) => {
-      await runPluginRuntimeControlCommand({
+      await runManagedPluginControlCommand({
         pluginName,
         action: "status",
         options: opts,
@@ -626,7 +636,7 @@ export function registerPluginsCommand(program: Command): void {
 
   plugin
     .command("start <pluginName>")
-    .description("按 agent 目标启动 runtime plugin")
+    .description("按 agent 目标启动托管 plugin")
     .option("--path <path>", "项目根目录（默认当前目录）", ".")
     .option("--agent <name>", "agent 名称（从 managed agent registry 解析）")
     .option("--host <host>", "Server host（覆盖自动解析）")
@@ -634,7 +644,7 @@ export function registerPluginsCommand(program: Command): void {
     .option("--token <token>", "覆盖 Bearer Token（仅远程 HTTP 调用需要；默认本地走 IPC）")
     .option("--json [enabled]", "以 JSON 输出", parseBoolean, true)
     .action(async (pluginName: string, opts: PluginCliBaseOptions) => {
-      await runPluginRuntimeControlCommand({
+      await runManagedPluginControlCommand({
         pluginName,
         action: "start",
         options: opts,
@@ -643,7 +653,7 @@ export function registerPluginsCommand(program: Command): void {
 
   plugin
     .command("stop <pluginName>")
-    .description("按 agent 目标停止 runtime plugin")
+    .description("按 agent 目标停止托管 plugin")
     .option("--path <path>", "项目根目录（默认当前目录）", ".")
     .option("--agent <name>", "agent 名称（从 managed agent registry 解析）")
     .option("--host <host>", "Server host（覆盖自动解析）")
@@ -651,7 +661,7 @@ export function registerPluginsCommand(program: Command): void {
     .option("--token <token>", "覆盖 Bearer Token（仅远程 HTTP 调用需要；默认本地走 IPC）")
     .option("--json [enabled]", "以 JSON 输出", parseBoolean, true)
     .action(async (pluginName: string, opts: PluginCliBaseOptions) => {
-      await runPluginRuntimeControlCommand({
+      await runManagedPluginControlCommand({
         pluginName,
         action: "stop",
         options: opts,
@@ -660,7 +670,7 @@ export function registerPluginsCommand(program: Command): void {
 
   plugin
     .command("restart <pluginName>")
-    .description("按 agent 目标重启 runtime plugin")
+    .description("按 agent 目标重启托管 plugin")
     .option("--path <path>", "项目根目录（默认当前目录）", ".")
     .option("--agent <name>", "agent 名称（从 managed agent registry 解析）")
     .option("--host <host>", "Server host（覆盖自动解析）")
@@ -668,7 +678,7 @@ export function registerPluginsCommand(program: Command): void {
     .option("--token <token>", "覆盖 Bearer Token（仅远程 HTTP 调用需要；默认本地走 IPC）")
     .option("--json [enabled]", "以 JSON 输出", parseBoolean, true)
     .action(async (pluginName: string, opts: PluginCliBaseOptions) => {
-      await runPluginRuntimeControlCommand({
+      await runManagedPluginControlCommand({
         pluginName,
         action: "restart",
         options: opts,
@@ -677,7 +687,7 @@ export function registerPluginsCommand(program: Command): void {
 
   plugin
     .command("command <pluginName> <command>")
-    .description("按 agent 目标转发 runtime plugin command")
+    .description("按 agent 目标转发托管 plugin command")
     .option("--payload <json>", "可选 payload（JSON 字符串或普通字符串）")
     .option("--path <path>", "项目根目录（默认当前目录）", ".")
     .option("--agent <name>", "agent 名称（从 managed agent registry 解析）")
@@ -690,7 +700,7 @@ export function registerPluginsCommand(program: Command): void {
       command: string,
       opts: PluginCliBaseOptions & { payload?: string },
     ) => {
-      await runPluginRuntimeCommandBridge({
+      await runManagedPluginCommandBridge({
         pluginName,
         command,
         payloadRaw: opts.payload,

package/src/cli/shared/PortHints.ts

@@ -23,7 +23,7 @@ export function buildRuntimePortFacts(): Array<{
     },
     {
       label: "Usage",
-      value: "Runtime API / plugin endpoints (health, runtime plugin, task, extension plugin)",
+      value: "Runtime API / plugin endpoints (health, plugin runtime, task, extension plugin)",
     },
   ];
 }

package/src/config/DowncitySchema.ts

@@ -120,11 +120,11 @@ export const DOWNCITY_JSON_SCHEMA: JsonObject = {
         },
       },
     },
-    services: {
+    plugins: {
       type: "object",
       additionalProperties: true,
       properties: {
-        skills: {
+        skill: {
           type: "object",
           additionalProperties: true,
           properties: {
@@ -187,12 +187,6 @@ export const DOWNCITY_JSON_SCHEMA: JsonObject = {
             },
           },
         },
-      },
-    },
-    plugins: {
-      type: "object",
-      additionalProperties: true,
-      properties: {
         asr: {
           type: "object",
           additionalProperties: true,

package/src/config/Paths.ts

@@ -111,7 +111,7 @@ export function getDowncityMemoryDailyPath(cwd: string, date: string): string {
 }
 
 /**
- * Service Schedule JSONL 路径。
+ * Plugin Schedule JSONL 路径。
  *
  * 关键点（中文）
  * - 调度任务属于项目 runtime 本地状态，因此放在项目 `.downcity/` 下。
@@ -226,7 +226,7 @@ export function getDowncityDebugDirPath(cwd: string): string {
 }
 
 /**
- * Chat 元信息目录（由 services/chat 维护）。
+ * Chat 元信息目录（由 chat plugin runtime 维护）。
  *
  * 关键点（中文）
  * - 该目录存放 `sessionId -> chat` 的最近映射快照

package/src/control/AgentStatusApiRoutes.ts

@@ -19,7 +19,7 @@ type AgentStatusPayload = {
   reason?: string;
 };
 
-type PluginRuntimeListResponse = {
+type PluginStateListResponse = {
   success?: boolean;
   plugins?: Array<{
     name?: unknown;
@@ -94,10 +94,10 @@ async function probeSelectedAgentStatus(
     };
   }
 
-  let pluginsPayload: PluginRuntimeListResponse;
+  let pluginsPayload: PluginStateListResponse;
   try {
-    pluginsPayload = await fetchStatusJson<PluginRuntimeListResponse>(
-      new URL("/api/plugins/runtime/list", baseUrl).toString(),
+    pluginsPayload = await fetchStatusJson<PluginStateListResponse>(
+      new URL("/api/plugins/list", baseUrl).toString(),
     );
   } catch (error) {
     return {
@@ -152,7 +152,7 @@ async function probeSelectedAgentStatus(
 
   try {
     await fetchStatusJson<ChatStatusResponse>(
-      new URL("/api/plugins/runtime/command", baseUrl).toString(),
+      new URL("/api/plugins/command", baseUrl).toString(),
       {
         method: "POST",
         headers: {

package/src/control/ChannelAccountApiRoutes.ts

@@ -7,19 +7,18 @@
  */
 
 import type { Hono } from "hono";
-import { ChatChannelAccountService } from "@downcity/agent";
-import { createAgentPlatformRuntime } from "@/process/registry/AgentHostRuntime.js";
+import { ChatChannelAccountManager } from "@downcity/plugins";
 
 /**
  * 注册 Channel Account API 路由。
  */
 export function registerPlatformChannelAccountRoutes(params: { app: Hono }): void {
   const app = params.app;
-  const service = new ChatChannelAccountService(createAgentPlatformRuntime());
+  const manager = new ChatChannelAccountManager();
 
   app.get("/api/ui/channel-accounts", async (c) => {
     try {
-      const payload = await service.list();
+      const payload = await manager.list();
       return c.json({
         success: true,
         ...payload,
@@ -47,7 +46,7 @@ export function registerPlatformChannelAccountRoutes(params: { app: Hono }): voi
         clearAppId?: boolean;
         clearAppSecret?: boolean;
       };
-      const payload = await service.upsert({
+      const payload = await manager.upsert({
         id: String(body.id || "").trim(),
         channel: String(body.channel || "").trim(),
         name: String(body.name || "").trim(),
@@ -82,7 +81,7 @@ export function registerPlatformChannelAccountRoutes(params: { app: Hono }): voi
         domain?: string;
         sandbox?: boolean;
       };
-      const payload = await service.probe({
+      const payload = await manager.probe({
         channel: String(body.channel || "").trim(),
         botToken: body.botToken,
         appId: body.appId,
@@ -108,7 +107,7 @@ export function registerPlatformChannelAccountRoutes(params: { app: Hono }): voi
       if (!id) {
         return c.json({ success: false, error: "Missing id" }, 400);
       }
-      await service.remove(id);
+      await manager.remove(id);
       return c.json({
         success: true,
         id,

package/src/control/ControlGateway.ts

@@ -40,6 +40,7 @@ import {
   buildPlatformUpstreamUrl,
   forwardPlatformRequest,
 } from "@/control/gateway/Proxy.js";
+import { listPluginAuthPolicies } from "@downcity/agent";
 import type {
   PlatformAgentOption,
   PlatformAgentsResponse,
@@ -49,7 +50,7 @@ import type {
   PlatformLocalModelsResponse,
 } from "@downcity/agent";
 import type { AgentProjectInitializationResult } from "@downcity/agent";
-import { listBuiltinPluginRuntimeAuthPolicies } from "@downcity/agent";
+import { createBuiltinPlugins } from "@downcity/plugins";
 import { AuthService } from "@/http/auth/AuthService.js";
 import { registerAuthRoutes } from "@/http/auth/AuthRoutes.js";
 import {
@@ -120,7 +121,7 @@ export class ControlGateway {
         this.authService,
         [
           ...CONTROL_PLANE_AUTH_ROUTE_POLICIES,
-          ...listBuiltinPluginRuntimeAuthPolicies(),
+          ...listPluginAuthPolicies(createBuiltinPlugins()),
         ],
       ),
     );

package/src/control/PluginApiRoutes.ts

@@ -9,15 +9,17 @@
 
 import type { Hono } from "hono";
 import {
-  findBuiltinPlugin,
-  listStaticPluginViews,
+  findPluginByName,
+  listPluginViews,
   runLocalPluginAction,
 } from "@downcity/agent";
+import { createBuiltinPlugins } from "@downcity/plugins";
 import type { PlatformAgentOption } from "@downcity/agent";
 import type {
   PluginActionResult,
   PluginAction,
   PluginAvailability,
+  Plugin,
   PluginSetupDefinition,
   PluginUsageDefinition,
   PluginView,
@@ -75,8 +77,12 @@ function getErrorMessage(error: unknown): string {
   return String(error);
 }
 
+function createPluginCatalog() {
+  return createBuiltinPlugins();
+}
+
 function buildPluginActionConfig(
-  plugin: ReturnType<typeof findBuiltinPlugin>,
+  plugin: Plugin | null,
 ): PluginActionConfigItem[] {
   if (!plugin) return [];
   const actions = (plugin.actions || {}) as Record<string, PluginAction>;
@@ -94,19 +100,19 @@ function buildPluginConfigMap(): Map<string, {
   setup?: PluginSetupDefinition;
   usage?: PluginUsageDefinition;
 }> {
+  const plugins = createPluginCatalog();
   return new Map(
-    listStaticPluginViews().map((view) => [
-      view.name,
-      {
-        actions: buildPluginActionConfig(findBuiltinPlugin(view.name)),
-        ...(findBuiltinPlugin(view.name)?.setup
-          ? { setup: findBuiltinPlugin(view.name)?.setup }
-          : {}),
-        ...(findBuiltinPlugin(view.name)?.usage
-          ? { usage: findBuiltinPlugin(view.name)?.usage }
-          : {}),
-      },
-    ] as const),
+    listPluginViews(plugins).map((view) => {
+      const plugin = findPluginByName(plugins, view.name);
+      return [
+        view.name,
+        {
+          actions: buildPluginActionConfig(plugin),
+          ...(plugin?.setup ? { setup: plugin.setup } : {}),
+          ...(plugin?.usage ? { usage: plugin.usage } : {}),
+        },
+      ] as const;
+    }),
   );
 }
 
@@ -114,16 +120,18 @@ function buildGlobalPluginConfigMap(): Map<string, {
   actions: PluginActionConfigItem[];
   setup?: PluginSetupDefinition;
 }> {
+  const plugins = createPluginCatalog();
   return new Map(
-    listStaticPluginViews().map((view) => [
-      view.name,
-      {
-        actions: buildPluginActionConfig(findBuiltinPlugin(view.name)),
-        ...(findBuiltinPlugin(view.name)?.setup
-          ? { setup: findBuiltinPlugin(view.name)?.setup }
-          : {}),
-      },
-    ] as const),
+    listPluginViews(plugins).map((view) => {
+      const plugin = findPluginByName(plugins, view.name);
+      return [
+        view.name,
+        {
+          actions: buildPluginActionConfig(plugin),
+          ...(plugin?.setup ? { setup: plugin.setup } : {}),
+        },
+      ] as const;
+    }),
   );
 }
 
@@ -132,7 +140,7 @@ function buildGlobalPluginPayload(): PluginUiResponse {
   return {
     success: true,
     runtimeConnected: false,
-    plugins: listStaticPluginViews().map((view) => ({
+    plugins: listPluginViews(createPluginCatalog()).map((view) => ({
       ...view,
       availability: {
         enabled: isCityPluginEnabled(view.name),
@@ -157,7 +165,7 @@ function buildAgentPluginPayload(params?: {
     success: true,
     runtimeConnected: params?.runtimeConnected === true,
     ...(reason ? { runtimeError: reason } : {}),
-    plugins: listStaticPluginViews().map((view) => ({
+    plugins: listPluginViews(createPluginCatalog()).map((view) => ({
       ...view,
       availability: {
         enabled: isCityPluginEnabled(view.name),
@@ -213,7 +221,7 @@ async function loadPluginViews(
   baseUrl: string,
   authHeaders?: RuntimeForwardAuthHeaders,
 ): Promise<PluginView[]> {
-  const listUrl = new URL("/api/plugins/list", baseUrl).toString();
+  const listUrl = new URL("/api/plugins/catalog", baseUrl).toString();
   const payload = await fetchJson<PluginListResponse>(listUrl, {
     headers: buildRuntimeRequestHeaders({ authHeaders }),
   });
@@ -221,7 +229,7 @@ async function loadPluginViews(
   return plugins.sort((a, b) => a.name.localeCompare(b.name));
 }
 
-async function loadRuntimePluginAvailability(
+async function loadAgentPluginAvailability(
   baseUrl: string,
   pluginName: string,
   authHeaders?: RuntimeForwardAuthHeaders,
@@ -245,7 +253,7 @@ async function loadRuntimePluginAvailability(
   return payload.availability;
 }
 
-async function buildRuntimePluginPayload(
+async function buildAgentPluginPayloadFromRuntime(
   selectedAgent: PlatformAgentOption,
   authHeaders?: RuntimeForwardAuthHeaders,
 ): Promise<PluginUiResponse> {
@@ -256,7 +264,7 @@ async function buildRuntimePluginPayload(
     pluginViews.map(async (view) => {
       return {
         ...view,
-        availability: await loadRuntimePluginAvailability(
+        availability: await loadAgentPluginAvailability(
           baseUrl,
           view.name,
           authHeaders,
@@ -282,7 +290,8 @@ async function runGlobalPluginAction(input: {
 }): Promise<PluginActionResult<JsonValue>> {
   const pluginName = String(input.pluginName || "").trim();
   const actionName = String(input.actionName || "").trim();
-  const plugin = findBuiltinPlugin(pluginName);
+  const plugins = createPluginCatalog();
+  const plugin = findPluginByName(plugins, pluginName);
   if (!plugin) {
     return {
       success: false,
@@ -320,6 +329,7 @@ async function runGlobalPluginAction(input: {
   }
 
   return runLocalPluginAction({
+    plugins,
     projectRoot,
     pluginName: plugin.name,
     actionName,
@@ -367,7 +377,7 @@ export function registerPlatformPluginRoutes(params: {
 
       try {
         return c.json(
-          await buildRuntimePluginPayload(
+          await buildAgentPluginPayloadFromRuntime(
             selectedAgent,
             readRuntimeForwardAuthHeaders(c.req.raw),
           ),

package/src/control/gateway/AgentActions.ts

@@ -18,7 +18,6 @@ import {
 } from "@/process/daemon/Manager.js";
 import { buildRunArgsFromOptions } from "@/process/daemon/CliArgs.js";
 import {
-  ensureRuntimeExecutionBindingReady,
   initializeAgentProject,
   isAgentProjectInitialized,
 } from "@downcity/agent";
@@ -33,7 +32,10 @@ import type { AgentProjectInitializationResult } from "@downcity/agent";
 import type {
   ExecutionBindingConfig,
 } from "@downcity/agent";
-import { createAgentPlatformRuntime } from "@/process/registry/AgentHostRuntime.js";
+import {
+  assertPlatformModelReady,
+  assertProjectExecutionModelReady,
+} from "@/model/runtime/ExecutionModelBinding.js";
 
 function resolveExecutionInput(params: {
   modelId?: unknown;
@@ -70,16 +72,17 @@ export async function initializePlatformAgentProject(params: {
   modelId?: unknown;
   forceOverwriteShipJson?: unknown;
 }): Promise<AgentProjectInitializationResult> {
+  const execution = resolveExecutionInput({
+    modelId: params.modelId,
+  });
+  assertPlatformModelReady(execution.modelId);
   return initializeAgentProject(
     {
       projectRoot: params.projectRoot,
       agentName: String(params.agentName || "").trim() || undefined,
-      execution: resolveExecutionInput({
-        modelId: params.modelId,
-      }),
+      execution,
       forceOverwriteShipJson: params.forceOverwriteShipJson === true,
     },
-    createAgentPlatformRuntime(),
   );
 }
 
@@ -103,6 +106,7 @@ export async function updatePlatformAgentExecution(params: {
   if (!modelId) {
     throw new Error("modelId is required");
   }
+  assertPlatformModelReady(modelId);
   ship.execution = {
     type: "api",
     modelId,
@@ -270,16 +274,17 @@ export async function startManagedAgentByProjectRoot(params: {
         `Project not ready: ${normalizedRoot}. Required files: PROFILE.md and downcity.json`,
       );
     }
+    const execution = resolveExecutionInput({
+      modelId: params.initialization?.modelId,
+    });
+    assertPlatformModelReady(execution.modelId);
     await initializeAgentProject(
       {
         projectRoot: normalizedRoot,
         agentName: String(params.initialization?.agentName || "").trim() || undefined,
-        execution: resolveExecutionInput({
-          modelId: params.initialization?.modelId,
-        }),
+        execution,
         forceOverwriteShipJson: params.initialization?.forceOverwriteShipJson === true,
       },
-      createAgentPlatformRuntime(),
     );
   } else {
     const profilePath = getProfileMdPath(normalizedRoot);
@@ -291,7 +296,7 @@ export async function startManagedAgentByProjectRoot(params: {
     }
   }
 
-  ensureRuntimeExecutionBindingReady(normalizedRoot, createAgentPlatformRuntime());
+  assertProjectExecutionModelReady(normalizedRoot);
   const args = await buildRunArgsFromOptions(normalizedRoot, {});
   const started = await startDaemonProcess({
     projectRoot: normalizedRoot,

package/src/control/gateway/AgentCatalog.ts

@@ -119,7 +119,7 @@ async function resolveAgentChatProfiles(params: {
   statusText?: string;
 }>> {
   try {
-    const upstreamUrl = new URL("/api/plugins/runtime/command", params.baseUrl).toString();
+    const upstreamUrl = new URL("/api/plugins/command", params.baseUrl).toString();
     const response = await fetch(upstreamUrl, {
       method: "POST",
       headers: {