@voltagent/core 0.1.40 → 0.1.42

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { Span } from '@opentelemetry/api';
+import { Simplify, LiteralUnion } from 'type-fest';
 import { Context } from 'hono';
 import { SpanExporter } from '@opentelemetry/sdk-trace-base';
 import { ClientCapabilities } from '@modelcontextprotocol/sdk/types.js';
@@ -731,6 +732,42 @@ declare class VoltAgentExporter {
     updateHistoryEntry(history_id: string, updates: Partial<AgentHistoryUpdatableFields>): Promise<void>;
 }
 
+type StreamEventType = StreamEvent["type"];
+type StreamEvent = StreamEventTextDelta | StreamEventReasoning | StreamEventSource | StreamEventToolCall | StreamEventToolResult | StreamEventFinish | StreamEventError;
+type StreamEventTextDelta = InferStreamEventBase<TextDeltaStreamPart>;
+type StreamEventReasoning = InferStreamEventBase<ReasoningStreamPart>;
+type StreamEventSource = InferStreamEventBase<SourceStreamPart>;
+type StreamEventToolCall = InferStreamEventBase<ToolCallStreamPart>;
+type StreamEventToolResult = InferStreamEventBase<ToolResultStreamPart>;
+type StreamEventFinish = InferStreamEventBase<FinishStreamPart>;
+type StreamEventError = InferStreamEventBase<ErrorStreamPart>;
+type InferStreamEventBase<TStreamPart extends StreamPart> = {
+    type: TStreamPart["type"];
+    data: InferStreamEventData<TStreamPart> | null;
+    timestamp: string;
+    subAgentId: string;
+    subAgentName: string;
+};
+type InferStreamEventData<TStreamPart extends StreamPart> = Simplify<Omit<TStreamPart, "type" | "subAgentId" | "subAgentName">>;
+
+interface StreamEventForwarderOptions {
+    forwarder?: (event: StreamEvent) => Promise<void>;
+    filterTypes?: LiteralUnion<StreamEventType, 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: StreamEvent, options?: StreamEventForwarderOptions): Promise<void>;
+/**
+ * Creates a configured streamEventForwarder function
+ * @param options - Configuration options
+ * @returns A configured forwarder function
+ */
+declare function createStreamEventForwarder(options?: StreamEventForwarderOptions): (event: StreamEvent) => Promise<void>;
+
 /**
  * Options object for dynamic value resolution
  */
@@ -983,13 +1020,7 @@ type AgentHandoffOptions = {
      * Optional real-time event forwarder function
      * Used to forward SubAgent events to parent stream in real-time
      */
-    forwardEvent?: (event: {
-        type: string;
-        data: any;
-        timestamp: string;
-        subAgentId: string;
-        subAgentName: string;
-    }) => Promise<void>;
+    forwardEvent?: (event: StreamEvent) => Promise<void>;
 };
 /**
  * Result of a handoff to another agent
@@ -3203,23 +3234,23 @@ declare const ReasoningStepSchema: z.ZodObject<{
     title: string;
     id: string;
     historyEntryId: string;
-    agentId: string;
     reasoning: string;
     timestamp: string;
+    agentId: string;
     confidence: number;
-    action?: string | undefined;
     result?: string | undefined;
+    action?: string | undefined;
     next_action?: NextAction | undefined;
 }, {
     type: "thought" | "analysis";
     title: string;
     id: string;
     historyEntryId: string;
-    agentId: string;
     reasoning: string;
     timestamp: string;
-    action?: string | undefined;
+    agentId: string;
     result?: string | undefined;
+    action?: string | undefined;
     next_action?: NextAction | undefined;
     confidence?: number | undefined;
 }>;
@@ -3373,31 +3404,6 @@ declare const updateSinglePackage: (packageName: string, packagePath?: string) =
 declare function safeJsonParse(value: string | null | undefined): any;
 declare function serializeValueForDebug(value: unknown): unknown;
 
-interface SubAgentEvent {
-    type: string;
-    data: any;
-    timestamp: string;
-    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.
  * This is the preferred way to use a retriever as a tool, as it properly maintains the 'this' context.
@@ -3999,4 +4005,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, 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 };
+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, 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 };