@downcity/agent 1.1.35 → 1.1.43

package/bin/plugin/core/ActionScheduleTime.d.ts

@@ -0,0 +1,32 @@
+/**
+ * ActionSchedule 时间解析工具。
+ *
+ * 关键点（中文）
+ * - 统一解析 plugin action 通用 `--delay` / `--time` 参数。
+ * - 输出统一毫秒时间戳，供 command 请求解析与持久化层复用。
+ * - 该模块只处理“action 延迟执行时间”，不表达独立 schedule plugin。
+ */
+/**
+ * 解析绝对执行时间。
+ *
+ * 支持格式（中文）
+ * - Unix 时间戳秒/毫秒
+ * - ISO 时间字符串（必须显式带时区）
+ */
+export declare function parseScheduleTimeOptionOrThrow(value: string, fieldName: string): number;
+/**
+ * 解析 command 层调度输入并归一化为绝对毫秒时间戳。
+ *
+ * 说明（中文）
+ * - `delayMs` 与 `time` 只能二选一。
+ * - 未传时返回 `undefined`，表示立即执行。
+ */
+export declare function parseActionScheduleRunAtMsOrThrow(params: {
+    delay?: string | number | undefined;
+    time?: string | number | undefined;
+}): number | undefined;
+/**
+ * 规范化 API/存储层传入的 runAtMs。
+ */
+export declare function normalizeRunAtMsOrThrow(value: string | number | undefined, fieldName: string): number;
+//# sourceMappingURL=ActionScheduleTime.d.ts.map

package/bin/plugin/core/ActionScheduleTime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActionScheduleTime.d.ts","sourceRoot":"","sources":["../../../src/plugin/core/ActionScheduleTime.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA+BH;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,MAAM,CA2BR;AAED;;;;;;GAMG;AACH,wBAAgB,iCAAiC,CAAC,MAAM,EAAE;IACxD,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACpC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACpC,GAAG,MAAM,GAAG,SAAS,CAuBrB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EAClC,SAAS,EAAE,MAAM,GAChB,MAAM,CAaR"}

package/bin/plugin/core/ActionScheduleTime.js

