@usestratus/sdk 1.3.0 → 1.6.0

package/dist/core/hooks.d.ts

@@ -18,6 +18,8 @@ export type HandoffDecision = {
     decision: "deny";
     reason?: string;
 };
+type HookResult<T = void> = T | Promise<T>;
+type NotificationHookResult = unknown | Promise<unknown>;
 export type ToolMatcher = string | RegExp;
 export interface MatchedToolCallHook<TContext = unknown> {
     match: ToolMatcher | ToolMatcher[];
@@ -25,7 +27,7 @@ export interface MatchedToolCallHook<TContext = unknown> {
         agent: Agent<TContext, any>;
         toolCall: ToolCall;
         context: TContext;
-    }) => undefined | ToolCallDecision | Promise<undefined | ToolCallDecision>;
+    }) => HookResult<void | ToolCallDecision | undefined>;
 }
 export interface MatchedAfterToolCallHook<TContext = unknown> {
     match: ToolMatcher | ToolMatcher[];
@@ -34,65 +36,65 @@ export interface MatchedAfterToolCallHook<TContext = unknown> {
         toolCall: ToolCall;
         result: string;
         context: TContext;
-    }) => void | Promise<void>;
+    }) => NotificationHookResult;
 }
 export type BeforeToolCallHook<TContext = unknown> = ((params: {
     agent: Agent<TContext, any>;
     toolCall: ToolCall;
     context: TContext;
-}) => undefined | ToolCallDecision | Promise<undefined | ToolCallDecision>) | MatchedToolCallHook<TContext>[];
+}) => HookResult<void | ToolCallDecision | undefined>) | MatchedToolCallHook<TContext>[];
 export type AfterToolCallHook<TContext = unknown> = ((params: {
     agent: Agent<TContext, any>;
     toolCall: ToolCall;
     result: string;
     context: TContext;
-}) => void | Promise<void>) | MatchedAfterToolCallHook<TContext>[];
+}) => NotificationHookResult) | MatchedAfterToolCallHook<TContext>[];
 export interface AgentHooks<TContext = unknown> {
     beforeRun?: (params: {
         agent: Agent<TContext, any>;
         input: string;
         context: TContext;
-    }) => void | Promise<void>;
+    }) => NotificationHookResult;
     afterRun?: (params: {
         agent: Agent<TContext, any>;
         result: RunResult<any>;
         context: TContext;
-    }) => void | Promise<void>;
+    }) => NotificationHookResult;
     beforeToolCall?: BeforeToolCallHook<TContext>;
     afterToolCall?: AfterToolCallHook<TContext>;
     beforeHandoff?: (params: {
         fromAgent: Agent<TContext, any>;
         toAgent: Agent<TContext, any>;
         context: TContext;
-    }) => undefined | HandoffDecision | Promise<undefined | HandoffDecision>;
+    }) => HookResult<void | HandoffDecision | undefined>;
     onStop?: (params: {
         agent: Agent<TContext, any>;
         context: TContext;
         reason: "max_turns" | "max_budget";
-    }) => void | Promise<void>;
+    }) => NotificationHookResult;
     onSubagentStart?: (params: {
         agent: Agent<TContext, any>;
         subagent: SubAgent;
         context: TContext;
-    }) => void | Promise<void>;
+    }) => NotificationHookResult;
     onSubagentStop?: (params: {
         agent: Agent<TContext, any>;
         subagent: SubAgent;
         result: string;
         context: TContext;
-    }) => void | Promise<void>;
+    }) => NotificationHookResult;
     onSessionStart?: (params: {
         context: TContext;
-    }) => void | Promise<void>;
+    }) => NotificationHookResult;
     onSessionEnd?: (params: {
         context: TContext;
-    }) => void | Promise<void>;
+    }) => NotificationHookResult;
     /** Called before each LLM API call */
     onLlmStart?: (params: {
         agent: Agent<TContext, any>;
         messages: ChatMessage[];
         context: TContext;
-    }) => void | Promise<void>;
+    }) => NotificationHookResult;
     /** Called after each LLM API call */
     onLlmEnd?: (params: {
         agent: Agent<TContext, any>;
@@ -101,7 +103,7 @@ export interface AgentHooks<TContext = unknown> {
             toolCallCount: number;
         };
         context: TContext;
-    }) => void | Promise<void>;
+    }) => NotificationHookResult;
 }
 /** Run-level hooks that fire across all agents in a run */
 export interface RunHooks<TContext = unknown> {
@@ -109,38 +111,38 @@ export interface RunHooks<TContext = unknown> {
     onAgentStart?: (params: {
         agent: Agent<TContext, any>;
         context: TContext;
-    }) => void | Promise<void>;
+    }) => NotificationHookResult;
     /** Called when an agent finishes (before handoff or at end) */
     onAgentEnd?: (params: {
         agent: Agent<TContext, any>;
         output: string;
         context: TContext;
-    }) => void | Promise<void>;
+    }) => NotificationHookResult;
     /** Called on every handoff */
     onHandoff?: (params: {
         fromAgent: Agent<TContext, any>;
         toAgent: Agent<TContext, any>;
         context: TContext;
-    }) => void | Promise<void>;
+    }) => NotificationHookResult;
     /** Called before every tool execution */
     onToolStart?: (params: {
         agent: Agent<TContext, any>;
         toolName: string;
         context: TContext;
-    }) => void | Promise<void>;
+    }) => NotificationHookResult;
     /** Called after every tool execution */
     onToolEnd?: (params: {
         agent: Agent<TContext, any>;
         toolName: string;
         result: string;
         context: TContext;
-    }) => void | Promise<void>;
+    }) => NotificationHookResult;
     /** Called before every LLM API call */
     onLlmStart?: (params: {
         agent: Agent<TContext, any>;
         request: ModelRequest;
         context: TContext;
-    }) => void | Promise<void>;
+    }) => NotificationHookResult;
     /** Called after every LLM API call */
     onLlmEnd?: (params: {
         agent: Agent<TContext, any>;
@@ -149,6 +151,7 @@ export interface RunHooks<TContext = unknown> {
             toolCallCount: number;
         };
         context: TContext;
-    }) => void | Promise<void>;
+    }) => NotificationHookResult;
 }
