@downcity/agent 1.1.5 → 1.1.7

package/bin/index.js

@@ -8,6 +8,7 @@
 // SDK 入口
 export { Agent } from "./host/sdk/Agent.js";
 export { RemoteAgent } from "./host/sdk/RemoteAgent.js";
+export { BaseService } from "./service/builtins/BaseService.js";
 export { ChatService } from "./service/builtins/chat/ChatService.js";
 export { ChatChannelAccountService } from "./service/builtins/chat/accounts/ChannelAccountService.js";
 // Agent 运行时
@@ -88,6 +89,12 @@ export { normalizeDefaultAgentName, listPlatformModelChoices, isAgentProjectInit
 export { readProjectExecutionBinding, readProjectPrimaryModelId, hasProjectExecutionTarget, assertProjectExecutionTarget, } from "./agent/project/ProjectExecutionBinding.js";
 export { listChatAuthorizationRoles, readChatAuthorizationConfigSync, setChatAuthorizationUserRole, } from "./plugins/auth/runtime/AuthorizationConfig.js";
 export { resolveAuthorizedUserRole } from "./plugins/auth/runtime/AuthorizationPolicy.js";
+export { authPlugin } from "./plugins/auth/Plugin.js";
+export { skillPlugin } from "./plugins/skill/Plugin.js";
+export { webPlugin } from "./plugins/web/Plugin.js";
+export { asrPlugin } from "./plugins/asr/Plugin.js";
+export { ttsPlugin } from "./plugins/tts/Plugin.js";
+export { workboardPlugin } from "./plugins/workboard/Plugin.js";
 // Agent 项目准备
 export { ensureRuntimeProjectReady, ensureRuntimeExecutionBindingReady, } from "./host/daemon/ProjectSetup.js";
 export { buildStaticPluginAvailability, findBuiltinPlugin, findStaticPluginView, listBuiltinPlugins, listStaticPluginViews, toStaticPluginView, } from "./plugin/Catalog.js";

package/bin/index.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@downcity/agent",
-  "version": "1.1.5",
+  "version": "1.1.7",
   "type": "module",
   "description": "Downcity Agent 运行时 — 执行壳，通过 RPC/HTTP 调用 City 的能力",
   "main": "./bin/index.js",

package/src/host/sdk/Agent.ts

@@ -2,9 +2,9 @@
  * Agent SDK 本地入口。
  *
  * 关键点（中文）
- * - `new Agent({ id, path, tools, services })` 只做同步装配，不在构造阶段启动任何 I/O。
+ * - `new Agent({ id, path, tools, services, plugins })` 只做同步装配，不在构造阶段启动任何 I/O。
  * - session、HTTP、RPC、service lifecycle 都按需异步初始化。
- * - SDK Agent 通过最小 `AgentContext` 适配层复用现有 service/chat runtime，而不是重复实现一套执行链。
+ * - SDK Agent 通过最小 `AgentContext` 适配层复用现有 service/plugin/chat 运行协议，而不是重复实现一套执行链。
  */
 
 import fs from "fs-extra";
@@ -16,6 +16,12 @@ import type { AgentContext } from "@/agent/AgentContextTypes.js";
 import type { AgentRuntime } from "@/agent/AgentRuntimeTypes.js";
 import type { DowncityConfig } from "@/shared/types/DowncityConfig.js";
 import type { JsonValue } from "@/shared/types/Json.js";
+import type {
+  Plugin,
+  PluginAvailability,
+  PluginPort,
+  PluginView,
+} from "@/shared/types/Plugin.js";
 import type {
   AgentOptions,
   AgentSessionMetadata,
@@ -25,11 +31,17 @@ import { loadStaticSystemPrompts } from "@session/composer/system/default/Static
 import { getSdkAgentSessionsRootDirPath } from "@/host/sdk/Paths.js";
 import { SdkAgentHttpServer } from "@/host/sdk/HttpServer.js";
 import { SdkAgentRpcServer } from "@/host/sdk/RpcServer.js";
-import { createAgentPathRuntime } from "@/host/runtime/AgentHostRuntime.js";
+import {
+  createAgentPathRuntime,
+  createAgentPluginConfigRuntime,
+} from "@/host/runtime/AgentHostRuntime.js";
 import { loadDowncityConfig } from "@/config/Config.js";
 import { appendExecSessionMessage } from "@/service/builtins/chat/runtime/ChatIngressStore.js";
 import { readChatMetaBySessionId } from "@/service/builtins/chat/runtime/ChatMetaStore.js";
 import { resolveChatQueueStore } from "@/service/builtins/chat/runtime/ChatQueueStore.js";
+import { HookRegistry } from "@/plugin/HookRegistry.js";
+import { PluginRegistry } from "@/plugin/PluginRegistry.js";
+import { isPluginEnabled } from "@/plugin/Activation.js";
 
 function createFallbackSdkConfig(agentId: string): DowncityConfig {
   return {
@@ -48,11 +60,14 @@ export class Agent {
   readonly http: SdkAgentHttpServer;
   readonly rpc: SdkAgentRpcServer;
   readonly services: Map<string, BaseService>;
+  readonly plugins: PluginPort;
 
   private readonly logger: Logger;
   private readonly sessionsById = new Map<string, SdkSession>();
   private readonly runtime: AgentRuntime;
   private readonly serviceContext: AgentContext;
+  private readonly pluginRegistry: PluginRegistry;
+  private readonly pluginSystemProviders: Plugin[];
   private readonly config: DowncityConfig;
   private systems: string[];
   private servicesStartPromise: Promise<void> | null = null;
@@ -79,6 +94,11 @@ export class Agent {
     for (const service of this.services.values()) {
       service.bindAgent(this.runtime);
     }
+    this.pluginSystemProviders = Array.isArray(options.plugins)
+      ? [...options.plugins]
+      : [];
+    this.pluginRegistry = this.createPluginRegistry(this.pluginSystemProviders);
+    this.plugins = this.createPluginPort();
     this.serviceContext = this.createServiceContext();
     this.http = new SdkAgentHttpServer(this);
     this.rpc = new SdkAgentRpcServer(this);
@@ -167,6 +187,84 @@ export class Agent {
     return services;
   }
 
+  private createPluginRegistry(input: Plugin[]): PluginRegistry {
+    let pluginRegistryRef: PluginRegistry | null = null;
+    const hookRegistry = new HookRegistry({
+      contextResolver: () => this.serviceContext,
+      pluginEnabledChecker: (pluginName) => {
+        const plugin = pluginRegistryRef?.get(pluginName);
+        return plugin ? isPluginEnabled({ plugin }) : false;
+      },
+    });
+    const registry = new PluginRegistry({
+      contextResolver: () => this.serviceContext,
+      hookRegistry,
+    });
+    pluginRegistryRef = registry;
+
+    for (const plugin of input) {
+      registry.register(plugin);
+    }
+    return registry;
+  }
+
+  private createPluginPort(): PluginPort {
+    return {
+      list: (): PluginView[] => this.pluginRegistry.list(),
+      availability: async (pluginName: string): Promise<PluginAvailability> =>
+        await this.pluginRegistry.availability(pluginName),
+      runAction: async (params) => await this.pluginRegistry.runAction(params),
+      pipeline: async <T>(pointName: string, value: T): Promise<T> =>
+        await this.pluginRegistry.pipeline(pointName, value),
+      guard: async <T>(pointName: string, value: T): Promise<void> => {
+        await this.pluginRegistry.guard(pointName, value);
+      },
+      effect: async <T>(pointName: string, value: T): Promise<void> => {
+        await this.pluginRegistry.effect(pointName, value);
+      },
+      resolve: async <TInput, TOutput>(
+        pointName: string,
+        value: TInput,
+      ): Promise<TOutput> =>
+        await this.pluginRegistry.resolve<TInput, TOutput>(pointName, value),
+    };
+  }
+
+  private async loadPluginSystemPrompts(): Promise<string[]> {
+    const out: string[] = [];
+    for (const plugin of this.pluginSystemProviders) {
+      if (typeof plugin.system !== "function") continue;
+      try {
+        if (!isPluginEnabled({ plugin })) continue;
+        if (typeof plugin.availability === "function") {
+          const availability = await plugin.availability(this.serviceContext);
+          if (!availability.available) continue;
+        }
+        const text = String(await plugin.system(this.serviceContext)).trim();
+        if (!text) continue;
+        out.push(text);
+      } catch {
+        // 单个 plugin system 失败不应阻断 SDK session 主链路。
+      }
+    }
+    return out;
+  }
+
+  private async loadServiceSystemPrompts(): Promise<string[]> {
+    const out: string[] = [];
+    for (const service of this.services.values()) {
+      if (typeof service.system !== "function") continue;
+      try {
+        const text = String(await service.system(this.serviceContext)).trim();
+        if (!text) continue;
+        out.push(text);
+      } catch {
+        // 单个 service system 失败不应阻断 SDK session 主链路。
+      }
+    }
+    return out;
+  }
+
   private createRuntime(): AgentRuntime {
     const runtime = {
       cwd: this.path,
@@ -177,11 +275,7 @@ export class Agent {
       globalEnv: {},
       systems: this.systems,
       paths: createAgentPathRuntime(this.path),
-      pluginConfig: {
-        async persistProjectPlugins(): Promise<string> {
-          return "";
-        },
-      },
+      pluginConfig: createAgentPluginConfigRuntime(this.path),
       model: undefined,
       getSession: (sessionId: string) => {
         return this.getOrCreateSession(sessionId).getServicePort() as never;
@@ -274,24 +368,7 @@ export class Agent {
         },
         enqueue: (params) => resolveChatQueueStore(context).enqueue(params),
       },
-      plugins: {
-        list: () => [],
-        availability: async () => ({
-          enabled: false,
-          available: false,
-          reasons: ["SDK Agent plugin runtime is not configured"],
-        }),
-        runAction: async () => ({
-          success: false,
-          error: "SDK Agent plugin runtime is not configured",
-        }),
-        pipeline: async <T>(_: string, value: T): Promise<T> => value,
-        guard: async (): Promise<void> => {},
-        effect: async (): Promise<void> => {},
-        resolve: async () => {
-          throw new Error("SDK Agent plugin resolve is not configured");
-        },
-      },
+      plugins: this.plugins,
     };
     return context;
   }
@@ -309,6 +386,8 @@ export class Agent {
       tools: this.tools,
       logger: this.logger,
       getStaticSystemPrompts: () => this.systems,
+      getServiceSystemPrompts: () => this.loadServiceSystemPrompts(),
+      getPluginSystemPrompts: () => this.loadPluginSystemPrompts(),
     });
     this.sessionsById.set(resolvedSessionId, created);
     return created;

package/src/host/sdk/AgentSdkTypes.ts

@@ -3,13 +3,14 @@
  *
  * 关键点（中文）
  * - 这里集中声明 `Agent` / `RemoteAgent` / `Session` 面向外部调用方的稳定接口。
- * - 不把内部 `AgentRuntime`、`AgentContext`、service/plugin 管理细节暴露给 SDK 用户。
- * - v1 先聚焦本地/远程 session 运行与基础落盘能力。
+ * - SDK 用户通过显式 `tools` / `services` / `plugins` 装配能力，不直接依赖内部 runtime 单例。
+ * - 本地/远程 session 运行与基础落盘能力仍是 SDK 主路径。
  */
 
 import type { LanguageModel, Tool } from "ai";
 import type { BaseService } from "@/service/builtins/BaseService.js";
 import type { JsonValue } from "@/shared/types/Json.js";
+import type { Plugin } from "@/shared/types/Plugin.js";
 import type { SessionMessageV1 } from "@/types/session/SessionMessages.js";
 
 /**
@@ -48,6 +49,16 @@ export interface AgentOptions {
    * - v1 推荐显式传入 `new ChatService(...)` 这类实例，而不是依赖包内隐式注册表。
    */
   services?: BaseService[];
+
+  /**
+   * 当前 agent 显式注册的 plugin 定义集合。
+   *
+   * 关键点（中文）
+   * - 这里接收完整 plugin 定义对象，而不是 plugin 名称。
+   * - `Agent` 会为当前 SDK 实例创建独立 plugin registry，避免污染全局 runtime。
+   * - 同名 plugin 会直接报错，避免 action / hook / resolve 行为被静默覆盖。
+   */
+  plugins?: Plugin[];
 }
 
 /**

package/src/host/sdk/SdkSessionSystemComposer.ts

@@ -3,8 +3,7 @@
  *
  * 关键点（中文）
  * - 面向 `Agent` SDK 的本地会话执行场景。
- * - v1 先只注入静态 PROFILE / SOUL / core prompt 与运行时时钟上下文。
- * - 暂不把 service/plugin system 注入暴露到 SDK 主路径。
+ * - 注入静态 PROFILE / SOUL / core prompt、显式注入 service system、显式注册 plugin system 与运行时时钟上下文。
  */
 
 import { SessionSystemComposer } from "@session/composer/system/SessionSystemComposer.js";
@@ -22,6 +21,16 @@ type SdkSessionSystemComposerOptions = {
    * 读取当前生效的静态 system 文本集合。
    */
   getStaticSystemPrompts: () => string[];
+
+  /**
+   * 读取当前显式注册 plugin 的 system 文本集合。
+   */
+  getPluginSystemPrompts: () => Promise<string[]>;
+
+  /**
+   * 读取当前显式注入 service 的 system 文本集合。
+   */
+  getServiceSystemPrompts: () => Promise<string[]>;
 };
 
 /**
@@ -32,11 +41,15 @@ export class SdkSessionSystemComposer extends SessionSystemComposer {
 
   private readonly projectRoot: string;
   private readonly getStaticSystemPrompts: SdkSessionSystemComposerOptions["getStaticSystemPrompts"];
+  private readonly getServiceSystemPrompts: SdkSessionSystemComposerOptions["getServiceSystemPrompts"];
+  private readonly getPluginSystemPrompts: SdkSessionSystemComposerOptions["getPluginSystemPrompts"];
 
   constructor(options: SdkSessionSystemComposerOptions) {
     super();
     this.projectRoot = String(options.projectRoot || "").trim();
     this.getStaticSystemPrompts = options.getStaticSystemPrompts;
+    this.getServiceSystemPrompts = options.getServiceSystemPrompts;
+    this.getPluginSystemPrompts = options.getPluginSystemPrompts;
     if (!this.projectRoot) {
       throw new Error("SdkSessionSystemComposer requires a non-empty projectRoot");
     }
@@ -61,9 +74,33 @@ export class SdkSessionSystemComposer extends SessionSystemComposer {
         variableMode: "stable",
       },
     );
+    const servicePrompts = (await this.getServiceSystemPrompts()).filter((item) =>
+      String(item || "").trim(),
+    );
+    const serviceMessages = await transformPromptsIntoSystemMessages(
+      servicePrompts,
+      {
+        projectPath: this.projectRoot,
+        sessionId,
+        variableMode: "stable",
+      },
+    );
+    const pluginPrompts = (await this.getPluginSystemPrompts()).filter((item) =>
+      String(item || "").trim(),
+    );
+    const pluginMessages = await transformPromptsIntoSystemMessages(
+      pluginPrompts,
+      {
+        projectPath: this.projectRoot,
+        sessionId,
+        variableMode: "stable",
+      },
+    );
 
     return [
       ...staticMessages,
+      ...serviceMessages,
+      ...pluginMessages,
       {
         role: "system" as const,
         content: buildRuntimeClockSystemPrompt({

package/src/host/sdk/Session.ts

@@ -73,6 +73,16 @@ type SdkSessionOptions = {
    * 读取静态 system 文本集合。
    */
   getStaticSystemPrompts: () => string[];
+
+  /**
+   * 读取当前 agent 显式注入 service 的 system 文本集合。
+   */
+  getServiceSystemPrompts: () => Promise<string[]>;
+
+  /**
+   * 读取当前 agent 显式注册 plugin 的 system 文本集合。
+   */
+  getPluginSystemPrompts: () => Promise<string[]>;
 };
 
 /**
@@ -86,6 +96,8 @@ export class SdkSession {
   private readonly tools: Record<string, Tool>;
   private readonly logger: SdkSessionOptions["logger"];
   private readonly getStaticSystemPrompts: SdkSessionOptions["getStaticSystemPrompts"];
+  private readonly getServiceSystemPrompts: SdkSessionOptions["getServiceSystemPrompts"];
+  private readonly getPluginSystemPrompts: SdkSessionOptions["getPluginSystemPrompts"];
   private readonly historyComposer: JsonlSessionHistoryComposer;
   private readonly coreSession: CoreSession;
   private sessionConfig: AgentSessionConfigSnapshot = {};
@@ -99,6 +111,8 @@ export class SdkSession {
     this.tools = options.tools;
     this.logger = options.logger;
     this.getStaticSystemPrompts = options.getStaticSystemPrompts;
+    this.getServiceSystemPrompts = options.getServiceSystemPrompts;
+    this.getPluginSystemPrompts = options.getPluginSystemPrompts;
     if (!this.id) {
       throw new Error("SdkSession requires a non-empty sessionId");
     }
@@ -149,6 +163,8 @@ export class SdkSession {
           systemComposer: new SdkSessionSystemComposer({
             projectRoot: this.projectRoot,
             getStaticSystemPrompts: this.getStaticSystemPrompts,
+            getServiceSystemPrompts: this.getServiceSystemPrompts,
+            getPluginSystemPrompts: this.getPluginSystemPrompts,
           }),
           getTools: () => this.tools,
         });
@@ -356,6 +372,8 @@ export class SdkSession {
       tools: this.tools,
       logger: this.logger,
       getStaticSystemPrompts: this.getStaticSystemPrompts,
+      getServiceSystemPrompts: this.getServiceSystemPrompts,
+      getPluginSystemPrompts: this.getPluginSystemPrompts,
     });
     await forked.initialize();
     if (this.sessionConfig.model) {

package/src/index.ts

@@ -20,6 +20,7 @@ export type {
   AgentSessionMetadata,
   AgentSessionForkInput,
 } from "./host/sdk/AgentSdkTypes.js";
+export { BaseService } from "./service/builtins/BaseService.js";
 export { ChatService } from "./service/builtins/chat/ChatService.js";
 export { ChatChannelAccountService } from "./service/builtins/chat/accounts/ChannelAccountService.js";
 export type { ChatChannelAccountListItem } from "./service/builtins/chat/types/ChannelAccount.js";
@@ -188,6 +189,12 @@ export {
   setChatAuthorizationUserRole,
 } from "./plugins/auth/runtime/AuthorizationConfig.js";
 export { resolveAuthorizedUserRole } from "./plugins/auth/runtime/AuthorizationPolicy.js";
+export { authPlugin } from "./plugins/auth/Plugin.js";
+export { skillPlugin } from "./plugins/skill/Plugin.js";
+export { webPlugin } from "./plugins/web/Plugin.js";
+export { asrPlugin } from "./plugins/asr/Plugin.js";
+export { ttsPlugin } from "./plugins/tts/Plugin.js";
+export { workboardPlugin } from "./plugins/workboard/Plugin.js";
 
 // Agent 项目准备
 export {