@easynet/agent-tool 1.0.0

package/dist/llm/LangChainToolsHub.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Exposes all tools from a ToolRegistry + PTCRuntime as LangChain tools
+ * for local agent use (e.g. with createReactAgent, AgentExecutor).
+ *
+ * Use: new LangChainToolsHub(runtime, ctxFactory).getLangChainTools()
+ */
+import { DynamicTool } from "@langchain/core/tools";
+import type { PTCRuntime } from "../runtime/PTCRuntime.js";
+import type { ExecContext } from "../types/ToolIntent.js";
+export type ExecContextFactory = () => ExecContext;
+/**
+ * Hub that wraps PTCRuntime and exposes every registered tool as a LangChain
+ * DynamicTool, so local agents (LangChain AgentExecutor, createReactAgent, etc.)
+ * can use the same tools as MCP and the ReAct agent.
+ */
+export declare class LangChainToolsHub {
+    private readonly runtime;
+    private readonly ctxFactory;
+    constructor(runtime: PTCRuntime, ctxFactory?: ExecContextFactory);
+    /**
+     * Returns all registered tools as LangChain tools (DynamicTool[]).
+     * Each tool invokes the runtime through the full pipeline (policy, HITL, etc.).
+     */
+    getLangChainTools(): DynamicTool[];
+    /**
+     * Returns LangChain tools for a subset of tools (by name or query).
+     */
+    getLangChainToolsForNames(toolNames: string[]): DynamicTool[];
+    private specToLangChainTool;
+}
+//# sourceMappingURL=LangChainToolsHub.d.ts.map

package/dist/llm/LangChainToolsHub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LangChainToolsHub.d.ts","sourceRoot":"","sources":["../../src/llm/LangChainToolsHub.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAG1D,MAAM,MAAM,kBAAkB,GAAG,MAAM,WAAW,CAAC;AAiBnD;;;;GAIG;AACH,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBADV,OAAO,EAAE,UAAU,EACnB,UAAU,GAAE,kBAAwC;IAGvE;;;OAGG;IACH,iBAAiB,IAAI,WAAW,EAAE;IAOlC;;OAEG;IACH,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE;IAO7D,OAAO,CAAC,mBAAmB;CAgC5B"}

package/dist/llm/OpenAICompatibleClient.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Minimal client for OpenAI-compatible chat completions API.
+ * Use createOpenAICompatibleClient(baseUrl, model, apiKey?) and then .chat(messages) or .chatWithTools(messages, tools).
+ */
+export interface ChatMessage {
+    role: "system" | "user" | "assistant";
+    content: string;
+}
+export interface ChatOptions {
+    /** Request timeout in milliseconds. Default 60000. */
+    timeoutMs?: number;
+}
+export interface ChatResult {
+    content: string;
+    raw: unknown;
+}
+export interface OpenAIToolDefinition {
+    type: "function";
+    function: {
+        name: string;
+        description?: string;
+        parameters?: object;
+    };
+}
+export interface AssistantMessageWithToolCalls {
+    role: "assistant";
+    content?: string | null;
+    tool_calls?: Array<{
+        id: string;
+        type: "function";
+        function: {
+            name: string;
+            arguments: string;
+        };
+    }>;
+}
+export interface ChatWithToolsResult {
+    message: AssistantMessageWithToolCalls;
+    raw: unknown;
+}
+export interface OpenAICompatibleClientConfig {
+    baseUrl: string;
+    model: string;
+    apiKey?: string;
+}
+export declare function createOpenAICompatibleClient(baseUrl: string, model: string, apiKey?: string): OpenAICompatibleClient;
+export declare class OpenAICompatibleClient {
+    private readonly baseUrl;
+    private readonly model;
+    private readonly apiKey?;
+    constructor(config: OpenAICompatibleClientConfig);
+    chat(messages: ChatMessage[], options?: ChatOptions): Promise<ChatResult>;
+    chatWithTools(messages: Array<ChatMessage | {
+        role: "tool";
+        content: string;
+        tool_call_id: string;
+    } | (Omit<AssistantMessageWithToolCalls, "role"> & {
+        role: "assistant";
+    })>, tools: OpenAIToolDefinition[], options?: ChatOptions): Promise<ChatWithToolsResult>;
+    private buildHeaders;
+    private serializeMessage;
+    private request;
+}
+//# sourceMappingURL=OpenAICompatibleClient.d.ts.map

