@downcity/agent 1.1.287 → 1.1.310

package/bin/plugin/core/PluginActionRunner.js

@@ -1,155 +1,19 @@
 /**
- * PluginActionRunner：plugin command/action 执行模块。
+ * Plugin Action 解析与执行辅助。
  *
- * 关键点（中文）
- * - 新模型中注册即生效，不再要求 plugin 处于 running 状态。
- * - CLI/RPC command 优先解析为同名 action，再处理 plugin 自定义命令。
- * - 延迟调度仍复用本模块，保证 schedule 到点后走统一 action 规则。
+ * 关键点（中文）：Plugin 对外调用协议只有 Action，不再提供 command 兼容层。
  */
-import { ActionScheduleStore } from "../../plugin/core/ActionScheduleStore.js";
-import { normalizeRunAtMsOrThrow } from "../../plugin/core/ActionScheduleTime.js";
-/**
- * 按名称解析 plugin action。
- */
-export function resolvePluginAction(plugin, actionName) {
-    const key = String(actionName || "").trim();
-    if (!key)
-        return null;
-    return plugin.actions?.[key] || null;
+/** 按名称解析一个 Plugin Action。 */
+export function resolve_plugin_action(plugin, action_name) {
+    const key = String(action_name || "").trim();
+    return key ? plugin.actions?.[key] ?? null : null;
 }
-/**
- * 执行一个 plugin action。
- */
-export async function invokePluginAction(params) {
-    return await params.context.plugins.runAction({
-        plugin: params.pluginName,
-        action: params.actionName,
+/** 通过当前 Plugin Registry 执行一个 Action。 */
+export async function invoke_plugin_action(params) {
+    return await params.context.plugins.run_action({
+        plugin: params.plugin_name,
+        action: params.action_name,
         payload: params.payload,
     });
 }
-async function schedulePluginAction(params) {
-    try {
-        const scheduleInput = params.schedule;
-        const runAtMs = normalizeRunAtMsOrThrow(scheduleInput.runAtMs, "schedule.runAtMs");
-        const store = new ActionScheduleStore(params.context.rootPath);
-        try {
-            const job = store.createJob({
-                pluginName: params.pluginName,
-                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 pluginName = String(params.pluginName || "").trim();
-    const command = String(params.command || "")
-        .trim()
-        .toLowerCase();
-    const plugin = params.context.plugins.get(pluginName);
-    const snapshot = params.context.plugins.status(pluginName) || undefined;
-    if (!plugin || !snapshot) {
-        return {
-            success: false,
-            message: `Unknown plugin: ${params.pluginName}`,
-        };
-    }
-    if (!command) {
-        return {
-            success: false,
-            plugin: snapshot,
-            message: "command is required",
-        };
-    }
-    if (command === "status") {
-        return {
-            success: true,
-            plugin: snapshot,
-        };
-    }
-    const action = resolvePluginAction(plugin, command);
-    if (params.schedule !== undefined && params.schedule !== null) {
-        if (!action) {
-            return {
-                success: false,
-                plugin: snapshot,
-                message: `Scheduling only supports plugin actions. "${plugin.name}.${command}" is not a schedulable action.`,
-            };
-        }
-        return await schedulePluginAction({
-            pluginName: plugin.name,
-            command,
-            payload: params.payload,
-            schedule: params.schedule,
-            recordSnapshot: snapshot,
-            context: params.context,
-        });
-    }
-    if (action) {
-        const result = await params.context.plugins.runAction({
-            plugin: plugin.name,
-            action: command,
-            payload: params.payload,
-        });
-        return {
-            success: result.success,
-            plugin: params.context.plugins.status(plugin.name) || snapshot,
-            ...(result.message || result.error
-                ? { message: result.message || result.error }
-                : {}),
-            ...(result.data !== undefined ? { data: result.data } : {}),
-            ...(result.error ? { error: result.error } : {}),
-        };
-    }
-    const handler = plugin.lifecycle?.command;
-    if (handler) {
-        try {
-            const result = await handler({
-                context: params.context,
-                command,
-                payload: params.payload,
-            });
-            return {
-                ...result,
-                plugin: params.context.plugins.status(plugin.name) || snapshot,
-            };
-        }
-        catch (error) {
-            return {
-                success: false,
-                plugin: params.context.plugins.status(plugin.name) || snapshot,
-                message: String(error),
-            };
-        }
-    }
-    return {
-        success: false,
-        plugin: snapshot,
-        message: `Plugin "${plugin.name}" does not implement command "${command}"`,
-    };
-}
 //# sourceMappingURL=PluginActionRunner.js.map

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":"AAAA;;;;GAIG;AAMH,6BAA6B;AAC7B,MAAM,UAAU,qBAAqB,CACnC,MAAwE,EACxE,WAAmB;IAEnB,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,OAAO,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AACpD,CAAC;AAED,wCAAwC;AACxC,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,MAS1C;IACC,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC;QAC7C,MAAM,EAAE,MAAM,CAAC,WAAW;QAC1B,MAAM,EAAE,MAAM,CAAC,WAAW;QAC1B,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC,CAAC;AACL,CAAC"}

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

@@ -8,31 +8,31 @@
  */
 import type { Plugin } from "../../types/plugin/PluginDefinition.js";
 import type { PluginAvailability, PluginView } from "../../types/plugin/PluginRuntime.js";
-import type { AgentContext } from "../../agent/AgentContext.js";
+import type { PluginContext } from "../../types/plugin/PluginContext.js";
 /**
  * 判断 plugin 是否声明了运行时生命周期。
  */
-export declare function hasPluginLifecycle(plugin: Plugin): boolean;
+export declare function has_plugin_lifecycle(plugin: Plugin): boolean;
 /**
  * 过滤出声明了运行时生命周期的 plugin。
  */
-export declare function listPluginsWithLifecycle<T extends Plugin>(plugins: Iterable<T>): T[];
+export declare function list_plugins_with_lifecycle<T extends Plugin>(plugins: Iterable<T>): T[];
 /**
  * 过滤出没有运行时生命周期、可直接执行 action 的 plugin。
  */
-export declare function listPluginsWithoutLifecycle<T extends Plugin>(plugins: Iterable<T>): T[];
+export declare function list_plugins_without_lifecycle<T extends Plugin>(plugins: Iterable<T>): T[];
 /**
  * 按名称查找 plugin。
  */
-export declare function findPluginByName<T extends Plugin>(plugins: Iterable<T>, pluginName: string): T | null;
+export declare function find_plugin_by_name<T extends Plugin>(plugins: Iterable<T>, plugin_name: string): T | null;
 /**
  * 将 plugin 定义转换为目录视图。
  */
-export declare function toPluginView(plugin: Plugin): PluginView;
+export declare function to_plugin_view(plugin: Plugin): PluginView;
 /**
  * 列出 plugin 目录视图。
  */
-export declare function listPluginViews(plugins: Iterable<Plugin>): PluginView[];
+export declare function list_plugin_views(plugins: Iterable<Plugin>): PluginView[];
 /**
  * 构建 plugin 可用性视图。
  *
@@ -40,18 +40,18 @@ export declare function listPluginViews(plugins: Iterable<Plugin>): PluginView[]
  * - 传入 context 时会调用 plugin 自己的 availability。
  * - 未传 context 时只返回静态目录说明，适合 Console 或 CLI 的目录回退展示。
  */
-export declare function resolvePluginAvailability(params: {
+export declare function resolve_plugin_availability(params: {
     plugins: Iterable<Plugin>;
-    pluginName: string;
-    context?: AgentContext;
+    plugin_name: string;
+    context?: PluginContext;
     agentError?: string;
 }): Promise<PluginAvailability>;
 /**
  * 同步构建静态 plugin 可用性视图。
  */
-export declare function buildStaticPluginAvailability(params: {
+export declare function build_static_plugin_availability(params: {
     plugins: Iterable<Plugin>;
-    pluginName: string;
+    plugin_name: string;
     agentError?: string;
 }): PluginAvailability;
 //# sourceMappingURL=PluginCatalog.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"PluginCatalog.d.ts","sourceRoot":"","sources":["../../../src/plugin/core/PluginCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D;;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,CA8B9B;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,CAkBrB"}
+{"version":3,"file":"PluginCatalog.d.ts","sourceRoot":"","sources":["../../../src/plugin/core/PluginCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAErE;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAEvF;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAE1F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,EAClD,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,EACpB,WAAW,EAAE,MAAM,GAClB,CAAC,GAAG,IAAI,CAIV;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAuBzD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,UAAU,EAAE,CAIzE;AAED;;;;;;GAMG;AACH,wBAAsB,2BAA2B,CAAC,MAAM,EAAE;IACxD,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA8B9B;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE;IACvD,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,kBAAkB,CAkBrB"}

package/bin/plugin/core/PluginCatalog.js

@@ -9,26 +9,26 @@
 /**
  * 判断 plugin 是否声明了运行时生命周期。
  */
-export function hasPluginLifecycle(plugin) {
+export function has_plugin_lifecycle(plugin) {
     return Boolean(plugin.lifecycle);
 }
 /**
  * 过滤出声明了运行时生命周期的 plugin。
  */
-export function listPluginsWithLifecycle(plugins) {
-    return [...plugins].filter((plugin) => hasPluginLifecycle(plugin));
+export function list_plugins_with_lifecycle(plugins) {
+    return [...plugins].filter((plugin) => has_plugin_lifecycle(plugin));
 }
 /**
  * 过滤出没有运行时生命周期、可直接执行 action 的 plugin。
  */
-export function listPluginsWithoutLifecycle(plugins) {
-    return [...plugins].filter((plugin) => !hasPluginLifecycle(plugin));
+export function list_plugins_without_lifecycle(plugins) {
+    return [...plugins].filter((plugin) => !has_plugin_lifecycle(plugin));
 }
 /**
  * 按名称查找 plugin。
  */
-export function findPluginByName(plugins, pluginName) {
-    const key = String(pluginName || "").trim();
+export function find_plugin_by_name(plugins, plugin_name) {
+    const key = String(plugin_name || "").trim();
     if (!key)
         return null;
     return [...plugins].find((plugin) => plugin.name === key) || null;
@@ -36,7 +36,7 @@ export function findPluginByName(plugins, pluginName) {
 /**
  * 将 plugin 定义转换为目录视图。
  */
-export function toPluginView(plugin) {
+export function to_plugin_view(plugin) {
     return {
         name: plugin.name,
         title: String(plugin.title || plugin.name || "").trim(),
@@ -46,16 +46,16 @@ export function toPluginView(plugin) {
         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",
+        has_system: typeof plugin.system === "function",
+        has_availability: typeof plugin.availability === "function",
     };
 }
 /**
  * 列出 plugin 目录视图。
  */
-export function listPluginViews(plugins) {
+export function list_plugin_views(plugins) {
     return [...plugins]
-        .map((plugin) => toPluginView(plugin))
+        .map((plugin) => to_plugin_view(plugin))
         .sort((left, right) => left.name.localeCompare(right.name));
 }
 /**
@@ -65,13 +65,13 @@ export function listPluginViews(plugins) {
  * - 传入 context 时会调用 plugin 自己的 availability。
  * - 未传 context 时只返回静态目录说明，适合 Console 或 CLI 的目录回退展示。
  */
-export async function resolvePluginAvailability(params) {
-    const plugin = findPluginByName(params.plugins, params.pluginName);
+export async function resolve_plugin_availability(params) {
+    const plugin = find_plugin_by_name(params.plugins, params.plugin_name);
     if (!plugin) {
         return {
             enabled: false,
             available: false,
-            reasons: [`Unknown plugin: ${params.pluginName}`],
+            reasons: [`Unknown plugin: ${params.plugin_name}`],
         };
     }
     if (params.context && plugin.availability) {
@@ -96,13 +96,13 @@ export async function resolvePluginAvailability(params) {
 /**
  * 同步构建静态 plugin 可用性视图。
  */
-export function buildStaticPluginAvailability(params) {
-    const plugin = findPluginByName(params.plugins, params.pluginName);
+export function build_static_plugin_availability(params) {
+    const plugin = find_plugin_by_name(params.plugins, params.plugin_name);
     if (!plugin) {
         return {
             enabled: false,
             available: false,
-            reasons: [`Unknown plugin: ${params.pluginName}`],
+            reasons: [`Unknown plugin: ${params.plugin_name}`],
         };
     }
     const agentReason = String(params.agentError || "").trim();

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

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

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

@@ -0,0 +1,32 @@
+/**
+ * PluginContext 工厂：构造 Agent 向 Plugin 投影的只读能力视图。
+ *
+ * 关键点（中文）
+ * - 固定能力直接引用唯一实例。
+ * - env 与 instruction 使用 getter 延迟读取，避免复制可变状态。
+ */
+import type { PluginContext } from "../../types/plugin/PluginContext.js";
+/** PluginContext 工厂输入。 */
+export interface CreatePluginContextInput {
+    /** 当前 Agent 稳定标识。 */
+    agent_id: PluginContext["agent_id"];
+    /** 当前 Workspace 绝对根目录。 */
+    workspace_path: PluginContext["workspace_path"];
+    /** 当前 Workspace 文件能力。 */
+    files: PluginContext["files"];
+    /** 当前 Workspace 可选 Shell。 */
+    shell?: PluginContext["shell"];
+    /** 当前 Agent 日志器。 */
+    logger: PluginContext["logger"];
+    /** 当前 Agent Session 集合。 */
+    sessions: PluginContext["sessions"];
+    /** 当前 Agent Plugin 注册表视图。 */
+    plugins: PluginContext["plugins"];
+    /** 延迟读取 Workspace env。 */
+    get_workspace_env: () => PluginContext["workspace_env"];
+    /** 延迟读取 Agent instruction。 */
+    get_instructions: () => PluginContext["instructions"];
+}
+/** 创建一个不复制动态状态的 PluginContext。 */
+export declare function create_plugin_context(input: CreatePluginContextInput): PluginContext;
+//# sourceMappingURL=PluginContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PluginContext.d.ts","sourceRoot":"","sources":["../../../src/plugin/core/PluginContext.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAErE,0BAA0B;AAC1B,MAAM,WAAW,wBAAwB;IACvC,qBAAqB;IACrB,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACpC,0BAA0B;IAC1B,cAAc,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAChD,yBAAyB;IACzB,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAC9B,6BAA6B;IAC7B,KAAK,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAC/B,oBAAoB;IACpB,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChC,2BAA2B;IAC3B,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACpC,6BAA6B;IAC7B,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IAClC,0BAA0B;IAC1B,iBAAiB,EAAE,MAAM,aAAa,CAAC,eAAe,CAAC,CAAC;IACxD,8BAA8B;IAC9B,gBAAgB,EAAE,MAAM,aAAa,CAAC,cAAc,CAAC,CAAC;CACvD;AAED,kCAAkC;AAClC,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,wBAAwB,GAC9B,aAAa,CAgBf"}

package/bin/plugin/core/PluginContext.js

@@ -0,0 +1,26 @@
+/**
+ * PluginContext 工厂：构造 Agent 向 Plugin 投影的只读能力视图。
+ *
+ * 关键点（中文）
+ * - 固定能力直接引用唯一实例。
+ * - env 与 instruction 使用 getter 延迟读取，避免复制可变状态。
+ */
+/** 创建一个不复制动态状态的 PluginContext。 */
+export function create_plugin_context(input) {
+    return Object.freeze({
+        agent_id: input.agent_id,
+        workspace_path: input.workspace_path,
+        files: input.files,
+        ...(input.shell ? { shell: input.shell } : {}),
+        logger: input.logger,
+        sessions: input.sessions,
+        plugins: input.plugins,
+        get workspace_env() {
+            return input.get_workspace_env();
+        },
+        get instructions() {
+            return input.get_instructions();
+        },
+    });
+}
+//# sourceMappingURL=PluginContext.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PluginContext.js","sourceRoot":"","sources":["../../../src/plugin/core/PluginContext.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA0BH,kCAAkC;AAClC,MAAM,UAAU,qBAAqB,CACnC,KAA+B;IAE/B,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,aAAa;YACf,OAAO,KAAK,CAAC,iBAAiB,EAAE,CAAC;QACnC,CAAC;QACD,IAAI,YAAY;YACd,OAAO,KAAK,CAAC,gBAAgB,EAAE,CAAC;QAClC,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

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

@@ -7,18 +7,18 @@
  */
 import type { Hono } from "hono";
 import type { Plugin } from "../../types/plugin/PluginDefinition.js";
-import type { AgentContext } from "../../agent/AgentContext.js";
-import type { AuthRoutePolicy } from "../../types/runtime/auth/AuthRoute.js";
+import type { PluginContext } from "../../types/plugin/PluginContext.js";
+import type { AuthRoutePolicy } from "@downcity/type";
 /**
  * 收集全部 plugin HTTP 鉴权策略。
  */
-export declare function listPluginAuthPolicies(plugins: Iterable<Plugin>): AuthRoutePolicy[];
+export declare function list_plugin_auth_policies(plugins: Iterable<Plugin>): AuthRoutePolicy[];
 /**
  * 注册全部 plugin HTTP 路由。
  */
-export declare function registerPluginHttpRoutes(params: {
+export declare function register_plugin_http_routes(params: {
     app: Hono;
-    getContext: () => AgentContext;
+    get_context: () => PluginContext;
     plugins: Iterable<Plugin>;
 }): void;
 //# sourceMappingURL=PluginHttpRoutes.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"PluginHttpRoutes.d.ts","sourceRoot":"","sources":["../../../src/plugin/core/PluginHttpRoutes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAWzE;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,eAAe,EAAE,CAInF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C,GAAG,EAAE,IAAI,CAAC;IACV,UAAU,EAAE,MAAM,YAAY,CAAC;IAC/B,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;CAC3B,GAAG,IAAI,CAQP"}
+{"version":3,"file":"PluginHttpRoutes.d.ts","sourceRoot":"","sources":["../../../src/plugin/core/PluginHttpRoutes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAWtD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,eAAe,EAAE,CAItF;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IAClD,GAAG,EAAE,IAAI,CAAC;IACV,WAAW,EAAE,MAAM,aAAa,CAAC;IACjC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;CAC3B,GAAG,IAAI,CAQP"}

package/bin/plugin/core/PluginHttpRoutes.js

@@ -17,18 +17,18 @@ function dedupeAuthPolicies(policies) {
 /**
  * 收集全部 plugin HTTP 鉴权策略。
  */
-export function listPluginAuthPolicies(plugins) {
-    return dedupeAuthPolicies([...plugins].flatMap((plugin) => plugin.http?.server?.authPolicies || []));
+export function list_plugin_auth_policies(plugins) {
+    return dedupeAuthPolicies([...plugins].flatMap((plugin) => plugin.http?.server?.auth_policies || []));
 }
 /**
  * 注册全部 plugin HTTP 路由。
  */
-export function registerPluginHttpRoutes(params) {
+export function register_plugin_http_routes(params) {
     for (const plugin of params.plugins) {
         plugin.http?.server?.register({
             app: params.app,
-            getContext: params.getContext,
-            pluginName: plugin.name,
+            get_context: params.get_context,
+            plugin_name: plugin.name,
         });
     }
 }

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

@@ -1 +1 @@
-{"version":3,"file":"PluginHttpRoutes.js","sourceRoot":"","sources":["../../../src/plugin/core/PluginHttpRoutes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,SAAS,kBAAkB,CAAC,QAA2B;IACrD,MAAM,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAC;IACnD,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACvG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAyB;IAC9D,OAAO,kBAAkB,CACvB,CAAC,GAAG,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,IAAI,EAAE,CAAC,CAC1E,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAIxC;IACC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACpC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC;YAC5B,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,UAAU,EAAE,MAAM,CAAC,IAAI;SACxB,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}
+{"version":3,"file":"PluginHttpRoutes.js","sourceRoot":"","sources":["../../../src/plugin/core/PluginHttpRoutes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,SAAS,kBAAkB,CAAC,QAA2B;IACrD,MAAM,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAC;IACnD,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACvG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAyB;IACjE,OAAO,kBAAkB,CACvB,CAAC,GAAG,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,IAAI,EAAE,CAAC,CAC3E,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAI3C;IACC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACpC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC;YAC5B,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,WAAW,EAAE,MAAM,CAAC,IAAI;SACzB,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}