@voltagent/core 0.1.22 → 0.1.24

package/dist/index.d.ts

@@ -480,6 +480,8 @@ declare class VoltAgentExporter {
     updateHistoryEntry(history_id: string, updates: Partial<AgentHistoryUpdatableFields>): Promise<void>;
 }
 
+type HistoryStatus = "working" | "completed" | "error";
+
 /**
  * Step information for history
  */
@@ -1428,10 +1430,27 @@ interface BaseEventMetadata {
     displayName?: string;
     id: string;
     agentId?: string;
-    usage?: Usage;
+    userContext?: Record<string, unknown>;
 }
-interface AgentStartEventMetadata extends BaseEventMetadata {
+type AgentStartEventMetadata = {
     instructions?: string;
+    modelParameters?: {
+        model?: string;
+        temperature?: number;
+        maxTokens?: number;
+        topP?: number;
+        frequencyPenalty?: number;
+        presencePenalty?: number;
+        stop?: string[];
+        system?: string;
+        toolChoice?: string;
+    };
+} & Record<string, unknown>;
+interface AgentSuccessEventMetadata extends BaseEventMetadata {
+    usage?: Usage;
+}
+interface MemoryEventMetadata extends BaseEventMetadata {
+    type?: string;
 }
 /**
  * Base interface for all Timeline Events.
@@ -1444,17 +1463,16 @@ interface BaseTimelineEvent<M = BaseEventMetadata | null> {
     startTime: string;
     endTime?: string | null;
     status?: TimelineEventCoreStatus;
-    statusMessage?: string | null;
-    level?: TimelineEventCoreLevel;
-    input?: Record<string, unknown> | null;
-    output?: Record<string, unknown> | null;
-    metadata: M;
-    error?: {
+    statusMessage?: {
         message: string;
         stack?: string;
         code?: string | number;
         [key: string]: unknown;
-    } | null;
+    };
+    level?: TimelineEventCoreLevel;
+    input?: Record<string, unknown> | null;
+    output?: Record<string, unknown> | null;
+    metadata: M;
     version?: string | null;
     parentEventId?: string | null;
     traceId: string;
@@ -1474,14 +1492,14 @@ type ToolErrorEvent = BaseTimelineEvent<BaseEventMetadata> & {
     status: "error";
     level: "ERROR" | "CRITICAL";
 };
-type AgentStartEvent = BaseTimelineEvent<AgentStartEventMetadata> & {
+type AgentStartEvent = BaseTimelineEvent<AgentStartEventMetadata & BaseEventMetadata> & {
     name: "agent:start";
     type: "agent";
     input: {
         input: string | BaseMessage[];
     };
 };
-type AgentSuccessEvent = BaseTimelineEvent<BaseEventMetadata> & {
+type AgentSuccessEvent = BaseTimelineEvent<AgentSuccessEventMetadata> & {
     name: "agent:success";
     type: "agent";
     status: "completed";
@@ -1492,31 +1510,31 @@ type AgentErrorEvent = BaseTimelineEvent<BaseEventMetadata> & {
     status: "error";
     level: "ERROR" | "CRITICAL";
 };
-type MemoryReadStartEvent = BaseTimelineEvent<BaseEventMetadata> & {
+type MemoryReadStartEvent = BaseTimelineEvent<MemoryEventMetadata> & {
     name: "memory:read_start";
     type: "memory";
 };
-type MemoryReadSuccessEvent = BaseTimelineEvent<BaseEventMetadata> & {
+type MemoryReadSuccessEvent = BaseTimelineEvent<MemoryEventMetadata> & {
     name: "memory:read_success";
     type: "memory";
     status: "completed";
 };
-type MemoryReadErrorEvent = BaseTimelineEvent<BaseEventMetadata> & {
+type MemoryReadErrorEvent = BaseTimelineEvent<MemoryEventMetadata> & {
     name: "memory:read_error";
     type: "memory";
     status: "error";
     level: "ERROR" | "CRITICAL";
 };
-type MemoryWriteStartEvent = BaseTimelineEvent<BaseEventMetadata> & {
+type MemoryWriteStartEvent = BaseTimelineEvent<MemoryEventMetadata> & {
     name: "memory:write_start";
     type: "memory";
 };
-type MemoryWriteSuccessEvent = BaseTimelineEvent<BaseEventMetadata> & {
+type MemoryWriteSuccessEvent = BaseTimelineEvent<MemoryEventMetadata> & {
     name: "memory:write_success";
     type: "memory";
     status: "completed";
 };
-type MemoryWriteErrorEvent = BaseTimelineEvent<BaseEventMetadata> & {
+type MemoryWriteErrorEvent = BaseTimelineEvent<MemoryEventMetadata> & {
     name: "memory:write_error";
     type: "memory";
     status: "error";
@@ -2732,6 +2750,12 @@ declare const updateSinglePackage: (packageName: string, packagePath?: string) =
     packageName: string;
 }>;
 
+/**
+ * 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;
 
 /**
@@ -3249,4 +3273,4 @@ declare class VoltAgent {
     shutdownTelemetry(): Promise<void>;
 }
 
-export { Agent, AgentErrorEvent, AgentHistoryEntry, AgentHookOnEnd, AgentHookOnHandoff, AgentHookOnStart, AgentHookOnToolEnd, AgentHookOnToolStart, AgentHooks, AgentOptions, AgentRegistry, AgentResponse, AgentStartEvent, AgentStartEventMetadata, AgentSuccessEvent, AgentTool, AllowedVariableValue, AnyToolConfig, BaseEventMetadata, BaseLLMOptions, BaseMessage, BaseRetriever, BaseTimelineEvent, BaseTool, BaseToolCall, ClientInfo, Conversation, CreateConversationInput, CreateReasoningToolsOptions, DEFAULT_INSTRUCTIONS, DataContent, EventStatus, ExtractVariableNames, FEW_SHOT_EXAMPLES, FilePart, GenerateObjectOptions, GenerateTextOptions, HTTPServerConfig, ImagePart, InMemoryStorage, InferGenerateObjectResponse, InferGenerateTextResponse, InferMessage, InferModel, InferProviderParams, InferStreamResponse, InferTool, LLMProvider, LibSQLStorage, MCPClient, MCPClientConfig, MCPClientEvents, MCPConfiguration, MCPOptions, MCPServerConfig, MCPToolCall, MCPToolResult, Memory, 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, ReasoningToolExecuteOptions, Retriever, RetrieverErrorEvent, RetrieverOptions, RetrieverStartEvent, RetrieverSuccessEvent, RetryConfig, StandardEventData, StandardTimelineEvent, StdioServerConfig, StepChunkCallback, StepFinishCallback, StepWithContent, StreamObjectFinishResult, StreamObjectOnFinishCallback, StreamObjectOptions, StreamTextFinishResult, StreamTextOnFinishCallback, StreamTextOptions, TemplateVariables, TextPart, TimelineEventCoreLevel, TimelineEventCoreStatus, TimelineEventCoreType, Tool, ToolCall, ToolErrorEvent, ToolErrorInfo, ToolExecuteOptions, ToolExecutionContext, ToolManager, ToolOptions, ToolSchema, ToolStartEvent, ToolStatus, ToolStatusInfo, ToolSuccessEvent, Toolkit, ToolsetMap, ToolsetWithTools, TransportError, Usage, UsageInfo, Voice, VoiceEventData, VoiceEventType, VoiceMetadata, VoiceOptions, VoltAgent, VoltAgentError, VoltAgentExporter, VoltAgentExporterOptions, checkForUpdates, createHooks, createNodeId, createPrompt, createReasoningTools, createRetrieverTool, createTool, createToolkit, VoltAgent as default, getNodeTypeFromNodeId, 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, BaseEventMetadata, BaseLLMOptions, BaseMessage, BaseRetriever, BaseTimelineEvent, BaseTool, BaseToolCall, ClientInfo, Conversation, CreateConversationInput, CreateReasoningToolsOptions, DEFAULT_INSTRUCTIONS, DataContent, EventStatus, ExtractVariableNames, FEW_SHOT_EXAMPLES, FilePart, GenerateObjectOptions, GenerateTextOptions, HTTPServerConfig, HistoryStatus, 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, ReasoningToolExecuteOptions, Retriever, RetrieverErrorEvent, RetrieverOptions, RetrieverStartEvent, RetrieverSuccessEvent, RetryConfig, StandardEventData, StandardTimelineEvent, StdioServerConfig, StepChunkCallback, StepFinishCallback, StepWithContent, StreamObjectFinishResult, StreamObjectOnFinishCallback, StreamObjectOptions, StreamTextFinishResult, StreamTextOnFinishCallback, StreamTextOptions, TemplateVariables, TextPart, TimelineEventCoreLevel, TimelineEventCoreStatus, TimelineEventCoreType, Tool, ToolCall, ToolErrorEvent, ToolErrorInfo, ToolExecuteOptions, ToolExecutionContext, ToolManager, ToolOptions, ToolSchema, ToolStartEvent, ToolStatus, ToolStatusInfo, ToolSuccessEvent, Toolkit, ToolsetMap, ToolsetWithTools, TransportError, Usage, UsageInfo, Voice, VoiceEventData, VoiceEventType, VoiceMetadata, VoiceOptions, VoltAgent, VoltAgentError, VoltAgentExporter, VoltAgentExporterOptions, checkForUpdates, createHooks, createNodeId, createPrompt, createReasoningTools, createRetrieverTool, createTool, createToolkit, VoltAgent as default, getNodeTypeFromNodeId, safeJsonParse, serializeValueForDebug, tool, updateAllPackages, updateSinglePackage, zodSchemaToJsonUI };