package/dist/llm/OpenAICompatibleClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenAICompatibleClient.d.ts","sourceRoot":"","sources":["../../src/llm/OpenAICompatibleClient.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,UAAU,CAAC;QACjB,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;KAC/C,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,6BAA6B,CAAC;IACvC,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,GACd,sBAAsB,CAExB;AAED,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;gBAErB,MAAM,EAAE,4BAA4B;IAM1C,IAAI,CACR,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,UAAU,CAAC;IAiBhB,aAAa,CACjB,QAAQ,EAAE,KAAK,CACX,WAAW,GACX;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,GACvD,CAAC,IAAI,CAAC,6BAA6B,EAAE,MAAM,CAAC,GAAG;QAAE,IAAI,EAAE,WAAW,CAAA;KAAE,CAAC,CACxE,EACD,KAAK,EAAE,oBAAoB,EAAE,EAC7B,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,mBAAmB,CAAC;IA6B/B,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,gBAAgB;YAaV,OAAO;CA+BtB"}

package/dist/llm/ReActAgent.d.ts

@@ -0,0 +1,35 @@
+/**
+ * ReAct agent: LLM + tool hub, Thought–Action–Observation loop.
+ * Use: new ReActAgent(llm, toolHub).run(instruction).
+ */
+import type { ToolRegistry } from "../registry/ToolRegistry.js";
+import type { ToolResult } from "../types/ToolResult.js";
+import type { OpenAICompatibleClient } from "./OpenAICompatibleClient.js";
+export interface ReActAgentToolHub {
+    getRegistry(): ToolRegistry;
+    invokeTool(toolName: string, args: unknown): Promise<ToolResult>;
+}
+export interface ReActAgentRunOptions {
+    systemPrompt?: string;
+    maxSteps?: number;
+    timeoutMs?: number;
+    /** When set, only these tool names are exposed to the LLM (e.g. from agent.yaml tools list). */
+    toolNames?: string[];
+}
+export interface ReActAgentRunResult {
+    content: string;
+    steps: number;
+}
+export declare class ReActAgent {
+    private readonly llm;
+    private readonly toolHub;
+    constructor(llm: OpenAICompatibleClient, toolHub: ReActAgentToolHub);
+    run(instruction: string, options?: ReActAgentRunOptions): Promise<ReActAgentRunResult>;
+    private getTools;
+    /**
+     * Parse tool-call arguments. Handles models that send text + JSON
+     * (e.g. "Let's fetch.{\"symbol\":\"GOOGL\"}") by extracting the last {...} and parsing.
+     */
+    private parseArgs;
+}
+//# sourceMappingURL=ReActAgent.d.ts.map

package/dist/llm/ReActAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReActAgent.d.ts","sourceRoot":"","sources":["../../src/llm/ReActAgent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEhE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EACV,sBAAsB,EAIvB,MAAM,6BAA6B,CAAC;AAErC,MAAM,WAAW,iBAAiB;IAChC,WAAW,IAAI,YAAY,CAAC;IAC5B,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAClE;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gGAAgG;IAChG,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAUD,qBAAa,UAAU;IAEnB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,GAAG,EAAE,sBAAsB,EAC3B,OAAO,EAAE,iBAAiB;IAGvC,GAAG,CACP,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC;IAkC/B,OAAO,CAAC,QAAQ;IAYhB;;;OAGG;IACH,OAAO,CAAC,SAAS;CAqBlB"}

