@mcp-use/agent 2.0.0-beta.18 → 2.0.0-beta.19

package/dist/llm/chat.d.ts

@@ -1,5 +1,12 @@
 import type { ProviderConfig, ProviderMessage } from "./types.js";
-/** Single-shot chat completion without tools (sampling, props generation). */
+/**
+ * Runs one provider chat completion without exposing tools.
+ *
+ * @param params - Provider configuration, messages, and optional cancellation
+ * signal.
+ * @returns The assistant's final text.
+ * @throws {@link LlmRequestError} when the provider rejects the HTTP request.
+ */
 export declare function completeChat(params: {
     config: ProviderConfig;
     messages: ProviderMessage[];

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

@@ -1 +1 @@
-{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/llm/chat.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElE,8EAA8E;AAC9E,wBAAsB,YAAY,CAAC,MAAM,EAAE;IACzC,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,MAAM,CAAC,CAQlB"}
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/llm/chat.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElE;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE;IACzC,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,MAAM,CAAC,CAQlB"}

package/dist/llm/messageFormat.d.ts

@@ -1,26 +1,48 @@
 import type { ProviderMessage } from "./types.js";
 import type { BaseMessage } from "../agents/types.js";
-interface InspectorAttachment {
+/** Attachment accepted by {@link convertMessagesToProvider}. */
+export interface InspectorAttachment {
+    /** Attachment kind. Files that are not images are ignored. */
     type: "image" | "file";
+    /** Base64-encoded attachment bytes. */
     data: string;
+    /** MIME type for the encoded bytes. */
     mimeType: string;
 }
-interface InspectorMessagePart {
+/** Text or completed tool invocation in an inspector message. */
+export interface InspectorMessagePart {
+    /** Message part kind. */
     type: "text" | "tool-invocation";
+    /** Text content when `type` is `"text"`. */
     text?: string;
+    /** Invocation details when `type` is `"tool-invocation"`. */
     toolInvocation?: {
+        /** Tool name. */
         toolName: string;
+        /** Tool arguments. */
         args: Record<string, unknown>;
+        /** Completed result. Omit while the invocation is pending. */
         result?: unknown;
     };
 }
-interface InspectorMessageLike {
+/** Structural inspector message accepted by {@link convertMessagesToProvider}. */
+export interface InspectorMessageLike {
+    /** Author of the message. */
     role: "user" | "assistant";
+    /** Plain text or framework-specific content. */
     content: unknown;
+    /** Optional message attachments. */
     attachments?: InspectorAttachment[];
+    /** Optional AI SDK-style message parts. */
     parts?: InspectorMessagePart[];
 }
-/** Convert legacy LangChain external history for the native agent runtime. */
+/**
+ * Converts LangChain messages into provider-neutral history.
+ *
+ * @param messages - LangChain history in conversation order.
+ * @returns Equivalent provider messages.
+ * @throws TypeError if a message has an unsupported or unknown role.
+ */
 export declare function convertExternalHistoryToProvider(messages: BaseMessage[]): ProviderMessage[];
 /**
  * Convert inspector chat `Message[]` to provider-neutral `ProviderMessage[]`.
@@ -29,6 +51,10 @@ export declare function convertExternalHistoryToProvider(messages: BaseMessage[]
  * assistant message (bearing `toolCalls`) followed by one `tool` message per
  * invocation carrying the serialized result. This mirrors what the inspector
  * previously built using LangChain's AIMessage + ToolMessage pair.
+ *
+ * @param messages - Inspector messages in conversation order.
+ * @returns Provider-neutral messages, including completed tool call/result
+ * pairs.
  */
 export declare function convertMessagesToProvider(messages: InspectorMessageLike[]): ProviderMessage[];
 /**
@@ -42,10 +68,14 @@ export declare function extractSystem(messages: ProviderMessage[]): {
     system?: string;
     rest: ProviderMessage[];
 };
-/** Parse a `data:...;base64,...` URL. */
+/**
+ * Parses a base64 data URL.
+ *
+ * @param url - URL in `data:<mime>;base64,<payload>` form.
+ * @returns The MIME type and base64 payload, or `null` for another URL form.
+ */
 export declare function parseDataUrl(url: string): {
     mimeType: string;
     data: string;
 } | null;
-export {};
 //# sourceMappingURL=messageFormat.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"messageFormat.d.ts","sourceRoot":"","sources":["../../src/llm/messageFormat.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,eAAe,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,UAAU,mBAAmB;IAC3B,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,oBAAoB;IAC5B,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;CACH;AAED,UAAU,oBAAoB;IAC5B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACpC,KAAK,CAAC,EAAE,oBAAoB,EAAE,CAAC;CAChC;AA2CD,8EAA8E;AAC9E,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,WAAW,EAAE,GACtB,eAAe,EAAE,CAuCnB;AAsBD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,oBAAoB,EAAE,GAC/B,eAAe,EAAE,CAgEnB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,eAAe,EAAE,CAAC;CACzB,CAiBA;AAED,yCAAyC;AACzC,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,GACV;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAI3C"}
+{"version":3,"file":"messageFormat.d.ts","sourceRoot":"","sources":["../../src/llm/messageFormat.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,eAAe,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,gEAAgE;AAChE,MAAM,WAAW,mBAAmB;IAClC,8DAA8D;IAC9D,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,iEAAiE;AACjE,MAAM,WAAW,oBAAoB;IACnC,yBAAyB;IACzB,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAAC;IACjC,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,cAAc,CAAC,EAAE;QACf,iBAAiB;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,sBAAsB;QACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC9B,8DAA8D;QAC9D,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;CACH;AAED,kFAAkF;AAClF,MAAM,WAAW,oBAAoB;IACnC,6BAA6B;IAC7B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,WAAW,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACpC,2CAA2C;IAC3C,KAAK,CAAC,EAAE,oBAAoB,EAAE,CAAC;CAChC;AA2CD;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,WAAW,EAAE,GACtB,eAAe,EAAE,CAuCnB;AAsBD;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,oBAAoB,EAAE,GAC/B,eAAe,EAAE,CAgEnB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,eAAe,EAAE,CAAC;CACzB,CAiBA;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,GACV;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAI3C"}

package/dist/llm/provider_config.d.ts

@@ -1,13 +1,37 @@
 import type { ProviderConfig, ProviderName } from "./types.js";
+/** Optional credentials and request settings for a string model identifier. */
 export interface NativeLLMConfig {
+    /** Provider API key. When omitted, the provider environment variable is used. */
     apiKey?: string;
+    /** Sampling temperature forwarded to the provider. */
     temperature?: number;
+    /** Maximum number of output tokens requested from the provider. */
     maxTokens?: number;
+    /** Provider API base URL override. */
     baseUrl?: string;
+    /** Additional HTTP headers sent with every request. */
     extraHeaders?: Record<string, string>;
+    /** Fetch credentials mode used for provider requests. */
     credentials?: RequestCredentials;
 }
-/** Parse "provider/model" into native ProviderConfig (no LangChain). */
+/**
+ * Parses a `"provider/model"` identifier into a provider configuration.
+ *
+ * @param llmString - Provider and model separated by the first slash.
+ * @param config - Optional credentials and request overrides.
+ * @returns A complete provider configuration.
+ * @throws Error if the identifier is invalid, the provider is unsupported, or
+ * no required API key is available.
+ */
 export declare function parseLLMStringToProviderConfig(llmString: string, config?: NativeLLMConfig): ProviderConfig;
+/**
+ * Builds a provider configuration from separate provider and model values.
+ *
+ * @param provider - Provider implementation to use.
+ * @param model - Provider-specific model identifier.
+ * @param config - Optional credentials and request overrides.
+ * @returns A complete provider configuration.
+ * @throws Error if no required API key is available.
+ */
 export declare function providerConfigFromOptions(provider: ProviderName, model: string, config?: NativeLLMConfig): ProviderConfig;
 //# sourceMappingURL=provider_config.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"provider_config.d.ts","sourceRoot":"","sources":["../../src/llm/provider_config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/D,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAClC;AA6BD,wEAAwE;AACxE,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,eAAe,GACvB,cAAc,CAgChB;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,eAAe,GACvB,cAAc,CAWhB"}
+{"version":3,"file":"provider_config.d.ts","sourceRoot":"","sources":["../../src/llm/provider_config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/D,+EAA+E;AAC/E,MAAM,WAAW,eAAe;IAC9B,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,yDAAyD;IACzD,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAClC;AA6BD;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,eAAe,GACvB,cAAc,CAgChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,eAAe,GACvB,cAAc,CAWhB"}

package/dist/llm/providers/ollama/utils.d.ts

@@ -1,7 +1,29 @@
+/** Default origin used by a local Ollama installation. */
 export declare const DEFAULT_OLLAMA_BASE_URL = "http://localhost:11434";
+/**
+ * Normalizes an Ollama origin for use with `/api/*` endpoints.
+ *
+ * @param baseUrl - Ollama origin, optionally ending in `/` or `/api`.
+ * @returns The origin without trailing slashes or a trailing `/api`.
+ */
 export declare function normalizeOllamaBaseUrl(baseUrl?: string): string;
+/**
+ * Builds an absolute URL for an Ollama API endpoint.
+ *
+ * @param baseUrl - Ollama origin. Defaults to
+ * {@link DEFAULT_OLLAMA_BASE_URL}.
+ * @param path - Endpoint path beginning with `/api/`.
+ * @returns An absolute endpoint URL.
+ */
 export declare function buildOllamaApiUrl(baseUrl: string | undefined, path: `/api/${string}`): string;
+/**
+ * Indicates that a browser could not reach Ollama, commonly because its CORS
+ * origin allowlist rejected the request.
+ */
 export declare class OllamaCorsError extends Error {
+    /**
+     * @param cause - Original network error.
+     */
     constructor(cause: unknown);
 }
 //# sourceMappingURL=utils.d.ts.map

package/dist/llm/providers/ollama/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/llm/providers/ollama/utils.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,2BAA2B,CAAC;AAEhE,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAS/D;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,EAAE,QAAQ,MAAM,EAAE,GACrB,MAAM,CAER;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACxC,YAAY,KAAK,EAAE,OAAO,EAOzB;CACF"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/llm/providers/ollama/utils.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,eAAO,MAAM,uBAAuB,2BAA2B,CAAC;AAEhE;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAS/D;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,EAAE,QAAQ,MAAM,EAAE,GACrB,MAAM,CAER;AAED;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC;;OAEG;IACH,YAAY,KAAK,EAAE,OAAO,EAOzB;CACF"}

package/dist/llm/providers/openai-chat-completions.d.ts

@@ -1,8 +1,15 @@
 import type { LlmStreamEvent, ProviderConfig, ProviderMessage, ProviderTool } from "../types.js";
-/** Structured HTTP error from an LLM provider fetch (preserves status + JSON body). */
+/** HTTP error returned by an LLM provider request. */
 export declare class LlmRequestError extends Error {
+    /** HTTP response status. */
     readonly status: number;
+    /** Parsed JSON response body, or the raw response text. */
     readonly body?: unknown;
+    /**
+     * @param status - HTTP response status.
+     * @param message - Error message.
+     * @param body - Parsed or raw provider response body.
+     */
     constructor(status: number, message: string, body?: unknown);
 }
 interface ChatParams {

package/dist/llm/providers/openai-chat-completions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openai-chat-completions.d.ts","sourceRoot":"","sources":["../../../src/llm/providers/openai-chat-completions.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAEV,cAAc,EACd,cAAc,EACd,eAAe,EACf,YAAY,EACb,MAAM,aAAa,CAAC;AAGrB,uFAAuF;AACvF,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAExB,YAAY,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAK1D;CACF;AAmBD,UAAU,UAAU;IAClB,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AA2BD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,OAAO,EAAE,CAoDvE;AAED,wBAAuB,UAAU,CAC/B,MAAM,EAAE,UAAU,GACjB,cAAc,CAAC,cAAc,EAAE,IAAI,EAAE,OAAO,CAAC,CAmI/C;AAED,wBAAsB,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EAAE,CAAC;CAC1E,CAAC,CAiDD"}
+{"version":3,"file":"openai-chat-completions.d.ts","sourceRoot":"","sources":["../../../src/llm/providers/openai-chat-completions.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAEV,cAAc,EACd,cAAc,EACd,eAAe,EACf,YAAY,EACb,MAAM,aAAa,CAAC;AAGrB,sDAAsD;AACtD,qBAAa,eAAgB,SAAQ,KAAK;IACxC,4BAA4B;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAExB;;;;OAIG;IACH,YAAY,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAK1D;CACF;AAmBD,UAAU,UAAU;IAClB,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AA2BD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,OAAO,EAAE,CAoDvE;AAED,wBAAuB,UAAU,CAC/B,MAAM,EAAE,UAAU,GACjB,cAAc,CAAC,cAAc,EAAE,IAAI,EAAE,OAAO,CAAC,CAmI/C;AAED,wBAAsB,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EAAE,CAAC;CAC1E,CAAC,CAiDD"}

package/dist/llm/types.d.ts

@@ -3,17 +3,25 @@
  *
  * These replace the langchain BaseMessage / StreamEvent types that the
  * inspector previously depended on. The goal is to keep the inspector free
- * of any @langchain/* or langchain runtime imports so that consumers of
- * @mcp-use/inspector (and, transitively, of mcp-use) do not need to install
+ * of any `@langchain/*` or langchain runtime imports so that consumers of
+ * `@mcp-use/inspector` (and, transitively, of mcp-use) do not need to install
  * langchain to bundle their apps.
  */
+/** LLM providers supported by the native agent runtime. */
 export type ProviderName = "openai" | "openai-compatible" | "anthropic" | "google" | "openrouter" | "ollama";
+/** Provider-neutral model and HTTP request configuration. */
 export interface ProviderConfig {
+    /** Provider implementation used for requests. */
     provider: ProviderName;
+    /** Provider-specific model identifier. */
     model: string;
+    /** Provider API key. Ollama may use an empty string. */
     apiKey: string;
+    /** Sampling temperature forwarded to the provider. */
     temperature?: number;
+    /** Maximum number of output tokens requested from the provider. */
     maxTokens?: number;
+    /** Provider API base URL override. */
     baseUrl?: string;
     /** Extra HTTP headers to merge into every request (e.g. OpenRouter's HTTP-Referer). */
     extraHeaders?: Record<string, string>;
@@ -22,7 +30,9 @@ export interface ProviderConfig {
     /** Responses API reasoning effort (direct OpenAI provider). */
     reasoningEffort?: "none" | "low" | "medium" | "high";
 }
+/** Image content supplied to a multimodal model. */
 export interface ImageContentPart {
+    /** Content discriminator. */
     type: "image";
     /** Full data URL (`data:image/png;base64,...`) or raw https URL. */
     url: string;
@@ -31,10 +41,14 @@ export interface ImageContentPart {
     /** Base64 payload without the data-URL prefix (when available). */
     data?: string;
 }
+/** Text content supplied to a model. */
 export interface TextContentPart {
+    /** Content discriminator. */
     type: "text";
+    /** Plain-text content. */
     text: string;
 }
+/** Text or image content in a provider message. */
 export type ContentPart = TextContentPart | ImageContentPart;
 /**
  * Provider-neutral message shape. Each provider module is responsible for
@@ -42,6 +56,7 @@ export type ContentPart = TextContentPart | ImageContentPart;
  * messages, Gemini generateContent).
  */
 export interface ProviderMessage {
+    /** Message role in the provider-neutral conversation. */
     role: "system" | "user" | "assistant" | "tool";
     /** Text content, OR a list of rich content parts (for multimodal input). */
     content: string | ContentPart[];
@@ -49,68 +64,120 @@ export interface ProviderMessage {
     toolCalls?: ProviderToolCall[];
     /** Tool result payload (tool messages only). */
     toolCallId?: string;
+    /** Tool name associated with a tool result. */
     toolName?: string;
+    /** Raw result returned by the MCP tool. */
     toolResult?: unknown;
+    /** Whether the MCP tool reported an error. */
     toolIsError?: boolean;
 }
+/** Tool call requested by a model. */
 export interface ProviderToolCall {
+    /** Provider-generated call identifier. */
     id: string;
+    /** Tool name exposed to the model. */
     name: string;
+    /** Parsed tool arguments. */
     args: Record<string, unknown>;
 }
+/** Provider-neutral tool definition supplied to a model. */
 export interface ProviderTool {
+    /** Tool name exposed to the model. */
     name: string;
+    /** Human-readable tool description. */
     description?: string;
     /** JSON Schema object describing the tool's input. */
     inputSchema: Record<string, unknown>;
 }
+/** Token counts reported by an LLM provider. */
 export interface TokenUsage {
+    /** Tokens read from the request. */
     inputTokens?: number;
+    /** Tokens generated in the response. */
     outputTokens?: number;
+    /** Total input and output tokens. */
     totalTokens?: number;
+    /** Input tokens served from a provider cache. */
     cachedInputTokens?: number;
+    /** Tokens used for model reasoning. */
     reasoningTokens?: number;
 }
-/**
- * Stream events emitted by the tool loop. These replace LangChain's
- * `on_chat_model_stream`, `on_tool_start`, `on_tool_end` events. The shape
- * is deliberately narrow and tailored to what the inspector UI needs.
- */
-export type LlmStreamEvent = {
+/** Text emitted by the model. */
+export interface LlmTextDeltaEvent {
+    /** Event discriminator. */
     type: "text-delta";
+    /** Incremental text. */
     delta: string;
-} | {
+}
+/** Start of a model-requested tool call. */
+export interface LlmToolCallStartEvent {
+    /** Event discriminator. */
     type: "tool-call-start";
-    /** Stable per-turn index so multiple parallel calls can be tracked. */
+    /** Stable per-turn index for tracking parallel calls. */
     index: number;
+    /** Provider-generated tool call identifier. */
     toolCallId: string;
+    /** Tool name exposed to the model. */
     toolName: string;
-} | {
+}
+/** Incremental JSON arguments for a model-requested tool call. */
+export interface LlmToolCallArgsDeltaEvent {
+    /** Event discriminator. */
     type: "tool-call-args-delta";
+    /** Stable per-turn index for tracking parallel calls. */
     index: number;
+    /** Provider-generated tool call identifier. */
     toolCallId: string;
+    /** Tool name exposed to the model. */
     toolName: string;
-    /** Partial JSON fragment. Concatenate across deltas, then parse. */
+    /** Partial JSON fragment. Concatenate all fragments before parsing. */
     argsDelta: string;
-} | {
+}
+/** A tool call with complete, parsed arguments. */
+export interface LlmToolCallReadyEvent {
+    /** Event discriminator. */
     type: "tool-call-ready";
+    /** Stable per-turn index for tracking parallel calls. */
     index: number;
+    /** Provider-generated tool call identifier. */
     toolCallId: string;
+    /** Tool name exposed to the model. */
     toolName: string;
+    /** Parsed tool arguments. */
     args: Record<string, unknown>;
-} | {
+}
+/** Result of an MCP tool invocation. */
+export interface LlmToolResultEvent {
+    /** Event discriminator. */
     type: "tool-result";
+    /** Provider-generated tool call identifier. */
     toolCallId: string;
+    /** Invoked tool name. */
     toolName: string;
+    /** Raw MCP tool result. */
     result: unknown;
+    /** Whether the tool reported an error. */
     isError: boolean;
-} | {
+}
+/** Token usage reported by the provider. */
+export interface LlmUsageEvent {
+    /** Event discriminator. */
     type: "usage";
+    /** Provider-normalized token counts. */
     usage: TokenUsage;
-} | {
+}
+/** Error emitted during streaming. */
+export interface LlmErrorEvent {
+    /** Event discriminator. */
     type: "error";
+    /** Human-readable error message. */
     message: string;
-} | {
+}
+/** Indicates that the tool loop finished. */
+export interface LlmDoneEvent {
+    /** Event discriminator. */
     type: "done";
-};
+}
+/** Provider-neutral event emitted by the native agent tool loop. */
+export type LlmStreamEvent = LlmTextDeltaEvent | LlmToolCallStartEvent | LlmToolCallArgsDeltaEvent | LlmToolCallReadyEvent | LlmToolResultEvent | LlmUsageEvent | LlmErrorEvent | LlmDoneEvent;
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/llm/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,mBAAmB,GACnB,WAAW,GACX,QAAQ,GACR,YAAY,GACZ,QAAQ,CAAC;AAEb,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uFAAuF;IACvF,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,kFAAkF;IAClF,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,+DAA+D;IAC/D,eAAe,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACtD;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,oEAAoE;IACpE,GAAG,EAAE,MAAM,CAAC;IACZ,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,gBAAgB,CAAC;AAE7D;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,4EAA4E;IAC5E,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;IAChC,qEAAqE;IACrE,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACrC;IACE,IAAI,EAAE,iBAAiB,CAAC;IACxB,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,GACD;IACE,IAAI,EAAE,sBAAsB,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IACE,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,GACD;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB,GACD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/llm/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,2DAA2D;AAC3D,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,mBAAmB,GACnB,WAAW,GACX,QAAQ,GACR,YAAY,GACZ,QAAQ,CAAC;AAEb,6DAA6D;AAC7D,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,QAAQ,EAAE,YAAY,CAAC;IACvB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uFAAuF;IACvF,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,kFAAkF;IAClF,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,+DAA+D;IAC/D,eAAe,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACtD;AAED,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,oEAAoE;IACpE,GAAG,EAAE,MAAM,CAAC;IACZ,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wCAAwC;AACxC,MAAM,WAAW,eAAe;IAC9B,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,mDAAmD;AACnD,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,gBAAgB,CAAC;AAE7D;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,4EAA4E;IAC5E,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;IAChC,qEAAqE;IACrE,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,sCAAsC;AACtC,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,4DAA4D;AAC5D,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,gDAAgD;AAChD,MAAM,WAAW,UAAU;IACzB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uCAAuC;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,iCAAiC;AACjC,MAAM,WAAW,iBAAiB;IAChC,2BAA2B;IAC3B,IAAI,EAAE,YAAY,CAAC;IACnB,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,4CAA4C;AAC5C,MAAM,WAAW,qBAAqB;IACpC,2BAA2B;IAC3B,IAAI,EAAE,iBAAiB,CAAC;IACxB,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,kEAAkE;AAClE,MAAM,WAAW,yBAAyB;IACxC,2BAA2B;IAC3B,IAAI,EAAE,sBAAsB,CAAC;IAC7B,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,mDAAmD;AACnD,MAAM,WAAW,qBAAqB;IACpC,2BAA2B;IAC3B,IAAI,EAAE,iBAAiB,CAAC;IACxB,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,wCAAwC;AACxC,MAAM,WAAW,kBAAkB;IACjC,2BAA2B;IAC3B,IAAI,EAAE,aAAa,CAAC;IACpB,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,0CAA0C;IAC1C,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC5B,2BAA2B;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,wCAAwC;IACxC,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,sCAAsC;AACtC,MAAM,WAAW,aAAa;IAC5B,2BAA2B;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,6CAA6C;AAC7C,MAAM,WAAW,YAAY;IAC3B,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,oEAAoE;AACpE,MAAM,MAAM,cAAc,GACtB,iBAAiB,GACjB,qBAAqB,GACrB,yBAAyB,GACzB,qBAAqB,GACrB,kBAAkB,GAClB,aAAa,GACb,aAAa,GACb,YAAY,CAAC"}

package/dist/managers/server_manager.d.ts

@@ -2,18 +2,48 @@ import type { StructuredToolInterface } from "@langchain/core/tools";
 import type { LangChainAdapter } from "../adapters/langchain_adapter.js";
 import type { MCPClient } from "@mcp-use/client";
 import type { IServerManager } from "./types.js";
+/** Selects an active MCP server and exposes its LangChain tools. */
 export declare class ServerManager implements IServerManager {
+    /** Whether capabilities have been loaded for each configured server. */
     readonly initializedServers: Record<string, boolean>;
+    /** Cached LangChain tools, resources, and prompts by server name. */
     readonly serverTools: Record<string, StructuredToolInterface[]>;
+    /** MCP client that owns server configurations and sessions. */
     readonly client: MCPClient;
+    /** Adapter used to create LangChain tools. */
     readonly adapter: LangChainAdapter;
+    /** Server whose cached tools are currently exposed. */
     activeServer: string | null;
     private overrideManagementTools?;
+    /**
+     * @param client - MCP client that owns the managed servers.
+     * @param adapter - Adapter used to convert MCP capabilities.
+     * @param managementTools - Optional replacement for the built-in server
+     * management tools.
+     */
     constructor(client: MCPClient, adapter: LangChainAdapter, managementTools?: StructuredToolInterface[]);
+    /**
+     * Replaces the management tools returned by {@link ServerManager.tools}.
+     *
+     * @param tools - Complete replacement tool list.
+     */
     setManagementTools(tools: StructuredToolInterface[]): void;
+    /**
+     * Writes current connection and tool-cache state at debug level.
+     *
+     * @param context - Label describing why the state was logged.
+     */
     logState(context: string): void;
+    /** Validates that the client contains at least one server configuration. */
     initialize(): void;
+    /**
+     * Connects configured servers as needed and caches all tools, resources, and
+     * prompts.
+     */
     prefetchServerTools(): Promise<void>;
+    /**
+     * @returns Management tools plus cached tools from the active server, if any.
+     */
     get tools(): StructuredToolInterface[];
 }
 //# sourceMappingURL=server_manager.d.ts.map

package/dist/managers/server_manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server_manager.d.ts","sourceRoot":"","sources":["../../src/managers/server_manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAmDjD,qBAAa,aAAc,YAAW,cAAc;IAClD,SAAgB,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM;IACjE,SAAgB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,EAAE,CAAC,CAAM;IAE5E,SAAgB,MAAM,EAAE,SAAS,CAAC;IAClC,SAAgB,OAAO,EAAE,gBAAgB,CAAC;IACnC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC1C,OAAO,CAAC,uBAAuB,CAAC,CAA4B;IAE5D,YACE,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,gBAAgB,EACzB,eAAe,CAAC,EAAE,uBAAuB,EAAE,EAK5C;IAEM,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,EAAE,GAAG,IAAI,CAKhE;IAEM,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAmBrC;IAED,UAAU,IAAI,IAAI,CAKjB;IAEK,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAsEzC;IAED,IAAI,KAAK,IAAI,uBAAuB,EAAE,CAsBrC;CACF"}
+{"version":3,"file":"server_manager.d.ts","sourceRoot":"","sources":["../../src/managers/server_manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAmDjD,oEAAoE;AACpE,qBAAa,aAAc,YAAW,cAAc;IAClD,wEAAwE;IACxE,SAAgB,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM;IACjE,qEAAqE;IACrE,SAAgB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,EAAE,CAAC,CAAM;IAE5E,+DAA+D;IAC/D,SAAgB,MAAM,EAAE,SAAS,CAAC;IAClC,8CAA8C;IAC9C,SAAgB,OAAO,EAAE,gBAAgB,CAAC;IAC1C,uDAAuD;IAChD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC1C,OAAO,CAAC,uBAAuB,CAAC,CAA4B;IAE5D;;;;;OAKG;IACH,YACE,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,gBAAgB,EACzB,eAAe,CAAC,EAAE,uBAAuB,EAAE,EAK5C;IAED;;;;OAIG;IACI,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,EAAE,GAAG,IAAI,CAKhE;IAED;;;;OAIG;IACI,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAmBrC;IAED,4EAA4E;IAC5E,UAAU,IAAI,IAAI,CAKjB;IAED;;;OAGG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAsEzC;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,uBAAuB,EAAE,CAsBrC;CACF"}

package/dist/managers/tools/acquire_active_mcp_server.d.ts

@@ -2,11 +2,16 @@ import type { IServerManager } from "../types.js";
 import { z } from "zod";
 import { MCPServerTool } from "./base.js";
 declare const PresentActiveServerSchema: z.ZodObject<{}, z.core.$strip>;
+/** Reports the MCP server whose tools are currently active. */
 export declare class AcquireActiveMCPServerTool extends MCPServerTool<typeof PresentActiveServerSchema> {
+    /** Tool name exposed to the model. */
     name: string;
+    /** Tool description exposed to the model. */
     description: string;
+    /** Empty input schema. */
     schema: z.ZodObject<{}, z.core.$strip>;
     constructor(manager: IServerManager);
+    /** @returns A message identifying the active server, or stating there is none. */
     _call(): Promise<string>;
 }
 export {};

package/dist/managers/tools/acquire_active_mcp_server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"acquire_active_mcp_server.d.ts","sourceRoot":"","sources":["../../../src/managers/tools/acquire_active_mcp_server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,QAAA,MAAM,yBAAyB,gCAAe,CAAC;AAE/C,qBAAa,0BAA2B,SAAQ,aAAa,CAC3D,OAAO,yBAAyB,CACjC;IACU,IAAI,SAA2B;IAC/B,WAAW,SAC6C;IACxD,MAAM,iCAA6B;IAE5C,YAAY,OAAO,EAAE,cAAc,EAElC;IAEK,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAM7B;CACF"}
+{"version":3,"file":"acquire_active_mcp_server.d.ts","sourceRoot":"","sources":["../../../src/managers/tools/acquire_active_mcp_server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,QAAA,MAAM,yBAAyB,gCAAe,CAAC;AAE/C,+DAA+D;AAC/D,qBAAa,0BAA2B,SAAQ,aAAa,CAC3D,OAAO,yBAAyB,CACjC;IACC,sCAAsC;IAC7B,IAAI,SAA2B;IACxC,6CAA6C;IACpC,WAAW,SAC6C;IACjE,0BAA0B;IACjB,MAAM,iCAA6B;IAE5C,YAAY,OAAO,EAAE,cAAc,EAElC;IAED,kFAAkF;IAC5E,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAM7B;CACF"}

package/dist/managers/tools/add_server_from_config.d.ts

@@ -1,15 +1,27 @@
 import type { IServerManager } from "../types.js";
 import { StructuredTool } from "@langchain/core/tools";
 import { z } from "zod";
+/** Adds, connects, and activates an MCP server from model-supplied config. */
 export declare class AddMCPServerFromConfigTool extends StructuredTool {
+    /** Tool name exposed to the model. */
     name: string;
+    /** Tool description exposed to the model. */
     description: string;
+    /** Input schema for the server name and transport configuration. */
     schema: z.ZodObject<{
         serverName: z.ZodString;
         serverConfig: z.ZodAny;
     }, z.core.$strip>;
     private manager;
+    /**
+     * @param manager - Server manager that receives the new server.
+     */
     constructor(manager: IServerManager);
+    /**
+     * Adds the server, opens a session, and makes the server active.
+     *
+     * @returns A success message with loaded tool names, or an error message.
+     */
     protected _call({ serverName, serverConfig, }: z.infer<typeof this.schema>): Promise<string>;
 }
 //# sourceMappingURL=add_server_from_config.d.ts.map

package/dist/managers/tools/add_server_from_config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add_server_from_config.d.ts","sourceRoot":"","sources":["../../../src/managers/tools/add_server_from_config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,qBAAa,0BAA2B,SAAQ,cAAc;IAC5D,IAAI,SAAgC;IACpC,WAAW,SACyG;IAEpH,MAAM;;;sBAOH;IAEH,OAAO,CAAC,OAAO,CAAiB;IAEhC,YAAY,OAAO,EAAE,cAAc,EAGlC;IAED,UAAgB,KAAK,CAAC,EACpB,UAAU,EACV,YAAY,GACb,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CA2B/C;CACF"}
+{"version":3,"file":"add_server_from_config.d.ts","sourceRoot":"","sources":["../../../src/managers/tools/add_server_from_config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,8EAA8E;AAC9E,qBAAa,0BAA2B,SAAQ,cAAc;IAC5D,sCAAsC;IACtC,IAAI,SAAgC;IACpC,6CAA6C;IAC7C,WAAW,SACyG;IAEpH,oEAAoE;IACpE,MAAM;;;sBASH;IAEH,OAAO,CAAC,OAAO,CAAiB;IAEhC;;OAEG;IACH,YAAY,OAAO,EAAE,cAAc,EAGlC;IAED;;;;OAIG;IACH,UAAgB,KAAK,CAAC,EACpB,UAAU,EACV,YAAY,GACb,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CA2B/C;CACF"}

package/dist/managers/tools/base.d.ts

@@ -7,12 +7,19 @@ import { StructuredTool } from "@langchain/core/tools";
 type ToolOutputT = any;
 export type SchemaOutputT<T extends ToolSchemaBase> = T extends z.ZodSchema ? z.output<T> : T extends JSONSchema ? unknown : never;
 export declare class MCPServerTool<SchemaT extends ToolSchemaBase> extends StructuredTool<SchemaT, SchemaOutputT<SchemaT>> {
+    /** Default tool name. Subclasses replace this value. */
     name: string;
+    /** Default tool description. Subclasses replace this value. */
     description: string;
+    /** Input schema supplied by the concrete management tool. */
     schema: SchemaT;
     private readonly _manager;
+    /**
+     * @param manager - Server manager operated by this tool.
+     */
     constructor(manager: IServerManager);
     protected _call(_arg: SchemaOutputT<SchemaT>, _runManager?: CallbackManagerForToolRun, _parentConfig?: ToolRunnableConfig): Promise<ToolOutputT>;
+    /** @returns The server manager operated by this tool. */
     get manager(): IServerManager;
 }
 export {};

package/dist/managers/tools/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/managers/tools/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AACnF,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,KAAK,WAAW,GAAG,GAAG,CAAC;AACvB,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,cAAc,IAAI,CAAC,SAAS,CAAC,CAAC,SAAS,GACvE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GACX,CAAC,SAAS,UAAU,GAClB,OAAO,GACP,KAAK,CAAC;AAEZ,qBAAa,aAAa,CACxB,OAAO,SAAS,cAAc,CAC9B,SAAQ,cAAc,CAAC,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,EAAE,MAAM,CAAqB;IACjC,WAAW,EAAE,MAAM,CAA0C;IAC7D,MAAM,EAAG,OAAO,CAAC;IAE1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAE1C,YAAY,OAAO,EAAE,cAAc,EAGlC;IAED,UAAgB,KAAK,CACnB,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,EAC5B,WAAW,CAAC,EAAE,yBAAyB,EACvC,aAAa,CAAC,EAAE,kBAAkB,GACjC,OAAO,CAAC,WAAW,CAAC,CAEtB;IAED,IAAI,OAAO,IAAI,cAAc,CAE5B;CACF"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/managers/tools/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AACnF,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,KAAK,WAAW,GAAG,GAAG,CAAC;AACvB,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,cAAc,IAAI,CAAC,SAAS,CAAC,CAAC,SAAS,GACvE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GACX,CAAC,SAAS,UAAU,GAClB,OAAO,GACP,KAAK,CAAC;AAEZ,qBAAa,aAAa,CACxB,OAAO,SAAS,cAAc,CAC9B,SAAQ,cAAc,CAAC,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACvD,wDAAwD;IAC/C,IAAI,EAAE,MAAM,CAAqB;IAC1C,+DAA+D;IACtD,WAAW,EAAE,MAAM,CAA0C;IACtE,6DAA6D;IACpD,MAAM,EAAG,OAAO,CAAC;IAE1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAE1C;;OAEG;IACH,YAAY,OAAO,EAAE,cAAc,EAGlC;IAED,UAAgB,KAAK,CACnB,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,EAC5B,WAAW,CAAC,EAAE,yBAAyB,EACvC,aAAa,CAAC,EAAE,kBAAkB,GACjC,OAAO,CAAC,WAAW,CAAC,CAEtB;IAED,yDAAyD;IACzD,IAAI,OAAO,IAAI,cAAc,CAE5B;CACF"}

package/dist/managers/tools/connect_mcp_server.d.ts

@@ -5,13 +5,22 @@ import { MCPServerTool } from "./base.js";
 declare const ConnectMCPServerSchema: z.ZodObject<{
     serverName: z.ZodString;
 }, z.core.$strip>;
+/** Activates a configured MCP server and exposes its capabilities. */
 export declare class ConnectMCPServerTool extends MCPServerTool<typeof ConnectMCPServerSchema> {
+    /** Tool name exposed to the model. */
     name: string;
+    /** Tool description exposed to the model. */
     description: string;
+    /** Input schema containing the server name. */
     schema: z.ZodObject<{
         serverName: z.ZodString;
     }, z.core.$strip>;
     constructor(manager: IServerManager);
+    /**
+     * Activates a configured server and loads its capabilities if needed.
+     *
+     * @returns A human-readable success or error message.
+     */
     _call({ serverName }: SchemaOutputT<typeof ConnectMCPServerSchema>): Promise<string>;
 }
 export {};

package/dist/managers/tools/connect_mcp_server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connect_mcp_server.d.ts","sourceRoot":"","sources":["../../../src/managers/tools/connect_mcp_server.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,QAAA,MAAM,sBAAsB;;iBAE1B,CAAC;AAEH,qBAAa,oBAAqB,SAAQ,aAAa,CACrD,OAAO,sBAAsB,CAC9B;IACU,IAAI,SAA2B;IAC/B,WAAW,SAC6H;IACxI,MAAM;;sBAA0B;IAEzC,YAAY,OAAO,EAAE,cAAc,EAElC;IAEK,KAAK,CAAC,EAAE,UAAU,EAAE,EAAE,aAAa,CAAC,OAAO,sBAAsB,CAAC,mBA+CvE;CACF"}
+{"version":3,"file":"connect_mcp_server.d.ts","sourceRoot":"","sources":["../../../src/managers/tools/connect_mcp_server.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,QAAA,MAAM,sBAAsB;;iBAG1B,CAAC;AAEH,sEAAsE;AACtE,qBAAa,oBAAqB,SAAQ,aAAa,CACrD,OAAO,sBAAsB,CAC9B;IACC,sCAAsC;IAC7B,IAAI,SAA2B;IACxC,6CAA6C;IACpC,WAAW,SAC6H;IACjJ,+CAA+C;IACtC,MAAM;;sBAA0B;IAEzC,YAAY,OAAO,EAAE,cAAc,EAElC;IAED;;;;OAIG;IACG,KAAK,CAAC,EAAE,UAAU,EAAE,EAAE,aAAa,CAAC,OAAO,sBAAsB,CAAC,mBA+CvE;CACF"}

package/dist/managers/tools/list_mcp_servers.d.ts

@@ -2,11 +2,16 @@ import type { IServerManager } from "../types.js";
 import { z } from "zod";
 import { MCPServerTool } from "./base.js";
 declare const EnumerateServersSchema: z.ZodObject<{}, z.core.$strip>;
+/** Lists configured MCP servers and their cached capability counts. */
 export declare class ListMCPServersTool extends MCPServerTool<typeof EnumerateServersSchema> {
+    /** Tool name exposed to the model. */
     name: string;
+    /** Tool description exposed to the model. */
     description: string;
+    /** Empty input schema. */
     schema: z.ZodObject<{}, z.core.$strip>;
     constructor(manager: IServerManager);
+    /** @returns A formatted list of configured servers and capability counts. */
     _call(): Promise<string>;
 }
 export {};

package/dist/managers/tools/list_mcp_servers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list_mcp_servers.d.ts","sourceRoot":"","sources":["../../../src/managers/tools/list_mcp_servers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,QAAA,MAAM,sBAAsB,gCAAe,CAAC;AAE5C,qBAAa,kBAAmB,SAAQ,aAAa,CACnD,OAAO,sBAAsB,CAC9B;IACU,IAAI,SAAsB;IAC1B,WAAW,SAAkN;IAC7N,MAAM,iCAA0B;IAEzC,YAAY,OAAO,EAAE,cAAc,EAElC;IAEK,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CA0B7B;CACF"}
+{"version":3,"file":"list_mcp_servers.d.ts","sourceRoot":"","sources":["../../../src/managers/tools/list_mcp_servers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,QAAA,MAAM,sBAAsB,gCAAe,CAAC;AAE5C,uEAAuE;AACvE,qBAAa,kBAAmB,SAAQ,aAAa,CACnD,OAAO,sBAAsB,CAC9B;IACC,sCAAsC;IAC7B,IAAI,SAAsB;IACnC,6CAA6C;IACpC,WAAW,SAAkN;IACtO,0BAA0B;IACjB,MAAM,iCAA0B;IAEzC,YAAY,OAAO,EAAE,cAAc,EAElC;IAED,6EAA6E;IACvE,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CA0B7B;CACF"}