@voltagent/core 1.2.21 → 1.4.0

package/dist/index.d.mts

@@ -16,7 +16,7 @@ import { DangerouslyAllowAny, PlainObject } from '@voltagent/internal/types';
 import * as TF from 'type-fest';
 import { A2AServerLike, A2AServerDeps, A2AServerMetadata, A2AServerFactory } from '@voltagent/internal/a2a';
 import { MCPServerLike, MCPServerDeps, MCPServerMetadata, MCPServerFactory } from '@voltagent/internal/mcp';
-import { ClientCapabilities } from '@modelcontextprotocol/sdk/types.js';
+import { ElicitRequest, ElicitResult, ClientCapabilities } from '@modelcontextprotocol/sdk/types.js';
 
 /**
  * Represents a collection of related tools with optional shared instructions.
@@ -8407,6 +8407,235 @@ declare class MCPServerRegistry<TServer extends MCPServerLike = MCPServerLike> {
     private createAnonymousSlug;
 }
 
+/**
+ * The action being authorized.
+ * - "discovery": Tool is being listed/discovered (getTools/getToolsets)
+ * - "execution": Tool is being executed (callTool)
+ */
+type MCPAuthorizationAction = "discovery" | "execution";
+/**
+ * Minimal context for tool discovery authorization.
+ * Used when full OperationContext is not available (e.g., during getTools).
+ */
+interface MCPAuthorizationContext {
+    /** User identifier */
+    userId?: string;
+    /** User-defined context map (same as OperationContext.context) */
+    context?: Map<string | symbol, unknown> | Record<string, unknown>;
+}
+/**
+ * Parameters passed to the `can` authorization function.
+ */
+interface MCPCanParams {
+    /** Tool name (without server prefix) */
+    toolName: string;
+    /** Server/resource identifier */
+    serverName: string;
+    /** The action being authorized: "discovery" or "execution" */
+    action: MCPAuthorizationAction;
+    /** Tool arguments (for attribute-based access control) */
+    arguments?: Record<string, unknown>;
+    /** User identifier */
+    userId?: string;
+    /** User-defined context (from authContext or OperationContext) */
+    context?: Map<string | symbol, unknown>;
+}
+/**
+ * Result from the `can` authorization function.
+ * Can be a simple boolean or an object with reason.
+ */
+type MCPCanResult = boolean | {
+    allowed: boolean;
+    reason?: string;
+};
+/**
+ * Simple authorization function type.
+ * Return true/false or { allowed: boolean, reason?: string }
+ *
+ * @example
+ * ```typescript
+ * const can: MCPCanFunction = async ({ toolName, action, userId, context }) => {
+ *   const roles = context?.get("roles") as string[] ?? [];
+ *   // action is "discovery" or "execution"
+ *   if (toolName === "delete_item" && !roles.includes("admin")) {
+ *     return { allowed: false, reason: "Only admins can delete" };
+ *   }
+ *   return true;
+ * };
+ * ```
+ */
+type MCPCanFunction = (params: MCPCanParams) => Promise<MCPCanResult> | MCPCanResult;
+/**
+ * Authorization configuration for MCPConfiguration.
+ *
+ * @example
+ * ```typescript
+ * const mcp = new MCPConfiguration({
+ *   servers: { myServer: { type: "http", url: "..." } },
+ *   authorization: {
+ *     can: async ({ toolName, action, userId, context }) => {
+ *       const roles = context?.get("roles") as string[] ?? [];
+ *       // action is "discovery" or "execution"
+ *       if (toolName === "admin_tool" && !roles.includes("admin")) {
+ *         return { allowed: false, reason: "Admin only" };
+ *       }
+ *       return true;
+ *     },
+ *     filterOnDiscovery: true,
+ *   },
+ * });
+ * ```
+ */
+interface MCPAuthorizationConfig {
+    /**
+     * Authorization function to check if a tool can be accessed.
+     * Called for both discovery and execution based on config options.
+     */
+    can: MCPCanFunction;
+    /**
+     * Whether to filter tools on discovery (getTools/getToolsets).
+     * When true, unauthorized tools are hidden from the tool list.
+     * @default false
+     */
+    filterOnDiscovery?: boolean;
+    /**
+     * Whether to check authorization on execution (callTool).
+     * When true, each tool call is verified before execution.
+     * @default true
+     */
+    checkOnExecution?: boolean;
+}
+
+/**
+ * Error thrown when MCP tool authorization is denied.
+ */
+declare class MCPAuthorizationError extends Error {
+    readonly toolName: string;
+    readonly serverName: string;
+    readonly reason?: string;
+    constructor(toolName: string, serverName: string, reason?: string);
+}
+
+/**
+ * Handler function for processing user input requests from MCP servers.
+ * Called when the server needs additional information during tool execution.
+ */
+type UserInputHandler = (request: ElicitRequest["params"]) => Promise<ElicitResult>;
+/**
+ * Internal callback type for notifying MCPClient when handler changes.
+ * @internal
+ */
+type HandlerChangeCallback = (handler: UserInputHandler | undefined) => void;
+/**
+ * Bridge for handling user input requests from MCP servers.
+ *
+ * Provides a fluent API for registering handlers that process elicitation
+ * requests during tool execution. Handlers can be set permanently, used
+ * once, or removed dynamically at runtime.
+ *
+ * @example
+ * ```typescript
+ * // Set a permanent handler
+ * mcpClient.elicitation.setHandler(async (request) => {
+ *   const confirmed = await askUser(request.message);
+ *   return {
+ *     action: confirmed ? "accept" : "decline",
+ *     content: confirmed ? { confirmed: true } : undefined,
+ *   };
+ * });
+ *
+ * // Set a one-time handler
+ * mcpClient.elicitation.once(async (request) => {
+ *   return { action: "accept", content: { approved: true } };
+ * });
+ *
+ * // Remove the handler
+ * mcpClient.elicitation.removeHandler();
+ * ```
+ */
+declare class UserInputBridge {
+    private handler;
+    private readonly logger;
+    private readonly onHandlerChange;
+    /**
+     * @internal
+     */
+    constructor(logger: Logger, onHandlerChange: HandlerChangeCallback);
+    /**
+     * Whether a handler is currently registered.
+     */
+    get hasHandler(): boolean;
+    /**
+     * Gets the current handler.
+     *
+     * @internal
+     * @returns The current handler or undefined if none is set
+     */
+    getHandler(): UserInputHandler | undefined;
+    /**
+     * Registers a handler for processing user input requests.
+     *
+     * The handler will be called each time the MCP server requests
+     * additional information during tool execution.
+     *
+     * @param handler - Function to process user input requests
+     * @returns This bridge instance for chaining
+     *
+     * @example
+     * ```typescript
+     * mcpClient.elicitation.setHandler(async (request) => {
+     *   console.log("Server asks:", request.message);
+     *   const userInput = await promptUser(request.requestedSchema);
+     *   return { action: "accept", content: userInput };
+     * });
+     * ```
+     */
+    setHandler(handler: UserInputHandler): this;
+    /**
+     * Registers a one-time handler that automatically removes itself after use.
+     *
+     * Useful for handling a single expected user input request without
+     * leaving a permanent handler in place.
+     *
+     * @param handler - Function to process the next user input request
+     * @returns This bridge instance for chaining
+     *
+     * @example
+     * ```typescript
+     * // Handle only the next elicitation request
+     * mcpClient.elicitation.once(async (request) => {
+     *   return { action: "accept", content: { confirmed: true } };
+     * });
+     * ```
+     */
+    once(handler: UserInputHandler): this;
+    /**
+     * Removes the current handler.
+     *
+     * After calling this, user input requests from the server will
+     * be automatically cancelled until a new handler is set.
+     *
+     * @returns This bridge instance for chaining
+     */
+    removeHandler(): this;
+    /**
+     * Processes a user input request using the registered handler.
+     *
+     * @internal
+     * @param request - The elicitation request from the server
+     * @returns The user's response or a cancel action if no handler
+     */
+    processRequest(request: ElicitRequest["params"]): Promise<ElicitResult>;
+}
+
+/**
+ * Handler for elicitation requests from the MCP server.
+ * Called when the server needs user input during tool execution.
+ *
+ * @deprecated Use `UserInputHandler` from `UserInputBridge` instead for dynamic handler registration.
+ */
+type MCPElicitationHandler = (request: ElicitRequest["params"]) => Promise<ElicitResult>;
+
 /**
  * Client information for MCP
  */
