@easynet/agent-tool-hub 1.0.6 → 1.0.8

package/README.md

@@ -115,18 +115,15 @@ npx agent-tool-hub list    # list discovered tools
 
 ### In code
 
-Load from config, init, then invoke:
+Recommended — create and init in one call:
 
 ```ts
-import { createToolHubAndInitFromConfig } from "@easynet/agent-tool-hub";
+import { createAgentToolHub } from "@easynet/agent-tool-hub";
 
-const hub = await createToolHubAndInitFromConfig("toolhub.yaml");
-const result = await hub.invokeTool("utils.calculator", { expression: "1 + 2" });
-// result.ok, result.data, result.error, etc.
+const toolHub = await createAgentToolHub("toolhub.yaml");
+const result = await toolHub.invokeTool("utils.calculator", { expression: "1 + 2" });
 ```
 
-Or build the hub yourself: `createToolHub(options)` → `await hub.initAllTools()`; run tools with `hub.invokeTool(name, args, options)`.
-
 ---
 
 See `toolhub.yaml` for config and `examples/` for full tool layouts.

package/dist/chunk-CJZ2EWUG.cjs

@@ -0,0 +1,101 @@
+'use strict';
+
+var chunkXHNKPSOO_cjs = require('./chunk-XHNKPSOO.cjs');
+var path = require('path');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var path__default = /*#__PURE__*/_interopDefault(path);
+
+var AgentToolHub = class {
+  configPath;
+  hub = null;
+  /**
+   * @param configPath Optional path to toolhub config (YAML). If omitted, uses
+   *   default "toolhub.yaml" resolved from process.cwd().
+   */
+  constructor(configPath) {
+    this.configPath = configPath ? path__default.default.resolve(process.cwd(), configPath) : path__default.default.resolve(process.cwd(), chunkXHNKPSOO_cjs.DEFAULT_CONFIG_FILE);
+  }
+  /**
+   * Load config from the path given at construction, create the underlying ToolHub,
+   * and initialize all tools. Must be called before using invokeTool, listToolMetadata, etc.
+   */
+  async init() {
+    const { options } = await chunkXHNKPSOO_cjs.loadToolHubConfig(this.configPath);
+    this.hub = chunkXHNKPSOO_cjs.createToolHub(options);
+    return this.hub.initAllTools();
+  }
+  requireHub() {
+    if (!this.hub) {
+      throw new Error(
+        "AgentToolHub not initialized. Call await toolHub.init() first."
+      );
+    }
+    return this.hub;
+  }
+  listToolMetadata() {
+    return this.requireHub().listToolMetadata();
+  }
+  getToolDescription(toolName) {
+    return this.requireHub().getToolDescription(toolName);
+  }
+  async invokeTool(toolName, args, options = {}) {
+    return this.requireHub().invokeTool(toolName, args, options);
+  }
+  async invokeIntent(intent, ctx) {
+    return this.requireHub().invokeIntent(intent, ctx);
+  }
+  getRegistry() {
+    return this.requireHub().getRegistry();
+  }
+  getRuntime() {
+    return this.requireHub().getRuntime();
+  }
+  async refreshTools() {
+    return this.requireHub().refreshTools();
+  }
+  async addRoots(roots, refresh = true) {
+    return this.requireHub().addRoots(roots, refresh);
+  }
+  async setRoots(roots, refresh = true) {
+    return this.requireHub().setRoots(roots, refresh);
+  }
+  watchRoots(options = {}) {
+    this.requireHub().watchRoots(options);
+  }
+  unwatchRoots() {
+    this.requireHub().unwatchRoots();
+  }
+  async shutdown() {
+    if (this.hub) {
+      await this.hub.shutdown();
+      this.hub = null;
+    }
+  }
+  /** Config path used for init (resolved absolute path). */
+  getConfigPath() {
+    return this.configPath;
+  }
+};
+async function createToolHubAndInit(options) {
+  const hub = chunkXHNKPSOO_cjs.createToolHub(options);
+  await hub.initAllTools();
+  return hub;
+}
+async function createToolHubAndInitFromConfig(configPath) {
+  const { options } = await chunkXHNKPSOO_cjs.loadToolHubConfig(configPath);
+  return createToolHubAndInit(options);
+}
+async function createAgentToolHub(configPath) {
+  const hub = new AgentToolHub(configPath);
+  await hub.init();
+  return hub;
+}
+
+exports.AgentToolHub = AgentToolHub;
+exports.createAgentToolHub = createAgentToolHub;
+exports.createToolHubAndInit = createToolHubAndInit;
+exports.createToolHubAndInitFromConfig = createToolHubAndInitFromConfig;
+//# sourceMappingURL=chunk-CJZ2EWUG.cjs.map
+//# sourceMappingURL=chunk-CJZ2EWUG.cjs.map

