@downcity/agent 1.1.32 → 1.1.35

package/src/plugin/core/schedule/Store.ts

@@ -1,5 +1,5 @@
 /**
- * Service Schedule 持久化存储。
+ * Plugin Schedule 持久化存储。
  *
  * 关键点（中文）
  * - 调度任务改为使用项目内 `jsonl` 事件流持久化，不再依赖 SQLite。
@@ -120,7 +120,7 @@ function compareJobs(a: ScheduledJobRecord, b: ScheduledJobRecord): number {
 }
 
 /**
- * Service Schedule Store。
+ * Plugin Schedule Store。
  */
 export class PluginScheduleStore {
   private readonly filePath: string;

package/src/plugin/core/schedule/Time.ts

@@ -1,5 +1,5 @@
 /**
- * Service Schedule 时间解析工具。
+ * Plugin Schedule 时间解析工具。
  *
  * 关键点（中文）
  * - 统一解析 `--delay` / `--time` 对应的调度时间。

package/src/plugin/types/Plugin.ts

@@ -137,7 +137,7 @@ export interface PluginStateControlResult {
  *
  * 关键点（中文）
  * - 这里表达的是“CLI 命令执行 plugin 时真正需要的最小上下文”。
- * - plugin 命令不应依赖 session、service invoke、agent runtime 等长期宿主对象。
+ * - plugin 命令不应依赖 session、plugin invoke、agent runtime 等长期宿主对象。
  * - agent runtime 在需要复用 action 时，直接传入自身更完整的 AgentContext 即可。
  */
 export interface PluginCommandContext {
@@ -180,13 +180,13 @@ export interface PluginCommandContext {
 }
 
 /**
- * Service 调用参数。
+ * Plugin action 调用参数。
  */
-export interface PluginServiceInvokeParams {
+export interface PluginActionInvokeParams {
   /**
-   * 目标 service 名称。
+   * 目标 plugin 名称。
    */
-  service: string;
+  plugin: string;
   /**
    * 目标 action 名称。
    */
@@ -198,9 +198,9 @@ export interface PluginServiceInvokeParams {
 }
 
 /**
- * Service 调用结果。
+ * Plugin action 调用结果。
  */
-export interface PluginServiceInvokeResult {
+export interface PluginActionInvokeResult {
   /**
    * 调用是否成功。
    */
@@ -216,15 +216,15 @@ export interface PluginServiceInvokeResult {
 }
 
 /**
- * Service 调用端口。
+ * Plugin action 调用端口。
  */
-export interface PluginServiceInvokePort {
+export interface PluginActionInvokePort {
   /**
-   * 调用指定 service action。
+   * 调用指定 plugin action。
    */
   invoke(
-    params: PluginServiceInvokeParams,
-  ): Promise<PluginServiceInvokeResult>;
+    params: PluginActionInvokeParams,
+  ): Promise<PluginActionInvokeResult>;
 }
 
 /**
@@ -267,7 +267,7 @@ export interface PluginCommandResult {
  * Plugin 生命周期兼容定义。
  *
  * 关键点（中文）
- * - 这是从旧 service lifecycle 过渡过来的兼容层。
+ * - 这是从旧运行生命周期过渡过来的兼容层。
  * - 新代码优先直接实现 `start/stop/command`。
  */
 export interface PluginLifecycle {
@@ -608,10 +608,6 @@ export interface PluginAction<
      * 当前插件名称。
      */
     pluginName: string;
-    /**
-     * 兼容旧 service action 参数名。
-     */
-    serviceName?: string;
     /**
      * 当前 Action 名称。
      */
@@ -816,13 +812,13 @@ export interface PluginUsageDefinition {
 }
 
 /**
- * Plugin runtime HTTP 注入参数。
+ * Plugin HTTP 注入参数。
  *
  * 关键点（中文）
  * - plugin 只声明自己的路由与鉴权策略，不感知 server 装配细节。
  * - console 会复用相同路径策略保护代理请求，但不会重复注册路由本身。
  */
-export interface PluginRuntimeHttpRegistration {
+export interface PluginHttpRegistration {
   /**
    * 该组路由对应的鉴权策略列表。
    */
@@ -851,9 +847,9 @@ export interface PluginRuntimeHttpRegistration {
  */
 export interface PluginHttpDefinition {
   /**
-   * runtime HTTP 路由注入（可选）。
+   * server HTTP 路由注入（可选）。
    */
-  runtime?: PluginRuntimeHttpRegistration;
+  server?: PluginHttpRegistration;
 }
 
 /**
@@ -909,7 +905,7 @@ export interface Plugin {
    */
   system?: (context: AgentContext) => string | Promise<string>;
   /**
-   * 旧 service lifecycle 兼容定义（可选）。
+   * 旧生命周期兼容定义（可选）。
    */
   lifecycle?: PluginLifecycle;
   /**

package/src/plugin/types/PluginApi.ts

@@ -1,5 +1,5 @@
 /**
- * plugin 管理命令与 API 类型。
+ * plugin catalog / availability / action API 类型。
  *
  * 关键点（中文）
  * - 统一描述 CLI -> daemon 的 plugin 管理协议。
@@ -73,9 +73,9 @@ export interface PluginAvailabilityView {
 }
 
 /**
- * plugin list 响应。
+ * plugin catalog 响应。
  */
-export interface PluginListResponse {
+export interface PluginCatalogResponse {
   /**
    * 请求是否成功。
    */

package/src/plugin/types/PluginState.ts

@@ -8,9 +8,4 @@ export type {
   PluginStateControlResult,
   PluginStateRecord,
   PluginStateSnapshot,
-  PluginState as ServiceState,
-  PluginStateControlAction as ServiceStateControlAction,
-  PluginStateControlResult as ServiceStateControlResult,
-  PluginStateRecord as ServiceStateRecord,
-  PluginStateSnapshot as ServiceStateSnapshot,
 } from "@/plugin/types/Plugin.js";

package/src/plugin/types/Plugins.ts

@@ -29,9 +29,9 @@ export type PluginStateView = {
 };
 
 /**
- * plugin 列表响应。
+ * plugin 状态列表响应。
  */
-export type PluginListResponse = {
+export type PluginStateListResponse = {
   success: boolean;
   plugins?: PluginStateView[];
   error?: string;

package/src/runtime/host/AgentHostRuntime.ts

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - agent runtime 负责创建这些宿主能力对象，再注入到 AgentRuntime。
- * - service / session / plugin 只消费这些对象，不直接依赖具体宿主实现。
+ * - plugin runtime / session / plugin 作者 API 只消费这些对象，不直接依赖具体宿主实现。
  * - 当前先收敛路径与 plugin 配置持久化两类宿主能力。
  */
 import {

package/src/runtime/host/daemon/Api.ts

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - 这里描述的是 CLI 与 agent daemon 之间的远程访问契约，不包含具体 HTTP 实现。
- * - service 等上层模块只依赖这些协议类型，不需要感知 city/daemon 的内部实现细节。
+ * - plugin runtime 等上层模块只依赖这些协议类型，不需要感知 city/daemon 的内部实现细节。
  * - 该文件属于 agent daemon 访问协议边界，而不是通用 HTTP 类型目录。
  */
 
@@ -40,7 +40,7 @@ export type DaemonJsonApiCallParams = {
    *
    * 说明（中文）
    * - 仅本地 IPC transport 当前会消费该参数。
-   * - 用于 `session execute`、`service command` 这类可能持续几十秒的请求，
+   * - 用于 `session execute`、`plugin command` 这类可能持续几十秒的请求，
    *   避免被默认短超时误判成“Agent server 未启动”。
    */
   timeoutMs?: number;

package/src/runtime/sandbox/types/SandboxRuntime.ts

@@ -4,7 +4,7 @@
  * 关键点（中文）
  * - 这里放的是 agent 执行层内部使用的最小 sandbox 运行时类型。
  * - 当前只围绕 `SandboxRunner` 设计，不引入复杂 provider / policy / binding 对象。
- * - 目标是让 `ShellService` 可以直接把命令交给 `SandboxRunner` 执行。
+ * - 目标是让 shell plugin runtime 可以直接把命令交给 `SandboxRunner` 执行。
  */
 
 import type { ChildProcessWithoutNullStreams } from "node:child_process";

package/src/runtime/server/http/Server.ts

@@ -16,9 +16,6 @@ import { finished } from "node:stream/promises";
 import { logger as serverLogger } from "@/utils/logger/Logger.js";
 import { createExecuteRouter } from "@/runtime/server/http/execute/execute.js";
 import { healthRouter } from "@/runtime/server/http/health/health.js";
-import {
-  createServicesRouter,
-} from "@/runtime/server/http/services/services.js";
 import { createPluginsRouter } from "@/runtime/server/http/plugins/plugins.js";
 import { createStaticRouter } from "@/runtime/server/http/static/static.js";
 import { createControlRouter } from "@/runtime/server/http/control/ControlRouter.js";
@@ -28,7 +25,7 @@ import {
 } from "@/plugin/core/HttpRoutes.js";
 import type { AgentRuntime } from "@/core/AgentCoreTypes.js";
 import type { AgentContext } from "@/core/AgentContextTypes.js";
-import type { AgentCore } from "@/core/AgentCore.js";
+import type { AgentSessionCollection } from "@/sdk/AgentSdkTypes.js";
 
 /**
  * Server 启动参数。
@@ -38,12 +35,12 @@ export interface ServerStartOptions {
   port: number;
   /** HTTP 服务监听主机。 */
   host: string;
-  /** 可选实例级 agent core。 */
-  core?: Pick<AgentCore, "getContext" | "getRuntime" | "session" | "sessions">;
-  /** 可选实例级 runtime 读取函数。 */
-  getAgentRuntime?: () => AgentRuntime;
-  /** 可选实例级 context 读取函数。 */
-  getAgentContext?: () => AgentContext;
+  /** 当前 agent runtime 读取函数。 */
+  getAgentRuntime: () => AgentRuntime;
+  /** 当前 agent context 读取函数。 */
+  getAgentContext: () => AgentContext;
+  /** 可选 SDK Session 集合绑定。 */
+  sessionCollection?: AgentSessionCollection;
 }
 
 /**
@@ -58,41 +55,16 @@ export interface ServerInstance {
   stop(): Promise<void>;
 }
 
-type AgentServerBindings = {
-  getAgentRuntime: () => AgentRuntime;
-  getAgentContext: () => AgentContext;
-};
-
-function resolveServerBindings(options: Pick<
-  ServerStartOptions,
-  "core" | "getAgentRuntime" | "getAgentContext"
->): AgentServerBindings {
-  const core = options.core;
-  if (core) {
-    return {
-      getAgentRuntime: () => core.getRuntime(),
-      getAgentContext: () => core.getContext(),
-    };
-  }
-  if (options.getAgentRuntime && options.getAgentContext) {
-    return {
-      getAgentRuntime: options.getAgentRuntime,
-      getAgentContext: options.getAgentContext,
-    };
-  }
-  throw new Error(
-    "createServerApp/startServer requires either core or both getAgentRuntime/getAgentContext",
-  );
-}
-
 /**
  * 创建主 Hono 应用。
  */
 export function createServerApp(
-  options: Pick<ServerStartOptions, "core" | "getAgentRuntime" | "getAgentContext">,
+  options: Pick<
+    ServerStartOptions,
+    "getAgentRuntime" | "getAgentContext" | "sessionCollection"
+  >,
 ): Hono {
   const app = new Hono();
-  const bindings = resolveServerBindings(options);
 
   app.use("*", logger());
   app.use(
@@ -106,29 +78,25 @@ export function createServerApp(
 
   // 关键点（中文）：按路由域挂载，server 模块只保留装配职责。
   app.route("/", createStaticRouter({
-    getAgentRuntime: bindings.getAgentRuntime,
+    getAgentRuntime: options.getAgentRuntime,
   }));
   app.route("/", healthRouter);
-  const servicesRouter = createServicesRouter({
-    getAgentContext: bindings.getAgentContext,
-  });
-  app.route("/", servicesRouter);
   app.route("/", createPluginsRouter({
-    getAgentContext: bindings.getAgentContext,
+    getAgentContext: options.getAgentContext,
   }));
   app.route("/", createExecuteRouter({
-    getAgentRuntime: bindings.getAgentRuntime,
+    getAgentRuntime: options.getAgentRuntime,
   }));
   app.route("/", createControlRouter({
-    getAgentRuntime: bindings.getAgentRuntime,
-    getAgentContext: bindings.getAgentContext,
+    getAgentRuntime: options.getAgentRuntime,
+    getAgentContext: options.getAgentContext,
   }));
-  if (options.core) {
-    app.route("/", createSdkRouter(options.core));
+  if (options.sessionCollection) {
+    app.route("/", createSdkRouter(options.sessionCollection));
   }
   registerBuiltinPluginHttpRoutes({
     app,
-    getContext: bindings.getAgentContext,
+    getContext: options.getAgentContext,
   });
 
   return app;

package/src/runtime/server/http/control/MessageTimeline.ts

@@ -16,7 +16,7 @@ import {
 import type {
   SessionMessageV1,
   SessionMetadataV1,
-} from "@/session/types/SessionMessages.js";
+} from "@/executor/types/SessionMessages.js";
 import { pickLastSuccessfulChatSendText } from "@/plugin/builtins/chat/runtime/UserVisibleText.js";
 import { extractToolCallsFromUiMessage } from "@/plugin/builtins/chat/runtime/UIMessageTransformer.js";
 import type { ControlTimelineEvent, ControlTimelineRole } from "@/runtime/server/http/control/types/ControlViewData.js";

package/src/runtime/server/http/control/OverviewRoutes.ts

@@ -2,7 +2,7 @@
  * Control 概览路由。
  *
  * 关键点（中文）
- * - 聚合 overview 与 runtime plugins 两块轻量只读接口。
+ * - 聚合 overview 与 plugin 运行态两块轻量只读接口。
  * - 只负责路由层拼装，不承载复杂业务状态机。
  */
 
@@ -85,7 +85,6 @@ export function registerControlOverviewRoutes(
             total: sessions.length,
             items: sessions,
           },
-          services: runtimePlugins,
           plugins: runtimePlugins,
           tasks: {
             total: tasks.length,
@@ -99,13 +98,10 @@ export function registerControlOverviewRoutes(
     });
   }
 
-  for (const routePath of buildControlRouteAliases("/services")) {
+  for (const routePath of buildControlRouteAliases("/plugins/list")) {
     app.get(routePath, (c) => {
       return c.json({
         success: true,
-        services: listPluginStates({
-          context: params.getAgentContext(),
-        }),
         plugins: listPluginStates({
           context: params.getAgentContext(),
         }),

package/src/runtime/server/http/control/SessionRoutes.ts

@@ -10,7 +10,7 @@
 import type { SystemModelMessage } from "ai";
 import fs from "fs-extra";
 import { dirname } from "path";
-import { resolveSessionSystemMessages } from "@session/composer/system/default/SystemDomain.js";
+import { resolveSessionSystemMessages } from "@executor/composer/system/default/SystemDomain.js";
 import {
   getDowncityChatHistoryPath,
   getDowncitySessionMessagesArchiveDirPath,

package/src/runtime/server/http/control/TaskRoutes.ts

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - 聚合 tasks/runs/logs 相关接口。
- * - 任务动作统一复用 task runtime plugin command，不在 UI 层重复实现业务语义。
+ * - 任务动作统一复用 task plugin runtime command，不在 UI 层重复实现业务语义。
  */
 
 import fs from "fs-extra";

package/src/runtime/server/http/plugins/plugins.ts

@@ -2,13 +2,20 @@
  * Plugin 路由模块。
  *
  * 职责说明：
- * 1. 提供 plugin 列表接口。
- * 2. 提供 plugin 可用性检查接口。
- * 3. 提供 plugin action 桥接接口。
+ * 1. 提供 plugin catalog / state / availability 接口。
+ * 2. 提供 plugin lifecycle 控制接口。
+ * 3. 提供 plugin command / action 桥接接口。
  */
 
 import { Hono } from "hono";
 import type { AgentContext } from "@/core/AgentContextTypes.js";
+import {
+  controlPluginState,
+  listPluginStates,
+} from "@/plugin/core/PluginStateController.js";
+import type { PluginStateControlAction } from "@/plugin/types/Plugin.js";
+import { parsePluginCommandRequestBody } from "@/plugin/core/PluginCommandRequest.js";
+import { runPluginCommand } from "@/plugin/core/PluginActionRunner.js";
 
 /**
  * Plugin 路由参数。
@@ -28,13 +35,73 @@ export function createPluginsRouter(
 ): Hono {
   const router = new Hono();
 
-  router.get("/api/plugins/list", (c) => {
+  router.get("/api/plugins/catalog", (c) => {
     return c.json({
       success: true,
       plugins: options.getAgentContext().plugins.list(),
     });
   });
 
+  router.get("/api/plugins/list", (c) => {
+    return c.json({
+      success: true,
+      plugins: listPluginStates({
+        context: options.getAgentContext(),
+      }),
+    });
+  });
+
+  router.post("/api/plugins/control", async (c) => {
+    const body = await c.req.json().catch(() => null);
+    const pluginName = String(body?.pluginName || "").trim();
+    const action = String(body?.action || "")
+      .trim()
+      .toLowerCase();
+
+    if (!pluginName) {
+      return c.json({ success: false, error: "pluginName is required" }, 400);
+    }
+    if (!action) {
+      return c.json({ success: false, error: "action is required" }, 400);
+    }
+    if (!["start", "stop", "restart", "status"].includes(action)) {
+      return c.json({ success: false, error: "invalid action" }, 400);
+    }
+
+    const result = await controlPluginState({
+      pluginName,
+      action: action as PluginStateControlAction,
+      context: options.getAgentContext(),
+    });
+    return c.json(result, result.success ? 200 : 400);
+  });
+
+  router.post("/api/plugins/command", async (c) => {
+    const body = await c.req.json().catch(() => null);
+    let requestBody;
+    try {
+      requestBody = parsePluginCommandRequestBody(body);
+    } catch (error) {
+      return c.json({ success: false, error: String(error) }, 400);
+    }
+
+    if (!requestBody.pluginName) {
+      return c.json({ success: false, error: "pluginName is required" }, 400);
+    }
+    if (!requestBody.command) {
+      return c.json({ success: false, error: "command is required" }, 400);
+    }
+
+    const result = await runPluginCommand({
+      pluginName: requestBody.pluginName,
+      command: requestBody.command,
+      payload: requestBody.payload,
+      schedule: requestBody.schedule,
+      context: options.getAgentContext(),
+    });
+    return c.json(result, result.success ? 200 : 400);
+  });
+
   router.post("/api/plugins/availability", async (c) => {
     const body = await c.req.json().catch(() => null);
     const pluginName = String(body?.pluginName || "").trim();

package/src/runtime/server/http/sdk/Router.ts

@@ -7,16 +7,16 @@
  */
 
 import { Hono } from "hono";
-import type { AgentCore } from "@/core/AgentCore.js";
+import type { AgentSessionCollection } from "@/sdk/AgentSdkTypes.js";
 import { registerSdkSessionRoutes } from "@/runtime/server/http/sdk/SessionRoutes.js";
 
 /**
  * 创建 SDK HTTP router。
  */
 export function createSdkRouter(
-  core: Pick<AgentCore, "session" | "sessions">,
+  sessionCollection: AgentSessionCollection,
 ): Hono {
   const router = new Hono();
-  registerSdkSessionRoutes(router, core);
+  registerSdkSessionRoutes(router, sessionCollection);
   return router;
 }