@voltagent/core 1.1.13 → 1.1.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.mts CHANGED
@@ -18,6 +18,7 @@ import * as TF from 'type-fest';
18
18
  import { EventEmitter } from 'node:events';
19
19
  import { A2AServerLike, A2AServerDeps, A2AServerMetadata, A2AServerFactory } from '@voltagent/internal/a2a';
20
20
  import { MCPServerLike, MCPServerDeps, MCPServerMetadata, MCPServerFactory } from '@voltagent/internal/mcp';
21
+ import { ClientCapabilities } from '@modelcontextprotocol/sdk/types.js';
21
22
 
22
23
  /**
23
24
  * Represents a collection of related tools with optional shared instructions.
@@ -3986,11 +3987,11 @@ interface WorkflowStreamEvent {
3986
3987
  /**
3987
3988
  * Input data for the step/event
3988
3989
  */
3989
- input?: Record<string, DangerouslyAllowAny>;
3990
+ input?: DangerouslyAllowAny;
3990
3991
  /**
3991
3992
  * Output data from the step/event
3992
3993
  */
3993
- output?: Record<string, DangerouslyAllowAny>;
3994
+ output?: DangerouslyAllowAny;
3994
3995
  /**
3995
3996
  * Current status of the step/event
3996
3997
  */
@@ -5792,6 +5793,431 @@ declare class MCPServerRegistry<TServer extends MCPServerLike = MCPServerLike> {
5792
5793
  private createAnonymousSlug;
5793
5794
  }
5794
5795
 