package/dist/chunk-CJZ2EWUG.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/toolhub-runtime.ts"],"names":["path","DEFAULT_CONFIG_FILE","loadToolHubConfig","createToolHub"],"mappings":"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","file":"chunk-CJZ2EWUG.cjs","sourcesContent":["import path from \"node:path\";\nimport { ToolHub, createToolHub } from \"./tool-hub/ToolHub.js\";\nimport { loadToolHubConfig } from \"./config/ToolHubConfig.js\";\nimport { DEFAULT_CONFIG_FILE } from \"./config/ToolHubConfig.js\";\nimport type {\n  ToolHubInitOptions,\n  ToolMetadata,\n  ToolDescription,\n  InvokeOptions,\n} from \"./tool-hub/ToolHub.js\";\nimport type { ToolSpec } from \"./types/ToolSpec.js\";\nimport type { ToolIntent } from \"./types/ToolIntent.js\";\nimport type { ExecContext } from \"./types/ToolIntent.js\";\nimport type { ToolResult } from \"./types/ToolResult.js\";\nimport type { ToolRegistry } from \"./registry/ToolRegistry.js\";\nimport type { PTCRuntime } from \"./core/PTCRuntime.js\";\n\nexport { ToolHub, createToolHub };\nexport type { ToolHubInitOptions, InvokeOptions } from \"./tool-hub/ToolHub.js\";\n\n/**\n * High-level facade for initializing and using the tool hub from a config file.\n * Supports two constructor forms:\n * - `new AgentToolHub()` — uses default config path (toolhub.yaml in cwd).\n * - `new AgentToolHub(configPath)` — uses the given config file path.\n *\n * Call `await toolHub.init()` after construction to load config and discover tools.\n * Then use the same API as ToolHub (invokeTool, listToolMetadata, etc.).\n */\nexport class AgentToolHub {\n  private readonly configPath: string;\n  private hub: ToolHub | null = null;\n\n  /**\n   * @param configPath Optional path to toolhub config (YAML). If omitted, uses\n   *   default \"toolhub.yaml\" resolved from process.cwd().\n   */\n  constructor(configPath?: string) {\n    this.configPath = configPath\n      ? path.resolve(process.cwd(), configPath)\n      : path.resolve(process.cwd(), DEFAULT_CONFIG_FILE);\n  }\n\n  /**\n   * Load config from the path given at construction, create the underlying ToolHub,\n   * and initialize all tools. Must be called before using invokeTool, listToolMetadata, etc.\n   */\n  async init(): Promise<ToolSpec[]> {\n    const { options } = await loadToolHubConfig(this.configPath);\n    this.hub = createToolHub(options);\n    return this.hub.initAllTools();\n  }\n\n  private requireHub(): ToolHub {\n    if (!this.hub) {\n      throw new Error(\n        \"AgentToolHub not initialized. Call await toolHub.init() first.\",\n      );\n    }\n    return this.hub;\n  }\n\n  listToolMetadata(): ToolMetadata[] {\n    return this.requireHub().listToolMetadata();\n  }\n\n  getToolDescription(toolName: string): ToolDescription {\n    return this.requireHub().getToolDescription(toolName);\n  }\n\n  async invokeTool(\n    toolName: string,\n    args: unknown,\n    options: InvokeOptions = {},\n  ): Promise<ToolResult> {\n    return this.requireHub().invokeTool(toolName, args, options);\n  }\n\n  async invokeIntent(intent: ToolIntent, ctx: ExecContext): Promise<ToolResult> {\n    return this.requireHub().invokeIntent(intent, ctx);\n  }\n\n  getRegistry(): ToolRegistry {\n    return this.requireHub().getRegistry();\n  }\n\n  getRuntime(): PTCRuntime {\n    return this.requireHub().getRuntime();\n  }\n\n  async refreshTools(): Promise<ToolSpec[]> {\n    return this.requireHub().refreshTools();\n  }\n\n  async addRoots(\n    roots: Array<string | { path: string; namespace?: string }>,\n    refresh = true,\n  ): Promise<ToolSpec[] | void> {\n    return this.requireHub().addRoots(roots, refresh);\n  }\n\n  async setRoots(\n    roots: Array<string | { path: string; namespace?: string }>,\n    refresh = true,\n  ): Promise<ToolSpec[] | void> {\n    return this.requireHub().setRoots(roots, refresh);\n  }\n\n  watchRoots(options: { debounceMs?: number; persistent?: boolean } = {}): void {\n    this.requireHub().watchRoots(options);\n  }\n\n  unwatchRoots(): void {\n    this.requireHub().unwatchRoots();\n  }\n\n  async shutdown(): Promise<void> {\n    if (this.hub) {\n      await this.hub.shutdown();\n      this.hub = null;\n    }\n  }\n\n  /** Config path used for init (resolved absolute path). */\n  getConfigPath(): string {\n    return this.configPath;\n  }\n}\n\nexport async function createToolHubAndInit(\n  options: ToolHubInitOptions,\n) {\n  const hub = createToolHub(options);\n  await hub.initAllTools();\n  return hub;\n}\n\nexport async function createToolHubAndInitFromConfig(configPath: string) {\n  const { options } = await loadToolHubConfig(configPath);\n  return createToolHubAndInit(options);\n}\n\n/**\n * Create an AgentToolHub from a config path, run init(), and return the instance.\n * Equivalent to: `const hub = new AgentToolHub(configPath); await hub.init(); return hub;`\n */\nexport async function createAgentToolHub(configPath: string): Promise<AgentToolHub> {\n  const hub = new AgentToolHub(configPath);\n  await hub.init();\n  return hub;\n}\n"]}