package/dist/llm-export.cjs

@@ -0,0 +1,20 @@
+'use strict';
+
+var chunkP3UEAZHK_cjs = require('./chunk-P3UEAZHK.cjs');
+
+
+
+Object.defineProperty(exports, "OpenAICompatibleClient", {
+  enumerable: true,
+  get: function () { return chunkP3UEAZHK_cjs.OpenAICompatibleClient; }
+});
+Object.defineProperty(exports, "ReActAgent", {
+  enumerable: true,
+  get: function () { return chunkP3UEAZHK_cjs.ReActAgent; }
+});
+Object.defineProperty(exports, "createOpenAICompatibleClient", {
+  enumerable: true,
+  get: function () { return chunkP3UEAZHK_cjs.createOpenAICompatibleClient; }
+});
+//# sourceMappingURL=llm-export.cjs.map
+//# sourceMappingURL=llm-export.cjs.map

package/dist/llm-export.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"llm-export.cjs"}

package/dist/llm-export.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Slim entry: LLM client + ReActAgent only (no ToolHub/n8n/MCP).
+ * Use for examples or apps that only need OpenAICompatibleClient and ReActAgent.
+ */
+export { createOpenAICompatibleClient, OpenAICompatibleClient, } from "./llm/OpenAICompatibleClient.js";
+export type { ChatMessage, ChatOptions, ChatResult, OpenAICompatibleClientConfig, OpenAIToolDefinition, AssistantMessageWithToolCalls, ChatWithToolsResult, } from "./llm/OpenAICompatibleClient.js";
+export { ReActAgent } from "./llm/ReActAgent.js";
+export type { ReActAgentToolHub, ReActAgentRunOptions, ReActAgentRunResult, } from "./llm/ReActAgent.js";
+//# sourceMappingURL=llm-export.d.ts.map

package/dist/llm-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-export.d.ts","sourceRoot":"","sources":["../src/llm-export.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EACV,WAAW,EACX,WAAW,EACX,UAAU,EACV,4BAA4B,EAC5B,oBAAoB,EACpB,6BAA6B,EAC7B,mBAAmB,GACpB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC"}

package/dist/llm-export.js

@@ -0,0 +1,3 @@
+export { OpenAICompatibleClient, ReActAgent, createOpenAICompatibleClient } from './chunk-RPAMQCFH.js';
+//# sourceMappingURL=llm-export.js.map
+//# sourceMappingURL=llm-export.js.map

package/dist/llm-export.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"llm-export.js"}

package/dist/mcp/MCPClientAdapter.d.ts

@@ -0,0 +1,34 @@
+/**
+ * ToolAdapter for MCP tools: holds SDK Client reference, invoke() calls client.callTool.
+ * Framework-level support so scripts use registerMCPToolsFromConfig instead of inline MCP logic.
+ */
+import type { ToolAdapter, ToolSpec } from "../types/ToolSpec.js";
+import type { ExecContext } from "../types/ToolIntent.js";
+/** SDK Client type (avoid hard typing on @modelcontextprotocol/sdk in this file for optional dep). */
+export interface MCPClientLike {
+    callTool(params: {
+        name: string;
+        arguments: Record<string, unknown>;
+    }): Promise<CallToolResult>;
+}
+export interface CallToolResult {
+    content?: Array<{
+        type: string;
+        text?: string;
+    }>;
+    toolResult?: unknown;
+}
+/**
+ * Adapter that invokes MCP tools via the SDK Client (callTool).
+ * Register with runtime after connecting and listing tools; specs must have kind "mcp".
+ */
+export declare class MCPClientAdapter implements ToolAdapter {
+    private readonly client;
+    readonly kind: "mcp";
+    constructor(client: MCPClientLike);
+    invoke(spec: ToolSpec, args: unknown, _ctx: ExecContext): Promise<{
+        result: unknown;
+        raw?: unknown;
+    }>;
+}
+//# sourceMappingURL=MCPClientAdapter.d.ts.map

