@downcity/agent 1.1.25 → 1.1.32

package/bin/plugin/core/BasePlugin.js

@@ -0,0 +1,84 @@
+/**
+ * BasePlugin：统一 plugin 类基座。
+ *
+ * 关键点（中文）
+ * - 主动运行型能力与被动扩展型能力统一收敛到 plugin 概念。
+ * - plugin 的长期状态归属于实例本身，而不是模块级单例。
+ * - 旧 service 生命周期模型暂时通过 `lifecycle` 兼容，后续可逐步收敛到 `start/stop/command`。
+ */
+/**
+ * BasePlugin 抽象基类。
+ */
+export class BasePlugin {
+    /**
+     * 当前实例持有的通用 plugin 运行状态记录。
+     */
+    pluginStateRecord = {
+        state: "stopped",
+        updatedAt: Date.now(),
+        chain: Promise.resolve(),
+    };
+    /**
+     * 当前 plugin 所属的 agent 宿主。
+     */
+    agent;
+    constructor(agent = null) {
+        this.agent = agent;
+    }
+    /**
+     * 插件标题。
+     */
+    title = "";
+    /**
+     * 插件说明。
+     */
+    description = "";
+    /**
+     * 插件配置定义。
+     */
+    config;
+    /**
+     * 插件 setup 协议。
+     */
+    setup;
+    /**
+     * 插件 usage 协议。
+     */
+    usage;
+    /**
+     * 显式 action 集合。
+     */
+    actions = {};
+    /**
+     * pipeline / guard / effect 扩展点。
+     */
+    hooks;
+    /**
+     * resolve 扩展点。
+     */
+    resolves;
+    /**
+     * HTTP 路由扩展。
+     */
+    http;
+    /**
+     * 旧生命周期兼容层。
+     */
+    lifecycle;
+    /**
+     * 绑定当前 plugin 所属的 agent 宿主。
+     */
+    bindAgent(agent) {
+        this.agent = agent;
+        return this;
+    }
+    /**
+     * 读取绑定的 agent 宿主。
+     */
+    requireAgent() {
+        if (this.agent)
+            return this.agent;
+        throw new Error(`Plugin "${this.name}" is not bound to an agent instance.`);
+    }
+}
+//# sourceMappingURL=BasePlugin.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BasePlugin.js","sourceRoot":"","sources":["../../../src/plugin/core/BasePlugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAoBH;;GAEG;AACH,MAAM,OAAgB,UAAU;IAC9B;;OAEG;IACa,iBAAiB,GAAsB;QACrD,KAAK,EAAE,SAAS;QAChB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE;KACzB,CAAC;IAEF;;OAEG;IACO,KAAK,CAAsB;IAErC,YAAY,QAA6B,IAAI;QAC3C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAOD;;OAEG;IACM,KAAK,GAAG,EAAE,CAAC;IAEpB;;OAEG;IACM,WAAW,GAAG,EAAE,CAAC;IAE1B;;OAEG;IACM,MAAM,CAA4C;IAE3D;;OAEG;IACM,KAAK,CAAyB;IAEvC;;OAEG;IACM,KAAK,CAAyB;IAEvC;;OAEG;IACM,OAAO,GAAkB,EAAE,CAAC;IAErC;;OAEG;IACM,KAAK,CAAe;IAE7B;;OAEG;IACM,QAAQ,CAAkB;IAEnC;;OAEG;IACM,IAAI,CAAwB;IAErC;;OAEG;IACH,SAAS,CAAmB;IAc5B;;OAEG;IACH,SAAS,CAAC,KAA0B;QAClC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACO,YAAY;QACpB,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC;QAClC,MAAM,IAAI,KAAK,CACb,WAAW,IAAI,CAAC,IAAI,sCAAsC,CAC3D,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,14 @@
+/**
+ * 内建主动型 plugin 类清单。
+ */
+import type { AgentRuntime } from "../../core/AgentCoreTypes.js";
+import type { BasePlugin } from "../../plugin/core/BasePlugin.js";
+/**
+ * 单个主动型 plugin class 构造器。
+ */
+export type BuiltinPluginClass<T extends BasePlugin = BasePlugin> = new (agent: AgentRuntime | null) => T;
+/**
+ * 全部内建主动型 plugin classes。
+ */
+export declare const BUILTIN_PLUGIN_CLASSES: BuiltinPluginClass[];
+//# sourceMappingURL=BuiltinPluginClasses.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BuiltinPluginClasses.d.ts","sourceRoot":"","sources":["../../../src/plugin/core/BuiltinPluginClasses.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAQ9D;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU,IAAI,KAClE,KAAK,EAAE,YAAY,GAAG,IAAI,KACvB,CAAC,CAAC;AAEP;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,kBAAkB,EAOtD,CAAC"}