@@ -8458,6 +8687,35 @@ type MCPClientConfig = {
      * @default 30000
      */
     timeout?: number;
+    /**
+     * Elicitation handler for receiving user input requests from the MCP server.
+     * When the server needs additional information during tool execution,
+     * this handler will be called with the request details.
+     *
+     * @example
+     * ```typescript
+     * const mcpClient = new MCPClient({
+     *   clientInfo: { name: "my-client", version: "1.0.0" },
+     *   server: { type: "stdio", command: "my-mcp-server" },
+     *   elicitation: {
+     *     onRequest: async (request) => {
+     *       const confirmed = await askUserForConfirmation(request.message);
+     *       return {
+     *         action: confirmed ? "accept" : "decline",
+     *         content: confirmed ? { confirmed: true } : undefined,
+     *       };
+     *     },
+     *   },
+     * });
+     * ```
+     */
+    elicitation?: {
+        /**
+         * Handler called when the MCP server requests user input.
+         * Must return an ElicitResult with action: "accept", "decline", or "cancel".
+         */
+        onRequest: MCPElicitationHandler;
+    };
 };
 /**
  * MCP server configuration options
@@ -8628,6 +8886,40 @@ type ToolsetWithTools = Record<string, AnyToolConfig> & {
  * Any tool configuration
  */
 type AnyToolConfig = Tool<any>;