package/dist/mcp/MCPClientAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MCPClientAdapter.d.ts","sourceRoot":"","sources":["../../src/mcp/MCPClientAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,sGAAsG;AACtG,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACjG;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAaD;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,WAAW;IAGtC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,QAAQ,CAAC,IAAI,EAAG,KAAK,CAAU;gBAEF,MAAM,EAAE,aAAa;IAE5C,MAAM,CACV,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAc/C"}

package/dist/mcp/connectMCP.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Connect to an MCP server via stdio using MCPConnectionInfo.
+ * Framework-level: uses @modelcontextprotocol/sdk Client + StdioClientTransport.
+ */
+import type { MCPConnectionInfo } from "../discovery/MCPProcessManager.js";
+import type { ToolSpec } from "../types/ToolSpec.js";
+export interface MCPConnectResult {
+    /** SDK Client; use listTools() and callTool(). */
+    client: MCPClientLike;
+    /** Transport; call close() when done. */
+    transport: MCPTransportLike;
+}
+export interface MCPClientLike {
+    connect(transport: MCPTransportLike): Promise<void>;
+    listTools(params?: unknown): Promise<{
+        tools: MCPToolDef[];
+    }>;
+    callTool(params: {
+        name: string;
+        arguments: Record<string, unknown>;
+    }): Promise<CallToolResult>;
+}
+export interface MCPTransportLike {
+    close(): Promise<void>;
+}
+export interface MCPToolDef {
+    name: string;
+    description?: string;
+    inputSchema?: object;
+}
+export interface CallToolResult {
+    content?: Array<{
+        type: string;
+        text?: string;
+    }>;
+    toolResult?: unknown;
+}
+/**
+ * Connect to MCP server via stdio. Only stdio is supported; url/SSE not implemented here.
+ * Requires @modelcontextprotocol/sdk. Returns client and transport; caller must call transport.close() when done.
+ */
+export declare function connectMCP(connectionInfo: MCPConnectionInfo): Promise<MCPConnectResult>;
+/**
+ * Convert MCP listTools() result to ToolSpec[] (kind "mcp") for registry.
+ */
+export declare function mcpToolsToSpecs(tools: MCPToolDef[]): ToolSpec[];
+//# sourceMappingURL=connectMCP.d.ts.map

package/dist/mcp/connectMCP.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectMCP.d.ts","sourceRoot":"","sources":["../../src/mcp/connectMCP.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGrD,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,MAAM,EAAE,aAAa,CAAC;IACtB,yCAAyC;IACzC,SAAS,EAAE,gBAAgB,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,SAAS,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC,CAAC;IAC9D,QAAQ,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACjG;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,cAAc,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAyB7F;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,QAAQ,EAAE,CAU/D"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Framework-level MCP support: connect to MCP server (stdio), list tools, register with runtime.
+ */
+export { MCPClientAdapter } from "./MCPClientAdapter.js";
+export type { MCPClientLike } from "./MCPClientAdapter.js";
+export { connectMCP, mcpToolsToSpecs } from "./connectMCP.js";
+export type { MCPConnectResult, MCPToolDef, CallToolResult as MCPCallToolResult, } from "./connectMCP.js";
+export { registerMCPToolsFromConfig } from "./registerMCPTools.js";
+export type { RegisterMCPToolsOptions, RegisterMCPToolsResult } from "./registerMCPTools.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC9D,YAAY,EACV,gBAAgB,EAChB,UAAU,EACV,cAAc,IAAI,iBAAiB,GACpC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACnE,YAAY,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/mcp/registerMCPTools.d.ts

