@voltagent/core 1.1.20 → 1.1.22

package/dist/index.d.mts

@@ -754,6 +754,32 @@ interface MemoryConfig {
      */
     workingMemory?: WorkingMemoryConfig;
 }
+/**
+ * Metadata about the underlying storage adapter
+ */
+interface MemoryStorageMetadata {
+    /** Name of the configured storage adapter */
+    adapter: string;
+}
+/**
+ * Summary of working memory configuration exposed to the UI
+ */
+interface WorkingMemorySummary {
+    /** Whether working memory support is enabled */
+    enabled: boolean;
+    /** Scope of working memory persistence */
+    scope?: WorkingMemoryScope;
+    /** Output format (markdown/json) */
+    format: "markdown" | "json" | null;
+    /** Indicates if a template is configured */
+    hasTemplate: boolean;
+    /** Indicates if a schema is configured */
+    hasSchema: boolean;
+    /** Template content if configured */
+    template?: string | null;
+    /** Simplified schema field map if configured */
+    schema?: Record<string, string> | null;
+}
 /**
  * Document type for RAG operations
  */
@@ -1249,6 +1275,14 @@ declare class Memory {
      * Get embedding adapter if configured
      */
     getEmbeddingAdapter(): EmbeddingAdapter$1 | undefined;
+    /**
+     * Get metadata about the configured storage adapter
+     */
+    getStorageMetadata(): MemoryStorageMetadata;
+    /**
+     * Get a UI-friendly summary of working memory configuration
+     */
+    getWorkingMemorySummary(): WorkingMemorySummary | null;
     /**
      * Get workflow state by execution ID
      */
@@ -2211,6 +2245,12 @@ interface ObservabilityStorageAdapter {
     deleteOldSpans(beforeTimestamp: number): Promise<number>;
     deleteOldLogs(beforeTimestamp: number): Promise<number>;
     clear(): Promise<void>;
+    getInfo?(): {
+        adapter: string;
+        displayName?: string;
+        persistent?: boolean;
+        description?: string;
+    };
 }
 /**
  * Log filter for querying
@@ -2653,6 +2693,12 @@ declare class InMemoryStorageAdapter$1 implements ObservabilityStorageAdapter {
         oldestLog?: Date;
         newestLog?: Date;
     };
+    getInfo(): {
+        adapter: string;
+        displayName: string;
+        persistent: boolean;
+        description: string;
+    };
 }
 
 /**
@@ -2815,6 +2861,8 @@ interface OnToolEndHookArgs {
 interface OnPrepareMessagesHookArgs {
     /** The messages that will be sent to the LLM (AI SDK UIMessage). */
     messages: UIMessage[];
+    /** The raw messages before sanitization (for advanced transformations). */
+    rawMessages?: UIMessage[];
     /** The agent instance making the LLM call. */
     agent: Agent;
     /** The operation context containing metadata about the current operation. */
@@ -2824,6 +2872,20 @@ interface OnPrepareMessagesHookResult {
     /** The transformed messages to send to the LLM. */
     messages?: UIMessage[];
 }
+interface OnPrepareModelMessagesHookArgs {
+    /** The finalized model messages that will be sent to the provider. */
+    modelMessages: ModelMessage[];
+    /** The sanitized UI messages that produced the model messages. */
+    uiMessages: UIMessage[];
+    /** The agent instance making the LLM call. */
+    agent: Agent;
+    /** The operation context containing metadata about the current operation. */
+    context: OperationContext;
+}
+interface OnPrepareModelMessagesHookResult {
+    /** The transformed model messages to send to the provider. */
+    modelMessages?: ModelMessage[];
+}
 interface OnErrorHookArgs {
     agent: Agent;
     error: VoltAgentError | AbortError | Error;
@@ -2840,6 +2902,7 @@ type AgentHookOnHandoff = (args: OnHandoffHookArgs) => Promise<void> | void;
 type AgentHookOnToolStart = (args: OnToolStartHookArgs) => Promise<void> | void;
 type AgentHookOnToolEnd = (args: OnToolEndHookArgs) => Promise<void> | void;
 type AgentHookOnPrepareMessages = (args: OnPrepareMessagesHookArgs) => Promise<OnPrepareMessagesHookResult> | OnPrepareMessagesHookResult;
+type AgentHookOnPrepareModelMessages = (args: OnPrepareModelMessagesHookArgs) => Promise<OnPrepareModelMessagesHookResult> | OnPrepareModelMessagesHookResult;
 type AgentHookOnError = (args: OnErrorHookArgs) => Promise<void> | void;
 type AgentHookOnStepFinish = (args: OnStepFinishHookArgs) => Promise<void> | void;
 /**
@@ -2852,6 +2915,7 @@ type AgentHooks = {
     onToolStart?: AgentHookOnToolStart;
     onToolEnd?: AgentHookOnToolEnd;
     onPrepareMessages?: AgentHookOnPrepareMessages;
+    onPrepareModelMessages?: AgentHookOnPrepareModelMessages;
     onError?: AgentHookOnError;
     onStepFinish?: AgentHookOnStepFinish;
 };
@@ -2982,7 +3046,7 @@ interface SubAgentStateData {
     status: string;
     model: string;
     tools: ApiToolInfo[];
-    memory?: Record<string, unknown>;
+    memory?: AgentMemoryState;
     node_id: string;
     subAgents?: SubAgentStateData[];
     methodConfig?: {
@@ -2992,6 +3056,33 @@ interface SubAgentStateData {
     };
     [key: string]: unknown;
 }
+/**
+ * Memory block representation shared across agent and sub-agent state
+ */
+interface AgentMemoryState extends Record<string, unknown> {
+    node_id: string;
+    type?: string;
+    resourceId?: string;
+    options?: MemoryOptions;
+    available?: boolean;
+    status?: string;
+    storage?: MemoryStorageMetadata;
+    workingMemory?: WorkingMemorySummary | null;
+    vectorDB?: {
+        enabled: boolean;
+        adapter?: string;
+        dimension?: number;
+        status?: string;
+        node_id?: string;
+    } | null;
+    embeddingModel?: {
+        enabled: boolean;
+        model?: string;
+        dimension?: number;
+        status?: string;
+        node_id?: string;
+    } | null;
+}
 /**
  * Full state of an agent including all properties
  */
@@ -3004,9 +3095,7 @@ interface AgentFullState {
     node_id: string;
     tools: ToolWithNodeId[];
     subAgents: SubAgentStateData[];
-    memory: Record<string, unknown> & {
-        node_id: string;
-    };
+    memory: AgentMemoryState;
     retriever?: {
         name: string;
         description?: string;
@@ -6605,7 +6694,10 @@ interface ServerApiResponse<T> {
  * VoltAgent constructor options
  */
 type VoltAgentOptions = {
-    agents: Record<string, Agent>;
+    /**
+     * Optional agents to register when bootstrapping VoltAgent
+     */
+    agents?: Record<string, Agent>;
     /**
      * Optional workflows to register with VoltAgent
      * Can be either Workflow instances or WorkflowChain instances
@@ -7258,7 +7350,7 @@ declare class VoltAgent {
     /**
      * Register multiple agents
      */
-    registerAgents(agents: Record<string, Agent>): void;
+    registerAgents(agents?: Record<string, Agent>): void;
     /**
      * Start the server
      */
@@ -7334,4 +7426,4 @@ declare class VoltAgent {
  */
 declare function convertUsage(usage: LanguageModelUsage | undefined): UsageInfo | undefined;
 
-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 CloudflareFetchHandler, 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 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 LLMProvider, LazyRemoteExportProcessor, LocalStorageSpanProcessor, type LogFilter, LoggerProxy, MCPConfiguration, type MCPElicitationAdapter, type MCPLoggingAdapter, type MCPPromptsAdapter, type MCPResourcesAdapter, MCPServerRegistry, Memory, type MemoryConfig, type MemoryOptions, 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 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 RemoteLogExportConfig, RemoteLogProcessor, type RetrieveOptions, type Retriever, type RetrieverOptions, 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, 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, type WorkingMemoryUpdateOptions, addTimestampToMessage, andAgent, andAll, andRace, andTap, andThen, andWhen, andWorkflow, appendToMessage, buildRetrieverLogMessage, buildSpanTree, checkForUpdates, convertUsage, cosineSimilarity, createHooks, createNodeId, createPrompt, createReasoningTools, createRetrieverTool, createSimpleTemplateEngine, createSubagent, createSuspendController, createTool, createToolkit, createVoltAgentObservability, createVoltOpsClient, createWorkflow, createWorkflowChain, createWorkflowStepNodeId, VoltAgent as default, extractFileParts, extractImageParts, extractText, extractTextParts, extractWorkflowStepInfo, filterContentParts, getContentLength, getEnvVar, getGlobalLogBuffer, getGlobalLogger, getNodeTypeFromNodeId, getWorkflowStepNodeType, hasContent, hasFilePart, hasImagePart, hasTextPart, isAbortError, isNodeRuntime, isServerlessRuntime, isStructuredContent, isTextContent, isVoltAgentError, mapMessageContent, messageHelpers, normalizeContent, normalizeToArray, prependToMessage, readableLogRecordToObservabilityLog, readableSpanToObservabilitySpan, safeJsonParse, serializeValueForDebug, tool, transformTextContent, updateAllPackages, updateSinglePackage, zodSchemaToJsonUI };
+export { A2AServerRegistry, AbortError, Agent, type AgentFullState, type AgentHookOnEnd, type AgentHookOnError, type AgentHookOnHandoff, type AgentHookOnPrepareMessages, type AgentHookOnPrepareModelMessages, 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 CloudflareFetchHandler, 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 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 LLMProvider, LazyRemoteExportProcessor, LocalStorageSpanProcessor, type LogFilter, LoggerProxy, MCPConfiguration, type MCPElicitationAdapter, type MCPLoggingAdapter, type MCPPromptsAdapter, type MCPResourcesAdapter, MCPServerRegistry, 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 OnHandoffHookArgs, type OnPrepareMessagesHookArgs, type OnPrepareMessagesHookResult, type OnPrepareModelMessagesHookArgs, type OnPrepareModelMessagesHookResult, 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 RemoteLogExportConfig, RemoteLogProcessor, type RetrieveOptions, type Retriever, type RetrieverOptions, 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, 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, type WorkingMemorySummary, type WorkingMemoryUpdateOptions, addTimestampToMessage, andAgent, andAll, andRace, andTap, andThen, andWhen, andWorkflow, appendToMessage, buildRetrieverLogMessage, buildSpanTree, checkForUpdates, convertUsage, cosineSimilarity, createHooks, createNodeId, createPrompt, createReasoningTools, createRetrieverTool, createSimpleTemplateEngine, createSubagent, createSuspendController, createTool, createToolkit, createVoltAgentObservability, createVoltOpsClient, createWorkflow, createWorkflowChain, createWorkflowStepNodeId, VoltAgent as default, extractFileParts, extractImageParts, extractText, extractTextParts, extractWorkflowStepInfo, filterContentParts, getContentLength, getEnvVar, getGlobalLogBuffer, getGlobalLogger, getNodeTypeFromNodeId, getWorkflowStepNodeType, hasContent, hasFilePart, hasImagePart, hasTextPart, isAbortError, isNodeRuntime, isServerlessRuntime, isStructuredContent, isTextContent, isVoltAgentError, mapMessageContent, messageHelpers, normalizeContent, normalizeToArray, prependToMessage, readableLogRecordToObservabilityLog, readableSpanToObservabilitySpan, safeJsonParse, serializeValueForDebug, tool, transformTextContent, updateAllPackages, updateSinglePackage, zodSchemaToJsonUI };

package/dist/index.d.ts

@@ -754,6 +754,32 @@ interface MemoryConfig {
      */
     workingMemory?: WorkingMemoryConfig;
 }
+/**
+ * Metadata about the underlying storage adapter
+ */
+interface MemoryStorageMetadata {
+    /** Name of the configured storage adapter */
+    adapter: string;
+}
+/**
+ * Summary of working memory configuration exposed to the UI
+ */
+interface WorkingMemorySummary {
+    /** Whether working memory support is enabled */
+    enabled: boolean;
+    /** Scope of working memory persistence */
+    scope?: WorkingMemoryScope;
+    /** Output format (markdown/json) */
+    format: "markdown" | "json" | null;
+    /** Indicates if a template is configured */
+    hasTemplate: boolean;
+    /** Indicates if a schema is configured */
+    hasSchema: boolean;
+    /** Template content if configured */
+    template?: string | null;
+    /** Simplified schema field map if configured */
+    schema?: Record<string, string> | null;
+}
 /**
  * Document type for RAG operations
  */
@@ -1249,6 +1275,14 @@ declare class Memory {
      * Get embedding adapter if configured
      */
     getEmbeddingAdapter(): EmbeddingAdapter$1 | undefined;
+    /**
+     * Get metadata about the configured storage adapter
+     */
+    getStorageMetadata(): MemoryStorageMetadata;
+    /**
+     * Get a UI-friendly summary of working memory configuration
+     */
+    getWorkingMemorySummary(): WorkingMemorySummary | null;
     /**
      * Get workflow state by execution ID
      */
@@ -2211,6 +2245,12 @@ interface ObservabilityStorageAdapter {
     deleteOldSpans(beforeTimestamp: number): Promise<number>;
     deleteOldLogs(beforeTimestamp: number): Promise<number>;
     clear(): Promise<void>;
+    getInfo?(): {
+        adapter: string;
+        displayName?: string;
+        persistent?: boolean;
+        description?: string;
+    };
 }
 /**
  * Log filter for querying
@@ -2653,6 +2693,12 @@ declare class InMemoryStorageAdapter$1 implements ObservabilityStorageAdapter {
         oldestLog?: Date;
         newestLog?: Date;
     };
+    getInfo(): {
+        adapter: string;
+        displayName: string;
+        persistent: boolean;
+        description: string;
+    };
 }
 
 /**
@@ -2815,6 +2861,8 @@ interface OnToolEndHookArgs {
 interface OnPrepareMessagesHookArgs {
     /** The messages that will be sent to the LLM (AI SDK UIMessage). */
     messages: UIMessage[];
+    /** The raw messages before sanitization (for advanced transformations). */
+    rawMessages?: UIMessage[];
     /** The agent instance making the LLM call. */
     agent: Agent;
     /** The operation context containing metadata about the current operation. */
@@ -2824,6 +2872,20 @@ interface OnPrepareMessagesHookResult {
     /** The transformed messages to send to the LLM. */
     messages?: UIMessage[];
 }
+interface OnPrepareModelMessagesHookArgs {
+    /** The finalized model messages that will be sent to the provider. */
+    modelMessages: ModelMessage[];
+    /** The sanitized UI messages that produced the model messages. */
+    uiMessages: UIMessage[];
+    /** The agent instance making the LLM call. */
+    agent: Agent;
+    /** The operation context containing metadata about the current operation. */
+    context: OperationContext;
+}
+interface OnPrepareModelMessagesHookResult {
+    /** The transformed model messages to send to the provider. */
+    modelMessages?: ModelMessage[];
+}
 interface OnErrorHookArgs {
     agent: Agent;
     error: VoltAgentError | AbortError | Error;
@@ -2840,6 +2902,7 @@ type AgentHookOnHandoff = (args: OnHandoffHookArgs) => Promise<void> | void;
 type AgentHookOnToolStart = (args: OnToolStartHookArgs) => Promise<void> | void;
 type AgentHookOnToolEnd = (args: OnToolEndHookArgs) => Promise<void> | void;
 type AgentHookOnPrepareMessages = (args: OnPrepareMessagesHookArgs) => Promise<OnPrepareMessagesHookResult> | OnPrepareMessagesHookResult;
+type AgentHookOnPrepareModelMessages = (args: OnPrepareModelMessagesHookArgs) => Promise<OnPrepareModelMessagesHookResult> | OnPrepareModelMessagesHookResult;
 type AgentHookOnError = (args: OnErrorHookArgs) => Promise<void> | void;
 type AgentHookOnStepFinish = (args: OnStepFinishHookArgs) => Promise<void> | void;
 /**
@@ -2852,6 +2915,7 @@ type AgentHooks = {
     onToolStart?: AgentHookOnToolStart;
     onToolEnd?: AgentHookOnToolEnd;
     onPrepareMessages?: AgentHookOnPrepareMessages;
+    onPrepareModelMessages?: AgentHookOnPrepareModelMessages;
     onError?: AgentHookOnError;
     onStepFinish?: AgentHookOnStepFinish;
 };
@@ -2982,7 +3046,7 @@ interface SubAgentStateData {
     status: string;
     model: string;
     tools: ApiToolInfo[];
-    memory?: Record<string, unknown>;
+    memory?: AgentMemoryState;
     node_id: string;
     subAgents?: SubAgentStateData[];
     methodConfig?: {
@@ -2992,6 +3056,33 @@ interface SubAgentStateData {
     };
     [key: string]: unknown;
 }
+/**
+ * Memory block representation shared across agent and sub-agent state
+ */
+interface AgentMemoryState extends Record<string, unknown> {
+    node_id: string;
+    type?: string;
+    resourceId?: string;
+    options?: MemoryOptions;
+    available?: boolean;
+    status?: string;
+    storage?: MemoryStorageMetadata;
+    workingMemory?: WorkingMemorySummary | null;
+    vectorDB?: {
+        enabled: boolean;
+        adapter?: string;
+        dimension?: number;
+        status?: string;
+        node_id?: string;
+    } | null;
+    embeddingModel?: {
+        enabled: boolean;
+        model?: string;
+        dimension?: number;
+        status?: string;
+        node_id?: string;
+    } | null;
+}
 /**
  * Full state of an agent including all properties
  */
@@ -3004,9 +3095,7 @@ interface AgentFullState {
     node_id: string;
     tools: ToolWithNodeId[];
     subAgents: SubAgentStateData[];
-    memory: Record<string, unknown> & {
-        node_id: string;
-    };
+    memory: AgentMemoryState;
     retriever?: {
         name: string;
         description?: string;
@@ -6605,7 +6694,10 @@ interface ServerApiResponse<T> {
  * VoltAgent constructor options
  */
 type VoltAgentOptions = {
-    agents: Record<string, Agent>;
+    /**
+     * Optional agents to register when bootstrapping VoltAgent
+     */
+    agents?: Record<string, Agent>;
     /**
      * Optional workflows to register with VoltAgent
      * Can be either Workflow instances or WorkflowChain instances
@@ -7258,7 +7350,7 @@ declare class VoltAgent {
     /**
      * Register multiple agents
      */
-    registerAgents(agents: Record<string, Agent>): void;
+    registerAgents(agents?: Record<string, Agent>): void;
     /**
      * Start the server
      */
@@ -7334,4 +7426,4 @@ declare class VoltAgent {
  */
 declare function convertUsage(usage: LanguageModelUsage | undefined): UsageInfo | undefined;
 
-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 CloudflareFetchHandler, 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 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 LLMProvider, LazyRemoteExportProcessor, LocalStorageSpanProcessor, type LogFilter, LoggerProxy, MCPConfiguration, type MCPElicitationAdapter, type MCPLoggingAdapter, type MCPPromptsAdapter, type MCPResourcesAdapter, MCPServerRegistry, Memory, type MemoryConfig, type MemoryOptions, 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 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 RemoteLogExportConfig, RemoteLogProcessor, type RetrieveOptions, type Retriever, type RetrieverOptions, 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, 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, type WorkingMemoryUpdateOptions, addTimestampToMessage, andAgent, andAll, andRace, andTap, andThen, andWhen, andWorkflow, appendToMessage, buildRetrieverLogMessage, buildSpanTree, checkForUpdates, convertUsage, cosineSimilarity, createHooks, createNodeId, createPrompt, createReasoningTools, createRetrieverTool, createSimpleTemplateEngine, createSubagent, createSuspendController, createTool, createToolkit, createVoltAgentObservability, createVoltOpsClient, createWorkflow, createWorkflowChain, createWorkflowStepNodeId, VoltAgent as default, extractFileParts, extractImageParts, extractText, extractTextParts, extractWorkflowStepInfo, filterContentParts, getContentLength, getEnvVar, getGlobalLogBuffer, getGlobalLogger, getNodeTypeFromNodeId, getWorkflowStepNodeType, hasContent, hasFilePart, hasImagePart, hasTextPart, isAbortError, isNodeRuntime, isServerlessRuntime, isStructuredContent, isTextContent, isVoltAgentError, mapMessageContent, messageHelpers, normalizeContent, normalizeToArray, prependToMessage, readableLogRecordToObservabilityLog, readableSpanToObservabilitySpan, safeJsonParse, serializeValueForDebug, tool, transformTextContent, updateAllPackages, updateSinglePackage, zodSchemaToJsonUI };
+export { A2AServerRegistry, AbortError, Agent, type AgentFullState, type AgentHookOnEnd, type AgentHookOnError, type AgentHookOnHandoff, type AgentHookOnPrepareMessages, type AgentHookOnPrepareModelMessages, 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 CloudflareFetchHandler, 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 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 LLMProvider, LazyRemoteExportProcessor, LocalStorageSpanProcessor, type LogFilter, LoggerProxy, MCPConfiguration, type MCPElicitationAdapter, type MCPLoggingAdapter, type MCPPromptsAdapter, type MCPResourcesAdapter, MCPServerRegistry, 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 OnHandoffHookArgs, type OnPrepareMessagesHookArgs, type OnPrepareMessagesHookResult, type OnPrepareModelMessagesHookArgs, type OnPrepareModelMessagesHookResult, 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 RemoteLogExportConfig, RemoteLogProcessor, type RetrieveOptions, type Retriever, type RetrieverOptions, 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, 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, type WorkingMemorySummary, type WorkingMemoryUpdateOptions, addTimestampToMessage, andAgent, andAll, andRace, andTap, andThen, andWhen, andWorkflow, appendToMessage, buildRetrieverLogMessage, buildSpanTree, checkForUpdates, convertUsage, cosineSimilarity, createHooks, createNodeId, createPrompt, createReasoningTools, createRetrieverTool, createSimpleTemplateEngine, createSubagent, createSuspendController, createTool, createToolkit, createVoltAgentObservability, createVoltOpsClient, createWorkflow, createWorkflowChain, createWorkflowStepNodeId, VoltAgent as default, extractFileParts, extractImageParts, extractText, extractTextParts, extractWorkflowStepInfo, filterContentParts, getContentLength, getEnvVar, getGlobalLogBuffer, getGlobalLogger, getNodeTypeFromNodeId, getWorkflowStepNodeType, hasContent, hasFilePart, hasImagePart, hasTextPart, isAbortError, isNodeRuntime, isServerlessRuntime, isStructuredContent, isTextContent, isVoltAgentError, mapMessageContent, messageHelpers, normalizeContent, normalizeToArray, prependToMessage, readableLogRecordToObservabilityLog, readableSpanToObservabilitySpan, safeJsonParse, serializeValueForDebug, tool, transformTextContent, updateAllPackages, updateSinglePackage, zodSchemaToJsonUI };