@voltagent/core 1.3.0 → 1.5.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.
@@ -1699,6 +1699,10 @@ type Retriever = {
      * This is optional and may not be present in all implementations
      */
     tool?: any;
+    /**
+     * Optional observability attributes for retriever spans.
+     */
+    getObservabilityAttributes?: () => Record<string, unknown>;
 };
 
 /**
@@ -1747,6 +1751,11 @@ declare abstract class BaseRetriever {
      * @returns Promise resolving to a string with the retrieved content
      */
     abstract retrieve(input: string | BaseMessage[], options: RetrieveOptions): Promise<string>;
+    /**
+     * Optional observability attributes for retriever spans.
+     * Override in subclasses to add context (e.g. knowledge base metadata).
+     */
+    getObservabilityAttributes(): Record<string, unknown>;
 }
 
 /**
@@ -5520,6 +5529,7 @@ declare class Agent {
      * Get retriever context
      */
     private getRetrieverContext;
+    private getRetrieverObservabilityAttributes;
     /**
      * Resolve dynamic value
      */
@@ -8516,6 +8526,126 @@ declare class MCPAuthorizationError extends Error {
     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
  */
@@ -8567,6 +8697,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
@@ -8814,6 +8973,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
      */
@@ -8827,6 +8999,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.
@@ -10436,6 +10619,197 @@ declare const isServerlessRuntime: () => boolean;
 declare const isNodeRuntime: () => boolean;
 declare const getEnvVar: (key: string) => string | undefined;
 
+/**
+ * Prompt manager with caching and Liquid template processing
+ */
+
+/**
+ * Implementation of VoltOpsPromptManager with caching and Liquid templates
+ */
+declare class VoltOpsPromptManagerImpl implements VoltOpsPromptManager {
+    private readonly cache;
+    private readonly apiClient;
+    private readonly templateEngine;
+    private readonly cacheConfig;
+    private readonly logger;
+    constructor(options: VoltOpsClientOptions);
+    /**
+     * Get prompt content by reference with caching and template processing
+     */
+    getPrompt(reference: PromptReference): Promise<PromptContent>;
+    /**
+     * Preload prompts for better performance
+     */
+    preload(references: PromptReference[]): Promise<void>;
+    /**
+     * Clear cache
+     */
+    clearCache(): void;
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): {
+        size: number;
+        entries: string[];
+    };
+    /**
+     * Convert API response to PromptContent with metadata
+     */
+    private convertApiResponseToPromptContent;
+    /**
+     * Generate cache key for prompt reference
+     */
+    private getCacheKey;
+    /**
+     * Get cached prompt if valid
+     */
+    private getCachedPrompt;
+    /**
+     * Set cached prompt with TTL and size limit enforcement
+     */
+    private setCachedPrompt;
+    /**
+     * Evict oldest cache entry to make room for new one
+     */
+    private evictOldestEntry;
+    /**
+     * Process template variables using configured template engine
+     */
+    private processTemplate;
+    /**
+     * Process PromptContent with template processing
+     */
+    private processPromptContent;
+    /**
+     * Process MessageContent (can be string or array of parts)
+     */
+    private processMessageContent;
+}
+
+/**
+ * API client for prompt operations
+ */
+
+/**
+ * Implementation of PromptApiClient for VoltOps API communication
+ */
+declare class VoltOpsPromptApiClient implements PromptApiClient {
+    private readonly baseUrl;
+    private readonly publicKey;
+    private readonly secretKey;
+    private readonly fetchFn;
+    private readonly logger;
+    constructor(options: VoltOpsClientOptions);
+    /**
+     * Fetch prompt content from VoltOps API
+     */
+    fetchPrompt(reference: PromptReference): Promise<PromptApiResponse>;
+    /**
+     * Build URL for prompt API endpoint
+     */
+    private buildPromptUrl;
+    /**
+     * Build authentication headers
+     */
+    private buildHeaders;
+}
+
+/**
+ * Simple template engine for basic variable substitution
+ */
+/**
+ * Template engine interface
+ */
+type TemplateEngine = {
+    /** Process template with variables */
+    process: (content: string, variables: Record<string, any>) => string;
+    /** Engine name for debugging */
+    name: string;
+};
+/**
+ * Simple mustache-style template engine (built-in, no dependencies)
+ * Supports {{variable}} syntax for basic variable substitution
+ */
+declare const createSimpleTemplateEngine: () => TemplateEngine;
+
+type KnowledgeBaseTagFilter = {
+    tagName: string;
+    tagValue: string;
+};
+type RagSearchKnowledgeBaseRequest = {
+    knowledgeBaseId: string;
+    query?: string | null;
+    topK?: number;
+    tagFilters?: KnowledgeBaseTagFilter[] | null;
+};
+type RagKnowledgeBaseSummary = {
+    id: string;
+    project_id: string;
+    name: string;
+    description?: string | null;
+    embedding_model: string;
+    embedding_dimension: number;
+    chunking_config: Record<string, unknown>;
+    token_count: number;
+    created_at: string;
+    updated_at: string;
+    deleted_at?: string | null;
+};
+type RagSearchKnowledgeBaseChildChunk = {
+    chunkIndex: number;
+    content: string;
+    startOffset: number;
+    endOffset: number;
+    similarity: number;
+};
+type RagSearchKnowledgeBaseResult = {
+    documentId: string;
+    documentName: string;
+    content: string;
+    chunkIndex: number;
+    similarity: number;
+    metadata: Record<string, unknown>;
+    childChunks?: RagSearchKnowledgeBaseChildChunk[];
+};
+type RagSearchKnowledgeBaseResponse = {
+    knowledgeBaseId: string;
+    query: string;
+    totalResults: number;
+    results: RagSearchKnowledgeBaseResult[];
+};
+type VoltAgentRagRetrieverKnowledgeBaseOptions = {
+    knowledgeBaseName: string;
+};
+type VoltAgentRagRetrieverOptions = RetrieverOptions & VoltAgentRagRetrieverKnowledgeBaseOptions & {
+    voltOpsClient?: VoltOpsClient;
+    topK?: number;
+    tagFilters?: KnowledgeBaseTagFilter[] | null;
+    maxChunkCharacters?: number;
+    includeSources?: boolean;
+    includeSimilarity?: boolean;
+};
+/**
+ * Retriever that queries VoltAgent RAG Knowledge Bases via the VoltAgent API.
+ *
+ * Works with the `/rag/project/search` endpoint and returns the top-k chunks as context.
+ */
+declare class VoltAgentRagRetriever extends BaseRetriever {
+    private readonly search;
+    private readonly listKnowledgeBases;
+    private readonly knowledgeBaseName;
+    private resolvedKnowledgeBaseId;
+    private resolveKnowledgeBaseIdPromise;
+    private readonly topK;
+    private readonly tagFilters;
+    private readonly maxChunkCharacters;
+    private readonly includeSources;
+    private readonly includeSimilarity;
+    constructor(options: VoltAgentRagRetrieverOptions);
+    getObservabilityAttributes(): Record<string, unknown>;
+    private resolveKnowledgeBaseId;
+    retrieve(input: string | BaseMessage[], options: RetrieveOptions): Promise<string>;
+}
+
 /**
  * Creates an AgentTool from a retriever, allowing it to be used as a tool in an agent.
  * This is the preferred way to use a retriever as a tool, as it properly maintains the 'this' context.
@@ -10609,119 +10983,6 @@ declare const updateSinglePackage: (packageName: string, packagePath?: string) =
     requiresRestart?: boolean;
 }>;
 
-/**
- * Prompt manager with caching and Liquid template processing
- */
-
-/**
- * Implementation of VoltOpsPromptManager with caching and Liquid templates
- */
-declare class VoltOpsPromptManagerImpl implements VoltOpsPromptManager {
-    private readonly cache;
-    private readonly apiClient;
-    private readonly templateEngine;
-    private readonly cacheConfig;
-    private readonly logger;
-    constructor(options: VoltOpsClientOptions);
-    /**
-     * Get prompt content by reference with caching and template processing
-     */
-    getPrompt(reference: PromptReference): Promise<PromptContent>;
-    /**
-     * Preload prompts for better performance
-     */
-    preload(references: PromptReference[]): Promise<void>;
-    /**
-     * Clear cache
-     */
-    clearCache(): void;
-    /**
-     * Get cache statistics
-     */
-    getCacheStats(): {
-        size: number;
-        entries: string[];
-    };
-    /**
-     * Convert API response to PromptContent with metadata
-     */
-    private convertApiResponseToPromptContent;
-    /**
-     * Generate cache key for prompt reference
-     */
-    private getCacheKey;
-    /**
-     * Get cached prompt if valid
-     */
-    private getCachedPrompt;
-    /**
-     * Set cached prompt with TTL and size limit enforcement
-     */
-    private setCachedPrompt;
-    /**
-     * Evict oldest cache entry to make room for new one
-     */
-    private evictOldestEntry;
-    /**
-     * Process template variables using configured template engine
-     */
-    private processTemplate;
-    /**
-     * Process PromptContent with template processing
-     */
-    private processPromptContent;
-    /**
-     * Process MessageContent (can be string or array of parts)
-     */
-    private processMessageContent;
-}
-
-/**
- * API client for prompt operations
- */
-
-/**
- * Implementation of PromptApiClient for VoltOps API communication
- */
-declare class VoltOpsPromptApiClient implements PromptApiClient {
-    private readonly baseUrl;
-    private readonly publicKey;
-    private readonly secretKey;
-    private readonly fetchFn;
-    private readonly logger;
-    constructor(options: VoltOpsClientOptions);
-    /**
-     * Fetch prompt content from VoltOps API
-     */
-    fetchPrompt(reference: PromptReference): Promise<PromptApiResponse>;
-    /**
-     * Build URL for prompt API endpoint
-     */
-    private buildPromptUrl;
-    /**
-     * Build authentication headers
-     */
-    private buildHeaders;
-}
-
-/**
- * Simple template engine for basic variable substitution
- */
-/**
- * Template engine interface
- */
-type TemplateEngine = {
-    /** Process template with variables */
-    process: (content: string, variables: Record<string, any>) => string;
-    /** Engine name for debugging */
-    name: string;
-};
-/**
- * Simple mustache-style template engine (built-in, no dependencies)
- * Supports {{variable}} syntax for basic variable substitution
- */
-declare const createSimpleTemplateEngine: () => TemplateEngine;
-
 /**
  * Main VoltAgent class for managing agents and server
  */
@@ -10838,4 +11099,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, type MCPAuthorizationAction, type MCPAuthorizationConfig, type MCPAuthorizationContext, MCPAuthorizationError, type MCPCanFunction, type MCPCanParams, type MCPCanResult, type MCPClientCallOptions, MCPConfiguration, type MCPConfigurationOptions, 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 KnowledgeBaseTagFilter, 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 RagKnowledgeBaseSummary, type RagSearchKnowledgeBaseChildChunk, type RagSearchKnowledgeBaseRequest, type RagSearchKnowledgeBaseResponse, type RagSearchKnowledgeBaseResult, 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, VoltAgentRagRetriever, type VoltAgentRagRetrieverOptions, 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 };