@voltagent/core 0.1.10 → 0.1.12

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 import { z } from 'zod';
+import { Span } from '@opentelemetry/api';
+import { SpanExporter } from '@opentelemetry/sdk-trace-base';
 import { ClientCapabilities } from '@modelcontextprotocol/sdk/types.js';
 import { EventEmitter } from 'node:events';
 
@@ -423,6 +425,7 @@ type ProviderOptions = {
     onFinish?: (result: unknown) => Promise<void>;
     onError?: (error: unknown) => Promise<void>;
     toolExecutionContext?: ToolExecutionContext;
+    [key: string]: unknown;
 };
 /**
  * Agent configuration options
@@ -647,6 +650,10 @@ type OperationContext = {
     parentAgentId?: string;
     /** Parent history entry ID if part of a delegation chain */
     parentHistoryEntryId?: string;
+    /** The root OpenTelemetry span for this operation */
+    otelSpan?: Span;
+    /** Map to store active OpenTelemetry spans for tool calls within this operation */
+    toolSpans?: Map<string, Span>;
 };
 /**
  * Tool execution context passed to tool.execute method
@@ -2085,6 +2092,7 @@ declare class Agent<TProvider extends {
      * Initialize a new history entry
      * @param input User input
      * @param initialStatus Initial status
+     * @param options Options including parent context
      * @returns Created operation context
      */
     private initializeHistory;
@@ -2143,6 +2151,10 @@ declare class Agent<TProvider extends {
      * Agent event creator (update)
      */
     private addAgentEvent;
+    /**
+     * Helper method to enrich and end an OpenTelemetry span associated with a tool call.
+     */
+    private _endOtelToolSpan;
     /**
      * Generate a text response without streaming
      */
@@ -2894,6 +2906,13 @@ type VoltAgentOptions = {
     port?: number;
     autoStart?: boolean;
     checkDependencies?: boolean;
+    /**
+     * Optional OpenTelemetry SpanExporter instance or array of instances.
+     * If provided, VoltAgent will attempt to initialize and register
+     * a NodeTracerProvider with a BatchSpanProcessor for the given exporter(s).
+     * It's recommended to only provide this in one VoltAgent instance per application process.
+     */
+    telemetryExporter?: SpanExporter | SpanExporter[];
 };
 /**
  * Main VoltAgent class for managing agents and server
@@ -2930,6 +2949,8 @@ declare class VoltAgent {
      * Get agent count
      */
     getAgentCount(): number;
+    private initializeGlobalTelemetry;
+    shutdownTelemetry(): Promise<void>;
 }
 
 export { Agent, AgentHistoryEntry, AgentHookOnEnd, AgentHookOnHandoff, AgentHookOnStart, AgentHookOnToolEnd, AgentHookOnToolStart, AgentHooks, AgentOptions, AgentRegistry, AgentResponse, AgentTool, AllowedVariableValue, AnyToolConfig, BaseLLMOptions, BaseMessage, BaseRetriever, BaseTool, BaseToolCall, ClientInfo, Conversation, CreateConversationInput, CreateReasoningToolsOptions, DEFAULT_INSTRUCTIONS, DataContent, 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, MessageContent, MessageFilterOptions, MessageRole, ModelToolCall, NextAction, NodeType, OnEndHookArgs, OnHandoffHookArgs, OnStartHookArgs, OnToolEndHookArgs, OnToolStartHookArgs, OperationContext, PackageUpdateInfo, PromptCreator, PromptTemplate, ProviderObjectResponse, ProviderObjectStreamResponse, ProviderParams, ProviderResponse, ProviderTextResponse, ProviderTextStreamResponse, ReadableStreamType, ReasoningStep, ReasoningStepSchema, ReasoningToolExecuteOptions, Retriever, RetrieverOptions, RetryConfig, StdioServerConfig, StepChunkCallback, StepFinishCallback, StepWithContent, StreamObjectFinishResult, StreamObjectOnFinishCallback, StreamObjectOptions, StreamTextFinishResult, StreamTextOnFinishCallback, StreamTextOptions, TemplateVariables, TextPart, Tool, ToolCall, ToolErrorInfo, ToolExecuteOptions, ToolExecutionContext, ToolManager, ToolOptions, ToolSchema, ToolStatus, ToolStatusInfo, Toolkit, ToolsetMap, ToolsetWithTools, TransportError, UsageInfo, Voice, VoiceEventData, VoiceEventType, VoiceMetadata, VoiceOptions, VoltAgent, VoltAgentError, checkForUpdates, createHooks, createNodeId, createPrompt, createReasoningTools, createRetrieverTool, createTool, VoltAgent as default, getNodeTypeFromNodeId, serializeValueForDebug, tool, updateAllPackages, updateSinglePackage, zodSchemaToJsonUI };