@@ -0,0 +1,108 @@
+/**
+ * ActionSchedule 时间解析工具。
+ *
+ * 关键点（中文）
+ * - 统一解析 plugin action 通用 `--delay` / `--time` 参数。
+ * - 输出统一毫秒时间戳，供 command 请求解析与持久化层复用。
+ * - 该模块只处理“action 延迟执行时间”，不表达独立 schedule plugin。
+ */
+/**
+ * 判断是否为“缺少时区”的 ISO 时间字符串。
+ */
+function looksLikeIsoDatetimeWithoutTimezone(value) {
+    const text = String(value || "").trim();
+    if (!text)
+        return false;
+    const isoLike = /^\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}/.test(text);
+    if (!isoLike)
+        return false;
+    return !/(?:Z|[+-]\d{2}:\d{2})$/i.test(text);
+}
+/**
+ * 解析非负整数。
+ */
+function parseNonNegativeIntOptionOrThrow(value, fieldName) {
+    const text = String(value || "").trim();
+    if (!text) {
+        throw new Error(`${fieldName} is required`);
+    }
+    if (!/^\d+$/.test(text)) {
+        throw new Error(`Invalid ${fieldName}: ${value}`);
+    }
+    const parsed = Number.parseInt(text, 10);
+    if (!Number.isFinite(parsed) || Number.isNaN(parsed) || parsed < 0) {
+        throw new Error(`Invalid ${fieldName}: ${value}`);
+    }
+    return parsed;
+}
+/**
+ * 解析绝对执行时间。
+ *
+ * 支持格式（中文）
+ * - Unix 时间戳秒/毫秒
+ * - ISO 时间字符串（必须显式带时区）
+ */
+export function parseScheduleTimeOptionOrThrow(value, fieldName) {
+    const text = String(value || "").trim();
+    if (!text) {
+        throw new Error(`${fieldName} is required`);
+    }
+    if (/^\d+$/.test(text)) {
+        const parsed = Number.parseInt(text, 10);
+        if (!Number.isFinite(parsed) || Number.isNaN(parsed) || parsed <= 0) {
+            throw new Error(`Invalid ${fieldName}: ${value}`);
+        }
+        return parsed < 1_000_000_000_000 ? parsed * 1000 : parsed;
+    }
+    if (looksLikeIsoDatetimeWithoutTimezone(text)) {
+        throw new Error(`Invalid ${fieldName}: ${value}. ISO datetime must include timezone offset (e.g. +08:00 or Z).`);
+    }
+    const parsed = Date.parse(text);
+    if (!Number.isFinite(parsed) || Number.isNaN(parsed) || parsed <= 0) {
+        throw new Error(`Invalid ${fieldName}: ${value}. Use Unix timestamp (seconds/ms) or ISO datetime.`);
+    }
+    return parsed;
+}
+/**
+ * 解析 command 层调度输入并归一化为绝对毫秒时间戳。
+ *
+ * 说明（中文）
+ * - `delayMs` 与 `time` 只能二选一。
+ * - 未传时返回 `undefined`，表示立即执行。
+ */
+export function parseActionScheduleRunAtMsOrThrow(params) {
+    const delayText = params.delay === undefined || params.delay === null
+        ? ""
+        : String(params.delay).trim();
+    const timeText = params.time === undefined || params.time === null
+        ? ""
+        : String(params.time).trim();
+    if (delayText && timeText) {
+        throw new Error("`--delay` and `--time` cannot be used together.");
+    }
+    if (delayText) {
+        return Date.now() + parseNonNegativeIntOptionOrThrow(delayText, "delay");
+    }
+    if (timeText) {
+        return parseScheduleTimeOptionOrThrow(timeText, "time");
+    }
+    return undefined;
+}
+/**
+ * 规范化 API/存储层传入的 runAtMs。
+ */
+export function normalizeRunAtMsOrThrow(value, fieldName) {
+    const text = String(value ?? "").trim();
+    if (!text) {
+        throw new Error(`${fieldName} is required`);
+    }
+    if (!/^\d+$/.test(text)) {
+        throw new Error(`Invalid ${fieldName}: ${String(value)}`);
+    }
+    const parsed = Number.parseInt(text, 10);
+    if (!Number.isFinite(parsed) || Number.isNaN(parsed) || parsed <= 0) {
+        throw new Error(`Invalid ${fieldName}: ${String(value)}`);
+    }
+    return parsed;
+}
+//# sourceMappingURL=ActionScheduleTime.js.map

package/bin/plugin/core/ActionScheduleTime.js.map

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

package/bin/plugin/core/Activation.d.ts

@@ -2,18 +2,18 @@
  * Plugin 激活判定工具。
  *
  * 关键点（中文）
- * - 统一收敛“某个 plugin 在当前 city 配置下是否启用”的规则。
- * - plugin 启用态属于 city 级生命周期配置，不再来自 agent `downcity.json`。
+ * - 统一收敛“某个 plugin 在当前项目配置下是否启用”的规则。
+ * - plugin 启用态直接来自项目 `downcity.json` 的 `plugins.<name>.enabled`。
  */
 import type { Plugin } from "../../plugin/types/Plugin.js";
-import type { AgentContext } from "../../core/AgentContextTypes.js";
-import type { AgentRuntimeBase } from "../../core/AgentCoreTypes.js";
+import type { AgentContext } from "../../types/runtime/agent/AgentContext.js";
+import type { AgentRuntimeBase } from "../../types/runtime/agent/AgentRuntime.js";
 /**
- * 读取当前 city 配置下的 plugin 启用态。
+ * 读取当前项目配置下的 plugin 启用态。
  */
 export declare function isPluginEnabled(params: {
     plugin: Plugin;
-    context?: Pick<AgentContext, "platform">;
-    runtime?: Pick<AgentRuntimeBase, "platform">;
+    context?: Pick<AgentContext, "config">;
+    runtime?: Pick<AgentRuntimeBase, "config">;
 }): boolean;
 //# sourceMappingURL=Activation.d.ts.map

