@downcity/agent 1.1.175 → 1.1.178

package/src/types/plugin/PluginState.ts

@@ -1,82 +1,89 @@
 /**
- * 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"
+  | "register"
+  | "unregister"
   | "status";
 
 /**
- * plugin 状态控制结果。
+ * plugin 控制结果。
  */
 export interface PluginStateControlResult {
   /** 控制动作是否成功。 */
   success: boolean;
   /** 成功或失败后返回的最新 plugin 快照。 */
-  plugin?: PluginStateSnapshot;
+  plugin?: PluginSnapshot;
   /** 失败时的错误信息。 */
   error?: string;
 }

package/src/types/runtime/agent/AgentContext.ts

@@ -16,7 +16,7 @@ import type {
 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,
@@ -249,7 +249,7 @@ export interface AgentContextOptions {
   /** 当前可见的 plugin 配置持久化能力集合。 */
   pluginConfig: AgentPluginConfigRuntime;
   /** 当前 agent 持有的插件实例集合。 */
-  pluginInstances: Map<string, BasePlugin>;
+  pluginInstances: Map<string, Plugin>;
   /** Session 能力入口。 */
   session: SessionCollectionPort;
   /** Plugin 调用入口。 */
@@ -282,7 +282,7 @@ export class AgentContext {
   /** 当前可见的 plugin 配置持久化能力集合。 */
   readonly pluginConfig: AgentPluginConfigRuntime;
   /** 当前 agent 持有的插件实例集合。 */
-  readonly pluginInstances: Map<string, BasePlugin>;
+  readonly pluginInstances: Map<string, Plugin>;
   /** Session 能力入口。 */
   readonly session: SessionCollectionPort;
   /** Plugin 调用入口。 */