@voltagent/core 1.1.12 → 1.1.14

package/dist/index.d.mts

@@ -16,6 +16,8 @@ import { SpanProcessor, ReadableSpan } from '@opentelemetry/sdk-trace-base';
 import { DangerouslyAllowAny, PlainObject } from '@voltagent/internal/types';
 import * as TF from 'type-fest';
 import { EventEmitter } from 'node:events';
+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';
 
 /**
@@ -2955,6 +2957,8 @@ type OperationContext = {
     isActive: boolean;
     /** Parent agent ID if part of a delegation chain */
     parentAgentId?: string;
+    /** Optional elicitation bridge for requesting user input */
+    elicitation?: (request: unknown) => Promise<unknown>;
     /** Trace context for managing span hierarchy and common attributes */
     traceContext: AgentTraceContext;
     /** Execution-scoped logger with full context (userId, conversationId, executionId) */
@@ -3294,6 +3298,7 @@ interface BaseGenerationOptions extends Partial<CallSettings> {
     userId?: string;
     conversationId?: string;
     context?: ContextInput;
+    elicitation?: (request: unknown) => Promise<unknown>;
     parentAgentId?: string;
     parentOperationContext?: OperationContext;
     parentSpan?: Span;
@@ -3982,11 +3987,11 @@ interface WorkflowStreamEvent {
     /**
      * Input data for the step/event
      */
-    input?: Record<string, DangerouslyAllowAny>;
+    input?: DangerouslyAllowAny;
     /**
      * Output data from the step/event
      */
-    output?: Record<string, DangerouslyAllowAny>;
+    output?: DangerouslyAllowAny;
     /**
      * Current status of the step/event
      */
@@ -5744,933 +5749,977 @@ interface BaseEventMetadata {
     context?: Record<string, unknown>;
 }
 
-/**
- * Basic type definitions for VoltAgent Core
- */
+declare class A2AServerRegistry<TServer extends A2AServerLike = A2AServerLike> {
+    private readonly servers;
+    private readonly idByServer;
+    private readonly serverById;
+    private readonly metadataById;
+    private anonymousCounter;
+    register(server: TServer, deps: A2AServerDeps): void;
+    unregister(server: TServer): void;
+    getServer(id: string): TServer | undefined;
+    getMetadata(id: string): A2AServerMetadata | undefined;
+    list(): TServer[];
+    listMetadata(): A2AServerMetadata[];
+    private resolveMetadata;
+    private normalizeIdentifier;
+    private ensureUniqueId;
+    private createAnonymousSlug;
+    private createAnonymousName;
+}
+
+interface RegisterOptions {
+    startTransports?: boolean;
+    transportOptions?: Record<string, unknown>;
+}
+declare class MCPServerRegistry<TServer extends MCPServerLike = MCPServerLike> {
+    private readonly servers;
+    private readonly idByServer;
+    private readonly serverById;
+    private readonly metadataById;
+    private anonymousCounter;
+    register(server: TServer, deps: MCPServerDeps, options?: RegisterOptions): void;
+    unregister(server: TServer): void;
+    getServer(id: string): TServer | undefined;
+    getServerMetadata(id: string): MCPServerMetadata | undefined;
+    list(): TServer[];
+    listMetadata(): MCPServerMetadata[];
+    startAll(options?: Record<string, unknown>): Promise<void>;
+    stopAll(): Promise<void>;
+    private startConfigured;
+    private resolveMetadata;
+    private normalizeIdentifier;
+    private ensureUniqueId;
+    private createAnonymousSlug;
+}
 
 /**
- * Server provider interface
+ * Client information for MCP
  */
-interface IServerProvider {
-    start(): Promise<{
-        port: number;
-    }>;
-    stop(): Promise<void>;
-    isRunning(): boolean;
+interface ClientInfo {
+    /**
+     * Client name
+     */
+    name: string;
+    /**
+     * Client version
+     */
+    version: string;
+    /**
+     * Allow additional properties for SDK compatibility
+     */
+    [key: string]: unknown;
 }
 /**
- * Server provider dependencies
+ * Transport error from MCP
  */
-interface ServerProviderDeps {
-    agentRegistry: {
-        getAgent(id: string): Agent | undefined;
-        getAllAgents(): Agent[];
-        getAgentCount(): number;
-        removeAgent(id: string): boolean;
-        registerAgent(agent: Agent): void;
-        getGlobalVoltOpsClient(): VoltOpsClient | undefined;
-        getGlobalLogger(): Logger | undefined;
-    };
-    workflowRegistry: {
-        getWorkflow(id: string): RegisteredWorkflow | undefined;
-        getWorkflowsForApi(): unknown[];
-        getWorkflowDetailForApi(id: string): unknown;
-        getWorkflowCount(): number;
-        on(event: string, handler: (...args: any[]) => void): void;
-        off(event: string, handler: (...args: any[]) => void): void;
-        activeExecutions: Map<string, WorkflowSuspendController>;
-        resumeSuspendedWorkflow(workflowId: string, executionId: string, resumeData?: any, stepId?: string): Promise<any>;
-    };
-    logger?: Logger;
-    voltOpsClient?: VoltOpsClient;
-    observability?: VoltAgentObservability;
+interface TransportError extends Error {
+    /**
+     * Error code
+     */
+    code?: string;
+    /**
+     * Error details
+     */
+    details?: unknown;
 }
 /**
- * Server provider factory type
+ * Configuration for MCP client
  */
-type ServerProviderFactory = (deps: ServerProviderDeps) => IServerProvider;
+type MCPClientConfig = {
+    /**
+     * Client information
+     */
+    clientInfo: ClientInfo;
+    /**
+     * MCP server configuration
+     */
+    server: MCPServerConfig;
+    /**
+     * MCP capabilities
+     */
+    capabilities?: ClientCapabilities;
+    /**
+     * Timeout in milliseconds for MCP requests
+     * @default 30000
+     */
+    timeout?: number;
+};
 /**
- * Server API response types
+ * MCP server configuration options
  */
-interface ServerAgentResponse {
-    id: string;
-    name: string;
-    description: string;
-    status: AgentStatus;
-    model: string;
-    tools: ToolStatusInfo[];
-    memory?: Record<string, unknown>;
-    subAgents?: ServerAgentResponse[];
-    isTelemetryEnabled?: boolean;
-}
-interface ServerWorkflowResponse {
-    id: string;
-    name: string;
-    purpose: string;
-    stepsCount: number;
-    status: "idle" | "running" | "completed" | "error";
-    steps: Array<{
-        id: string;
-        name: string;
-        purpose: string | null;
-        type: string;
-        agentId?: string;
-        agentName?: string;
-    }>;
-}
-interface ServerApiResponse<T> {
-    success: boolean;
-    data?: T;
-    error?: string;
-}
+type MCPServerConfig = HTTPServerConfig | SSEServerConfig | StreamableHTTPServerConfig | StdioServerConfig;
 /**
- * VoltAgent constructor options
+ * HTTP-based MCP server configuration with automatic fallback
+ * Tries streamable HTTP first, falls back to SSE if not supported
  */
-type VoltAgentOptions = {
-    agents: Record<string, Agent>;
+type HTTPServerConfig = {
     /**
-     * Optional workflows to register with VoltAgent
-     * Can be either Workflow instances or WorkflowChain instances
+     * Type of server connection
      */
-    workflows?: Record<string, Workflow<DangerouslyAllowAny, DangerouslyAllowAny, DangerouslyAllowAny, DangerouslyAllowAny> | WorkflowChain<DangerouslyAllowAny, DangerouslyAllowAny, DangerouslyAllowAny, DangerouslyAllowAny, DangerouslyAllowAny>>;
+    type: "http";
     /**
-     * Server provider factory function
-     * Example: honoServer({ port: 3141, enableSwaggerUI: true })
+     * URL of the MCP server
      */
-    server?: ServerProviderFactory;
+    url: string;
     /**
-     * Unified VoltOps client for telemetry and prompt management
-     * Replaces the old telemetryExporter approach with a comprehensive solution.
+     * Request initialization options
      */
-    voltOpsClient?: VoltOpsClient;
+    requestInit?: RequestInit;
     /**
-     * Observability instance for OpenTelemetry-compliant tracing
-     * Allows sharing the same observability instance between VoltAgent and Agents
-     * If not provided, creates a default instance with in-memory storage
+     * Event source initialization options (used for SSE fallback)
      */
-    observability?: VoltAgentObservability;
+    eventSourceInit?: EventSourceInit;
     /**
-     * Global logger instance to use across all agents and workflows
-     * If not provided, a default logger will be created
+     * Optional maximum request timeout in milliseconds.
+     * If provided, passed to MCPClient as the per-request timeout.
      */
-    logger?: Logger;
+    timeout?: number;
+};
+/**
+ * SSE-based MCP server configuration (explicit SSE transport)
+ */
+type SSEServerConfig = {
     /**
-     * @deprecated Use `server.port` instead
+     * Type of server connection
      */
-    port?: number;
+    type: "sse";
     /**
-     * @deprecated Use `server.autoStart` instead
+     * URL of the MCP server
      */
-    autoStart?: boolean;
-    checkDependencies?: boolean;
+    url: string;
     /**
-     * @deprecated Server configuration is now done through server provider
+     * Request initialization options
      */
-    customEndpoints?: unknown[];
+    requestInit?: RequestInit;
     /**
-     * @deprecated Server configuration is now done through server provider
+     * Event source initialization options
      */
-    enableSwaggerUI?: boolean;
+    eventSourceInit?: EventSourceInit;
+    /**
+     * Optional maximum request timeout in milliseconds.
+     * If provided, passed to MCPClient as the per-request timeout.
+     */
+    timeout?: number;
 };
-
 /**
- * Prompt management utilities for agent prompt tuning
+ * Streamable HTTP-based MCP server configuration (no fallback)
  */
-type ExtractVariableNames<T extends string> = T extends `${string}{{${infer Param}}}${infer Rest}` ? Param | ExtractVariableNames<Rest> : never;
-type AllowedVariableValue = string | number | boolean | undefined | null;
-type TemplateVariables<T extends string> = {
-    [K in ExtractVariableNames<T>]: AllowedVariableValue;
-};
-type PromptTemplate<T extends string> = [ExtractVariableNames<T>] extends [never] ? {
-    template: T;
-    variables?: Record<string, never>;
-} : {
-    template: T;
-    variables: TemplateVariables<T>;
+type StreamableHTTPServerConfig = {
+    /**
+     * Type of server connection
+     */
+    type: "streamable-http";
+    /**
+     * URL of the MCP server
+     */
+    url: string;
+    /**
+     * Request initialization options
+     */
+    requestInit?: RequestInit;
+    /**
+     * Session ID for the connection
+     */
+    sessionId?: string;
+    /**
+     * Optional maximum request timeout in milliseconds.
+     * If provided, passed to MCPClient as the per-request timeout.
+     */
+    timeout?: number;
 };
-type PromptCreator<T extends string> = (extraVariables?: Partial<TemplateVariables<T>>) => string;
 /**
- * Creates a type-safe, customizable prompt function from a template string.
- * Variable names are automatically inferred from the template `{{variable}}` syntax.
- *
- * @param template - The template string with `{{variable}}` placeholders.
- * @param variables - An object containing the default values for the template variables.
- * @returns A function that takes optional extra variables and returns the processed prompt string.
+ * Stdio-based MCP server configuration
  */
-declare const createPrompt: <T extends string>({ template, variables, }: PromptTemplate<T>) => PromptCreator<T>;
-
+type StdioServerConfig = {
+    /**
+     * Type of server connection
+     */
+    type: "stdio";
+    /**
+     * Command to run the MCP server
+     */
+    command: string;
+    /**
+     * Arguments to pass to the command
+     */
+    args?: string[];
+    /**
+     * Environment variables for the MCP server process
+     */
+    env?: Record<string, string>;
+    /**
+     * Working directory for the MCP server process
+     */
+    cwd?: string;
+    /**
+     * Optional maximum request timeout in milliseconds.
+     * If provided, passed to MCPClient as the per-request timeout.
+     */
+    timeout?: number;
+};
 /**
- * Node types for agents, tools, and other components
+ * Tool call request
  */
-declare enum NodeType {
-    AGENT = "agent",
-    SUBAGENT = "agent",
-    TOOL = "tool",
-    MEMORY = "memory",
-    MESSAGE = "message",
-    OUTPUT = "output",
-    RETRIEVER = "retriever",
-    VECTOR = "vector",
-    EMBEDDING = "embedding",
-    WORKFLOW_STEP = "workflow_step",
-    WORKFLOW_AGENT_STEP = "workflow_agent_step",
-    WORKFLOW_FUNC_STEP = "workflow_func_step",
-    WORKFLOW_CONDITIONAL_STEP = "workflow_conditional_step",
-    WORKFLOW_PARALLEL_ALL_STEP = "workflow_parallel_all_step",
-    WORKFLOW_PARALLEL_RACE_STEP = "workflow_parallel_race_step"
-}
-/**
- * Standard node ID creation function
- * @param type Node type
- * @param name Main identifier (tool name, agent name, etc.)
- * @param ownerId Owner ID (optional)
- * @returns Standard formatted node ID
- */
-declare const createNodeId: (type: NodeType, name: string, ownerId?: string) => string;
-/**
- * Function to extract node type from NodeID
- * @param nodeId Node ID
- * @returns NodeType or null (if type cannot be found)
- */
-declare const getNodeTypeFromNodeId: (nodeId: string) => NodeType | null;
-/**
- * Workflow step types enum
- */
-type WorkflowStepType = "agent" | "func" | "conditional-when" | "parallel-all" | "parallel-race";
-/**
- * Create a workflow step node ID with consistent pattern
- * @param stepType Type of workflow step
- * @param stepIndex Index of step in workflow
- * @param workflowId Workflow identifier
- * @param options Additional options for node ID generation
- * @returns Consistent workflow step node ID
- */
-declare const createWorkflowStepNodeId: (stepType: WorkflowStepType, stepIndex: number, workflowId: string, options?: {
-    agentId?: string;
-    parallelIndex?: number;
-    stepName?: string;
-    stepId?: string;
-}) => string;
-/**
- * Get NodeType for workflow step type
- * @param stepType Workflow step type
- * @returns Corresponding NodeType
- */
-declare const getWorkflowStepNodeType: (stepType: WorkflowStepType) => NodeType;
-/**
- * Extract workflow step information from node ID
- * @param nodeId Workflow step node ID
- * @returns Extracted workflow step info or null
- */
-declare const extractWorkflowStepInfo: (nodeId: string) => {
-    stepType: WorkflowStepType;
-    stepIndex: number;
-    workflowId: string;
-    agentId?: string;
-    parallelIndex?: number;
-    stepName?: string;
-} | null;
-
-/**
- * Tool call interface
- */
-interface ToolCall {
-    id: string;
-    type: "function";
-    function: {
-        name: string;
-        arguments: string;
-    };
-}
-/**
- * Converts a Zod-like schema to a JSON representation usable in the UI
- * @param schema Any Zod schema object
- * @returns A JSON Schema compatible representation of the Zod schema
- */
-declare function zodSchemaToJsonUI(schema: any): any;
-
-type UpdateOptions = {
-    filter?: string;
-    useCache?: boolean;
-    forceRefresh?: boolean;
-};
-/**
- * Package update info with semver details
- */
-type PackageUpdateInfo = {
+type MCPToolCall = {
+    /**
+     * Name of the tool to call
+     */
     name: string;
-    installed: string;
-    latest: string;
-    type: "major" | "minor" | "patch" | "latest";
-    packageJson: string;
+    /**
+     * Arguments to pass to the tool
+     */
+    arguments: Record<string, unknown>;
 };
 /**
- * Checks for dependency updates using native package manager commands
- * @returns Object containing update information
+ * Tool call result
  */
-declare const checkForUpdates: (packagePath?: string, options?: UpdateOptions) => Promise<{
-    hasUpdates: boolean;
-    updates: PackageUpdateInfo[];
-    count: number;
-    message: string;
-}>;
+type MCPToolResult = {
+    /**
+     * Result content from the tool
+     */
+    content: unknown;
+};
 /**
- * Update all packages that have available updates using native package manager
- * @param packagePath Optional path to package.json, uses current directory if not provided
- * @returns Result of the update operation
+ * MCP client events
  */
-declare const updateAllPackages: (packagePath?: string) => Promise<{
-    success: boolean;
-    message: string;
-    updatedPackages?: string[];
-    requiresRestart?: boolean;
-}>;
+interface MCPClientEvents {
+    /**
+     * Emitted when the client connects to the server
+     */
+    connect: () => void;
+    /**
+     * Emitted when the client disconnects from the server
+     */
+    disconnect: () => void;
+    /**
+     * Emitted when an error occurs
+     */
+    error: (error: Error | TransportError) => void;
+    /**
+     * Emitted when a tool call completes
+     */
+    toolCall: (name: string, args: Record<string, unknown>, result: unknown) => void;
+}
 /**
- * Update a single package to its latest version using native package manager
- * @param packageName Name of the package to update
- * @param packagePath Optional path to package.json, uses current directory if not provided
- * @returns Result of the update operation
+ * A record of tools along with a helper method to convert them to an array.
  */
-declare const updateSinglePackage: (packageName: string, packagePath?: string) => Promise<{
-    success: boolean;
-    message: string;
-    packageName: string;
-    requiresRestart?: boolean;
-}>;
-
+type ToolsetWithTools = Record<string, AnyToolConfig> & {
+    /**
+     * Converts the toolset to an array of BaseTool objects.
+     */
+    getTools: () => Tool<any>[];
+};
 /**
- * Safely parse JSON string. If parsing fails, returns the original value.
- * @param value String to parse as JSON
- * @returns Parsed JSON object or original value if parsing fails
+ * Any tool configuration
  */
-declare function safeJsonParse(value: string | null | undefined): any;
-declare function serializeValueForDebug(value: unknown): unknown;
+type AnyToolConfig = Tool<any>;
 
 /**
- * Type guard to check if content is a string
- */
-declare function isTextContent(content: MessageContent): content is string;
-/**
- * Type guard to check if content is structured (array of content parts)
- */
-declare function isStructuredContent(content: MessageContent): content is Array<any>;
-/**
- * Check if content has any text parts
- */
-declare function hasTextPart(content: MessageContent): boolean;
-/**
- * Check if content has any image parts
- */
-declare function hasImagePart(content: MessageContent): boolean;
-/**
- * Check if content has any file parts
- */
-declare function hasFilePart(content: MessageContent): boolean;
-/**
- * Extract text from message content
- */
-declare function extractText(content: MessageContent): string;
-/**
- * Extract all text parts from structured content
- */
-declare function extractTextParts(content: MessageContent): Array<{
-    type: "text";
-    text: string;
-}>;
-/**
- * Extract image parts from message content
- */
-declare function extractImageParts(content: MessageContent): Array<any>;
-/**
- * Extract file parts from message content
- */
-declare function extractFileParts(content: MessageContent): Array<any>;
-/**
- * Transform text content in a message
- */
-declare function transformTextContent(content: MessageContent, transformer: (text: string) => string): MessageContent;
-/**
- * Map UIMessage text parts with a transformer function
- */
-declare function mapMessageContent(message: UIMessage, transformer: (text: string) => string): UIMessage;
-/**
- * Filter content parts by type
- */
-declare function filterContentParts(content: MessageContent, predicate: (part: any) => boolean): MessageContent;
-/**
- * Normalize content to always be an array
- */
-declare function normalizeToArray(content: MessageContent): Array<any>;
-/**
- * Normalize content to the most compact form
- */
-declare function normalizeContent(content: MessageContent): MessageContent;
-/**
- * Builder class for creating message content
+ * Client for interacting with Model Context Protocol (MCP) servers.
+ * Wraps the official MCP SDK client to provide a higher-level interface.
+ * Internal implementation differs from original source.
  */
-declare class MessageContentBuilder {
-    private parts;
+declare class MCPClient extends EventEmitter {
     /**
-     * Add a text part
+     * Underlying MCP client instance from the SDK.
      */
-    addText(text: string): this;
+    private client;
     /**
-     * Add an image part
+     * Communication channel (transport layer) for MCP interactions.
      */
-    addImage(image: string | Uint8Array): this;
+    private transport;
     /**
-     * Add a file part
+     * Tracks the connection status to the server.
      */
-    addFile(file: string | Uint8Array, mimeType?: string): this;
+    private connected;
     /**
-     * Add a custom part
+     * Maximum time allowed for requests in milliseconds.
      */
-    addPart(part: any): this;
+    private readonly timeout;
     /**
-     * Build the final content
+     * Logger instance
      */
-    build(): MessageContent;
-    /**
-     * Build as array (always returns array)
-     */
-    buildAsArray(): Array<any>;
+    private logger;
     /**
-     * Clear all parts
+     * Information identifying this client to the server.
      */
-    clear(): this;
+    private readonly clientInfo;
     /**
-     * Get current parts count
+     * Server configuration for fallback attempts.
      */
-    get length(): number;
-}
-/**
- * Convenience function to add timestamp to user messages (UIMessage only)
- */
-declare function addTimestampToMessage(message: UIMessage, timestamp?: string): UIMessage;
-/**
- * Convenience function to prepend text to UIMessage text parts
- */
-declare function prependToMessage(message: UIMessage, prefix: string): UIMessage;
-/**
- * Convenience function to append text to UIMessage text parts
- */
-declare function appendToMessage(message: UIMessage, suffix: string): UIMessage;
-/**
- * Check if UIMessage has any content
- */
-declare function hasContent(message: UIMessage): boolean;
-/**
- * Get content length (text characters or array items)
- */
-declare function getContentLength(content: MessageContent): number;
-/**
- * Combined message helpers object for easy importing
- */
-declare const messageHelpers: {
-    isTextContent: typeof isTextContent;
-    isStructuredContent: typeof isStructuredContent;
-    hasTextPart: typeof hasTextPart;
-    hasImagePart: typeof hasImagePart;
-    hasFilePart: typeof hasFilePart;
-    extractText: typeof extractText;
-    extractTextParts: typeof extractTextParts;
-    extractImageParts: typeof extractImageParts;
-    extractFileParts: typeof extractFileParts;
-    transformTextContent: typeof transformTextContent;
-    mapMessageContent: typeof mapMessageContent;
-    filterContentParts: typeof filterContentParts;
-    normalizeToArray: typeof normalizeToArray;
-    normalizeContent: typeof normalizeContent;
-    addTimestampToMessage: typeof addTimestampToMessage;
-    prependToMessage: typeof prependToMessage;
-    appendToMessage: typeof appendToMessage;
-    hasContent: typeof hasContent;
-    getContentLength: typeof getContentLength;
-    MessageContentBuilder: typeof MessageContentBuilder;
-};
-
-/**
- * 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.
- *
- * @param retriever - The retriever instance to convert to a tool
- * @param options - Options for customizing the tool
- * @returns An AgentTool that can be added to an agent's tools
- *
- * @example
- * ```typescript
- * const retriever = new SimpleRetriever();
- * const searchTool = createRetrieverTool(retriever, {
- *   name: "search_knowledge",
- *   description: "Searches the knowledge base for information"
- * });
- *
- * agent.addTool(searchTool);
- * ```
- */
-declare const createRetrieverTool: (retriever: Retriever, options?: {
-    name?: string;
-    description?: string;
-}) => AgentTool;
-
-/**
- * Client information for MCP
- */
-interface ClientInfo {
+    private readonly serverConfig;
     /**
-     * Client name
+     * Whether to attempt SSE fallback if streamable HTTP fails.
      */
-    name: string;
+    private shouldAttemptFallback;
     /**
-     * Client version
+     * Client capabilities for re-initialization.
      */
-    version: string;
+    private readonly capabilities;
     /**
-     * Allow additional properties for SDK compatibility
+     * Get server info for logging
      */
-    [key: string]: unknown;
-}
-/**
- * Transport error from MCP
- */
-interface TransportError extends Error {
+    private getServerInfo;
     /**
-     * Error code
+     * Creates a new MCP client instance.
+     * @param config Configuration for the client, including server details and client identity.
      */
-    code?: string;
+    constructor(config: MCPClientConfig);
     /**
-     * Error details
+     * Sets up handlers for events from the underlying SDK client.
      */
-    details?: unknown;
-}
-/**
- * Model Context Protocol (MCP) configuration options
- */
-type MCPOptions = {
+    private setupEventHandlers;
     /**
-     * Whether MCP is enabled
+     * Establishes a connection to the configured MCP server.
+     * Idempotent: does nothing if already connected.
      */
-    enabled: boolean;
+    connect(): Promise<void>;
     /**
-     * MCP API endpoint
+     * Attempts to connect using SSE transport as a fallback.
+     * @param originalError The error from the initial connection attempt.
      */
-    endpoint?: string;
+    private attemptSSEFallback;
     /**
-     * API key for MCP authentication
+     * Closes the connection to the MCP server.
+     * Idempotent: does nothing if not connected.
      */
-    apiKey?: string;
+    disconnect(): Promise<void>;
     /**
-     * Control parameters for MCP
+     * Fetches the definitions of available tools from the server.
+     * @returns A record mapping tool names to their definitions (schema, description).
      */
-    controlParams?: Record<string, unknown>;
+    listTools(): Promise<Record<string, unknown>>;
     /**
-     * Whether to fall back to the provider if MCP fails
+     * Builds executable Tool objects from the server's tool definitions.
+     * These tools include an `execute` method for calling the remote tool.
+     * @returns A record mapping namespaced tool names (`clientName_toolName`) to executable Tool objects.
      */
-    fallbackToProvider?: boolean;
+    getAgentTools(): Promise<Record<string, Tool<any>>>;
     /**
-     * Timeout in milliseconds for MCP requests
-     * @default 30000
+     * Executes a specified tool on the remote MCP server.
+     * @param toolCall Details of the tool to call, including name and arguments.
+     * @returns The result content returned by the tool.
      */
-    timeout?: number;
-};
-/**
- * Configuration for MCP client
- */
-type MCPClientConfig = {
+    callTool(toolCall: MCPToolCall): Promise<MCPToolResult>;
     /**
-     * Client information
+     * Retrieves a list of resource identifiers available on the server.
+     * @returns A promise resolving to an array of resource ID strings.
      */
-    clientInfo: ClientInfo;
+    listResources(): Promise<string[]>;
     /**
-     * MCP server configuration
+     * Ensures the client is connected before proceeding with an operation.
+     * Attempts to connect if not currently connected.
+     * @throws Error if connection attempt fails.
      */
-    server: MCPServerConfig;
+    private ensureConnected;
     /**
-     * MCP capabilities
+     * Emits an 'error' event, ensuring the payload is always an Error object.
+     * @param error The error encountered, can be of any type.
      */
-    capabilities?: ClientCapabilities;
+    private emitError;
     /**
-     * Timeout in milliseconds for MCP requests
-     * @default 30000
+     * Type guard to check if a server configuration is for an HTTP server.
+     * @param server The server configuration object.
+     * @returns True if the configuration type is 'http', false otherwise.
      */
-    timeout?: number;
-};
-/**
- * MCP server configuration options
- */
-type MCPServerConfig = HTTPServerConfig | SSEServerConfig | StreamableHTTPServerConfig | StdioServerConfig;
-/**
- * HTTP-based MCP server configuration with automatic fallback
- * Tries streamable HTTP first, falls back to SSE if not supported
- */
-type HTTPServerConfig = {
+    private isHTTPServer;
     /**
-     * Type of server connection
+     * Type guard to check if a server configuration is for an SSE server.
+     * @param server The server configuration object.
+     * @returns True if the configuration type is 'sse', false otherwise.
      */
-    type: "http";
+    private isSSEServer;
     /**
-     * URL of the MCP server
+     * Type guard to check if a server configuration is for a Streamable HTTP server.
+     * @param server The server configuration object.
+     * @returns True if the configuration type is 'streamable-http', false otherwise.
      */
-    url: string;
+    private isStreamableHTTPServer;
     /**
-     * Request initialization options
+     * Type guard to check if a server configuration is for a Stdio server.
+     * @param server The server configuration object.
+     * @returns True if the configuration type is 'stdio', false otherwise.
      */
-    requestInit?: RequestInit;
+    private isStdioServer;
     /**
-     * Event source initialization options (used for SSE fallback)
+     * Overrides EventEmitter's 'on' method for type-safe event listening.
+     * Uses the original `MCPClientEvents` for event types.
      */
-    eventSourceInit?: EventSourceInit;
+    on<E extends keyof MCPClientEvents>(event: E, listener: MCPClientEvents[E]): this;
     /**
-     * Optional maximum request timeout in milliseconds.
-     * If provided, passed to MCPClient as the per-request timeout.
+     * Overrides EventEmitter's 'emit' method for type-safe event emission.
+     * Uses the original `MCPClientEvents` for event types.
      */
-    timeout?: number;
-};
+    emit<E extends keyof MCPClientEvents>(event: E, ...args: Parameters<MCPClientEvents[E]>): boolean;
+}
+
 /**
- * SSE-based MCP server configuration (explicit SSE transport)
+ * Configuration manager for Model Context Protocol (MCP).
+ * Handles multiple MCP server connections and tool management.
+ * NOTE: This version does NOT manage singleton instances automatically.
  */
-type SSEServerConfig = {
+declare class MCPConfiguration<TServerKeys extends string = string> {
     /**
-     * Type of server connection
+     * Map of server configurations keyed by server names.
      */
-    type: "sse";
+    private readonly serverConfigs;
     /**
-     * URL of the MCP server
+     * Map of connected MCP clients keyed by server names (local cache).
      */
-    url: string;
+    private readonly mcpClientsById;
     /**
-     * Request initialization options
+     * Creates a new, independent MCP configuration instance.
+     * @param options Configuration options including server definitions.
      */
-    requestInit?: RequestInit;
+    constructor(options: {
+        servers: Record<TServerKeys, MCPServerConfig>;
+    });
     /**
-     * Event source initialization options
+     * Type guard to check if an object conforms to the basic structure of AnyToolConfig.
      */
-    eventSourceInit?: EventSourceInit;
+    private isAnyToolConfigStructure;
     /**
-     * Optional maximum request timeout in milliseconds.
-     * If provided, passed to MCPClient as the per-request timeout.
+     * Disconnects all associated MCP clients for THIS instance.
      */
-    timeout?: number;
-};
-/**
- * Streamable HTTP-based MCP server configuration (no fallback)
- */
-type StreamableHTTPServerConfig = {
+    disconnect(): Promise<void>;
     /**
-     * Type of server connection
+     * Retrieves agent-ready tools from all configured MCP servers for this instance.
+     * @returns A flat array of all agent-ready tools.
      */
-    type: "streamable-http";
+    getTools(): Promise<Tool<any>[]>;
     /**
-     * URL of the MCP server
+     * 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.
      */
-    url: string;
-    /**
-     * Request initialization options
-     */
-    requestInit?: RequestInit;
-    /**
-     * Session ID for the connection
-     */
-    sessionId?: string;
-    /**
-     * Optional maximum request timeout in milliseconds.
-     * If provided, passed to MCPClient as the per-request timeout.
-     */
-    timeout?: number;
-};
-/**
- * Stdio-based MCP server configuration
- */
-type StdioServerConfig = {
-    /**
-     * Type of server connection
-     */
-    type: "stdio";
-    /**
-     * Command to run the MCP server
-     */
-    command: string;
-    /**
-     * Arguments to pass to the command
-     */
-    args?: string[];
+    getRawTools(): Promise<Record<string, AnyToolConfig>>;
     /**
-     * Environment variables for the MCP server process
+     * Retrieves agent-ready toolsets grouped by server name for this instance.
+     * @returns A record where keys are server names and values are agent-ready toolsets.
      */
-    env?: Record<string, string>;
+    getToolsets(): Promise<Record<TServerKeys, ToolsetWithTools>>;
     /**
-     * Working directory for the MCP server process
+     * Retrieves raw tool definitions grouped by server name for this instance.
+     * @returns A record where keys are server names and values are records of raw tools.
      */
-    cwd?: string;
+    getRawToolsets(): Promise<Record<TServerKeys, Record<string, AnyToolConfig>>>;
     /**
-     * Optional maximum request timeout in milliseconds.
-     * If provided, passed to MCPClient as the per-request timeout.
+     * Retrieves a specific connected MCP client by its server name for this instance.
      */
-    timeout?: number;
-};
-/**
- * Tool call request
- */
-type MCPToolCall = {
+    getClient(serverName: TServerKeys): Promise<MCPClient | undefined>;
     /**
-     * Name of the tool to call
+     * Retrieves all configured MCP clients for this instance, ensuring they are connected.
      */
-    name: string;
+    getClients(): Promise<Record<TServerKeys, MCPClient>>;
     /**
-     * Arguments to pass to the tool
+     * Internal helper to get/create/connect a client for this instance.
+     * Manages the local mcpClientsById cache.
      */
-    arguments: Record<string, unknown>;
-};
+    private getConnectedClient;
+}
+
 /**
- * Tool call result
+ * Basic type definitions for VoltAgent Core
  */
-type MCPToolResult = {
-    /**
-     * Result content from the tool
-     */
-    content: unknown;
-};
+
+interface MCPLoggingAdapter {
+    setLevel?(level: string): Promise<void> | void;
+    getLevel?(): Promise<string | undefined> | string | undefined;
+}
+interface MCPPromptsAdapter {
+    listPrompts(): Promise<unknown[]>;
+    getPrompt(params: unknown): Promise<unknown>;
+}
+interface MCPResourcesAdapter {
+    listResources(): Promise<unknown>;
+    readResource(uri: string): Promise<unknown>;
+    listResourceTemplates?(): Promise<unknown>;
+    subscribe?(params: unknown, headers?: Record<string, string>): Promise<void> | void;
+    unsubscribe?(params: unknown): Promise<void> | void;
+}
+interface MCPElicitationAdapter {
+    sendRequest(request: unknown): Promise<unknown>;
+}
+
 /**
- * MCP client events
+ * Server provider interface
  */
-interface MCPClientEvents {
-    /**
-     * Emitted when the client connects to the server
-     */
-    connect: () => void;
-    /**
-     * Emitted when the client disconnects from the server
-     */
-    disconnect: () => void;
-    /**
-     * Emitted when an error occurs
-     */
-    error: (error: Error | TransportError) => void;
-    /**
-     * Emitted when a tool call completes
-     */
-    toolCall: (name: string, args: Record<string, unknown>, result: unknown) => void;
+interface IServerProvider {
+    start(): Promise<{
+        port: number;
+    }>;
+    stop(): Promise<void>;
+    isRunning(): boolean;
 }
 /**
- * Map of toolset names to tools
+ * Server provider dependencies
  */
-type ToolsetMap = Record<string, ToolsetWithTools>;
+interface ServerProviderDeps {
+    agentRegistry: {
+        getAgent(id: string): Agent | undefined;
+        getAllAgents(): Agent[];
+        getAgentCount(): number;
+        removeAgent(id: string): boolean;
+        registerAgent(agent: Agent): void;
+        getGlobalVoltOpsClient(): VoltOpsClient | undefined;
+        getGlobalLogger(): Logger | undefined;
+    };
+    workflowRegistry: {
+        getWorkflow(id: string): RegisteredWorkflow | undefined;
+        getWorkflowsForApi(): unknown[];
+        getWorkflowDetailForApi(id: string): unknown;
+        getWorkflowCount(): number;
+        on(event: string, handler: (...args: any[]) => void): void;
+        off(event: string, handler: (...args: any[]) => void): void;
+        activeExecutions: Map<string, WorkflowSuspendController>;
+        resumeSuspendedWorkflow(workflowId: string, executionId: string, resumeData?: any, stepId?: string): Promise<any>;
+    };
+    logger?: Logger;
+    voltOpsClient?: VoltOpsClient;
+    observability?: VoltAgentObservability;
+    mcp?: {
+        registry: MCPServerRegistry;
+    };
+    a2a?: {
+        registry: A2AServerRegistry;
+    };
+}
 /**
- * A record of tools along with a helper method to convert them to an array.
+ * Server provider factory type
  */
-type ToolsetWithTools = Record<string, AnyToolConfig> & {
-    /**
-     * Converts the toolset to an array of BaseTool objects.
-     */
-    getTools: () => Tool<any>[];
-};
+type ServerProviderFactory = (deps: ServerProviderDeps) => IServerProvider;
 /**
- * Any tool configuration
+ * Server API response types
  */
-type AnyToolConfig = Tool<any>;
-
+interface ServerAgentResponse {
+    id: string;
+    name: string;
+    description: string;
+    status: AgentStatus;
+    model: string;
+    tools: ToolStatusInfo[];
+    memory?: Record<string, unknown>;
+    subAgents?: ServerAgentResponse[];
+    isTelemetryEnabled?: boolean;
+}
+interface ServerWorkflowResponse {
+    id: string;
+    name: string;
+    purpose: string;
+    stepsCount: number;
+    status: "idle" | "running" | "completed" | "error";
+    steps: Array<{
+        id: string;
+        name: string;
+        purpose: string | null;
+        type: string;
+        agentId?: string;
+        agentName?: string;
+    }>;
+}
+interface ServerApiResponse<T> {
+    success: boolean;
+    data?: T;
+    error?: string;
+}
 /**
- * Client for interacting with Model Context Protocol (MCP) servers.
- * Wraps the official MCP SDK client to provide a higher-level interface.
- * Internal implementation differs from original source.
+ * VoltAgent constructor options
  */
-declare class MCPClient extends EventEmitter {
-    /**
-     * Underlying MCP client instance from the SDK.
-     */
-    private client;
-    /**
-     * Communication channel (transport layer) for MCP interactions.
-     */
-    private transport;
-    /**
-     * Tracks the connection status to the server.
-     */
-    private connected;
-    /**
-     * Maximum time allowed for requests in milliseconds.
-     */
-    private readonly timeout;
-    /**
-     * Logger instance
-     */
-    private logger;
+type VoltAgentOptions = {
+    agents: Record<string, Agent>;
     /**
-     * Information identifying this client to the server.
+     * Optional workflows to register with VoltAgent
+     * Can be either Workflow instances or WorkflowChain instances
      */
-    private readonly clientInfo;
+    workflows?: Record<string, Workflow<DangerouslyAllowAny, DangerouslyAllowAny, DangerouslyAllowAny, DangerouslyAllowAny> | WorkflowChain<DangerouslyAllowAny, DangerouslyAllowAny, DangerouslyAllowAny, DangerouslyAllowAny, DangerouslyAllowAny>>;
     /**
-     * Server configuration for fallback attempts.
+     * Server provider factory function
+     * Example: honoServer({ port: 3141, enableSwaggerUI: true })
      */
-    private readonly serverConfig;
+    server?: ServerProviderFactory;
     /**
-     * Whether to attempt SSE fallback if streamable HTTP fails.
+     * Unified VoltOps client for telemetry and prompt management
+     * Replaces the old telemetryExporter approach with a comprehensive solution.
      */
-    private shouldAttemptFallback;
+    voltOpsClient?: VoltOpsClient;
     /**
-     * Client capabilities for re-initialization.
+     * Observability instance for OpenTelemetry-compliant tracing
+     * Allows sharing the same observability instance between VoltAgent and Agents
+     * If not provided, creates a default instance with in-memory storage
      */
-    private readonly capabilities;
+    observability?: VoltAgentObservability;
     /**
-     * Get server info for logging
+     * Global logger instance to use across all agents and workflows
+     * If not provided, a default logger will be created
      */
-    private getServerInfo;
+    logger?: Logger;
     /**
-     * Creates a new MCP client instance.
-     * @param config Configuration for the client, including server details and client identity.
+     * Optional collection of MCP servers to register alongside the primary server.
+     * Enables exposing multiple VoltAgent surfaces through separate MCP endpoints.
      */
-    constructor(config: MCPClientConfig);
+    mcpServers?: Record<string, MCPServerLike | MCPServerFactory>;
     /**
-     * Sets up handlers for events from the underlying SDK client.
+     * Optional collection of A2A servers to expose agents via the Agent-to-Agent protocol.
      */
-    private setupEventHandlers;
+    a2aServers?: Record<string, A2AServerLike | A2AServerFactory>;
     /**
-     * Establishes a connection to the configured MCP server.
-     * Idempotent: does nothing if already connected.
+     * @deprecated Use `server.port` instead
      */
-    connect(): Promise<void>;
+    port?: number;
     /**
-     * Attempts to connect using SSE transport as a fallback.
-     * @param originalError The error from the initial connection attempt.
+     * @deprecated Use `server.autoStart` instead
      */
-    private attemptSSEFallback;
+    autoStart?: boolean;
+    checkDependencies?: boolean;
     /**
-     * Closes the connection to the MCP server.
-     * Idempotent: does nothing if not connected.
+     * @deprecated Server configuration is now done through server provider
      */
-    disconnect(): Promise<void>;
+    customEndpoints?: unknown[];
     /**
-     * Fetches the definitions of available tools from the server.
-     * @returns A record mapping tool names to their definitions (schema, description).
+     * @deprecated Server configuration is now done through server provider
      */
-    listTools(): Promise<Record<string, unknown>>;
-    /**
-     * Builds executable Tool objects from the server's tool definitions.
-     * These tools include an `execute` method for calling the remote tool.
-     * @returns A record mapping namespaced tool names (`clientName_toolName`) to executable Tool objects.
-     */
-    getAgentTools(): 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.
-     * @returns The result content returned by the tool.
-     */
-    callTool(toolCall: MCPToolCall): Promise<MCPToolResult>;
-    /**
-     * Retrieves a list of resource identifiers available on the server.
-     * @returns A promise resolving to an array of resource ID strings.
-     */
-    listResources(): Promise<string[]>;
-    /**
-     * Ensures the client is connected before proceeding with an operation.
-     * Attempts to connect if not currently connected.
-     * @throws Error if connection attempt fails.
-     */
-    private ensureConnected;
-    /**
-     * Emits an 'error' event, ensuring the payload is always an Error object.
-     * @param error The error encountered, can be of any type.
-     */
-    private emitError;
-    /**
-     * Type guard to check if a server configuration is for an HTTP server.
-     * @param server The server configuration object.
-     * @returns True if the configuration type is 'http', false otherwise.
-     */
-    private isHTTPServer;
-    /**
-     * Type guard to check if a server configuration is for an SSE server.
-     * @param server The server configuration object.
-     * @returns True if the configuration type is 'sse', false otherwise.
-     */
-    private isSSEServer;
-    /**
-     * Type guard to check if a server configuration is for a Streamable HTTP server.
-     * @param server The server configuration object.
-     * @returns True if the configuration type is 'streamable-http', false otherwise.
-     */
-    private isStreamableHTTPServer;
-    /**
-     * Type guard to check if a server configuration is for a Stdio server.
-     * @param server The server configuration object.
-     * @returns True if the configuration type is 'stdio', false otherwise.
-     */
-    private isStdioServer;
-    /**
-     * Overrides EventEmitter's 'on' method for type-safe event listening.
-     * Uses the original `MCPClientEvents` for event types.
-     */
-    on<E extends keyof MCPClientEvents>(event: E, listener: MCPClientEvents[E]): this;
-    /**
-     * Overrides EventEmitter's 'emit' method for type-safe event emission.
-     * Uses the original `MCPClientEvents` for event types.
-     */
-    emit<E extends keyof MCPClientEvents>(event: E, ...args: Parameters<MCPClientEvents[E]>): boolean;
+    enableSwaggerUI?: boolean;
+};
+
+/**
+ * Prompt management utilities for agent prompt tuning
+ */
+type ExtractVariableNames<T extends string> = T extends `${string}{{${infer Param}}}${infer Rest}` ? Param | ExtractVariableNames<Rest> : never;
+type AllowedVariableValue = string | number | boolean | undefined | null;
+type TemplateVariables<T extends string> = {
+    [K in ExtractVariableNames<T>]: AllowedVariableValue;
+};
+type PromptTemplate<T extends string> = [ExtractVariableNames<T>] extends [never] ? {
+    template: T;
+    variables?: Record<string, never>;
+} : {
+    template: T;
+    variables: TemplateVariables<T>;
+};
+type PromptCreator<T extends string> = (extraVariables?: Partial<TemplateVariables<T>>) => string;
+/**
+ * Creates a type-safe, customizable prompt function from a template string.
+ * Variable names are automatically inferred from the template `{{variable}}` syntax.
+ *
+ * @param template - The template string with `{{variable}}` placeholders.
+ * @param variables - An object containing the default values for the template variables.
+ * @returns A function that takes optional extra variables and returns the processed prompt string.
+ */
+declare const createPrompt: <T extends string>({ template, variables, }: PromptTemplate<T>) => PromptCreator<T>;
+
+/**
+ * Node types for agents, tools, and other components
+ */
+declare enum NodeType {
+    AGENT = "agent",
+    SUBAGENT = "agent",
+    TOOL = "tool",
+    MEMORY = "memory",
+    MESSAGE = "message",
+    OUTPUT = "output",
+    RETRIEVER = "retriever",
+    VECTOR = "vector",
+    EMBEDDING = "embedding",
+    WORKFLOW_STEP = "workflow_step",
+    WORKFLOW_AGENT_STEP = "workflow_agent_step",
+    WORKFLOW_FUNC_STEP = "workflow_func_step",
+    WORKFLOW_CONDITIONAL_STEP = "workflow_conditional_step",
+    WORKFLOW_PARALLEL_ALL_STEP = "workflow_parallel_all_step",
+    WORKFLOW_PARALLEL_RACE_STEP = "workflow_parallel_race_step"
 }
+/**
+ * Standard node ID creation function
+ * @param type Node type
+ * @param name Main identifier (tool name, agent name, etc.)
+ * @param ownerId Owner ID (optional)
+ * @returns Standard formatted node ID
+ */
+declare const createNodeId: (type: NodeType, name: string, ownerId?: string) => string;
+/**
+ * Function to extract node type from NodeID
+ * @param nodeId Node ID
+ * @returns NodeType or null (if type cannot be found)
+ */
+declare const getNodeTypeFromNodeId: (nodeId: string) => NodeType | null;
+/**
+ * Workflow step types enum
+ */
+type WorkflowStepType = "agent" | "func" | "conditional-when" | "parallel-all" | "parallel-race";
+/**
+ * Create a workflow step node ID with consistent pattern
+ * @param stepType Type of workflow step
+ * @param stepIndex Index of step in workflow
+ * @param workflowId Workflow identifier
+ * @param options Additional options for node ID generation
+ * @returns Consistent workflow step node ID
+ */
+declare const createWorkflowStepNodeId: (stepType: WorkflowStepType, stepIndex: number, workflowId: string, options?: {
+    agentId?: string;
+    parallelIndex?: number;
+    stepName?: string;
+    stepId?: string;
+}) => string;
+/**
+ * Get NodeType for workflow step type
+ * @param stepType Workflow step type
+ * @returns Corresponding NodeType
+ */
+declare const getWorkflowStepNodeType: (stepType: WorkflowStepType) => NodeType;
+/**
+ * Extract workflow step information from node ID
+ * @param nodeId Workflow step node ID
+ * @returns Extracted workflow step info or null
+ */
+declare const extractWorkflowStepInfo: (nodeId: string) => {
+    stepType: WorkflowStepType;
+    stepIndex: number;
+    workflowId: string;
+    agentId?: string;
+    parallelIndex?: number;
+    stepName?: string;
+} | null;
 
 /**
- * Configuration manager for Model Context Protocol (MCP).
- * Handles multiple MCP server connections and tool management.
- * NOTE: This version does NOT manage singleton instances automatically.
+ * Tool call interface
  */
-declare class MCPConfiguration<TServerKeys extends string = string> {
-    /**
-     * Map of server configurations keyed by server names.
-     */
-    private readonly serverConfigs;
-    /**
-     * Map of connected MCP clients keyed by server names (local cache).
-     */
-    private readonly mcpClientsById;
-    /**
-     * Creates a new, independent MCP configuration instance.
-     * @param options Configuration options including server definitions.
-     */
-    constructor(options: {
-        servers: Record<TServerKeys, MCPServerConfig>;
-    });
-    /**
-     * Type guard to check if an object conforms to the basic structure of AnyToolConfig.
-     */
-    private isAnyToolConfigStructure;
+interface ToolCall {
+    id: string;
+    type: "function";
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+/**
+ * Converts a Zod-like schema to a JSON representation usable in the UI
+ * @param schema Any Zod schema object
+ * @returns A JSON Schema compatible representation of the Zod schema
+ */
+declare function zodSchemaToJsonUI(schema: any): any;
+
+type UpdateOptions = {
+    filter?: string;
+    useCache?: boolean;
+    forceRefresh?: boolean;
+};
+/**
+ * Package update info with semver details
+ */
+type PackageUpdateInfo = {
+    name: string;
+    installed: string;
+    latest: string;
+    type: "major" | "minor" | "patch" | "latest";
+    packageJson: string;
+};
+/**
+ * Checks for dependency updates using native package manager commands
+ * @returns Object containing update information
+ */
+declare const checkForUpdates: (packagePath?: string, options?: UpdateOptions) => Promise<{
+    hasUpdates: boolean;
+    updates: PackageUpdateInfo[];
+    count: number;
+    message: string;
+}>;
+/**
+ * Update all packages that have available updates using native package manager
+ * @param packagePath Optional path to package.json, uses current directory if not provided
+ * @returns Result of the update operation
+ */
+declare const updateAllPackages: (packagePath?: string) => Promise<{
+    success: boolean;
+    message: string;
+    updatedPackages?: string[];
+    requiresRestart?: boolean;
+}>;
+/**
+ * Update a single package to its latest version using native package manager
+ * @param packageName Name of the package to update
+ * @param packagePath Optional path to package.json, uses current directory if not provided
+ * @returns Result of the update operation
+ */
+declare const updateSinglePackage: (packageName: string, packagePath?: string) => Promise<{
+    success: boolean;
+    message: string;
+    packageName: string;
+    requiresRestart?: boolean;
+}>;
+
+/**
+ * Safely parse JSON string. If parsing fails, returns the original value.
+ * @param value String to parse as JSON
+ * @returns Parsed JSON object or original value if parsing fails
+ */
+declare function safeJsonParse(value: string | null | undefined): any;
+declare function serializeValueForDebug(value: unknown): unknown;
+
+/**
+ * Type guard to check if content is a string
+ */
+declare function isTextContent(content: MessageContent): content is string;
+/**
+ * Type guard to check if content is structured (array of content parts)
+ */
+declare function isStructuredContent(content: MessageContent): content is Array<any>;
+/**
+ * Check if content has any text parts
+ */
+declare function hasTextPart(content: MessageContent): boolean;
+/**
+ * Check if content has any image parts
+ */
+declare function hasImagePart(content: MessageContent): boolean;
+/**
+ * Check if content has any file parts
+ */
+declare function hasFilePart(content: MessageContent): boolean;
+/**
+ * Extract text from message content
+ */
+declare function extractText(content: MessageContent): string;
+/**
+ * Extract all text parts from structured content
+ */
+declare function extractTextParts(content: MessageContent): Array<{
+    type: "text";
+    text: string;
+}>;
+/**
+ * Extract image parts from message content
+ */
+declare function extractImageParts(content: MessageContent): Array<any>;
+/**
+ * Extract file parts from message content
+ */
+declare function extractFileParts(content: MessageContent): Array<any>;
+/**
+ * Transform text content in a message
+ */
+declare function transformTextContent(content: MessageContent, transformer: (text: string) => string): MessageContent;
+/**
+ * Map UIMessage text parts with a transformer function
+ */
+declare function mapMessageContent(message: UIMessage, transformer: (text: string) => string): UIMessage;
+/**
+ * Filter content parts by type
+ */
+declare function filterContentParts(content: MessageContent, predicate: (part: any) => boolean): MessageContent;
+/**
+ * Normalize content to always be an array
+ */
+declare function normalizeToArray(content: MessageContent): Array<any>;
+/**
+ * Normalize content to the most compact form
+ */
+declare function normalizeContent(content: MessageContent): MessageContent;
+/**
+ * Builder class for creating message content
+ */
+declare class MessageContentBuilder {
+    private parts;
     /**
-     * Disconnects all associated MCP clients for THIS instance.
+     * Add a text part
      */
-    disconnect(): Promise<void>;
+    addText(text: string): this;
     /**
-     * Retrieves agent-ready tools from all configured MCP servers for this instance.
-     * @returns A flat array of all agent-ready tools.
+     * Add an image part
      */
-    getTools(): Promise<Tool<any>[]>;
+    addImage(image: string | Uint8Array): this;
     /**
-     * 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.
+     * Add a file part
      */
-    getRawTools(): Promise<Record<string, AnyToolConfig>>;
+    addFile(file: string | Uint8Array, mimeType?: string): this;
     /**
-     * Retrieves agent-ready toolsets grouped by server name for this instance.
-     * @returns A record where keys are server names and values are agent-ready toolsets.
+     * Add a custom part
      */
-    getToolsets(): Promise<Record<TServerKeys, ToolsetWithTools>>;
+    addPart(part: any): this;
     /**
-     * Retrieves raw tool definitions grouped by server name for this instance.
-     * @returns A record where keys are server names and values are records of raw tools.
+     * Build the final content
      */
-    getRawToolsets(): Promise<Record<TServerKeys, Record<string, AnyToolConfig>>>;
+    build(): MessageContent;
     /**
-     * Retrieves a specific connected MCP client by its server name for this instance.
+     * Build as array (always returns array)
      */
-    getClient(serverName: TServerKeys): Promise<MCPClient | undefined>;
+    buildAsArray(): Array<any>;
     /**
-     * Retrieves all configured MCP clients for this instance, ensuring they are connected.
+     * Clear all parts
      */
-    getClients(): Promise<Record<TServerKeys, MCPClient>>;
+    clear(): this;
     /**
-     * Internal helper to get/create/connect a client for this instance.
-     * Manages the local mcpClientsById cache.
+     * Get current parts count
      */
-    private getConnectedClient;
+    get length(): number;
 }
+/**
+ * Convenience function to add timestamp to user messages (UIMessage only)
+ */
+declare function addTimestampToMessage(message: UIMessage, timestamp?: string): UIMessage;
+/**
+ * Convenience function to prepend text to UIMessage text parts
+ */
+declare function prependToMessage(message: UIMessage, prefix: string): UIMessage;
+/**
+ * Convenience function to append text to UIMessage text parts
+ */
+declare function appendToMessage(message: UIMessage, suffix: string): UIMessage;
+/**
+ * Check if UIMessage has any content
+ */
+declare function hasContent(message: UIMessage): boolean;
+/**
+ * Get content length (text characters or array items)
+ */
+declare function getContentLength(content: MessageContent): number;
+/**
+ * Combined message helpers object for easy importing
+ */
+declare const messageHelpers: {
+    isTextContent: typeof isTextContent;
+    isStructuredContent: typeof isStructuredContent;
+    hasTextPart: typeof hasTextPart;
+    hasImagePart: typeof hasImagePart;
+    hasFilePart: typeof hasFilePart;
+    extractText: typeof extractText;
+    extractTextParts: typeof extractTextParts;
+    extractImageParts: typeof extractImageParts;
+    extractFileParts: typeof extractFileParts;
+    transformTextContent: typeof transformTextContent;
+    mapMessageContent: typeof mapMessageContent;
+    filterContentParts: typeof filterContentParts;
+    normalizeToArray: typeof normalizeToArray;
+    normalizeContent: typeof normalizeContent;
+    addTimestampToMessage: typeof addTimestampToMessage;
+    prependToMessage: typeof prependToMessage;
+    appendToMessage: typeof appendToMessage;
+    hasContent: typeof hasContent;
+    getContentLength: typeof getContentLength;
+    MessageContentBuilder: typeof MessageContentBuilder;
+};
+
+/**
+ * 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.
+ *
+ * @param retriever - The retriever instance to convert to a tool
+ * @param options - Options for customizing the tool
+ * @returns An AgentTool that can be added to an agent's tools
+ *
+ * @example
+ * ```typescript
+ * const retriever = new SimpleRetriever();
+ * const searchTool = createRetrieverTool(retriever, {
+ *   name: "search_knowledge",
+ *   description: "Searches the knowledge base for information"
+ * });
+ *
+ * agent.addTool(searchTool);
+ * ```
+ */
+declare const createRetrieverTool: (retriever: Retriever, options?: {
+    name?: string;
+    description?: string;
+}) => AgentTool;
 
 /**
  * Registry to manage and track agents
@@ -6894,6 +6943,10 @@ declare class VoltAgent {
     private serverInstance?;
     private logger;
     private observability?;
+    private readonly mcpServers;
+    private readonly mcpServerRegistry;
+    private readonly a2aServers;
+    private readonly a2aServerRegistry;
     constructor(options: VoltAgentOptions);
     /**
      * Setup graceful shutdown handlers
@@ -6966,6 +7019,14 @@ declare class VoltAgent {
      * Useful for programmatic cleanup or when integrating with other frameworks
      */
     shutdown(): Promise<void>;
+    private initializeMCPServer;
+    private initializeA2AServer;
+    private startConfiguredMcpTransports;
+    getMCPDependencies(): MCPServerDeps;
+    private getA2ADependencies;
+    getServerInstance(): IServerProvider | undefined;
+    private shutdownMcpServers;
+    private shutdownA2AServers;
 }
 
 /**
@@ -6979,4 +7040,4 @@ declare class VoltAgent {
  */
 declare function convertUsage(usage: LanguageModelUsage | undefined): UsageInfo | undefined;
 
-export { 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 AnyToolConfig, type ApiToolInfo, type BaseEventMetadata, type BaseGenerationOptions, type BaseLLMOptions, type BaseMessage, BaseRetriever, type BaseTool, type BaseToolCall, type CachedPrompt, type ChatMessage, type ClientInfo, 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 HTTPServerConfig, 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, MCPClient, type MCPClientConfig, type MCPClientEvents, MCPConfiguration, type MCPOptions, type MCPServerConfig, type MCPToolCall, type MCPToolResult, 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 RegisteredWorkflow, type RetrieveOptions, type Retriever, type RetrieverOptions, type SSEServerConfig, 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 StdioServerConfig, 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 StreamableHTTPServerConfig, 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 ToolsetMap, type ToolsetWithTools, type TransportError, 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 };
+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 };