package/bin/plugin/core/Activation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Activation.d.ts","sourceRoot":"","sources":["../../../src/plugin/core/Activation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IACzC,OAAO,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;CAC9C,GAAG,OAAO,CAMV"}
+{"version":3,"file":"Activation.d.ts","sourceRoot":"","sources":["../../../src/plugin/core/Activation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAE9E;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IACvC,OAAO,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;CAC5C,GAAG,OAAO,CAOV"}

package/bin/plugin/core/Activation.js

@@ -2,19 +2,20 @@
  * Plugin 激活判定工具。
  *
  * 关键点（中文）
- * - 统一收敛“某个 plugin 在当前 city 配置下是否启用”的规则。
- * - plugin 启用态属于 city 级生命周期配置，不再来自 agent `downcity.json`。
+ * - 统一收敛“某个 plugin 在当前项目配置下是否启用”的规则。
+ * - plugin 启用态直接来自项目 `downcity.json` 的 `plugins.<name>.enabled`。
  */
+import { readProjectPluginEnabled } from "../../plugin/core/ProjectConfigStore.js";
 /**
- * 读取当前 city 配置下的 plugin 启用态。
+ * 读取当前项目配置下的 plugin 启用态。
  */
 export function isPluginEnabled(params) {
     const pluginName = String(params.plugin.name || "").trim();
     if (!pluginName)
         return false;
-    if (pluginName === "auth")
-        return true;
-    const platform = params.context?.platform || params.runtime?.platform;
-    return platform ? platform.isPluginEnabled(pluginName) : true;
+    return readProjectPluginEnabled({
+        pluginName,
+        config: params.context?.config || params.runtime?.config,
+    });
 }
 //# sourceMappingURL=Activation.js.map

package/bin/plugin/core/Activation.js.map

@@ -1 +1 @@
-{"version":3,"file":"Activation.js","sourceRoot":"","sources":["../../../src/plugin/core/Activation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAI/B;IACC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3D,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9B,IAAI,UAAU,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACvC,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,EAAE,QAAQ,IAAI,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC;IACtE,OAAO,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAChE,CAAC"}
+{"version":3,"file":"Activation.js","sourceRoot":"","sources":["../../../src/plugin/core/Activation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAK/E;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAI/B;IACC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3D,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9B,OAAO,wBAAwB,CAAC;QAC9B,UAAU;QACV,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,MAAM;KACzD,CAAC,CAAC;AACL,CAAC"}

package/bin/plugin/core/BasePlugin.d.ts

@@ -6,10 +6,10 @@
  * - plugin 的长期状态归属于实例本身，而不是模块级单例。
  * - 旧生命周期模型暂时通过 `lifecycle` 兼容，后续可逐步收敛到 `start/stop/command`。
  */
-import type { AgentContext } from "../../core/AgentContextTypes.js";
-import type { AgentRuntime } from "../../core/AgentCoreTypes.js";
+import type { AgentContext } from "../../types/runtime/agent/AgentContext.js";
+import type { AgentRuntime } from "../../types/runtime/agent/AgentRuntime.js";
 import type { Plugin, PluginActions, PluginAvailability, PluginCommandContext, PluginConfigDefinition, PluginHooks, PluginHttpDefinition, PluginLifecycle, PluginResolves, PluginSetupDefinition, PluginStateRecord, PluginUsageDefinition } from "../../plugin/types/Plugin.js";
-import type { StructuredConfig } from "../../core/AgentContextTypes.js";
+import type { StructuredConfig } from "../../types/runtime/agent/AgentContext.js";
 /**
  * BasePlugin 抽象基类。
  */

package/bin/plugin/core/BasePlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BasePlugin.d.ts","sourceRoot":"","sources":["../../../src/plugin/core/BasePlugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EACV,MAAM,EACN,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,WAAW,EACX,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAEpE;;GAEG;AACH,8BAAsB,UAAW,YAAW,MAAM;IAChD;;OAEG;IACH,SAAgB,iBAAiB,EAAE,iBAAiB,CAIlD;IAEF;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;gBAEzB,KAAK,GAAE,YAAY,GAAG,IAAW;IAI7C;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,KAAK,MAAM;IAEpB;;OAEG;IACH,QAAQ,CAAC,WAAW,MAAM;IAE1B;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;IAE3D;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAEvC;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAEvC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAM;IAErC;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;IAEnC;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,oBAAoB,CAAC;IAErC;;OAEG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;IAE5B;;OAEG;IACH,YAAY,CAAC,CACX,OAAO,EAAE,oBAAoB,GAAG,YAAY,GAC3C,OAAO,CAAC,kBAAkB,CAAC,GAAG,kBAAkB;IAEnD;;OAEG;IACH,MAAM,CAAC,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM;IAExD;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI;IAK3C;;OAEG;IACH,SAAS,CAAC,YAAY,IAAI,YAAY;CAMvC"}
+{"version":3,"file":"BasePlugin.d.ts","sourceRoot":"","sources":["../../../src/plugin/core/BasePlugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EACV,MAAM,EACN,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,WAAW,EACX,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAE9E;;GAEG;AACH,8BAAsB,UAAW,YAAW,MAAM;IAChD;;OAEG;IACH,SAAgB,iBAAiB,EAAE,iBAAiB,CAIlD;IAEF;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;gBAEzB,KAAK,GAAE,YAAY,GAAG,IAAW;IAI7C;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,KAAK,MAAM;IAEpB;;OAEG;IACH,QAAQ,CAAC,WAAW,MAAM;IAE1B;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;IAE3D;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAEvC;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAEvC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAM;IAErC;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;IAEnC;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,oBAAoB,CAAC;IAErC;;OAEG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;IAE5B;;OAEG;IACH,YAAY,CAAC,CACX,OAAO,EAAE,oBAAoB,GAAG,YAAY,GAC3C,OAAO,CAAC,kBAAkB,CAAC,GAAG,kBAAkB;IAEnD;;OAEG;IACH,MAAM,CAAC,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM;IAExD;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI;IAK3C;;OAEG;IACH,SAAS,CAAC,YAAY,IAAI,YAAY;CAMvC"}

package/bin/plugin/core/HookRegistry.d.ts

@@ -7,7 +7,7 @@
  */
 import type { JsonValue } from "../../types/common/Json.js";
 import type { PluginEffectHook, PluginGuardHook, PluginPipelineHook, PluginResolveHook } from "../../plugin/types/Plugin.js";
-import type { AgentContext } from "../../core/AgentContextTypes.js";
+import type { AgentContext } from "../../types/runtime/agent/AgentContext.js";
 type ContextResolver = () => AgentContext;
 type PluginEnabledChecker = (pluginName: string, context: AgentContext) => boolean;
 /**

package/bin/plugin/core/HookRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HookRegistry.d.ts","sourceRoot":"","sources":["../../../src/plugin/core/HookRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEhE,KAAK,eAAe,GAAG,MAAM,YAAY,CAAC;AAC1C,KAAK,oBAAoB,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC;AAsBnF;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAuB;IAE5D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuC;IAErE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoC;IAE/D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqC;IAEjE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoC;gBAErD,MAAM,EAAE;QAClB,eAAe,EAAE,eAAe,CAAC;QACjC,oBAAoB,EAAE,oBAAoB,CAAC;KAC5C;IAKD;;OAEG;IACH,QAAQ,CACN,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,kBAAkB,CAAC,SAAS,CAAC,GACrC,IAAI;IAaP;;OAEG;IACH,KAAK,CACH,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,GAClC,IAAI;IAaP;;OAEG;IACH,MAAM,CACJ,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,GACnC,IAAI;IAaP;;;;;OAKG;IACH,OAAO,CACL,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,iBAAiB,CAAC,SAAS,EAAE,SAAS,CAAC,GAC/C,IAAI;IAcP;;OAEG;IACH,IAAI,IAAI,MAAM,EAAE;IAUhB;;OAEG;IACG,aAAa,CAAC,CAAC,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAmB3E;;OAEG;IACG,UAAU,CAAC,CAAC,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB3E;;OAEG;IACG,WAAW,CAAC,CAAC,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB5E;;OAEG;IACG,YAAY,CAAC,MAAM,GAAG,SAAS,EAAE,OAAO,GAAG,SAAS,EACxD,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,OAAO,CAAC;CAoBpB"}
+{"version":3,"file":"HookRegistry.d.ts","sourceRoot":"","sources":["../../../src/plugin/core/HookRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAE1E,KAAK,eAAe,GAAG,MAAM,YAAY,CAAC;AAC1C,KAAK,oBAAoB,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC;AAsBnF;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAuB;IAE5D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuC;IAErE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoC;IAE/D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqC;IAEjE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoC;gBAErD,MAAM,EAAE;QAClB,eAAe,EAAE,eAAe,CAAC;QACjC,oBAAoB,EAAE,oBAAoB,CAAC;KAC5C;IAKD;;OAEG;IACH,QAAQ,CACN,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,kBAAkB,CAAC,SAAS,CAAC,GACrC,IAAI;IAaP;;OAEG;IACH,KAAK,CACH,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,GAClC,IAAI;IAaP;;OAEG;IACH,MAAM,CACJ,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,GACnC,IAAI;IAaP;;;;;OAKG;IACH,OAAO,CACL,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,iBAAiB,CAAC,SAAS,EAAE,SAAS,CAAC,GAC/C,IAAI;IAcP;;OAEG;IACH,IAAI,IAAI,MAAM,EAAE;IAUhB;;OAEG;IACG,aAAa,CAAC,CAAC,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAmB3E;;OAEG;IACG,UAAU,CAAC,CAAC,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB3E;;OAEG;IACG,WAAW,CAAC,CAAC,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB5E;;OAEG;IACG,YAAY,CAAC,MAAM,GAAG,SAAS,EAAE,OAAO,GAAG,SAAS,EACxD,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,OAAO,CAAC;CAoBpB"}

package/bin/plugin/core/PluginActionRunner.d.ts

@@ -1,10 +1,10 @@
 /**
  * PluginActionRunner：主动型 plugin action/command 执行模块。
  */
-import type { AgentContext } from "../../core/AgentContextTypes.js";
+import type { AgentContext } from "../../types/runtime/agent/AgentContext.js";
 import type { BasePlugin } from "../../plugin/core/BasePlugin.js";
 import type { PluginAction, PluginActionResult, PluginCommandResult, PluginStateSnapshot } from "../../plugin/types/Plugin.js";
-import type { PluginCommandScheduleInput } from "../../plugin/types/PluginSchedule.js";
+import type { PluginActionScheduleInput } from "../../plugin/types/ActionSchedule.js";
 import type { JsonValue } from "../../types/common/Json.js";
 /**
  * 按名称解析主动型 plugin action。
@@ -26,7 +26,7 @@ export declare function runPluginCommand(params: {
     pluginName: string;
     command: string;
     payload?: JsonValue;
-    schedule?: JsonValue | PluginCommandScheduleInput;
+    schedule?: JsonValue | PluginActionScheduleInput;
     context: AgentContext;
 }): Promise<PluginCommandResult & {
     plugin?: PluginStateSnapshot;

package/bin/plugin/core/PluginActionRunner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PluginActionRunner.d.ts","sourceRoot":"","sources":["../../../src/plugin/core/PluginActionRunner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EAEnB,mBAAmB,EACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AACnF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAgBxD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,MAAM,GACjB,YAAY,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,IAAI,CAI3C;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAC/C,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,OAAO,EAAE,YAAY,CAAC;CACvB,GAAG,OAAO,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAsBzC;AA4DD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,QAAQ,CAAC,EAAE,SAAS,GAAG,0BAA0B,CAAC;IAClD,OAAO,EAAE,YAAY,CAAC;CACvB,GAAG,OAAO,CAAC,mBAAmB,GAAG;IAAE,MAAM,CAAC,EAAE,mBAAmB,CAAA;CAAE,CAAC,CA6HlE"}
+{"version":3,"file":"PluginActionRunner.d.ts","sourceRoot":"","sources":["../../../src/plugin/core/PluginActionRunner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EAEnB,mBAAmB,EACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAClF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAgBxD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,MAAM,GACjB,YAAY,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,IAAI,CAI3C;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAC/C,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,OAAO,EAAE,YAAY,CAAC;CACvB,GAAG,OAAO,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAsBzC;AA4DD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,QAAQ,CAAC,EAAE,SAAS,GAAG,yBAAyB,CAAC;IACjD,OAAO,EAAE,YAAY,CAAC;CACvB,GAAG,OAAO,CAAC,mBAAmB,GAAG;IAAE,MAAM,CAAC,EAAE,mBAAmB,CAAA;CAAE,CAAC,CA6HlE"}

package/bin/plugin/core/PluginActionRunner.js

@@ -1,8 +1,8 @@
 /**
  * PluginActionRunner：主动型 plugin action/command 执行模块。
  */
-import { PluginScheduleStore } from "../../plugin/core/schedule/Store.js";
-import { normalizeRunAtMsOrThrow } from "../../plugin/core/schedule/Time.js";
+import { ActionScheduleStore } from "../../plugin/core/ActionScheduleStore.js";
+import { normalizeRunAtMsOrThrow } from "../../plugin/core/ActionScheduleTime.js";
 import { controlPluginState, ensurePluginStateRecord, markPluginCommand, markPluginState, resolvePluginByName, toPluginStateSnapshot, } from "../../plugin/core/PluginStateController.js";
 function resolveLifecycle(plugin) {
     return plugin.lifecycle;
@@ -55,7 +55,7 @@ async function schedulePluginAction(params) {
     try {
         const scheduleInput = params.schedule;
         const runAtMs = normalizeRunAtMsOrThrow(scheduleInput.runAtMs, "schedule.runAtMs");
-        const store = new PluginScheduleStore(params.context.rootPath);
+        const store = new ActionScheduleStore(params.context.rootPath);
         try {
             const job = store.createJob({
                 pluginName: params.plugin.name,

package/bin/plugin/core/PluginActionRunner.js.map

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

package/bin/plugin/core/PluginCatalog.d.ts

@@ -0,0 +1,56 @@
+/**
+ * PluginCatalog：通用 plugin 目录视图工具。
+ *
+ * 关键点（中文）
+ * - 这里不关心 plugin 来源，不区分内建、外部、本地或远程。
+ * - 调用方只需要传入当前已注册或准备展示的 plugin 实例集合。
+ * - Agent 的视角只有“传入的 plugin”，目录视图和可用性检查都从这些实例推导。
+ */
+import type { Plugin, PluginAvailability, PluginView } from "../../plugin/types/Plugin.js";
+import type { AgentContext } from "../../types/runtime/agent/AgentContext.js";
+/**
+ * 判断 plugin 是否声明了运行时生命周期。
+ */
+export declare function hasPluginLifecycle(plugin: Plugin): boolean;
+/**
+ * 过滤出声明了运行时生命周期的 plugin。
+ */
+export declare function listPluginsWithLifecycle<T extends Plugin>(plugins: Iterable<T>): T[];
+/**
+ * 过滤出没有运行时生命周期、可直接执行 action 的 plugin。
+ */
+export declare function listPluginsWithoutLifecycle<T extends Plugin>(plugins: Iterable<T>): T[];
+/**
+ * 按名称查找 plugin。
+ */
+export declare function findPluginByName<T extends Plugin>(plugins: Iterable<T>, pluginName: string): T | null;
+/**
+ * 将 plugin 定义转换为目录视图。
+ */
+export declare function toPluginView(plugin: Plugin): PluginView;
+/**
+ * 列出 plugin 目录视图。
+ */
+export declare function listPluginViews(plugins: Iterable<Plugin>): PluginView[];
+/**
+ * 构建 plugin 可用性视图。
+ *
+ * 关键点（中文）
+ * - 传入 context 时会调用 plugin 自己的 availability。
+ * - 未传 context 时只做静态启用态检查，适合 Console 或 CLI 的目录回退展示。
+ */
+export declare function resolvePluginAvailability(params: {
+    plugins: Iterable<Plugin>;
+    pluginName: string;
+    context?: AgentContext;
+    agentError?: string;
+}): Promise<PluginAvailability>;
+/**
+ * 同步构建静态 plugin 可用性视图。
+ */
+export declare function buildStaticPluginAvailability(params: {
+    plugins: Iterable<Plugin>;
+    pluginName: string;
+    agentError?: string;
+}): PluginAvailability;
+//# sourceMappingURL=PluginCatalog.d.ts.map

package/bin/plugin/core/PluginCatalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginCatalog.d.ts","sourceRoot":"","sources":["../../../src/plugin/core/PluginCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EACV,MAAM,EACN,kBAAkB,EAClB,UAAU,EACX,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAE1E;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAEpF;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAEvF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAC/C,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,EACpB,UAAU,EAAE,MAAM,GACjB,CAAC,GAAG,IAAI,CAIV;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAuBvD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,UAAU,EAAE,CAIvE;AAED;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAAC,MAAM,EAAE;IACtD,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA0C9B;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE;IACpD,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,kBAAkB,CA2BrB"}

package/bin/plugin/core/PluginCatalog.js

@@ -0,0 +1,137 @@
+/**
+ * PluginCatalog：通用 plugin 目录视图工具。
+ *
+ * 关键点（中文）
+ * - 这里不关心 plugin 来源，不区分内建、外部、本地或远程。
+ * - 调用方只需要传入当前已注册或准备展示的 plugin 实例集合。
+ * - Agent 的视角只有“传入的 plugin”，目录视图和可用性检查都从这些实例推导。
+ */
+import { isPluginEnabled } from "../../plugin/core/Activation.js";
+/**
+ * 判断 plugin 是否声明了运行时生命周期。
+ */
+export function hasPluginLifecycle(plugin) {
+    return Boolean(plugin.lifecycle);
+}
+/**
+ * 过滤出声明了运行时生命周期的 plugin。
+ */
+export function listPluginsWithLifecycle(plugins) {
+    return [...plugins].filter((plugin) => hasPluginLifecycle(plugin));
+}
+/**
+ * 过滤出没有运行时生命周期、可直接执行 action 的 plugin。
+ */
+export function listPluginsWithoutLifecycle(plugins) {
+    return [...plugins].filter((plugin) => !hasPluginLifecycle(plugin));
+}
+/**
+ * 按名称查找 plugin。
+ */
+export function findPluginByName(plugins, pluginName) {
+    const key = String(pluginName || "").trim();
+    if (!key)
+        return null;
+    return [...plugins].find((plugin) => plugin.name === key) || null;
+}
+/**
+ * 将 plugin 定义转换为目录视图。
+ */
+export function toPluginView(plugin) {
+    return {
+        name: plugin.name,
+        title: String(plugin.title || plugin.name || "").trim(),
+        description: String(plugin.description || "").trim(),
+        actions: Object.keys(plugin.actions || {}).sort((left, right) => left.localeCompare(right)),
+        pipelines: Object.keys(plugin.hooks?.pipeline || {}).sort((left, right) => left.localeCompare(right)),
+        guards: Object.keys(plugin.hooks?.guard || {}).sort((left, right) => left.localeCompare(right)),
+        effects: Object.keys(plugin.hooks?.effect || {}).sort((left, right) => left.localeCompare(right)),
+        resolves: Object.keys(plugin.resolves || {}).sort((left, right) => left.localeCompare(right)),
+        hasSystem: typeof plugin.system === "function",
+        hasAvailability: typeof plugin.availability === "function",
+    };
+}
+/**
+ * 列出 plugin 目录视图。
+ */
+export function listPluginViews(plugins) {
+    return [...plugins]
+        .map((plugin) => toPluginView(plugin))
+        .sort((left, right) => left.name.localeCompare(right.name));
+}
+/**
+ * 构建 plugin 可用性视图。
+ *
+ * 关键点（中文）
+ * - 传入 context 时会调用 plugin 自己的 availability。
+ * - 未传 context 时只做静态启用态检查，适合 Console 或 CLI 的目录回退展示。
+ */
+export async function resolvePluginAvailability(params) {
+    const plugin = findPluginByName(params.plugins, params.pluginName);
+    if (!plugin) {
+        return {
+            enabled: false,
+            available: false,
+            reasons: [`Unknown plugin: ${params.pluginName}`],
+        };
+    }
+    if (params.context && plugin.availability) {
+        return await plugin.availability(params.context);
+    }
+    const enabled = isPluginEnabled({
+        plugin,
+        ...(params.context ? { context: params.context } : {}),
+    });
+    if (!enabled) {
+        return {
+            enabled: false,
+            available: false,
+            reasons: [`Plugin "${plugin.name}" is disabled`],
+        };
+    }
+    const agentReason = String(params.agentError || "").trim();
+    if (agentReason || !params.context) {
+        return {
+            enabled: true,
+            available: false,
+            reasons: agentReason
+                ? [`Agent server unavailable: ${agentReason}`]
+                : ["Static catalog view only. Agent-side availability is not loaded."],
+        };
+    }
+    return {
+        enabled: true,
+        available: true,
+        reasons: [],
+    };
+}
+/**
+ * 同步构建静态 plugin 可用性视图。
+ */
+export function buildStaticPluginAvailability(params) {
+    const plugin = findPluginByName(params.plugins, params.pluginName);
+    if (!plugin) {
+        return {
+            enabled: false,
+            available: false,
+            reasons: [`Unknown plugin: ${params.pluginName}`],
+        };
+    }
+    const enabled = isPluginEnabled({ plugin });
+    if (!enabled) {
+        return {
+            enabled: false,
+            available: false,
+            reasons: [`Plugin "${plugin.name}" is disabled`],
+        };
+    }
+    const agentReason = String(params.agentError || "").trim();
+    return {
+        enabled: true,
+        available: false,
+        reasons: agentReason
+            ? [`Agent server unavailable: ${agentReason}`]
+            : ["Static catalog view only. Agent-side availability is not loaded."],
+    };
+}
+//# sourceMappingURL=PluginCatalog.js.map

package/bin/plugin/core/PluginCatalog.js.map

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

package/bin/plugin/core/PluginCommand.d.ts

@@ -1,13 +1,17 @@
 /**
- * Plugin Action CLI 注册器。
+ * PluginCommand：通用 plugin action CLI 注册器。
  *
  * 关键点（中文）
- * - 负责把“本地可执行”的 plugin actions 挂到 commander（`city <plugin> <action>`）。
- * - 需要运行中 agent 的 plugin 不在这里注册，避免和受托管命令桥接冲突。
+ * - 这里只把调用方传入的 plugin actions 挂到 commander。
+ * - 是否传入某类 plugin 由宿主决定，agent 不内置任何 plugin 清单。
  */
 import type { Command } from "commander";
+import type { Plugin } from "../../plugin/types/Plugin.js";
 /**
- * 注册全部 plugin actions 的 CLI 命令。
+ * 注册指定 plugin 集合的 action CLI 命令。
  */
-export declare function registerAllPluginsForCli(program: Command): void;
+export declare function registerPluginActionCommandsForCli(params: {
+    program: Command;
+    plugins: Iterable<Plugin>;
+}): void;
 //# sourceMappingURL=PluginCommand.d.ts.map

package/bin/plugin/core/PluginCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PluginCommand.d.ts","sourceRoot":"","sources":["../../../src/plugin/core/PluginCommand.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmMzC;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAW/D"}
+{"version":3,"file":"PluginCommand.d.ts","sourceRoot":"","sources":["../../../src/plugin/core/PluginCommand.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,MAAM,EAAgB,MAAM,0BAA0B,CAAC;AAsMrE;;GAEG;AACH,wBAAgB,kCAAkC,CAAC,MAAM,EAAE;IACzD,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;CAC3B,GAAG,IAAI,CAaP"}