@easynet/agent-tool-hub 1.0.8 → 1.0.9

package/dist/{toolhub-runtime-Du3j3gS3.d.ts → toolhub-runtime-EP-3hIOW.d.ts}

@@ -1,135 +1,8 @@
+import { E as Evidence, T as ToolError, a as ToolSpec, b as ExecContext, C as Capability, c as ToolRegistry, d as ToolAdapter, e as ToolIntent, f as ToolResult, B as BudgetConfig } from './ToolRegistry-wObXj92k.js';
 import { N8nLocal } from '@easynet/n8n-local';
 import { ErrorObject } from 'ajv';
 import { BulkheadPolicy, CircuitBreakerPolicy } from 'cockatiel';
 
-/**
- * Budget constraints for a tool invocation.
- */
-interface BudgetConfig {
-    timeoutMs?: number;
-    maxRetries?: number;
-    maxToolCalls?: number;
-}
-/**
- * Execution context passed from agent-orchestra.
- * Contains permissions, budget, and observability context.
- */
-interface ExecContext {
-    requestId: string;
-    taskId: string;
-    /** Allowed capabilities for this invocation */
-    permissions: Capability[];
-    budget?: BudgetConfig;
-    /** OpenTelemetry-compatible trace ID */
-    traceId?: string;
-    userId?: string;
-    /** Optional: enable dry-run mode for two-phase commit */
-    dryRun?: boolean;
-}
-/**
- * Tool invocation intent from agent-orchestra.
- * Represents what the agent wants to do (untrusted input).
- */
-interface ToolIntent {
-    /** ToolSpec.name reference */
-    tool: string;
-    /** Untrusted input arguments */
-    args: unknown;
-    /** Human-readable purpose for audit trail */
-    purpose: string;
-    /** Idempotency key: recommended format requestId:taskId:tool */
-    idempotencyKey?: string;
-}
-
-/**
- * Unified tool kinds supported by the tools package.
- */
-type ToolKind = "mcp" | "langchain" | "n8n" | "comfyui" | "skill" | "core";
-/**
- * Capability declarations for tools.
- * Used by PolicyEngine for permission gating.
- */
-type Capability = "read:web" | "read:fs" | "write:fs" | "read:db" | "write:db" | "network" | "gpu" | "workflow" | "danger:destructive";
-/**
- * Cost hints for tools, used by Budget and routing.
- */
-interface CostHints {
-    latencyMsP50?: number;
-    latencyMsP95?: number;
-    isAsync?: boolean;
-}
-/**
- * Unified tool specification.
- * All tool types (MCP, LangChain, n8n, ComfyUI, SKILL) are described by this interface.
- */
-interface ToolSpec {
-    /** Globally unique name, recommended format: namespace/name */
-    name: string;
-    /** Semver version */
-    version: string;
-    /** Tool kind determines which adapter handles execution */
-    kind: ToolKind;
-    description?: string;
-    tags?: string[];
-    /** JSON Schema for input validation */
-    inputSchema: object;
-    /** JSON Schema for output validation */
-    outputSchema: object;
-    /** Required capabilities for this tool */
-    capabilities: Capability[];
-    costHints?: CostHints;
-    /** Adapter-specific: endpoint URL (MCP/n8n/ComfyUI) */
-    endpoint?: string;
-    /** Adapter-specific: resource identifier (workflowId, promptId, etc.) */
-    resourceId?: string;
-    /** Adapter-specific: implementation reference (LangChain Tool instance, skill handler) */
-    impl?: unknown;
-}
-/**
- * Unified adapter interface.
- * Each protocol adapter (MCP, LangChain, n8n, ComfyUI, SKILL) implements this.
- */
-interface ToolAdapter {
-    kind: ToolKind;
-    /** Optional: supports dynamic tool discovery */
-    listTools?(): Promise<ToolSpec[]>;
-    /** Execute the tool with validated args */
-    invoke(spec: ToolSpec, args: unknown, ctx: ExecContext): Promise<{
-        result: unknown;
-        raw?: unknown;
-    }>;
-}
-
-/**
- * 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;
-}
-
 /**
  * Event types emitted by PTCRuntime and observability layer.
  */