+export {};
 //# sourceMappingURL=hooks.d.ts.map

package/dist/core/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/core/hooks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/core/hooks.ts"],"names":[],"mappings":"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"}

package/dist/core/index.d.ts

@@ -11,7 +11,10 @@ export { MemorySessionStore } from "./memory-store";
 export { tool, toolToDefinition } from "./tool";
 export type { FunctionTool, ToolExecuteOptions } from "./tool";
 export { McpClient } from "./mcp-client";
-export type { McpClientConfig, McpToolDefinition } from "./mcp-client";
+export { azureMcpHeaders } from "./mcp-client";
+export type { McpClientConfig, McpHeaders, McpToolDefinition, McpToolFilter } from "./mcp-client";
+export { LocalSandbox, SandboxAgent } from "./sandbox";
+export type { CommandResult, LocalSandboxOptions, SandboxAgentConfig, SandboxWorkspace, } from "./sandbox";
 export { isHostedTool, isFunctionTool } from "./hosted-tool";
 export type { HostedTool, AgentTool } from "./hosted-tool";
 export { webSearchTool, codeInterpreterTool, mcpTool, imageGenerationTool, fileSearchTool, computerUseTool, } from "./builtin-tools";
@@ -25,13 +28,15 @@ export type { Handoff, HandoffConfig, HandoffInputData, HandoffInputFilter } fro
 export { runInputGuardrails, runOutputGuardrails, runToolInputGuardrails, runToolOutputGuardrails, } from "./guardrails";
 export type { GuardrailResult, GuardrailRunResult, InputGuardrail, OutputGuardrail, ToolInputGuardrail, ToolOutputGuardrail, } from "./guardrails";
 export type { AgentHooks, RunHooks, ToolCallDecision, HandoffDecision, ToolMatcher, MatchedToolCallHook, MatchedAfterToolCallHook, BeforeToolCallHook, AfterToolCallHook, } from "./hooks";
-export { TraceContext, getCurrentTrace, withTrace } from "./tracing";
-export type { Span, Trace } from "./tracing";
+export { AzureMonitorTraceExporter, TraceContext, addTraceProcessor, clearTraceProcessors, createAzureMonitorTraceExporter, getCurrentTrace, setTraceProcessors, withTrace, } from "./tracing";
+export type { AzureMonitorTraceExporterConfig, Span, Trace, TraceProcessor } from "./tracing";
 export { createCostEstimator } from "./cost";
 export type { CostEstimator, PricingConfig } from "./cost";
 export type { FinishReason, Model, ModelRequest, ModelRequestOptions, ModelResponse, StreamEvent, UsageInfo, } from "./model";
 export type { ChatMessage, SystemMessage, DeveloperMessage, UserMessage, AssistantMessage, ToolMessage, ToolCall, ToolDefinition, HostedToolDefinition, ModelSettings, ReasoningEffort, ReasoningSummary, Truncation, ResponseFormat, ToolChoice, ToolUseBehavior, ContentPart, TextContentPart, ImageContentPart, AudioFormat, AudioVoice, AudioConfig, Modality, PredictedOutput, DataSource, ContextManagement, ContextManagementRule, } from "./types";
 export { StratusError, MaxTurnsExceededError, MaxBudgetExceededError, ModelError, ContentFilterError, OutputParseError, RunAbortedError, InputGuardrailTripwireTriggered, OutputGuardrailTripwireTriggered, ToolTimeoutError, } from "./errors";
