@agenticforge/tools 1.0.2 → 1.1.1

package/README.en.md

@@ -0,0 +1,53 @@
+# @agenticforge/tools
+
+[![npm](https://img.shields.io/npm/v/@agenticforge/tools)](https://www.npmjs.com/package/@agenticforge/tools)
+[![license](https://img.shields.io/github/license/LittleBlacky/AgenticFORGE)](https://github.com/LittleBlacky/AgenticFORGE/blob/main/LICENSE)
+
+Tool abstraction layer for AgenticFORGE — `Tool` base class, `ToolRegistry`, `ToolChain`, and async executor.
+
+## Installation
+
+```bash
+npm install @agenticforge/tools
+```
+
+## Exports
+
+| Name | Description |
+|------|-------------|
+| `Tool` | Tool base class — wraps parameter definitions and execution logic |
+| `toolAction` | Tool action factory with Zod-based parameter validation |
+| `ToolRegistry` | Registry for managing available tools |
+| `ToolChain` | Tool chain — compose multiple tools in sequence or parallel |
+| `AsyncToolExecutor` | Async tool executor with timeout and concurrency control |
+
+## Usage
+
+```ts
+import {Tool, toolAction, ToolRegistry} from "@agenticforge/tools";
+import {z} from "zod";
+
+const searchTool = new Tool({
+  name: "search",
+  description: "Search the web for information",
+  parameters: [
+    {name: "query", type: "string", description: "Search query", required: true},
+  ],
+  action: toolAction(z.object({query: z.string()}), async ({query}) => {
+    return `Search results for: ${query}`;
+  }),
+});
+
+const registry = new ToolRegistry();
+registry.register(searchTool);
+
+const tool = registry.get("search");
+const result = await tool.execute({query: "AgenticFORGE"});
+console.log(result);
+```
+
+## Links
+
+- [GitHub](https://github.com/LittleBlacky/AgenticFORGE/tree/main/packages/tools)
+- [npm](https://www.npmjs.com/package/@agenticforge/tools)
+- [Root README](https://github.com/LittleBlacky/AgenticFORGE)

package/dist/cjs/index.cjs

@@ -1,341 +1 @@
-'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
+"use strict";var t=require("zod");const e=Symbol("tool:actions");function n(t){const e=(t??"string").toLowerCase();return["string","number","integer","boolean","array","object"].includes(e)?e:"string"}function s(t,e){return t.replace(/\{(\w+)\}/g,(t,n)=>e[n]??`{${n}}`)}Object.defineProperty(exports,"z",{enumerable:!0,get:function(){return t.z}}),exports.AsyncToolExecutor=class{registry;concurrency;constructor(t,e=4){this.registry=t,this.concurrency=Math.max(1,e)}async executeBatch(t){const e=[];let n=0;const s=Array.from({length:Math.min(this.concurrency,t.length)},async()=>{for(;n<t.length;){const s=t[n++];e.push(await this.executeSingle(s))}});return await Promise.all(s),e}async executeSingle(t){const e=Date.now();try{const n=await this.registry.execute(t.toolName,t.parameters);return{id:t.id,toolName:t.toolName,output:n,durationMs:Date.now()-e}}catch(n){return{id:t.id,toolName:t.toolName,output:"",error:n instanceof Error?n.message:String(n),durationMs:Date.now()-e}}}},exports.Tool=class{name;description;expandable;constructor(t,e,n=!1){this.name=t,this.description=e,this.expandable=n}validateParameters(t){const e=this.getParameters();for(const n of e)if(n.required&&(void 0===t[n.name]||null===t[n.name]))return!1;return!0}validateAndNormalizeParameters(t){const e=this.getParameters(),n={};for(const s of e){const e=t[s.name];if(null==e){if(s.required)return{success:!1,error:`Missing required parameter: ${s.name}`};n[s.name]=s.default}else n[s.name]=e}for(const[e,s]of Object.entries(t))e in n||(n[e]=s);return{success:!0,data:n}}toOpenAISchema(){const t=this.getParameters(),e={},s=[];for(const r of t)e[r.name]={type:n(r.type),description:r.description,...null!==r.default&&void 0!==r.default?{default:r.default}:{}},r.required&&s.push(r.name);return{type:"function",function:{name:this.name,description:this.description,parameters:{type:"object",properties:e,...s.length>0?{required:s}:{}}}}}describe(){const t=this.getParameters().map(t=>`  - ${t.name} (${t.type}${t.required?", required":""}): ${t.description}`).join("\n");return`Tool: ${this.name}\nDescription: ${this.description}\nParameters:\n${t}`}},exports.ToolChain=class{name;description;steps=[];constructor(t,e){this.name=t,this.description=e}addStep(t,e,n){return this.steps.push({toolName:t,inputTemplate:e,outputKey:n}),this}getSteps(){return[...this.steps]}async execute(t,e){const n={input:e};for(const e of this.steps){const r=s(e.inputTemplate,n),o=await t.execute(e.toolName,{input:r});n[e.outputKey]=o}const r=this.steps[this.steps.length-1];return r?n[r.outputKey]??e:e}},exports.ToolChainManager=class{chains=new Map;registry;constructor(t){this.registry=t}registerChain(t){this.chains.set(t.name,t)}getChain(t){return this.chains.get(t)}listChains(){return Array.from(this.chains.keys())}async executeChain(t,e){const n=this.chains.get(t);if(!n)throw new Error(`ToolChain not found: ${t}`);return n.execute(this.registry,e)}},exports.ToolRegistry=class{tools=new Map;functions=new Map;registerTool(t){this.tools.set(t.name,t)}unregisterTool(t){return this.tools.delete(t)}registerFunction(t,e,n,s){this.functions.set(t,{name:t,description:e,func:n,schema:s})}unregisterFunction(t){return this.functions.delete(t)}getTool(t){return this.tools.get(t)}getFunction(t){return this.functions.get(t)}getAllTools(){return Array.from(this.tools.values())}listTools(){return[...Array.from(this.tools.keys()),...Array.from(this.functions.keys())]}hasTool(t){return this.tools.has(t)||this.functions.has(t)}async execute(t,e){const n=this.tools.get(t);if(n)return await n.run(e);const s=this.functions.get(t);if(s)return await s.func(e);throw new Error(`Tool not found: ${t}`)}getAvailableTools(){const t=[];for(const e of this.tools.values())t.push(e.describe());for(const e of this.functions.values())t.push(`Tool: ${e.name}\nDescription: ${e.description}`);return 0===t.length?"暂无可用工具":t.join("\n\n")}getOpenAISchemas(){const t=[];for(const e of this.tools.values())t.push(e.toOpenAISchema());for(const e of this.functions.values())t.push({type:"function",function:{name:e.name,description:e.description,parameters:{type:"object",properties:{input:{type:"string",description:"输入文本"}}}}});return t}},exports.defineFunctionTool=function(t){return t},exports.toolAction=function(t,n){return function(s,r,o){const i=Reflect.getMetadata(e,s)??[];i.push({key:t,description:n,method:r}),Reflect.defineMetadata(e,i,s)}};

package/dist/esm/index.js

@@ -1,329 +1 @@
-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
+export{z}from"zod";const t=Symbol("tool:actions");function e(e,n){return function(s,r,o){const i=Reflect.getMetadata(t,s)??[];i.push({key:e,description:n,method:r}),Reflect.defineMetadata(t,i,s)}}class n{name;description;expandable;constructor(t,e,n=!1){this.name=t,this.description=e,this.expandable=n}validateParameters(t){const e=this.getParameters();for(const n of e)if(n.required&&(void 0===t[n.name]||null===t[n.name]))return!1;return!0}validateAndNormalizeParameters(t){const e=this.getParameters(),n={};for(const s of e){const e=t[s.name];if(null==e){if(s.required)return{success:!1,error:`Missing required parameter: ${s.name}`};n[s.name]=s.default}else n[s.name]=e}for(const[e,s]of Object.entries(t))e in n||(n[e]=s);return{success:!0,data:n}}toOpenAISchema(){const t=this.getParameters(),e={},n=[];for(const r of t)e[r.name]={type:s(r.type),description:r.description,...null!==r.default&&void 0!==r.default?{default:r.default}:{}},r.required&&n.push(r.name);return{type:"function",function:{name:this.name,description:this.description,parameters:{type:"object",properties:e,...n.length>0?{required:n}:{}}}}}describe(){const t=this.getParameters().map(t=>`  - ${t.name} (${t.type}${t.required?", required":""}): ${t.description}`).join("\n");return`Tool: ${this.name}\nDescription: ${this.description}\nParameters:\n${t}`}}function s(t){const e=(t??"string").toLowerCase();return["string","number","integer","boolean","array","object"].includes(e)?e:"string"}function r(t){return t}class o{name;description;steps=[];constructor(t,e){this.name=t,this.description=e}addStep(t,e,n){return this.steps.push({toolName:t,inputTemplate:e,outputKey:n}),this}getSteps(){return[...this.steps]}async execute(t,e){const n={input:e};for(const e of this.steps){const s=a(e.inputTemplate,n),r=await t.execute(e.toolName,{input:s});n[e.outputKey]=r}const s=this.steps[this.steps.length-1];return s?n[s.outputKey]??e:e}}class i{chains=new Map;registry;constructor(t){this.registry=t}registerChain(t){this.chains.set(t.name,t)}getChain(t){return this.chains.get(t)}listChains(){return Array.from(this.chains.keys())}async executeChain(t,e){const n=this.chains.get(t);if(!n)throw new Error(`ToolChain not found: ${t}`);return n.execute(this.registry,e)}}function a(t,e){return t.replace(/\{(\w+)\}/g,(t,n)=>e[n]??`{${n}}`)}class c{tools=new Map;functions=new Map;registerTool(t){this.tools.set(t.name,t)}unregisterTool(t){return this.tools.delete(t)}registerFunction(t,e,n,s){this.functions.set(t,{name:t,description:e,func:n,schema:s})}unregisterFunction(t){return this.functions.delete(t)}getTool(t){return this.tools.get(t)}getFunction(t){return this.functions.get(t)}getAllTools(){return Array.from(this.tools.values())}listTools(){return[...Array.from(this.tools.keys()),...Array.from(this.functions.keys())]}hasTool(t){return this.tools.has(t)||this.functions.has(t)}async execute(t,e){const n=this.tools.get(t);if(n)return await n.run(e);const s=this.functions.get(t);if(s)return await s.func(e);throw new Error(`Tool not found: ${t}`)}getAvailableTools(){const t=[];for(const e of this.tools.values())t.push(e.describe());for(const e of this.functions.values())t.push(`Tool: ${e.name}\nDescription: ${e.description}`);return 0===t.length?"暂无可用工具":t.join("\n\n")}getOpenAISchemas(){const t=[];for(const e of this.tools.values())t.push(e.toOpenAISchema());for(const e of this.functions.values())t.push({type:"function",function:{name:e.name,description:e.description,parameters:{type:"object",properties:{input:{type:"string",description:"输入文本"}}}}});return t}}class u{registry;concurrency;constructor(t,e=4){this.registry=t,this.concurrency=Math.max(1,e)}async executeBatch(t){const e=[];let n=0;const s=Array.from({length:Math.min(this.concurrency,t.length)},async()=>{for(;n<t.length;){const s=t[n++];e.push(await this.executeSingle(s))}});return await Promise.all(s),e}async executeSingle(t){const e=Date.now();try{const n=await this.registry.execute(t.toolName,t.parameters);return{id:t.id,toolName:t.toolName,output:n,durationMs:Date.now()-e}}catch(n){return{id:t.id,toolName:t.toolName,output:"",error:n instanceof Error?n.message:String(n),durationMs:Date.now()-e}}}}export{u as AsyncToolExecutor,n as Tool,o as ToolChain,i as ToolChainManager,c as ToolRegistry,r as defineFunctionTool,e as toolAction};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenticforge/tools",
-  "version": "1.0.2",
+  "version": "1.1.1",
   "description": "Tooling core for AgenticFORGE",
   "type": "module",
   "sideEffects": false,

package/dist/cjs/index.cjs.map

@@ -1 +0,0 @@
-{"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.map

@@ -1 +0,0 @@
-{"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":"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"}