@downcity/agent 1.1.175 → 1.1.179

package/bin/types/plugin/PluginState.d.ts

@@ -1,68 +1,79 @@
 /**
- * Plugin 状态类型。
+ * Plugin 注册状态类型。
  *
  * 关键点（中文）
- * - 只描述 plugin 生命周期状态与控制结果。
- * - 不包含 command/action/hook 等执行协议，避免状态类型被运行时细节污染。
+ * - Plugin 只属于 Agent：注册即生效，卸载即不可见。
+ * - 不再暴露 start / stop / restart 这类生命周期状态。
+ * - `error` 只表示最近一次注册后运行发生错误，方便开发者诊断。
  */
+import type { Plugin } from "../../types/plugin/PluginDefinition.js";
 /**
- * Plugin 运行状态。
- *
- * 说明（中文）
- * - `starting` / `stopping` 仅用于生命周期过渡态。
- * - `error` 表示最近一次 lifecycle / command / action 执行失败后留下的状态标记。
+ * Plugin 当前可观察状态。
  */
-export type PluginState = "running" | "stopped" | "starting" | "stopping" | "error";
+export type PluginState = "ready" | "error";
 /**
- * 单个 plugin 实例内部持有的状态记录。
+ * 单个已注册 plugin 的运行时记录。
  */