5796
+ /**
5797
+ * Client information for MCP
5798
+ */
5799
+ interface ClientInfo {
5800
+ /**
5801
+ * Client name
5802
+ */
5803
+ name: string;
5804
+ /**
5805
+ * Client version
5806
+ */
5807
+ version: string;
5808
+ /**
5809
+ * Allow additional properties for SDK compatibility
5810
+ */
5811
+ [key: string]: unknown;
5812
+ }
5813
+ /**
5814
+ * Transport error from MCP
5815
+ */
5816
+ interface TransportError extends Error {
5817
+ /**
5818
+ * Error code
5819
+ */
5820
+ code?: string;
5821
+ /**
5822
+ * Error details
5823
+ */
5824
+ details?: unknown;
5825
+ }
5826
+ /**
5827
+ * Configuration for MCP client
5828
+ */
5829
+ type MCPClientConfig = {
5830
+ /**
5831
+ * Client information
5832
+ */
5833
+ clientInfo: ClientInfo;
5834
+ /**
5835
+ * MCP server configuration
5836
+ */
5837
+ server: MCPServerConfig;
5838
+ /**
5839
+ * MCP capabilities
5840
+ */
5841
+ capabilities?: ClientCapabilities;
5842
+ /**
5843
+ * Timeout in milliseconds for MCP requests
5844
+ * @default 30000
5845
+ */
5846
+ timeout?: number;
5847
+ };
5848
+ /**
5849
+ * MCP server configuration options
5850
+ */
5851
+ type MCPServerConfig = HTTPServerConfig | SSEServerConfig | StreamableHTTPServerConfig | StdioServerConfig;
5852
+ /**
5853
+ * HTTP-based MCP server configuration with automatic fallback
5854
+ * Tries streamable HTTP first, falls back to SSE if not supported
5855
+ */
5856
+ type HTTPServerConfig = {
5857
+ /**
5858
+ * Type of server connection
5859
+ */
5860
+ type: "http";
5861
+ /**
5862
+ * URL of the MCP server
5863
+ */
5864
+ url: string;
5865
+ /**
5866
+ * Request initialization options
5867
+ */
5868
+ requestInit?: RequestInit;
5869
+ /**
5870
+ * Event source initialization options (used for SSE fallback)
5871
+ */
5872
+ eventSourceInit?: EventSourceInit;
5873
+ /**
5874
+ * Optional maximum request timeout in milliseconds.
5875
+ * If provided, passed to MCPClient as the per-request timeout.
5876
+ */
5877
+ timeout?: number;
5878
+ };
5879
+ /**
5880
+ * SSE-based MCP server configuration (explicit SSE transport)
5881
+ */
5882
+ type SSEServerConfig = {
5883
+ /**
5884
+ * Type of server connection
5885
+ */
5886
+ type: "sse";
5887
+ /**
5888
+ * URL of the MCP server
5889
+ */
5890
+ url: string;
5891
+ /**
5892
+ * Request initialization options
5893
+ */
5894
+ requestInit?: RequestInit;
5895
+ /**
5896
+ * Event source initialization options
5897
+ */
5898
+ eventSourceInit?: EventSourceInit;
5899
+ /**
5900
+ * Optional maximum request timeout in milliseconds.
5901
+ * If provided, passed to MCPClient as the per-request timeout.
5902
+ */
5903
+ timeout?: number;
5904
+ };
5905
+ /**
5906
+ * Streamable HTTP-based MCP server configuration (no fallback)
5907
+ */
5908
+ type StreamableHTTPServerConfig = {
5909
+ /**
5910
+ * Type of server connection
5911
+ */
5912
+ type: "streamable-http";
5913
+ /**
5914
+ * URL of the MCP server
5915
+ */
5916
+ url: string;
5917
+ /**
5918
+ * Request initialization options
5919
+ */
5920
+ requestInit?: RequestInit;
5921
+ /**
5922
+ * Session ID for the connection
5923
+ */
5924
+ sessionId?: string;
5925
+ /**
5926
+ * Optional maximum request timeout in milliseconds.
5927
+ * If provided, passed to MCPClient as the per-request timeout.
5928
+ */
5929
+ timeout?: number;
5930
+ };
5931
+ /**
5932
+ * Stdio-based MCP server configuration
5933
+ */
5934
+ type StdioServerConfig = {
5935
+ /**
5936
+ * Type of server connection
5937
+ */
5938
+ type: "stdio";
5939
+ /**
5940
+ * Command to run the MCP server
5941
+ */
5942
+ command: string;
5943
+ /**
5944
+ * Arguments to pass to the command
5945
+ */
5946
+ args?: string[];
5947
+ /**
5948
+ * Environment variables for the MCP server process
5949
+ */
5950
+ env?: Record<string, string>;
5951
+ /**
5952
+ * Working directory for the MCP server process
5953
+ */
5954
+ cwd?: string;
5955
+ /**
5956
+ * Optional maximum request timeout in milliseconds.
5957
+ * If provided, passed to MCPClient as the per-request timeout.
5958
+ */
5959
+ timeout?: number;
5960
+ };
5961
+ /**
5962
+ * Tool call request
5963
+ */
5964
+ type MCPToolCall = {
5965
+ /**
5966
+ * Name of the tool to call
5967
+ */
5968
+ name: string;
5969
+ /**
5970
+ * Arguments to pass to the tool
5971
+ */
5972
+ arguments: Record<string, unknown>;
5973
+ };
5974
+ /**
5975
+ * Tool call result
5976
+ */
5977
+ type MCPToolResult = {
5978
+ /**
5979
+ * Result content from the tool
5980
+ */
5981
+ content: unknown;
5982
+ };
5983
+ /**
5984
+ * MCP client events
5985
+ */
5986
+ interface MCPClientEvents {
5987
+ /**
5988
+ * Emitted when the client connects to the server
5989
+ */
5990
+ connect: () => void;
5991
+ /**
5992
+ * Emitted when the client disconnects from the server
5993
+ */
5994
+ disconnect: () => void;
5995
+ /**
5996
+ * Emitted when an error occurs
5997
+ */
5998
+ error: (error: Error | TransportError) => void;
5999
+ /**
6000
+ * Emitted when a tool call completes
6001
+ */
6002
+ toolCall: (name: string, args: Record<string, unknown>, result: unknown) => void;
6003
+ }
6004
+ /**
6005
+ * A record of tools along with a helper method to convert them to an array.
6006
+ */
6007
+ type ToolsetWithTools = Record<string, AnyToolConfig> & {
6008
+ /**
6009
+ * Converts the toolset to an array of BaseTool objects.
6010
+ */
6011
+ getTools: () => Tool<any>[];
6012
+ };
6013
+ /**
6014
+ * Any tool configuration
6015
+ */
6016
+ type AnyToolConfig = Tool<any>;
6017
+
6018
+ /**
6019
+ * Client for interacting with Model Context Protocol (MCP) servers.
6020
+ * Wraps the official MCP SDK client to provide a higher-level interface.
6021
+ * Internal implementation differs from original source.
6022
+ */
6023
+ declare class MCPClient extends EventEmitter {
6024
+ /**
6025
+ * Underlying MCP client instance from the SDK.
6026
+ */
6027
+ private client;
6028
+ /**
6029
+ * Communication channel (transport layer) for MCP interactions.
6030
+ */
6031
+ private transport;
6032
+ /**
6033
+ * Tracks the connection status to the server.
6034
+ */
6035
+ private connected;
6036
+ /**
6037
+ * Maximum time allowed for requests in milliseconds.
6038
+ */
6039
+ private readonly timeout;
6040
+ /**
6041
+ * Logger instance
6042
+ */
6043
+ private logger;
6044
+ /**
6045
+ * Information identifying this client to the server.
6046
+ */
6047
+ private readonly clientInfo;
6048
+ /**
6049
+ * Server configuration for fallback attempts.
6050
+ */
6051
+ private readonly serverConfig;
6052
+ /**
6053
+ * Whether to attempt SSE fallback if streamable HTTP fails.
6054
+ */
6055
+ private shouldAttemptFallback;
6056
+ /**
6057
+ * Client capabilities for re-initialization.
6058
+ */
6059
+ private readonly capabilities;
6060
+ /**
6061
+ * Get server info for logging
6062
+ */
6063
+ private getServerInfo;
6064
+ /**
6065
+ * Creates a new MCP client instance.
6066
+ * @param config Configuration for the client, including server details and client identity.
6067
+ */
6068
+ constructor(config: MCPClientConfig);
6069
+ /**
6070
+ * Sets up handlers for events from the underlying SDK client.
6071
+ */
6072
+ private setupEventHandlers;
6073
+ /**
6074
+ * Establishes a connection to the configured MCP server.
6075
+ * Idempotent: does nothing if already connected.
6076
+ */
6077
+ connect(): Promise<void>;
6078
+ /**
6079
+ * Attempts to connect using SSE transport as a fallback.
6080
+ * @param originalError The error from the initial connection attempt.
6081
+ */
6082
+ private attemptSSEFallback;
6083
+ /**
6084
+ * Closes the connection to the MCP server.
6085
+ * Idempotent: does nothing if not connected.
6086
+ */
6087
+ disconnect(): Promise<void>;
6088
+ /**
6089
+ * Fetches the definitions of available tools from the server.
6090
+ * @returns A record mapping tool names to their definitions (schema, description).
6091
+ */
6092
+ listTools(): Promise<Record<string, unknown>>;
6093
+ /**
6094
+ * Builds executable Tool objects from the server's tool definitions.
6095
+ * These tools include an `execute` method for calling the remote tool.
6096
+ * @returns A record mapping namespaced tool names (`clientName_toolName`) to executable Tool objects.
6097
+ */
6098
+ getAgentTools(): Promise<Record<string, Tool<any>>>;
6099
+ /**
6100
+ * Executes a specified tool on the remote MCP server.
6101
+ * @param toolCall Details of the tool to call, including name and arguments.
6102
+ * @returns The result content returned by the tool.
6103
+ */
6104
+ callTool(toolCall: MCPToolCall): Promise<MCPToolResult>;
6105
+ /**
6106
+ * Retrieves a list of resource identifiers available on the server.
6107
+ * @returns A promise resolving to an array of resource ID strings.
6108
+ */
6109
+ listResources(): Promise<string[]>;
6110
+ /**
6111
+ * Ensures the client is connected before proceeding with an operation.
6112
+ * Attempts to connect if not currently connected.
6113
+ * @throws Error if connection attempt fails.
6114
+ */
6115
+ private ensureConnected;
6116
+ /**
6117
+ * Emits an 'error' event, ensuring the payload is always an Error object.
6118
+ * @param error The error encountered, can be of any type.
6119
+ */
6120
+ private emitError;
6121
+ /**
6122
+ * Type guard to check if a server configuration is for an HTTP server.
6123
+ * @param server The server configuration object.
6124
+ * @returns True if the configuration type is 'http', false otherwise.
6125
+ */
6126
+ private isHTTPServer;
6127
+ /**
6128
+ * Type guard to check if a server configuration is for an SSE server.
6129
+ * @param server The server configuration object.
6130
+ * @returns True if the configuration type is 'sse', false otherwise.
6131
+ */
6132
+ private isSSEServer;
6133
+ /**
6134
+ * Type guard to check if a server configuration is for a Streamable HTTP server.
6135
+ * @param server The server configuration object.
6136
+ * @returns True if the configuration type is 'streamable-http', false otherwise.
6137
+ */
6138
+ private isStreamableHTTPServer;
6139
+ /**
6140
+ * Type guard to check if a server configuration is for a Stdio server.
6141
+ * @param server The server configuration object.
6142
+ * @returns True if the configuration type is 'stdio', false otherwise.
6143
+ */
6144
+ private isStdioServer;
6145
+ /**
6146
+ * Overrides EventEmitter's 'on' method for type-safe event listening.
6147
+ * Uses the original `MCPClientEvents` for event types.
6148
+ */
6149
+ on<E extends keyof MCPClientEvents>(event: E, listener: MCPClientEvents[E]): this;
6150
+ /**
6151
+ * Overrides EventEmitter's 'emit' method for type-safe event emission.
6152
+ * Uses the original `MCPClientEvents` for event types.
6153
+ */
6154
+ emit<E extends keyof MCPClientEvents>(event: E, ...args: Parameters<MCPClientEvents[E]>): boolean;
6155
+ }
6156
+
6157
+ /**
6158
+ * Configuration manager for Model Context Protocol (MCP).
6159
+ * Handles multiple MCP server connections and tool management.
6160
+ * NOTE: This version does NOT manage singleton instances automatically.
6161
+ */
6162
+ declare class MCPConfiguration<TServerKeys extends string = string> {
6163
+ /**
6164
+ * Map of server configurations keyed by server names.
6165
+ */
6166
+ private readonly serverConfigs;
6167
+ /**
6168
+ * Map of connected MCP clients keyed by server names (local cache).
6169
+ */
6170
+ private readonly mcpClientsById;
6171
+ /**
6172
+ * Creates a new, independent MCP configuration instance.
6173
+ * @param options Configuration options including server definitions.
6174
+ */
6175
+ constructor(options: {
6176
+ servers: Record<TServerKeys, MCPServerConfig>;
6177
+ });
6178
+ /**
6179
+ * Type guard to check if an object conforms to the basic structure of AnyToolConfig.
6180
+ */
6181
+ private isAnyToolConfigStructure;
6182
+ /**
6183
+ * Disconnects all associated MCP clients for THIS instance.
6184
+ */
6185
+ disconnect(): Promise<void>;
6186
+ /**
6187
+ * Retrieves agent-ready tools from all configured MCP servers for this instance.
6188
+ * @returns A flat array of all agent-ready tools.
6189
+ */
6190
+ getTools(): Promise<Tool<any>[]>;
6191
+ /**
6192
+ * Retrieves raw tool definitions from all configured MCP servers for this instance.
6193
+ * @returns A flat record of all raw tools keyed by their namespaced name.
6194
+ */
6195
+ getRawTools(): Promise<Record<string, AnyToolConfig>>;
6196
+ /**
6197
+ * Retrieves agent-ready toolsets grouped by server name for this instance.
6198
+ * @returns A record where keys are server names and values are agent-ready toolsets.
6199
+ */
6200
+ getToolsets(): Promise<Record<TServerKeys, ToolsetWithTools>>;
6201
+ /**
6202
+ * Retrieves raw tool definitions grouped by server name for this instance.
6203
+ * @returns A record where keys are server names and values are records of raw tools.
6204
+ */
6205
+ getRawToolsets(): Promise<Record<TServerKeys, Record<string, AnyToolConfig>>>;
6206
+ /**
6207
+ * Retrieves a specific connected MCP client by its server name for this instance.
6208
+ */
6209
+ getClient(serverName: TServerKeys): Promise<MCPClient | undefined>;
6210
+ /**
6211
+ * Retrieves all configured MCP clients for this instance, ensuring they are connected.
6212
+ */
6213
+ getClients(): Promise<Record<TServerKeys, MCPClient>>;
6214
+ /**
6215
+ * Internal helper to get/create/connect a client for this instance.
6216
+ * Manages the local mcpClientsById cache.
6217
+ */
6218
+ private getConnectedClient;
6219
+ }
6220
+
5795
6221
  /**
5796
6222
  * Basic type definitions for VoltAgent Core
5797
6223
  */
