@downcity/agent 1.1.195 → 1.1.198

package/src/executor/tools/plugin/PluginToolDefinition.ts

@@ -12,42 +12,59 @@ import type {
   PluginCallInput,
   PluginReadInput,
 } from "@/executor/tools/plugin/types/PluginTool.js";
+import type {
+  AgentPluginTools,
+  CreatePluginToolsOptions,
+} from "@/types/plugin/PluginToolRuntime.js";
 import {
   invokePluginCallTool,
   invokePluginReadTool,
-  setPluginToolRuntime,
 } from "./PluginToolBridge.js";
 import {
   plugin_call_input_schema,
   plugin_read_input_schema,
 } from "./PluginToolSchemas.js";
 
-export { setPluginToolRuntime } from "./PluginToolBridge.js";
-
 /**
- * `plugin_call`：调用已注册 plugin action。
+ * 创建 `plugin_call`：调用当前 Agent 已注册 plugin action。
  */
-export const plugin_call = tool({
-  description:
-    "Call a registered agent plugin action. Use plugin_read first when you need the action list, input schema, or examples. Generated files may be attached to the final assistant message automatically.",
-  inputSchema: plugin_call_input_schema,
-  execute: async (input) => await invokePluginCallTool(input as PluginCallInput),
-});
+export function createPluginCallTool(options: CreatePluginToolsOptions) {
+  return tool({
+    description:
+      "Call a registered agent plugin action. Use plugin_read first when you need the action list, input schema, or examples. Generated files may be attached to the final assistant message automatically.",
+    inputSchema: plugin_call_input_schema,
+    execute: async (input) =>
+      await invokePluginCallTool({
+        plugins: options.plugins,
+        input: input as PluginCallInput,
+      }),
+  });
+}
 
 /**
- * `plugin_read`：读取已注册 plugin / action metadata。
+ * 创建 `plugin_read`：读取当前 Agent 已注册 plugin / action metadata。
  */
-export const plugin_read = tool({
-  description:
-    "Read registered agent plugin metadata, including action names, descriptions, input schemas, and examples. Use this before plugin_call when the payload shape is unclear.",
-  inputSchema: plugin_read_input_schema,
-  execute: async (input) => await invokePluginReadTool(input as PluginReadInput),
-});
+export function createPluginReadTool(options: CreatePluginToolsOptions) {
+  return tool({
+    description:
+      "Read registered agent plugin metadata, including action names, descriptions, input schemas, and examples. Use this before plugin_call when the payload shape is unclear.",
+    inputSchema: plugin_read_input_schema,
+    execute: async (input) =>
+      await invokePluginReadTool({
+        plugins: options.plugins,
+        input: input as PluginReadInput,
+      }),
+  });
+}
 
 /**
- * Plugin 工具导出集合。
+ * 创建当前 Agent 专属 Plugin 工具集合。
  */
-export const plugin_tools = {
-  plugin_call,
-  plugin_read,
-};
+export function createPluginTools(
+  options: CreatePluginToolsOptions,
+): AgentPluginTools {
+  return {
+    plugin_call: createPluginCallTool(options),
+    plugin_read: createPluginReadTool(options),
+  };
+}

package/src/plugin/core/PluginRegistry.ts

@@ -522,12 +522,8 @@ export class PluginRegistry implements AgentPlugins {
         pluginName: record.plugin.name,
         actionName,
       });
-      if (!result.success) {
-        update_record_state(record, "error", result.error || result.message);
-      }
       return result;
     } catch (error) {
-      update_record_state(record, "error", String(error));
       return {
         success: false,
         error: String(error),

package/src/types/plugin/PluginToolRuntime.ts

@@ -0,0 +1,86 @@
+/**
+ * Plugin tool runtime 绑定类型。
+ *
+ * 关键点（中文）
+ * - plugin_call / plugin_read 必须绑定当前 Agent 自己的 plugin registry。
+ * - 这些类型描述 tool 工厂与 bridge 调用时需要的显式 runtime 依赖。
+ */
+
+import type { Tool } from "ai";
+import type { AgentPlugins } from "@/types/plugin/PluginRuntime.js";
+import type {
+  PluginCallInput,
+  PluginReadInput,
+} from "@/executor/tools/plugin/types/PluginTool.js";
+
+/**
+ * 创建 plugin tools 的参数。
+ */
+export interface CreatePluginToolsOptions {
+  /**
+   * 当前 Agent 自己的 plugin 调用面。
+   *
+   * 关键点（中文）
+   * - 该引用必须来自当前 Agent 装配出的 plugin registry。
+   * - tool 执行时只能通过它访问 plugin，避免跨 Agent 读到其他 registry。
+   */
+  plugins: AgentPlugins;
+}
+
+/**
+ * 当前 Agent 专属 plugin tools。
+ */
+export interface AgentPluginTools {
+  /**
+   * 读取 plugin metadata 的模型工具。
+   *
+   * 关键点（中文）
+   * - 该 tool 通过闭包绑定当前 Agent 的 `plugins`。
+   * - 不读取任何模块级全局 runtime。
+   */
+  plugin_read: Tool;
+
+  /**
+   * 执行 plugin action 的模型工具。
+   *
+   * 关键点（中文）
+   * - 该 tool 通过闭包绑定当前 Agent 的 `plugins`。
+   * - 多 Agent 并发时，每个 Agent 都有自己的 tool 实例。
+   */
+  plugin_call: Tool;
+}
+
+/**
+ * 调用 plugin_call bridge 的参数。
+ */
+export interface InvokePluginCallToolOptions {
+  /**
+   * 当前 Agent 自己的 plugin 调用面。
+   *
+   * 关键点（中文）
+   * - 由 Agent 级 tool 工厂注入。
+   * - 不能在 bridge 内通过全局变量读取。
+   */
+  plugins: AgentPlugins;
+
+  /**
+   * 模型提交给 plugin_call 的结构化输入。
+   */
+  input: PluginCallInput;
+}
+
+/**
+ * 调用 plugin_read bridge 的参数。
+ */
+export interface InvokePluginReadToolOptions {
+  /**
+   * 当前 Agent 自己的 plugin 调用面。
+   */
+  plugins: AgentPlugins;
+
+  /**
+   * 模型提交给 plugin_read 的结构化输入。
+   */
+  input: PluginReadInput;
+}
+