+/**
+ * Options for MCPConfiguration constructor.
+ */
+interface MCPConfigurationOptions<TServerKeys extends string = string> {
+    /**
+     * Map of server configurations keyed by server names.
+     */
+    servers: Record<TServerKeys, MCPServerConfig>;
+    /**
+     * Optional authorization configuration for tool access control.
+     */
+    authorization?: MCPAuthorizationConfig;
+}
+/**
+ * Options for MCPClient.callTool method with authorization support.
+ */
+interface MCPClientCallOptions {
+    /**
+     * Full operation context for authorization (from agent execution).
+     */
+    operationContext?: OperationContext;
+    /**
+     * Authorization function.
+     */
+    canFunction?: MCPCanFunction;
+    /**
+     * Authorization config settings.
+     */
+    authorizationConfig?: MCPAuthorizationConfig;
+    /**
+     * Server name for authorization context.
+     */
+    serverName?: string;
+}
 
 /**
  * Client for interacting with Model Context Protocol (MCP) servers.
@@ -8671,6 +8963,19 @@ declare class MCPClient extends SimpleEventEmitter {
      * Client capabilities for re-initialization.
      */
     private readonly capabilities;
+    /**
+     * Bridge for handling user input requests from the server.
+     * Provides methods to dynamically register and manage input handlers.
+     *
+     * @example
+     * ```typescript
+     * mcpClient.elicitation.setHandler(async (request) => {
+     *   const confirmed = await askUser(request.message);
+     *   return { action: confirmed ? "accept" : "decline" };
+     * });
+     * ```
+     */
+    readonly elicitation: UserInputBridge;
     /**
      * Get server info for logging
      */
