@voltagent/core 1.1.19 → 1.1.21

package/dist/index.d.mts

@@ -7,15 +7,13 @@ import { z } from 'zod';
 import { AsyncIterableStream } from '@voltagent/internal/utils';
 export { AsyncIterableStream, createAsyncIterableStream } from '@voltagent/internal/utils';
 import { Logger, LogFn, LogBuffer } from '@voltagent/internal';
-import * as _opentelemetry_api from '@opentelemetry/api';
-import { Tracer, SpanOptions, Span, SpanStatusCode as SpanStatusCode$1, SpanKind as SpanKind$1, Context } from '@opentelemetry/api';
+import { Tracer, SpanOptions, Span, SpanStatusCode as SpanStatusCode$1, context, trace, SpanKind as SpanKind$1, Context } from '@opentelemetry/api';
 export { Span, SpanOptions, Tracer, context, trace } from '@opentelemetry/api';
-import { LogRecordProcessor, LoggerProvider, ReadableLogRecord } from '@opentelemetry/sdk-logs';
+import { LogRecordProcessor, LoggerProvider, ReadableLogRecord, SdkLogRecord } from '@opentelemetry/sdk-logs';
 import { NodeTracerProvider } from '@opentelemetry/sdk-trace-node';
-import { SpanProcessor, ReadableSpan } from '@opentelemetry/sdk-trace-base';
+import { SpanProcessor, BasicTracerProvider, ReadableSpan, Span as Span$1 } from '@opentelemetry/sdk-trace-base';
 import { DangerouslyAllowAny, PlainObject } from '@voltagent/internal/types';
 import * as TF from 'type-fest';
-import { EventEmitter } from 'node:events';
 import { A2AServerLike, A2AServerDeps, A2AServerMetadata, A2AServerFactory } from '@voltagent/internal/a2a';
 import { MCPServerLike, MCPServerDeps, MCPServerMetadata, MCPServerFactory } from '@voltagent/internal/mcp';
 import { ClientCapabilities } from '@modelcontextprotocol/sdk/types.js';
@@ -2036,18 +2034,34 @@ interface ObservabilityConfig {
     resourceAttributes?: Record<string, any>;
     spanFilters?: SpanFilterConfig;
     voltOpsSync?: {
-        sampling?: {
-            strategy?: "always" | "never" | "ratio" | "parent";
-            ratio?: number;
-        };
+        sampling?: ObservabilitySamplingConfig;
         maxQueueSize?: number;
         maxExportBatchSize?: number;
         scheduledDelayMillis?: number;
         exportTimeoutMillis?: number;
     };
+    serverlessRemote?: ServerlessRemoteExportConfig;
     spanProcessors?: SpanProcessor[];
     logProcessors?: LogRecordProcessor[];
 }
+interface ObservabilitySamplingConfig {
+    strategy?: "always" | "never" | "ratio" | "parent";
+    ratio?: number;
+}
+interface ServerlessRemoteEndpointConfig {
+    url: string;
+    headers?: Record<string, string>;
+    method?: string;
+}
+interface ServerlessRemoteExportConfig {
+    traces?: ServerlessRemoteEndpointConfig;
+    logs?: ServerlessRemoteEndpointConfig;
+    sampling?: ObservabilitySamplingConfig;
+    maxQueueSize?: number;
+    maxExportBatchSize?: number;
+    scheduledDelayMillis?: number;
+    exportTimeoutMillis?: number;
+}
 /**
  * Span filter configuration
  */
@@ -2227,11 +2241,22 @@ interface SpanTreeNode extends ObservabilitySpan {
     depth: number;
 }
 declare function buildSpanTree(spans: ObservabilitySpan[]): SpanTreeNode[];