@@ -0,0 +1,24 @@
+/**
+ * High-level API: load mcp.json, connect to MCP server, register tools with runtime.
+ * Framework-level so scripts call registerMCPToolsFromConfig() instead of inline MCP logic.
+ */
+import type { PTCRuntime } from "../runtime/PTCRuntime.js";
+import type { ToolRegistry } from "../registry/ToolRegistry.js";
+export interface RegisterMCPToolsOptions {
+    /** Path to mcp.json (or dir containing it). Default: process.env.MCP_CONFIG_PATH or "mcp.json" in cwd. */
+    configPath?: string;
+    /** Tool name for getConnectionInfo (default "mcp"). */
+    toolName?: string;
+}
+export interface RegisterMCPToolsResult {
+    /** Transport; caller must call transport.close() when done. */
+    transport: {
+        close(): Promise<void>;
+    };
+}
+/**
+ * Load mcp config (from configPath or MCP_CONFIG_PATH), connect via stdio, list tools,
+ * register ToolSpec[] with registry and MCPClientAdapter with runtime. Returns transport for cleanup.
+ */
+export declare function registerMCPToolsFromConfig(runtime: PTCRuntime, registry: ToolRegistry, options?: RegisterMCPToolsOptions): Promise<RegisterMCPToolsResult>;
+//# sourceMappingURL=registerMCPTools.d.ts.map

package/dist/mcp/registerMCPTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerMCPTools.d.ts","sourceRoot":"","sources":["../../src/mcp/registerMCPTools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAMhE,MAAM,WAAW,uBAAuB;IACtC,0GAA0G;IAC1G,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,+DAA+D;IAC/D,SAAS,EAAE;QAAE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;CACvC;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,YAAY,EACtB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CAoBjC"}

package/dist/observability/EventLog.d.ts

@@ -0,0 +1,60 @@
+import type { AnyToolEvent, ToolEventType } from "../types/Events.js";
+/**
+ * Event log entry with sequence number.
+ */
+export interface LogEntry {
+    seq: number;
+    event: AnyToolEvent;
+}
+/**
+ * Event log listener type.
+ */
+export type EventListener = (entry: LogEntry) => void;
+/**
+ * Append-only event log for tool invocations.
+ * Supports in-memory storage with configurable max size and event subscriptions.
+ */
+export declare class EventLog {
+    private readonly entries;
+    private seq;
+    private readonly maxEntries;
+    private readonly emitter;
+    constructor(options?: {
+        maxEntries?: number;
+    });
+    /**
+     * Append an event to the log.
+     */
+    append(event: AnyToolEvent): LogEntry;
+    /**
+     * Subscribe to all events.
+     */
+    on(listener: EventListener): () => void;
+    /**
+     * Subscribe to events of a specific type.
+     */
+    onType(type: ToolEventType, listener: EventListener): () => void;
+    /**
+     * Query events by filter.
+     */
+    query(filter: {
+        type?: ToolEventType;
+        toolName?: string;
+        requestId?: string;
+        since?: number;
+        limit?: number;
+    }): LogEntry[];
+    /**
+     * Get all entries.
+     */
+    getAll(): readonly LogEntry[];
+    /**
+     * Get entry count.
+     */
+    get size(): number;
+    /**
+     * Clear all entries (for testing).
+     */
+    clear(): void;
+}
+//# sourceMappingURL=EventLog.d.ts.map

package/dist/observability/EventLog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventLog.d.ts","sourceRoot":"","sources":["../../src/observability/EventLog.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,YAAY,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;AAEtD;;;GAGG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;gBAElC,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO;IAIjD;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,QAAQ;IAiBrC;;OAEG;IACH,EAAE,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,IAAI;IAKvC;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,GAAG,MAAM,IAAI;IAKhE;;OAEG;IACH,KAAK,CAAC,MAAM,EAAE;QACZ,IAAI,CAAC,EAAE,aAAa,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,QAAQ,EAAE;IAsBd;;OAEG;IACH,MAAM,IAAI,SAAS,QAAQ,EAAE;IAI7B;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,KAAK,IAAI,IAAI;CAId"}

package/dist/observability/Logger.d.ts