@@ -8684,6 +8989,17 @@ declare class MCPClient extends SimpleEventEmitter {
      * Sets up handlers for events from the underlying SDK client.
      */
     private setupEventHandlers;
+    /**
+     * Registers the elicitation request handler with the MCP SDK client.
+     * Delegates to UserInputBridge for actual handling.
+     */
+    private registerElicitationHandler;
+    /**
+     * Callback invoked when the elicitation handler changes.
+     * Currently a no-op since we always delegate to UserInputBridge.
+     * @internal
+     */
+    private updateElicitationHandler;
     /**
      * Establishes a connection to the configured MCP server.
      * Idempotent: does nothing if already connected.
@@ -8707,15 +9023,17 @@ declare class MCPClient extends SimpleEventEmitter {
     /**
      * Builds executable Tool objects from the server's tool definitions.
      * These tools include an `execute` method for calling the remote tool.
+     * @param options - Optional call options including authorization context.
      * @returns A record mapping namespaced tool names (`clientName_toolName`) to executable Tool objects.
      */
-    getAgentTools(): Promise<Record<string, Tool<any>>>;
+    getAgentTools(options?: MCPClientCallOptions): Promise<Record<string, Tool<any>>>;
     /**
      * Executes a specified tool on the remote MCP server.
      * @param toolCall Details of the tool to call, including name and arguments.
+     * @param options Optional call options including authorization context.
      * @returns The result content returned by the tool.
      */
-    callTool(toolCall: MCPToolCall): Promise<MCPToolResult>;
+    callTool(toolCall: MCPToolCall, options?: MCPClientCallOptions): Promise<MCPToolResult>;
     /**
      * Retrieves a list of resource identifiers available on the server.
      * @returns A promise resolving to an array of resource ID strings.
@@ -8782,13 +9100,15 @@ declare class MCPConfiguration<TServerKeys extends string = string> {
      * Map of connected MCP clients keyed by server names (local cache).
      */
     private readonly mcpClientsById;
+    /**
+     * Authorization configuration for tool access control.
+     */
+    private readonly authorizationConfig?;
     /**
      * Creates a new, independent MCP configuration instance.
-     * @param options Configuration options including server definitions.
+     * @param options Configuration options including server definitions and optional authorization.
      */
-    constructor(options: {
-        servers: Record<TServerKeys, MCPServerConfig>;
-    });
+    constructor(options: MCPConfigurationOptions<TServerKeys>);
     /**
      * Type guard to check if an object conforms to the basic structure of AnyToolConfig.
      */
@@ -8799,9 +9119,22 @@ declare class MCPConfiguration<TServerKeys extends string = string> {
     disconnect(): Promise<void>;
     /**
      * Retrieves agent-ready tools from all configured MCP servers for this instance.
+     * @param authContext - Optional authorization context for filtering tools.
      * @returns A flat array of all agent-ready tools.
      */
-    getTools(): Promise<Tool<any>[]>;
+    getTools(authContext?: MCPAuthorizationContext): Promise<Tool<any>[]>;
+    /**
+     * Checks if the can authorization function is configured.
+     */
+    private hasAuthorizationHandler;
+    /**
+     * Creates call options for MCPClient methods with authorization context.
+     */
+    private createClientCallOptions;
+    /**
+     * Filters tools based on authorization using the `can` function.
+     */
+    private filterToolsByAuthorization;
     /**
      * Retrieves raw tool definitions from all configured MCP servers for this instance.
      * @returns A flat record of all raw tools keyed by their namespaced name.
@@ -10678,4 +11011,4 @@ declare class VoltAgent {
  */
 declare function convertUsage(usage: LanguageModelUsage | undefined): UsageInfo | undefined;
 
-export { A2AServerRegistry, AbortError, Agent, type AgentEvalConfig, type AgentEvalContext, type AgentEvalOperationType, type AgentEvalPayload, type AgentEvalResult, type AgentEvalSamplingPolicy, type AgentEvalScorerConfig, type AgentEvalScorerFactory, type AgentEvalScorerReference, type AgentFullState, type AgentHookOnEnd, type AgentHookOnError, type AgentHookOnHandoff, type AgentHookOnHandoffComplete, type AgentHookOnPrepareMessages, type AgentHookOnPrepareModelMessages, type AgentHookOnStart, type AgentHookOnStepFinish, type AgentHookOnToolEnd, type AgentHookOnToolStart, type AgentHooks, type AgentOptions, AgentRegistry, type AgentResponse, type AgentScorerState, type AgentStatus, type AgentTool, AiSdkEmbeddingAdapter, type AllowedVariableValue, type ApiToolInfo, type BaseEventMetadata, type BaseGenerationOptions, type BaseLLMOptions, type BaseMessage, BaseRetriever, type BaseTool, type BaseToolCall, type BuildScorerOptions, type BuildScorerRunArgs, type BuildScorerRunResult, type BuilderAnalyzeContext, type BuilderPrepareContext, type BuilderReasonContext, type BuilderScoreContext, type CachedPrompt, type ChatMessage, ClientHTTPError, type ClientSideToolResult, type CloudflareFetchHandler, type Conversation, ConversationAlreadyExistsError, ConversationNotFoundError, type ConversationQueryOptions, type ConversationQueryOptions as ConversationQueryOptionsV2, type ConversationStepRecord, type ConversationStepType, type Conversation as ConversationV2, type CreateConversationInput, type CreateConversationInput as CreateConversationInputV2, type CreateInputGuardrailOptions, type CreateOutputGuardrailOptions, type CreateReasoningToolsOptions, type CreateScorerOptions, 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 GenerateReasonResult, type GenerateScoreResult, type GenerateScoreStep, type GenerateTextOptions, type GenerateTextSubAgentConfig, type GetConversationStepsOptions, type GetMessagesOptions, type GuardrailAction, type GuardrailContext, type GuardrailDefinition, type GuardrailFunction, type GuardrailSeverity, type IServerProvider, type IServerlessProvider, 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 InputGuardrail, type InputGuardrailArgs, type InputGuardrailResult, type LLMProvider, LazyRemoteExportProcessor, type LocalScorerDefinition, type LocalScorerExecutionResult, LocalStorageSpanProcessor, type LogFilter, LoggerProxy, MCPConfiguration, type MCPElicitationAdapter, type MCPLoggingAdapter, type MCPPromptsAdapter, type MCPResourcesAdapter, MCPServerRegistry, type ManagedMemoryAddMessageInput, type ManagedMemoryAddMessagesInput, type ManagedMemoryClearMessagesInput, type ManagedMemoryConnectionInfo, type ManagedMemoryConversationsClient, type ManagedMemoryCredentialCreateResult, type ManagedMemoryCredentialListResult, type ManagedMemoryCredentialSummary, type ManagedMemoryDatabaseSummary, type ManagedMemoryGetMessagesInput, type ManagedMemoryMessagesClient, type ManagedMemoryQueryWorkflowRunsInput, type ManagedMemorySetWorkingMemoryInput, type ManagedMemoryStatus, type ManagedMemoryUpdateConversationInput, type ManagedMemoryVoltOpsClient, type ManagedMemoryWorkflowStateUpdateInput, type ManagedMemoryWorkflowStatesClient, type ManagedMemoryWorkingMemoryClient, type ManagedMemoryWorkingMemoryInput, Memory, type MemoryConfig, type MemoryOptions, type MemoryStorageMetadata, type MemoryUpdateMode, Memory as MemoryV2, MemoryV2Error, type MessageContent, MessageContentBuilder, type MessageRole, type ModelToolCall, NextAction, NodeType, VoltAgentObservability$1 as NodeVoltAgentObservability, type ObservabilityConfig, type ObservabilityLogRecord, type ObservabilitySpan, type ObservabilityStorageAdapter, type ObservabilityWebSocketEvent, type OnEndHookArgs, type OnErrorHookArgs, type OnHandoffCompleteHookArgs, type OnHandoffHookArgs, type OnPrepareMessagesHookArgs, type OnPrepareMessagesHookResult, type OnPrepareModelMessagesHookArgs, type OnPrepareModelMessagesHookResult, type OnStartHookArgs, type OnStepFinishHookArgs, type OnToolEndHookArgs, type OnToolStartHookArgs, type OperationContext, type OutputGuardrail, type OutputGuardrailArgs, type OutputGuardrailResult, 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 ProviderTool, type ReadableStreamType, type ReasoningStep, ReasoningStepSchema, type RegisterOptions, type RegisteredTrigger, type RegisteredWorkflow, type RemoteLogExportConfig, RemoteLogProcessor, type RetrieveOptions, type Retriever, type RetrieverOptions, type RunLocalScorersArgs, type RunLocalScorersResult, type SamplingMetadata, type SamplingPolicy, type ScorerBuilder, type ScorerContext, type ScorerLifecycleScope, type ScorerPipelineContext, type ScorerReasonContext, type ScorerResult, type SearchOptions, type SearchResult, type ServerAgentResponse, type ServerApiResponse, type ServerProviderDeps, type ServerProviderFactory, type ServerWorkflowResponse, type ServerlessProviderFactory, type ServerlessRemoteEndpointConfig, type ServerlessRemoteExportConfig, type ServerlessRequestHandler, ServerlessVoltAgentObservability, type SpanAttributes, type SpanEvent, type SpanFilterConfig, SpanFilterProcessor, SpanKind, type SpanLink, type SpanStatus, SpanStatusCode, type SpanTreeNode, type StepChunkCallback, type StepFinishCallback, type StepWithContent, type StopWhen, type StorageAdapter, StorageError, StorageLogProcessor, 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, TRIGGER_CONTEXT_KEY, type TemplateVariables, type TimelineEventCoreLevel, type TimelineEventCoreStatus, type TimelineEventCoreType, Tool, type ToolCall, type ToolContext, ToolDeniedError, type ToolErrorInfo, type ToolExecuteOptions, ToolManager, type ToolOptions, type ToolResultOutput, type ToolSchema, type ToolStatus, type ToolStatusInfo, type ToolWithNodeId, type Toolkit, type TriggerHandler, type TriggerHandlerBody, type TriggerHandlerContext, type TriggerHandlerResponse, type TriggerHandlerResult, type TriggerHandlerReturn, type TriggerHttpMethod, TriggerRegistry, 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, type VoltAgentTriggerConfig, type VoltAgentTriggersConfig, type VoltOpsActionExecutionResult, type VoltOpsActionsApi, VoltOpsActionsClient, type VoltOpsActionsTransport, type VoltOpsAirtableCreateRecordParams, type VoltOpsAirtableCredential, type VoltOpsAirtableDeleteRecordParams, type VoltOpsAirtableGetRecordParams, type VoltOpsAirtableListRecordsParams, type VoltOpsAirtableUpdateRecordParams, type VoltOpsAppendEvalRunResultPayload, type VoltOpsAppendEvalRunResultsRequest, VoltOpsClient, type VoltOpsClientOptions, type VoltOpsCompleteEvalRunRequest, type VoltOpsCreateEvalRunRequest, type VoltOpsCreateScorerRequest, type VoltOpsDiscordChannelMessageParams, type VoltOpsDiscordChannelType, type VoltOpsDiscordConfig, type VoltOpsDiscordCreateChannelParams, type VoltOpsDiscordCredential, type VoltOpsDiscordDeleteChannelParams, type VoltOpsDiscordGetChannelParams, type VoltOpsDiscordListChannelsParams, type VoltOpsDiscordListMembersParams, type VoltOpsDiscordListMessagesParams, type VoltOpsDiscordMemberRoleParams, type VoltOpsDiscordReactionParams, type VoltOpsDiscordSendMessageParams, type VoltOpsDiscordSendWebhookMessageParams, type VoltOpsDiscordUpdateChannelParams, type VoltOpsEvalResultStatus, type VoltOpsEvalRunCompletionSummaryPayload, type VoltOpsEvalRunErrorPayload, type VoltOpsEvalRunResultLiveMetadata, type VoltOpsEvalRunResultScorePayload, type VoltOpsEvalRunStatus, type VoltOpsEvalRunSummary, VoltOpsPromptApiClient, type VoltOpsPromptManager, VoltOpsPromptManagerImpl, type VoltOpsScorerSummary, type VoltOpsSlackCredential, type VoltOpsSlackDeleteMessageParams, type VoltOpsSlackPostMessageParams, type VoltOpsSlackSearchMessagesParams, type VoltOpsTerminalEvalRunStatus, type VoltOpsTriggerDefinition, VoltOpsTriggerDefinitions, type VoltOpsTriggerEnvelope, type VoltOpsTriggerGroupMap, type VoltOpsTriggerName, VoltOpsTriggerNames, WebSocketEventEmitter, WebSocketLogProcessor, WebSocketSpanProcessor, type WeightedBlendComponent, type WeightedBlendOptions, type Workflow, type WorkflowConfig, type WorkflowExecutionContext, WorkflowRegistry, type WorkflowRunQuery, type WorkflowStateEntry, type WorkflowStats, type WorkflowStepContext, type WorkflowStepType, type WorkflowTimelineEvent, type WorkingMemoryConfig, type WorkingMemoryScope, type WorkingMemorySummary, type WorkingMemoryUpdateOptions, addTimestampToMessage, andAgent, andAll, andRace, andTap, andThen, andWhen, andWorkflow, appendToMessage, buildRetrieverLogMessage, buildSamplingMetadata, buildScorer, buildSpanTree, checkForUpdates, convertUsage, cosineSimilarity, createDefaultInputSafetyGuardrails, createDefaultPIIGuardrails, createDefaultSafetyGuardrails, createEmailRedactorGuardrail, createHTMLSanitizerInputGuardrail, createHooks, createInputGuardrail, createInputLengthGuardrail, createMaxLengthGuardrail, createNodeId, createOutputGuardrail, createPIIInputGuardrail, createPhoneNumberGuardrail, createProfanityGuardrail, createProfanityInputGuardrail, createPrompt, createPromptInjectionGuardrail, createReasoningTools, createRetrieverTool, createScorer, createSensitiveNumberGuardrail, createSimpleTemplateEngine, createSubagent, createSuspendController, createTool, createToolkit, createTriggers, createVoltAgentObservability, createVoltOpsClient, createWorkflow, createWorkflowChain, createWorkflowStepNodeId, VoltAgent as default, defineVoltOpsTrigger, extractFileParts, extractImageParts, extractText, extractTextParts, extractWorkflowStepInfo, filterContentParts, getContentLength, getEnvVar, getGlobalLogBuffer, getGlobalLogger, getNodeTypeFromNodeId, getVoltOpsTriggerDefinition, getWorkflowStepNodeType, hasContent, hasFilePart, hasImagePart, hasTextPart, isAbortError, isNodeRuntime, isServerlessRuntime, isStructuredContent, isTextContent, isVoltAgentError, mapMessageContent, messageHelpers, normalizeContent, normalizeScorerResult, normalizeToArray, prependToMessage, readableLogRecordToObservabilityLog, readableSpanToObservabilitySpan, runLocalScorers, safeJsonParse, serializeValueForDebug, setWaitUntil, shouldSample, tool, transformTextContent, updateAllPackages, updateSinglePackage, weightedBlend, zodSchemaToJsonUI };
+export { A2AServerRegistry, AbortError, Agent, type AgentEvalConfig, type AgentEvalContext, type AgentEvalOperationType, type AgentEvalPayload, type AgentEvalResult, type AgentEvalSamplingPolicy, type AgentEvalScorerConfig, type AgentEvalScorerFactory, type AgentEvalScorerReference, type AgentFullState, type AgentHookOnEnd, type AgentHookOnError, type AgentHookOnHandoff, type AgentHookOnHandoffComplete, type AgentHookOnPrepareMessages, type AgentHookOnPrepareModelMessages, type AgentHookOnStart, type AgentHookOnStepFinish, type AgentHookOnToolEnd, type AgentHookOnToolStart, type AgentHooks, type AgentOptions, AgentRegistry, type AgentResponse, type AgentScorerState, type AgentStatus, type AgentTool, AiSdkEmbeddingAdapter, type AllowedVariableValue, type ApiToolInfo, type BaseEventMetadata, type BaseGenerationOptions, type BaseLLMOptions, type BaseMessage, BaseRetriever, type BaseTool, type BaseToolCall, type BuildScorerOptions, type BuildScorerRunArgs, type BuildScorerRunResult, type BuilderAnalyzeContext, type BuilderPrepareContext, type BuilderReasonContext, type BuilderScoreContext, type CachedPrompt, type ChatMessage, ClientHTTPError, type ClientSideToolResult, type CloudflareFetchHandler, type Conversation, ConversationAlreadyExistsError, ConversationNotFoundError, type ConversationQueryOptions, type ConversationQueryOptions as ConversationQueryOptionsV2, type ConversationStepRecord, type ConversationStepType, type Conversation as ConversationV2, type CreateConversationInput, type CreateConversationInput as CreateConversationInputV2, type CreateInputGuardrailOptions, type CreateOutputGuardrailOptions, type CreateReasoningToolsOptions, type CreateScorerOptions, 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 GenerateReasonResult, type GenerateScoreResult, type GenerateScoreStep, type GenerateTextOptions, type GenerateTextSubAgentConfig, type GetConversationStepsOptions, type GetMessagesOptions, type GuardrailAction, type GuardrailContext, type GuardrailDefinition, type GuardrailFunction, type GuardrailSeverity, type IServerProvider, type IServerlessProvider, 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 InputGuardrail, type InputGuardrailArgs, type InputGuardrailResult, type LLMProvider, LazyRemoteExportProcessor, type LocalScorerDefinition, type LocalScorerExecutionResult, LocalStorageSpanProcessor, type LogFilter, LoggerProxy, type MCPAuthorizationAction, type MCPAuthorizationConfig, type MCPAuthorizationContext, MCPAuthorizationError, type MCPCanFunction, type MCPCanParams, type MCPCanResult, MCPClient, type MCPClientCallOptions, type MCPClientConfig, MCPConfiguration, type MCPConfigurationOptions, type MCPElicitationAdapter, type MCPElicitationHandler, type MCPLoggingAdapter, type MCPPromptsAdapter, type MCPResourcesAdapter, MCPServerRegistry, type ManagedMemoryAddMessageInput, type ManagedMemoryAddMessagesInput, type ManagedMemoryClearMessagesInput, type ManagedMemoryConnectionInfo, type ManagedMemoryConversationsClient, type ManagedMemoryCredentialCreateResult, type ManagedMemoryCredentialListResult, type ManagedMemoryCredentialSummary, type ManagedMemoryDatabaseSummary, type ManagedMemoryGetMessagesInput, type ManagedMemoryMessagesClient, type ManagedMemoryQueryWorkflowRunsInput, type ManagedMemorySetWorkingMemoryInput, type ManagedMemoryStatus, type ManagedMemoryUpdateConversationInput, type ManagedMemoryVoltOpsClient, type ManagedMemoryWorkflowStateUpdateInput, type ManagedMemoryWorkflowStatesClient, type ManagedMemoryWorkingMemoryClient, type ManagedMemoryWorkingMemoryInput, Memory, type MemoryConfig, type MemoryOptions, type MemoryStorageMetadata, type MemoryUpdateMode, Memory as MemoryV2, MemoryV2Error, type MessageContent, MessageContentBuilder, type MessageRole, type ModelToolCall, NextAction, NodeType, VoltAgentObservability$1 as NodeVoltAgentObservability, type ObservabilityConfig, type ObservabilityLogRecord, type ObservabilitySpan, type ObservabilityStorageAdapter, type ObservabilityWebSocketEvent, type OnEndHookArgs, type OnErrorHookArgs, type OnHandoffCompleteHookArgs, type OnHandoffHookArgs, type OnPrepareMessagesHookArgs, type OnPrepareMessagesHookResult, type OnPrepareModelMessagesHookArgs, type OnPrepareModelMessagesHookResult, type OnStartHookArgs, type OnStepFinishHookArgs, type OnToolEndHookArgs, type OnToolStartHookArgs, type OperationContext, type OutputGuardrail, type OutputGuardrailArgs, type OutputGuardrailResult, 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 ProviderTool, type ReadableStreamType, type ReasoningStep, ReasoningStepSchema, type RegisterOptions, type RegisteredTrigger, type RegisteredWorkflow, type RemoteLogExportConfig, RemoteLogProcessor, type RetrieveOptions, type Retriever, type RetrieverOptions, type RunLocalScorersArgs, type RunLocalScorersResult, type SamplingMetadata, type SamplingPolicy, type ScorerBuilder, type ScorerContext, type ScorerLifecycleScope, type ScorerPipelineContext, type ScorerReasonContext, type ScorerResult, type SearchOptions, type SearchResult, type ServerAgentResponse, type ServerApiResponse, type ServerProviderDeps, type ServerProviderFactory, type ServerWorkflowResponse, type ServerlessProviderFactory, type ServerlessRemoteEndpointConfig, type ServerlessRemoteExportConfig, type ServerlessRequestHandler, ServerlessVoltAgentObservability, type SpanAttributes, type SpanEvent, type SpanFilterConfig, SpanFilterProcessor, SpanKind, type SpanLink, type SpanStatus, SpanStatusCode, type SpanTreeNode, type StepChunkCallback, type StepFinishCallback, type StepWithContent, type StopWhen, type StorageAdapter, StorageError, StorageLogProcessor, 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, TRIGGER_CONTEXT_KEY, type TemplateVariables, type TimelineEventCoreLevel, type TimelineEventCoreStatus, type TimelineEventCoreType, Tool, type ToolCall, type ToolContext, ToolDeniedError, type ToolErrorInfo, type ToolExecuteOptions, ToolManager, type ToolOptions, type ToolResultOutput, type ToolSchema, type ToolStatus, type ToolStatusInfo, type ToolWithNodeId, type Toolkit, type TriggerHandler, type TriggerHandlerBody, type TriggerHandlerContext, type TriggerHandlerResponse, type TriggerHandlerResult, type TriggerHandlerReturn, type TriggerHttpMethod, TriggerRegistry, type Usage, type UsageInfo, UserInputBridge, type UserInputHandler, 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, type VoltAgentTriggerConfig, type VoltAgentTriggersConfig, type VoltOpsActionExecutionResult, type VoltOpsActionsApi, VoltOpsActionsClient, type VoltOpsActionsTransport, type VoltOpsAirtableCreateRecordParams, type VoltOpsAirtableCredential, type VoltOpsAirtableDeleteRecordParams, type VoltOpsAirtableGetRecordParams, type VoltOpsAirtableListRecordsParams, type VoltOpsAirtableUpdateRecordParams, type VoltOpsAppendEvalRunResultPayload, type VoltOpsAppendEvalRunResultsRequest, VoltOpsClient, type VoltOpsClientOptions, type VoltOpsCompleteEvalRunRequest, type VoltOpsCreateEvalRunRequest, type VoltOpsCreateScorerRequest, type VoltOpsDiscordChannelMessageParams, type VoltOpsDiscordChannelType, type VoltOpsDiscordConfig, type VoltOpsDiscordCreateChannelParams, type VoltOpsDiscordCredential, type VoltOpsDiscordDeleteChannelParams, type VoltOpsDiscordGetChannelParams, type VoltOpsDiscordListChannelsParams, type VoltOpsDiscordListMembersParams, type VoltOpsDiscordListMessagesParams, type VoltOpsDiscordMemberRoleParams, type VoltOpsDiscordReactionParams, type VoltOpsDiscordSendMessageParams, type VoltOpsDiscordSendWebhookMessageParams, type VoltOpsDiscordUpdateChannelParams, type VoltOpsEvalResultStatus, type VoltOpsEvalRunCompletionSummaryPayload, type VoltOpsEvalRunErrorPayload, type VoltOpsEvalRunResultLiveMetadata, type VoltOpsEvalRunResultScorePayload, type VoltOpsEvalRunStatus, type VoltOpsEvalRunSummary, VoltOpsPromptApiClient, type VoltOpsPromptManager, VoltOpsPromptManagerImpl, type VoltOpsScorerSummary, type VoltOpsSlackCredential, type VoltOpsSlackDeleteMessageParams, type VoltOpsSlackPostMessageParams, type VoltOpsSlackSearchMessagesParams, type VoltOpsTerminalEvalRunStatus, type VoltOpsTriggerDefinition, VoltOpsTriggerDefinitions, type VoltOpsTriggerEnvelope, type VoltOpsTriggerGroupMap, type VoltOpsTriggerName, VoltOpsTriggerNames, WebSocketEventEmitter, WebSocketLogProcessor, WebSocketSpanProcessor, type WeightedBlendComponent, type WeightedBlendOptions, type Workflow, type WorkflowConfig, type WorkflowExecutionContext, WorkflowRegistry, type WorkflowRunQuery, type WorkflowStateEntry, type WorkflowStats, type WorkflowStepContext, type WorkflowStepType, type WorkflowTimelineEvent, type WorkingMemoryConfig, type WorkingMemoryScope, type WorkingMemorySummary, type WorkingMemoryUpdateOptions, addTimestampToMessage, andAgent, andAll, andRace, andTap, andThen, andWhen, andWorkflow, appendToMessage, buildRetrieverLogMessage, buildSamplingMetadata, buildScorer, buildSpanTree, checkForUpdates, convertUsage, cosineSimilarity, createDefaultInputSafetyGuardrails, createDefaultPIIGuardrails, createDefaultSafetyGuardrails, createEmailRedactorGuardrail, createHTMLSanitizerInputGuardrail, createHooks, createInputGuardrail, createInputLengthGuardrail, createMaxLengthGuardrail, createNodeId, createOutputGuardrail, createPIIInputGuardrail, createPhoneNumberGuardrail, createProfanityGuardrail, createProfanityInputGuardrail, createPrompt, createPromptInjectionGuardrail, createReasoningTools, createRetrieverTool, createScorer, createSensitiveNumberGuardrail, createSimpleTemplateEngine, createSubagent, createSuspendController, createTool, createToolkit, createTriggers, createVoltAgentObservability, createVoltOpsClient, createWorkflow, createWorkflowChain, createWorkflowStepNodeId, VoltAgent as default, defineVoltOpsTrigger, extractFileParts, extractImageParts, extractText, extractTextParts, extractWorkflowStepInfo, filterContentParts, getContentLength, getEnvVar, getGlobalLogBuffer, getGlobalLogger, getNodeTypeFromNodeId, getVoltOpsTriggerDefinition, getWorkflowStepNodeType, hasContent, hasFilePart, hasImagePart, hasTextPart, isAbortError, isNodeRuntime, isServerlessRuntime, isStructuredContent, isTextContent, isVoltAgentError, mapMessageContent, messageHelpers, normalizeContent, normalizeScorerResult, normalizeToArray, prependToMessage, readableLogRecordToObservabilityLog, readableSpanToObservabilitySpan, runLocalScorers, safeJsonParse, serializeValueForDebug, setWaitUntil, shouldSample, tool, transformTextContent, updateAllPackages, updateSinglePackage, weightedBlend, zodSchemaToJsonUI };