+export { validateAgent } from "./validate-agent";
+export type { ValidationResult } from "./validate-agent";
 export { zodToJsonSchema } from "./utils/zod";
 export { createCodeModeTool, FunctionExecutor, WorkerExecutor, generateTypes, normalizeCode, sanitizeToolName, } from "./codemode/index";
 export type { CodeModeToolOptions, CodeModeOutput, Executor, ExecuteResult, FunctionExecutorOptions, WorkerExecutorOptions, } from "./codemode/index";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"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"}

package/dist/core/index.js

@@ -6,15 +6,18 @@ export { createSession, forkSession, loadSession, prompt, resumeSession, Session
 export { MemorySessionStore } from "./memory-store";
 export { tool, toolToDefinition } from "./tool";
 export { McpClient } from "./mcp-client";
+export { azureMcpHeaders } from "./mcp-client";
+export { LocalSandbox, SandboxAgent } from "./sandbox";
 export { isHostedTool, isFunctionTool } from "./hosted-tool";
 export { webSearchTool, codeInterpreterTool, mcpTool, imageGenerationTool, fileSearchTool, computerUseTool, } from "./builtin-tools";
 export { TodoList, todoTool } from "./todo";
 export { subagent, subagentToDefinition, subagentToTool } from "./subagent";
 export { handoff, handoffToDefinition } from "./handoff";
 export { runInputGuardrails, runOutputGuardrails, runToolInputGuardrails, runToolOutputGuardrails, } from "./guardrails";
-export { TraceContext, getCurrentTrace, withTrace } from "./tracing";
+export { AzureMonitorTraceExporter, TraceContext, addTraceProcessor, clearTraceProcessors, createAzureMonitorTraceExporter, getCurrentTrace, setTraceProcessors, withTrace, } from "./tracing";
 export { createCostEstimator } from "./cost";
 export { StratusError, MaxTurnsExceededError, MaxBudgetExceededError, ModelError, ContentFilterError, OutputParseError, RunAbortedError, InputGuardrailTripwireTriggered, OutputGuardrailTripwireTriggered, ToolTimeoutError, } from "./errors";
+export { validateAgent } from "./validate-agent";
 export { zodToJsonSchema } from "./utils/zod";
 export { createCodeModeTool, FunctionExecutor, WorkerExecutor, generateTypes, normalizeCode, sanitizeToolName, } from "./codemode/index";
 //# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGhC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE3D,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAe/C,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpG,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAGhD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG7D,OAAO,EACN,aAAa,EACb,mBAAmB,EACnB,OAAO,EACP,mBAAmB,EACnB,cAAc,EACd,eAAe,GACf,MAAM,iBAAiB,CAAC;AASzB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAG5C,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5E,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAGzD,OAAO,EACN,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,GACvB,MAAM,cAAc,CAAC;AAsBtB,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AA2C7C,OAAO,EACN,YAAY,EACZ,qBAAqB,EACrB,sBAAsB,EACtB,UAAU,EACV,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,+BAA+B,EAC/B,gCAAgC,EAChC,gBAAgB,GAChB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EACN,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,aAAa,EACb,gBAAgB,GAChB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGhC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE3D,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAe/C,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpG,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAGhD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG/C,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAQvD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG7D,OAAO,EACN,aAAa,EACb,mBAAmB,EACnB,OAAO,EACP,mBAAmB,EACnB,cAAc,EACd,eAAe,GACf,MAAM,iBAAiB,CAAC;AASzB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAG5C,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5E,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAGzD,OAAO,EACN,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,GACvB,MAAM,cAAc,CAAC;AAsBtB,OAAO,EACN,yBAAyB,EACzB,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACpB,+BAA+B,EAC/B,eAAe,EACf,kBAAkB,EAClB,SAAS,GACT,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AA2C7C,OAAO,EACN,YAAY,EACZ,qBAAqB,EACrB,sBAAsB,EACtB,UAAU,EACV,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,+BAA+B,EAC/B,gCAAgC,EAChC,gBAAgB,GAChB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EACN,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,aAAa,EACb,gBAAgB,GAChB,MAAM,kBAAkB,CAAC"}

package/dist/core/mcp-client.d.ts

@@ -1,57 +1,67 @@
 import type { FunctionTool } from "./tool";
+export type McpToolFilter = string[] | ((tool: McpToolDefinition) => boolean | Promise<boolean>);
+export type McpHeaders = Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>);
 export interface McpClientConfig {
-    /** Command to spawn the MCP server process */
-    command: string;
-    /** Arguments for the command */
+    /** Transport. Defaults to stdio when command is provided, otherwise streamable-http. */
+    transport?: "stdio" | "streamable-http";
+    /** Command to spawn for stdio MCP servers. */
+    command?: string;
+    /** Arguments for the stdio command. */
     args?: string[];
-    /** Environment variables for the process */
+    /** Environment variables for the stdio process. */
     env?: Record<string, string>;
-    /** Working directory */
+    /** Working directory for the stdio process. */
     cwd?: string;
+    /** Streamable HTTP MCP endpoint. */
+    url?: string;
+    /** Static or async headers for HTTP MCP servers. Use this for Entra tokens or API keys. */
+    headers?: McpHeaders;
+    /** Cache tools/list results after the first call. */
+    cacheToolsList?: boolean;
+    /** Filter discovered tools before exposing them to an agent. */
+    toolFilter?: McpToolFilter;
+    /** Prefix exposed tool names, useful when multiple MCP servers have overlapping names. */
+    namePrefix?: string;
+    /** JSON-RPC request timeout in milliseconds. Defaults to 30 seconds. */
+    requestTimeoutMs?: number;
 }
 export interface McpToolDefinition {
     name: string;
     description?: string;
     inputSchema?: Record<string, unknown>;
 }
