@easynet/agent-tool 1.0.33 → 1.0.35

package/dist/index.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunkYP6GRCQG_cjs = require('./chunk-YP6GRCQG.cjs');
-var chunkLOGUQGCL_cjs = require('./chunk-LOGUQGCL.cjs');
-var chunkPKUSCCS6_cjs = require('./chunk-PKUSCCS6.cjs');
+var chunkS27O27OH_cjs = require('./chunk-S27O27OH.cjs');
+var chunkZ5STQ2JO_cjs = require('./chunk-Z5STQ2JO.cjs');
+var chunk2WDDJYR7_cjs = require('./chunk-2WDDJYR7.cjs');
 var chunkTOSPHMYU_cjs = require('./chunk-TOSPHMYU.cjs');
 require('./chunk-4KTWJQ32.cjs');
 var chunkDYDNPIV2_cjs = require('./chunk-DYDNPIV2.cjs');
@@ -281,7 +281,7 @@ function createDynamicImportAdapter(options) {
           `Extension tool ${spec.name}: export "${exportName}" from ${sourcePath} is not a function`
         );
       }
-      const ctx = getExtensionContext(execCtx, spec);
+      const ctx = getExtensionContext(execCtx, spec, mergedArgs);
       const output = await contextRunner.runWith(ctx, () => handler(handlerArgs));
       return {
         result: { result: output.result, evidence: output.evidence },
@@ -293,23 +293,26 @@ function createDynamicImportAdapter(options) {
 function loadToolYaml(packageRoot, sourcePath) {
   const dir = path6__default.default.dirname(sourcePath);
   const base = path6__default.default.basename(sourcePath);
-  const yamlPath = path6__default.default.join(packageRoot, dir, `${base}.tool.yaml`);
+  const dirPath = path6__default.default.join(packageRoot, dir);
+  const yamlPath = fs.existsSync(path6__default.default.join(dirPath, `${base}.tool.yaml`)) ? path6__default.default.join(dirPath, `${base}.tool.yaml`) : path6__default.default.join(dirPath, `${base}.example.yaml`);
   if (!fs.existsSync(yamlPath)) return void 0;
   try {
     const raw = fs.readFileSync(yamlPath, "utf-8");
     const data = yaml__default.default.load(raw);
     if (data == null || typeof data !== "object" || Array.isArray(data)) return void 0;
     const obj = data;
-    const list = obj?.tool;
-    const arr = list?.list;
+    const toolBlock = obj?.tool;
+    const arr = toolBlock?.list;
     if (!Array.isArray(arr)) return void 0;
+    const defaults = toolBlock?.defaults != null && typeof toolBlock.defaults === "object" && !Array.isArray(toolBlock.defaults) ? toolBlock.defaults : {};
     const item = arr.find(
       (e) => e != null && typeof e === "object" && e.name === base
     );
     if (!item || typeof item !== "object") return void 0;
     const { name: _n, ...rest } = item;
-    if (Object.keys(rest).length === 0) return void 0;
-    return rest;
+    const merged = { ...defaults, ...rest };
+    if (Object.keys(merged).length === 0) return void 0;
+    return merged;
   } catch {
     return void 0;
   }
@@ -362,6 +365,7 @@ function registerToolsFromManifest(registry, options) {
         ...spec._meta,
         sourcePath: entry.sourcePath,
         exportName: entry.exportName,
+        shortName: toolName,
         ...defaultArgs != null && Object.keys(defaultArgs).length > 0 && { defaultArgs }
       }
     };
@@ -393,10 +397,30 @@ function registerExtension(registry, options) {
   const adapter = createDynamicImportAdapter({
     kind,
     packageRoot,
-    getExtensionContext: (execCtx, spec) => ({
-      execCtx,
-      config: config !== void 0 ? { ...config, ...spec._meta?.defaultArgs ?? {} } : spec._meta?.defaultArgs ?? {}
-    }),
+    getExtensionContext: (execCtx, spec, mergedArgs) => {
+      const defaultArgs = spec._meta?.defaultArgs ?? {};
+      const baseConfig = config !== void 0 ? config : {};
+      const toolOverrides = baseConfig?.toolOverrides;
+      const shortName = spec._meta?.shortName ?? spec.name;
+      const prefixWithVersion = shortName && spec.name.endsWith(shortName) && spec.name.length > shortName.length ? spec.name.slice(0, spec.name.length - shortName.length - 1) : "";
+      const parts = prefixWithVersion ? prefixWithVersion.split(".") : [];
+      const packageScopedKey = parts.length > 1 ? `${parts.slice(0, -1).join(".")}::${shortName}` : "";
+      const perTool = toolOverrides?.[spec.name] ?? (packageScopedKey ? toolOverrides?.[packageScopedKey] : void 0) ?? toolOverrides?.[shortName] ?? {};
+      const packagePrefix = parts.length > 1 ? parts.slice(0, -1).join(".") : "";
+      const packageDefaults = baseConfig?.packageDefaults;
+      const packageDefaultsForPkg = (packagePrefix && packageDefaults?.[packagePrefix]) ?? (prefixWithVersion && packageDefaults?.[prefixWithVersion]) ?? {};
+      const baseWithoutOverrides = { ...baseConfig };
+      delete baseWithoutOverrides.toolOverrides;
+      delete baseWithoutOverrides.packageDefaults;
+      const resolvedConfig = {
+        ...defaultArgs,
+        ...baseWithoutOverrides,
+        ...packageDefaultsForPkg,
+        ...perTool,
+        ...mergedArgs ?? {}
+      };
+      return { execCtx, config: resolvedConfig };
+    },
     contextRunner: {
       runWith(ctx, fn) {
         return contextRunner.runWith(ctx, fn);
@@ -419,7 +443,7 @@ function createExtension(options) {
   const contextRunner = createContextRunner();
   return {
     register(registry, userConfigOrOpts, opts) {
-      const config = buildConfig ? buildConfig(userConfigOrOpts) : void 0;
+      const config = buildConfig ? buildConfig(userConfigOrOpts) : userConfigOrOpts;
       return registerExtension(registry, {
         packagePath,
         kind,
@@ -437,11 +461,27 @@ function createExtension(options) {
     }
   };
 }
+function copyToolYamlRecursive(srcDir, destDir) {
+  if (!fs.existsSync(srcDir)) return 0;
+  let copied = 0;
+  for (const e of fs.readdirSync(srcDir, { withFileTypes: true })) {
+    const srcPath = path6__default.default.join(srcDir, e.name);
+    const destPath = path6__default.default.join(destDir, e.name);
+    if (e.isFile() && (e.name.endsWith(".tool.yaml") || e.name.endsWith(".example.yaml"))) {
+      if (!fs.existsSync(destDir)) fs.mkdirSync(destDir, { recursive: true });
+      fs.copyFileSync(srcPath, destPath);
+      copied++;
+    } else if (e.isDirectory()) {
+      copied += copyToolYamlRecursive(srcPath, destPath);
+    }
+  }
+  return copied;
+}
 function generateExtensionManifest(projectRoot = process.cwd(), options = {}) {
   const root = path6__default.default.resolve(projectRoot);
   const outDir = path6__default.default.resolve(options.outDir ?? path6__default.default.join(root, "dist"));
   const kind = options.kind ?? "core";
-  const { specs, errors } = chunkLOGUQGCL_cjs.scanForTools({
+  const { specs, errors } = chunkZ5STQ2JO_cjs.scanForTools({
     projectPath: root,
     include: options.include ?? ["**/*.ts"],
     tsconfigPath: options.tsconfigPath
@@ -451,7 +491,8 @@ function generateExtensionManifest(projectRoot = process.cwd(), options = {}) {
   }
   const entries = specs.map((spec) => {
     const sourcePathNoExt = (spec.sourcePath ?? "").replace(/\.(ts|tsx)$/i, "");
-    const name = sourcePathNoExt.replace(/^src\//, "").replace(/\//g, ".");
+    const pathBasedName = sourcePathNoExt.replace(/^src\//, "").replace(/\//g, ".");
+    const name = spec.exportName ?? pathBasedName;
     const sideEffect = spec._meta?.hitl?.sideEffect ?? "none";
     return {
       name,
@@ -476,28 +517,22 @@ function generateExtensionManifest(projectRoot = process.cwd(), options = {}) {
     for (const d of copyDirs) {
       const srcDir = path6__default.default.join(root, d);
       const destDir = path6__default.default.join(outDir, d);
-      if (!fs.existsSync(srcDir)) continue;
       try {
-        for (const e of fs.readdirSync(srcDir, { withFileTypes: true })) {
-          if (e.isFile() && e.name.endsWith(".tool.yaml")) {
-            if (!fs.existsSync(destDir)) fs.mkdirSync(destDir, { recursive: true });
-            fs.copyFileSync(path6__default.default.join(srcDir, e.name), path6__default.default.join(destDir, e.name));
-            toolYamlCopied++;
-          }
-        }
+        toolYamlCopied += copyToolYamlRecursive(srcDir, destDir);
       } catch {
       }
     }
   }
   return { manifestPath, toolsCount: entries.length, toolYamlCopied };
 }
-function generateManifest(projectRoot = process.cwd()) {
+function generateManifest(projectRoot = process.cwd(), options = {}) {
   const { manifestPath, toolsCount, toolYamlCopied } = generateExtensionManifest(projectRoot, {
     include: ["src/**/*.ts"],
-    copyToolYamlDirs: ["src"]
+    copyToolYamlDirs: ["src"],
+    ...options
   });
   console.log(`Wrote ${toolsCount} tools to ${path6__default.default.relative(projectRoot, manifestPath)}`);
-  if (toolYamlCopied > 0) console.log(`Copied ${toolYamlCopied} tool.yaml file(s) to dist`);
+  if (toolYamlCopied > 0) console.log(`Copied ${toolYamlCopied} .tool.yaml/.example.yaml file(s) to dist`);
 }
 
 // src/api/extension/groupPrefix.ts
@@ -524,7 +559,7 @@ var MCPClientAdapter = class {
   constructor(client) {
     this.client = client;
   }
-  kind = chunkPKUSCCS6_cjs.MCP_KIND;
+  kind = chunk2WDDJYR7_cjs.MCP_KIND;
   async invoke(spec, args, _ctx) {
     const params = args != null && typeof args === "object" && !Array.isArray(args) ? args : {};
     const result = await this.client.callTool({ name: spec.name, arguments: params });
@@ -565,7 +600,7 @@ function mcpToolsToSpecs(tools) {
   return tools.map((t) => ({
     name: t.name,
     version: "1.0.0",
-    kind: chunkPKUSCCS6_cjs.MCP_KIND,
+    kind: chunk2WDDJYR7_cjs.MCP_KIND,
     description: t.description ?? `MCP tool: ${t.name}`,
     inputSchema: t.inputSchema ?? chunkDYDNPIV2_cjs.DEFAULT_INPUT_SCHEMA,
     outputSchema: chunkDYDNPIV2_cjs.DEFAULT_OUTPUT_SCHEMA,
@@ -605,8 +640,8 @@ async function registerMCPToolsFromConfig(runtime, registry, options = {}) {
   const configPath = options.configPath ?? process.env.MCP_CONFIG_PATH ?? path6.join(process.cwd(), "mcp.json");
   const dirPath = path6.dirname(configPath);
   const entryPoint = path6.basename(configPath);
-  const toolName = options.toolName ?? chunkPKUSCCS6_cjs.MCP_KIND;
-  const loaded = await chunkLOGUQGCL_cjs.loadMCPTool(dirPath, { kind: chunkPKUSCCS6_cjs.MCP_KIND, name: toolName, entryPoint });
+  const toolName = options.toolName ?? chunk2WDDJYR7_cjs.MCP_KIND;
+  const loaded = await chunkZ5STQ2JO_cjs.loadMCPTool(dirPath, { kind: chunk2WDDJYR7_cjs.MCP_KIND, name: toolName, entryPoint });
   if (!loaded.mcpConfig) {
     throw new Error("mcp.json must have command or url");
   }
@@ -622,167 +657,171 @@ async function registerMCPToolsFromConfig(runtime, registry, options = {}) {
 
 Object.defineProperty(exports, "LangChainToolsHub", {
   enumerable: true,
-  get: function () { return chunkYP6GRCQG_cjs.LangChainToolsHub; }
+  get: function () { return chunkS27O27OH_cjs.LangChainToolsHub; }
 });
 Object.defineProperty(exports, "createAgentTools", {
   enumerable: true,
-  get: function () { return chunkYP6GRCQG_cjs.createAgentTools; }
+  get: function () { return chunkS27O27OH_cjs.createAgentTools; }
 });
 Object.defineProperty(exports, "DirectoryScanner", {
   enumerable: true,
-  get: function () { return chunkLOGUQGCL_cjs.DirectoryScanner; }
+  get: function () { return chunkZ5STQ2JO_cjs.DirectoryScanner; }
 });
 Object.defineProperty(exports, "DiscoveryError", {
   enumerable: true,
-  get: function () { return chunkLOGUQGCL_cjs.DiscoveryError; }
+  get: function () { return chunkZ5STQ2JO_cjs.DiscoveryError; }
 });
 Object.defineProperty(exports, "SkillManifestError", {
   enumerable: true,
-  get: function () { return chunkLOGUQGCL_cjs.SkillManifestError; }
+  get: function () { return chunkZ5STQ2JO_cjs.SkillManifestError; }
 });
 Object.defineProperty(exports, "buildFunctionToTool", {
   enumerable: true,
-  get: function () { return chunkLOGUQGCL_cjs.buildFunctionToTool; }
+  get: function () { return chunkZ5STQ2JO_cjs.buildFunctionToTool; }
 });
 Object.defineProperty(exports, "buildMcpPackage", {
   enumerable: true,
-  get: function () { return chunkLOGUQGCL_cjs.buildMcpPackage; }
+  get: function () { return chunkZ5STQ2JO_cjs.buildMcpPackage; }
 });
 Object.defineProperty(exports, "initProject", {
   enumerable: true,
-  get: function () { return chunkLOGUQGCL_cjs.initProject; }
+  get: function () { return chunkZ5STQ2JO_cjs.initProject; }
 });
 Object.defineProperty(exports, "loadMCPTool", {
   enumerable: true,
-  get: function () { return chunkLOGUQGCL_cjs.loadMCPTool; }
+  get: function () { return chunkZ5STQ2JO_cjs.loadMCPTool; }
 });
 Object.defineProperty(exports, "loadSkillDefinition", {
   enumerable: true,
-  get: function () { return chunkLOGUQGCL_cjs.loadSkillDefinition; }
+  get: function () { return chunkZ5STQ2JO_cjs.loadSkillDefinition; }
 });
 Object.defineProperty(exports, "parseSkillMd", {
   enumerable: true,
-  get: function () { return chunkLOGUQGCL_cjs.parseSkillMd; }
+  get: function () { return chunkZ5STQ2JO_cjs.parseSkillMd; }
 });
 Object.defineProperty(exports, "runGeneratedMCP", {
   enumerable: true,
-  get: function () { return chunkLOGUQGCL_cjs.runGeneratedMCP; }
+  get: function () { return chunkZ5STQ2JO_cjs.runGeneratedMCP; }
 });
 Object.defineProperty(exports, "runMcpServer", {
   enumerable: true,
-  get: function () { return chunkLOGUQGCL_cjs.runMcpServer; }
+  get: function () { return chunkZ5STQ2JO_cjs.runMcpServer; }
 });
 Object.defineProperty(exports, "scan", {
   enumerable: true,
-  get: function () { return chunkLOGUQGCL_cjs.scan; }
+  get: function () { return chunkZ5STQ2JO_cjs.scan; }
 });
 Object.defineProperty(exports, "scanForTools", {
   enumerable: true,
-  get: function () { return chunkLOGUQGCL_cjs.scanForTools; }
+  get: function () { return chunkZ5STQ2JO_cjs.scanForTools; }
 });
 Object.defineProperty(exports, "scanSkillResources", {
   enumerable: true,
-  get: function () { return chunkLOGUQGCL_cjs.scanSkillResources; }
+  get: function () { return chunkZ5STQ2JO_cjs.scanSkillResources; }
 });
 Object.defineProperty(exports, "validateFrontmatter", {
   enumerable: true,
-  get: function () { return chunkLOGUQGCL_cjs.validateFrontmatter; }
+  get: function () { return chunkZ5STQ2JO_cjs.validateFrontmatter; }
 });
 Object.defineProperty(exports, "BudgetManager", {
   enumerable: true,
-  get: function () { return chunkPKUSCCS6_cjs.BudgetManager; }
+  get: function () { return chunk2WDDJYR7_cjs.BudgetManager; }
 });
 Object.defineProperty(exports, "EventLog", {
   enumerable: true,
-  get: function () { return chunkPKUSCCS6_cjs.EventLog; }
+  get: function () { return chunk2WDDJYR7_cjs.EventLog; }
 });
 Object.defineProperty(exports, "Metrics", {
   enumerable: true,
-  get: function () { return chunkPKUSCCS6_cjs.Metrics; }
+  get: function () { return chunk2WDDJYR7_cjs.Metrics; }
 });
 Object.defineProperty(exports, "PTCRuntime", {
   enumerable: true,
-  get: function () { return chunkPKUSCCS6_cjs.PTCRuntime; }
+  get: function () { return chunk2WDDJYR7_cjs.PTCRuntime; }
 });
 Object.defineProperty(exports, "PolicyDeniedError", {
   enumerable: true,
-  get: function () { return chunkPKUSCCS6_cjs.PolicyDeniedError; }
+  get: function () { return chunk2WDDJYR7_cjs.PolicyDeniedError; }
 });
 Object.defineProperty(exports, "PolicyEngine", {
   enumerable: true,
-  get: function () { return chunkPKUSCCS6_cjs.PolicyEngine; }
+  get: function () { return chunk2WDDJYR7_cjs.PolicyEngine; }
 });
 Object.defineProperty(exports, "SchemaValidationError", {
   enumerable: true,
-  get: function () { return chunkPKUSCCS6_cjs.SchemaValidationError; }
+  get: function () { return chunk2WDDJYR7_cjs.SchemaValidationError; }
 });
 Object.defineProperty(exports, "SchemaValidator", {
   enumerable: true,
-  get: function () { return chunkPKUSCCS6_cjs.SchemaValidator; }
+  get: function () { return chunk2WDDJYR7_cjs.SchemaValidator; }
 });
 Object.defineProperty(exports, "Tracing", {
   enumerable: true,
-  get: function () { return chunkPKUSCCS6_cjs.Tracing; }
+  get: function () { return chunk2WDDJYR7_cjs.Tracing; }
 });
 Object.defineProperty(exports, "buildEvidence", {
   enumerable: true,
-  get: function () { return chunkPKUSCCS6_cjs.buildEvidence; }
+  get: function () { return chunk2WDDJYR7_cjs.buildEvidence; }
 });
 Object.defineProperty(exports, "createLogger", {
   enumerable: true,
-  get: function () { return chunkPKUSCCS6_cjs.createLogger; }
+  get: function () { return chunk2WDDJYR7_cjs.createLogger; }
 });
 Object.defineProperty(exports, "ensurePackageInCache", {
   enumerable: true,
-  get: function () { return chunkPKUSCCS6_cjs.ensurePackageInCache; }
+  get: function () { return chunk2WDDJYR7_cjs.ensurePackageInCache; }
 });
 Object.defineProperty(exports, "expandToolDescriptorsToRegistryNames", {
   enumerable: true,
-  get: function () { return chunkPKUSCCS6_cjs.expandToolDescriptorsToRegistryNames; }
+  get: function () { return chunk2WDDJYR7_cjs.expandToolDescriptorsToRegistryNames; }
 });
 Object.defineProperty(exports, "getPackageEntryPath", {
   enumerable: true,
-  get: function () { return chunkPKUSCCS6_cjs.getPackageEntryPath; }
+  get: function () { return chunk2WDDJYR7_cjs.getPackageEntryPath; }
 });
 Object.defineProperty(exports, "importFromCache", {
   enumerable: true,
-  get: function () { return chunkPKUSCCS6_cjs.importFromCache; }
+  get: function () { return chunk2WDDJYR7_cjs.importFromCache; }
 });
 Object.defineProperty(exports, "isNpmToolDescriptor", {
   enumerable: true,
-  get: function () { return chunkPKUSCCS6_cjs.isNpmToolDescriptor; }
+  get: function () { return chunk2WDDJYR7_cjs.isNpmToolDescriptor; }
 });
 Object.defineProperty(exports, "loadToolConfig", {
   enumerable: true,
-  get: function () { return chunkPKUSCCS6_cjs.loadToolConfig; }
+  get: function () { return chunk2WDDJYR7_cjs.loadToolConfig; }
 });
 Object.defineProperty(exports, "normalizeToolList", {
   enumerable: true,
-  get: function () { return chunkPKUSCCS6_cjs.normalizeToolList; }
+  get: function () { return chunk2WDDJYR7_cjs.normalizeToolList; }
 });
 Object.defineProperty(exports, "npmDescriptorToRegistryPrefix", {
   enumerable: true,
-  get: function () { return chunkPKUSCCS6_cjs.npmDescriptorToRegistryPrefix; }
+  get: function () { return chunk2WDDJYR7_cjs.npmDescriptorToRegistryPrefix; }
 });
 Object.defineProperty(exports, "parseNpmToolDescriptor", {
   enumerable: true,
-  get: function () { return chunkPKUSCCS6_cjs.parseNpmToolDescriptor; }
+  get: function () { return chunk2WDDJYR7_cjs.parseNpmToolDescriptor; }
+});
+Object.defineProperty(exports, "resolveLatestVersionFromRegistry", {
+  enumerable: true,
+  get: function () { return chunk2WDDJYR7_cjs.resolveLatestVersionFromRegistry; }
 });
 Object.defineProperty(exports, "resolveNpmToolDescriptor", {
   enumerable: true,
-  get: function () { return chunkPKUSCCS6_cjs.resolveNpmToolDescriptor; }
+  get: function () { return chunk2WDDJYR7_cjs.resolveNpmToolDescriptor; }
 });
 Object.defineProperty(exports, "resolveToolDescriptor", {
   enumerable: true,
-  get: function () { return chunkPKUSCCS6_cjs.resolveToolDescriptor; }
+  get: function () { return chunk2WDDJYR7_cjs.resolveToolDescriptor; }
 });
 Object.defineProperty(exports, "sanitizeForLog", {
   enumerable: true,
-  get: function () { return chunkPKUSCCS6_cjs.sanitizeForLog; }
+  get: function () { return chunk2WDDJYR7_cjs.sanitizeForLog; }
 });
 Object.defineProperty(exports, "summarizeForLog", {
   enumerable: true,
-  get: function () { return chunkPKUSCCS6_cjs.summarizeForLog; }
+  get: function () { return chunk2WDDJYR7_cjs.summarizeForLog; }
 });
 Object.defineProperty(exports, "ToolRegistry", {
   enumerable: true,