@@ -0,0 +1,33 @@
+export type LogLevel = "silent" | "error" | "warn" | "info" | "debug" | "trace";
+export interface DebugOptions {
+    enabled?: boolean;
+    level?: LogLevel;
+    includeArgs?: boolean;
+    includeResults?: boolean;
+    includeRaw?: boolean;
+    logEvents?: boolean;
+    prefix?: string;
+}
+export interface ResolvedDebugOptions {
+    enabled: boolean;
+    level: LogLevel;
+    includeArgs: boolean;
+    includeResults: boolean;
+    includeRaw: boolean;
+    logEvents: boolean;
+    prefix: string;
+}
+export interface Logger {
+    options: ResolvedDebugOptions;
+    isEnabled(level: LogLevel): boolean;
+    error(message: string, meta?: Record<string, unknown>): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+    info(message: string, meta?: Record<string, unknown>): void;
+    debug(message: string, meta?: Record<string, unknown>): void;
+    trace(message: string, meta?: Record<string, unknown>): void;
+}
+export declare function createLogger(options?: DebugOptions): Logger;
+export declare function resolveDebugOptions(options?: DebugOptions): ResolvedDebugOptions;
+export declare function sanitizeForLog(value: unknown, maxLen?: number): string;
+export declare function summarizeForLog(value: unknown, maxLen?: number): string;
+//# sourceMappingURL=Logger.d.ts.map

package/dist/observability/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../src/observability/Logger.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAEhF,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,QAAQ,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,MAAM;IACrB,OAAO,EAAE,oBAAoB,CAAC;IAC9B,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC;IACpC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC9D;AAWD,wBAAgB,YAAY,CAAC,OAAO,GAAE,YAAiB,GAAG,MAAM,CAoC/D;AAED,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,YAAiB,GAAG,oBAAoB,CAgBpF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,SAAM,GAAG,MAAM,CAMnE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,SAAM,GAAG,MAAM,CAkBpE"}

package/dist/observability/Metrics.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Simple counter metric.
+ */
+export interface CounterValue {
+    name: string;
+    labels: Record<string, string>;
+    value: number;
+}
+/**
+ * Histogram bucket.
+ */
+export interface HistogramValue {
+    name: string;
+    labels: Record<string, string>;
+    count: number;
+    sum: number;
+    buckets: Map<number, number>;
+}
+/**
+ * Lightweight metrics collector for tool invocations.
+ * Provides counters and histograms with label support.
+ */
+export declare class Metrics {
+    private readonly counters;
+    private readonly histograms;
+    private readonly defaultBuckets;
+    /**
+     * Increment a counter.
+     */
+    increment(name: string, labels?: Record<string, string>, value?: number): void;
+    /**
+     * Record a value in a histogram.
+     */
+    observe(name: string, labels: Record<string, string>, value: number): void;
+    /**
+     * Get a counter value.
+     */
+    getCounter(name: string, labels?: Record<string, string>): number;
+    /**
+     * Get histogram stats.
+     */
+    getHistogram(name: string, labels: Record<string, string>): HistogramValue | undefined;
+    /**
+     * Get all counter values.
+     */
+    getAllCounters(): CounterValue[];
+    /**
+     * Get all histogram values.
+     */
+    getAllHistograms(): HistogramValue[];
+    /**
+     * Record standard tool invocation metrics.
+     */
+    recordInvocation(toolName: string, ok: boolean, durationMs: number): void;
+    /**
+     * Record a retry event.
+     */
+    recordRetry(toolName: string): void;
+    /**
+     * Record a policy denial.
+     */
+    recordPolicyDenied(toolName: string, reason: string): void;
+    /**
+     * Reset all metrics (for testing).
+     */
+    reset(): void;
+    private makeKey;
+    private parseKey;
+}
+//# sourceMappingURL=Metrics.d.ts.map

