@easynet/agent-tool 1.0.16 → 1.0.18

package/dist/{chunk-UDGQSHEO.cjs → chunk-ZIFQWIN3.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkCDTLERB6_cjs = require('./chunk-CDTLERB6.cjs');
+var chunkEMI67SPN_cjs = require('./chunk-EMI67SPN.cjs');
 var tools = require('@langchain/core/tools');
 
 var DEFAULT_CTX_FACTORY = () => ({
@@ -51,7 +51,7 @@ var LangChainToolsHub = class {
         const intent = {
           tool: spec.name,
           args: args ?? {},
-          purpose: chunkCDTLERB6_cjs.LANGCHAIN_KIND
+          purpose: chunkEMI67SPN_cjs.LANGCHAIN_KIND
         };
         const ctx = ctxFactory();
         const result = await runtime.invoke(intent, ctx);
@@ -70,13 +70,36 @@ var LangChainToolsHub = class {
 };
 
 // src/api/createAgentTools.ts
+function mergeHostLists(a, b) {
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const list of [a ?? [], b ?? []]) {
+    for (const h of list) {
+      if (!seen.has(h)) {
+        seen.add(h);
+        out.push(h);
+      }
+    }
+  }
+  return out;
+}
 function runtimeOptionsFromConfig(opts) {
   const coreTools = opts.coreTools ?? { sandboxRoot: process.cwd(), allowedHosts: [] };
   if (opts.configFilePath) {
-    const toolConfig = chunkCDTLERB6_cjs.loadToolConfig(opts.configFilePath);
+    const toolConfig = chunkEMI67SPN_cjs.loadToolConfig(opts.configFilePath);
+    const updates = {};
     if (toolConfig.sandboxedPath && typeof toolConfig.sandboxedPath === "string") {
-      const sandboxRoot = chunkCDTLERB6_cjs.resolveSandboxedPath(opts.configFilePath, toolConfig.sandboxedPath);
-      return { ...opts, coreTools: { ...coreTools, sandboxRoot } };
+      updates.sandboxRoot = chunkEMI67SPN_cjs.resolveSandboxedPath(opts.configFilePath, toolConfig.sandboxedPath);
+    }
+    updates.allowedHosts = mergeHostLists(coreTools.allowedHosts, toolConfig.allowedHosts);
+    updates.blockedHosts = mergeHostLists(coreTools.blockedHosts, toolConfig.blockedHosts);
+    if (Array.isArray(toolConfig.blockedCidrs) && toolConfig.blockedCidrs.length > 0) {
+      updates.blockedCidrs = toolConfig.blockedCidrs;
+    } else if (coreTools.blockedCidrs?.length) {
+      updates.blockedCidrs = coreTools.blockedCidrs;
+    }
+    if (Object.keys(updates).length > 0) {
+      return { ...opts, coreTools: { ...coreTools, ...updates } };
     }
   }
   return { ...opts, coreTools };
@@ -84,21 +107,21 @@ function runtimeOptionsFromConfig(opts) {
 function createAgentTools(options) {
   const opts = typeof options === "string" ? { configFilePath: options } : options ?? {};
   const runtimeOpts = runtimeOptionsFromConfig(opts);
-  const { runtime } = chunkCDTLERB6_cjs.createRuntimeFromConfigSync(runtimeOpts);
+  const { runtime } = chunkEMI67SPN_cjs.createRuntimeFromConfigSync(runtimeOpts);
   const hub = new LangChainToolsHub(runtime);
   if (opts.configFilePath) {
-    const toolConfig = chunkCDTLERB6_cjs.loadToolConfig(opts.configFilePath);
+    const toolConfig = chunkEMI67SPN_cjs.loadToolConfig(opts.configFilePath);
     const names = Array.isArray(toolConfig.tools) ? toolConfig.tools : [];
     if (names.length > 0) {
       const registryNames = runtime.getRegistry().snapshot().map((s) => s.name);
-      const allBareBuiltin = names.every((n) => chunkCDTLERB6_cjs.isBarePackageDescriptor(String(n))) && names.some((n) => {
-        const p = chunkCDTLERB6_cjs.parseNpmDescriptor(String(n));
-        return p !== null && chunkCDTLERB6_cjs.BUILTIN_PKG_NAMES.includes(p.packageName);
+      const allBareBuiltin = names.every((n) => chunkEMI67SPN_cjs.isBarePackageDescriptor(String(n))) && names.some((n) => {
+        const p = chunkEMI67SPN_cjs.parseNpmDescriptor(String(n));
+        return p !== null && chunkEMI67SPN_cjs.BUILTIN_PKG_NAMES.includes(p.packageName);
       });
       if (allBareBuiltin) {
         return hub.getLangChainTools();
       }
-      const expanded = chunkCDTLERB6_cjs.expandToolDescriptorsToRegistryNames(names, registryNames);
+      const expanded = chunkEMI67SPN_cjs.expandToolDescriptorsToRegistryNames(names, registryNames);
       return hub.getLangChainToolsForNames(expanded);
     }
   }
@@ -106,21 +129,21 @@ function createAgentTools(options) {
 }
 async function createLangChainToolsAsync(options = {}) {
   const runtimeOpts = runtimeOptionsFromConfig(options);
-  const { runtime } = await chunkCDTLERB6_cjs.createRuntimeFromConfig(runtimeOpts);
+  const { runtime } = await chunkEMI67SPN_cjs.createRuntimeFromConfig(runtimeOpts);
   const hub = new LangChainToolsHub(runtime);
   if (options.configFilePath) {
-    const toolConfig = chunkCDTLERB6_cjs.loadToolConfig(options.configFilePath);
+    const toolConfig = chunkEMI67SPN_cjs.loadToolConfig(options.configFilePath);
     const names = Array.isArray(toolConfig.tools) ? toolConfig.tools : [];
     if (names.length > 0) {
       const registryNames = runtime.getRegistry().snapshot().map((s) => s.name);
-      const allBareBuiltin = names.every((n) => chunkCDTLERB6_cjs.isBarePackageDescriptor(String(n))) && names.some((n) => {
-        const p = chunkCDTLERB6_cjs.parseNpmDescriptor(String(n));
-        return p !== null && chunkCDTLERB6_cjs.BUILTIN_PKG_NAMES.includes(p.packageName);
+      const allBareBuiltin = names.every((n) => chunkEMI67SPN_cjs.isBarePackageDescriptor(String(n))) && names.some((n) => {
+        const p = chunkEMI67SPN_cjs.parseNpmDescriptor(String(n));
+        return p !== null && chunkEMI67SPN_cjs.BUILTIN_PKG_NAMES.includes(p.packageName);
       });
       if (allBareBuiltin) {
         return hub.getLangChainTools();
       }
-      const expanded = chunkCDTLERB6_cjs.expandToolDescriptorsToRegistryNames(names, registryNames);
+      const expanded = chunkEMI67SPN_cjs.expandToolDescriptorsToRegistryNames(names, registryNames);
       return hub.getLangChainToolsForNames(expanded);
     }
   }
@@ -130,5 +153,5 @@ async function createLangChainToolsAsync(options = {}) {
 exports.LangChainToolsHub = LangChainToolsHub;
 exports.createAgentTools = createAgentTools;
 exports.createLangChainToolsAsync = createLangChainToolsAsync;
-//# sourceMappingURL=chunk-UDGQSHEO.cjs.map
-//# sourceMappingURL=chunk-UDGQSHEO.cjs.map
+//# sourceMappingURL=chunk-ZIFQWIN3.cjs.map
+//# sourceMappingURL=chunk-ZIFQWIN3.cjs.map

package/dist/{chunk-UDGQSHEO.cjs.map → chunk-ZIFQWIN3.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/api/adapters/LangChainToolsHub.ts","../src/api/createAgentTools.ts"],"names":["DynamicStructuredTool","LANGCHAIN_KIND","loadToolConfig","resolveSandboxedPath","createRuntimeFromConfigSync","isBarePackageDescriptor","parseNpmDescriptor","BUILTIN_PKG_NAMES","expandToolDescriptorsToRegistryNames","createRuntimeFromConfig"],"mappings":"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","file":"chunk-UDGQSHEO.cjs","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 type { PTCRuntime } from \"../../core/runtime/PTCRuntime.js\";\nimport type { ToolSpec } from \"../../core/types/ToolSpec.js\";\nimport type { ExecContext } from \"../../core/types/ToolIntent.js\";\nimport type { ToolIntent } from \"../../core/types/ToolIntent.js\";\nimport { LANGCHAIN_KIND } from \"../../tools/langchain/types.js\";\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\n    return new DynamicStructuredTool({\n      name: spec.name,\n      description: spec.description ?? `Tool: ${spec.name}`,\n      schema: spec.inputSchema as Record<string, unknown>,\n      func: async (args: Record<string, unknown>): Promise<string> => {\n        const intent: ToolIntent = {\n          tool: spec.name,\n          args: args ?? {},\n          purpose: LANGCHAIN_KIND,\n        };\n        const ctx = ctxFactory();\n        const result = await runtime.invoke(intent, ctx);\n\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    });\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} from \"../tools/util/toolDescriptor.js\";\nimport {\n  createRuntimeFromConfigSync,\n  createRuntimeFromConfig,\n  BUILTIN_PKG_NAMES,\n  parseNpmDescriptor,\n} 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\nfunction runtimeOptionsFromConfig(opts: CreateAgentToolsOptions): CreateRuntimeOptions {\n  const coreTools = opts.coreTools ?? { sandboxRoot: process.cwd(), allowedHosts: [] };\n  if (opts.configFilePath) {\n    const toolConfig = loadToolConfig(opts.configFilePath);\n    if (toolConfig.sandboxedPath && typeof toolConfig.sandboxedPath === \"string\") {\n      const sandboxRoot = resolveSandboxedPath(opts.configFilePath, toolConfig.sandboxedPath);\n      return { ...opts, coreTools: { ...coreTools, sandboxRoot } };\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 allBareBuiltin =\n        names.every((n) => isBarePackageDescriptor(String(n))) &&\n        names.some((n) => {\n          const p = parseNpmDescriptor(String(n));\n          return p !== null && BUILTIN_PKG_NAMES.includes(p.packageName);\n        });\n      if (allBareBuiltin) {\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 allBareBuiltin =\n        names.every((n) => isBarePackageDescriptor(String(n))) &&\n        names.some((n) => {\n          const p = parseNpmDescriptor(String(n));\n          return p !== null && BUILTIN_PKG_NAMES.includes(p.packageName);\n        });\n      if (allBareBuiltin) {\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"]}
+{"version":3,"sources":["../src/api/adapters/LangChainToolsHub.ts","../src/api/createAgentTools.ts"],"names":["DynamicStructuredTool","LANGCHAIN_KIND","loadToolConfig","resolveSandboxedPath","createRuntimeFromConfigSync","isBarePackageDescriptor","parseNpmDescriptor","BUILTIN_PKG_NAMES","expandToolDescriptorsToRegistryNames","createRuntimeFromConfig"],"mappings":"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","file":"chunk-ZIFQWIN3.cjs","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 type { PTCRuntime } from \"../../core/runtime/PTCRuntime.js\";\nimport type { ToolSpec } from \"../../core/types/ToolSpec.js\";\nimport type { ExecContext } from \"../../core/types/ToolIntent.js\";\nimport type { ToolIntent } from \"../../core/types/ToolIntent.js\";\nimport { LANGCHAIN_KIND } from \"../../tools/langchain/types.js\";\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\n    return new DynamicStructuredTool({\n      name: spec.name,\n      description: spec.description ?? `Tool: ${spec.name}`,\n      schema: spec.inputSchema as Record<string, unknown>,\n      func: async (args: Record<string, unknown>): Promise<string> => {\n        const intent: ToolIntent = {\n          tool: spec.name,\n          args: args ?? {},\n          purpose: LANGCHAIN_KIND,\n        };\n        const ctx = ctxFactory();\n        const result = await runtime.invoke(intent, ctx);\n\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    });\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} from \"../tools/util/toolDescriptor.js\";\nimport {\n  createRuntimeFromConfigSync,\n  createRuntimeFromConfig,\n  BUILTIN_PKG_NAMES,\n  parseNpmDescriptor,\n} 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: [] };\n  if (opts.configFilePath) {\n    const toolConfig = loadToolConfig(opts.configFilePath);\n    const updates: {\n      sandboxRoot?: string;\n      allowedHosts?: string[];\n      blockedHosts?: string[];\n      blockedCidrs?: string[];\n    } = {};\n    if (toolConfig.sandboxedPath && typeof toolConfig.sandboxedPath === \"string\") {\n      updates.sandboxRoot = resolveSandboxedPath(opts.configFilePath, toolConfig.sandboxedPath);\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    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 allBareBuiltin =\n        names.every((n) => isBarePackageDescriptor(String(n))) &&\n        names.some((n) => {\n          const p = parseNpmDescriptor(String(n));\n          return p !== null && BUILTIN_PKG_NAMES.includes(p.packageName);\n        });\n      if (allBareBuiltin) {\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 allBareBuiltin =\n        names.every((n) => isBarePackageDescriptor(String(n))) &&\n        names.some((n) => {\n          const p = parseNpmDescriptor(String(n));\n          return p !== null && BUILTIN_PKG_NAMES.includes(p.packageName);\n        });\n      if (allBareBuiltin) {\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"]}