@voltagent/core 0.1.37 → 0.1.39

package/dist/index.d.ts

@@ -731,6 +731,17 @@ declare class VoltAgentExporter {
     updateHistoryEntry(history_id: string, updates: Partial<AgentHistoryUpdatableFields>): Promise<void>;
 }
 
+/**
+ * Options object for dynamic value resolution
+ */
+type DynamicValueOptions = {
+    /** User-defined context that can be used for dynamic value resolution */
+    userContext: Map<string | symbol, unknown>;
+};
+/**
+ * A value that can be either static or dynamically computed based on context
+ */
+type DynamicValue<T> = T | ((options: DynamicValueOptions) => T | Promise<T>);
 /**
  * Provider options type for LLM configurations
  */
@@ -779,8 +790,9 @@ type AgentOptions = {
     memoryOptions?: MemoryOptions;
     /**
      * Tools and/or Toolkits that the agent can use
+     * Can be static or dynamic based on user context
      */
-    tools?: (Tool<any> | Toolkit)[];
+    tools?: DynamicValue<(Tool<any> | Toolkit)[]>;
     /**
      * Sub-agents that this agent can delegate tasks to
      */
@@ -802,8 +814,9 @@ type AgentOptions = {
     description: string;
     /**
      * Agent instructions. This is the preferred field.
+     * Can be static or dynamic based on user context
      */
-    instructions?: string;
+    instructions?: DynamicValue<string>;
 } | {
     /**
      * @deprecated Use `instructions` instead.
@@ -813,8 +826,9 @@ type AgentOptions = {
     /**
      * Agent instructions. This is the preferred field.
      * Required if description is not provided.
+     * Can be static or dynamic based on user context
      */
-    instructions: string;
+    instructions: DynamicValue<string>;
 });
 /**
  * Provider instance type helper
@@ -2812,6 +2826,18 @@ declare class Agent<TProvider extends {
      * Agent instructions. This is the preferred field over `description`.
      */
     readonly instructions: string;
+    /**
+     * Dynamic instructions value (internal)
+     */
+    private readonly dynamicInstructions?;
+    /**
+     * Dynamic model value (internal)
+     */
+    private readonly dynamicModel?;
+    /**
+     * Dynamic tools value (internal)
+     */
+    private readonly dynamicTools?;
     /**
      * The LLM provider to use
      */