package/dist/chunk-MMNUEPKB.js

@@ -0,0 +1,92 @@
+import { DEFAULT_CONFIG_FILE, loadToolHubConfig, createToolHub } from './chunk-QSBCXLMH.js';
+import path from 'path';
+
+var AgentToolHub = class {
+  configPath;
+  hub = null;
+  /**
+   * @param configPath Optional path to toolhub config (YAML). If omitted, uses
+   *   default "toolhub.yaml" resolved from process.cwd().
+   */
+  constructor(configPath) {
+    this.configPath = configPath ? path.resolve(process.cwd(), configPath) : path.resolve(process.cwd(), DEFAULT_CONFIG_FILE);
+  }
+  /**
+   * Load config from the path given at construction, create the underlying ToolHub,
+   * and initialize all tools. Must be called before using invokeTool, listToolMetadata, etc.
+   */
+  async init() {
+    const { options } = await loadToolHubConfig(this.configPath);
+    this.hub = createToolHub(options);
+    return this.hub.initAllTools();
+  }
+  requireHub() {
+    if (!this.hub) {
+      throw new Error(
+        "AgentToolHub not initialized. Call await toolHub.init() first."
+      );
+    }
+    return this.hub;
+  }
+  listToolMetadata() {
+    return this.requireHub().listToolMetadata();
+  }
+  getToolDescription(toolName) {
+    return this.requireHub().getToolDescription(toolName);
+  }
+  async invokeTool(toolName, args, options = {}) {
+    return this.requireHub().invokeTool(toolName, args, options);
+  }
+  async invokeIntent(intent, ctx) {
+    return this.requireHub().invokeIntent(intent, ctx);
+  }
+  getRegistry() {
+    return this.requireHub().getRegistry();
+  }
+  getRuntime() {
+    return this.requireHub().getRuntime();
+  }
+  async refreshTools() {
+    return this.requireHub().refreshTools();
+  }
+  async addRoots(roots, refresh = true) {
+    return this.requireHub().addRoots(roots, refresh);
+  }
+  async setRoots(roots, refresh = true) {
+    return this.requireHub().setRoots(roots, refresh);
+  }
+  watchRoots(options = {}) {
+    this.requireHub().watchRoots(options);
+  }
+  unwatchRoots() {
+    this.requireHub().unwatchRoots();
+  }
+  async shutdown() {
+    if (this.hub) {
+      await this.hub.shutdown();
+      this.hub = null;
+    }
+  }
+  /** Config path used for init (resolved absolute path). */
+  getConfigPath() {
+    return this.configPath;
+  }
+};
+async function createToolHubAndInit(options) {
+  const hub = createToolHub(options);
+  await hub.initAllTools();
+  return hub;
+}
+async function createToolHubAndInitFromConfig(configPath) {
+  const { options } = await loadToolHubConfig(configPath);
+  return createToolHubAndInit(options);
+}
+async function createAgentToolHub(configPath) {
+  const hub = new AgentToolHub(configPath);
+  await hub.init();
+  return hub;
+}
+
+export { AgentToolHub, createAgentToolHub, createToolHubAndInit, createToolHubAndInitFromConfig };
+//# sourceMappingURL=chunk-MMNUEPKB.js.map
+//# sourceMappingURL=chunk-MMNUEPKB.js.map

