@easynet/agent-tool 1.0.73 → 1.0.75

package/dist/index.cjs

@@ -3,11 +3,11 @@
 require('./chunk-YL6RC7HQ.cjs');
 var chunkOKKBKZWK_cjs = require('./chunk-OKKBKZWK.cjs');
 var chunkR55NXJIH_cjs = require('./chunk-R55NXJIH.cjs');
-var chunkZZHS55OM_cjs = require('./chunk-ZZHS55OM.cjs');
+var chunkSR53PQTG_cjs = require('./chunk-SR53PQTG.cjs');
 require('./chunk-ICHSEIZN.cjs');
 require('./chunk-NOGGIM7B.cjs');
 var chunkTBDSFXNG_cjs = require('./chunk-TBDSFXNG.cjs');
-var chunkQVXWW657_cjs = require('./chunk-QVXWW657.cjs');
+var chunkPYTHEY6A_cjs = require('./chunk-PYTHEY6A.cjs');
 require('./chunk-UUNG3GL3.cjs');
 require('./chunk-33N4Y6IS.cjs');
 var chunkLHKEJNKL_cjs = require('./chunk-LHKEJNKL.cjs');
@@ -36,7 +36,7 @@ function normalizeAgentToolConfigRef(raw) {
 // src/config/index.ts
 function loadToolRuntimeConfig(options = {}) {
   const configPath = path.resolve(options.configPath ?? "config/tool.yaml");
-  return chunkQVXWW657_cjs.loadToolConfig(configPath);
+  return chunkPYTHEY6A_cjs.loadToolConfig(configPath);
 }
 function createToolConfig(options = {}) {
   const base = loadToolRuntimeConfig(options);
@@ -86,57 +86,57 @@ var platformApi = {
   }
 };
 
-Object.defineProperty(exports, "createAgentTools", {
+Object.defineProperty(exports, "createAgentToolRegistry", {
   enumerable: true,
-  get: function () { return chunkZZHS55OM_cjs.createAgentTools; }
+  get: function () { return chunkSR53PQTG_cjs.createAgentToolRegistry; }
 });
 Object.defineProperty(exports, "createLangChainToolsAsync", {
   enumerable: true,
-  get: function () { return chunkZZHS55OM_cjs.createLangChainToolsAsync; }
+  get: function () { return chunkSR53PQTG_cjs.createLangChainToolsAsync; }
 });
 Object.defineProperty(exports, "langchainApi", {
   enumerable: true,
-  get: function () { return chunkZZHS55OM_cjs.langchainApi; }
+  get: function () { return chunkSR53PQTG_cjs.langchainApi; }
 });
 Object.defineProperty(exports, "mcpApi", {
   enumerable: true,
-  get: function () { return chunkZZHS55OM_cjs.mcpApi; }
+  get: function () { return chunkSR53PQTG_cjs.mcpApi; }
 });
 Object.defineProperty(exports, "openApi", {
   enumerable: true,
-  get: function () { return chunkZZHS55OM_cjs.openApi; }
+  get: function () { return chunkSR53PQTG_cjs.openApi; }
 });
 Object.defineProperty(exports, "runtimeApi", {
   enumerable: true,
-  get: function () { return chunkZZHS55OM_cjs.runtimeApi; }
+  get: function () { return chunkSR53PQTG_cjs.runtimeApi; }
 });
 Object.defineProperty(exports, "createMCPServer", {
   enumerable: true,
-  get: function () { return chunkQVXWW657_cjs.createMCPServer; }
+  get: function () { return chunkPYTHEY6A_cjs.createMCPServer; }
 });
 Object.defineProperty(exports, "createMCPServerStreamableHttp", {
   enumerable: true,
-  get: function () { return chunkQVXWW657_cjs.createMCPServerStreamableHttp; }
+  get: function () { return chunkPYTHEY6A_cjs.createMCPServerStreamableHttp; }
 });
 Object.defineProperty(exports, "createMCPStreamableHttpHandler", {
   enumerable: true,
-  get: function () { return chunkQVXWW657_cjs.createMCPStreamableHttpHandler; }
+  get: function () { return chunkPYTHEY6A_cjs.createMCPStreamableHttpHandler; }
 });
 Object.defineProperty(exports, "createOpenAPIServer", {
   enumerable: true,
-  get: function () { return chunkQVXWW657_cjs.createHttpService; }
+  get: function () { return chunkPYTHEY6A_cjs.createHttpService; }
 });
 Object.defineProperty(exports, "createRuntimeFromConfig", {
   enumerable: true,
-  get: function () { return chunkQVXWW657_cjs.createRuntimeFromConfig; }
+  get: function () { return chunkPYTHEY6A_cjs.createRuntimeFromConfig; }
 });
 Object.defineProperty(exports, "createRuntimeFromConfigSync", {
   enumerable: true,
-  get: function () { return chunkQVXWW657_cjs.createRuntimeFromConfigSync; }
+  get: function () { return chunkPYTHEY6A_cjs.createRuntimeFromConfigSync; }
 });
 Object.defineProperty(exports, "runMCPServerOverStdio", {
   enumerable: true,
-  get: function () { return chunkQVXWW657_cjs.runMCPServerOverStdio; }
+  get: function () { return chunkPYTHEY6A_cjs.runMCPServerOverStdio; }
 });
 Object.defineProperty(exports, "ToolRegistry", {
   enumerable: true,

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/config/ref.ts","../src/config/index.ts","../src/index.ts"],"names":["resolve","loadToolConfig","deepMerge","initProject","buildMCPPackage","runMCPServer","scanForTools","scan","createExtension","generateManifest","generateExtensionManifest","registerExtension","registerToolsFromManifest","loadExtensionManifest","loadToolYaml","resolveExtensionPackageRoot","overrideWithConfig","getGroupNamePrefixes","createDynamicImportAdapter","createContextRunner","resolveSandboxedPath","setSandboxValidationEnabled","validateUrl","isIpInBlockedCidrs","createToolSpec","DEFAULT_INPUT_SCHEMA","DEFAULT_OUTPUT_SCHEMA","createTaggedError","withRetry","isRetryable","ToolRegistry"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAOA,SAAS,SAAS,KAAA,EAAqD;AACrE,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,OAAQ,KAAA,GAAoC,MAAA;AAC5F;AAGO,SAAS,4BAA4B,GAAA,EAA2C;AACrF,EAAA,IAAI,OAAO,GAAA,KAAQ,QAAA,IAAY,GAAA,CAAI,IAAA,EAAK,CAAE,MAAA,GAAS,CAAA,EAAG,OAAO,EAAE,GAAA,EAAK,GAAA,CAAI,MAAK,EAAE;AAC/E,EAAA,MAAM,GAAA,GAAM,SAAS,GAAG,CAAA;AACxB,EAAA,IAAI,CAAC,GAAA,EAAK,OAAO,EAAC;AAElB,EAAA,MAAM,MAAmC,EAAC;AAC1C,EAAA,IAAI,OAAO,GAAA,CAAI,GAAA,KAAQ,QAAA,IAAY,IAAI,GAAA,CAAI,IAAA,EAAK,CAAE,MAAA,GAAS,CAAA,EAAG,GAAA,CAAI,GAAA,GAAM,GAAA,CAAI,IAAI,IAAA,EAAK;AACrF,EAAA,IAAI,OAAO,GAAA,CAAI,WAAA,KAAgB,QAAA,IAAY,IAAI,WAAA,CAAY,IAAA,EAAK,CAAE,MAAA,GAAS,CAAA,EAAG,GAAA,CAAI,WAAA,GAAc,GAAA,CAAI,YAAY,IAAA,EAAK;AACrH,EAAA,IAAI,OAAO,GAAA,CAAI,UAAA,KAAe,QAAA,IAAY,IAAI,UAAA,CAAW,IAAA,EAAK,CAAE,MAAA,GAAS,CAAA,EAAG,GAAA,CAAI,UAAA,GAAa,GAAA,CAAI,WAAW,IAAA,EAAK;AACjH,EAAA,OAAO,GAAA;AACT;;;ACPO,SAAS,qBAAA,CAAsB,OAAA,GAAiC,EAAC,EAAkB;AACxF,EAAA,MAAM,UAAA,GAAaA,YAAA,CAAQ,OAAA,CAAQ,UAAA,IAAc,kBAAkB,CAAA;AACnE,EAAA,OAAOC,iCAAe,UAAU,CAAA;AAClC;AAEO,SAAS,gBAAA,CAAiB,OAAA,GAAmC,EAAC,EAAkB;AACrF,EAAA,MAAM,IAAA,GAAO,sBAAsB,OAAO,CAAA;AAC1C,EAAA,IAAI,CAAC,OAAA,CAAQ,SAAA,EAAW,OAAO,IAAA;AAC/B,EAAA,OAAOC,qBAAA,CAAU,EAAC,EAAoB,IAAA,EAAM,QAAQ,SAAS,CAAA;AAC/D;;;AC8DO,IAAM,WAAA,GAAc;AAAA,EACzB,KAAA,EAAO;AAAA,iBACLC,6BAAA;AAAA,qBACAC,iCAAA;AAAA,kBACAC,8BAAA;AAAA,kBACAC,8BAAA;AAAA,UACAC;AAAA,GACF;AAAA,EACA,SAAA,EAAW;AAAA,qBACTC,iCAAA;AAAA,sBACAC,kCAAA;AAAA,+BACAC,2CAAA;AAAA,uBACAC,mCAAA;AAAA,+BACAC,2CAAA;AAAA,2BACAC,uCAAA;AAAA,kBACAC,8BAAA;AAAA,iCACAC,6CAAA;AAAA,wBACAC,oCAAA;AAAA,0BACAC,sCAAA;AAAA,gCACAC,4CAAA;AAAA,yBACAC;AAAA,GACF;AAAA,EACA,QAAA,EAAU;AAAA,0BACRC,sCAAA;AAAA,iCACAC,6CAAA;AAAA,iBACAC,6BAAA;AAAA,wBACAC;AAAA,GACF;AAAA,EACA,IAAA,EAAM;AAAA,oBACJC,gCAAA;AAAA,0BACAC,sCAAA;AAAA,2BACAC;AAAA,GACF;AAAA,EACA,OAAA,EAAS;AAAA,uBACPC,mCAAA;AAAA,eACAC,2BAAA;AAAA,iBACAC,6BAAA;AAAA,kBACAC;AAAA;AAEJ","file":"index.cjs","sourcesContent":["/** Agent-level reference to tool config files by environment. */\nexport interface AgentToolConfigRef {\n  ref?: string;\n  development?: string;\n  production?: string;\n}\n\nfunction asObject(input: unknown): Record<string, unknown> | undefined {\n  return typeof input === \"object\" && input !== null ? (input as Record<string, unknown>) : undefined;\n}\n\n/** Normalize unknown value to AgentToolConfigRef. */\nexport function normalizeAgentToolConfigRef(raw: unknown): Partial<AgentToolConfigRef> {\n  if (typeof raw === \"string\" && raw.trim().length > 0) return { ref: raw.trim() };\n  const obj = asObject(raw);\n  if (!obj) return {};\n\n  const out: Partial<AgentToolConfigRef> = {};\n  if (typeof obj.ref === \"string\" && obj.ref.trim().length > 0) out.ref = obj.ref.trim();\n  if (typeof obj.development === \"string\" && obj.development.trim().length > 0) out.development = obj.development.trim();\n  if (typeof obj.production === \"string\" && obj.production.trim().length > 0) out.production = obj.production.trim();\n  return out;\n}\n","import { resolve } from \"node:path\";\nimport { deepMerge } from \"@easynet/agent-common\";\nimport { loadToolConfig, type ToolYamlShape } from \"../tools/util/toolConfig.js\";\n\nexport { normalizeAgentToolConfigRef } from \"./ref.js\";\nexport type { AgentToolConfigRef } from \"./ref.js\";\n\nexport interface LoadToolConfigOptions {\n  configPath?: string;\n}\n\nexport interface CreateToolConfigOptions extends LoadToolConfigOptions {\n  overrides?: Partial<ToolYamlShape>;\n}\n\nexport function loadToolRuntimeConfig(options: LoadToolConfigOptions = {}): ToolYamlShape {\n  const configPath = resolve(options.configPath ?? \"config/tool.yaml\");\n  return loadToolConfig(configPath);\n}\n\nexport function createToolConfig(options: CreateToolConfigOptions = {}): ToolYamlShape {\n  const base = loadToolRuntimeConfig(options);\n  if (!options.overrides) return base;\n  return deepMerge({} as ToolYamlShape, base, options.overrides);\n}\n","/**\n * Minimal public API for @easynet/agent-tool.\n * Keep root exports focused on high-level runtime/server creation.\n */\n\n// High-level API (most users should import from @easynet/agent-tool/api)\nexport {\n  createAgentTools,\n  createLangChainToolsAsync,\n  createOpenAPIServer,\n  createMCPServer,\n  runMCPServerOverStdio,\n  createMCPStreamableHttpHandler,\n  createMCPServerStreamableHttp,\n  createRuntimeFromConfig,\n  createRuntimeFromConfigSync,\n  langchainApi,\n  runtimeApi,\n  mcpApi,\n  openApi,\n} from \"./api/main.js\";\nexport type {\n  CreateAgentToolsOptions,\n  CreateRuntimeOptions,\n  CreateRuntimeResult,\n  MCPServerOptions,\n  MCPServerResult,\n  CreateMCPServerStreamableHttpOptions,\n  MCPServerStreamableHttpResult,\n  CreateHttpServiceOptions,\n  HttpServiceResult,\n  OpenAPIHttpServerOptions,\n} from \"./api/main.js\";\nexport type { AgentToolConfigRef } from \"./config/index.js\";\nexport {\n  normalizeAgentToolConfigRef,\n  loadToolRuntimeConfig,\n  createToolConfig,\n} from \"./config/index.js\";\nexport type { LoadToolConfigOptions, CreateToolConfigOptions } from \"./config/index.js\";\n\n// Backward compatibility: older extensions import runtime helpers from package root.\nexport { createTaggedError, withRetry, isRetryable, ToolRegistry } from \"./core/runtime.js\";\n\nimport {\n  initProject,\n  buildMCPPackage,\n  runMCPServer,\n  scanForTools,\n  scan,\n} from \"./build.js\";\nimport {\n  createExtension,\n  generateManifest,\n  generateExtensionManifest,\n  registerExtension,\n  registerToolsFromManifest,\n  loadExtensionManifest,\n  loadToolYaml,\n  resolveExtensionPackageRoot,\n  overrideWithConfig,\n  getGroupNamePrefixes,\n  createDynamicImportAdapter,\n  createContextRunner,\n} from \"./extension.js\";\nimport {\n  resolveSandboxedPath,\n  setSandboxValidationEnabled,\n  validateUrl,\n  isIpInBlockedCidrs,\n} from \"./security.js\";\nimport {\n  createToolSpec,\n  DEFAULT_INPUT_SCHEMA,\n  DEFAULT_OUTPUT_SCHEMA,\n} from \"./core/index.js\";\nimport {\n  createTaggedError,\n  withRetry,\n  isRetryable,\n  ToolRegistry,\n} from \"./core/runtime.js\";\n\n/**\n * Facade: grouped utilities beyond runtime/server creation.\n */\nexport const platformApi = {\n  build: {\n    initProject,\n    buildMCPPackage,\n    runMCPServer,\n    scanForTools,\n    scan,\n  },\n  extension: {\n    createExtension,\n    generateManifest,\n    generateExtensionManifest,\n    registerExtension,\n    registerToolsFromManifest,\n    loadExtensionManifest,\n    loadToolYaml,\n    resolveExtensionPackageRoot,\n    overrideWithConfig,\n    getGroupNamePrefixes,\n    createDynamicImportAdapter,\n    createContextRunner,\n  },\n  security: {\n    resolveSandboxedPath,\n    setSandboxValidationEnabled,\n    validateUrl,\n    isIpInBlockedCidrs,\n  },\n  core: {\n    createToolSpec,\n    DEFAULT_INPUT_SCHEMA,\n    DEFAULT_OUTPUT_SCHEMA,\n  },\n  runtime: {\n    createTaggedError,\n    withRetry,\n    isRetryable,\n    ToolRegistry,\n  },\n} as const;\n"]}
+{"version":3,"sources":["../src/config/ref.ts","../src/config/index.ts","../src/index.ts"],"names":["resolve","loadToolConfig","deepMerge","initProject","buildMCPPackage","runMCPServer","scanForTools","scan","createExtension","generateManifest","generateExtensionManifest","registerExtension","registerToolsFromManifest","loadExtensionManifest","loadToolYaml","resolveExtensionPackageRoot","overrideWithConfig","getGroupNamePrefixes","createDynamicImportAdapter","createContextRunner","resolveSandboxedPath","setSandboxValidationEnabled","validateUrl","isIpInBlockedCidrs","createToolSpec","DEFAULT_INPUT_SCHEMA","DEFAULT_OUTPUT_SCHEMA","createTaggedError","withRetry","isRetryable","ToolRegistry"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAOA,SAAS,SAAS,KAAA,EAAqD;AACrE,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,OAAQ,KAAA,GAAoC,MAAA;AAC5F;AAGO,SAAS,4BAA4B,GAAA,EAA2C;AACrF,EAAA,IAAI,OAAO,GAAA,KAAQ,QAAA,IAAY,GAAA,CAAI,IAAA,EAAK,CAAE,MAAA,GAAS,CAAA,EAAG,OAAO,EAAE,GAAA,EAAK,GAAA,CAAI,MAAK,EAAE;AAC/E,EAAA,MAAM,GAAA,GAAM,SAAS,GAAG,CAAA;AACxB,EAAA,IAAI,CAAC,GAAA,EAAK,OAAO,EAAC;AAElB,EAAA,MAAM,MAAmC,EAAC;AAC1C,EAAA,IAAI,OAAO,GAAA,CAAI,GAAA,KAAQ,QAAA,IAAY,IAAI,GAAA,CAAI,IAAA,EAAK,CAAE,MAAA,GAAS,CAAA,EAAG,GAAA,CAAI,GAAA,GAAM,GAAA,CAAI,IAAI,IAAA,EAAK;AACrF,EAAA,IAAI,OAAO,GAAA,CAAI,WAAA,KAAgB,QAAA,IAAY,IAAI,WAAA,CAAY,IAAA,EAAK,CAAE,MAAA,GAAS,CAAA,EAAG,GAAA,CAAI,WAAA,GAAc,GAAA,CAAI,YAAY,IAAA,EAAK;AACrH,EAAA,IAAI,OAAO,GAAA,CAAI,UAAA,KAAe,QAAA,IAAY,IAAI,UAAA,CAAW,IAAA,EAAK,CAAE,MAAA,GAAS,CAAA,EAAG,GAAA,CAAI,UAAA,GAAa,GAAA,CAAI,WAAW,IAAA,EAAK;AACjH,EAAA,OAAO,GAAA;AACT;;;ACPO,SAAS,qBAAA,CAAsB,OAAA,GAAiC,EAAC,EAAkB;AACxF,EAAA,MAAM,UAAA,GAAaA,YAAA,CAAQ,OAAA,CAAQ,UAAA,IAAc,kBAAkB,CAAA;AACnE,EAAA,OAAOC,iCAAe,UAAU,CAAA;AAClC;AAEO,SAAS,gBAAA,CAAiB,OAAA,GAAmC,EAAC,EAAkB;AACrF,EAAA,MAAM,IAAA,GAAO,sBAAsB,OAAO,CAAA;AAC1C,EAAA,IAAI,CAAC,OAAA,CAAQ,SAAA,EAAW,OAAO,IAAA;AAC/B,EAAA,OAAOC,qBAAA,CAAU,EAAC,EAAoB,IAAA,EAAM,QAAQ,SAAS,CAAA;AAC/D;;;ACiEO,IAAM,WAAA,GAAc;AAAA,EACzB,KAAA,EAAO;AAAA,iBACLC,6BAAA;AAAA,qBACAC,iCAAA;AAAA,kBACAC,8BAAA;AAAA,kBACAC,8BAAA;AAAA,UACAC;AAAA,GACF;AAAA,EACA,SAAA,EAAW;AAAA,qBACTC,iCAAA;AAAA,sBACAC,kCAAA;AAAA,+BACAC,2CAAA;AAAA,uBACAC,mCAAA;AAAA,+BACAC,2CAAA;AAAA,2BACAC,uCAAA;AAAA,kBACAC,8BAAA;AAAA,iCACAC,6CAAA;AAAA,wBACAC,oCAAA;AAAA,0BACAC,sCAAA;AAAA,gCACAC,4CAAA;AAAA,yBACAC;AAAA,GACF;AAAA,EACA,QAAA,EAAU;AAAA,0BACRC,sCAAA;AAAA,iCACAC,6CAAA;AAAA,iBACAC,6BAAA;AAAA,wBACAC;AAAA,GACF;AAAA,EACA,IAAA,EAAM;AAAA,oBACJC,gCAAA;AAAA,0BACAC,sCAAA;AAAA,2BACAC;AAAA,GACF;AAAA,EACA,OAAA,EAAS;AAAA,uBACPC,mCAAA;AAAA,eACAC,2BAAA;AAAA,iBACAC,6BAAA;AAAA,kBACAC;AAAA;AAEJ","file":"index.cjs","sourcesContent":["/** Agent-level reference to tool config files by environment. */\nexport interface AgentToolConfigRef {\n  ref?: string;\n  development?: string;\n  production?: string;\n}\n\nfunction asObject(input: unknown): Record<string, unknown> | undefined {\n  return typeof input === \"object\" && input !== null ? (input as Record<string, unknown>) : undefined;\n}\n\n/** Normalize unknown value to AgentToolConfigRef. */\nexport function normalizeAgentToolConfigRef(raw: unknown): Partial<AgentToolConfigRef> {\n  if (typeof raw === \"string\" && raw.trim().length > 0) return { ref: raw.trim() };\n  const obj = asObject(raw);\n  if (!obj) return {};\n\n  const out: Partial<AgentToolConfigRef> = {};\n  if (typeof obj.ref === \"string\" && obj.ref.trim().length > 0) out.ref = obj.ref.trim();\n  if (typeof obj.development === \"string\" && obj.development.trim().length > 0) out.development = obj.development.trim();\n  if (typeof obj.production === \"string\" && obj.production.trim().length > 0) out.production = obj.production.trim();\n  return out;\n}\n","import { resolve } from \"node:path\";\nimport { deepMerge } from \"@easynet/agent-common\";\nimport { loadToolConfig, type ToolYamlShape } from \"../tools/util/toolConfig.js\";\n\nexport { normalizeAgentToolConfigRef } from \"./ref.js\";\nexport type { AgentToolConfigRef } from \"./ref.js\";\n\nexport interface LoadToolConfigOptions {\n  configPath?: string;\n}\n\nexport interface CreateToolConfigOptions extends LoadToolConfigOptions {\n  overrides?: Partial<ToolYamlShape>;\n}\n\nexport function loadToolRuntimeConfig(options: LoadToolConfigOptions = {}): ToolYamlShape {\n  const configPath = resolve(options.configPath ?? \"config/tool.yaml\");\n  return loadToolConfig(configPath);\n}\n\nexport function createToolConfig(options: CreateToolConfigOptions = {}): ToolYamlShape {\n  const base = loadToolRuntimeConfig(options);\n  if (!options.overrides) return base;\n  return deepMerge({} as ToolYamlShape, base, options.overrides);\n}\n","/**\n * Minimal public API for @easynet/agent-tool.\n * Keep root exports focused on high-level runtime/server creation.\n */\n\n// High-level API (most users should import from @easynet/agent-tool/api)\nexport {\n  createAgentToolRegistry,\n  createLangChainToolsAsync,\n  createOpenAPIServer,\n  createMCPServer,\n  runMCPServerOverStdio,\n  createMCPStreamableHttpHandler,\n  createMCPServerStreamableHttp,\n  createRuntimeFromConfig,\n  createRuntimeFromConfigSync,\n  langchainApi,\n  runtimeApi,\n  mcpApi,\n  openApi,\n} from \"./api/main.js\";\nexport type {\n  CreateAgentToolsOptions,\n  AgentToolRegistry,\n  CreateRuntimeOptions,\n  CreateRuntimeResult,\n  MCPServerOptions,\n  MCPServerResult,\n  McpServer,\n  CreateMCPServerStreamableHttpOptions,\n  MCPServerStreamableHttpResult,\n  CreateHttpServiceOptions,\n  HttpServiceResult,\n  OpenAPIExpressApp,\n  OpenAPIHttpServerOptions,\n} from \"./api/main.js\";\nexport type { AgentToolConfigRef } from \"./config/index.js\";\nexport {\n  normalizeAgentToolConfigRef,\n  loadToolRuntimeConfig,\n  createToolConfig,\n} from \"./config/index.js\";\nexport type { LoadToolConfigOptions, CreateToolConfigOptions } from \"./config/index.js\";\n\n// Backward compatibility: older extensions import runtime helpers from package root.\nexport { createTaggedError, withRetry, isRetryable, ToolRegistry } from \"./core/runtime.js\";\n\nimport {\n  initProject,\n  buildMCPPackage,\n  runMCPServer,\n  scanForTools,\n  scan,\n} from \"./build.js\";\nimport {\n  createExtension,\n  generateManifest,\n  generateExtensionManifest,\n  registerExtension,\n  registerToolsFromManifest,\n  loadExtensionManifest,\n  loadToolYaml,\n  resolveExtensionPackageRoot,\n  overrideWithConfig,\n  getGroupNamePrefixes,\n  createDynamicImportAdapter,\n  createContextRunner,\n} from \"./extension.js\";\nimport {\n  resolveSandboxedPath,\n  setSandboxValidationEnabled,\n  validateUrl,\n  isIpInBlockedCidrs,\n} from \"./security.js\";\nimport {\n  createToolSpec,\n  DEFAULT_INPUT_SCHEMA,\n  DEFAULT_OUTPUT_SCHEMA,\n} from \"./core/index.js\";\nimport {\n  createTaggedError,\n  withRetry,\n  isRetryable,\n  ToolRegistry,\n} from \"./core/runtime.js\";\n\n/**\n * Facade: grouped utilities beyond runtime/server creation.\n */\nexport const platformApi = {\n  build: {\n    initProject,\n    buildMCPPackage,\n    runMCPServer,\n    scanForTools,\n    scan,\n  },\n  extension: {\n    createExtension,\n    generateManifest,\n    generateExtensionManifest,\n    registerExtension,\n    registerToolsFromManifest,\n    loadExtensionManifest,\n    loadToolYaml,\n    resolveExtensionPackageRoot,\n    overrideWithConfig,\n    getGroupNamePrefixes,\n    createDynamicImportAdapter,\n    createContextRunner,\n  },\n  security: {\n    resolveSandboxedPath,\n    setSandboxValidationEnabled,\n    validateUrl,\n    isIpInBlockedCidrs,\n  },\n  core: {\n    createToolSpec,\n    DEFAULT_INPUT_SCHEMA,\n    DEFAULT_OUTPUT_SCHEMA,\n  },\n  runtime: {\n    createTaggedError,\n    withRetry,\n    isRetryable,\n    ToolRegistry,\n  },\n} as const;\n"]}

package/dist/index.d.ts

@@ -2,8 +2,8 @@
  * Minimal public API for @easynet/agent-tool.
  * Keep root exports focused on high-level runtime/server creation.
  */
-export { createAgentTools, createLangChainToolsAsync, createOpenAPIServer, createMCPServer, runMCPServerOverStdio, createMCPStreamableHttpHandler, createMCPServerStreamableHttp, createRuntimeFromConfig, createRuntimeFromConfigSync, langchainApi, runtimeApi, mcpApi, openApi, } from "./api/main.js";
-export type { CreateAgentToolsOptions, CreateRuntimeOptions, CreateRuntimeResult, MCPServerOptions, MCPServerResult, CreateMCPServerStreamableHttpOptions, MCPServerStreamableHttpResult, CreateHttpServiceOptions, HttpServiceResult, OpenAPIHttpServerOptions, } from "./api/main.js";
+export { createAgentToolRegistry, createLangChainToolsAsync, createOpenAPIServer, createMCPServer, runMCPServerOverStdio, createMCPStreamableHttpHandler, createMCPServerStreamableHttp, createRuntimeFromConfig, createRuntimeFromConfigSync, langchainApi, runtimeApi, mcpApi, openApi, } from "./api/main.js";
+export type { CreateAgentToolsOptions, AgentToolRegistry, CreateRuntimeOptions, CreateRuntimeResult, MCPServerOptions, MCPServerResult, McpServer, CreateMCPServerStreamableHttpOptions, MCPServerStreamableHttpResult, CreateHttpServiceOptions, HttpServiceResult, OpenAPIExpressApp, OpenAPIHttpServerOptions, } from "./api/main.js";
 export type { AgentToolConfigRef } from "./config/index.js";
 export { normalizeAgentToolConfigRef, loadToolRuntimeConfig, createToolConfig, } from "./config/index.js";
 export type { LoadToolConfigOptions, CreateToolConfigOptions } from "./config/index.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EACzB,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACrB,8BAA8B,EAC9B,6BAA6B,EAC7B,uBAAuB,EACvB,2BAA2B,EAC3B,YAAY,EACZ,UAAU,EACV,MAAM,EACN,OAAO,GACR,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,oCAAoC,EACpC,6BAA6B,EAC7B,wBAAwB,EACxB,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAGxF,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE5F,OAAO,EACL,WAAW,EACX,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,IAAI,EACL,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,yBAAyB,EACzB,iBAAiB,EACjB,yBAAyB,EACzB,qBAAqB,EACrB,YAAY,EACZ,2BAA2B,EAC3B,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,EAC1B,mBAAmB,EACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,WAAW,EACX,kBAAkB,EACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,cAAc,EAGf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,iBAAiB,EACjB,SAAS,EACT,WAAW,EACX,YAAY,EACb,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCd,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACrB,8BAA8B,EAC9B,6BAA6B,EAC7B,uBAAuB,EACvB,2BAA2B,EAC3B,YAAY,EACZ,UAAU,EACV,MAAM,EACN,OAAO,GACR,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,oCAAoC,EACpC,6BAA6B,EAC7B,wBAAwB,EACxB,iBAAiB,EACjB,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAGxF,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE5F,OAAO,EACL,WAAW,EACX,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,IAAI,EACL,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,yBAAyB,EACzB,iBAAiB,EACjB,yBAAyB,EACzB,qBAAqB,EACrB,YAAY,EACZ,2BAA2B,EAC3B,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,EAC1B,mBAAmB,EACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,WAAW,EACX,kBAAkB,EACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,cAAc,EAGf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,iBAAiB,EACjB,SAAS,EACT,WAAW,EACX,YAAY,EACb,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCd,CAAC"}

package/dist/index.js

@@ -1,12 +1,12 @@
 import './chunk-FWWN4D2F.js';
 import { createContextRunner, createDynamicImportAdapter, getGroupNamePrefixes, overrideWithConfig, resolveExtensionPackageRoot, loadToolYaml, loadExtensionManifest, registerToolsFromManifest, registerExtension, generateExtensionManifest, generateManifest, createExtension } from './chunk-GSOJCOKN.js';
 import { isIpInBlockedCidrs, validateUrl } from './chunk-NKYFYALQ.js';
-export { createAgentTools, createLangChainToolsAsync, langchainApi, mcpApi, openApi, runtimeApi } from './chunk-4YLATI7J.js';
+export { createAgentToolRegistry, createLangChainToolsAsync, langchainApi, mcpApi, openApi, runtimeApi } from './chunk-XS26ZNYC.js';
 import './chunk-YLWTSNTT.js';
 import './chunk-DEDDPMBU.js';
 import { runMCPServer, buildMCPPackage, initProject } from './chunk-VYULM6NC.js';
-import { loadToolConfig } from './chunk-EHXA64OA.js';
-export { createMCPServer, createMCPServerStreamableHttp, createMCPStreamableHttpHandler, createHttpService as createOpenAPIServer, createRuntimeFromConfig, createRuntimeFromConfigSync, runMCPServerOverStdio } from './chunk-EHXA64OA.js';
+import { loadToolConfig } from './chunk-MBCFJBZY.js';
+export { createMCPServer, createMCPServerStreamableHttp, createMCPStreamableHttpHandler, createHttpService as createOpenAPIServer, createRuntimeFromConfig, createRuntimeFromConfigSync, runMCPServerOverStdio } from './chunk-MBCFJBZY.js';
 import './chunk-NTWOVFEY.js';
 import './chunk-Q6W32HAP.js';
 import { scan, scanForTools } from './chunk-HEVWKBBQ.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/config/ref.ts","../src/config/index.ts","../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAOA,SAAS,SAAS,KAAA,EAAqD;AACrE,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,OAAQ,KAAA,GAAoC,MAAA;AAC5F;AAGO,SAAS,4BAA4B,GAAA,EAA2C;AACrF,EAAA,IAAI,OAAO,GAAA,KAAQ,QAAA,IAAY,GAAA,CAAI,IAAA,EAAK,CAAE,MAAA,GAAS,CAAA,EAAG,OAAO,EAAE,GAAA,EAAK,GAAA,CAAI,MAAK,EAAE;AAC/E,EAAA,MAAM,GAAA,GAAM,SAAS,GAAG,CAAA;AACxB,EAAA,IAAI,CAAC,GAAA,EAAK,OAAO,EAAC;AAElB,EAAA,MAAM,MAAmC,EAAC;AAC1C,EAAA,IAAI,OAAO,GAAA,CAAI,GAAA,KAAQ,QAAA,IAAY,IAAI,GAAA,CAAI,IAAA,EAAK,CAAE,MAAA,GAAS,CAAA,EAAG,GAAA,CAAI,GAAA,GAAM,GAAA,CAAI,IAAI,IAAA,EAAK;AACrF,EAAA,IAAI,OAAO,GAAA,CAAI,WAAA,KAAgB,QAAA,IAAY,IAAI,WAAA,CAAY,IAAA,EAAK,CAAE,MAAA,GAAS,CAAA,EAAG,GAAA,CAAI,WAAA,GAAc,GAAA,CAAI,YAAY,IAAA,EAAK;AACrH,EAAA,IAAI,OAAO,GAAA,CAAI,UAAA,KAAe,QAAA,IAAY,IAAI,UAAA,CAAW,IAAA,EAAK,CAAE,MAAA,GAAS,CAAA,EAAG,GAAA,CAAI,UAAA,GAAa,GAAA,CAAI,WAAW,IAAA,EAAK;AACjH,EAAA,OAAO,GAAA;AACT;;;ACPO,SAAS,qBAAA,CAAsB,OAAA,GAAiC,EAAC,EAAkB;AACxF,EAAA,MAAM,UAAA,GAAa,OAAA,CAAQ,OAAA,CAAQ,UAAA,IAAc,kBAAkB,CAAA;AACnE,EAAA,OAAO,eAAe,UAAU,CAAA;AAClC;AAEO,SAAS,gBAAA,CAAiB,OAAA,GAAmC,EAAC,EAAkB;AACrF,EAAA,MAAM,IAAA,GAAO,sBAAsB,OAAO,CAAA;AAC1C,EAAA,IAAI,CAAC,OAAA,CAAQ,SAAA,EAAW,OAAO,IAAA;AAC/B,EAAA,OAAO,SAAA,CAAU,EAAC,EAAoB,IAAA,EAAM,QAAQ,SAAS,CAAA;AAC/D;;;AC8DO,IAAM,WAAA,GAAc;AAAA,EACzB,KAAA,EAAO;AAAA,IACL,WAAA;AAAA,IACA,eAAA;AAAA,IACA,YAAA;AAAA,IACA,YAAA;AAAA,IACA;AAAA,GACF;AAAA,EACA,SAAA,EAAW;AAAA,IACT,eAAA;AAAA,IACA,gBAAA;AAAA,IACA,yBAAA;AAAA,IACA,iBAAA;AAAA,IACA,yBAAA;AAAA,IACA,qBAAA;AAAA,IACA,YAAA;AAAA,IACA,2BAAA;AAAA,IACA,kBAAA;AAAA,IACA,oBAAA;AAAA,IACA,0BAAA;AAAA,IACA;AAAA,GACF;AAAA,EACA,QAAA,EAAU;AAAA,IACR,oBAAA;AAAA,IACA,2BAAA;AAAA,IACA,WAAA;AAAA,IACA;AAAA,GACF;AAAA,EACA,IAAA,EAAM;AAAA,IACJ,cAAA;AAAA,IACA,oBAAA;AAAA,IACA;AAAA,GACF;AAAA,EACA,OAAA,EAAS;AAAA,IACP,iBAAA;AAAA,IACA,SAAA;AAAA,IACA,WAAA;AAAA,IACA;AAAA;AAEJ","file":"index.js","sourcesContent":["/** Agent-level reference to tool config files by environment. */\nexport interface AgentToolConfigRef {\n  ref?: string;\n  development?: string;\n  production?: string;\n}\n\nfunction asObject(input: unknown): Record<string, unknown> | undefined {\n  return typeof input === \"object\" && input !== null ? (input as Record<string, unknown>) : undefined;\n}\n\n/** Normalize unknown value to AgentToolConfigRef. */\nexport function normalizeAgentToolConfigRef(raw: unknown): Partial<AgentToolConfigRef> {\n  if (typeof raw === \"string\" && raw.trim().length > 0) return { ref: raw.trim() };\n  const obj = asObject(raw);\n  if (!obj) return {};\n\n  const out: Partial<AgentToolConfigRef> = {};\n  if (typeof obj.ref === \"string\" && obj.ref.trim().length > 0) out.ref = obj.ref.trim();\n  if (typeof obj.development === \"string\" && obj.development.trim().length > 0) out.development = obj.development.trim();\n  if (typeof obj.production === \"string\" && obj.production.trim().length > 0) out.production = obj.production.trim();\n  return out;\n}\n","import { resolve } from \"node:path\";\nimport { deepMerge } from \"@easynet/agent-common\";\nimport { loadToolConfig, type ToolYamlShape } from \"../tools/util/toolConfig.js\";\n\nexport { normalizeAgentToolConfigRef } from \"./ref.js\";\nexport type { AgentToolConfigRef } from \"./ref.js\";\n\nexport interface LoadToolConfigOptions {\n  configPath?: string;\n}\n\nexport interface CreateToolConfigOptions extends LoadToolConfigOptions {\n  overrides?: Partial<ToolYamlShape>;\n}\n\nexport function loadToolRuntimeConfig(options: LoadToolConfigOptions = {}): ToolYamlShape {\n  const configPath = resolve(options.configPath ?? \"config/tool.yaml\");\n  return loadToolConfig(configPath);\n}\n\nexport function createToolConfig(options: CreateToolConfigOptions = {}): ToolYamlShape {\n  const base = loadToolRuntimeConfig(options);\n  if (!options.overrides) return base;\n  return deepMerge({} as ToolYamlShape, base, options.overrides);\n}\n","/**\n * Minimal public API for @easynet/agent-tool.\n * Keep root exports focused on high-level runtime/server creation.\n */\n\n// High-level API (most users should import from @easynet/agent-tool/api)\nexport {\n  createAgentTools,\n  createLangChainToolsAsync,\n  createOpenAPIServer,\n  createMCPServer,\n  runMCPServerOverStdio,\n  createMCPStreamableHttpHandler,\n  createMCPServerStreamableHttp,\n  createRuntimeFromConfig,\n  createRuntimeFromConfigSync,\n  langchainApi,\n  runtimeApi,\n  mcpApi,\n  openApi,\n} from \"./api/main.js\";\nexport type {\n  CreateAgentToolsOptions,\n  CreateRuntimeOptions,\n  CreateRuntimeResult,\n  MCPServerOptions,\n  MCPServerResult,\n  CreateMCPServerStreamableHttpOptions,\n  MCPServerStreamableHttpResult,\n  CreateHttpServiceOptions,\n  HttpServiceResult,\n  OpenAPIHttpServerOptions,\n} from \"./api/main.js\";\nexport type { AgentToolConfigRef } from \"./config/index.js\";\nexport {\n  normalizeAgentToolConfigRef,\n  loadToolRuntimeConfig,\n  createToolConfig,\n} from \"./config/index.js\";\nexport type { LoadToolConfigOptions, CreateToolConfigOptions } from \"./config/index.js\";\n\n// Backward compatibility: older extensions import runtime helpers from package root.\nexport { createTaggedError, withRetry, isRetryable, ToolRegistry } from \"./core/runtime.js\";\n\nimport {\n  initProject,\n  buildMCPPackage,\n  runMCPServer,\n  scanForTools,\n  scan,\n} from \"./build.js\";\nimport {\n  createExtension,\n  generateManifest,\n  generateExtensionManifest,\n  registerExtension,\n  registerToolsFromManifest,\n  loadExtensionManifest,\n  loadToolYaml,\n  resolveExtensionPackageRoot,\n  overrideWithConfig,\n  getGroupNamePrefixes,\n  createDynamicImportAdapter,\n  createContextRunner,\n} from \"./extension.js\";\nimport {\n  resolveSandboxedPath,\n  setSandboxValidationEnabled,\n  validateUrl,\n  isIpInBlockedCidrs,\n} from \"./security.js\";\nimport {\n  createToolSpec,\n  DEFAULT_INPUT_SCHEMA,\n  DEFAULT_OUTPUT_SCHEMA,\n} from \"./core/index.js\";\nimport {\n  createTaggedError,\n  withRetry,\n  isRetryable,\n  ToolRegistry,\n} from \"./core/runtime.js\";\n\n/**\n * Facade: grouped utilities beyond runtime/server creation.\n */\nexport const platformApi = {\n  build: {\n    initProject,\n    buildMCPPackage,\n    runMCPServer,\n    scanForTools,\n    scan,\n  },\n  extension: {\n    createExtension,\n    generateManifest,\n    generateExtensionManifest,\n    registerExtension,\n    registerToolsFromManifest,\n    loadExtensionManifest,\n    loadToolYaml,\n    resolveExtensionPackageRoot,\n    overrideWithConfig,\n    getGroupNamePrefixes,\n    createDynamicImportAdapter,\n    createContextRunner,\n  },\n  security: {\n    resolveSandboxedPath,\n    setSandboxValidationEnabled,\n    validateUrl,\n    isIpInBlockedCidrs,\n  },\n  core: {\n    createToolSpec,\n    DEFAULT_INPUT_SCHEMA,\n    DEFAULT_OUTPUT_SCHEMA,\n  },\n  runtime: {\n    createTaggedError,\n    withRetry,\n    isRetryable,\n    ToolRegistry,\n  },\n} as const;\n"]}
+{"version":3,"sources":["../src/config/ref.ts","../src/config/index.ts","../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAOA,SAAS,SAAS,KAAA,EAAqD;AACrE,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,OAAQ,KAAA,GAAoC,MAAA;AAC5F;AAGO,SAAS,4BAA4B,GAAA,EAA2C;AACrF,EAAA,IAAI,OAAO,GAAA,KAAQ,QAAA,IAAY,GAAA,CAAI,IAAA,EAAK,CAAE,MAAA,GAAS,CAAA,EAAG,OAAO,EAAE,GAAA,EAAK,GAAA,CAAI,MAAK,EAAE;AAC/E,EAAA,MAAM,GAAA,GAAM,SAAS,GAAG,CAAA;AACxB,EAAA,IAAI,CAAC,GAAA,EAAK,OAAO,EAAC;AAElB,EAAA,MAAM,MAAmC,EAAC;AAC1C,EAAA,IAAI,OAAO,GAAA,CAAI,GAAA,KAAQ,QAAA,IAAY,IAAI,GAAA,CAAI,IAAA,EAAK,CAAE,MAAA,GAAS,CAAA,EAAG,GAAA,CAAI,GAAA,GAAM,GAAA,CAAI,IAAI,IAAA,EAAK;AACrF,EAAA,IAAI,OAAO,GAAA,CAAI,WAAA,KAAgB,QAAA,IAAY,IAAI,WAAA,CAAY,IAAA,EAAK,CAAE,MAAA,GAAS,CAAA,EAAG,GAAA,CAAI,WAAA,GAAc,GAAA,CAAI,YAAY,IAAA,EAAK;AACrH,EAAA,IAAI,OAAO,GAAA,CAAI,UAAA,KAAe,QAAA,IAAY,IAAI,UAAA,CAAW,IAAA,EAAK,CAAE,MAAA,GAAS,CAAA,EAAG,GAAA,CAAI,UAAA,GAAa,GAAA,CAAI,WAAW,IAAA,EAAK;AACjH,EAAA,OAAO,GAAA;AACT;;;ACPO,SAAS,qBAAA,CAAsB,OAAA,GAAiC,EAAC,EAAkB;AACxF,EAAA,MAAM,UAAA,GAAa,OAAA,CAAQ,OAAA,CAAQ,UAAA,IAAc,kBAAkB,CAAA;AACnE,EAAA,OAAO,eAAe,UAAU,CAAA;AAClC;AAEO,SAAS,gBAAA,CAAiB,OAAA,GAAmC,EAAC,EAAkB;AACrF,EAAA,MAAM,IAAA,GAAO,sBAAsB,OAAO,CAAA;AAC1C,EAAA,IAAI,CAAC,OAAA,CAAQ,SAAA,EAAW,OAAO,IAAA;AAC/B,EAAA,OAAO,SAAA,CAAU,EAAC,EAAoB,IAAA,EAAM,QAAQ,SAAS,CAAA;AAC/D;;;ACiEO,IAAM,WAAA,GAAc;AAAA,EACzB,KAAA,EAAO;AAAA,IACL,WAAA;AAAA,IACA,eAAA;AAAA,IACA,YAAA;AAAA,IACA,YAAA;AAAA,IACA;AAAA,GACF;AAAA,EACA,SAAA,EAAW;AAAA,IACT,eAAA;AAAA,IACA,gBAAA;AAAA,IACA,yBAAA;AAAA,IACA,iBAAA;AAAA,IACA,yBAAA;AAAA,IACA,qBAAA;AAAA,IACA,YAAA;AAAA,IACA,2BAAA;AAAA,IACA,kBAAA;AAAA,IACA,oBAAA;AAAA,IACA,0BAAA;AAAA,IACA;AAAA,GACF;AAAA,EACA,QAAA,EAAU;AAAA,IACR,oBAAA;AAAA,IACA,2BAAA;AAAA,IACA,WAAA;AAAA,IACA;AAAA,GACF;AAAA,EACA,IAAA,EAAM;AAAA,IACJ,cAAA;AAAA,IACA,oBAAA;AAAA,IACA;AAAA,GACF;AAAA,EACA,OAAA,EAAS;AAAA,IACP,iBAAA;AAAA,IACA,SAAA;AAAA,IACA,WAAA;AAAA,IACA;AAAA;AAEJ","file":"index.js","sourcesContent":["/** Agent-level reference to tool config files by environment. */\nexport interface AgentToolConfigRef {\n  ref?: string;\n  development?: string;\n  production?: string;\n}\n\nfunction asObject(input: unknown): Record<string, unknown> | undefined {\n  return typeof input === \"object\" && input !== null ? (input as Record<string, unknown>) : undefined;\n}\n\n/** Normalize unknown value to AgentToolConfigRef. */\nexport function normalizeAgentToolConfigRef(raw: unknown): Partial<AgentToolConfigRef> {\n  if (typeof raw === \"string\" && raw.trim().length > 0) return { ref: raw.trim() };\n  const obj = asObject(raw);\n  if (!obj) return {};\n\n  const out: Partial<AgentToolConfigRef> = {};\n  if (typeof obj.ref === \"string\" && obj.ref.trim().length > 0) out.ref = obj.ref.trim();\n  if (typeof obj.development === \"string\" && obj.development.trim().length > 0) out.development = obj.development.trim();\n  if (typeof obj.production === \"string\" && obj.production.trim().length > 0) out.production = obj.production.trim();\n  return out;\n}\n","import { resolve } from \"node:path\";\nimport { deepMerge } from \"@easynet/agent-common\";\nimport { loadToolConfig, type ToolYamlShape } from \"../tools/util/toolConfig.js\";\n\nexport { normalizeAgentToolConfigRef } from \"./ref.js\";\nexport type { AgentToolConfigRef } from \"./ref.js\";\n\nexport interface LoadToolConfigOptions {\n  configPath?: string;\n}\n\nexport interface CreateToolConfigOptions extends LoadToolConfigOptions {\n  overrides?: Partial<ToolYamlShape>;\n}\n\nexport function loadToolRuntimeConfig(options: LoadToolConfigOptions = {}): ToolYamlShape {\n  const configPath = resolve(options.configPath ?? \"config/tool.yaml\");\n  return loadToolConfig(configPath);\n}\n\nexport function createToolConfig(options: CreateToolConfigOptions = {}): ToolYamlShape {\n  const base = loadToolRuntimeConfig(options);\n  if (!options.overrides) return base;\n  return deepMerge({} as ToolYamlShape, base, options.overrides);\n}\n","/**\n * Minimal public API for @easynet/agent-tool.\n * Keep root exports focused on high-level runtime/server creation.\n */\n\n// High-level API (most users should import from @easynet/agent-tool/api)\nexport {\n  createAgentToolRegistry,\n  createLangChainToolsAsync,\n  createOpenAPIServer,\n  createMCPServer,\n  runMCPServerOverStdio,\n  createMCPStreamableHttpHandler,\n  createMCPServerStreamableHttp,\n  createRuntimeFromConfig,\n  createRuntimeFromConfigSync,\n  langchainApi,\n  runtimeApi,\n  mcpApi,\n  openApi,\n} from \"./api/main.js\";\nexport type {\n  CreateAgentToolsOptions,\n  AgentToolRegistry,\n  CreateRuntimeOptions,\n  CreateRuntimeResult,\n  MCPServerOptions,\n  MCPServerResult,\n  McpServer,\n  CreateMCPServerStreamableHttpOptions,\n  MCPServerStreamableHttpResult,\n  CreateHttpServiceOptions,\n  HttpServiceResult,\n  OpenAPIExpressApp,\n  OpenAPIHttpServerOptions,\n} from \"./api/main.js\";\nexport type { AgentToolConfigRef } from \"./config/index.js\";\nexport {\n  normalizeAgentToolConfigRef,\n  loadToolRuntimeConfig,\n  createToolConfig,\n} from \"./config/index.js\";\nexport type { LoadToolConfigOptions, CreateToolConfigOptions } from \"./config/index.js\";\n\n// Backward compatibility: older extensions import runtime helpers from package root.\nexport { createTaggedError, withRetry, isRetryable, ToolRegistry } from \"./core/runtime.js\";\n\nimport {\n  initProject,\n  buildMCPPackage,\n  runMCPServer,\n  scanForTools,\n  scan,\n} from \"./build.js\";\nimport {\n  createExtension,\n  generateManifest,\n  generateExtensionManifest,\n  registerExtension,\n  registerToolsFromManifest,\n  loadExtensionManifest,\n  loadToolYaml,\n  resolveExtensionPackageRoot,\n  overrideWithConfig,\n  getGroupNamePrefixes,\n  createDynamicImportAdapter,\n  createContextRunner,\n} from \"./extension.js\";\nimport {\n  resolveSandboxedPath,\n  setSandboxValidationEnabled,\n  validateUrl,\n  isIpInBlockedCidrs,\n} from \"./security.js\";\nimport {\n  createToolSpec,\n  DEFAULT_INPUT_SCHEMA,\n  DEFAULT_OUTPUT_SCHEMA,\n} from \"./core/index.js\";\nimport {\n  createTaggedError,\n  withRetry,\n  isRetryable,\n  ToolRegistry,\n} from \"./core/runtime.js\";\n\n/**\n * Facade: grouped utilities beyond runtime/server creation.\n */\nexport const platformApi = {\n  build: {\n    initProject,\n    buildMCPPackage,\n    runMCPServer,\n    scanForTools,\n    scan,\n  },\n  extension: {\n    createExtension,\n    generateManifest,\n    generateExtensionManifest,\n    registerExtension,\n    registerToolsFromManifest,\n    loadExtensionManifest,\n    loadToolYaml,\n    resolveExtensionPackageRoot,\n    overrideWithConfig,\n    getGroupNamePrefixes,\n    createDynamicImportAdapter,\n    createContextRunner,\n  },\n  security: {\n    resolveSandboxedPath,\n    setSandboxValidationEnabled,\n    validateUrl,\n    isIpInBlockedCidrs,\n  },\n  core: {\n    createToolSpec,\n    DEFAULT_INPUT_SCHEMA,\n    DEFAULT_OUTPUT_SCHEMA,\n  },\n  runtime: {\n    createTaggedError,\n    withRetry,\n    isRetryable,\n    ToolRegistry,\n  },\n} as const;\n"]}

package/dist/tools/util/toolConfig.d.ts

@@ -23,6 +23,19 @@ export interface ToolYamlShape {
         defaults?: Record<string, unknown>;
         tools?: Record<string, Record<string, unknown>>;
     }>;
+    /** MCP server defaults used by createAgentToolRegistry().getMcpServer(). */
+    mcp?: {
+        name?: string;
+        version?: string;
+    };
+    /** OpenAPI/Express defaults used by createAgentToolRegistry().getOpenAPIServer(). */
+    openapi?: {
+        host?: string;
+        port?: number;
+        basePath?: string;
+        title?: string;
+        version?: string;
+    };
 }
 /**
  * Load tool.yaml and return normalized shape (tools array + sandboxedPath).

package/dist/tools/util/toolConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toolConfig.d.ts","sourceRoot":"","sources":["../../../src/tools/util/toolConfig.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,yGAAyG;AACzG,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,2GAA2G;IAC3G,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wFAAwF;IACxF,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,yFAAyF;IACzF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,gGAAgG;IAChG,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,gLAAgL;IAChL,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACvD,iLAAiL;IACjL,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;KAAE,CAAC,CAAC;CAC/H;AA+BD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,aAAa,CA8DlE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAKxF;AAED,oEAAoE;AACpE,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKnF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAU1F"}
+{"version":3,"file":"toolConfig.d.ts","sourceRoot":"","sources":["../../../src/tools/util/toolConfig.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,yGAAyG;AACzG,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,2GAA2G;IAC3G,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wFAAwF;IACxF,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,yFAAyF;IACzF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,gGAAgG;IAChG,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,gLAAgL;IAChL,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACvD,iLAAiL;IACjL,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;KAAE,CAAC,CAAC;IAC9H,4EAA4E;IAC5E,GAAG,CAAC,EAAE;QACJ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,qFAAqF;IACrF,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAsED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,aAAa,CAoElE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAKxF;AAED,oEAAoE;AACpE,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKnF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAU1F"}

package/dist/utils/cli/index.cjs

@@ -2,7 +2,7 @@
 'use strict';
 
 var chunkTBDSFXNG_cjs = require('../../chunk-TBDSFXNG.cjs');
-var chunkQVXWW657_cjs = require('../../chunk-QVXWW657.cjs');
+var chunkPYTHEY6A_cjs = require('../../chunk-PYTHEY6A.cjs');
 var chunkUUNG3GL3_cjs = require('../../chunk-UUNG3GL3.cjs');
 require('../../chunk-33N4Y6IS.cjs');
 require('../../chunk-LHKEJNKL.cjs');
@@ -274,10 +274,10 @@ async function getRuntimeWithTools(pathOpt, verbose = false) {
   const stepLog = verbose ? (msg) => process.stderr.write(`[agent-tool] ${msg}
 `) : void 0;
   if (stepLog) stepLog(`Loading tool config from ${searchDir}`);
-  const config = chunkQVXWW657_cjs.findAndLoadToolConfig(searchDir);
+  const config = chunkPYTHEY6A_cjs.findAndLoadToolConfig(searchDir);
   let sandboxRoot = cwd;
   if (config.sandboxedPath && typeof config.sandboxedPath === "string" && config.configPath) {
-    sandboxRoot = chunkQVXWW657_cjs.resolveSandboxedPath(config.configPath, config.sandboxedPath);
+    sandboxRoot = chunkPYTHEY6A_cjs.resolveSandboxedPath(config.configPath, config.sandboxedPath);
   }
   if (stepLog) {
     if (config.configPath) {
@@ -292,7 +292,7 @@ async function getRuntimeWithTools(pathOpt, verbose = false) {
     enableSandboxValidation: config.enableSandboxValidation ?? DEFAULT_CORE_CONFIG.enableSandboxValidation,
     allowedHosts: []
   };
-  const result = await chunkQVXWW657_cjs.createRuntimeFromConfig({
+  const result = await chunkPYTHEY6A_cjs.createRuntimeFromConfig({
     coreTools: coreConfig,
     configFilePath: config.configPath,
     stepLog
@@ -456,7 +456,7 @@ var LS_DESC_MAX = 72;
 function formatLsOutput(specs) {
   const rows = specs.map((spec) => {
     const { name } = parseToolName(spec.name);
-    const scope = chunkQVXWW657_cjs.getDisplayScope(spec.name, spec.kind, spec.version);
+    const scope = chunkPYTHEY6A_cjs.getDisplayScope(spec.name, spec.kind, spec.version);
     const desc = (spec.description ?? "").replace(/\n/g, " ").trim().slice(0, LS_DESC_MAX);
     return { scope, name, description: desc || "(no description)" };
   });
@@ -483,7 +483,7 @@ function formatLsOutput(specs) {
 }
 function formatDescribeOutput(spec) {
   const { name: localName } = parseToolName(spec.name);
-  const scope = chunkQVXWW657_cjs.getDisplayScope(spec.name, spec.kind, spec.version);
+  const scope = chunkPYTHEY6A_cjs.getDisplayScope(spec.name, spec.kind, spec.version);
   const sections = [];
   sections.push("\u250C\u2500 Tool");
   sections.push(`\u2502  name:        ${spec.name}`);
@@ -519,7 +519,7 @@ async function cmdLs(pathOpt, verbose = false) {
       process.stdout.write("No tools registered.\n");
       const cwd = process.cwd();
       const searchDir = path2__namespace.default.resolve(cwd, pathOpt ?? ".");
-      const config = chunkQVXWW657_cjs.findAndLoadToolConfig(searchDir);
+      const config = chunkPYTHEY6A_cjs.findAndLoadToolConfig(searchDir);
       const hasNpmTools = Array.isArray(config.tools) && config.tools.some((t) => typeof t === "string" && t.startsWith("npm:"));
       if (hasNpmTools) {
         process.stdout.write(
@@ -544,7 +544,7 @@ async function cmdDescribe(toolName, pathOpt, verbose = false) {
   }
   try {
     const { registry } = await getRuntimeWithTools(pathOpt, verbose);
-    const registryName = chunkQVXWW657_cjs.resolveToolDescriptor(toolName.trim());
+    const registryName = chunkPYTHEY6A_cjs.resolveToolDescriptor(toolName.trim());
     const spec = registry.get(registryName);
     if (!spec) {
       process.stderr.write(`Tool not found: ${toolName}
@@ -593,7 +593,7 @@ async function cmdRun(toolName, toolArgsJson, pathOpt, verbose = false) {
   }
   try {
     const { runtime, registry } = await getRuntimeWithTools(pathOpt, verbose);
-    const registryName = chunkQVXWW657_cjs.resolveToolDescriptor(toolName.trim());
+    const registryName = chunkPYTHEY6A_cjs.resolveToolDescriptor(toolName.trim());
     if (!registry.get(registryName)) {
       process.stderr.write(`Tool not found: ${toolName}
 `);
@@ -621,10 +621,10 @@ async function cmdStartMcp(pathOpt, verbose = false, stdio = false, port = 3e3,
   try {
     const { runtime } = await getRuntimeWithTools(pathOpt, verbose);
     if (stdio) {
-      await chunkQVXWW657_cjs.runMCPServerOverStdio(runtime);
+      await chunkPYTHEY6A_cjs.runMCPServerOverStdio(runtime);
       return 0;
     }
-    const streamable = await chunkQVXWW657_cjs.createMCPServerStreamableHttp(runtime, { port, host, path: "/mcp" });
+    const streamable = await chunkPYTHEY6A_cjs.createMCPServerStreamableHttp(runtime, { port, host, path: "/mcp" });
     const { url, port: actualPort } = await streamable.listen(port, host);
     process.stdout.write(`MCP Streamable HTTP: ${url}
 `);
@@ -640,7 +640,7 @@ async function cmdStartMcp(pathOpt, verbose = false, stdio = false, port = 3e3,
 async function cmdStartHttp(port, host, pathOpt, verbose = false) {
   try {
     const { runtime } = await getRuntimeWithTools(pathOpt, verbose);
-    const http = await chunkQVXWW657_cjs.createHttpService(runtime);
+    const http = await chunkPYTHEY6A_cjs.createHttpService(runtime);
     const { port: actualPort, host: actualHost } = await http.listen({ port, host });
     const base = `http://${actualHost}:${actualPort}`;
     process.stdout.write(`API: ${base}/invoke (POST), ${base}/tools (GET)

package/dist/utils/cli/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { initProject, buildMCPPackage, runMCPServer } from '../../chunk-VYULM6NC.js';
-import { findAndLoadToolConfig, resolveToolDescriptor, runMCPServerOverStdio, createMCPServerStreamableHttp, createHttpService, resolveSandboxedPath, createRuntimeFromConfig, getDisplayScope } from '../../chunk-EHXA64OA.js';
+import { findAndLoadToolConfig, resolveToolDescriptor, runMCPServerOverStdio, createMCPServerStreamableHttp, createHttpService, resolveSandboxedPath, createRuntimeFromConfig, getDisplayScope } from '../../chunk-MBCFJBZY.js';
 import { enrichSpecWithCanonicalSchema } from '../../chunk-NTWOVFEY.js';
 import '../../chunk-Q6W32HAP.js';
 import '../../chunk-HEVWKBBQ.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@easynet/agent-tool",
-  "version": "1.0.73",
+  "version": "1.0.75",
   "description": "MCP build: init → build → run. Turn your project (@tool, SKILL, n8n) into a standalone MCP npm server (no framework embedding, no package conflict).",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -61,6 +61,7 @@
     "test": "npm run build && vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit",
+    "example:start": "npm run -s build && tsx example/basic-usage.ts",
     "clean": "rm -rf dist",
     "lint:lines": "./scripts/check-line-count.sh",
     "lint:functions": "node scripts/check-function-length.mjs",
@@ -74,10 +75,12 @@
     "@langchain/core": ">=0.3.0",
     "@langchain/openai": "^1.2.3",
     "@modelcontextprotocol/sdk": ">=1.25.0",
+    "@types/express": "^5.0.3",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
     "cockatiel": "^3.2.1",
     "eventemitter3": "^5.0.1",
+    "express": "^5.1.0",
     "jmespath": "^0.16.0",
     "js-yaml": "^4.1.1",
     "langchain": ">=1.0.0",

package/dist/chunk-4YLATI7J.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/api/adapters/LangChainToolsHub.ts","../src/api/createAgentTools.ts","../src/api/main.ts"],"names":[],"mappings":"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","file":"chunk-4YLATI7J.js","sourcesContent":["/**\n * Exposes all tools from a ToolRegistry + PTCRuntime as LangChain tools\n * for local agent use (e.g. with createReactAgent, AgentExecutor).\n *\n * For most users, use createAgentTools() which loads from tools.yaml and returns\n * StructuredTool[]. Use LangChainToolsHub when you need a custom runtime or ctxFactory.\n *\n * Use: new LangChainToolsHub(runtime, ctxFactory).getLangChainTools()\n */\n\nimport { DynamicStructuredTool, type StructuredToolInterface } from \"@langchain/core/tools\";\nimport { stripNullishObjectFields } from \"@easynet/agent-common\";\nimport type { PTCRuntime } from \"../../core/runtime/PTCRuntime.js\";\nimport type { ToolSpec } from \"../../core/types/ToolSpec.js\";\nimport type { ToolResult } from \"../../core/types/ToolResult.js\";\nimport type { ExecContext } from \"../../core/types/ToolIntent.js\";\nimport type { ToolIntent } from \"../../core/types/ToolIntent.js\";\nimport { enrichSpecWithCanonicalSchema } from \"../../tools/util/canonicalCoreSchemas.js\";\nimport { LANGCHAIN_KIND } from \"../../tools/langchain/types.js\";\n\n/**\n * If inputSchema wraps all params in a single \"args\" object (manifest convention),\n * returns that inner args schema; otherwise returns null.\n */\nfunction getArgsSchemaIfWrapped(inputSchema: object): Record<string, unknown> | null {\n  const s = inputSchema as Record<string, unknown>;\n  if (s?.type !== \"object\" || !s.properties || typeof s.properties !== \"object\") return null;\n  const args = (s.properties as Record<string, unknown>).args;\n  if (\n    args != null &&\n    typeof args === \"object\" &&\n    (args as Record<string, unknown>).type === \"object\" &&\n    (args as Record<string, unknown>).properties != null\n  ) {\n    return args as Record<string, unknown>;\n  }\n  return null;\n}\n\n/**\n * True when inputSchema wraps all params in a single \"args\" object (manifest convention).\n */\nfunction hasArgsWrapper(inputSchema: object): boolean {\n  return getArgsSchemaIfWrapped(inputSchema) !== null;\n}\n\n/**\n * If inputSchema is { type: \"object\", properties: { args: { type: \"object\", properties: {...} } } },\n * return the inner args schema so the LLM can pass { path: \".\" } instead of { args: { path: \".\" } }.\n */\nfunction schemaForLangChain(inputSchema: object): Record<string, unknown> {\n  const wrapped = getArgsSchemaIfWrapped(inputSchema);\n  if (wrapped !== null) return wrapped;\n  return inputSchema as Record<string, unknown>;\n}\n\nfunction buildIntent(\n  toolName: string,\n  inputSchema: object,\n  args: Record<string, unknown>,\n): ToolIntent {\n  return {\n    tool: toolName,\n    args: hasArgsWrapper(inputSchema) ? { args } : args,\n    purpose: LANGCHAIN_KIND,\n  };\n}\n\nfunction normalizeArgs(args: Record<string, unknown> | undefined): Record<string, unknown> {\n  return stripNullishObjectFields(args ?? {}) as Record<string, unknown>;\n}\n\nfunction serializeToolResult(result: ToolResult): string {\n  if (result.ok) {\n    return typeof result.result === \"string\"\n      ? result.result\n      : JSON.stringify(result.result);\n  }\n\n  const err = result.error;\n  const message = err?.message ?? \"Tool failed\";\n  const details = err?.details;\n  return JSON.stringify(\n    details != null ? { error: message, details } : { error: message },\n  );\n}\n\nexport type ExecContextFactory = () => ExecContext;\n\nconst DEFAULT_CTX_FACTORY: ExecContextFactory = () => ({\n  requestId: `lc-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`,\n  taskId: `task-${Date.now()}`,\n  permissions: [\n    \"read:web\",\n    \"read:fs\",\n    \"write:fs\",\n    \"read:db\",\n    \"write:db\",\n    \"network\",\n    \"workflow\",\n    \"danger:destructive\",\n  ],\n});\n\n/**\n * Hub that wraps PTCRuntime and exposes every registered tool as a LangChain\n * StructuredTool (DynamicStructuredTool), so local agents (LangChain AgentExecutor,\n * createReactAgent, etc.) can use the same tools as MCP and OpenAPI.\n */\nexport class LangChainToolsHub {\n  constructor(\n    private readonly runtime: PTCRuntime,\n    private readonly ctxFactory: ExecContextFactory = DEFAULT_CTX_FACTORY,\n  ) {}\n\n  /**\n   * Returns all registered tools as LangChain StructuredTool[].\n   * Each tool invokes the runtime through the full pipeline (policy, HITL, etc.).\n   */\n  getLangChainTools(): StructuredToolInterface[] {\n    const registry = this.runtime.getRegistry();\n    const specs = registry.snapshot();\n\n    return specs.map((spec) => this.specToLangChainTool(spec));\n  }\n\n  /**\n   * Returns LangChain tools for a subset of tools (by name or query).\n   */\n  getLangChainToolsForNames(toolNames: string[]): StructuredToolInterface[] {\n    const registry = this.runtime.getRegistry();\n    const set = new Set(toolNames);\n    const specs = registry.snapshot().filter((s) => set.has(s.name));\n    return specs.map((spec) => this.specToLangChainTool(spec));\n  }\n\n  private specToLangChainTool(spec: ToolSpec): DynamicStructuredTool {\n    const runtime = this.runtime;\n    const ctxFactory = this.ctxFactory;\n    const enriched = enrichSpecWithCanonicalSchema(spec);\n\n    const schema = schemaForLangChain(enriched.inputSchema);\n    return new DynamicStructuredTool({\n      name: spec.name,\n      description: spec.description ?? `Tool: ${spec.name}`,\n      schema,\n      func: async (args: Record<string, unknown>): Promise<string> => {\n        const normalizedArgs = normalizeArgs(args);\n        const intent = buildIntent(spec.name, enriched.inputSchema, normalizedArgs);\n        const ctx = ctxFactory();\n        const result = await runtime.invoke(intent, ctx);\n        return serializeToolResult(result);\n      },\n    });\n  }\n}\n","/**\n * Create LangChain tools from config (sync or async). Uses PTCRuntime + registry\n * and exposes tools via LangChainToolsHub. All invokes go through PTC Intent.\n */\n\nimport { loadToolConfig, resolveSandboxedPath } from \"../tools/util/toolConfig.js\";\nimport {\n  expandToolDescriptorsToRegistryNames,\n  isBarePackageDescriptor,\n  npmDescriptorToPackagePrefixWithVersion,\n  fileDescriptorToPackagePrefix,\n} from \"../tools/util/toolDescriptor.js\";\nimport { createRuntimeFromConfigSync, createRuntimeFromConfig } from \"./runtimeFromConfig.js\";\nimport type { CreateRuntimeOptions } from \"./runtimeFromConfig.js\";\nimport { LangChainToolsHub } from \"./adapters/LangChainToolsHub.js\";\nimport type { StructuredToolInterface } from \"@langchain/core/tools\";\n\nexport interface CreateAgentToolsOptions extends CreateRuntimeOptions {\n  /** Path to tool.yaml; when set, only tools listed there are returned; sandboxedPath from it is used as sandboxRoot */\n  configFilePath?: string;\n  /** Project path for async loading (use createLangChainToolsAsync) */\n  projectPath?: string;\n}\n\n/** Merge host lists from multiple sources (e.g. tool.yaml + programmatic). Union, dedup, preserves order. */\nfunction mergeHostLists(a?: string[], b?: string[]): string[] {\n  const seen = new Set<string>();\n  const out: string[] = [];\n  for (const list of [a ?? [], b ?? []]) {\n    for (const h of list) {\n      if (!seen.has(h)) {\n        seen.add(h);\n        out.push(h);\n      }\n    }\n  }\n  return out;\n}\n\nfunction runtimeOptionsFromConfig(opts: CreateAgentToolsOptions): CreateRuntimeOptions {\n  const coreTools = opts.coreTools ?? { sandboxRoot: process.cwd(), allowedHosts: [], enableSandboxValidation: false };\n  if (opts.configFilePath) {\n    const toolConfig = loadToolConfig(opts.configFilePath);\n    const updates: {\n      sandboxRoot?: string;\n      enableSandboxValidation?: boolean;\n      allowedHosts?: string[];\n      blockedHosts?: string[];\n      blockedCidrs?: string[];\n      toolOverrides?: Record<string, Record<string, unknown>>;\n      packageDefaults?: Record<string, Record<string, unknown>>;\n    } = {};\n    if (toolConfig.sandboxedPath && typeof toolConfig.sandboxedPath === \"string\") {\n      updates.sandboxRoot = resolveSandboxedPath(opts.configFilePath, toolConfig.sandboxedPath);\n    }\n    if (typeof toolConfig.enableSandboxValidation === \"boolean\") {\n      updates.enableSandboxValidation = toolConfig.enableSandboxValidation;\n    } else if (coreTools.enableSandboxValidation == null) {\n      updates.enableSandboxValidation = false;\n    }\n    // Smart merge: union of allowedHosts and blockedHosts from yaml + programmatic (both lists always applied)\n    updates.allowedHosts = mergeHostLists(coreTools.allowedHosts, toolConfig.allowedHosts);\n    updates.blockedHosts = mergeHostLists(coreTools.blockedHosts, toolConfig.blockedHosts);\n    if (Array.isArray(toolConfig.blockedCidrs) && toolConfig.blockedCidrs.length > 0) {\n      updates.blockedCidrs = toolConfig.blockedCidrs;\n    } else if (coreTools.blockedCidrs?.length) {\n      updates.blockedCidrs = coreTools.blockedCidrs;\n    }\n    let hasToolDefaults = false;\n    const flatOverrides: Record<string, Record<string, unknown>> = { ...coreTools.toolOverrides };\n    if (toolConfig.toolDefaults != null && Object.keys(toolConfig.toolDefaults).length > 0) {\n      Object.assign(flatOverrides, toolConfig.toolDefaults);\n      hasToolDefaults = true;\n    }\n    const packageDefaults: Record<string, Record<string, unknown>> = { ...coreTools.packageDefaults };\n    if (toolConfig.packageToolDefaults != null && Object.keys(toolConfig.packageToolDefaults).length > 0) {\n      for (const [descriptor, pkgConfig] of Object.entries(toolConfig.packageToolDefaults)) {\n        const prefix = descriptor.startsWith(\"file:\")\n          ? fileDescriptorToPackagePrefix(descriptor)\n          : npmDescriptorToPackagePrefixWithVersion(descriptor);\n        if (!prefix) continue;\n        const pkgDefaults =\n          pkgConfig?.defaults != null && typeof pkgConfig.defaults === \"object\" && !Array.isArray(pkgConfig.defaults)\n            ? (pkgConfig.defaults as Record<string, unknown>)\n            : {};\n        if (Object.keys(pkgDefaults).length > 0) {\n          packageDefaults[prefix] = pkgDefaults;\n        }\n        const toolConfigs = pkgConfig?.tools != null && typeof pkgConfig.tools === \"object\" && !Array.isArray(pkgConfig.tools) ? pkgConfig.tools : {};\n        for (const [toolName, config] of Object.entries(toolConfigs)) {\n          if (config != null && typeof config === \"object\") {\n            hasToolDefaults = true;\n            flatOverrides[`${prefix}::${toolName}`] = { ...pkgDefaults, ...(config as Record<string, unknown>) };\n          }\n        }\n      }\n      if (Object.keys(packageDefaults).length > 0) {\n        updates.packageDefaults = packageDefaults;\n      }\n    }\n    if (hasToolDefaults) {\n      updates.toolOverrides = flatOverrides;\n    }\n    if (Object.keys(updates).length > 0) {\n      return { ...opts, coreTools: { ...coreTools, ...updates } };\n    }\n  }\n  return { ...opts, coreTools };\n}\n\n/**\n * Create LangChain tools synchronously. When configFilePath is set, returns only\n * tools listed in that file (and that exist in the registry). If tool.yaml has\n * sandboxedPath, fs tools can only access that directory.\n */\nexport function createAgentTools(\n  options?: CreateAgentToolsOptions | string\n): StructuredToolInterface[] {\n  const opts: CreateAgentToolsOptions =\n    typeof options === \"string\" ? { configFilePath: options } : options ?? {};\n  const runtimeOpts = runtimeOptionsFromConfig(opts);\n  const { runtime } = createRuntimeFromConfigSync(runtimeOpts);\n  const hub = new LangChainToolsHub(runtime);\n\n  if (opts.configFilePath) {\n    const toolConfig = loadToolConfig(opts.configFilePath);\n    const names = Array.isArray(toolConfig.tools) ? toolConfig.tools : [];\n    if (names.length > 0) {\n      const registryNames = runtime.getRegistry().snapshot().map((s) => s.name);\n      const allBarePackages = names.every((n) => isBarePackageDescriptor(String(n)));\n      if (allBarePackages) {\n        return hub.getLangChainTools();\n      }\n      const expanded = expandToolDescriptorsToRegistryNames(names, registryNames);\n      return hub.getLangChainToolsForNames(expanded);\n    }\n  }\n\n  return hub.getLangChainTools();\n}\n\n/**\n * Create LangChain tools asynchronously. Use when projectPath is set to load\n * tools from the project before building the tool list.\n */\nexport async function createLangChainToolsAsync(\n  options: CreateAgentToolsOptions = {}\n): Promise<StructuredToolInterface[]> {\n  const runtimeOpts = runtimeOptionsFromConfig(options);\n  const { runtime } = await createRuntimeFromConfig(runtimeOpts);\n  const hub = new LangChainToolsHub(runtime);\n\n  if (options.configFilePath) {\n    const toolConfig = loadToolConfig(options.configFilePath);\n    const names = Array.isArray(toolConfig.tools) ? toolConfig.tools : [];\n    if (names.length > 0) {\n      const registryNames = runtime.getRegistry().snapshot().map((s) => s.name);\n      const allBarePackages = names.every((n) => isBarePackageDescriptor(String(n)));\n      if (allBarePackages) {\n        return hub.getLangChainTools();\n      }\n      const expanded = expandToolDescriptorsToRegistryNames(names, registryNames);\n      return hub.getLangChainToolsForNames(expanded);\n    }\n  }\n\n  return hub.getLangChainTools();\n}\n","/**\n * Public API: three create functions (config-driven) + runtime.\n *\n * 1. createLangChainTools(config?) → LangChain tools (createReactAgent / AgentExecutor)\n * 2. createMCPServer(runtime | config, options?) → MCP server (stdio, Cursor / Claude)\n * 3. createOpenAPIServer(runtime | config, options?) → HTTP + OpenAPI/Swagger (GET /tools, POST /invoke)\n *\n * All tool invokes go through PTC Intent (runtime.invoke(intent, ctx)) for policy, budget, observability.\n * Use createRuntimeFromConfig(config) when you need the runtime for multiple servers.\n */\n\nexport { createAgentTools, createLangChainToolsAsync } from \"./createAgentTools.js\";\nexport type { CreateAgentToolsOptions } from \"./createAgentTools.js\";\n\nexport { createHttpService } from \"./expose/openapiHttp.js\";\nexport type {\n  CreateHttpServiceOptions,\n  HttpServiceResult,\n  OpenAPIHttpServerOptions,\n} from \"./expose/openapiHttp.js\";\n/** Alias: OpenAPI server with Swagger support */\nexport { createHttpService as createOpenAPIServer } from \"./expose/openapiHttp.js\";\n\nexport {\n  createMCPServer,\n  runMCPServerOverStdio,\n  createMCPStreamableHttpHandler,\n  createMCPServerStreamableHttp,\n} from \"./expose/mcpServer.js\";\nexport type {\n  MCPServerOptions,\n  MCPServerResult,\n  MCPStreamableHttpHandler,\n  MCPServerStreamableHttpResult,\n  CreateMCPServerStreamableHttpOptions,\n} from \"./expose/mcpServer.js\";\n\nexport { createRuntimeFromConfig, createRuntimeFromConfigSync } from \"./runtimeFromConfig.js\";\nexport type { CreateRuntimeOptions, CreateRuntimeResult } from \"./runtimeFromConfig.js\";\n\nexport { PTCRuntime } from \"../core/runtime/PTCRuntime.js\";\nexport type { PTCRuntimeConfig } from \"../core/runtime/PTCRuntime.js\";\n\nimport { createAgentTools, createLangChainToolsAsync } from \"./createAgentTools.js\";\nimport { createHttpService } from \"./expose/openapiHttp.js\";\nimport {\n  createMCPServer,\n  runMCPServerOverStdio,\n  createMCPStreamableHttpHandler,\n  createMCPServerStreamableHttp,\n} from \"./expose/mcpServer.js\";\nimport { createRuntimeFromConfig, createRuntimeFromConfigSync } from \"./runtimeFromConfig.js\";\n\n/**\n * Facade: grouped API for lower import complexity in callers.\n */\nexport const langchainApi = {\n  createAgentTools,\n  createLangChainToolsAsync,\n} as const;\n\n/**\n * Facade: grouped runtime creation helpers.\n */\nexport const runtimeApi = {\n  createRuntimeFromConfig,\n  createRuntimeFromConfigSync,\n} as const;\n\n/**\n * Facade: grouped MCP server helpers.\n */\nexport const mcpApi = {\n  createMCPServer,\n  runMCPServerOverStdio,\n  createMCPStreamableHttpHandler,\n  createMCPServerStreamableHttp,\n} as const;\n\n/**\n * Facade: grouped OpenAPI/HTTP helpers.\n */\nexport const openApi = {\n  createOpenAPIServer: createHttpService,\n  createHttpService,\n} as const;\n"]}