package/dist/observability/Metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Metrics.d.ts","sourceRoot":"","sources":["../../src/observability/Metrics.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED;;;GAGG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAGvB;IAEJ,OAAO,CAAC,QAAQ,CAAC,cAAc,CAE7B;IAEF;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EAAE,KAAK,SAAI,GAAG,IAAI;IAK7E;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAY1E;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,MAAM;IAIrE;;OAEG;IACH,YAAY,CACV,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,cAAc,GAAG,SAAS;IAa7B;;OAEG;IACH,cAAc,IAAI,YAAY,EAAE;IAShC;;OAEG;IACH,gBAAgB,IAAI,cAAc,EAAE;IAapC;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAQzE;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAInC;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAI1D;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,OAAO;IAQf,OAAO,CAAC,QAAQ;CAejB"}

package/dist/observability/Tracing.d.ts

@@ -0,0 +1,69 @@
+/**
+ * A trace span representing a unit of work.
+ */
+export interface Span {
+    spanId: string;
+    traceId: string;
+    parentSpanId?: string;
+    name: string;
+    startTime: number;
+    endTime?: number;
+    durationMs?: number;
+    status: "ok" | "error" | "in_progress";
+    attributes: Record<string, string | number | boolean>;
+    events: SpanEvent[];
+}
+/**
+ * An event within a span.
+ */
+export interface SpanEvent {
+    name: string;
+    timestamp: number;
+    attributes?: Record<string, string | number | boolean>;
+}
+/**
+ * Lightweight tracing system for tool invocation spans.
+ * Compatible with OpenTelemetry trace/span ID format.
+ */
+export declare class Tracing {
+    private readonly spans;
+    private readonly traceSpans;
+    /**
+     * Start a new span.
+     */
+    startSpan(options: {
+        name: string;
+        traceId?: string;
+        parentSpanId?: string;
+        attributes?: Record<string, string | number | boolean>;
+    }): Span;
+    /**
+     * End a span and calculate duration.
+     */
+    endSpan(spanId: string, status?: "ok" | "error"): Span | undefined;
+    /**
+     * Add an event to a span.
+     */
+    addEvent(spanId: string, name: string, attributes?: Record<string, string | number | boolean>): void;
+    /**
+     * Set attributes on a span.
+     */
+    setAttributes(spanId: string, attributes: Record<string, string | number | boolean>): void;
+    /**
+     * Get a span by ID.
+     */
+    getSpan(spanId: string): Span | undefined;
+    /**
+     * Get all spans for a trace.
+     */
+    getTrace(traceId: string): Span[];
+    /**
+     * Create a child span from a parent.
+     */
+    createChildSpan(parentSpanId: string, name: string, attributes?: Record<string, string | number | boolean>): Span | undefined;
+    /**
+     * Clear all traces (for testing).
+     */
+    clear(): void;
+}
+//# sourceMappingURL=Tracing.d.ts.map

package/dist/observability/Tracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tracing.d.ts","sourceRoot":"","sources":["../../src/observability/Tracing.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,IAAI,GAAG,OAAO,GAAG,aAAa,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACtD,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CACxD;AAED;;;GAGG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA+B;IAE1D;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;KACxD,GAAG,IAAI;IAqBR;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,IAAI,GAAG,OAAc,GAAG,IAAI,GAAG,SAAS;IAUxE;;OAEG;IACH,QAAQ,CACN,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GACrD,IAAI;IAMP;;OAEG;IACH,aAAa,CACX,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GACpD,IAAI;IAMP;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIzC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE;IAOjC;;OAEG;IACH,eAAe,CACb,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GACrD,IAAI,GAAG,SAAS;IAWnB;;OAEG;IACH,KAAK,IAAI,IAAI;CAId"}

package/dist/registry/ToolRegistry.d.ts

@@ -0,0 +1,68 @@
+import type { Capability, ToolKind, ToolSpec } from "../types/ToolSpec.js";
+/**
+ * Search query for tools.
+ */
+export 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.
+ */
+export 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;
+}
+//# sourceMappingURL=ToolRegistry.d.ts.map