+/**
+ * Convert OpenTelemetry ReadableLogRecord to ObservabilityLogRecord
+ */
+declare function readableLogRecordToObservabilityLog(readableLog: any): ObservabilityLogRecord;
+
+/**
+ * VoltAgentObservability (Node runtime)
+ *
+ * Wraps OpenTelemetry's NodeTracerProvider and configures VoltAgent-specific
+ * processors/exporters. This retains the existing Node behavior.
+ */
 
 /**
- * VoltAgent Observability wrapper around OpenTelemetry
+ * VoltAgent Observability wrapper around OpenTelemetry for Node
  */
-declare class VoltAgentObservability {
+declare class VoltAgentObservability$1 {
     private provider;
     private loggerProvider;
     private tracer;
@@ -2249,112 +2274,109 @@ declare class VoltAgentObservability {
     private setupProcessors;
     private applySpanFilter;
     private resolveSpanFilterOptions;
-    /**
-     * Try to initialize Pino OpenTelemetry bridge if available
-     */
     private tryInitializePinoBridge;
-    /**
-     * Set up log processors
-     */
     private setupLogProcessors;
-    /**
-     * Get the OpenTelemetry tracer
-     */
     getTracer(): Tracer;
-    /**
-     * Get the LoggerProvider for logs integration
-     */
     getLoggerProvider(): LoggerProvider;
-    /**
-     * Get the storage adapter
-     */
     getStorage(): ObservabilityStorageAdapter;
-    /**
-     * Start a new span
-     */
     startSpan(name: string, options?: SpanOptions & {
         type?: string;
         attributes?: Record<string, any>;
     }): Span;
-    /**
-     * Start an active span (sets it as the current span in context)
-     */
     startActiveSpan<T>(name: string, options: SpanOptions & {
         type?: string;
         attributes?: Record<string, any>;
     }, fn: (span: Span) => T): T;
-    /**
-     * Get the current active span
-     */
     getActiveSpan(): Span | undefined;
-    /**
-     * Set attributes on the current span
-     */
     setSpanAttributes(attributes: Record<string, any>): void;
-    /**
-     * Add an event to the current span
-     */
     addSpanEvent(name: string, attributes?: Record<string, any>): void;
-    /**
-     * Set the status of the current span
-     */
     setSpanStatus(code: SpanStatusCode$1, message?: string): void;
-    /**
-     * Record an exception on the current span
-     */
     recordException(error: Error): void;
-    /**
-     * Subscribe to WebSocket events
-     */
     subscribeToWebSocketEvents(callback: (event: any) => void): (() => void) | undefined;
-    /**
-     * Get traces from storage
-     */
     getTraceFromStorage(traceId: string): Promise<any>;
-    /**
-     * Get a span from storage
-     */
     getSpan(spanId: string): Promise<any>;
-    /**
-     * Clean up old spans from storage
-     */
     cleanupOldSpans(beforeTimestamp: number): Promise<number>;
-    /**
-     * Get logs from storage
-     */
     getLogsByTraceId(traceId: string): Promise<any[]>;
-    /**
-     * Get logs from storage by span ID
-     */
     getLogsBySpanId(spanId: string): Promise<any[]>;
-    /**
-     * Shutdown the observability system
-     */
     shutdown(): Promise<void>;
-    /**
-     * Force flush all pending spans and logs
-     */
     forceFlush(): Promise<void>;
-    /**
-     * Get provider for advanced usage
-     */
     getProvider(): NodeTracerProvider;
-    /**
-     * Get OpenTelemetry context API
-     */
-    getContext(): _opentelemetry_api.ContextAPI;
-    /**
-     * Get OpenTelemetry trace API
-     */
-    getTraceAPI(): _opentelemetry_api.TraceAPI;
-    /**
-     * Get span kinds enum
-     */
+    getContext(): typeof context;
+    getTraceAPI(): typeof trace;
+    getSpanKind(): typeof SpanKind$1;
+    getSpanStatusCode(): typeof SpanStatusCode$1;
+}
+
+/**
+ * VoltAgentObservability (serverless runtime)
+ *
+ * Simplified observability pipeline for Workers/serverless runtimes. Uses
+ * BasicTracerProvider and fetch-friendly processors only.
+ */
+
+declare class ServerlessVoltAgentObservability {
+    private provider;
+    private loggerProvider;
+    private tracer;
+    private storage;
+    private websocketProcessor?;
+    private localStorageProcessor?;
+    private config;
+    private resource;
+    private spanFilterOptions?;
+    private instrumentationScopeName;
+    private spanStack;
+    constructor(config?: ObservabilityConfig);
+    private setupProcessors;
+    private applySpanFilter;
+    private resolveSpanFilterOptions;
+    private setupLogProcessors;
+    private initializeTelemetryPipeline;
+    getTracer(): Tracer;
+    getLoggerProvider(): LoggerProvider;
+    getStorage(): ObservabilityStorageAdapter;
+    startSpan(name: string, options?: SpanOptions & {
+        type?: string;
+        attributes?: Record<string, any>;
+    }): Span;
+    startActiveSpan<T>(name: string, options: SpanOptions & {
+        type?: string;
+        attributes?: Record<string, any>;
+    }, fn: (span: Span) => T): T;
+    getActiveSpan(): Span | undefined;
+    setSpanAttributes(attributes: Record<string, any>): void;
+    addSpanEvent(name: string, attributes?: Record<string, any>): void;
+    setSpanStatus(code: SpanStatusCode$1, message?: string): void;
+    recordException(error: Error): void;
+    subscribeToWebSocketEvents(callback: (event: any) => void): (() => void) | undefined;
+    getTraceFromStorage(traceId: string): Promise<any>;
+    getSpan(spanId: string): Promise<any>;
+    cleanupOldSpans(beforeTimestamp: number): Promise<number>;
+    getLogsByTraceId(traceId: string): Promise<any[]>;
+    getLogsBySpanId(spanId: string): Promise<any[]>;
+    shutdown(): Promise<void>;
+    forceFlush(): Promise<void>;
+    getProvider(): BasicTracerProvider;
+    getContext(): typeof context;
+    getTraceAPI(): typeof trace;
     getSpanKind(): typeof SpanKind$1;
-    /**
-     * Get span status codes enum
-     */
     getSpanStatusCode(): typeof SpanStatusCode$1;
+    updateServerlessRemote(config: ServerlessRemoteExportConfig): void;
+    private pushSpan;
+    private popSpan;
+}
+
+/**
+ * Minimal event emitter that works in both Node and edge runtimes.
+ */
+declare class SimpleEventEmitter {
+    private listeners;
+    on(event: string, listener: (...args: any[]) => void): this;
+    off(event: string, listener: (...args: any[]) => void): this;
+    once(event: string, listener: (...args: any[]) => void): this;
+    emit(event: string, ...args: any[]): boolean;
+    listenerCount(event: string): number;
+    removeAllListeners(event?: string): void;
 }
 
 /**
@@ -2367,7 +2389,7 @@ declare class VoltAgentObservability {
 /**
  * Singleton EventEmitter for WebSocket broadcasting
  */
-declare class WebSocketEventEmitter extends EventEmitter {
+declare class WebSocketEventEmitter extends SimpleEventEmitter {
     private static instance;
     private constructor();
     static getInstance(): WebSocketEventEmitter;
@@ -2443,6 +2465,90 @@ declare class LocalStorageSpanProcessor implements SpanProcessor {
     getStorage(): ObservabilityStorageAdapter;
 }
 
+/**
+ * Lazy Remote Export Processor for OpenTelemetry
+ *
+ * This processor delays the initialization of remote export until
+ * the VoltOpsClient is available in the global registry, solving
+ * the race condition between Agent and VoltAgent initialization.
+ */
+
+interface LazyRemoteExportConfig {
+    maxQueueSize?: number;
+    maxExportBatchSize?: number;
+    scheduledDelayMillis?: number;
+    exportTimeoutMillis?: number;
+    logger?: Logger;
+}
+declare class LazyRemoteExportProcessor implements SpanProcessor {
+    private config;
+    private actualProcessor?;
+    private pendingSpans;
+    private initialized;
+    private initCheckInterval?;
+    private logger?;
+    constructor(config?: LazyRemoteExportConfig);
+    /**
+     * Called when a span is started
+     */
+    onStart(_span: Span, _parentContext: Context): void;
+    /**
+     * Called when a span ends
+     */
+    onEnd(span: ReadableSpan): void;
+    /**
+     * Force flush all pending spans
+     */
+    forceFlush(): Promise<void>;
+    /**
+     * Shutdown the processor
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Start periodic check for VoltOpsClient availability
+     */
+    private startInitializationCheck;
+    /**
+     * Try to initialize the actual processor
+     */
+    private tryInitialize;
+}
+
+/**
+ * SpanFilterProcessor
+ *
+ * Wraps another SpanProcessor and ensures only spans that match the
+ * configured filter are forwarded. This prevents VoltAgent's
+ * observability pipeline from processing spans that originate from
+ * unrelated OpenTelemetry instrumentation.
+ */
+
+/**
+ * Configuration for SpanFilterProcessor
+ */
+interface SpanFilterOptions {
+    allowedServiceNames?: string[];
+    allowedInstrumentationScopes?: string[];
+    predicate?: (span: Span$1 | ReadableSpan) => boolean;
+}
+/**
+ * SpanProcessor wrapper that filters spans before delegating
+ */
+declare class SpanFilterProcessor implements SpanProcessor {
+    private readonly delegate;
+    private readonly options;
+    private readonly allowedServiceNames?;
+    private readonly allowedInstrumentationScopes?;
+    constructor(delegate: SpanProcessor, options?: SpanFilterOptions);
+    onStart(span: Span$1, parentContext: Context): void;
+    onEnd(span: ReadableSpan): void;
+    shutdown(): Promise<void>;
+    forceFlush(): Promise<void>;
+    private shouldProcess;
+    private extractInstrumentationScopeName;
+    private extractServiceName;
+}
+
 /**
  * InMemoryStorageAdapter
  *
@@ -2549,6 +2655,29 @@ declare class InMemoryStorageAdapter$1 implements ObservabilityStorageAdapter {
     };
 }
 
+/**
+ * Storage Log Processor
+ *
+ * Stores OpenTelemetry log records in the configured storage adapter
+ */
+
+declare class StorageLogProcessor implements LogRecordProcessor {
+    private storage;
+    constructor(storage: ObservabilityStorageAdapter);
+    /**
+     * Called when a log record is emitted
+     */
+    onEmit(logRecord: ReadableLogRecord, _context?: Context): void;
+    /**
+     * Force flush any pending logs
+     */
+    forceFlush(): Promise<void>;
+    /**
+     * Shutdown the processor
+     */
+    shutdown(): Promise<void>;
+}
+
 /**
  * WebSocket Log Processor
  *
@@ -2583,6 +2712,72 @@ declare class WebSocketLogProcessor implements LogRecordProcessor {
     shutdown(): Promise<void>;
 }
 
+/**
+ * Remote Log Processor
+ *
+ * Exports OpenTelemetry log records to remote VoltOps API using OTLP protocol
+ * Similar to LazyRemoteExportProcessor for spans, but for logs
+ */
+
+interface RemoteLogExportConfig {
+    maxQueueSize?: number;
+    maxExportBatchSize?: number;
+    scheduledDelayMillis?: number;
+    exportTimeoutMillis?: number;
+    samplingConfig?: {
+        strategy?: "always" | "never" | "ratio" | "parent";
+        ratio?: number;
+    };
+}
+/**
+ * Lazy Remote Log Processor
+ *
+ * Delays initialization until VoltOpsClient is available,
+ * then exports logs to VoltOps API using OTLP protocol
+ */
+declare class RemoteLogProcessor implements LogRecordProcessor {
+    private config;
+    private actualProcessor?;
+    private pendingLogs;
+    private initialized;
+    private initCheckInterval?;
+    constructor(config?: RemoteLogExportConfig);
+    /**
+     * Called to emit a log record
+     */
+    onEmit(logRecord: SdkLogRecord): void;
+    /**
+     * Force flush all pending logs
+     */
+    forceFlush(): Promise<void>;
+    /**
+     * Shutdown the processor
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Start periodic check for VoltOpsClient availability
+     */
+    private startInitializationCheck;
+    /**
+     * Try to initialize the actual processor
+     */
+    private tryInitialize;
+}
+
+/**
+ * VoltAgent Observability - Built on OpenTelemetry
+ *
+ * This module provides OpenTelemetry-based observability with:
+ * - WebSocket real-time events via custom SpanProcessor
+ * - Local storage via custom SpanProcessor
+ * - OTLP export support
+ * - Zero-configuration defaults
+ */
+
+declare const VoltAgentObservability: typeof VoltAgentObservability$1;
+type VoltAgentObservability = VoltAgentObservability$1 | ServerlessVoltAgentObservability;
+declare const createVoltAgentObservability: (config?: ObservabilityConfig) => VoltAgentObservability$1 | ServerlessVoltAgentObservability;
+
 interface OnStartHookArgs {
     agent: Agent;
     context: OperationContext;
@@ -2620,6 +2815,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. */
@@ -2629,6 +2826,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;
@@ -2645,6 +2856,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;
 /**
@@ -2657,6 +2869,7 @@ type AgentHooks = {
     onToolStart?: AgentHookOnToolStart;
     onToolEnd?: AgentHookOnToolEnd;
     onPrepareMessages?: AgentHookOnPrepareMessages;
+    onPrepareModelMessages?: AgentHookOnPrepareModelMessages;
     onError?: AgentHookOnError;
     onStepFinish?: AgentHookOnStepFinish;
 };
@@ -2690,7 +2903,6 @@ declare class AgentTraceContext {
     private tracer;
     private commonAttributes;
     private activeContext;
-    private observability;
     constructor(observability: VoltAgentObservability, operationName: string, options: TraceContextOptions);
     /**
      * Create a child span with automatic parent context and attribute inheritance
@@ -3447,10 +3659,6 @@ declare class Agent {
      * but still work standalone with their own instance
      */
     private getObservability;
-    /**
-     * Create a default observability instance for standalone agent usage
-     */
-    private getOrCreateDefaultObservability;
     /**
      * Check if semantic search is supported
      */
@@ -3760,6 +3968,7 @@ interface WorkflowStreamResult<RESULT_SCHEMA extends z.ZodTypeAny, RESUME_SCHEMA
     cancellation: Promise<WorkflowCancellationMetadata | undefined>;
     error: Promise<unknown | undefined>;
     usage: Promise<UsageInfo>;
+    toUIMessageStreamResponse: StreamTextResult<any, any>["toUIMessageStreamResponse"];
     /**
      * Resume a suspended workflow execution
      * @param input - Optional new input data for resuming (validated against resumeSchema if provided)
@@ -4052,7 +4261,7 @@ interface WorkflowStreamEvent {
     /**
      * Type of the event (e.g., "step-start", "step-complete", "custom", "agent-stream")
      */
-    type: string;
+    type: "workflow-start" | "workflow-suspended" | "workflow-complete" | "workflow-cancelled" | "workflow-error" | "step-start" | "step-complete";
     /**
      * Unique execution ID for this workflow run
      */
@@ -5395,7 +5604,7 @@ interface RegisteredWorkflow {
 declare global {
     var ___voltagent_workflow_registry: WorkflowRegistry | undefined;
 }
-declare class WorkflowRegistry extends EventEmitter {
+declare class WorkflowRegistry extends SimpleEventEmitter {
     private workflows;
     private logger;
     activeExecutions: Map<string, WorkflowSuspendController>;
@@ -6093,7 +6302,7 @@ type AnyToolConfig = Tool<any>;
  * Wraps the official MCP SDK client to provide a higher-level interface.
  * Internal implementation differs from original source.
  */
-declare class MCPClient extends EventEmitter {
+declare class MCPClient extends SimpleEventEmitter {
     /**
      * Underlying MCP client instance from the SDK.
      */
@@ -6324,6 +6533,20 @@ interface IServerProvider {
     stop(): Promise<void>;
     isRunning(): boolean;
 }
+type ServerlessRequestHandler = (req: Request, ...args: unknown[]) => Promise<Response>;
+type CloudflareFetchHandler = (req: Request, env: Record<string, unknown>, ctx: unknown) => Promise<Response>;
+interface IServerlessProvider {
+    handleRequest(request: Request): Promise<Response>;
+    toCloudflareWorker(): {
+        fetch: CloudflareFetchHandler;
+    };
+    toVercelEdge(): ServerlessRequestHandler;
+    toDeno(): ServerlessRequestHandler;
+    auto(): {
+        fetch: CloudflareFetchHandler;
+    } | ServerlessRequestHandler;
+}
+type ServerlessProviderFactory = (deps: ServerProviderDeps) => IServerlessProvider;
 /**
  * Server provider dependencies
  */
@@ -6356,6 +6579,7 @@ interface ServerProviderDeps {
     a2a?: {
         registry: A2AServerRegistry;
     };
+    ensureEnvironment?: (env?: Record<string, unknown>) => void;
 }
 /**
  * Server provider factory type
@@ -6399,7 +6623,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
@@ -6410,6 +6637,11 @@ type VoltAgentOptions = {
      * Example: honoServer({ port: 3141, enableSwaggerUI: true })
      */
     server?: ServerProviderFactory;
+    /**
+     * Serverless provider factory function for fetch-based runtimes
+     * Example: serverlessHono({ corsOrigin: '*' })
+     */
+    serverless?: ServerlessProviderFactory;
     /**
      * Unified VoltOps client for telemetry and prompt management
      * Replaces the old telemetryExporter approach with a comprehensive solution.
@@ -6570,55 +6802,6 @@ interface ToolCall {
  */
 declare function zodSchemaToJsonUI(schema: any): any;
 
-type UpdateOptions = {
-    filter?: string;
-    useCache?: boolean;
-    forceRefresh?: boolean;
-};
-/**
- * Package update info with semver details
- */
-type PackageUpdateInfo = {
-    name: string;
-    installed: string;
-    latest: string;
-    type: "major" | "minor" | "patch" | "latest";
-    packageJson: string;
-};
-/**
- * Checks for dependency updates using native package manager commands
- * @returns Object containing update information
- */
-declare const checkForUpdates: (packagePath?: string, options?: UpdateOptions) => Promise<{
-    hasUpdates: boolean;
-    updates: PackageUpdateInfo[];
-    count: number;
-    message: string;
-}>;
-/**
- * Update all packages that have available updates using native package manager
- * @param packagePath Optional path to package.json, uses current directory if not provided
- * @returns Result of the update operation
- */
-declare const updateAllPackages: (packagePath?: string) => Promise<{
-    success: boolean;
-    message: string;
-    updatedPackages?: string[];
-    requiresRestart?: boolean;
-}>;
-/**
- * Update a single package to its latest version using native package manager
- * @param packageName Name of the package to update
- * @param packagePath Optional path to package.json, uses current directory if not provided
- * @returns Result of the update operation
- */
-declare const updateSinglePackage: (packageName: string, packagePath?: string) => Promise<{
-    success: boolean;
-    message: string;
-    packageName: string;
-    requiresRestart?: boolean;
-}>;
-
 /**
  * Safely parse JSON string. If parsing fails, returns the original value.
  * @param value String to parse as JSON
@@ -6770,6 +6953,10 @@ declare const messageHelpers: {
     MessageContentBuilder: typeof MessageContentBuilder;
 };
 
+declare const isServerlessRuntime: () => boolean;
+declare const isNodeRuntime: () => boolean;
+declare const getEnvVar: (key: string) => string | undefined;
+
 /**
  * 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.
@@ -6894,6 +7081,55 @@ declare class AgentRegistry {
     getGlobalObservability(): VoltAgentObservability | undefined;
 }
 
+type UpdateOptions = {
+    filter?: string;
+    useCache?: boolean;
+    forceRefresh?: boolean;
+};
+/**
+ * Package update info with semver details
+ */
+type PackageUpdateInfo = {
+    name: string;
+    installed: string;
+    latest: string;
+    type: "major" | "minor" | "patch" | "latest";
+    packageJson: string;
+};
+/**
+ * Checks for dependency updates using native package manager commands
+ * @returns Object containing update information
+ */
+declare const checkForUpdates: (packagePath?: string, options?: UpdateOptions) => Promise<{
+    hasUpdates: boolean;
+    updates: PackageUpdateInfo[];
+    count: number;
+    message: string;
+}>;
+/**
+ * Update all packages that have available updates using native package manager
+ * @param packagePath Optional path to package.json, uses current directory if not provided
+ * @returns Result of the update operation
+ */
+declare const updateAllPackages: (packagePath?: string) => Promise<{
+    success: boolean;
+    message: string;
+    updatedPackages?: string[];
+    requiresRestart?: boolean;
+}>;
+/**
+ * Update a single package to its latest version using native package manager
+ * @param packageName Name of the package to update
+ * @param packagePath Optional path to package.json, uses current directory if not provided
+ * @returns Result of the update operation
+ */
+declare const updateSinglePackage: (packageName: string, packagePath?: string) => Promise<{
+    success: boolean;
+    message: string;
+    packageName: string;
+    requiresRestart?: boolean;
+}>;
+
 /**
  * Prompt manager with caching and Liquid template processing
  */
@@ -7014,13 +7250,19 @@ declare class VoltAgent {
     private registry;
     private workflowRegistry;
     private serverInstance?;
+    private serverlessProvider?;
     private logger;
     private observability?;
     private readonly mcpServers;
     private readonly mcpServerRegistry;
     private readonly a2aServers;
     private readonly a2aServerRegistry;
+    private readonly ensureEnvironmentBinding;
     constructor(options: VoltAgentOptions);
+    serverless(): IServerlessProvider;
+    private ensureEnvironment;
+    private autoConfigureVoltOpsClientFromEnv;
+    private syncServerlessObservabilityRemote;
     /**
      * Setup graceful shutdown handlers
      */
@@ -7037,7 +7279,7 @@ declare class VoltAgent {
     /**
      * Register multiple agents
      */
-    registerAgents(agents: Record<string, Agent>): void;
+    registerAgents(agents?: Record<string, Agent>): void;
     /**
      * Start the server
      */
@@ -7113,4 +7355,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 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 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, 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, 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 RetrieveOptions, type Retriever, type RetrieverOptions, type SearchOptions, type SearchResult, type ServerAgentResponse, type ServerApiResponse, type ServerProviderDeps, type ServerProviderFactory, type ServerWorkflowResponse, type SpanAttributes, type SpanEvent, SpanKind, type SpanLink, type SpanStatus, SpanStatusCode, type SpanTreeNode, type StepChunkCallback, type StepFinishCallback, type StepWithContent, type StopWhen, type StorageAdapter, StorageError, 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, createVoltOpsClient, createWorkflow, createWorkflowChain, createWorkflowStepNodeId, VoltAgent as default, extractFileParts, extractImageParts, extractText, extractTextParts, extractWorkflowStepInfo, filterContentParts, getContentLength, getGlobalLogBuffer, getGlobalLogger, getNodeTypeFromNodeId, getWorkflowStepNodeType, hasContent, hasFilePart, hasImagePart, hasTextPart, isAbortError, isStructuredContent, isTextContent, isVoltAgentError, mapMessageContent, messageHelpers, normalizeContent, normalizeToArray, prependToMessage, 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 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 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 };