@@ -6614,4 +7040,4 @@ declare class VoltAgent {
6614
7040
  */
6615
7041
  declare function convertUsage(usage: LanguageModelUsage | undefined): UsageInfo | undefined;
6616
7042
 
6617
- export { A2AServerRegistry, AbortError, Agent, type AgentFullState, type AgentHookOnEnd, type AgentHookOnError, type AgentHookOnHandoff, type AgentHookOnPrepareMessages, type AgentHookOnStart, type AgentHookOnStepFinish, type AgentHookOnToolEnd, type AgentHookOnToolStart, type AgentHooks, type AgentOptions, AgentRegistry, type AgentResponse, type AgentStatus, type AgentTool, AiSdkEmbeddingAdapter, type AllowedVariableValue, type ApiToolInfo, type BaseEventMetadata, type BaseGenerationOptions, type BaseLLMOptions, type BaseMessage, BaseRetriever, type BaseTool, type BaseToolCall, type CachedPrompt, type ChatMessage, type Conversation, ConversationAlreadyExistsError, ConversationNotFoundError, type ConversationQueryOptions, type ConversationQueryOptions as ConversationQueryOptionsV2, type Conversation as ConversationV2, type CreateConversationInput, type CreateConversationInput as CreateConversationInputV2, type CreateReasoningToolsOptions, DEFAULT_INSTRUCTIONS, type DataContent, type Document, type DynamicValue, type DynamicValueOptions, type EmbeddingAdapter$1 as EmbeddingAdapter, EmbeddingAdapterNotConfiguredError, EmbeddingError, type ExtractVariableNames, FEW_SHOT_EXAMPLES, type GenerateObjectOptions, type GenerateObjectSubAgentConfig, type GenerateTextOptions, type GenerateTextSubAgentConfig, type GetMessagesOptions, type IServerProvider, type VoltOpsClient$1 as IVoltOpsClient, InMemoryStorageAdapter$1 as InMemoryObservabilityAdapter, InMemoryStorageAdapter, InMemoryVectorAdapter, type InferGenerateObjectResponse, type InferGenerateTextResponse, type InferMessage, type InferModel, type InferProviderParams, type InferStreamResponse, type InferTool, type LLMProvider, LocalStorageSpanProcessor, type LogFilter, LoggerProxy, type MCPElicitationAdapter, type MCPLoggingAdapter, type MCPPromptsAdapter, type MCPResourcesAdapter, MCPServerRegistry, Memory, type MemoryConfig, type MemoryOptions, Memory as MemoryV2, MemoryV2Error, type MessageContent, MessageContentBuilder, type MessageRole, type ModelToolCall, NextAction, NodeType, type ObservabilityLogRecord, type ObservabilitySpan, type ObservabilityStorageAdapter, type ObservabilityWebSocketEvent, type OnEndHookArgs, type OnErrorHookArgs, type OnHandoffHookArgs, type OnPrepareMessagesHookArgs, type OnPrepareMessagesHookResult, type OnStartHookArgs, type OnStepFinishHookArgs, type OnToolEndHookArgs, type OnToolStartHookArgs, type OperationContext, type PackageUpdateInfo, type PromptApiClient, type PromptApiResponse, type PromptContent, type PromptCreator, type PromptHelper, type PromptReference, type PromptTemplate, type ProviderObjectResponse, type ProviderObjectStreamResponse, type ProviderParams, type ProviderResponse, type ProviderTextResponse, type ProviderTextStreamResponse, type ReadableStreamType, type ReasoningStep, ReasoningStepSchema, type RegisterOptions, type RegisteredWorkflow, type RetrieveOptions, type Retriever, type RetrieverOptions, type SearchOptions, type SearchResult, type ServerAgentResponse, type ServerApiResponse, type ServerProviderDeps, type ServerProviderFactory, type ServerWorkflowResponse, type SpanAttributes, type SpanEvent, SpanKind, type SpanLink, type SpanStatus, SpanStatusCode, type SpanTreeNode, type StepChunkCallback, type StepFinishCallback, type StepWithContent, type StopWhen, type StorageAdapter, StorageError, type StoredUIMessage, type StreamObjectFinishResult, type StreamObjectOnFinishCallback, type StreamObjectOptions, type StreamObjectSubAgentConfig, type StreamPart, type StreamTextFinishResult, type StreamTextOnFinishCallback, type StreamTextOptions, type StreamTextSubAgentConfig, type SubAgentConfig, type SubAgentMethod, type SubAgentStateData, type SupervisorConfig, type TemplateVariables, type TimelineEventCoreLevel, type TimelineEventCoreStatus, type TimelineEventCoreType, Tool, type ToolCall, type ToolErrorInfo, type ToolExecuteOptions, ToolManager, type ToolOptions, type ToolSchema, type ToolStatus, type ToolStatusInfo, type ToolWithNodeId, type Toolkit, type Usage, type UsageInfo, type VectorAdapter, VectorAdapterNotConfiguredError, VectorError, type VectorItem, type VectorSearchOptions, type Voice, type VoiceEventData, type VoiceEventType, type VoiceMetadata, type VoiceOptions, VoltAgent, VoltAgentError, VoltAgentObservability, type VoltAgentOptions, type VoltAgentStreamTextResult, type VoltAgentTextStreamPart, VoltOpsClient, type VoltOpsClientOptions, VoltOpsPromptApiClient, type VoltOpsPromptManager, VoltOpsPromptManagerImpl, WebSocketEventEmitter, WebSocketLogProcessor, WebSocketSpanProcessor, type Workflow, type WorkflowConfig, type WorkflowExecutionContext, WorkflowRegistry, type WorkflowStateEntry, type WorkflowStats, type WorkflowStepContext, type WorkflowStepType, type WorkflowTimelineEvent, type WorkingMemoryConfig, type WorkingMemoryScope, addTimestampToMessage, andAgent, andAll, andRace, andTap, andThen, andWhen, andWorkflow, appendToMessage, buildRetrieverLogMessage, buildSpanTree, checkForUpdates, convertUsage, cosineSimilarity, createHooks, createNodeId, createPrompt, createReasoningTools, createRetrieverTool, createSimpleTemplateEngine, createSubagent, createSuspendController, createTool, createToolkit, createVoltOpsClient, createWorkflow, createWorkflowChain, createWorkflowStepNodeId, VoltAgent as default, extractFileParts, extractImageParts, extractText, extractTextParts, extractWorkflowStepInfo, filterContentParts, getContentLength, getGlobalLogBuffer, getGlobalLogger, getNodeTypeFromNodeId, getWorkflowStepNodeType, hasContent, hasFilePart, hasImagePart, hasTextPart, isAbortError, isStructuredContent, isTextContent, isVoltAgentError, mapMessageContent, messageHelpers, normalizeContent, normalizeToArray, prependToMessage, readableSpanToObservabilitySpan, safeJsonParse, serializeValueForDebug, tool, transformTextContent, updateAllPackages, updateSinglePackage, zodSchemaToJsonUI };
7043
+ export { A2AServerRegistry, AbortError, Agent, type AgentFullState, type AgentHookOnEnd, type AgentHookOnError, type AgentHookOnHandoff, type AgentHookOnPrepareMessages, type AgentHookOnStart, type AgentHookOnStepFinish, type AgentHookOnToolEnd, type AgentHookOnToolStart, type AgentHooks, type AgentOptions, AgentRegistry, type AgentResponse, type AgentStatus, type AgentTool, AiSdkEmbeddingAdapter, type AllowedVariableValue, type ApiToolInfo, type BaseEventMetadata, type BaseGenerationOptions, type BaseLLMOptions, type BaseMessage, BaseRetriever, type BaseTool, type BaseToolCall, type CachedPrompt, type ChatMessage, type Conversation, ConversationAlreadyExistsError, ConversationNotFoundError, type ConversationQueryOptions, type ConversationQueryOptions as ConversationQueryOptionsV2, type Conversation as ConversationV2, type CreateConversationInput, type CreateConversationInput as CreateConversationInputV2, type CreateReasoningToolsOptions, DEFAULT_INSTRUCTIONS, type DataContent, type Document, type DynamicValue, type DynamicValueOptions, type EmbeddingAdapter$1 as EmbeddingAdapter, EmbeddingAdapterNotConfiguredError, EmbeddingError, type ExtractVariableNames, FEW_SHOT_EXAMPLES, type GenerateObjectOptions, type GenerateObjectSubAgentConfig, type GenerateTextOptions, type GenerateTextSubAgentConfig, type GetMessagesOptions, type IServerProvider, type VoltOpsClient$1 as IVoltOpsClient, InMemoryStorageAdapter$1 as InMemoryObservabilityAdapter, InMemoryStorageAdapter, InMemoryVectorAdapter, type InferGenerateObjectResponse, type InferGenerateTextResponse, type InferMessage, type InferModel, type InferProviderParams, type InferStreamResponse, type InferTool, type LLMProvider, LocalStorageSpanProcessor, type LogFilter, LoggerProxy, MCPConfiguration, type MCPElicitationAdapter, type MCPLoggingAdapter, type MCPPromptsAdapter, type MCPResourcesAdapter, MCPServerRegistry, Memory, type MemoryConfig, type MemoryOptions, Memory as MemoryV2, MemoryV2Error, type MessageContent, MessageContentBuilder, type MessageRole, type ModelToolCall, NextAction, NodeType, type ObservabilityLogRecord, type ObservabilitySpan, type ObservabilityStorageAdapter, type ObservabilityWebSocketEvent, type OnEndHookArgs, type OnErrorHookArgs, type OnHandoffHookArgs, type OnPrepareMessagesHookArgs, type OnPrepareMessagesHookResult, type OnStartHookArgs, type OnStepFinishHookArgs, type OnToolEndHookArgs, type OnToolStartHookArgs, type OperationContext, type PackageUpdateInfo, type PromptApiClient, type PromptApiResponse, type PromptContent, type PromptCreator, type PromptHelper, type PromptReference, type PromptTemplate, type ProviderObjectResponse, type ProviderObjectStreamResponse, type ProviderParams, type ProviderResponse, type ProviderTextResponse, type ProviderTextStreamResponse, type ReadableStreamType, type ReasoningStep, ReasoningStepSchema, type RegisterOptions, type RegisteredWorkflow, type RetrieveOptions, type Retriever, type RetrieverOptions, type SearchOptions, type SearchResult, type ServerAgentResponse, type ServerApiResponse, type ServerProviderDeps, type ServerProviderFactory, type ServerWorkflowResponse, type SpanAttributes, type SpanEvent, SpanKind, type SpanLink, type SpanStatus, SpanStatusCode, type SpanTreeNode, type StepChunkCallback, type StepFinishCallback, type StepWithContent, type StopWhen, type StorageAdapter, StorageError, type StoredUIMessage, type StreamObjectFinishResult, type StreamObjectOnFinishCallback, type StreamObjectOptions, type StreamObjectSubAgentConfig, type StreamPart, type StreamTextFinishResult, type StreamTextOnFinishCallback, type StreamTextOptions, type StreamTextSubAgentConfig, type SubAgentConfig, type SubAgentMethod, type SubAgentStateData, type SupervisorConfig, type TemplateVariables, type TimelineEventCoreLevel, type TimelineEventCoreStatus, type TimelineEventCoreType, Tool, type ToolCall, type ToolErrorInfo, type ToolExecuteOptions, ToolManager, type ToolOptions, type ToolSchema, type ToolStatus, type ToolStatusInfo, type ToolWithNodeId, type Toolkit, type Usage, type UsageInfo, type VectorAdapter, VectorAdapterNotConfiguredError, VectorError, type VectorItem, type VectorSearchOptions, type Voice, type VoiceEventData, type VoiceEventType, type VoiceMetadata, type VoiceOptions, VoltAgent, VoltAgentError, VoltAgentObservability, type VoltAgentOptions, type VoltAgentStreamTextResult, type VoltAgentTextStreamPart, VoltOpsClient, type VoltOpsClientOptions, VoltOpsPromptApiClient, type VoltOpsPromptManager, VoltOpsPromptManagerImpl, WebSocketEventEmitter, WebSocketLogProcessor, WebSocketSpanProcessor, type Workflow, type WorkflowConfig, type WorkflowExecutionContext, WorkflowRegistry, type WorkflowStateEntry, type WorkflowStats, type WorkflowStepContext, type WorkflowStepType, type WorkflowTimelineEvent, type WorkingMemoryConfig, type WorkingMemoryScope, addTimestampToMessage, andAgent, andAll, andRace, andTap, andThen, andWhen, andWorkflow, appendToMessage, buildRetrieverLogMessage, buildSpanTree, checkForUpdates, convertUsage, cosineSimilarity, createHooks, createNodeId, createPrompt, createReasoningTools, createRetrieverTool, createSimpleTemplateEngine, createSubagent, createSuspendController, createTool, createToolkit, createVoltOpsClient, createWorkflow, createWorkflowChain, createWorkflowStepNodeId, VoltAgent as default, extractFileParts, extractImageParts, extractText, extractTextParts, extractWorkflowStepInfo, filterContentParts, getContentLength, getGlobalLogBuffer, getGlobalLogger, getNodeTypeFromNodeId, getWorkflowStepNodeType, hasContent, hasFilePart, hasImagePart, hasTextPart, isAbortError, isStructuredContent, isTextContent, isVoltAgentError, mapMessageContent, messageHelpers, normalizeContent, normalizeToArray, prependToMessage, readableSpanToObservabilitySpan, safeJsonParse, serializeValueForDebug, tool, transformTextContent, updateAllPackages, updateSinglePackage, zodSchemaToJsonUI };