-export interface PluginStateRecord {
-    /** 当前运行状态。 */
+export interface PluginRuntimeRecord {
+    /** 当前 plugin 实例。 */
+    plugin: Plugin;
+    /** 当前可观察状态。 */
     state: PluginState;
+    /** plugin 注册时间（毫秒时间戳）。 */
+    registered_at: number;
     /** 最近一次状态更新时间（毫秒时间戳）。 */
-    updatedAt: number;
+    updated_at: number;
     /** 最近一次错误信息。 */
-    lastError?: string;
-    /** 最近一次执行的命令名。 */
-    lastCommand?: string;
-    /** 最近一次执行命令的时间（毫秒时间戳）。 */
-    lastCommandAt?: number;
-    /** 当前串行控制链。 */
+    last_error?: string;
+    /** 当前串行变更链。 */
     chain: Promise<void>;
+    /** lifecycle.start 是否已经执行成功。 */
+    lifecycle_started: boolean;
 }
 /**
- * 单个 plugin 状态的对外快照。
+ * 单个 plugin 注册快照。
  */
-export interface PluginStateSnapshot {
+export interface PluginSnapshot {
     /** plugin 名称。 */
     name: string;
-    /** 当前运行状态。 */
+    /** plugin 标题。 */
+    title: string;
+    /** plugin 描述。 */
+    description: string;
+    /** 当前注册后的可用状态。 */
+    status: PluginState;
+    /** 兼容旧字段的状态别名。 */
     state: PluginState;
-    /** 最近一次状态更新时间（毫秒时间戳）。 */
+    /** 注册时间（毫秒时间戳）。 */
+    registered_at: number;
+    /** 最近更新时间（毫秒时间戳）。 */
+    updated_at: number;
+    /** 兼容旧字段的最近更新时间。 */
     updatedAt: number;
-    /** 最近一次错误信息。 */
+    /** 最近错误。 */
+    last_error?: string;
+    /** 兼容旧字段的最近错误。 */
     lastError?: string;
-    /** 最近一次执行的命令名。 */
-    lastCommand?: string;
-    /** 最近一次执行命令的时间（毫秒时间戳）。 */
-    lastCommandAt?: number;
-    /** 是否支持主动生命周期。 */
-    supportsLifecycle: boolean;
-    /** 是否支持 command/action。 */
-    supportsCommand: boolean;
 }
 /**
- * plugin 状态控制动作。
+ * 兼容旧名称的 plugin 快照类型。
+ */
+export type PluginStateSnapshot = PluginSnapshot;
+/**
+ * 兼容旧控制动作类型。
+ *
+ * 说明（中文）
+ * - 控制面只保留状态查询与卸载。
  */
-export type PluginStateControlAction = "start" | "stop" | "restart" | "status";
+export type PluginStateControlAction = "register" | "unregister" | "status";
 /**
- * plugin 状态控制结果。
+ * plugin 控制结果。
  */
 export interface PluginStateControlResult {
     /** 控制动作是否成功。 */
     success: boolean;
     /** 成功或失败后返回的最新 plugin 快照。 */
-    plugin?: PluginStateSnapshot;
+    plugin?: PluginSnapshot;
     /** 失败时的错误信息。 */
     error?: string;
 }

package/bin/types/plugin/PluginState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PluginState.d.ts","sourceRoot":"","sources":["../../../src/types/plugin/PluginState.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GACnB,SAAS,GACT,SAAS,GACT,UAAU,GACV,UAAU,GACV,OAAO,CAAC;AAEZ;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,cAAc;IACd,KAAK,EAAE,WAAW,CAAC;IACnB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe;IACf,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc;IACd,KAAK,EAAE,WAAW,CAAC;IACnB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB;IAClB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,2BAA2B;IAC3B,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAChC,OAAO,GACP,MAAM,GACN,SAAS,GACT,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,gBAAgB;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,gBAAgB;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"PluginState.d.ts","sourceRoot":"","sources":["../../../src/types/plugin/PluginState.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,OAAO,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe;IACf,KAAK,EAAE,WAAW,CAAC;IACnB,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe;IACf,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,gCAAgC;IAChC,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,kBAAkB;IAClB,KAAK,EAAE,WAAW,CAAC;IACnB,mBAAmB;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,cAAc,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,MAAM,wBAAwB,GAChC,UAAU,GACV,YAAY,GACZ,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,gBAAgB;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,gBAAgB;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/bin/types/plugin/PluginState.js

@@ -1,9 +1,10 @@
 /**
- * Plugin 状态类型。
+ * Plugin 注册状态类型。
  *
  * 关键点（中文）
- * - 只描述 plugin 生命周期状态与控制结果。
- * - 不包含 command/action/hook 等执行协议，避免状态类型被运行时细节污染。
+ * - Plugin 只属于 Agent：注册即生效，卸载即不可见。
+ * - 不再暴露 start / stop / restart 这类生命周期状态。
+ * - `error` 只表示最近一次注册后运行发生错误，方便开发者诊断。
  */
 export {};
 //# sourceMappingURL=PluginState.js.map

package/bin/types/plugin/PluginState.js.map

@@ -1 +1 @@
-{"version":3,"file":"PluginState.js","sourceRoot":"","sources":["../../../src/types/plugin/PluginState.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}
+{"version":3,"file":"PluginState.js","sourceRoot":"","sources":["../../../src/types/plugin/PluginState.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/bin/types/runtime/agent/AgentContext.d.ts

@@ -12,7 +12,7 @@ import type { AgentPathRuntime, AgentPluginConfigRuntime } from "../../../types/
 import type { DowncityConfig } from "../../../types/config/DowncityConfig.js";
 import type { JsonValue } from "../../../types/common/Json.js";
 import type { AgentPlugins } from "../../../plugin/types/Plugin.js";
-import type { BasePlugin } from "../../../plugin/core/BasePlugin.js";
+import type { Plugin } from "../../../types/plugin/PluginDefinition.js";
 import type { SessionMetadataV1, SessionMessageV1 } from "../../../executor/types/SessionMessages.js";
 import type { SessionRunInput, SessionRunResult } from "../../../executor/types/SessionRun.js";
 import type { SessionHistoryStore } from "../../../executor/store/history/SessionHistoryStore.js";
@@ -227,7 +227,7 @@ export interface AgentContextOptions {
     /** 当前可见的 plugin 配置持久化能力集合。 */
     pluginConfig: AgentPluginConfigRuntime;
     /** 当前 agent 持有的插件实例集合。 */
-    pluginInstances: Map<string, BasePlugin>;
+    pluginInstances: Map<string, Plugin>;
     /** Session 能力入口。 */
     session: SessionCollectionPort;
     /** Plugin 调用入口。 */
@@ -259,7 +259,7 @@ export declare class AgentContext {
     /** 当前可见的 plugin 配置持久化能力集合。 */
     readonly pluginConfig: AgentPluginConfigRuntime;
     /** 当前 agent 持有的插件实例集合。 */
-    readonly pluginInstances: Map<string, BasePlugin>;
+    readonly pluginInstances: Map<string, Plugin>;
     /** Session 能力入口。 */
     readonly session: SessionCollectionPort;
     /** Plugin 调用入口。 */

package/bin/types/runtime/agent/AgentContext.d.ts.map

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

package/bin/types/runtime/agent/AgentContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"AgentContext.js","sourceRoot":"","sources":["../../../../src/types/runtime/agent/AgentContext.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA2PH;;;;;;;GAOG;AACH,MAAM,OAAO,YAAY;IACvB,gBAAgB;IACP,GAAG,CAAS;IACrB,eAAe;IACN,QAAQ,CAAS;IAC1B,aAAa;IACJ,MAAM,CAAS;IACxB,kBAAkB;IACT,MAAM,CAAiB;IAChC,oBAAoB;IACX,GAAG,CAAyB;IACrC,yBAAyB;IAChB,OAAO,CAAW;IAC3B,mBAAmB;IACV,KAAK,CAAmB;IACjC,8BAA8B;IACrB,YAAY,CAA2B;IAChD,0BAA0B;IACjB,eAAe,CAA0B;IAClD,oBAAoB;IACX,OAAO,CAAwB;IACxC,mBAAmB;IACV,OAAO,CAAe;IAC/B,8BAA8B;IACrB,MAAM,CAAmB;IAElC,YAAY,OAA4B;QACtC,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QACzC,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;QAC/C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG;YACZ,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC;SACtD,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,UAAU,CAAC,SAAiB;QAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,uBAAuB;QACrB,OAAO,IAAI,CAAC,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,wBAAwB;QACtB,OAAO,IAAI,CAAC,OAAO,CAAC,wBAAwB,EAAE,CAAC;IACjD,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,oBAAoB,CAChC,MAA0B;QAE1B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;YAC1C,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrE,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,OAAO,IAAI,sBAAsB;aAChE,CAAC;QACJ,CAAC;QACD,OAAO;YACL,OAAO,EAAE,IAAI;YACb,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5D,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"AgentContext.js","sourceRoot":"","sources":["../../../../src/types/runtime/agent/AgentContext.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA2PH;;;;;;;GAOG;AACH,MAAM,OAAO,YAAY;IACvB,gBAAgB;IACP,GAAG,CAAS;IACrB,eAAe;IACN,QAAQ,CAAS;IAC1B,aAAa;IACJ,MAAM,CAAS;IACxB,kBAAkB;IACT,MAAM,CAAiB;IAChC,oBAAoB;IACX,GAAG,CAAyB;IACrC,yBAAyB;IAChB,OAAO,CAAW;IAC3B,mBAAmB;IACV,KAAK,CAAmB;IACjC,8BAA8B;IACrB,YAAY,CAA2B;IAChD,0BAA0B;IACjB,eAAe,CAAsB;IAC9C,oBAAoB;IACX,OAAO,CAAwB;IACxC,mBAAmB;IACV,OAAO,CAAe;IAC/B,8BAA8B;IACrB,MAAM,CAAmB;IAElC,YAAY,OAA4B;QACtC,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QACzC,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;QAC/C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG;YACZ,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC;SACtD,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,UAAU,CAAC,SAAiB;QAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,uBAAuB;QACrB,OAAO,IAAI,CAAC,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,wBAAwB;QACtB,OAAO,IAAI,CAAC,OAAO,CAAC,wBAAwB,EAAE,CAAC;IACjD,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,oBAAoB,CAChC,MAA0B;QAE1B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;YAC1C,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrE,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,OAAO,IAAI,sBAAsB;aAChE,CAAC;QACJ,CAAC;QACD,OAAO;YACL,OAAO,EAAE,IAAI;YACb,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5D,CAAC;IACJ,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@downcity/agent",
-  "version": "1.1.175",
+  "version": "1.1.179",
   "type": "module",
   "description": "Downcity Agent 运行时 — 单 Agent 执行壳与本机 RPC 能力",
   "main": "./bin/index.js",
@@ -17,8 +17,8 @@
   },
   "dependencies": {
     "@ai-sdk/openai-compatible": "^2.0.48",
-    "@downcity/shell": "^0.1.47",
-    "@downcity/type": "0.1.81",
+    "@downcity/shell": "^0.1.51",
+    "@downcity/type": "0.1.85",
     "ai": "^6.0.193",
     "commander": "^15.0.0",
     "dotenv": "^17.4.2",

package/src/agent/local/AgentPluginFactory.ts

@@ -6,18 +6,19 @@
  * - Agent 仍然持有长期状态；这里不创建新的运行时层级。
  */
 
-import type { BasePlugin } from "@/plugin/core/BasePlugin.js";
+import type { Plugin } from "@/types/plugin/PluginDefinition.js";
 import type { AgentContext } from "@/types/runtime/agent/AgentContext.js";
 import { HookRegistry } from "@/plugin/core/HookRegistry.js";
 import { PluginRegistry } from "@/plugin/core/PluginRegistry.js";
-import { isPluginEnabled } from "@/plugin/core/Activation.js";
 
 /**
  * 创建 plugin registry 的参数。
  */
 export interface CreateAgentPluginRegistryOptions {
   /** 当前 agent 显式注册的 plugin 实例。 */
-  plugins: BasePlugin[];
+  plugins: Plugin[];
+  /** 当前 agent plugin 实例集合。 */
+  plugin_instances: Map<string, Plugin>;
   /** 延迟读取当前 AgentContext。 */
   get_context: () => AgentContext;
 }
@@ -32,20 +33,19 @@ export function createAgentPluginRegistry(
   const hook_registry = new HookRegistry({
     contextResolver: options.get_context,
     pluginEnabledChecker: (plugin_name) => {
-      const plugin = plugin_registry_ref?.get(plugin_name);
-      return plugin
-        ? isPluginEnabled({ plugin, context: options.get_context() })
-        : false;
+      void options;
+      return plugin_registry_ref?.isReady(plugin_name) || false;
     },
   });
   const registry = new PluginRegistry({
     contextResolver: options.get_context,
     hookRegistry: hook_registry,
+    pluginInstances: options.plugin_instances,
   });
   plugin_registry_ref = registry;
 
   for (const plugin of options.plugins) {
-    registry.register(plugin);
+    registry.mount(plugin);
   }
   return registry;
 }

package/src/agent/local/AgentRuntimeAssembly.ts

@@ -5,6 +5,7 @@
  * - agent runtime 负责创建这些宿主能力对象，再注入到 AgentRuntime。
  * - plugin runtime / session / plugin 作者 API 只消费这些对象，不直接依赖具体宿主实现。
  * - 当前先收敛路径与 plugin 配置持久化两类宿主能力。
+ * - SDK 默认不把 plugin 配置写回项目文件；宿主如 CLI 可接管持久化。
  */
 import {
   getCacheDirPath,
@@ -18,12 +19,10 @@ import {
   getDowncitySessionDirPath,
   getDowncitySessionRootDirPath,
 } from "@/config/Paths.js";
-import { persistProjectPluginConfig } from "@/plugin/core/ProjectConfigStore.js";
 import type {
   AgentPathRuntime,
   AgentPluginConfigRuntime,
 } from "@/types/agent/AgentRuntimeAssembly.js";
-import type { DowncityConfig } from "@/types/config/DowncityConfig.js";
 
 /**
  * 创建当前项目的路径能力集合。
@@ -57,13 +56,8 @@ export function createAgentPathRuntime(
 export function createAgentPluginConfigRuntime(projectRoot: string): AgentPluginConfigRuntime {
   const rootPath = String(projectRoot || "").trim();
   return {
-    async persistProjectPlugins(plugins: DowncityConfig["plugins"] | undefined): Promise<string> {
-      return persistProjectPluginConfig({
-        projectRoot: rootPath,
-        sections: {
-          ...(plugins !== undefined ? { plugins } : {}),
-        },
-      });
+    async persistProjectPlugins(): Promise<string> {
+      return rootPath;
     },
   };
 }

package/src/agent/local/ProjectSetup.ts

@@ -2,7 +2,7 @@
  * ProjectSetup：本地 Agent 启动前项目结构准备模块。
  *
  * 关键点（中文）
- * - 统一校验初始化必要文件（PROFILE.md / downcity.json）。
+ * - 统一校验初始化必要文件（PROFILE.md）。
  * - 统一确保 `.downcity/*` 目录结构存在，避免调用方重复拼装目录逻辑。
  */
 
@@ -17,7 +17,6 @@ import {
   getDowncityDataDirPath,
   getDowncityDebugDirPath,
   getDowncityDirPath,
-  getDowncityJsonPath,
   getDowncityProfileDirPath,
   getDowncityPublicDirPath,
   getDowncityTasksDirPath,
@@ -35,12 +34,6 @@ function ensureContextFiles(projectRoot: string): void {
     process.exit(1);
   }
 
-  if (!fs.existsSync(getDowncityJsonPath(projectRoot))) {
-    console.error(
-      '❌ downcity.json does not exist. Please run "downcity agent create" first',
-    );
-    process.exit(1);
-  }
 }
 
 /**

package/src/agent/local/services/AgentAssemblyService.ts

@@ -8,7 +8,7 @@
  */
 
 import type { LanguageModel, Tool } from "ai";
-import type { BasePlugin } from "@/plugin/core/BasePlugin.js";
+import type { Plugin } from "@/types/plugin/PluginDefinition.js";
 import { AgentContext } from "@/types/runtime/agent/AgentContext.js";
 import type { DowncityConfig } from "@/types/config/DowncityConfig.js";
 import type { AgentPlugins } from "@/plugin/types/Plugin.js";
@@ -101,7 +101,7 @@ export interface AgentAssemblyResult {
   /**
    * 当前 plugin 实例集合。
    */
-  plugin_instances: Map<string, BasePlugin>;
+  plugin_instances: Map<string, Plugin>;
 
   /**
    * 当前 plugin 注册表。
@@ -165,16 +165,15 @@ export class AgentAssemblyService {
     const env = resolveAgentEnv(path, this.options.env);
     const instruction = normalizeInstructionInput(this.options.instruction);
     const config = this.load_config(id, path);
-    const plugin_instances = new Map<string, BasePlugin>();
-
-    this.register_plugins(plugin_instances, this.options.plugins || []);
+    const plugin_instances = new Map<string, Plugin>();
 
     // 关键点（中文）
     // - plugin_registry 仍然延迟读取 agent_context（避免循环依赖）。
     // - context 一构造完就赋值，registry 第一次读 get_context 时已经是非空。
     let agent_context: AgentContext | undefined;
     const plugin_registry = createAgentPluginRegistry({
-      plugins: [...plugin_instances.values()],
+      plugins: this.options.plugins || [],
+      plugin_instances,
       get_context: () => {
         if (!agent_context) {
           throw new Error("AgentContext is not assembled yet");
@@ -248,6 +247,13 @@ export class AgentAssemblyService {
   }
 
   private load_config(agent_id: string, project_root: string): DowncityConfig {
+    if (this.options.config) {
+      return {
+        ...this.options.config,
+        id: String(this.options.config.id || "").trim() || agent_id,
+        version: String(this.options.config.version || "").trim() || "1.0.0",
+      };
+    }
     try {
       return loadDowncityConfig(project_root);
     } catch {
@@ -255,27 +261,11 @@ export class AgentAssemblyService {
     }
   }
 
-  private register_plugins(
-    plugin_instances: Map<string, BasePlugin>,
-    plugins: BasePlugin[],
-  ): void {
-    for (const plugin of plugins) {
-      const name = String(plugin?.name || "").trim();
-      if (!name) {
-        throw new Error("Agent received a plugin without a valid name");
-      }
-      if (plugin_instances.has(name)) {
-        throw new Error(`Duplicate plugin registration: ${name}`);
-      }
-      plugin_instances.set(name, plugin);
-    }
-  }
-
   /**
    * 判断是否需要自动注册 plugin_call tool。
    */
   private should_register_plugin_call_tool(
-    plugin_instances: Map<string, BasePlugin>,
+    plugin_instances: Map<string, Plugin>,
   ): boolean {
     for (const plugin of plugin_instances.values()) {
       if (

package/src/agent/local/services/AgentBackgroundService.ts

@@ -11,7 +11,6 @@ import type { AgentContext } from "@/types/runtime/agent/AgentContext.js";
 import type { Logger } from "@/utils/logger/Logger.js";
 import type { ActionScheduleRuntimeHandle } from "@/plugin/core/ActionScheduleRuntime.js";
 import { startActionScheduleRuntime } from "@/plugin/core/ActionScheduleRuntime.js";
-import { startAllPlugins, stopAllPlugins } from "@/plugin/core/Manager.js";
 import type { Shell } from "@downcity/shell";
 
 type AgentBackgroundServiceOptions = {
@@ -73,7 +72,7 @@ export class AgentBackgroundService {
     }
     if (this.plugins_started) {
       await this.stop_action_schedule_runtime();
-      await stopAllPlugins(this.agent_context);
+      await this.agent_context.plugins.unregisterAll();
       this.plugins_started = false;
     }
     await this.get_shell?.()?.dispose();
@@ -85,12 +84,12 @@ export class AgentBackgroundService {
 
   private async ensure_plugins_started(): Promise<void> {
     if (this.plugins_started) return;
-    const lifecycle = await startAllPlugins(this.agent_context);
+    const snapshots = await this.agent_context.plugins.startAll();
     this.plugins_started = true;
-    for (const item of lifecycle.results) {
-      if (!item.success) {
+    for (const item of snapshots) {
+      if (item.status === "error") {
         this.logger.error(
-          `Plugin start failed: ${item.plugin?.name || "unknown"} - ${item.error || "unknown error"}`,
+          `Plugin start failed: ${item.name} - ${item.last_error || "unknown error"}`,
         );
       }
     }

package/src/agent/local/services/AgentSessionManager.ts

@@ -37,8 +37,7 @@ import {
 } from "@/session/index.js";
 import type { AgentContext } from "@/types/runtime/agent/AgentContext.js";
 import type { SessionPort } from "@/types/runtime/agent/AgentContext.js";
-import type { BasePlugin } from "@/plugin/core/BasePlugin.js";
-import { isPluginEnabled } from "@/plugin/core/Activation.js";
+import type { Plugin } from "@/types/plugin/PluginDefinition.js";
 import { createInstructionSystemBlocks } from "@/agent/local/AgentInstructions.js";
 
 function decodeMaybe(input: string): string {
@@ -86,7 +85,7 @@ type AgentSessionManagerOptions = {
   /**
    * 当前 plugin 实例集合。
    */
-  plugin_instances: Map<string, BasePlugin>;
+  plugin_instances: Map<string, Plugin>;
 
   /**
    * 当前默认模型实例。
@@ -109,7 +108,7 @@ export class AgentSessionManager {
   private readonly logger: Logger;
   private readonly get_agent_context: AgentSessionManagerOptions["get_agent_context"];
   private readonly get_instruction: AgentSessionManagerOptions["get_instruction"];
-  private readonly plugin_instances: Map<string, BasePlugin>;
+  private readonly plugin_instances: Map<string, Plugin>;
   private readonly default_model?: AgentModel;
   private readonly SessionClass: AgentSessionConstructor;
   private readonly sessions_by_id = new Map<string, AgentManagedSession>();
@@ -378,27 +377,6 @@ export class AgentSessionManager {
   }
 
   private async load_plugin_system_blocks(): Promise<AgentSessionSystemBlock[]> {
-    const context = this.get_agent_context();
-    const out: AgentSessionSystemBlock[] = [];
-    for (const plugin of this.plugin_instances.values()) {
-      if (typeof plugin.system !== "function") continue;
-      try {
-        if (!isPluginEnabled({ plugin, context })) continue;
-        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 失败不应阻断 SDK session 主链路。
-      }
-    }
-    return out;
+    return await this.get_agent_context().plugins.systemBlocks();
   }
 }