package/bin/plugin/core/BuiltinPluginClasses.js

@@ -0,0 +1,21 @@
+/**
+ * 内建主动型 plugin 类清单。
+ */
+import { ChatPlugin } from "../../plugin/builtins/chat/ChatPlugin.js";
+import { ContactPlugin } from "../../plugin/builtins/contact/ContactPlugin.js";
+import { SchedulePlugin } from "../../plugin/builtins/schedule/SchedulePlugin.js";
+import { TaskPlugin } from "../../plugin/builtins/task/TaskPlugin.js";
+import { MemoryPlugin } from "../../plugin/builtins/memory/MemoryPlugin.js";
+import { ShellPlugin } from "../../plugin/builtins/shell/ShellPlugin.js";
+/**
+ * 全部内建主动型 plugin classes。
+ */
+export const BUILTIN_PLUGIN_CLASSES = [
+    ChatPlugin,
+    ContactPlugin,
+    SchedulePlugin,
+    TaskPlugin,
+    MemoryPlugin,
+    ShellPlugin,
+];
+//# sourceMappingURL=BuiltinPluginClasses.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BuiltinPluginClasses.js","sourceRoot":"","sources":["../../../src/plugin/core/BuiltinPluginClasses.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,0CAA0C,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AASrE;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAyB;IAC1D,UAAU;IACV,aAAa;IACb,cAAc;IACd,UAAU;IACV,YAAY;IACZ,WAAW;CACZ,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"LocalExecution.d.ts","sourceRoot":"","sources":["../../../src/plugin/core/LocalExecution.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,UAAU,EACX,MAAM,0BAA0B,CAAC;AAkBlC;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,WAAW,EAAE,MAAM,GAAG,oBAAoB,CA2BzF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,UAAU,EAAE,CAE/C;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,kBAAkB,CAAC,CA6B7B;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB,GAAG,OAAO,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAoDzC"}
+{"version":3,"file":"LocalExecution.d.ts","sourceRoot":"","sources":["../../../src/plugin/core/LocalExecution.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,UAAU,EACX,MAAM,0BAA0B,CAAC;AAmBlC;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,WAAW,EAAE,MAAM,GAAG,oBAAoB,CA8BzF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,UAAU,EAAE,CAE/C;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,kBAAkB,CAAC,CA6B7B;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB,GAAG,OAAO,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAoDzC"}

package/bin/plugin/core/LocalExecution.js

@@ -49,7 +49,7 @@ export function createLocalPluginCommandContext(projectRoot) {
         config,
         env,
         globalEnv,
-        paths: createAgentPathRuntime(rootPath),
+        paths: createAgentPathRuntime(rootPath, String(config.name || "").trim() || path.basename(rootPath) || "agent"),
         pluginConfig: createAgentPluginConfigRuntime(rootPath),
         platform,
     };
@@ -129,7 +129,7 @@ export async function runLocalPluginAction(params) {
     }
     try {
         return await action.execute({
-            context,
+            context: context,
             payload: (params.payload ?? {}),
             pluginName: plugin.name,
             actionName,

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

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

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

@@ -0,0 +1,7 @@
+/**
+ * Plugin Manager 门面模块。
+ */
+export type { PluginStateControlAction, PluginStateControlResult, PluginStateSnapshot, } from "../../plugin/types/Plugin.js";
+export { controlPluginState, getPluginRootCommandNames, getStaticPlugins, isPluginRunning, listPluginStates, startAllPlugins, stopAllPlugins, } from "../../plugin/core/PluginStateController.js";
+export { runPluginCommand, } from "../../plugin/core/PluginActionRunner.js";
+//# sourceMappingURL=Manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Manager.d.ts","sourceRoot":"","sources":["../../../src/plugin/core/Manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,wBAAwB,EACxB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,cAAc,GACf,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,gBAAgB,GACjB,MAAM,qCAAqC,CAAC"}

package/bin/plugin/core/Manager.js

@@ -0,0 +1,6 @@
+/**
+ * Plugin Manager 门面模块。
+ */
+export { controlPluginState, getPluginRootCommandNames, getStaticPlugins, isPluginRunning, listPluginStates, startAllPlugins, stopAllPlugins, } from "../../plugin/core/PluginStateController.js";
+export { runPluginCommand, } from "../../plugin/core/PluginActionRunner.js";
+//# sourceMappingURL=Manager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Manager.js","sourceRoot":"","sources":["../../../src/plugin/core/Manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,cAAc,GACf,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,gBAAgB,GACjB,MAAM,qCAAqC,CAAC"}

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

@@ -0,0 +1,34 @@
+/**
+ * PluginActionRunner：主动型 plugin action/command 执行模块。
+ */
+import type { AgentContext } from "../../core/AgentContextTypes.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 { JsonValue } from "../../types/common/Json.js";
+/**
+ * 按名称解析主动型 plugin action。
+ */
+export declare function resolvePluginAction(plugin: BasePlugin, actionName: string): PluginAction<JsonValue, JsonValue> | null;
+/**
+ * 执行一个主动型 plugin action。
+ */
+export declare function invokePluginAction(params: {
+    plugin: BasePlugin;
+    actionName: string;
+    payload?: JsonValue;
+    context: AgentContext;
+}): Promise<PluginActionResult<JsonValue>>;
+/**
+ * 统一执行主动型 plugin command。
+ */
+export declare function runPluginCommand(params: {
+    pluginName: string;
+    command: string;
+    payload?: JsonValue;
+    schedule?: JsonValue | PluginCommandScheduleInput;
+    context: AgentContext;
+}): Promise<PluginCommandResult & {
+    plugin?: PluginStateSnapshot;
+}>;
+//# sourceMappingURL=PluginActionRunner.d.ts.map

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

@@ -0,0 +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,CAuBzC;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"}

package/bin/plugin/core/PluginActionRunner.js

@@ -0,0 +1,208 @@
+/**
+ * PluginActionRunner：主动型 plugin action/command 执行模块。
+ */
+import { PluginScheduleStore } from "../../plugin/core/schedule/Store.js";
+import { normalizeRunAtMsOrThrow } from "../../plugin/core/schedule/Time.js";
+import { controlPluginState, ensurePluginStateRecord, markPluginCommand, markPluginState, resolvePluginByName, toPluginStateSnapshot, } from "../../plugin/core/PluginStateController.js";
+function resolveLifecycle(plugin) {
+    return plugin.lifecycle;
+}
+/**
+ * 按名称解析主动型 plugin action。
+ */
+export function resolvePluginAction(plugin, actionName) {
+    const key = String(actionName || "").trim();
+    if (!key)
+        return null;
+    return plugin.actions[key] || null;
+}
+/**
+ * 执行一个主动型 plugin action。
+ */
+export async function invokePluginAction(params) {
+    const action = resolvePluginAction(params.plugin, params.actionName);
+    if (!action) {
+        return {
+            success: false,
+            error: `Plugin "${params.plugin.name}" does not implement action "${params.actionName}"`,
+        };
+    }
+    try {
+        return await action.execute({
+            context: params.context,
+            payload: (params.payload ?? {}),
+            pluginName: params.plugin.name,
+            serviceName: params.plugin.name,
+            actionName: params.actionName,
+        });
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: String(error),
+        };
+    }
+}
+function toControlCommandAction(command) {
+    if (command === "status" ||
+        command === "start" ||
+        command === "stop" ||
+        command === "restart") {
+        return command;
+    }
+    return null;
+}
+async function schedulePluginAction(params) {
+    try {
+        const scheduleInput = params.schedule;
+        const runAtMs = normalizeRunAtMsOrThrow(scheduleInput.runAtMs, "schedule.runAtMs");
+        const store = new PluginScheduleStore(params.context.rootPath);
+        try {
+            const job = store.createJob({
+                pluginName: params.plugin.name,
+                actionName: params.command,
+                payload: params.payload ?? null,
+                runAtMs,
+            });
+            return {
+                success: true,
+                plugin: params.recordSnapshot,
+                data: {
+                    scheduled: true,
+                    jobId: job.id,
+                    runAtMs: job.runAtMs,
+                    status: job.status,
+                },
+            };
+        }
+        finally {
+            store.close();
+        }
+    }
+    catch (error) {
+        return {
+            success: false,
+            plugin: params.recordSnapshot,
+            message: String(error),
+        };
+    }
+}
+/**
+ * 统一执行主动型 plugin command。
+ */
+export async function runPluginCommand(params) {
+    const plugin = resolvePluginByName(params.pluginName, {
+        context: params.context,
+    });
+    if (!plugin) {
+        return {
+            success: false,
+            message: `Unknown plugin: ${params.pluginName}`,
+        };
+    }
+    const record = ensurePluginStateRecord(plugin);
+    const command = String(params.command || "")
+        .trim()
+        .toLowerCase();
+    if (!command) {
+        return {
+            success: false,
+            plugin: toPluginStateSnapshot(record, plugin),
+            message: "command is required",
+        };
+    }
+    markPluginCommand(record, command);
+    const action = resolvePluginAction(plugin, command);
+    if (params.schedule !== undefined && params.schedule !== null) {
+        if (!action) {
+            return {
+                success: false,
+                plugin: toPluginStateSnapshot(record, plugin),
+                message: `Scheduling only supports plugin actions. "${plugin.name}.${command}" is not a schedulable action.`,
+            };
+        }
+        return await schedulePluginAction({
+            plugin,
+            command,
+            payload: params.payload,
+            schedule: params.schedule,
+            recordSnapshot: toPluginStateSnapshot(record, plugin),
+            context: params.context,
+        });
+    }
+    if (action) {
+        if (record.state !== "running") {
+            return {
+                success: false,
+                plugin: toPluginStateSnapshot(record, plugin),
+                message: `Plugin "${plugin.name}" is not running`,
+            };
+        }
+        const result = await invokePluginAction({
+            plugin,
+            actionName: command,
+            payload: params.payload,
+            context: params.context,
+        });
+        if (!result.success) {
+            return {
+                success: false,
+                plugin: toPluginStateSnapshot(record, plugin),
+                message: result.error || "plugin action failed",
+            };
+        }
+        return {
+            success: true,
+            plugin: toPluginStateSnapshot(record, plugin),
+            ...(result.data !== undefined ? { data: result.data } : {}),
+        };
+    }
+    const controlAction = toControlCommandAction(command);
+    if (controlAction) {
+        const result = await controlPluginState({
+            pluginName: plugin.name,
+            action: controlAction,
+            context: params.context,
+        });
+        return {
+            success: result.success,
+            ...(result.plugin ? { plugin: result.plugin } : {}),
+            ...(result.error ? { message: result.error } : {}),
+        };
+    }
+    if (record.state !== "running") {
+        return {
+            success: false,
+            plugin: toPluginStateSnapshot(record, plugin),
+            message: `Plugin "${plugin.name}" is not running`,
+        };
+    }
+    const handler = resolveLifecycle(plugin)?.command;
+    if (handler) {
+        try {
+            const result = await handler({
+                context: params.context,
+                command,
+                payload: params.payload,
+            });
+            return {
+                ...result,
+                plugin: toPluginStateSnapshot(record, plugin),
+            };
+        }
+        catch (error) {
+            markPluginState(record, "error", String(error));
+            return {
+                success: false,
+                plugin: toPluginStateSnapshot(record, plugin),
+                message: String(error),
+            };
+        }
+    }
+    return {
+        success: false,
+        plugin: toPluginStateSnapshot(record, plugin),
+        message: `Plugin "${plugin.name}" does not implement command "${command}"`,
+    };
+}
+//# sourceMappingURL=PluginActionRunner.js.map

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

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

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

@@ -0,0 +1,22 @@
+/**
+ * PluginClassRegistry：主动型 plugin 类注册表。
+ */
+import type { AgentRuntime } from "../../core/AgentCoreTypes.js";
+import { BasePlugin } from "../../plugin/core/BasePlugin.js";
+/**
+ * 返回全部已注册内建主动型 plugin 名称。
+ */
+export declare function listRegisteredPluginNames(): string[];
+/**
+ * 返回全部已注册内建主动型 plugin 实例视图。
+ */
+export declare function listRegisteredPlugins(): BasePlugin[];
+/**
+ * 返回无宿主静态 plugin 实例集合。
+ */
+export declare function getRegisteredStaticPluginInstances(): Map<string, BasePlugin>;
+/**
+ * 为当前 agent 创建一组主动型 plugin instances。
+ */
+export declare function createRegisteredPluginInstances(agent: AgentRuntime | null): Map<string, BasePlugin>;
+//# sourceMappingURL=PluginClassRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PluginClassRegistry.d.ts","sourceRoot":"","sources":["../../../src/plugin/core/PluginClassRegistry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAWzD;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,EAAE,CAEpD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,UAAU,EAAE,CAEpD;AAED;;GAEG;AACH,wBAAgB,kCAAkC,IAAI,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAI5E;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,YAAY,GAAG,IAAI,GACzB,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAazB"}

package/bin/plugin/core/PluginClassRegistry.js

@@ -0,0 +1,47 @@
+/**
+ * PluginClassRegistry：主动型 plugin 类注册表。
+ */
+import { BUILTIN_PLUGIN_CLASSES } from "../../plugin/core/BuiltinPluginClasses.js";
+let staticPluginInstances = null;
+function createPluginInstance(PluginClass, agent) {
+    return new PluginClass(agent);
+}
+/**
+ * 返回全部已注册内建主动型 plugin 名称。
+ */
+export function listRegisteredPluginNames() {
+    return BUILTIN_PLUGIN_CLASSES.map((PluginClass) => new PluginClass(null).name);
+}
+/**
+ * 返回全部已注册内建主动型 plugin 实例视图。
+ */
+export function listRegisteredPlugins() {
+    return BUILTIN_PLUGIN_CLASSES.map((PluginClass) => new PluginClass(null));
+}
+/**
+ * 返回无宿主静态 plugin 实例集合。
+ */
+export function getRegisteredStaticPluginInstances() {
+    if (staticPluginInstances)
+        return staticPluginInstances;
+    staticPluginInstances = createRegisteredPluginInstances(null);
+    return staticPluginInstances;
+}
+/**
+ * 为当前 agent 创建一组主动型 plugin instances。
+ */
+export function createRegisteredPluginInstances(agent) {
+    if (agent === null && staticPluginInstances) {
+        return staticPluginInstances;
+    }
+    const plugins = new Map();
+    for (const PluginClass of BUILTIN_PLUGIN_CLASSES) {
+        const plugin = createPluginInstance(PluginClass, agent);
+        plugins.set(plugin.name, plugin);
+    }
+    if (agent === null) {
+        staticPluginInstances = plugins;
+    }
+    return plugins;
+}
+//# sourceMappingURL=PluginClassRegistry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PluginClassRegistry.js","sourceRoot":"","sources":["../../../src/plugin/core/PluginClassRegistry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAG/E,IAAI,qBAAqB,GAAmC,IAAI,CAAC;AAEjE,SAAS,oBAAoB,CAC3B,WAA2D,EAC3D,KAA0B;IAE1B,OAAO,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB;IACvC,OAAO,sBAAsB,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;AACjF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,sBAAsB,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kCAAkC;IAChD,IAAI,qBAAqB;QAAE,OAAO,qBAAqB,CAAC;IACxD,qBAAqB,GAAG,+BAA+B,CAAC,IAAI,CAAC,CAAC;IAC9D,OAAO,qBAAqB,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,+BAA+B,CAC7C,KAA0B;IAE1B,IAAI,KAAK,KAAK,IAAI,IAAI,qBAAqB,EAAE,CAAC;QAC5C,OAAO,qBAAqB,CAAC;IAC/B,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC9C,KAAK,MAAM,WAAW,IAAI,sBAAsB,EAAE,CAAC;QACjD,MAAM,MAAM,GAAG,oBAAoB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,qBAAqB,GAAG,OAAO,CAAC;IAClC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,36 @@
+/**
+ * PluginCommandRequest：统一 runtime plugin command 请求解析模块。
+ *
+ * 关键点（中文）
+ * - 统一收口 HTTP / RPC 两种入口的请求体解析。
+ * - runtime plugin 远程调用统一走 runtime command 协议，不再让 action 自带 HTTP route。
+ * - 通用调度参数（`schedule` / `delay` / `time`）也在这里一次性归一化。
+ */
+import type { JsonValue } from "../../types/common/Json.js";
+import type { PluginCommandScheduleInput } from "../../plugin/types/PluginSchedule.js";
+/**
+ * 统一 runtime plugin command 请求体。
+ */
+export type PluginCommandRequestBody = {
+    /**
+     * 目标 plugin 名称。
+     */
+    pluginName: string;
+    /**
+     * 目标 command / action 名称。
+     */
+    command: string;
+    /**
+     * 结构化 payload。
+     */
+    payload?: JsonValue;
+    /**
+     * 可选调度信息。
+     */
+    schedule?: PluginCommandScheduleInput;
+};
+/**
+ * 解析统一 runtime plugin command 请求体。
+ */
+export declare function parsePluginCommandRequestBody(rawBody: JsonValue | undefined): PluginCommandRequestBody;
+//# sourceMappingURL=PluginCommandRequest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PluginCommandRequest.d.ts","sourceRoot":"","sources":["../../../src/plugin/core/PluginCommandRequest.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAQnF;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB;;OAEG;IACH,QAAQ,CAAC,EAAE,0BAA0B,CAAC;CACvC,CAAC;AAwCF;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,SAAS,GAAG,SAAS,GAC7B,wBAAwB,CAS1B"}

package/bin/plugin/core/PluginCommandRequest.js

@@ -0,0 +1,53 @@
+/**
+ * PluginCommandRequest：统一 runtime plugin command 请求解析模块。
+ *
+ * 关键点（中文）
+ * - 统一收口 HTTP / RPC 两种入口的请求体解析。
+ * - runtime plugin 远程调用统一走 runtime command 协议，不再让 action 自带 HTTP route。
+ * - 通用调度参数（`schedule` / `delay` / `time`）也在这里一次性归一化。
+ */
+import { normalizeRunAtMsOrThrow, parseScheduledRunAtMsOrThrow, } from "../../plugin/core/schedule/Time.js";
+function isJsonRecord(value) {
+    return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+/**
+ * 从统一请求体中提取调度输入。
+ */
+function readScheduleInput(body) {
+    const nestedSchedule = isJsonRecord(body.schedule) ? body.schedule : undefined;
+    const nestedRunAtMs = nestedSchedule?.runAtMs;
+    const topLevelDelay = body.delayMs ?? body.delay;
+    const topLevelTime = body.sendAtMs ?? body.sendAt ?? body.time;
+    if (body.schedule !== undefined && !nestedSchedule) {
+        throw new Error("schedule must be an object");
+    }
+    if (nestedRunAtMs !== undefined && (topLevelDelay !== undefined || topLevelTime !== undefined)) {
+        throw new Error("`schedule.runAtMs` cannot be used together with `delay/time`.");
+    }
+    if (nestedRunAtMs !== undefined) {
+        return {
+            runAtMs: normalizeRunAtMsOrThrow(nestedRunAtMs, "schedule.runAtMs"),
+        };
+    }
+    const runAtMs = parseScheduledRunAtMsOrThrow({
+        delay: topLevelDelay,
+        time: topLevelTime,
+    });
+    if (typeof runAtMs !== "number")
+        return undefined;
+    return { runAtMs };
+}
+/**
+ * 解析统一 runtime plugin command 请求体。
+ */
+export function parsePluginCommandRequestBody(rawBody) {
+    const body = isJsonRecord(rawBody) ? rawBody : {};
+    const schedule = readScheduleInput(body);
+    return {
+        pluginName: String(body.pluginName || "").trim(),
+        command: String(body.command || "").trim(),
+        ...(body.payload !== undefined ? { payload: body.payload } : {}),
+        ...(schedule ? { schedule } : {}),
+    };
+}
+//# sourceMappingURL=PluginCommandRequest.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PluginCommandRequest.js","sourceRoot":"","sources":["../../../src/plugin/core/PluginCommandRequest.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EACL,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,gCAAgC,CAAC;AA0BxC,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,OAAO,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CACxB,IAAgB;IAEhB,MAAM,cAAc,GAAG,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/E,MAAM,aAAa,GAAG,cAAc,EAAE,OAAO,CAAC;IAC9C,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC;IACjD,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC;IAE/D,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,cAAc,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,aAAa,KAAK,SAAS,IAAI,CAAC,aAAa,KAAK,SAAS,IAAI,YAAY,KAAK,SAAS,CAAC,EAAE,CAAC;QAC/F,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACnF,CAAC;IACD,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO;YACL,OAAO,EAAE,uBAAuB,CAC9B,aAA4C,EAC5C,kBAAkB,CACnB;SACF,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,4BAA4B,CAAC;QAC3C,KAAK,EAAE,aAA4C;QACnD,IAAI,EAAE,YAA2C;KAClD,CAAC,CAAC;IACH,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAClD,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAC3C,OAA8B;IAE9B,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAClD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACzC,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;QAChD,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;QAC1C,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAoB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClC,CAAC;AACJ,CAAC"}