@@ -205,73 +78,6 @@ interface JobFailedEvent extends ToolEvent {
  */
 type AnyToolEvent = ToolCalledEvent | ToolResultEvent | PolicyDeniedEvent | RetryEvent | JobSubmittedEvent | JobCompletedEvent | JobFailedEvent;
 
-/**
- * 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;
-}
-
 /**
  * Schema validation result.
  */
@@ -1612,4 +1418,4 @@ declare function createToolHubAndInitFromConfig(configPath: string): Promise<Too
  */
 declare function createAgentToolHub(configPath: string): Promise<AgentToolHub>;
 
-export { type N8nInvokeMode as $, AgentToolHub as A, type BudgetConfig as B, type Capability as C, DEFAULT_CORE_TOOLS_CONFIG as D, type ExecContext as E, type HttpClient as F, type JobFailedEvent as G, type HistogramValue as H, type InvokeOptions as I, type JobCompletedEvent as J, type JobSubmittedEvent as K, LangChainAdapter as L, type LangChainAdapterOptions as M, type LangChainToolLike as N, type LogEntry as O, type LogLevel as P, type Logger as Q, MCPAdapter as R, type SkillDefinition as S, type ToolSpec as T, type MCPAdapterOptions as U, type MCPCallResult as V, type MCPClientLike as W, type MCPToolDefinition as X, Metrics as Y, N8nAdapter as Z, type N8nAdapterOptions as _, type Evidence as a, N8nLocalAdapter as a0, type N8nLocalAdapterOptions as a1, PTCRuntime as a2, type PTCRuntimeConfig as a3, type PolicyCheckResult as a4, type PolicyConfig as a5, PolicyDeniedError as a6, type PolicyDeniedEvent as a7, PolicyEngine as a8, type ResolvedDebugOptions as a9, createAgentToolHub as aA, createLogger as aB, createToolHub as aC, createToolHubAndInitFromConfig as aD, registerCoreTools as aE, sanitizeForLog as aF, summarizeForLog as aG, validateFrontmatter as aH, createToolHubAndInit as aI, type RetryEvent as aa, SchemaValidationError as ab, SchemaValidator as ac, SkillAdapter as ad, type SkillAdapterOptions as ae, type SkillContext as af, type SkillHandler as ag, type SkillInstructionResult as ah, type SkillInvocationContext as ai, SkillManifestError as aj, type SkillOutput as ak, type Span as al, type SpanEvent as am, type ToolCalledEvent as an, type ToolDescription as ao, type ToolError as ap, type ToolEvent as aq, type ToolEventType as ar, ToolHub as as, type ToolIntent as at, type ToolMetadata as au, type ToolResult as av, type ToolResultEvent as aw, type ToolSearchQuery as ax, Tracing as ay, type ValidationResult as az, ToolRegistry as b, type ToolAdapter as c, type SkillFrontmatter as d, type SkillResource as e, type ToolKind as f, type CostHints as g, type ToolHubInitOptions as h, type AnyToolEvent as i, BudgetManager as j, type BudgetOptions as k, ComfyUIAdapter as l, type ComfyUIAdapterOptions as m, type ComfyUIHistoryEntry as n, type ComfyUIHttpClient as o, type ComfyUIQueueResponse as p, CoreAdapter as q, type CoreToolContext as r, type CoreToolHandler as s, type CoreToolResult as t, type CoreToolsConfig as u, type CoreToolsUserConfig as v, type CounterValue as w, type DebugOptions as x, type EventListener as y, EventLog as z };
+export { PolicyEngine as $, AgentToolHub as A, BudgetManager as B, ComfyUIAdapter as C, DEFAULT_CORE_TOOLS_CONFIG as D, type EventListener as E, type MCPCallResult as F, type MCPClientLike as G, type HistogramValue as H, type InvokeOptions as I, type JobCompletedEvent as J, type MCPToolDefinition as K, LangChainAdapter as L, MCPAdapter as M, Metrics as N, N8nAdapter as O, type N8nAdapterOptions as P, type N8nInvokeMode as Q, N8nLocalAdapter as R, type SkillDefinition as S, type ToolHubInitOptions as T, type N8nLocalAdapterOptions as U, PTCRuntime as V, type PTCRuntimeConfig as W, type PolicyCheckResult as X, type PolicyConfig as Y, PolicyDeniedError as Z, type PolicyDeniedEvent as _, type SkillFrontmatter as a, type ResolvedDebugOptions as a0, type RetryEvent as a1, SchemaValidationError as a2, SchemaValidator as a3, SkillAdapter as a4, type SkillAdapterOptions as a5, type SkillContext as a6, type SkillHandler as a7, type SkillInstructionResult as a8, type SkillInvocationContext as a9, SkillManifestError as aa, type SkillOutput as ab, type Span as ac, type SpanEvent as ad, type ToolCalledEvent as ae, type ToolDescription as af, type ToolEvent as ag, type ToolEventType as ah, ToolHub as ai, type ToolMetadata as aj, type ToolResultEvent as ak, Tracing as al, type ValidationResult as am, createAgentToolHub as an, createLogger as ao, createToolHub as ap, createToolHubAndInitFromConfig as aq, registerCoreTools as ar, sanitizeForLog as as, summarizeForLog as at, validateFrontmatter as au, createToolHubAndInit as av, type SkillResource as b, type AnyToolEvent as c, type BudgetOptions as d, type ComfyUIAdapterOptions as e, type ComfyUIHistoryEntry as f, type ComfyUIHttpClient as g, type ComfyUIQueueResponse as h, CoreAdapter as i, type CoreToolContext as j, type CoreToolHandler as k, type CoreToolResult as l, type CoreToolsConfig as m, type CoreToolsUserConfig as n, type CounterValue as o, type DebugOptions as p, EventLog as q, type HttpClient as r, type JobFailedEvent as s, type JobSubmittedEvent as t, type LangChainAdapterOptions as u, type LangChainToolLike as v, type LogEntry as w, type LogLevel as x, type Logger as y, type MCPAdapterOptions as z };

package/dist/toolhub-runtime.d.cts

@@ -1,4 +1,5 @@
-export { A as AgentToolHub, I as InvokeOptions, as as ToolHub, h as ToolHubInitOptions, aA as createAgentToolHub, aC as createToolHub, aI as createToolHubAndInit, aD as createToolHubAndInitFromConfig } from './toolhub-runtime-Du3j3gS3.cjs';
+export { A as AgentToolHub, I as InvokeOptions, ai as ToolHub, T as ToolHubInitOptions, an as createAgentToolHub, ap as createToolHub, av as createToolHubAndInit, aq as createToolHubAndInitFromConfig } from './toolhub-runtime-DqZOyihh.cjs';
+import './ToolRegistry-wObXj92k.cjs';
 import '@easynet/n8n-local';
 import 'ajv';
 import 'cockatiel';

package/dist/toolhub-runtime.d.ts

@@ -1,4 +1,5 @@
-export { A as AgentToolHub, I as InvokeOptions, as as ToolHub, h as ToolHubInitOptions, aA as createAgentToolHub, aC as createToolHub, aI as createToolHubAndInit, aD as createToolHubAndInitFromConfig } from './toolhub-runtime-Du3j3gS3.js';
+export { A as AgentToolHub, I as InvokeOptions, ai as ToolHub, T as ToolHubInitOptions, an as createAgentToolHub, ap as createToolHub, av as createToolHubAndInit, aq as createToolHubAndInitFromConfig } from './toolhub-runtime-EP-3hIOW.js';
+import './ToolRegistry-wObXj92k.js';
 import '@easynet/n8n-local';
 import 'ajv';
 import 'cockatiel';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@easynet/agent-tool-hub",
-  "version": "1.0.8",
+  "version": "1.0.9",
   "description": "Agent Tool Hub: multi-protocol tool registry, PTC runtime, and adapter layer for MCP/LangChain/n8n/ComfyUI/SKILL",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -25,6 +25,7 @@
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",
+    "example:agent-toolhub": "node examples/agent-toolhub-example.mjs",
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit",