@easynet/agent-tool-hub 1.0.16 → 1.0.17

package/README.md

@@ -1,8 +1,6 @@
 # Agent Tool Hub
 
-**One registry, many protocols** — discover and run tools from MCP, LangChain, n8n, and SKILL through a single PTC runtime. [Source](https://github.com/easynet-world/agent-tool-hub)
-
-Define tools with simple, familiar formats: drop a folder under a configured root and use the protocol you like. One tool can be exposed in multiple protocols in the same folder.
+**One registry, many protocols** — MCP, LangChain, n8n, SKILL in one PTC runtime. [Source](https://github.com/easynet-world/agent-tool-hub) Drop a folder under a root; one tool can expose multiple protocols.
 
 ---
 
@@ -19,27 +17,31 @@ Define tools with simple, familiar formats: drop a folder under a configured roo
 
 ## Install
 
+Node 18+.
+
+**Default** — MCP / LangChain / SKILL only (~tens of MB):
+
 ```bash
 npm install @easynet/agent-tool-hub
 ```
 
-Node 18+ required.
+**+ n8n** — workflows / stock example (~1.3GB):
+
+```bash
+npm install @easynet/agent-tool-hub @easynet/n8n-local
+```
 
 ---
 
 ## Run the stock research example
 
-End-to-end demo: **ReAct agent** + **yahoo-finance SKILL tools** + **HTML report**. After [installing](#install), run (examples are bundled; no clone needed):
+ReAct + yahoo-finance SKILL + HTML report. After [install](#install):
 
 ```bash
 npx agent-toolhub-react-stock GOOGL
 ```
 
-Pass the ticker symbol (e.g. `GOOGL`, `AAPL`, `MSFT`). **Configure your own LLM** — point the example to your OpenAI-compatible API (base URL and API key) in [examples/agent-toolhub-react-stock.mjs](examples/agent-toolhub-react-stock.mjs) or via env (e.g. `OPENAI_API_KEY`, `OPENAI_BASE_URL`). The bundled example uses placeholder values; replace them with your model endpoint.
-
-Output: console step-by-step progress + an HTML report (e.g. `GOOGL-research-report.html`) in the current directory. See a sample report: [easynet-world.github.io/agent-tool-hub/AAPL-research-report.html](https://easynet-world.github.io/agent-tool-hub/AAPL-research-report.html).
-
-**Agent Run Report** — The generated HTML report is a highlight: it shows system/user prompts, the rendered Markdown report, and a Debug tab with step-by-step execution and token usage.
+Ticker: `GOOGL`, `AAPL`, `MSFT`. Set LLM in [examples/agent-toolhub-react-stock.mjs](examples/agent-toolhub-react-stock.mjs) or env (`OPENAI_API_KEY`, `OPENAI_BASE_URL`). Output: console + `GOOGL-research-report.html`. [Sample report](https://easynet-world.github.io/agent-tool-hub/AAPL-research-report.html).
 
 | Report | Debug |
 |--------|-------|
@@ -49,9 +51,7 @@ Output: console step-by-step progress + an HTML report (e.g. `GOOGL-research-rep
 
 ## Use
 
-### Embed in LangChain (minimal)
-
-Initialize the runtime, then pass the tools to your agent:
+### Embed in LangChain
 
 ```ts
 import { createAgentToolHub } from "@easynet/agent-tool-hub/langchain-tools";
@@ -71,33 +71,38 @@ const stream = await agent.stream(/* your messages */);
 await toolHub.shutdown();
 ```
 
-**Tracking & reports** — Optional: `formatStepProgress(step)` for console; `writeReportFromStream(stream, { htmlReportPath, onStep })` for an HTML report.
+Optional: `formatStepProgress(step)` for console; `writeReportFromStream(stream, { htmlReportPath, onStep })` for HTML report.
 
 ---
 
 ## Code reference
 
-Full examples for each tool type: [SKILL](#skill) · [LangChain](#langchain) · [MCP](#mcp) · [n8n](#n8n).
+[SKILL](#skill) · [LangChain](#langchain) · [MCP](#mcp) · [n8n](#n8n).
 
 ### SKILL
 
-Markdown spec + JS handler. Put under `skill/`. Full spec compliance and implementation details: [docs/AGENT_SKILLS_SPEC.md](docs/AGENT_SKILLS_SPEC.md).
+Markdown (SKILL.md) under `skill/`. Progressive disclosure:
 
-```yaml
+- **Level 1** = frontmatter (name, description)
+- **Level 2** = body (instructions)
+- **Level 3** = resources (e.g. `references/`, `scripts/`, `assets/`) — scanned from the skill dir, exposed as resource list; agents can reference them by path
+
+[Spec & impl](docs/AGENT_SKILLS_SPEC.md).
+
+```markdown
 # skill/SKILL.md
 ---
 name: my-tool
 description: What your tool does.
 ---
-```
 
-```js
-// skill/handler.js
-async function handler(args) {
-  const { x, y } = args ?? {};
-  return { result: { sum: Number(x) + Number(y) } };
-}
-export default handler;
+# Instructions (Level 2)
+
+Steps the agent should follow when using this skill.
+
+# Level 3 (resources)
+
+Put files under the skill dir (e.g. `references/REFERENCE.md`, `scripts/`, `assets/`). They appear in the resource list and can be read by path.
 ```
 
 ### LangChain
@@ -122,7 +127,7 @@ export default new CalculatorTool();
 
 ### MCP
 
-We do **not** provide MCP server implementation—we provide an **MCP client** that connects to existing MCP servers. Put a Cursor-style `mcp.json` under `mcp/`. To implement an MCP server, we recommend [**easy-mcp-server**](https://www.npmjs.com/package/easy-mcp-server).
+MCP **client** only; put Cursor-style `mcp.json` under `mcp/`. MCP servers: [easy-mcp-server](https://www.npmjs.com/package/easy-mcp-server).
 
 ```json
 // mcp/mcp.json
@@ -138,7 +143,7 @@ We do **not** provide MCP server implementation—we provide an **MCP client** t
 
 ### n8n
 
-Drop an n8n workflow JSON under `n8n/`. We run a local n8n server ([**@easynet/n8n-local**](https://www.npmjs.com/package/@easynet/n8n-local)) and call the instance directly—no API.
+Workflow JSON under `n8n/`; local server via [@easynet/n8n-local](https://www.npmjs.com/package/@easynet/n8n-local). Optional: `npm install @easynet/n8n-local`.
 
 ```json
 // n8n/workflow.json

package/dist/N8nLocalAdapter-2O65XSVJ.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+var chunk6QHFRQIS_cjs = require('./chunk-6QHFRQIS.cjs');
+require('./chunk-NTTBDQUF.cjs');
+
+
+
+Object.defineProperty(exports, "N8nLocalAdapter", {
+  enumerable: true,
+  get: function () { return chunk6QHFRQIS_cjs.N8nLocalAdapter; }
+});
+//# sourceMappingURL=N8nLocalAdapter-2O65XSVJ.cjs.map
+//# sourceMappingURL=N8nLocalAdapter-2O65XSVJ.cjs.map

package/dist/{N8nLocalAdapter-OFIRXYGD.cjs.map → N8nLocalAdapter-2O65XSVJ.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"N8nLocalAdapter-OFIRXYGD.cjs"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"N8nLocalAdapter-2O65XSVJ.cjs"}

package/dist/N8nLocalAdapter-RG5OEB6H.js

@@ -0,0 +1,4 @@
+export { N8nLocalAdapter } from './chunk-DKZK47TK.js';
+import './chunk-YSYEED4K.js';
+//# sourceMappingURL=N8nLocalAdapter-RG5OEB6H.js.map
+//# sourceMappingURL=N8nLocalAdapter-RG5OEB6H.js.map

package/dist/{N8nLocalAdapter-XIDYGB5X.js.map → N8nLocalAdapter-RG5OEB6H.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"N8nLocalAdapter-XIDYGB5X.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"N8nLocalAdapter-RG5OEB6H.js"}

package/dist/ToolRegistry-B4MF95IR.d.cts

@@ -0,0 +1,100 @@
+import { T as ToolSpec, a as ToolKind, C as Capability } from './ToolSpec-Be_To9dT.cjs';
+
+/**
+ * Evidence attached to a tool result for audit trail.
+ */
+interface Evidence {
+    type: "tool" | "file" | "url" | "text" | "metric";
+    ref: string;
+    summary: string;
+    createdAt: string;
+}
+/**
+ * Error information in a tool result.
+ */
+interface ToolError {
+    kind?: "TOOL_NOT_FOUND" | "INPUT_SCHEMA_INVALID" | "POLICY_DENIED" | "BUDGET_EXCEEDED" | "TIMEOUT" | "UPSTREAM_ERROR" | "OUTPUT_SCHEMA_INVALID" | "PATH_OUTSIDE_SANDBOX" | "FILE_TOO_LARGE" | "HTTP_DISALLOWED_HOST" | "HTTP_TIMEOUT" | "HTTP_TOO_LARGE";
+    message: string;
+    details?: unknown;
+}
+/**
+ * Unified tool result returned to agent-orchestra.
+ * Always structured, never throws raw exceptions.
+ */
+interface ToolResult {
+    ok: boolean;
+    result?: unknown;
+    evidence: Evidence[];
+    error?: ToolError;
+    /** Raw response for debugging (can be disabled in production) */
+    raw?: unknown;
+}
+
+/**
+ * Search query for tools.
+ */
+interface ToolSearchQuery {
+    /** Text search in name/description/tags */
+    text?: string;
+    /** Filter by tool kind */
+    kind?: ToolKind;
+    /** Filter by required capabilities */
+    capabilities?: Capability[];
+    /** Filter by tags */
+    tags?: string[];
+}
+/**
+ * Tool Registry: manages tool registration, lookup, and search.
+ * Supports both static registration and dynamic discovery via adapters.
+ */
+declare class ToolRegistry {
+    private readonly tools;
+    private readonly tagIndex;
+    private readonly kindIndex;
+    /**
+     * Register a single tool spec.
+     * Overwrites if same name already exists.
+     */
+    register(spec: ToolSpec): void;
+    /**
+     * Register multiple tool specs at once.
+     */
+    bulkRegister(specs: ToolSpec[]): void;
+    /**
+     * Unregister a tool by name.
+     */
+    unregister(name: string): boolean;
+    /**
+     * Get a tool spec by name.
+     */
+    get(name: string): ToolSpec | undefined;
+    /**
+     * Check if a tool exists.
+     */
+    has(name: string): boolean;
+    /**
+     * Search tools by query.
+     */
+    search(query: ToolSearchQuery): ToolSpec[];
+    /**
+     * List all registered tool names.
+     */
+    list(): string[];
+    /**
+     * Get count of registered tools.
+     */
+    get size(): number;
+    /**
+     * Export a snapshot of all registered tools (for debugging/routing).
+     */
+    snapshot(): ToolSpec[];
+    /**
+     * Clear all registered tools.
+     */
+    clear(): void;
+    private validateSpec;
+    private indexTool;
+    private deindexTool;
+}
+
+export { type Evidence as E, type ToolResult as T, type ToolError as a, ToolRegistry as b, type ToolSearchQuery as c };

package/dist/ToolRegistry-BBDRAr__.d.ts

@@ -0,0 +1,100 @@
+import { T as ToolSpec, a as ToolKind, C as Capability } from './ToolSpec-Be_To9dT.js';
+
+/**
+ * Evidence attached to a tool result for audit trail.
+ */
+interface Evidence {
+    type: "tool" | "file" | "url" | "text" | "metric";
+    ref: string;
+    summary: string;
+    createdAt: string;
+}
+/**
+ * Error information in a tool result.
+ */
+interface ToolError {
+    kind?: "TOOL_NOT_FOUND" | "INPUT_SCHEMA_INVALID" | "POLICY_DENIED" | "BUDGET_EXCEEDED" | "TIMEOUT" | "UPSTREAM_ERROR" | "OUTPUT_SCHEMA_INVALID" | "PATH_OUTSIDE_SANDBOX" | "FILE_TOO_LARGE" | "HTTP_DISALLOWED_HOST" | "HTTP_TIMEOUT" | "HTTP_TOO_LARGE";
+    message: string;
+    details?: unknown;
+}
+/**
+ * Unified tool result returned to agent-orchestra.
+ * Always structured, never throws raw exceptions.
+ */
+interface ToolResult {
+    ok: boolean;
+    result?: unknown;
+    evidence: Evidence[];
+    error?: ToolError;
+    /** Raw response for debugging (can be disabled in production) */
+    raw?: unknown;
+}
+
+/**
+ * Search query for tools.
+ */
+interface ToolSearchQuery {
+    /** Text search in name/description/tags */
+    text?: string;
+    /** Filter by tool kind */
+    kind?: ToolKind;
+    /** Filter by required capabilities */
+    capabilities?: Capability[];
+    /** Filter by tags */
+    tags?: string[];
+}
+/**
+ * Tool Registry: manages tool registration, lookup, and search.
+ * Supports both static registration and dynamic discovery via adapters.
+ */
+declare class ToolRegistry {
+    private readonly tools;
+    private readonly tagIndex;
+    private readonly kindIndex;
+    /**
+     * Register a single tool spec.
+     * Overwrites if same name already exists.
+     */
+    register(spec: ToolSpec): void;
+    /**
+     * Register multiple tool specs at once.
+     */
+    bulkRegister(specs: ToolSpec[]): void;
+    /**
+     * Unregister a tool by name.
+     */
+    unregister(name: string): boolean;
+    /**
+     * Get a tool spec by name.
+     */
+    get(name: string): ToolSpec | undefined;
+    /**
+     * Check if a tool exists.
+     */
+    has(name: string): boolean;
+    /**
+     * Search tools by query.
+     */
+    search(query: ToolSearchQuery): ToolSpec[];
+    /**
+     * List all registered tool names.
+     */
+    list(): string[];
+    /**
+     * Get count of registered tools.
+     */
+    get size(): number;
+    /**
+     * Export a snapshot of all registered tools (for debugging/routing).
+     */
+    snapshot(): ToolSpec[];
+    /**
+     * Clear all registered tools.
+     */
+    clear(): void;
+    private validateSpec;
+    private indexTool;
+    private deindexTool;
+}
+
+export { type Evidence as E, type ToolResult as T, type ToolError as a, ToolRegistry as b, type ToolSearchQuery as c };

package/dist/{ToolRegistry-CN_IXOCr.d.cts → ToolSpec-Be_To9dT.d.cts}

@@ -96,101 +96,4 @@ interface ToolAdapter {
     }>;
 }
 
-/**
- * Evidence attached to a tool result for audit trail.
- */
-interface Evidence {
-    type: "tool" | "file" | "url" | "text" | "metric";
-    ref: string;
-    summary: string;
-    createdAt: string;
-}
-/**
- * Error information in a tool result.
- */
-interface ToolError {
-    kind?: "TOOL_NOT_FOUND" | "INPUT_SCHEMA_INVALID" | "POLICY_DENIED" | "BUDGET_EXCEEDED" | "TIMEOUT" | "UPSTREAM_ERROR" | "OUTPUT_SCHEMA_INVALID" | "PATH_OUTSIDE_SANDBOX" | "FILE_TOO_LARGE" | "HTTP_DISALLOWED_HOST" | "HTTP_TIMEOUT" | "HTTP_TOO_LARGE";
-    message: string;
-    details?: unknown;
-}
-/**
- * Unified tool result returned to agent-orchestra.
- * Always structured, never throws raw exceptions.
- */
-interface ToolResult {
-    ok: boolean;
-    result?: unknown;
-    evidence: Evidence[];
-    error?: ToolError;
-    /** Raw response for debugging (can be disabled in production) */
-    raw?: unknown;
-}
-
-/**
- * Search query for tools.
- */
-interface ToolSearchQuery {
-    /** Text search in name/description/tags */
-    text?: string;
-    /** Filter by tool kind */
-    kind?: ToolKind;
-    /** Filter by required capabilities */
-    capabilities?: Capability[];
-    /** Filter by tags */
-    tags?: string[];
-}
-/**
- * Tool Registry: manages tool registration, lookup, and search.
- * Supports both static registration and dynamic discovery via adapters.
- */
-declare class ToolRegistry {
-    private readonly tools;
-    private readonly tagIndex;
-    private readonly kindIndex;
-    /**
-     * Register a single tool spec.
-     * Overwrites if same name already exists.
-     */
-    register(spec: ToolSpec): void;
-    /**
-     * Register multiple tool specs at once.
-     */
-    bulkRegister(specs: ToolSpec[]): void;
-    /**
-     * Unregister a tool by name.
-     */
-    unregister(name: string): boolean;
-    /**
-     * Get a tool spec by name.
-     */
-    get(name: string): ToolSpec | undefined;
-    /**
-     * Check if a tool exists.
-     */
-    has(name: string): boolean;
-    /**
-     * Search tools by query.
-     */
-    search(query: ToolSearchQuery): ToolSpec[];
-    /**
-     * List all registered tool names.
-     */
-    list(): string[];
-    /**
-     * Get count of registered tools.
-     */
-    get size(): number;
-    /**
-     * Export a snapshot of all registered tools (for debugging/routing).
-     */
-    snapshot(): ToolSpec[];
-    /**
-     * Clear all registered tools.
-     */
-    clear(): void;
-    private validateSpec;
-    private indexTool;
-    private deindexTool;
-}
-
-export { type BudgetConfig as B, type Capability as C, type Evidence as E, type ToolSpec as T, type ToolResult as a, type ToolError as b, type ExecContext as c, ToolRegistry as d, type ToolAdapter as e, type ToolIntent as f, type ToolKind as g, type CostHints as h, type ToolSearchQuery as i };
+export type { BudgetConfig as B, Capability as C, ExecContext as E, ToolSpec as T, ToolKind as a, ToolAdapter as b, ToolIntent as c, CostHints as d };

package/dist/{ToolRegistry-CN_IXOCr.d.ts → ToolSpec-Be_To9dT.d.ts}

@@ -96,101 +96,4 @@ interface ToolAdapter {
     }>;
 }
 
-/**
- * Evidence attached to a tool result for audit trail.
- */
-interface Evidence {
-    type: "tool" | "file" | "url" | "text" | "metric";
-    ref: string;
-    summary: string;
-    createdAt: string;
-}
-/**
- * Error information in a tool result.
- */
-interface ToolError {
-    kind?: "TOOL_NOT_FOUND" | "INPUT_SCHEMA_INVALID" | "POLICY_DENIED" | "BUDGET_EXCEEDED" | "TIMEOUT" | "UPSTREAM_ERROR" | "OUTPUT_SCHEMA_INVALID" | "PATH_OUTSIDE_SANDBOX" | "FILE_TOO_LARGE" | "HTTP_DISALLOWED_HOST" | "HTTP_TIMEOUT" | "HTTP_TOO_LARGE";
-    message: string;
-    details?: unknown;
-}
-/**
- * Unified tool result returned to agent-orchestra.
- * Always structured, never throws raw exceptions.
- */
-interface ToolResult {
-    ok: boolean;
-    result?: unknown;
-    evidence: Evidence[];
-    error?: ToolError;
-    /** Raw response for debugging (can be disabled in production) */
-    raw?: unknown;
-}
-
-/**
- * Search query for tools.
- */
-interface ToolSearchQuery {
-    /** Text search in name/description/tags */
-    text?: string;
-    /** Filter by tool kind */
-    kind?: ToolKind;
-    /** Filter by required capabilities */
-    capabilities?: Capability[];
-    /** Filter by tags */
-    tags?: string[];
-}
-/**
- * Tool Registry: manages tool registration, lookup, and search.
- * Supports both static registration and dynamic discovery via adapters.
- */
-declare class ToolRegistry {
-    private readonly tools;
-    private readonly tagIndex;
-    private readonly kindIndex;
-    /**
-     * Register a single tool spec.
-     * Overwrites if same name already exists.
-     */
-    register(spec: ToolSpec): void;
-    /**
-     * Register multiple tool specs at once.
-     */
-    bulkRegister(specs: ToolSpec[]): void;
-    /**
-     * Unregister a tool by name.
-     */
-    unregister(name: string): boolean;
-    /**
-     * Get a tool spec by name.
-     */
-    get(name: string): ToolSpec | undefined;
-    /**
-     * Check if a tool exists.
-     */
-    has(name: string): boolean;
-    /**
-     * Search tools by query.
-     */
-    search(query: ToolSearchQuery): ToolSpec[];
-    /**
-     * List all registered tool names.
-     */
-    list(): string[];
-    /**
-     * Get count of registered tools.
-     */
-    get size(): number;
-    /**
-     * Export a snapshot of all registered tools (for debugging/routing).
-     */
-    snapshot(): ToolSpec[];
-    /**
-     * Clear all registered tools.
-     */
-    clear(): void;
-    private validateSpec;
-    private indexTool;
-    private deindexTool;
-}
-
-export { type BudgetConfig as B, type Capability as C, type Evidence as E, type ToolSpec as T, type ToolResult as a, type ToolError as b, type ExecContext as c, ToolRegistry as d, type ToolAdapter as e, type ToolIntent as f, type ToolKind as g, type CostHints as h, type ToolSearchQuery as i };
+export type { BudgetConfig as B, Capability as C, ExecContext as E, ToolSpec as T, ToolKind as a, ToolAdapter as b, ToolIntent as c, CostHints as d };

package/dist/{chunk-Q6EXJZUA.js → chunk-4UWNCO4Q.js}

@@ -1,4 +1,4 @@
-import { DEFAULT_CONFIG_FILE, loadToolHubConfig, createToolHub } from './chunk-4GETODZZ.js';
+import { DEFAULT_CONFIG_FILE, loadToolHubConfig, createToolHub } from './chunk-VF2LGUDP.js';
 import path from 'path';
 
 var AgentToolHub = class {
@@ -91,5 +91,5 @@ async function createAgentToolHub(configPath) {
 }
 
 export { AgentToolHub, createAgentToolHub, createToolHubAndInit, createToolHubAndInitFromConfig };
-//# sourceMappingURL=chunk-Q6EXJZUA.js.map
-//# sourceMappingURL=chunk-Q6EXJZUA.js.map
+//# sourceMappingURL=chunk-4UWNCO4Q.js.map
+//# sourceMappingURL=chunk-4UWNCO4Q.js.map

package/dist/{chunk-Q6EXJZUA.js.map → chunk-4UWNCO4Q.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/toolhub-runtime.ts"],"names":[],"mappings":"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","file":"chunk-Q6EXJZUA.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 { createMCPClientFromConfig } from \"./adapters/createMCPClientFromConfig.js\";\nexport type { CreateMCPClientResult } from \"./adapters/createMCPClientFromConfig.js\";\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 syncMCPToolsFromAdapter(): Promise<ToolSpec[]> {\n    return this.requireHub().syncMCPToolsFromAdapter();\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"]}
+{"version":3,"sources":["../src/toolhub-runtime.ts"],"names":[],"mappings":"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","file":"chunk-4UWNCO4Q.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 { createMCPClientFromConfig } from \"./adapters/createMCPClientFromConfig.js\";\nexport type { CreateMCPClientResult } from \"./adapters/createMCPClientFromConfig.js\";\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 syncMCPToolsFromAdapter(): Promise<ToolSpec[]> {\n    return this.requireHub().syncMCPToolsFromAdapter();\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"]}