@agenticforge/tools 1.0.0

package/dist/cjs/index.cjs

@@ -0,0 +1,341 @@
+'use strict';
+
+require('reflect-metadata');
+var zod = require('zod');
+
+var __defProp$3 = Object.defineProperty;
+var __defNormalProp$3 = (obj, key, value) => key in obj ? __defProp$3(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$3 = (obj, key, value) => __defNormalProp$3(obj, typeof key !== "symbol" ? key + "" : key, value);
+const TOOL_ACTIONS_META_KEY = /* @__PURE__ */ Symbol("tool:actions");
+function toolAction(key, description) {
+  return function(target, propertyKey, _descriptor) {
+    const existing = Reflect.getMetadata(TOOL_ACTIONS_META_KEY, target) ?? [];
+    existing.push({ key, description, method: propertyKey });
+    Reflect.defineMetadata(TOOL_ACTIONS_META_KEY, existing, target);
+  };
+}
+class Tool {
+  constructor(name, description, expandable = false) {
+    __publicField$3(this, "name");
+    __publicField$3(this, "description");
+    __publicField$3(this, "expandable");
+    this.name = name;
+    this.description = description;
+    this.expandable = expandable;
+  }
+  /**
+   * Validate that required parameters are present and have basic types.
+   * Returns true if valid.
+   */
+  validateParameters(parameters) {
+    const params = this.getParameters();
+    for (const p of params) {
+      if (p.required && (parameters[p.name] === void 0 || parameters[p.name] === null)) {
+        return false;
+      }
+    }
+    return true;
+  }
+  /**
+   * Validate and coerce parameters, returning a Result object.
+   */
+  validateAndNormalizeParameters(parameters) {
+    const params = this.getParameters();
+    const data = {};
+    for (const p of params) {
+      const val = parameters[p.name];
+      if (val === void 0 || val === null) {
+        if (p.required) {
+          return { success: false, error: `Missing required parameter: ${p.name}` };
+        }
+        data[p.name] = p.default;
+      } else {
+        data[p.name] = val;
+      }
+    }
+    for (const [key, val] of Object.entries(parameters)) {
+      if (!(key in data)) data[key] = val;
+    }
+    return { success: true, data };
+  }
+  /**
+   * Convert this Tool to an OpenAI function-calling schema.
+   */
+  toOpenAISchema() {
+    const params = this.getParameters();
+    const properties = {};
+    const required = [];
+    for (const p of params) {
+      properties[p.name] = {
+        type: mapType(p.type),
+        description: p.description,
+        ...p.default !== null && p.default !== void 0 ? { default: p.default } : {}
+      };
+      if (p.required) required.push(p.name);
+    }
+    return {
+      type: "function",
+      function: {
+        name: this.name,
+        description: this.description,
+        parameters: {
+          type: "object",
+          properties,
+          ...required.length > 0 ? { required } : {}
+        }
+      }
+    };
+  }
+  /**
+   * Return a formatted description of all available tool actions (for system prompt).
+   */
+  describe() {
+    const params = this.getParameters();
+    const paramStr = params.map(
+      (p) => `  - ${p.name} (${p.type}${p.required ? ", required" : ""}): ${p.description}`
+    ).join("\n");
+    return `Tool: ${this.name}
+Description: ${this.description}
+Parameters:
+${paramStr}`;
+  }
+}
+function mapType(type) {
+  const t = (type ?? "string").toLowerCase();
+  if (["string", "number", "integer", "boolean", "array", "object"].includes(t)) {
+    return t;
+  }
+  return "string";
+}
+function defineFunctionTool(options) {
+  return options;
+}
+
+var __defProp$2 = Object.defineProperty;
+var __defNormalProp$2 = (obj, key, value) => key in obj ? __defProp$2(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$2 = (obj, key, value) => __defNormalProp$2(obj, typeof key !== "symbol" ? key + "" : key, value);
+class ToolChain {
+  constructor(name, description) {
+    __publicField$2(this, "name");
+    __publicField$2(this, "description");
+    __publicField$2(this, "steps", []);
+    this.name = name;
+    this.description = description;
+  }
+  addStep(toolName, inputTemplate, outputKey) {
+    this.steps.push({ toolName, inputTemplate, outputKey });
+    return this;
+  }
+  getSteps() {
+    return [...this.steps];
+  }
+  /**
+   * Execute the chain against a registry.
+   * @param registry  ToolRegistry that holds the referenced tools.
+   * @param input     Initial `{input}` value.
+   * @returns         The value stored under the last step's outputKey.
+   */
+  async execute(registry, input) {
+    const context = { input };
+    for (const step of this.steps) {
+      const resolvedInput = interpolate(step.inputTemplate, context);
+      const result = await registry.execute(step.toolName, { input: resolvedInput });
+      context[step.outputKey] = result;
+    }
+    const lastStep = this.steps[this.steps.length - 1];
+    if (!lastStep) return input;
+    return context[lastStep.outputKey] ?? input;
+  }
+}
+class ToolChainManager {
+  constructor(registry) {
+    __publicField$2(this, "chains", /* @__PURE__ */ new Map());
+    __publicField$2(this, "registry");
+    this.registry = registry;
+  }
+  registerChain(chain) {
+    this.chains.set(chain.name, chain);
+  }
+  getChain(name) {
+    return this.chains.get(name);
+  }
+  listChains() {
+    return Array.from(this.chains.keys());
+  }
+  async executeChain(chainName, input) {
+    const chain = this.chains.get(chainName);
+    if (!chain) throw new Error(`ToolChain not found: ${chainName}`);
+    return chain.execute(this.registry, input);
+  }
+}
+function interpolate(template, context) {
+  return template.replace(/\{(\w+)\}/g, (_match, key) => {
+    return context[key] ?? `{${key}}`;
+  });
+}
+
+var __defProp$1 = Object.defineProperty;
+var __defNormalProp$1 = (obj, key, value) => key in obj ? __defProp$1(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$1 = (obj, key, value) => __defNormalProp$1(obj, typeof key !== "symbol" ? key + "" : key, value);
+class ToolRegistry {
+  constructor() {
+    __publicField$1(this, "tools", /* @__PURE__ */ new Map());
+    __publicField$1(this, "functions", /* @__PURE__ */ new Map());
+  }
+  // ---------------------------------------------------------------------------
+  // Registration
+  // ---------------------------------------------------------------------------
+  registerTool(tool) {
+    this.tools.set(tool.name, tool);
+  }
+  unregisterTool(name) {
+    return this.tools.delete(name);
+  }
+  registerFunction(name, description, func, schema) {
+    this.functions.set(name, {
+      name,
+      description,
+      func,
+      schema
+    });
+  }
+  unregisterFunction(name) {
+    return this.functions.delete(name);
+  }
+  // ---------------------------------------------------------------------------
+  // Lookup
+  // ---------------------------------------------------------------------------
+  getTool(name) {
+    return this.tools.get(name);
+  }
+  getFunction(name) {
+    return this.functions.get(name);
+  }
+  getAllTools() {
+    return Array.from(this.tools.values());
+  }
+  listTools() {
+    return [
+      ...Array.from(this.tools.keys()),
+      ...Array.from(this.functions.keys())
+    ];
+  }
+  hasTool(name) {
+    return this.tools.has(name) || this.functions.has(name);
+  }
+  // ---------------------------------------------------------------------------
+  // Execution
+  // ---------------------------------------------------------------------------
+  async execute(name, parameters) {
+    const tool = this.tools.get(name);
+    if (tool) {
+      return await tool.run(parameters);
+    }
+    const fn = this.functions.get(name);
+    if (fn) {
+      return await fn.func(parameters);
+    }
+    throw new Error(`Tool not found: ${name}`);
+  }
+  // ---------------------------------------------------------------------------
+  // Description (for system prompts)
+  // ---------------------------------------------------------------------------
+  getAvailableTools() {
+    const lines = [];
+    for (const tool of this.tools.values()) {
+      lines.push(tool.describe());
+    }
+    for (const fn of this.functions.values()) {
+      lines.push(`Tool: ${fn.name}
+Description: ${fn.description}`);
+    }
+    if (lines.length === 0) return "\u6682\u65E0\u53EF\u7528\u5DE5\u5177";
+    return lines.join("\n\n");
+  }
+  getOpenAISchemas() {
+    const schemas = [];
+    for (const tool of this.tools.values()) {
+      schemas.push(tool.toOpenAISchema());
+    }
+    for (const fn of this.functions.values()) {
+      schemas.push({
+        type: "function",
+        function: {
+          name: fn.name,
+          description: fn.description,
+          parameters: {
+            type: "object",
+            properties: {
+              input: { type: "string", description: "\u8F93\u5165\u6587\u672C" }
+            }
+          }
+        }
+      });
+    }
+    return schemas;
+  }
+}
+
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+class AsyncToolExecutor {
+  constructor(registry, concurrency = 4) {
+    __publicField(this, "registry");
+    __publicField(this, "concurrency");
+    this.registry = registry;
+    this.concurrency = Math.max(1, concurrency);
+  }
+  /**
+   * Execute a batch of tool calls with bounded concurrency.
+   */
+  async executeBatch(requests) {
+    const results = [];
+    let idx = 0;
+    const worker = async () => {
+      while (idx < requests.length) {
+        const req = requests[idx++];
+        results.push(await this.executeSingle(req));
+      }
+    };
+    const workers = Array.from({ length: Math.min(this.concurrency, requests.length) }, worker);
+    await Promise.all(workers);
+    return results;
+  }
+  /**
+   * Execute a single tool call.
+   */
+  async executeSingle(request) {
+    const start = Date.now();
+    try {
+      const output = await this.registry.execute(request.toolName, request.parameters);
+      return {
+        id: request.id,
+        toolName: request.toolName,
+        output,
+        durationMs: Date.now() - start
+      };
+    } catch (error) {
+      return {
+        id: request.id,
+        toolName: request.toolName,
+        output: "",
+        error: error instanceof Error ? error.message : String(error),
+        durationMs: Date.now() - start
+      };
+    }
+  }
+}
+
+Object.defineProperty(exports, "z", {
+  enumerable: true,
+  get: function () { return zod.z; }
+});
+exports.AsyncToolExecutor = AsyncToolExecutor;
+exports.Tool = Tool;
+exports.ToolChain = ToolChain;
+exports.ToolChainManager = ToolChainManager;
+exports.ToolRegistry = ToolRegistry;
+exports.defineFunctionTool = defineFunctionTool;
+exports.toolAction = toolAction;
+//# sourceMappingURL=index.cjs.map

package/dist/cjs/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../../src/Tool.ts","../../src/ToolChain.ts","../../src/ToolRegistry.ts","../../src/AsyncToolExecutor.ts"],"sourcesContent":["import \"reflect-metadata\";\nimport {z, type ZodType} from \"zod\";\nimport type {ToolParameter} from \"./types\";\n\nexport type {ToolParameter};\n\n// ---------------------------------------------------------------------------\n// OpenAI function-calling schema\n// ---------------------------------------------------------------------------\n\nexport interface OpenAIFunctionSchema {\n  type: \"function\";\n  function: {\n    name: string;\n    description: string;\n    parameters: Record<string, unknown>;\n  };\n}\n\n// ---------------------------------------------------------------------------\n// toolAction decorator\n// ---------------------------------------------------------------------------\n\nconst TOOL_ACTIONS_META_KEY = Symbol(\"tool:actions\");\n\nexport interface ToolActionMeta {\n  key: string;\n  description: string;\n  method: string;\n}\n\n/**\n * Decorator that registers a method as a named tool action.\n * Usage: @toolAction(\"action_key\", \"Description\")\n */\nexport function toolAction(key: string, description: string) {\n  return function (\n    target: object,\n    propertyKey: string,\n    _descriptor: PropertyDescriptor,\n  ): void {\n    const existing: ToolActionMeta[] =\n      Reflect.getMetadata(TOOL_ACTIONS_META_KEY, target) ?? [];\n    existing.push({key, description, method: propertyKey});\n    Reflect.defineMetadata(TOOL_ACTIONS_META_KEY, existing, target);\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Tool base class\n// ---------------------------------------------------------------------------\n\nexport abstract class Tool {\n  readonly name: string;\n  readonly description: string;\n  readonly expandable: boolean;\n\n  constructor(name: string, description: string, expandable = false) {\n    this.name = name;\n    this.description = description;\n    this.expandable = expandable;\n  }\n\n  abstract run(parameters: Record<string, unknown>): Promise<string> | string;\n  abstract getParameters(): ToolParameter[];\n\n  /**\n   * Validate that required parameters are present and have basic types.\n   * Returns true if valid.\n   */\n  validateParameters(parameters: Record<string, unknown>): boolean {\n    const params = this.getParameters();\n    for (const p of params) {\n      if (p.required && (parameters[p.name] === undefined || parameters[p.name] === null)) {\n        return false;\n      }\n    }\n    return true;\n  }\n\n  /**\n   * Validate and coerce parameters, returning a Result object.\n   */\n  validateAndNormalizeParameters(\n    parameters: Record<string, unknown>,\n  ): {success: true; data: Record<string, unknown>} | {success: false; error: string} {\n    const params = this.getParameters();\n    const data: Record<string, unknown> = {};\n\n    for (const p of params) {\n      const val = parameters[p.name];\n      if (val === undefined || val === null) {\n        if (p.required) {\n          return {success: false, error: `Missing required parameter: ${p.name}`};\n        }\n        data[p.name] = p.default;\n      } else {\n        data[p.name] = val;\n      }\n    }\n\n    // pass through any extra parameters\n    for (const [key, val] of Object.entries(parameters)) {\n      if (!(key in data)) data[key] = val;\n    }\n\n    return {success: true, data};\n  }\n\n  /**\n   * Convert this Tool to an OpenAI function-calling schema.\n   */\n  toOpenAISchema(): OpenAIFunctionSchema {\n    const params = this.getParameters();\n    const properties: Record<string, unknown> = {};\n    const required: string[] = [];\n\n    for (const p of params) {\n      properties[p.name] = {\n        type: mapType(p.type),\n        description: p.description,\n        ...(p.default !== null && p.default !== undefined\n          ? {default: p.default}\n          : {}),\n      };\n      if (p.required) required.push(p.name);\n    }\n\n    return {\n      type: \"function\",\n      function: {\n        name: this.name,\n        description: this.description,\n        parameters: {\n          type: \"object\",\n          properties,\n          ...(required.length > 0 ? {required} : {}),\n        },\n      },\n    };\n  }\n\n  /**\n   * Return a formatted description of all available tool actions (for system prompt).\n   */\n  describe(): string {\n    const params = this.getParameters();\n    const paramStr = params\n      .map(\n        (p) =>\n          `  - ${p.name} (${p.type}${p.required ? \", required\" : \"\"}): ${p.description}`,\n      )\n      .join(\"\\n\");\n    return `Tool: ${this.name}\\nDescription: ${this.description}\\nParameters:\\n${paramStr}`;\n  }\n}\n\nfunction mapType(type: string): string {\n  const t = (type ?? \"string\").toLowerCase();\n  if ([\"string\", \"number\", \"integer\", \"boolean\", \"array\", \"object\"].includes(t)) {\n    return t;\n  }\n  return \"string\";\n}\n\n// ---------------------------------------------------------------------------\n// FunctionTool — wraps a plain async/sync function\n// ---------------------------------------------------------------------------\n\nexport interface FunctionTool<TArgs = Record<string, unknown>> {\n  name: string;\n  description: string;\n  func: (args: TArgs) => string | Promise<string>;\n  schema?: ZodType<TArgs>;\n}\n\n/**\n * Convenience factory for creating type-safe function tools.\n *\n * ```ts\n * const myTool = defineFunctionTool({\n *   name: \"myTool\",\n *   description: \"...\",\n *   schema: z.object({ input: z.string() }),\n *   func: ({ input }) => input.toUpperCase(),\n * });\n * ```\n */\nexport function defineFunctionTool<TArgs extends Record<string, unknown>>(\n  options: FunctionTool<TArgs>,\n): FunctionTool<TArgs> {\n  return options;\n}\n\nexport {z};\n","import {ToolRegistry} from \"./ToolRegistry\";\n\n// ---------------------------------------------------------------------------\n// ToolChain step definition\n// ---------------------------------------------------------------------------\n\nexport interface ToolChainStep {\n  /** Name of the tool/function to call */\n  toolName: string;\n  /** Input template string; use {variableName} to reference context variables */\n  inputTemplate: string;\n  /** Key under which the step output is stored in context */\n  outputKey: string;\n}\n\n// ---------------------------------------------------------------------------\n// ToolChain\n// ---------------------------------------------------------------------------\n\n/**\n * A sequential chain of tool steps.\n * Each step can reference outputs of prior steps via `{key}` placeholders.\n *\n * ```ts\n * const chain = new ToolChain(\"my_chain\", \"Does X then Y\");\n * chain.addStep(\"search\", \"{input}\", \"search_result\");\n * chain.addStep(\"summarize\", \"{search_result}\", \"summary\");\n * ```\n */\nexport class ToolChain {\n  readonly name: string;\n  readonly description: string;\n  private readonly steps: ToolChainStep[] = [];\n\n  constructor(name: string, description: string) {\n    this.name = name;\n    this.description = description;\n  }\n\n  addStep(toolName: string, inputTemplate: string, outputKey: string): this {\n    this.steps.push({toolName, inputTemplate, outputKey});\n    return this;\n  }\n\n  getSteps(): ToolChainStep[] {\n    return [...this.steps];\n  }\n\n  /**\n   * Execute the chain against a registry.\n   * @param registry  ToolRegistry that holds the referenced tools.\n   * @param input     Initial `{input}` value.\n   * @returns         The value stored under the last step's outputKey.\n   */\n  async execute(registry: ToolRegistry, input: string): Promise<string> {\n    const context: Record<string, string> = {input};\n\n    for (const step of this.steps) {\n      const resolvedInput = interpolate(step.inputTemplate, context);\n      const result = await registry.execute(step.toolName, {input: resolvedInput});\n      context[step.outputKey] = result;\n    }\n\n    const lastStep = this.steps[this.steps.length - 1];\n    if (!lastStep) return input;\n    return context[lastStep.outputKey] ?? input;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// ToolChainManager\n// ---------------------------------------------------------------------------\n\n/**\n * Manages multiple named ToolChains and executes them against a shared registry.\n */\nexport class ToolChainManager {\n  private readonly chains = new Map<string, ToolChain>();\n  private readonly registry: ToolRegistry;\n\n  constructor(registry: ToolRegistry) {\n    this.registry = registry;\n  }\n\n  registerChain(chain: ToolChain): void {\n    this.chains.set(chain.name, chain);\n  }\n\n  getChain(name: string): ToolChain | undefined {\n    return this.chains.get(name);\n  }\n\n  listChains(): string[] {\n    return Array.from(this.chains.keys());\n  }\n\n  async executeChain(chainName: string, input: string): Promise<string> {\n    const chain = this.chains.get(chainName);\n    if (!chain) throw new Error(`ToolChain not found: ${chainName}`);\n    return chain.execute(this.registry, input);\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\n/** Replace `{key}` placeholders with values from context. */\nfunction interpolate(template: string, context: Record<string, string>): string {\n  return template.replace(/\\{(\\w+)\\}/g, (_match, key: string) => {\n    return context[key] ?? `{${key}}`;\n  });\n}\n","import {Tool, type FunctionTool, type OpenAIFunctionSchema} from \"./Tool\";\n\n/**\n * Central registry that manages Tool instances and raw FunctionTools.\n * Supports registration, lookup, and execution.\n */\nexport class ToolRegistry {\n  private readonly tools = new Map<string, Tool>();\n  private readonly functions = new Map<string, FunctionTool<Record<string, unknown>>>();\n\n  // ---------------------------------------------------------------------------\n  // Registration\n  // ---------------------------------------------------------------------------\n\n  registerTool(tool: Tool): void {\n    this.tools.set(tool.name, tool);\n  }\n\n  unregisterTool(name: string): boolean {\n    return this.tools.delete(name);\n  }\n\n  registerFunction<TArgs extends Record<string, unknown>>(\n    name: string,\n    description: string,\n    func: (args: TArgs) => string | Promise<string>,\n    schema?: FunctionTool<TArgs>[\"schema\"],\n  ): void {\n    this.functions.set(name, {\n      name,\n      description,\n      func: func as FunctionTool<Record<string, unknown>>[\"func\"],\n      schema: schema as FunctionTool<Record<string, unknown>>[\"schema\"],\n    });\n  }\n\n  unregisterFunction(name: string): boolean {\n    return this.functions.delete(name);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Lookup\n  // ---------------------------------------------------------------------------\n\n  getTool(name: string): Tool | undefined {\n    return this.tools.get(name);\n  }\n\n  getFunction(name: string): FunctionTool<Record<string, unknown>> | undefined {\n    return this.functions.get(name);\n  }\n\n  getAllTools(): Tool[] {\n    return Array.from(this.tools.values());\n  }\n\n  listTools(): string[] {\n    return [\n      ...Array.from(this.tools.keys()),\n      ...Array.from(this.functions.keys()),\n    ];\n  }\n\n  hasTool(name: string): boolean {\n    return this.tools.has(name) || this.functions.has(name);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Execution\n  // ---------------------------------------------------------------------------\n\n  async execute(name: string, parameters: Record<string, unknown>): Promise<string> {\n    const tool = this.tools.get(name);\n    if (tool) {\n      return await tool.run(parameters);\n    }\n\n    const fn = this.functions.get(name);\n    if (fn) {\n      return await fn.func(parameters);\n    }\n\n    throw new Error(`Tool not found: ${name}`);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Description (for system prompts)\n  // ---------------------------------------------------------------------------\n\n  getAvailableTools(): string {\n    const lines: string[] = [];\n\n    for (const tool of this.tools.values()) {\n      lines.push(tool.describe());\n    }\n\n    for (const fn of this.functions.values()) {\n      lines.push(`Tool: ${fn.name}\\nDescription: ${fn.description}`);\n    }\n\n    if (lines.length === 0) return \"暂无可用工具\";\n    return lines.join(\"\\n\\n\");\n  }\n\n  getOpenAISchemas(): Array<OpenAIFunctionSchema | Record<string, unknown>> {\n    const schemas: Array<OpenAIFunctionSchema | Record<string, unknown>> = [];\n\n    for (const tool of this.tools.values()) {\n      schemas.push(tool.toOpenAISchema());\n    }\n\n    for (const fn of this.functions.values()) {\n      schemas.push({\n        type: \"function\",\n        function: {\n          name: fn.name,\n          description: fn.description,\n          parameters: {\n            type: \"object\",\n            properties: {\n              input: {type: \"string\", description: \"输入文本\"},\n            },\n          },\n        },\n      });\n    }\n\n    return schemas;\n  }\n}\n","import {ToolRegistry} from \"./ToolRegistry\";\n\nexport interface ToolCallRequest {\n  id: string;\n  toolName: string;\n  parameters: Record<string, unknown>;\n}\n\nexport interface ToolCallResult {\n  id: string;\n  toolName: string;\n  output: string;\n  error?: string;\n  durationMs: number;\n}\n\n/**\n * Executes multiple tool calls concurrently and collects results.\n */\nexport class AsyncToolExecutor {\n  private readonly registry: ToolRegistry;\n  private readonly concurrency: number;\n\n  constructor(registry: ToolRegistry, concurrency = 4) {\n    this.registry = registry;\n    this.concurrency = Math.max(1, concurrency);\n  }\n\n  /**\n   * Execute a batch of tool calls with bounded concurrency.\n   */\n  async executeBatch(requests: ToolCallRequest[]): Promise<ToolCallResult[]> {\n    const results: ToolCallResult[] = [];\n    let idx = 0;\n\n    const worker = async (): Promise<void> => {\n      while (idx < requests.length) {\n        const req = requests[idx++]!;\n        results.push(await this.executeSingle(req));\n      }\n    };\n\n    const workers = Array.from({length: Math.min(this.concurrency, requests.length)}, worker);\n    await Promise.all(workers);\n    return results;\n  }\n\n  /**\n   * Execute a single tool call.\n   */\n  async executeSingle(request: ToolCallRequest): Promise<ToolCallResult> {\n    const start = Date.now();\n    try {\n      const output = await this.registry.execute(request.toolName, request.parameters);\n      return {\n        id: request.id,\n        toolName: request.toolName,\n        output,\n        durationMs: Date.now() - start,\n      };\n    } catch (error) {\n      return {\n        id: request.id,\n        toolName: request.toolName,\n        output: \"\",\n        error: error instanceof Error ? error.message : String(error),\n        durationMs: Date.now() - start,\n      };\n    }\n  }\n}\n"],"names":["__publicField"],"mappings":"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"}

package/dist/esm/index.js

@@ -0,0 +1,329 @@
+import 'reflect-metadata';
+export { z } from 'zod';
+
+var __defProp$3 = Object.defineProperty;
+var __defNormalProp$3 = (obj, key, value) => key in obj ? __defProp$3(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$3 = (obj, key, value) => __defNormalProp$3(obj, typeof key !== "symbol" ? key + "" : key, value);
+const TOOL_ACTIONS_META_KEY = /* @__PURE__ */ Symbol("tool:actions");
+function toolAction(key, description) {
+  return function(target, propertyKey, _descriptor) {
+    const existing = Reflect.getMetadata(TOOL_ACTIONS_META_KEY, target) ?? [];
+    existing.push({ key, description, method: propertyKey });
+    Reflect.defineMetadata(TOOL_ACTIONS_META_KEY, existing, target);
+  };
+}
+class Tool {
+  constructor(name, description, expandable = false) {
+    __publicField$3(this, "name");
+    __publicField$3(this, "description");
+    __publicField$3(this, "expandable");
+    this.name = name;
+    this.description = description;
+    this.expandable = expandable;
+  }
+  /**
+   * Validate that required parameters are present and have basic types.
+   * Returns true if valid.
+   */
+  validateParameters(parameters) {
+    const params = this.getParameters();
+    for (const p of params) {
+      if (p.required && (parameters[p.name] === void 0 || parameters[p.name] === null)) {
+        return false;
+      }
+    }
+    return true;
+  }
+  /**
+   * Validate and coerce parameters, returning a Result object.
+   */
+  validateAndNormalizeParameters(parameters) {
+    const params = this.getParameters();
+    const data = {};
+    for (const p of params) {
+      const val = parameters[p.name];
+      if (val === void 0 || val === null) {
+        if (p.required) {
+          return { success: false, error: `Missing required parameter: ${p.name}` };
+        }
+        data[p.name] = p.default;
+      } else {
+        data[p.name] = val;
+      }
+    }
+    for (const [key, val] of Object.entries(parameters)) {
+      if (!(key in data)) data[key] = val;
+    }
+    return { success: true, data };
+  }
+  /**
+   * Convert this Tool to an OpenAI function-calling schema.
+   */
+  toOpenAISchema() {
+    const params = this.getParameters();
+    const properties = {};
+    const required = [];
+    for (const p of params) {
+      properties[p.name] = {
+        type: mapType(p.type),
+        description: p.description,
+        ...p.default !== null && p.default !== void 0 ? { default: p.default } : {}
+      };
+      if (p.required) required.push(p.name);
+    }
+    return {
+      type: "function",
+      function: {
+        name: this.name,
+        description: this.description,
+        parameters: {
+          type: "object",
+          properties,
+          ...required.length > 0 ? { required } : {}
+        }
+      }
+    };
+  }
+  /**
+   * Return a formatted description of all available tool actions (for system prompt).
+   */
+  describe() {
+    const params = this.getParameters();
+    const paramStr = params.map(
+      (p) => `  - ${p.name} (${p.type}${p.required ? ", required" : ""}): ${p.description}`
+    ).join("\n");
+    return `Tool: ${this.name}
+Description: ${this.description}
+Parameters:
+${paramStr}`;
+  }
+}
+function mapType(type) {
+  const t = (type ?? "string").toLowerCase();
+  if (["string", "number", "integer", "boolean", "array", "object"].includes(t)) {
+    return t;
+  }
+  return "string";
+}
+function defineFunctionTool(options) {
+  return options;
+}
+
+var __defProp$2 = Object.defineProperty;
+var __defNormalProp$2 = (obj, key, value) => key in obj ? __defProp$2(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$2 = (obj, key, value) => __defNormalProp$2(obj, typeof key !== "symbol" ? key + "" : key, value);
+class ToolChain {
+  constructor(name, description) {
+    __publicField$2(this, "name");
+    __publicField$2(this, "description");
+    __publicField$2(this, "steps", []);
+    this.name = name;
+    this.description = description;
+  }
+  addStep(toolName, inputTemplate, outputKey) {
+    this.steps.push({ toolName, inputTemplate, outputKey });
+    return this;
+  }
+  getSteps() {
+    return [...this.steps];
+  }
+  /**
+   * Execute the chain against a registry.
+   * @param registry  ToolRegistry that holds the referenced tools.
+   * @param input     Initial `{input}` value.
+   * @returns         The value stored under the last step's outputKey.
+   */
+  async execute(registry, input) {
+    const context = { input };
+    for (const step of this.steps) {
+      const resolvedInput = interpolate(step.inputTemplate, context);
+      const result = await registry.execute(step.toolName, { input: resolvedInput });
+      context[step.outputKey] = result;
+    }
+    const lastStep = this.steps[this.steps.length - 1];
+    if (!lastStep) return input;
+    return context[lastStep.outputKey] ?? input;
+  }
+}
+class ToolChainManager {
+  constructor(registry) {
+    __publicField$2(this, "chains", /* @__PURE__ */ new Map());
+    __publicField$2(this, "registry");
+    this.registry = registry;
+  }
+  registerChain(chain) {
+    this.chains.set(chain.name, chain);
+  }
+  getChain(name) {
+    return this.chains.get(name);
+  }
+  listChains() {
+    return Array.from(this.chains.keys());
+  }
+  async executeChain(chainName, input) {
+    const chain = this.chains.get(chainName);
+    if (!chain) throw new Error(`ToolChain not found: ${chainName}`);
+    return chain.execute(this.registry, input);
+  }
+}
+function interpolate(template, context) {
+  return template.replace(/\{(\w+)\}/g, (_match, key) => {
+    return context[key] ?? `{${key}}`;
+  });
+}
+
+var __defProp$1 = Object.defineProperty;
+var __defNormalProp$1 = (obj, key, value) => key in obj ? __defProp$1(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$1 = (obj, key, value) => __defNormalProp$1(obj, typeof key !== "symbol" ? key + "" : key, value);
+class ToolRegistry {
+  constructor() {
+    __publicField$1(this, "tools", /* @__PURE__ */ new Map());
+    __publicField$1(this, "functions", /* @__PURE__ */ new Map());
+  }
+  // ---------------------------------------------------------------------------
+  // Registration
+  // ---------------------------------------------------------------------------
+  registerTool(tool) {
+    this.tools.set(tool.name, tool);
+  }
+  unregisterTool(name) {
+    return this.tools.delete(name);
+  }
+  registerFunction(name, description, func, schema) {
+    this.functions.set(name, {
+      name,
+      description,
+      func,
+      schema
+    });
+  }
+  unregisterFunction(name) {
+    return this.functions.delete(name);
+  }
+  // ---------------------------------------------------------------------------
+  // Lookup
+  // ---------------------------------------------------------------------------
+  getTool(name) {
+    return this.tools.get(name);
+  }
+  getFunction(name) {
+    return this.functions.get(name);
+  }
+  getAllTools() {
+    return Array.from(this.tools.values());
+  }
+  listTools() {
+    return [
+      ...Array.from(this.tools.keys()),
+      ...Array.from(this.functions.keys())
+    ];
+  }
+  hasTool(name) {
+    return this.tools.has(name) || this.functions.has(name);
+  }
+  // ---------------------------------------------------------------------------
+  // Execution
+  // ---------------------------------------------------------------------------
+  async execute(name, parameters) {
+    const tool = this.tools.get(name);
+    if (tool) {
+      return await tool.run(parameters);
+    }
+    const fn = this.functions.get(name);
+    if (fn) {
+      return await fn.func(parameters);
+    }
+    throw new Error(`Tool not found: ${name}`);
+  }
+  // ---------------------------------------------------------------------------
+  // Description (for system prompts)
+  // ---------------------------------------------------------------------------
+  getAvailableTools() {
+    const lines = [];
+    for (const tool of this.tools.values()) {
+      lines.push(tool.describe());
+    }
+    for (const fn of this.functions.values()) {
+      lines.push(`Tool: ${fn.name}
+Description: ${fn.description}`);
+    }
+    if (lines.length === 0) return "\u6682\u65E0\u53EF\u7528\u5DE5\u5177";
+    return lines.join("\n\n");
+  }
+  getOpenAISchemas() {
+    const schemas = [];
+    for (const tool of this.tools.values()) {
+      schemas.push(tool.toOpenAISchema());
+    }
+    for (const fn of this.functions.values()) {
+      schemas.push({
+        type: "function",
+        function: {
+          name: fn.name,
+          description: fn.description,
+          parameters: {
+            type: "object",
+            properties: {
+              input: { type: "string", description: "\u8F93\u5165\u6587\u672C" }
+            }
+          }
+        }
+      });
+    }
+    return schemas;
+  }
+}
+
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+class AsyncToolExecutor {
+  constructor(registry, concurrency = 4) {
+    __publicField(this, "registry");
+    __publicField(this, "concurrency");
+    this.registry = registry;
+    this.concurrency = Math.max(1, concurrency);
+  }
+  /**
+   * Execute a batch of tool calls with bounded concurrency.
+   */
+  async executeBatch(requests) {
+    const results = [];
+    let idx = 0;
+    const worker = async () => {
+      while (idx < requests.length) {
+        const req = requests[idx++];
+        results.push(await this.executeSingle(req));
+      }
+    };
+    const workers = Array.from({ length: Math.min(this.concurrency, requests.length) }, worker);
+    await Promise.all(workers);
+    return results;
+  }
+  /**
+   * Execute a single tool call.
+   */
+  async executeSingle(request) {
+    const start = Date.now();
+    try {
+      const output = await this.registry.execute(request.toolName, request.parameters);
+      return {
+        id: request.id,
+        toolName: request.toolName,
+        output,
+        durationMs: Date.now() - start
+      };
+    } catch (error) {
+      return {
+        id: request.id,
+        toolName: request.toolName,
+        output: "",
+        error: error instanceof Error ? error.message : String(error),
+        durationMs: Date.now() - start
+      };
+    }
+  }
+}
+
+export { AsyncToolExecutor, Tool, ToolChain, ToolChainManager, ToolRegistry, defineFunctionTool, toolAction };
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../src/Tool.ts","../../src/ToolChain.ts","../../src/ToolRegistry.ts","../../src/AsyncToolExecutor.ts"],"sourcesContent":["import \"reflect-metadata\";\nimport {z, type ZodType} from \"zod\";\nimport type {ToolParameter} from \"./types\";\n\nexport type {ToolParameter};\n\n// ---------------------------------------------------------------------------\n// OpenAI function-calling schema\n// ---------------------------------------------------------------------------\n\nexport interface OpenAIFunctionSchema {\n  type: \"function\";\n  function: {\n    name: string;\n    description: string;\n    parameters: Record<string, unknown>;\n  };\n}\n\n// ---------------------------------------------------------------------------\n// toolAction decorator\n// ---------------------------------------------------------------------------\n\nconst TOOL_ACTIONS_META_KEY = Symbol(\"tool:actions\");\n\nexport interface ToolActionMeta {\n  key: string;\n  description: string;\n  method: string;\n}\n\n/**\n * Decorator that registers a method as a named tool action.\n * Usage: @toolAction(\"action_key\", \"Description\")\n */\nexport function toolAction(key: string, description: string) {\n  return function (\n    target: object,\n    propertyKey: string,\n    _descriptor: PropertyDescriptor,\n  ): void {\n    const existing: ToolActionMeta[] =\n      Reflect.getMetadata(TOOL_ACTIONS_META_KEY, target) ?? [];\n    existing.push({key, description, method: propertyKey});\n    Reflect.defineMetadata(TOOL_ACTIONS_META_KEY, existing, target);\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Tool base class\n// ---------------------------------------------------------------------------\n\nexport abstract class Tool {\n  readonly name: string;\n  readonly description: string;\n  readonly expandable: boolean;\n\n  constructor(name: string, description: string, expandable = false) {\n    this.name = name;\n    this.description = description;\n    this.expandable = expandable;\n  }\n\n  abstract run(parameters: Record<string, unknown>): Promise<string> | string;\n  abstract getParameters(): ToolParameter[];\n\n  /**\n   * Validate that required parameters are present and have basic types.\n   * Returns true if valid.\n   */\n  validateParameters(parameters: Record<string, unknown>): boolean {\n    const params = this.getParameters();\n    for (const p of params) {\n      if (p.required && (parameters[p.name] === undefined || parameters[p.name] === null)) {\n        return false;\n      }\n    }\n    return true;\n  }\n\n  /**\n   * Validate and coerce parameters, returning a Result object.\n   */\n  validateAndNormalizeParameters(\n    parameters: Record<string, unknown>,\n  ): {success: true; data: Record<string, unknown>} | {success: false; error: string} {\n    const params = this.getParameters();\n    const data: Record<string, unknown> = {};\n\n    for (const p of params) {\n      const val = parameters[p.name];\n      if (val === undefined || val === null) {\n        if (p.required) {\n          return {success: false, error: `Missing required parameter: ${p.name}`};\n        }\n        data[p.name] = p.default;\n      } else {\n        data[p.name] = val;\n      }\n    }\n\n    // pass through any extra parameters\n    for (const [key, val] of Object.entries(parameters)) {\n      if (!(key in data)) data[key] = val;\n    }\n\n    return {success: true, data};\n  }\n\n  /**\n   * Convert this Tool to an OpenAI function-calling schema.\n   */\n  toOpenAISchema(): OpenAIFunctionSchema {\n    const params = this.getParameters();\n    const properties: Record<string, unknown> = {};\n    const required: string[] = [];\n\n    for (const p of params) {\n      properties[p.name] = {\n        type: mapType(p.type),\n        description: p.description,\n        ...(p.default !== null && p.default !== undefined\n          ? {default: p.default}\n          : {}),\n      };\n      if (p.required) required.push(p.name);\n    }\n\n    return {\n      type: \"function\",\n      function: {\n        name: this.name,\n        description: this.description,\n        parameters: {\n          type: \"object\",\n          properties,\n          ...(required.length > 0 ? {required} : {}),\n        },\n      },\n    };\n  }\n\n  /**\n   * Return a formatted description of all available tool actions (for system prompt).\n   */\n  describe(): string {\n    const params = this.getParameters();\n    const paramStr = params\n      .map(\n        (p) =>\n          `  - ${p.name} (${p.type}${p.required ? \", required\" : \"\"}): ${p.description}`,\n      )\n      .join(\"\\n\");\n    return `Tool: ${this.name}\\nDescription: ${this.description}\\nParameters:\\n${paramStr}`;\n  }\n}\n\nfunction mapType(type: string): string {\n  const t = (type ?? \"string\").toLowerCase();\n  if ([\"string\", \"number\", \"integer\", \"boolean\", \"array\", \"object\"].includes(t)) {\n    return t;\n  }\n  return \"string\";\n}\n\n// ---------------------------------------------------------------------------\n// FunctionTool — wraps a plain async/sync function\n// ---------------------------------------------------------------------------\n\nexport interface FunctionTool<TArgs = Record<string, unknown>> {\n  name: string;\n  description: string;\n  func: (args: TArgs) => string | Promise<string>;\n  schema?: ZodType<TArgs>;\n}\n\n/**\n * Convenience factory for creating type-safe function tools.\n *\n * ```ts\n * const myTool = defineFunctionTool({\n *   name: \"myTool\",\n *   description: \"...\",\n *   schema: z.object({ input: z.string() }),\n *   func: ({ input }) => input.toUpperCase(),\n * });\n * ```\n */\nexport function defineFunctionTool<TArgs extends Record<string, unknown>>(\n  options: FunctionTool<TArgs>,\n): FunctionTool<TArgs> {\n  return options;\n}\n\nexport {z};\n","import {ToolRegistry} from \"./ToolRegistry\";\n\n// ---------------------------------------------------------------------------\n// ToolChain step definition\n// ---------------------------------------------------------------------------\n\nexport interface ToolChainStep {\n  /** Name of the tool/function to call */\n  toolName: string;\n  /** Input template string; use {variableName} to reference context variables */\n  inputTemplate: string;\n  /** Key under which the step output is stored in context */\n  outputKey: string;\n}\n\n// ---------------------------------------------------------------------------\n// ToolChain\n// ---------------------------------------------------------------------------\n\n/**\n * A sequential chain of tool steps.\n * Each step can reference outputs of prior steps via `{key}` placeholders.\n *\n * ```ts\n * const chain = new ToolChain(\"my_chain\", \"Does X then Y\");\n * chain.addStep(\"search\", \"{input}\", \"search_result\");\n * chain.addStep(\"summarize\", \"{search_result}\", \"summary\");\n * ```\n */\nexport class ToolChain {\n  readonly name: string;\n  readonly description: string;\n  private readonly steps: ToolChainStep[] = [];\n\n  constructor(name: string, description: string) {\n    this.name = name;\n    this.description = description;\n  }\n\n  addStep(toolName: string, inputTemplate: string, outputKey: string): this {\n    this.steps.push({toolName, inputTemplate, outputKey});\n    return this;\n  }\n\n  getSteps(): ToolChainStep[] {\n    return [...this.steps];\n  }\n\n  /**\n   * Execute the chain against a registry.\n   * @param registry  ToolRegistry that holds the referenced tools.\n   * @param input     Initial `{input}` value.\n   * @returns         The value stored under the last step's outputKey.\n   */\n  async execute(registry: ToolRegistry, input: string): Promise<string> {\n    const context: Record<string, string> = {input};\n\n    for (const step of this.steps) {\n      const resolvedInput = interpolate(step.inputTemplate, context);\n      const result = await registry.execute(step.toolName, {input: resolvedInput});\n      context[step.outputKey] = result;\n    }\n\n    const lastStep = this.steps[this.steps.length - 1];\n    if (!lastStep) return input;\n    return context[lastStep.outputKey] ?? input;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// ToolChainManager\n// ---------------------------------------------------------------------------\n\n/**\n * Manages multiple named ToolChains and executes them against a shared registry.\n */\nexport class ToolChainManager {\n  private readonly chains = new Map<string, ToolChain>();\n  private readonly registry: ToolRegistry;\n\n  constructor(registry: ToolRegistry) {\n    this.registry = registry;\n  }\n\n  registerChain(chain: ToolChain): void {\n    this.chains.set(chain.name, chain);\n  }\n\n  getChain(name: string): ToolChain | undefined {\n    return this.chains.get(name);\n  }\n\n  listChains(): string[] {\n    return Array.from(this.chains.keys());\n  }\n\n  async executeChain(chainName: string, input: string): Promise<string> {\n    const chain = this.chains.get(chainName);\n    if (!chain) throw new Error(`ToolChain not found: ${chainName}`);\n    return chain.execute(this.registry, input);\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\n/** Replace `{key}` placeholders with values from context. */\nfunction interpolate(template: string, context: Record<string, string>): string {\n  return template.replace(/\\{(\\w+)\\}/g, (_match, key: string) => {\n    return context[key] ?? `{${key}}`;\n  });\n}\n","import {Tool, type FunctionTool, type OpenAIFunctionSchema} from \"./Tool\";\n\n/**\n * Central registry that manages Tool instances and raw FunctionTools.\n * Supports registration, lookup, and execution.\n */\nexport class ToolRegistry {\n  private readonly tools = new Map<string, Tool>();\n  private readonly functions = new Map<string, FunctionTool<Record<string, unknown>>>();\n\n  // ---------------------------------------------------------------------------\n  // Registration\n  // ---------------------------------------------------------------------------\n\n  registerTool(tool: Tool): void {\n    this.tools.set(tool.name, tool);\n  }\n\n  unregisterTool(name: string): boolean {\n    return this.tools.delete(name);\n  }\n\n  registerFunction<TArgs extends Record<string, unknown>>(\n    name: string,\n    description: string,\n    func: (args: TArgs) => string | Promise<string>,\n    schema?: FunctionTool<TArgs>[\"schema\"],\n  ): void {\n    this.functions.set(name, {\n      name,\n      description,\n      func: func as FunctionTool<Record<string, unknown>>[\"func\"],\n      schema: schema as FunctionTool<Record<string, unknown>>[\"schema\"],\n    });\n  }\n\n  unregisterFunction(name: string): boolean {\n    return this.functions.delete(name);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Lookup\n  // ---------------------------------------------------------------------------\n\n  getTool(name: string): Tool | undefined {\n    return this.tools.get(name);\n  }\n\n  getFunction(name: string): FunctionTool<Record<string, unknown>> | undefined {\n    return this.functions.get(name);\n  }\n\n  getAllTools(): Tool[] {\n    return Array.from(this.tools.values());\n  }\n\n  listTools(): string[] {\n    return [\n      ...Array.from(this.tools.keys()),\n      ...Array.from(this.functions.keys()),\n    ];\n  }\n\n  hasTool(name: string): boolean {\n    return this.tools.has(name) || this.functions.has(name);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Execution\n  // ---------------------------------------------------------------------------\n\n  async execute(name: string, parameters: Record<string, unknown>): Promise<string> {\n    const tool = this.tools.get(name);\n    if (tool) {\n      return await tool.run(parameters);\n    }\n\n    const fn = this.functions.get(name);\n    if (fn) {\n      return await fn.func(parameters);\n    }\n\n    throw new Error(`Tool not found: ${name}`);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Description (for system prompts)\n  // ---------------------------------------------------------------------------\n\n  getAvailableTools(): string {\n    const lines: string[] = [];\n\n    for (const tool of this.tools.values()) {\n      lines.push(tool.describe());\n    }\n\n    for (const fn of this.functions.values()) {\n      lines.push(`Tool: ${fn.name}\\nDescription: ${fn.description}`);\n    }\n\n    if (lines.length === 0) return \"暂无可用工具\";\n    return lines.join(\"\\n\\n\");\n  }\n\n  getOpenAISchemas(): Array<OpenAIFunctionSchema | Record<string, unknown>> {\n    const schemas: Array<OpenAIFunctionSchema | Record<string, unknown>> = [];\n\n    for (const tool of this.tools.values()) {\n      schemas.push(tool.toOpenAISchema());\n    }\n\n    for (const fn of this.functions.values()) {\n      schemas.push({\n        type: \"function\",\n        function: {\n          name: fn.name,\n          description: fn.description,\n          parameters: {\n            type: \"object\",\n            properties: {\n              input: {type: \"string\", description: \"输入文本\"},\n            },\n          },\n        },\n      });\n    }\n\n    return schemas;\n  }\n}\n","import {ToolRegistry} from \"./ToolRegistry\";\n\nexport interface ToolCallRequest {\n  id: string;\n  toolName: string;\n  parameters: Record<string, unknown>;\n}\n\nexport interface ToolCallResult {\n  id: string;\n  toolName: string;\n  output: string;\n  error?: string;\n  durationMs: number;\n}\n\n/**\n * Executes multiple tool calls concurrently and collects results.\n */\nexport class AsyncToolExecutor {\n  private readonly registry: ToolRegistry;\n  private readonly concurrency: number;\n\n  constructor(registry: ToolRegistry, concurrency = 4) {\n    this.registry = registry;\n    this.concurrency = Math.max(1, concurrency);\n  }\n\n  /**\n   * Execute a batch of tool calls with bounded concurrency.\n   */\n  async executeBatch(requests: ToolCallRequest[]): Promise<ToolCallResult[]> {\n    const results: ToolCallResult[] = [];\n    let idx = 0;\n\n    const worker = async (): Promise<void> => {\n      while (idx < requests.length) {\n        const req = requests[idx++]!;\n        results.push(await this.executeSingle(req));\n      }\n    };\n\n    const workers = Array.from({length: Math.min(this.concurrency, requests.length)}, worker);\n    await Promise.all(workers);\n    return results;\n  }\n\n  /**\n   * Execute a single tool call.\n   */\n  async executeSingle(request: ToolCallRequest): Promise<ToolCallResult> {\n    const start = Date.now();\n    try {\n      const output = await this.registry.execute(request.toolName, request.parameters);\n      return {\n        id: request.id,\n        toolName: request.toolName,\n        output,\n        durationMs: Date.now() - start,\n      };\n    } catch (error) {\n      return {\n        id: request.id,\n        toolName: request.toolName,\n        output: \"\",\n        error: error instanceof Error ? error.message : String(error),\n        durationMs: Date.now() - start,\n      };\n    }\n  }\n}\n"],"names":["__publicField"],"mappings":";;;;;;AAuBA,MAAM,qBAAA,0BAA+B,cAAc,CAAA;AAY5C,SAAS,UAAA,CAAW,KAAa,WAAA,EAAqB;AAC3D,EAAA,OAAO,SACL,MAAA,EACA,WAAA,EACA,WAAA,EACM;AACN,IAAA,MAAM,WACJ,OAAA,CAAQ,WAAA,CAAY,qBAAA,EAAuB,MAAM,KAAK,EAAC;AACzD,IAAA,QAAA,CAAS,KAAK,EAAC,GAAA,EAAK,WAAA,EAAa,MAAA,EAAQ,aAAY,CAAA;AACrD,IAAA,OAAA,CAAQ,cAAA,CAAe,qBAAA,EAAuB,QAAA,EAAU,MAAM,CAAA;AAAA,EAChE,CAAA;AACF;AAMO,MAAe,IAAA,CAAK;AAAA,EAKzB,WAAA,CAAY,IAAA,EAAc,WAAA,EAAqB,UAAA,GAAa,KAAA,EAAO;AAJnE,IAAAA,eAAA,CAAA,IAAA,EAAS,MAAA,CAAA;AACT,IAAAA,eAAA,CAAA,IAAA,EAAS,aAAA,CAAA;AACT,IAAAA,eAAA,CAAA,IAAA,EAAS,YAAA,CAAA;AAGP,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AACZ,IAAA,IAAA,CAAK,WAAA,GAAc,WAAA;AACnB,IAAA,IAAA,CAAK,UAAA,GAAa,UAAA;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,mBAAmB,UAAA,EAA8C;AAC/D,IAAA,MAAM,MAAA,GAAS,KAAK,aAAA,EAAc;AAClC,IAAA,KAAA,MAAW,KAAK,MAAA,EAAQ;AACtB,MAAA,IAAI,CAAA,CAAE,QAAA,KAAa,UAAA,CAAW,CAAA,CAAE,IAAI,CAAA,KAAM,MAAA,IAAa,UAAA,CAAW,CAAA,CAAE,IAAI,CAAA,KAAM,IAAA,CAAA,EAAO;AACnF,QAAA,OAAO,KAAA;AAAA,MACT;AAAA,IACF;AACA,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,+BACE,UAAA,EACkF;AAClF,IAAA,MAAM,MAAA,GAAS,KAAK,aAAA,EAAc;AAClC,IAAA,MAAM,OAAgC,EAAC;AAEvC,IAAA,KAAA,MAAW,KAAK,MAAA,EAAQ;AACtB,MAAA,MAAM,GAAA,GAAM,UAAA,CAAW,CAAA,CAAE,IAAI,CAAA;AAC7B,MAAA,IAAI,GAAA,KAAQ,MAAA,IAAa,GAAA,KAAQ,IAAA,EAAM;AACrC,QAAA,IAAI,EAAE,QAAA,EAAU;AACd,UAAA,OAAO,EAAC,OAAA,EAAS,KAAA,EAAO,OAAO,CAAA,4BAAA,EAA+B,CAAA,CAAE,IAAI,CAAA,CAAA,EAAE;AAAA,QACxE;AACA,QAAA,IAAA,CAAK,CAAA,CAAE,IAAI,CAAA,GAAI,CAAA,CAAE,OAAA;AAAA,MACnB,CAAA,MAAO;AACL,QAAA,IAAA,CAAK,CAAA,CAAE,IAAI,CAAA,GAAI,GAAA;AAAA,MACjB;AAAA,IACF;AAGA,IAAA,KAAA,MAAW,CAAC,GAAA,EAAK,GAAG,KAAK,MAAA,CAAO,OAAA,CAAQ,UAAU,CAAA,EAAG;AACnD,MAAA,IAAI,EAAE,GAAA,IAAO,IAAA,CAAA,EAAO,IAAA,CAAK,GAAG,CAAA,GAAI,GAAA;AAAA,IAClC;AAEA,IAAA,OAAO,EAAC,OAAA,EAAS,IAAA,EAAM,IAAA,EAAI;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA,EAKA,cAAA,GAAuC;AACrC,IAAA,MAAM,MAAA,GAAS,KAAK,aAAA,EAAc;AAClC,IAAA,MAAM,aAAsC,EAAC;AAC7C,IAAA,MAAM,WAAqB,EAAC;AAE5B,IAAA,KAAA,MAAW,KAAK,MAAA,EAAQ;AACtB,MAAA,UAAA,CAAW,CAAA,CAAE,IAAI,CAAA,GAAI;AAAA,QACnB,IAAA,EAAM,OAAA,CAAQ,CAAA,CAAE,IAAI,CAAA;AAAA,QACpB,aAAa,CAAA,CAAE,WAAA;AAAA,QACf,GAAI,CAAA,CAAE,OAAA,KAAY,IAAA,IAAQ,CAAA,CAAE,OAAA,KAAY,MAAA,GACpC,EAAC,OAAA,EAAS,CAAA,CAAE,OAAA,EAAO,GACnB;AAAC,OACP;AACA,MAAA,IAAI,CAAA,CAAE,QAAA,EAAU,QAAA,CAAS,IAAA,CAAK,EAAE,IAAI,CAAA;AAAA,IACtC;AAEA,IAAA,OAAO;AAAA,MACL,IAAA,EAAM,UAAA;AAAA,MACN,QAAA,EAAU;AAAA,QACR,MAAM,IAAA,CAAK,IAAA;AAAA,QACX,aAAa,IAAA,CAAK,WAAA;AAAA,QAClB,UAAA,EAAY;AAAA,UACV,IAAA,EAAM,QAAA;AAAA,UACN,UAAA;AAAA,UACA,GAAI,QAAA,CAAS,MAAA,GAAS,IAAI,EAAC,QAAA,KAAY;AAAC;AAC1C;AACF,KACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,QAAA,GAAmB;AACjB,IAAA,MAAM,MAAA,GAAS,KAAK,aAAA,EAAc;AAClC,IAAA,MAAM,WAAW,MAAA,CACd,GAAA;AAAA,MACC,CAAC,CAAA,KACC,CAAA,IAAA,EAAO,CAAA,CAAE,IAAI,CAAA,EAAA,EAAK,CAAA,CAAE,IAAI,CAAA,EAAG,EAAE,QAAA,GAAW,YAAA,GAAe,EAAE,CAAA,GAAA,EAAM,EAAE,WAAW,CAAA;AAAA,KAChF,CACC,KAAK,IAAI,CAAA;AACZ,IAAA,OAAO,CAAA,MAAA,EAAS,KAAK,IAAI;AAAA,aAAA,EAAkB,KAAK,WAAW;AAAA;AAAA,EAAkB,QAAQ,CAAA,CAAA;AAAA,EACvF;AACF;AAEA,SAAS,QAAQ,IAAA,EAAsB;AACrC,EAAA,MAAM,CAAA,GAAA,CAAK,IAAA,IAAQ,QAAA,EAAU,WAAA,EAAY;AACzC,EAAA,IAAI,CAAC,QAAA,EAAU,QAAA,EAAU,SAAA,EAAW,SAAA,EAAW,SAAS,QAAQ,CAAA,CAAE,QAAA,CAAS,CAAC,CAAA,EAAG;AAC7E,IAAA,OAAO,CAAA;AAAA,EACT;AACA,EAAA,OAAO,QAAA;AACT;AAyBO,SAAS,mBACd,OAAA,EACqB;AACrB,EAAA,OAAO,OAAA;AACT;;;;;ACnKO,MAAM,SAAA,CAAU;AAAA,EAKrB,WAAA,CAAY,MAAc,WAAA,EAAqB;AAJ/C,IAAAA,eAAA,CAAA,IAAA,EAAS,MAAA,CAAA;AACT,IAAAA,eAAA,CAAA,IAAA,EAAS,aAAA,CAAA;AACT,IAAAA,eAAA,CAAA,IAAA,EAAiB,SAAyB,EAAC,CAAA;AAGzC,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AACZ,IAAA,IAAA,CAAK,WAAA,GAAc,WAAA;AAAA,EACrB;AAAA,EAEA,OAAA,CAAQ,QAAA,EAAkB,aAAA,EAAuB,SAAA,EAAyB;AACxE,IAAA,IAAA,CAAK,MAAM,IAAA,CAAK,EAAC,QAAA,EAAU,aAAA,EAAe,WAAU,CAAA;AACpD,IAAA,OAAO,IAAA;AAAA,EACT;AAAA,EAEA,QAAA,GAA4B;AAC1B,IAAA,OAAO,CAAC,GAAG,IAAA,CAAK,KAAK,CAAA;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,OAAA,CAAQ,QAAA,EAAwB,KAAA,EAAgC;AACpE,IAAA,MAAM,OAAA,GAAkC,EAAC,KAAA,EAAK;AAE9C,IAAA,KAAA,MAAW,IAAA,IAAQ,KAAK,KAAA,EAAO;AAC7B,MAAA,MAAM,aAAA,GAAgB,WAAA,CAAY,IAAA,CAAK,aAAA,EAAe,OAAO,CAAA;AAC7D,MAAA,MAAM,MAAA,GAAS,MAAM,QAAA,CAAS,OAAA,CAAQ,KAAK,QAAA,EAAU,EAAC,KAAA,EAAO,aAAA,EAAc,CAAA;AAC3E,MAAA,OAAA,CAAQ,IAAA,CAAK,SAAS,CAAA,GAAI,MAAA;AAAA,IAC5B;AAEA,IAAA,MAAM,WAAW,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,KAAA,CAAM,SAAS,CAAC,CAAA;AACjD,IAAA,IAAI,CAAC,UAAU,OAAO,KAAA;AACtB,IAAA,OAAO,OAAA,CAAQ,QAAA,CAAS,SAAS,CAAA,IAAK,KAAA;AAAA,EACxC;AACF;AASO,MAAM,gBAAA,CAAiB;AAAA,EAI5B,YAAY,QAAA,EAAwB;AAHpC,IAAAA,eAAA,CAAA,IAAA,EAAiB,QAAA,sBAAa,GAAA,EAAuB,CAAA;AACrD,IAAAA,eAAA,CAAA,IAAA,EAAiB,UAAA,CAAA;AAGf,IAAA,IAAA,CAAK,QAAA,GAAW,QAAA;AAAA,EAClB;AAAA,EAEA,cAAc,KAAA,EAAwB;AACpC,IAAA,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,KAAA,CAAM,IAAA,EAAM,KAAK,CAAA;AAAA,EACnC;AAAA,EAEA,SAAS,IAAA,EAAqC;AAC5C,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,IAAI,CAAA;AAAA,EAC7B;AAAA,EAEA,UAAA,GAAuB;AACrB,IAAA,OAAO,KAAA,CAAM,IAAA,CAAK,IAAA,CAAK,MAAA,CAAO,MAAM,CAAA;AAAA,EACtC;AAAA,EAEA,MAAM,YAAA,CAAa,SAAA,EAAmB,KAAA,EAAgC;AACpE,IAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,SAAS,CAAA;AACvC,IAAA,IAAI,CAAC,KAAA,EAAO,MAAM,IAAI,KAAA,CAAM,CAAA,qBAAA,EAAwB,SAAS,CAAA,CAAE,CAAA;AAC/D,IAAA,OAAO,KAAA,CAAM,OAAA,CAAQ,IAAA,CAAK,QAAA,EAAU,KAAK,CAAA;AAAA,EAC3C;AACF;AAOA,SAAS,WAAA,CAAY,UAAkB,OAAA,EAAyC;AAC9E,EAAA,OAAO,QAAA,CAAS,OAAA,CAAQ,YAAA,EAAc,CAAC,QAAQ,GAAA,KAAgB;AAC7D,IAAA,OAAO,OAAA,CAAQ,GAAG,CAAA,IAAK,CAAA,CAAA,EAAI,GAAG,CAAA,CAAA,CAAA;AAAA,EAChC,CAAC,CAAA;AACH;;;;;AC1GO,MAAM,YAAA,CAAa;AAAA,EAAnB,WAAA,GAAA;AACL,IAAAA,eAAA,CAAA,IAAA,EAAiB,OAAA,sBAAY,GAAA,EAAkB,CAAA;AAC/C,IAAAA,eAAA,CAAA,IAAA,EAAiB,WAAA,sBAAgB,GAAA,EAAmD,CAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA,EAMpF,aAAa,IAAA,EAAkB;AAC7B,IAAA,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,IAAA,CAAK,IAAA,EAAM,IAAI,CAAA;AAAA,EAChC;AAAA,EAEA,eAAe,IAAA,EAAuB;AACpC,IAAA,OAAO,IAAA,CAAK,KAAA,CAAM,MAAA,CAAO,IAAI,CAAA;AAAA,EAC/B;AAAA,EAEA,gBAAA,CACE,IAAA,EACA,WAAA,EACA,IAAA,EACA,MAAA,EACM;AACN,IAAA,IAAA,CAAK,SAAA,CAAU,IAAI,IAAA,EAAM;AAAA,MACvB,IAAA;AAAA,MACA,WAAA;AAAA,MACA,IAAA;AAAA,MACA;AAAA,KACD,CAAA;AAAA,EACH;AAAA,EAEA,mBAAmB,IAAA,EAAuB;AACxC,IAAA,OAAO,IAAA,CAAK,SAAA,CAAU,MAAA,CAAO,IAAI,CAAA;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA,EAMA,QAAQ,IAAA,EAAgC;AACtC,IAAA,OAAO,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,IAAI,CAAA;AAAA,EAC5B;AAAA,EAEA,YAAY,IAAA,EAAiE;AAC3E,IAAA,OAAO,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,IAAI,CAAA;AAAA,EAChC;AAAA,EAEA,WAAA,GAAsB;AACpB,IAAA,OAAO,KAAA,CAAM,IAAA,CAAK,IAAA,CAAK,KAAA,CAAM,QAAQ,CAAA;AAAA,EACvC;AAAA,EAEA,SAAA,GAAsB;AACpB,IAAA,OAAO;AAAA,MACL,GAAG,KAAA,CAAM,IAAA,CAAK,IAAA,CAAK,KAAA,CAAM,MAAM,CAAA;AAAA,MAC/B,GAAG,KAAA,CAAM,IAAA,CAAK,IAAA,CAAK,SAAA,CAAU,MAAM;AAAA,KACrC;AAAA,EACF;AAAA,EAEA,QAAQ,IAAA,EAAuB;AAC7B,IAAA,OAAO,IAAA,CAAK,MAAM,GAAA,CAAI,IAAI,KAAK,IAAA,CAAK,SAAA,CAAU,IAAI,IAAI,CAAA;AAAA,EACxD;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,OAAA,CAAQ,IAAA,EAAc,UAAA,EAAsD;AAChF,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,IAAI,CAAA;AAChC,IAAA,IAAI,IAAA,EAAM;AACR,MAAA,OAAO,MAAM,IAAA,CAAK,GAAA,CAAI,UAAU,CAAA;AAAA,IAClC;AAEA,IAAA,MAAM,EAAA,GAAK,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,IAAI,CAAA;AAClC,IAAA,IAAI,EAAA,EAAI;AACN,MAAA,OAAO,MAAM,EAAA,CAAG,IAAA,CAAK,UAAU,CAAA;AAAA,IACjC;AAEA,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,gBAAA,EAAmB,IAAI,CAAA,CAAE,CAAA;AAAA,EAC3C;AAAA;AAAA;AAAA;AAAA,EAMA,iBAAA,GAA4B;AAC1B,IAAA,MAAM,QAAkB,EAAC;AAEzB,IAAA,KAAA,MAAW,IAAA,IAAQ,IAAA,CAAK,KAAA,CAAM,MAAA,EAAO,EAAG;AACtC,MAAA,KAAA,CAAM,IAAA,CAAK,IAAA,CAAK,QAAA,EAAU,CAAA;AAAA,IAC5B;AAEA,IAAA,KAAA,MAAW,EAAA,IAAM,IAAA,CAAK,SAAA,CAAU,MAAA,EAAO,EAAG;AACxC,MAAA,KAAA,CAAM,IAAA,CAAK,CAAA,MAAA,EAAS,EAAA,CAAG,IAAI;AAAA,aAAA,EAAkB,EAAA,CAAG,WAAW,CAAA,CAAE,CAAA;AAAA,IAC/D;AAEA,IAAA,IAAI,KAAA,CAAM,MAAA,KAAW,CAAA,EAAG,OAAO,sCAAA;AAC/B,IAAA,OAAO,KAAA,CAAM,KAAK,MAAM,CAAA;AAAA,EAC1B;AAAA,EAEA,gBAAA,GAA0E;AACxE,IAAA,MAAM,UAAiE,EAAC;AAExE,IAAA,KAAA,MAAW,IAAA,IAAQ,IAAA,CAAK,KAAA,CAAM,MAAA,EAAO,EAAG;AACtC,MAAA,OAAA,CAAQ,IAAA,CAAK,IAAA,CAAK,cAAA,EAAgB,CAAA;AAAA,IACpC;AAEA,IAAA,KAAA,MAAW,EAAA,IAAM,IAAA,CAAK,SAAA,CAAU,MAAA,EAAO,EAAG;AACxC,MAAA,OAAA,CAAQ,IAAA,CAAK;AAAA,QACX,IAAA,EAAM,UAAA;AAAA,QACN,QAAA,EAAU;AAAA,UACR,MAAM,EAAA,CAAG,IAAA;AAAA,UACT,aAAa,EAAA,CAAG,WAAA;AAAA,UAChB,UAAA,EAAY;AAAA,YACV,IAAA,EAAM,QAAA;AAAA,YACN,UAAA,EAAY;AAAA,cACV,KAAA,EAAO,EAAC,IAAA,EAAM,QAAA,EAAU,aAAa,0BAAA;AAAM;AAC7C;AACF;AACF,OACD,CAAA;AAAA,IACH;AAEA,IAAA,OAAO,OAAA;AAAA,EACT;AACF;;;;;AC9GO,MAAM,iBAAA,CAAkB;AAAA,EAI7B,WAAA,CAAY,QAAA,EAAwB,WAAA,GAAc,CAAA,EAAG;AAHrD,IAAA,aAAA,CAAA,IAAA,EAAiB,UAAA,CAAA;AACjB,IAAA,aAAA,CAAA,IAAA,EAAiB,aAAA,CAAA;AAGf,IAAA,IAAA,CAAK,QAAA,GAAW,QAAA;AAChB,IAAA,IAAA,CAAK,WAAA,GAAc,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,WAAW,CAAA;AAAA,EAC5C;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,aAAa,QAAA,EAAwD;AACzE,IAAA,MAAM,UAA4B,EAAC;AACnC,IAAA,IAAI,GAAA,GAAM,CAAA;AAEV,IAAA,MAAM,SAAS,YAA2B;AACxC,MAAA,OAAO,GAAA,GAAM,SAAS,MAAA,EAAQ;AAC5B,QAAA,MAAM,GAAA,GAAM,SAAS,GAAA,EAAK,CAAA;AAC1B,QAAA,OAAA,CAAQ,IAAA,CAAK,MAAM,IAAA,CAAK,aAAA,CAAc,GAAG,CAAC,CAAA;AAAA,MAC5C;AAAA,IACF,CAAA;AAEA,IAAA,MAAM,OAAA,GAAU,KAAA,CAAM,IAAA,CAAK,EAAC,MAAA,EAAQ,IAAA,CAAK,GAAA,CAAI,IAAA,CAAK,WAAA,EAAa,QAAA,CAAS,MAAM,CAAA,IAAI,MAAM,CAAA;AACxF,IAAA,MAAM,OAAA,CAAQ,IAAI,OAAO,CAAA;AACzB,IAAA,OAAO,OAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,cAAc,OAAA,EAAmD;AACrE,IAAA,MAAM,KAAA,GAAQ,KAAK,GAAA,EAAI;AACvB,IAAA,IAAI;AACF,MAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,QAAA,CAAS,QAAQ,OAAA,CAAQ,QAAA,EAAU,QAAQ,UAAU,CAAA;AAC/E,MAAA,OAAO;AAAA,QACL,IAAI,OAAA,CAAQ,EAAA;AAAA,QACZ,UAAU,OAAA,CAAQ,QAAA;AAAA,QAClB,MAAA;AAAA,QACA,UAAA,EAAY,IAAA,CAAK,GAAA,EAAI,GAAI;AAAA,OAC3B;AAAA,IACF,SAAS,KAAA,EAAO;AACd,MAAA,OAAO;AAAA,QACL,IAAI,OAAA,CAAQ,EAAA;AAAA,QACZ,UAAU,OAAA,CAAQ,QAAA;AAAA,QAClB,MAAA,EAAQ,EAAA;AAAA,QACR,OAAO,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,OAAA,GAAU,OAAO,KAAK,CAAA;AAAA,QAC5D,UAAA,EAAY,IAAA,CAAK,GAAA,EAAI,GAAI;AAAA,OAC3B;AAAA,IACF;AAAA,EACF;AACF;;;;"}

package/dist/types/AsyncToolExecutor.d.ts

@@ -0,0 +1,30 @@
+import { ToolRegistry } from "./ToolRegistry";
+export interface ToolCallRequest {
+    id: string;
+    toolName: string;
+    parameters: Record<string, unknown>;
+}
+export interface ToolCallResult {
+    id: string;
+    toolName: string;
+    output: string;
+    error?: string;
+    durationMs: number;
+}
+/**
+ * Executes multiple tool calls concurrently and collects results.
+ */
+export declare class AsyncToolExecutor {
+    private readonly registry;
+    private readonly concurrency;
+    constructor(registry: ToolRegistry, concurrency?: number);
+    /**
+     * Execute a batch of tool calls with bounded concurrency.
+     */
+    executeBatch(requests: ToolCallRequest[]): Promise<ToolCallResult[]>;
+    /**
+     * Execute a single tool call.
+     */
+    executeSingle(request: ToolCallRequest): Promise<ToolCallResult>;
+}
+//# sourceMappingURL=AsyncToolExecutor.d.ts.map

package/dist/types/AsyncToolExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AsyncToolExecutor.d.ts","sourceRoot":"","sources":["../../src/AsyncToolExecutor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAE5C,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,QAAQ,EAAE,YAAY,EAAE,WAAW,SAAI;IAKnD;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAgB1E;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;CAoBvE"}

package/dist/types/Tool.d.ts

@@ -0,0 +1,74 @@
+import "reflect-metadata";
+import { z, type ZodType } from "zod";
+import type { ToolParameter } from "./types";
+export type { ToolParameter };
+export interface OpenAIFunctionSchema {
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    };
+}
+export interface ToolActionMeta {
+    key: string;
+    description: string;
+    method: string;
+}
+/**
+ * Decorator that registers a method as a named tool action.
+ * Usage: @toolAction("action_key", "Description")
+ */
+export declare function toolAction(key: string, description: string): (target: object, propertyKey: string, _descriptor: PropertyDescriptor) => void;
+export declare abstract class Tool {
+    readonly name: string;
+    readonly description: string;
+    readonly expandable: boolean;
+    constructor(name: string, description: string, expandable?: boolean);
+    abstract run(parameters: Record<string, unknown>): Promise<string> | string;
+    abstract getParameters(): ToolParameter[];
+    /**
+     * Validate that required parameters are present and have basic types.
+     * Returns true if valid.
+     */
+    validateParameters(parameters: Record<string, unknown>): boolean;
+    /**
+     * Validate and coerce parameters, returning a Result object.
+     */
+    validateAndNormalizeParameters(parameters: Record<string, unknown>): {
+        success: true;
+        data: Record<string, unknown>;
+    } | {
+        success: false;
+        error: string;
+    };
+    /**
+     * Convert this Tool to an OpenAI function-calling schema.
+     */
+    toOpenAISchema(): OpenAIFunctionSchema;
+    /**
+     * Return a formatted description of all available tool actions (for system prompt).
+     */
+    describe(): string;
+}
+export interface FunctionTool<TArgs = Record<string, unknown>> {
+    name: string;
+    description: string;
+    func: (args: TArgs) => string | Promise<string>;
+    schema?: ZodType<TArgs>;
+}
+/**
+ * Convenience factory for creating type-safe function tools.
+ *
+ * ```ts
+ * const myTool = defineFunctionTool({
+ *   name: "myTool",
+ *   description: "...",
+ *   schema: z.object({ input: z.string() }),
+ *   func: ({ input }) => input.toUpperCase(),
+ * });
+ * ```
+ */
+export declare function defineFunctionTool<TArgs extends Record<string, unknown>>(options: FunctionTool<TArgs>): FunctionTool<TArgs>;
+export { z };
+//# sourceMappingURL=Tool.d.ts.map

package/dist/types/Tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tool.d.ts","sourceRoot":"","sources":["../../src/Tool.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAC,CAAC,EAAE,KAAK,OAAO,EAAC,MAAM,KAAK,CAAC;AACpC,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,SAAS,CAAC;AAE3C,YAAY,EAAC,aAAa,EAAC,CAAC;AAM5B,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC,CAAC;CACH;AAQD,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,IAEvD,QAAQ,MAAM,EACd,aAAa,MAAM,EACnB,aAAa,kBAAkB,KAC9B,IAAI,CAMR;AAMD,8BAAsB,IAAI;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;gBAEjB,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,UAAQ;IAMjE,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM;IAC3E,QAAQ,CAAC,aAAa,IAAI,aAAa,EAAE;IAEzC;;;OAGG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAUhE;;OAEG;IACH,8BAA8B,CAC5B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC;QAAC,OAAO,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAC,GAAG;QAAC,OAAO,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC;IAwBnF;;OAEG;IACH,cAAc,IAAI,oBAAoB;IA8BtC;;OAEG;IACH,QAAQ,IAAI,MAAM;CAUnB;AAcD,MAAM,WAAW,YAAY,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtE,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,GAC3B,YAAY,CAAC,KAAK,CAAC,CAErB;AAED,OAAO,EAAC,CAAC,EAAC,CAAC"}

package/dist/types/ToolChain.d.ts

@@ -0,0 +1,47 @@
+import { ToolRegistry } from "./ToolRegistry";
+export interface ToolChainStep {
+    /** Name of the tool/function to call */
+    toolName: string;
+    /** Input template string; use {variableName} to reference context variables */
+    inputTemplate: string;
+    /** Key under which the step output is stored in context */
+    outputKey: string;
+}
+/**
+ * A sequential chain of tool steps.
+ * Each step can reference outputs of prior steps via `{key}` placeholders.
+ *
+ * ```ts
+ * const chain = new ToolChain("my_chain", "Does X then Y");
+ * chain.addStep("search", "{input}", "search_result");
+ * chain.addStep("summarize", "{search_result}", "summary");
+ * ```
+ */
+export declare class ToolChain {
+    readonly name: string;
+    readonly description: string;
+    private readonly steps;
+    constructor(name: string, description: string);
+    addStep(toolName: string, inputTemplate: string, outputKey: string): this;
+    getSteps(): ToolChainStep[];
+    /**
+     * Execute the chain against a registry.
+     * @param registry  ToolRegistry that holds the referenced tools.
+     * @param input     Initial `{input}` value.
+     * @returns         The value stored under the last step's outputKey.
+     */
+    execute(registry: ToolRegistry, input: string): Promise<string>;
+}
+/**
+ * Manages multiple named ToolChains and executes them against a shared registry.
+ */
+export declare class ToolChainManager {
+    private readonly chains;
+    private readonly registry;
+    constructor(registry: ToolRegistry);
+    registerChain(chain: ToolChain): void;
+    getChain(name: string): ToolChain | undefined;
+    listChains(): string[];
+    executeChain(chainName: string, input: string): Promise<string>;
+}
+//# sourceMappingURL=ToolChain.d.ts.map

package/dist/types/ToolChain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolChain.d.ts","sourceRoot":"","sources":["../../src/ToolChain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAM5C,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,aAAa,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;;;;;GASG;AACH,qBAAa,SAAS;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;gBAEjC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAK7C,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAKzE,QAAQ,IAAI,aAAa,EAAE;IAI3B;;;;;OAKG;IACG,OAAO,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAatE;AAMD;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IACvD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;gBAE5B,QAAQ,EAAE,YAAY;IAIlC,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAIrC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI7C,UAAU,IAAI,MAAM,EAAE;IAIhB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAKtE"}

package/dist/types/ToolRegistry.d.ts

@@ -0,0 +1,22 @@
+import { Tool, type FunctionTool, type OpenAIFunctionSchema } from "./Tool";
+/**
+ * Central registry that manages Tool instances and raw FunctionTools.
+ * Supports registration, lookup, and execution.
+ */
+export declare class ToolRegistry {
+    private readonly tools;
+    private readonly functions;
+    registerTool(tool: Tool): void;
+    unregisterTool(name: string): boolean;
+    registerFunction<TArgs extends Record<string, unknown>>(name: string, description: string, func: (args: TArgs) => string | Promise<string>, schema?: FunctionTool<TArgs>["schema"]): void;
+    unregisterFunction(name: string): boolean;
+    getTool(name: string): Tool | undefined;
+    getFunction(name: string): FunctionTool<Record<string, unknown>> | undefined;
+    getAllTools(): Tool[];
+    listTools(): string[];
+    hasTool(name: string): boolean;
+    execute(name: string, parameters: Record<string, unknown>): Promise<string>;
+    getAvailableTools(): string;
+    getOpenAISchemas(): Array<OpenAIFunctionSchema | Record<string, unknown>>;
+}
+//# sourceMappingURL=ToolRegistry.d.ts.map

package/dist/types/ToolRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolRegistry.d.ts","sourceRoot":"","sources":["../../src/ToolRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAE,KAAK,YAAY,EAAE,KAAK,oBAAoB,EAAC,MAAM,QAAQ,CAAC;AAE1E;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4D;IAMtF,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAI9B,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIrC,gBAAgB,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpD,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,EAC/C,MAAM,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,GACrC,IAAI;IASP,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQzC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIvC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS;IAI5E,WAAW,IAAI,IAAI,EAAE;IAIrB,SAAS,IAAI,MAAM,EAAE;IAOrB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQxB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAkBjF,iBAAiB,IAAI,MAAM;IAe3B,gBAAgB,IAAI,KAAK,CAAC,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAyB1E"}

package/dist/types/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./Tool";
+export * from "./ToolChain";
+export * from "./ToolRegistry";
+export * from "./AsyncToolExecutor";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC"}

package/dist/types/types.d.ts

@@ -0,0 +1,13 @@
+export interface ToolParameter {
+    name: string;
+    type: string;
+    description: string;
+    required: boolean;
+    default: unknown;
+}
+export interface ToolResult {
+    success: boolean;
+    output: string;
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@agenticforge/tools",
+  "version": "1.0.0",
+  "description": "Tooling core for AgenticKIT",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/cjs/index.cjs",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "clean": "rimraf dist",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "build:types": "tsc -p tsconfig.build.json",
+    "build:js": "rollup -c",
+    "build": "pnpm run clean && pnpm run typecheck && pnpm run build:types && pnpm run build:js"
+  },
+  "dependencies": {
+    "reflect-metadata": "^0.2.2",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^28.0.8",
+    "@rollup/plugin-json": "^6.1.0",
+    "@rollup/plugin-node-resolve": "^16.0.1",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@types/node": "^25.3.3",
+    "rimraf": "^6.0.1",
+    "rollup": "^4.50.1",
+    "rollup-plugin-esbuild": "^6.2.1",
+    "tsx": "^4.21.0",
+    "typescript": "~5.9.3"
+  }
+}