package/dist/chunk-MMNUEPKB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/toolhub-runtime.ts"],"names":[],"mappings":"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","file":"chunk-MMNUEPKB.js","sourcesContent":["import path from \"node:path\";\nimport { ToolHub, createToolHub } from \"./tool-hub/ToolHub.js\";\nimport { loadToolHubConfig } from \"./config/ToolHubConfig.js\";\nimport { DEFAULT_CONFIG_FILE } from \"./config/ToolHubConfig.js\";\nimport type {\n  ToolHubInitOptions,\n  ToolMetadata,\n  ToolDescription,\n  InvokeOptions,\n} from \"./tool-hub/ToolHub.js\";\nimport type { ToolSpec } from \"./types/ToolSpec.js\";\nimport type { ToolIntent } from \"./types/ToolIntent.js\";\nimport type { ExecContext } from \"./types/ToolIntent.js\";\nimport type { ToolResult } from \"./types/ToolResult.js\";\nimport type { ToolRegistry } from \"./registry/ToolRegistry.js\";\nimport type { PTCRuntime } from \"./core/PTCRuntime.js\";\n\nexport { ToolHub, createToolHub };\nexport type { ToolHubInitOptions, InvokeOptions } from \"./tool-hub/ToolHub.js\";\n\n/**\n * High-level facade for initializing and using the tool hub from a config file.\n * Supports two constructor forms:\n * - `new AgentToolHub()` — uses default config path (toolhub.yaml in cwd).\n * - `new AgentToolHub(configPath)` — uses the given config file path.\n *\n * Call `await toolHub.init()` after construction to load config and discover tools.\n * Then use the same API as ToolHub (invokeTool, listToolMetadata, etc.).\n */\nexport class AgentToolHub {\n  private readonly configPath: string;\n  private hub: ToolHub | null = null;\n\n  /**\n   * @param configPath Optional path to toolhub config (YAML). If omitted, uses\n   *   default \"toolhub.yaml\" resolved from process.cwd().\n   */\n  constructor(configPath?: string) {\n    this.configPath = configPath\n      ? path.resolve(process.cwd(), configPath)\n      : path.resolve(process.cwd(), DEFAULT_CONFIG_FILE);\n  }\n\n  /**\n   * Load config from the path given at construction, create the underlying ToolHub,\n   * and initialize all tools. Must be called before using invokeTool, listToolMetadata, etc.\n   */\n  async init(): Promise<ToolSpec[]> {\n    const { options } = await loadToolHubConfig(this.configPath);\n    this.hub = createToolHub(options);\n    return this.hub.initAllTools();\n  }\n\n  private requireHub(): ToolHub {\n    if (!this.hub) {\n      throw new Error(\n        \"AgentToolHub not initialized. Call await toolHub.init() first.\",\n      );\n    }\n    return this.hub;\n  }\n\n  listToolMetadata(): ToolMetadata[] {\n    return this.requireHub().listToolMetadata();\n  }\n\n  getToolDescription(toolName: string): ToolDescription {\n    return this.requireHub().getToolDescription(toolName);\n  }\n\n  async invokeTool(\n    toolName: string,\n    args: unknown,\n    options: InvokeOptions = {},\n  ): Promise<ToolResult> {\n    return this.requireHub().invokeTool(toolName, args, options);\n  }\n\n  async invokeIntent(intent: ToolIntent, ctx: ExecContext): Promise<ToolResult> {\n    return this.requireHub().invokeIntent(intent, ctx);\n  }\n\n  getRegistry(): ToolRegistry {\n    return this.requireHub().getRegistry();\n  }\n\n  getRuntime(): PTCRuntime {\n    return this.requireHub().getRuntime();\n  }\n\n  async refreshTools(): Promise<ToolSpec[]> {\n    return this.requireHub().refreshTools();\n  }\n\n  async addRoots(\n    roots: Array<string | { path: string; namespace?: string }>,\n    refresh = true,\n  ): Promise<ToolSpec[] | void> {\n    return this.requireHub().addRoots(roots, refresh);\n  }\n\n  async setRoots(\n    roots: Array<string | { path: string; namespace?: string }>,\n    refresh = true,\n  ): Promise<ToolSpec[] | void> {\n    return this.requireHub().setRoots(roots, refresh);\n  }\n\n  watchRoots(options: { debounceMs?: number; persistent?: boolean } = {}): void {\n    this.requireHub().watchRoots(options);\n  }\n\n  unwatchRoots(): void {\n    this.requireHub().unwatchRoots();\n  }\n\n  async shutdown(): Promise<void> {\n    if (this.hub) {\n      await this.hub.shutdown();\n      this.hub = null;\n    }\n  }\n\n  /** Config path used for init (resolved absolute path). */\n  getConfigPath(): string {\n    return this.configPath;\n  }\n}\n\nexport async function createToolHubAndInit(\n  options: ToolHubInitOptions,\n) {\n  const hub = createToolHub(options);\n  await hub.initAllTools();\n  return hub;\n}\n\nexport async function createToolHubAndInitFromConfig(configPath: string) {\n  const { options } = await loadToolHubConfig(configPath);\n  return createToolHubAndInit(options);\n}\n\n/**\n * Create an AgentToolHub from a config path, run init(), and return the instance.\n * Equivalent to: `const hub = new AgentToolHub(configPath); await hub.init(); return hub;`\n */\nexport async function createAgentToolHub(configPath: string): Promise<AgentToolHub> {\n  const hub = new AgentToolHub(configPath);\n  await hub.init();\n  return hub;\n}\n"]}