@@ -2856,7 +2882,7 @@ declare class Agent<TProvider extends {
      * Create a new agent
      */
     constructor(options: AgentOptions & TProvider & {
-        model: ModelType<TProvider>;
+        model: DynamicValue<ModelType<TProvider>>;
         subAgents?: Agent<any>[];
         maxHistoryEntries?: number;
         hooks?: AgentHooks;
@@ -2865,6 +2891,18 @@ declare class Agent<TProvider extends {
         markdown?: boolean;
         telemetryExporter?: VoltAgentExporter;
     });
+    /**
+     * Resolve dynamic instructions based on user context
+     */
+    private resolveInstructions;
+    /**
+     * Resolve dynamic model based on user context
+     */
+    private resolveModel;
+    /**
+     * Resolve dynamic tools based on user context
+     */
+    private resolveTools;
     /**
      * Get the system message for the agent
      */
@@ -2956,7 +2994,7 @@ declare class Agent<TProvider extends {
      */
     private _endOtelToolSpan;
     /**
-     * Create an enhanced fullStream that includes SubAgent events
+     * Create an enhanced fullStream with real-time SubAgent event injection
      */
     private createEnhancedFullStream;
     /**
@@ -3335,34 +3373,6 @@ declare const updateSinglePackage: (packageName: string, packagePath?: string) =
 declare function safeJsonParse(value: string | null | undefined): any;
 declare function serializeValueForDebug(value: unknown): unknown;
 
-/**
- * Utility for merging multiple async streams with event queue integration
- */
-interface StreamMergerOptions {
-    /**
-     * Polling interval for checking events (in milliseconds)
-     * Default: 16ms (~60fps for smooth UI updates)
-     */
-    pollingInterval?: number;
-    /**
-     * Post-stream polling interval when main stream is finished (in milliseconds)
-     * Default: 10ms
-     */
-    postStreamInterval?: number;
-}
-/**
- * Creates an enhanced stream that merges an original async iterable with events
- * from a shared queue, ensuring chronological order and smooth UI updates.
- *
- * @param originalStream - The main stream to merge with
- * @param eventsQueue - Shared array that other sources push events to
- * @param options - Configuration options for polling intervals
- * @returns Enhanced async iterable that yields events from both sources
- */
-declare function createMergedStream<T>(originalStream: AsyncIterable<T>, eventsQueue: T[], options?: StreamMergerOptions): AsyncIterable<T>;
-/**
- * Helper type for SubAgent events that can be merged into a main stream
- */
 interface SubAgentEvent {
     type: string;
     data: any;
@@ -3370,6 +3380,23 @@ interface SubAgentEvent {
     subAgentId: string;
     subAgentName: string;
 }
+interface StreamEventForwarderOptions {
+    forwarder?: (event: any) => Promise<void>;
+    filterTypes?: string[];
+    addSubAgentPrefix?: boolean;
+}
+/**
+ * Forwards SubAgent events to a stream with optional filtering and prefixing
+ * @param event - The SubAgent event to forward
+ * @param options - Configuration options for forwarding
+ */
+declare function streamEventForwarder(event: SubAgentEvent, options?: StreamEventForwarderOptions): Promise<void>;
+/**
+ * Creates a configured streamEventForwarder function
+ * @param options - Configuration options
+ * @returns A configured forwarder function
+ */
+declare function createStreamEventForwarder(options?: StreamEventForwarderOptions): (event: SubAgentEvent) => Promise<void>;
 
 /**
  * Creates an AgentTool from a retriever, allowing it to be used as a tool in an agent.
@@ -3972,4 +3999,4 @@ declare class VoltAgent {
     shutdownTelemetry(): Promise<void>;
 }
 
-export { Agent, AgentErrorEvent, AgentHistoryEntry, AgentHookOnEnd, AgentHookOnHandoff, AgentHookOnStart, AgentHookOnToolEnd, AgentHookOnToolStart, AgentHooks, AgentOptions, AgentRegistry, AgentResponse, AgentStartEvent, AgentStartEventMetadata, AgentSuccessEvent, AgentSuccessEventMetadata, AgentTool, AllowedVariableValue, AnyToolConfig, AsyncIterableStream, BaseEventMetadata, BaseLLMOptions, BaseMessage, BaseRetriever, BaseTimelineEvent, BaseTool, BaseToolCall, ClientInfo, Conversation, ConversationQueryOptions, CreateConversationInput, CreateReasoningToolsOptions, CustomEndpointDefinition, CustomEndpointError, CustomEndpointHandler, DEFAULT_INSTRUCTIONS, DataContent, ErrorStreamPart, EventStatus, ExtractVariableNames, FEW_SHOT_EXAMPLES, FilePart, FinishStreamPart, GenerateObjectOptions, GenerateTextOptions, HTTPServerConfig, HistoryStatus, HttpMethod, ImagePart, InMemoryStorage, InferGenerateObjectResponse, InferGenerateTextResponse, InferMessage, InferModel, InferProviderParams, InferStreamResponse, InferTool, LLMProvider, LibSQLStorage, MCPClient, MCPClientConfig, MCPClientEvents, MCPConfiguration, MCPOptions, MCPServerConfig, MCPToolCall, MCPToolResult, Memory, MemoryEventMetadata, MemoryManager, MemoryMessage, MemoryOptions, MemoryReadErrorEvent, MemoryReadStartEvent, MemoryReadSuccessEvent, MemoryWriteErrorEvent, MemoryWriteStartEvent, MemoryWriteSuccessEvent, MessageContent, MessageFilterOptions, MessageRole, ModelToolCall, NewTimelineEvent, NextAction, NodeType, OnEndHookArgs, OnHandoffHookArgs, OnStartHookArgs, OnToolEndHookArgs, OnToolStartHookArgs, OperationContext, PackageUpdateInfo, PromptCreator, PromptTemplate, ProviderObjectResponse, ProviderObjectStreamResponse, ProviderParams, ProviderResponse, ProviderTextResponse, ProviderTextStreamResponse, ReadableStreamType, ReasoningStep, ReasoningStepSchema, ReasoningStreamPart, ReasoningToolExecuteOptions, RetrieveOptions, Retriever, RetrieverErrorEvent, RetrieverOptions, RetrieverStartEvent, RetrieverSuccessEvent, SSEServerConfig, ServerOptions, SourceStreamPart, StandardEventData, StandardTimelineEvent, StdioServerConfig, StepChunkCallback, StepFinishCallback, StepWithContent, StreamMergerOptions, StreamObjectFinishResult, StreamObjectOnFinishCallback, StreamObjectOptions, StreamPart, StreamTextFinishResult, StreamTextOnFinishCallback, StreamTextOptions, StreamableHTTPServerConfig, SubAgentEvent, TemplateVariables, TextDeltaStreamPart, TextPart, TimelineEventCoreLevel, TimelineEventCoreStatus, TimelineEventCoreType, Tool, ToolCall, ToolCallStreamPart, ToolErrorEvent, ToolErrorInfo, ToolExecuteOptions, ToolExecutionContext, ToolManager, ToolOptions, ToolResultStreamPart, ToolSchema, ToolStartEvent, ToolStatus, ToolStatusInfo, ToolSuccessEvent, Toolkit, ToolsetMap, ToolsetWithTools, TransportError, Usage, UsageInfo, Voice, VoiceEventData, VoiceEventType, VoiceMetadata, VoiceOptions, VoltAgent, VoltAgentError, VoltAgentExporter, VoltAgentExporterOptions, VoltAgentOptions, checkForUpdates, createAsyncIterableStream, createHooks, createMergedStream, createNodeId, createPrompt, createReasoningTools, createRetrieverTool, createTool, createToolkit, VoltAgent as default, getNodeTypeFromNodeId, registerCustomEndpoint, registerCustomEndpoints, safeJsonParse, serializeValueForDebug, tool, updateAllPackages, updateSinglePackage, zodSchemaToJsonUI };
+export { Agent, AgentErrorEvent, AgentHistoryEntry, AgentHookOnEnd, AgentHookOnHandoff, AgentHookOnStart, AgentHookOnToolEnd, AgentHookOnToolStart, AgentHooks, AgentOptions, AgentRegistry, AgentResponse, AgentStartEvent, AgentStartEventMetadata, AgentSuccessEvent, AgentSuccessEventMetadata, AgentTool, AllowedVariableValue, AnyToolConfig, AsyncIterableStream, BaseEventMetadata, BaseLLMOptions, BaseMessage, BaseRetriever, BaseTimelineEvent, BaseTool, BaseToolCall, ClientInfo, Conversation, ConversationQueryOptions, CreateConversationInput, CreateReasoningToolsOptions, CustomEndpointDefinition, CustomEndpointError, CustomEndpointHandler, DEFAULT_INSTRUCTIONS, DataContent, DynamicValueOptions, ErrorStreamPart, EventStatus, ExtractVariableNames, FEW_SHOT_EXAMPLES, FilePart, FinishStreamPart, GenerateObjectOptions, GenerateTextOptions, HTTPServerConfig, HistoryStatus, HttpMethod, ImagePart, InMemoryStorage, InferGenerateObjectResponse, InferGenerateTextResponse, InferMessage, InferModel, InferProviderParams, InferStreamResponse, InferTool, LLMProvider, LibSQLStorage, MCPClient, MCPClientConfig, MCPClientEvents, MCPConfiguration, MCPOptions, MCPServerConfig, MCPToolCall, MCPToolResult, Memory, MemoryEventMetadata, MemoryManager, MemoryMessage, MemoryOptions, MemoryReadErrorEvent, MemoryReadStartEvent, MemoryReadSuccessEvent, MemoryWriteErrorEvent, MemoryWriteStartEvent, MemoryWriteSuccessEvent, MessageContent, MessageFilterOptions, MessageRole, ModelToolCall, NewTimelineEvent, NextAction, NodeType, OnEndHookArgs, OnHandoffHookArgs, OnStartHookArgs, OnToolEndHookArgs, OnToolStartHookArgs, OperationContext, PackageUpdateInfo, PromptCreator, PromptTemplate, ProviderObjectResponse, ProviderObjectStreamResponse, ProviderParams, ProviderResponse, ProviderTextResponse, ProviderTextStreamResponse, ReadableStreamType, ReasoningStep, ReasoningStepSchema, ReasoningStreamPart, ReasoningToolExecuteOptions, RetrieveOptions, Retriever, RetrieverErrorEvent, RetrieverOptions, RetrieverStartEvent, RetrieverSuccessEvent, SSEServerConfig, ServerOptions, SourceStreamPart, StandardEventData, StandardTimelineEvent, StdioServerConfig, StepChunkCallback, StepFinishCallback, StepWithContent, StreamEventForwarderOptions, StreamObjectFinishResult, StreamObjectOnFinishCallback, StreamObjectOptions, StreamPart, StreamTextFinishResult, StreamTextOnFinishCallback, StreamTextOptions, StreamableHTTPServerConfig, SubAgentEvent, TemplateVariables, TextDeltaStreamPart, TextPart, TimelineEventCoreLevel, TimelineEventCoreStatus, TimelineEventCoreType, Tool, ToolCall, ToolCallStreamPart, ToolErrorEvent, ToolErrorInfo, ToolExecuteOptions, ToolExecutionContext, ToolManager, ToolOptions, ToolResultStreamPart, ToolSchema, ToolStartEvent, ToolStatus, ToolStatusInfo, ToolSuccessEvent, Toolkit, ToolsetMap, ToolsetWithTools, TransportError, Usage, UsageInfo, Voice, VoiceEventData, VoiceEventType, VoiceMetadata, VoiceOptions, VoltAgent, VoltAgentError, VoltAgentExporter, VoltAgentExporterOptions, VoltAgentOptions, checkForUpdates, createAsyncIterableStream, createHooks, createNodeId, createPrompt, createReasoningTools, createRetrieverTool, createStreamEventForwarder, createTool, createToolkit, VoltAgent as default, getNodeTypeFromNodeId, registerCustomEndpoint, registerCustomEndpoints, safeJsonParse, serializeValueForDebug, streamEventForwarder, tool, updateAllPackages, updateSinglePackage, zodSchemaToJsonUI };