+export declare function azureMcpHeaders(tokenProvider: () => Promise<string>, extraHeaders?: Record<string, string>): () => Promise<Record<string, string>>;
 /**
- * Local MCP client that connects to MCP servers via stdio transport.
- * Discovers tools and wraps them as FunctionTool instances for use with Stratus agents.
- *
- * Usage:
- * ```ts
- * const client = new McpClient({ command: "npx", args: ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"] });
- * await client.connect();
- * const tools = await client.getTools();
- * const agent = new Agent({ tools });
- * // ...
- * await client.disconnect();
- * ```
+ * MCP client for local stdio servers and Streamable HTTP servers.
+ * Discovers MCP tools and wraps them as Stratus FunctionTool instances.
  */
 export declare class McpClient {
     private process;
     private buffer;
     private pendingRequests;
     private nextId;
+    private cachedTools;
     private readonly config;
+    private readonly transport;
+    private connected;
     constructor(config: McpClientConfig);
-    /** Connect to the MCP server and perform the initialize handshake. */
     connect(): Promise<void>;
-    /** Discover tools exposed by the MCP server. */
-    listTools(): Promise<McpToolDefinition[]>;
-    /** Call a tool on the MCP server and return concatenated text content. */
+    listTools(options?: {
+        refresh?: boolean;
+    }): Promise<McpToolDefinition[]>;
     callTool(name: string, args: Record<string, unknown>): Promise<string>;
-    /**
-     * Discover MCP tools and return them as Stratus FunctionTool instances.
-     * Each returned tool proxies execution to the MCP server via `tools/call`.
-     */
-    getTools<TContext = unknown>(): Promise<FunctionTool<any, TContext>[]>;
-    /** Disconnect from the MCP server and clean up. */
+    getTools<TContext = unknown>(): Promise<FunctionTool<Record<string, unknown>, TContext>[]>;
     disconnect(): Promise<void>;
     [Symbol.asyncDispose](): Promise<void>;
+    private connectStdio;
     private assertConnected;
+    private applyToolFilter;
+    private withPrefix;
+    private stripPrefix;
     private processBuffer;
     private sendRequest;
     private sendNotification;
+    private sendHttpRequest;
+    private parseHttpResponse;
 }
 //# sourceMappingURL=mcp-client.d.ts.map

package/dist/core/mcp-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-client.d.ts","sourceRoot":"","sources":["../../src/core/mcp-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAE3C,MAAM,WAAW,eAAe;IAC/B,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,4CAA4C;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAOD;;;;;;;;;;;;;GAaG;AACH,qBAAa,SAAS;IACrB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,eAAe,CAAqC;IAC5D,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;gBAE7B,MAAM,EAAE,eAAe;IAInC,sEAAsE;IAChE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAyC9B,gDAAgD;IAC1C,SAAS,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAQ/C,0EAA0E;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAa5E;;;OAGG;IACG,QAAQ,CAAC,QAAQ,GAAG,OAAO,KAAK,OAAO,CAAC,YAAY,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,CAAC;IAgB5E,mDAAmD;IAC7C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5C,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,aAAa;IAgDrB,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,gBAAgB;CAMxB"}
+{"version":3,"file":"mcp-client.d.ts","sourceRoot":"","sources":["../../src/core/mcp-client.ts"],"names":[],"mappings":"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"}