package/dist/{chunk-HPDQEW2P.js → chunk-QSBCXLMH.js}

@@ -15,6 +15,7 @@ import { createReadStream, watch } from 'fs';
 import { createInterface } from 'readline';
 import { lookup } from 'dns/promises';
 
+var DEFAULT_CONFIG_FILE = "toolhub.yaml";
 function resolveRoots(rootsRaw, configDir) {
   let coreToolsInlineConfig;
   const roots = rootsRaw.map((root) => {
@@ -5246,6 +5247,6 @@ function createToolHub(options) {
   return new ToolHub(options);
 }
 
-export { BudgetManager, ComfyUIAdapter, CoreAdapter, DEFAULT_CORE_TOOLS_CONFIG, DirectoryScanner, DiscoveryError, EventLog, LangChainAdapter, MCPAdapter, Metrics, N8nAdapter, PTCRuntime, PolicyDeniedError, PolicyEngine, SchemaValidationError, SchemaValidator, SkillAdapter, SkillManifestError, ToolHub, ToolRegistry, Tracing, buildEvidence, createTaggedError, createToolHub, deletePathSpec, downloadFileSpec, fetchJsonSpec, fetchTextSpec, hashTextSpec, headSpec, isIpInBlockedCidrs, isRetryable, jsonSelectSpec, listDirSpec, loadSkillDefinition, loadToolHubConfig, mapToolHubConfig, nowSpec, parseSkillMd, readTextSpec, registerCoreTools, resolveSandboxedPath, scanSkillResources, searchTextSpec, sha256Spec, templateRenderSpec, truncateSpec, validateFrontmatter, validateUrl, withRetry, writeTextSpec };
-//# sourceMappingURL=chunk-HPDQEW2P.js.map
-//# sourceMappingURL=chunk-HPDQEW2P.js.map
+export { BudgetManager, ComfyUIAdapter, CoreAdapter, DEFAULT_CONFIG_FILE, DEFAULT_CORE_TOOLS_CONFIG, DirectoryScanner, DiscoveryError, EventLog, LangChainAdapter, MCPAdapter, Metrics, N8nAdapter, PTCRuntime, PolicyDeniedError, PolicyEngine, SchemaValidationError, SchemaValidator, SkillAdapter, SkillManifestError, ToolHub, ToolRegistry, Tracing, buildEvidence, createTaggedError, createToolHub, deletePathSpec, downloadFileSpec, fetchJsonSpec, fetchTextSpec, hashTextSpec, headSpec, isIpInBlockedCidrs, isRetryable, jsonSelectSpec, listDirSpec, loadSkillDefinition, loadToolHubConfig, mapToolHubConfig, nowSpec, parseSkillMd, readTextSpec, registerCoreTools, resolveSandboxedPath, scanSkillResources, searchTextSpec, sha256Spec, templateRenderSpec, truncateSpec, validateFrontmatter, validateUrl, withRetry, writeTextSpec };
+//# sourceMappingURL=chunk-QSBCXLMH.js.map
+//# sourceMappingURL=chunk-QSBCXLMH.js.map