@voltagent/core 2.1.6 → 2.2.0

package/dist/index.d.mts

@@ -1,14 +1,14 @@
 import { ToolExecutionOptions, ToolNeedsApprovalFunction, ProviderOptions as ProviderOptions$1, ModelMessage, DataContent as DataContent$1, UserContent, AssistantContent, ToolContent } from '@ai-sdk/provider-utils';
 export { AssistantContent, FilePart, ImagePart, ProviderOptions, TextPart, ToolContent, UserContent } from '@ai-sdk/provider-utils';
-import { Tool as Tool$1, TextStreamPart, generateText, UIMessage, StreamTextResult, LanguageModel, CallSettings, Output, ToolChoice, ToolSet, GenerateTextResult, InferGenerateOutput, GenerateObjectResult, AsyncIterableStream as AsyncIterableStream$1, Warning, LanguageModelUsage, FinishReason, EmbeddingModel, TextUIPart, FileUIPart } from 'ai';
+import { Tool as Tool$1, EmbeddingModel, TextStreamPart, generateText, UIMessage, StreamTextResult, LanguageModel, CallSettings, Output, ToolChoice, ToolSet, GenerateTextResult, InferGenerateOutput, GenerateObjectResult, AsyncIterableStream as AsyncIterableStream$1, Warning, LanguageModelUsage, FinishReason, TextUIPart, FileUIPart } from 'ai';
 export { LanguageModel, Tool as VercelTool, hasToolCall, stepCountIs } from 'ai';
 import * as zod from 'zod';
 import { z } from 'zod';
+import { Span, Tracer, SpanOptions, SpanStatusCode as SpanStatusCode$1, context, trace, SpanKind as SpanKind$1, Context } from '@opentelemetry/api';
+export { ROOT_CONTEXT, Span, SpanOptions, Tracer, context, propagation, trace } from '@opentelemetry/api';
+import { Logger, LogFn, LogBuffer } from '@voltagent/internal';
 import { AsyncIterableStream } from '@voltagent/internal/utils';
 export { AsyncIterableStream, createAsyncIterableStream } from '@voltagent/internal/utils';
-import { Logger, LogFn, LogBuffer } from '@voltagent/internal';
-import { Tracer, SpanOptions, Span, SpanStatusCode as SpanStatusCode$1, context, trace, SpanKind as SpanKind$1, Context } from '@opentelemetry/api';
-export { ROOT_CONTEXT, Span, SpanOptions, Tracer, context, propagation, trace } from '@opentelemetry/api';
 import { LogRecordProcessor, LoggerProvider, ReadableLogRecord, SdkLogRecord } from '@opentelemetry/sdk-logs';
 import { NodeTracerProvider } from '@opentelemetry/sdk-trace-node';
 import { SpanProcessor, BasicTracerProvider, ReadableSpan, Span as Span$1 } from '@opentelemetry/sdk-trace-base';
@@ -114,6 +114,10 @@ declare abstract class BaseToolManager<TItems extends AgentTool | Tool$1 | Toolk
      * Get all kinds of tools, owned by this manager and inside toolkits as a flattened list.
      * */
     getAllTools(): (BaseTool | ProviderTool)[];
+    /**
+     * Get a tool by name across standalone tools and toolkits.
+     */
+    getToolByName(toolName: string): BaseTool | ProviderTool | undefined;
     /**
      * Get names of all tools (standalone and inside toolkits), deduplicated.
      */
@@ -217,6 +221,203 @@ type ToolStatusInfo = {
     parameters?: any;
 };
 
+/**
+ * THIS FILE IS AUTO-GENERATED - DO NOT EDIT
+ * Generated from https://models.dev/api.json
+ */
+type EmbeddingModelsMap = {
+    readonly azure: readonly [
+        "cohere-embed-v-4-0",
+        "cohere-embed-v3-english",
+        "cohere-embed-v3-multilingual",
+        "text-embedding-3-large",
+        "text-embedding-3-small",
+        "text-embedding-ada-002"
+    ];
+    readonly "azure-cognitive-services": readonly [
+        "cohere-embed-v-4-0",
+        "cohere-embed-v3-english",
+        "cohere-embed-v3-multilingual",
+        "text-embedding-3-large",
+        "text-embedding-3-small",
+        "text-embedding-ada-002"
+    ];
+    readonly "cloudflare-ai-gateway": readonly [
+        "workers-ai/@cf/pfnet/plamo-embedding-1b",
+        "workers-ai/@cf/qwen/qwen3-embedding-0.6b"
+    ];
+    readonly google: readonly ["gemini-embedding-001"];
+    readonly "google-vertex": readonly ["gemini-embedding-001"];
+    readonly huggingface: readonly ["Qwen/Qwen3-Embedding-4B", "Qwen/Qwen3-Embedding-8B"];
+    readonly inference: readonly ["qwen/qwen3-embedding-4b"];
+    readonly mistral: readonly ["mistral-embed"];
+    readonly nvidia: readonly ["nvidia/llama-embed-nemotron-8b"];
+    readonly openai: readonly [
+        "text-embedding-3-large",
+        "text-embedding-3-small",
+        "text-embedding-ada-002"
+    ];
+    readonly "privatemode-ai": readonly ["qwen3-embedding-4b"];
+    readonly vercel: readonly [
+        "alibaba/qwen3-embedding-0.6b",
+        "alibaba/qwen3-embedding-4b",
+        "alibaba/qwen3-embedding-8b",
+        "amazon/titan-embed-text-v2",
+        "cohere/embed-v4.0",
+        "google/gemini-embedding-001",
+        "google/text-embedding-005",
+        "google/text-multilingual-embedding-002",
+        "mistral/codestral-embed",
+        "mistral/mistral-embed",
+        "openai/text-embedding-3-large",
+        "openai/text-embedding-3-small",
+        "openai/text-embedding-ada-002"
+    ];
+};
+type EmbeddingProviderId = keyof EmbeddingModelsMap;
+type EmbeddingRouterModelId = {
+    [P in EmbeddingProviderId]: `${P}/${EmbeddingModelsMap[P][number]}`;
+}[EmbeddingProviderId] | (string & {});
+
+type EmbeddingModelInstance$1 = Exclude<EmbeddingModel, string>;
+type EmbeddingModelReference = EmbeddingRouterModelId | EmbeddingModelInstance$1;
+/**
+ * Embedding adapter interface for converting text to vectors
+ */
+interface EmbeddingAdapter$1 {
+    /**
+     * Embed a single text string into a vector
+     */
+    embed(text: string): Promise<number[]>;
+    /**
+     * Embed multiple texts in a batch for efficiency
+     */
+    embedBatch(texts: string[]): Promise<number[][]>;
+    /**
+     * Get the dimensionality of the embeddings
+     * Returns undefined if dimensions are not yet known
+     */
+    getDimensions(): number | undefined;
+    /**
+     * Get the model name for debugging/logging
+     */
+    getModelName(): string;
+}
+/**
+ * Options for embedding adapter initialization
+ */
+interface EmbeddingOptions {
+    /**
+     * Maximum number of texts to process in a single batch
+     */
+    maxBatchSize?: number;
+    /**
+     * Timeout for embedding operations in milliseconds
+     */
+    timeout?: number;
+    /**
+     * Whether to normalize embeddings to unit vectors
+     */
+    normalize?: boolean;
+}
+
+declare const TOOL_ROUTER_SYMBOL: unique symbol;
+
+type ToolRouterMode = "agent" | "resolver";
+type ToolRouterSelection = {
+    name: string;
+    score?: number;
+    reason?: string;
+};
+type ToolRouterInput = {
+    query: string;
+    topK?: number;
+};
+type ToolRouterResultItem = {
+    toolName: string;
+    toolCallId?: string;
+    output?: unknown;
+    error?: string;
+};
+type ToolRouterResult = {
+    query: string;
+    selections: ToolRouterSelection[];
+    results: ToolRouterResultItem[];
+};
+type ToolRouterCandidate = {
+    name: string;
+    description?: string;
+    tags?: string[];
+    parameters?: unknown;
+    tool: Tool<any, any> | ProviderTool;
+};
+type ToolRouterContext = {
+    agentId: string;
+    agentName: string;
+    operationContext: OperationContext;
+    routerName?: string;
+    parentSpan?: Span;
+};
+type ToolRouterStrategy = {
+    select: (params: {
+        query: string;
+        tools: ToolRouterCandidate[];
+        topK: number;
+        context: ToolRouterContext;
+    }) => Promise<ToolRouterSelection[]>;
+};
+type ToolArgumentResolver = (params: {
+    query: string;
+    tool: Tool<any, any>;
+    context: ToolRouterContext;
+}) => Promise<Record<string, unknown>>;
+type ToolRouterMetadata = {
+    strategy: ToolRouterStrategy;
+    mode?: ToolRouterMode;
+    executionModel?: AgentModelValue;
+    resolver?: ToolArgumentResolver;
+    topK?: number;
+    parallel?: boolean;
+};
+type ToolRouter = Tool<any, any> & {
+    [TOOL_ROUTER_SYMBOL]: ToolRouterMetadata;
+};
+type ToolRoutingEmbeddingConfig = {
+    model: EmbeddingAdapter$1 | EmbeddingModelReference;
+    normalize?: boolean;
+    maxBatchSize?: number;
+    topK?: number;
+    toolText?: (tool: ToolRouterCandidate) => string;
+};
+type ToolRoutingEmbeddingInput = ToolRoutingEmbeddingConfig | EmbeddingAdapter$1 | EmbeddingModelReference;
+type ToolRoutingConfig = {
+    routers?: ToolRouter[];
+    pool?: (Tool<any, any> | Toolkit | Tool$1)[];
+    expose?: (Tool<any, any> | Toolkit | Tool$1)[];
+    mode?: ToolRouterMode;
+    executionModel?: AgentModelValue;
+    embedding?: ToolRoutingEmbeddingInput;
+    topK?: number;
+    parallel?: boolean;
+};
+
+declare const createEmbeddingToolRouterStrategy: (input: ToolRoutingEmbeddingInput) => ToolRouterStrategy;
+
+type CreateToolRouterOptions = {
+    name: string;
+    description: string;
+    strategy?: ToolRouterStrategy;
+    embedding?: ToolRoutingEmbeddingInput;
+    mode?: ToolRouterMode;
+    executionModel?: ToolRouterMetadata["executionModel"];
+    resolver?: ToolArgumentResolver;
+    topK?: number;
+    parallel?: boolean;
+    parameters?: ToolSchema;
+};
+declare const createToolRouter: (options: CreateToolRouterOptions) => ToolRouter;
+declare const isToolRouter: (tool: unknown) => tool is ToolRouter;
+
 /**
  * JSON value types (matches AI SDK's JSONValue)
  */
@@ -224,6 +425,29 @@ type JSONValue = string | number | boolean | null | {
     [key: string]: JSONValue;
 } | Array<JSONValue>;
 type ToolExecutionResult<T> = PromiseLike<T> | AsyncIterable<T> | T;
+interface ToolHookOnStartArgs {
+    tool: Tool<any, any>;
+    args: unknown;
+    options?: ToolExecuteOptions;
+}
+interface ToolHookOnEndArgs {
+    tool: Tool<any, any>;
+    args: unknown;
+    /** The successful output from the tool. Undefined on error. */
+    output: unknown | undefined;
+    /** The error if the tool execution failed. */
+    error: unknown | undefined;
+    options?: ToolExecuteOptions;
+}
+interface ToolHookOnEndResult {
+    output?: unknown;
+}
+type ToolHookOnStart = (args: ToolHookOnStartArgs) => Promise<void> | void;
+type ToolHookOnEnd = (args: ToolHookOnEndArgs) => Promise<ToolHookOnEndResult | undefined> | Promise<void> | ToolHookOnEndResult | undefined;
+type ToolHooks = {
+    onStart?: ToolHookOnStart;
+    onEnd?: ToolHookOnEnd;
+};
 /**
  * Tool result output format for multi-modal content.
  * Matches AI SDK's LanguageModelV2ToolResultOutput type.
@@ -342,6 +566,10 @@ type ToolOptions<T extends ToolSchema = ToolSchema, O extends ToolSchema | undef
      * @returns A result or an AsyncIterable of results (last value is final).
      */
     execute?: (args: z.infer<T>, options?: ToolExecuteOptions) => ToolExecutionResult<O extends ToolSchema ? z.infer<O> : unknown>;
+    /**
+     * Optional tool-specific hooks for lifecycle events.
+     */
+    hooks?: ToolHooks;
 };
 /**
  * Tool class for defining tools that agents can use
@@ -387,6 +615,10 @@ declare class Tool<T extends ToolSchema = ToolSchema, O extends ToolSchema | und
     readonly toModelOutput?: (args: {
         output: O extends ToolSchema ? z.infer<O> : unknown;
     }) => ToolResultOutput;
+    /**
+     * Optional tool-specific hooks for lifecycle events.
+     */
+    readonly hooks?: ToolHooks;
     /**
      * Internal discriminator to make runtime/type checks simpler across module boundaries.
      * Marking our Tool instances with a stable string avoids instanceof issues.
@@ -777,367 +1009,336 @@ type LLMProvider<TProvider> = {
 type StopWhen = Parameters<typeof generateText>[0]["stopWhen"];
 
 /**
- * Memory V2 Type Definitions
- * Clean separation between conversation memory and telemetry
+ * LoggerProxy implements the Logger interface but delegates all calls to the current global logger.
+ * This allows agents and workflows to be created before VoltAgent sets the global logger,
+ * while still using the correct logger once it's available.
+ *
+ * When the logger package is not available, it also emits logs via OpenTelemetry Logs API.
  */
+declare class LoggerProxy implements Logger {
+    private bindings;
+    private externalLogger?;
+    constructor(bindings?: Record<string, any>, externalLogger?: Logger);
+    /**
+     * Get the actual logger instance with bindings applied
+     */
+    private getActualLogger;
+    /**
+     * Check if a log level should be logged based on the configured level
+     */
+    private shouldLog;
+    /**
+     * Emit log via OpenTelemetry Logs API if available
+     */
+    private emitOtelLog;
+    trace: LogFn;
+    debug: LogFn;
+    info: LogFn;
+    warn: LogFn;
+    error: LogFn;
+    fatal: LogFn;
+    /**
+     * Create a child logger with additional bindings
+     */
+    child(childBindings: Record<string, any>): Logger;
+}
 
+declare enum ActionType {
+    START = "start",
+    COMPLETE = "complete",
+    ERROR = "error",
+    GENERATION_START = "generationStart",
+    GENERATION_COMPLETE = "generationComplete",
+    STREAM_START = "streamStart",
+    STREAM_COMPLETE = "streamComplete",
+    STREAM_STEP = "streamStep",
+    STREAMING = "streaming",
+    OBJECT_GENERATION_START = "objectGenerationStart",
+    OBJECT_GENERATION_COMPLETE = "objectGenerationComplete",
+    STREAM_OBJECT_START = "streamObjectStart",
+    STREAM_OBJECT_COMPLETE = "streamObjectComplete",
+    TOOL_CALL = "toolCall",
+    TOOL_ERROR = "toolError",
+    DELEGATE = "delegate",
+    EXECUTE = "execute",
+    VALIDATE = "validate",
+    STEP_START = "stepStart",
+    STEP_COMPLETE = "stepComplete",
+    SUSPEND = "suspend",
+    RESUME = "resume",
+    ACCESS = "access",
+    STORE = "store",
+    RETRIEVE = "retrieve"
+}
 /**
- * Extended UIMessage type with storage metadata
- */
-type StoredUIMessage = UIMessage & {
-    createdAt: Date;
-    userId: string;
-    conversationId: string;
-};
-/**
- * Conversation type
+ * Helper to format retriever log messages
  */
-type Conversation = {
-    id: string;
-    resourceId: string;
-    userId: string;
-    title: string;
-    metadata: Record<string, unknown>;
-    createdAt: string;
-    updatedAt: string;
-};
+declare function buildRetrieverLogMessage(retrieverName: string, action: ActionType | string, description: string): string;
+
 /**
- * Input type for creating a conversation
+ * Get the global logger instance from registry or create a default one
  */
-type CreateConversationInput = {
-    id: string;
-    resourceId: string;
-    userId: string;
-    title: string;
-    metadata: Record<string, unknown>;
-};
+declare function getGlobalLogger(): Logger;
 /**
- * Query builder options for conversations
+ * Get the global log buffer
  */
-type ConversationQueryOptions = {
-    userId?: string;
-    resourceId?: string;
-    limit?: number;
-    offset?: number;
-    orderBy?: "created_at" | "updated_at" | "title";
-    orderDirection?: "ASC" | "DESC";
-};
+declare function getGlobalLogBuffer(): LogBuffer;
+
 /**
- * Options for getting messages
+ * Options for configuring the Retriever
  */
-type GetMessagesOptions = {
-    limit?: number;
-    before?: Date;
-    after?: Date;
-    roles?: string[];
-};
-type ConversationStepType = "text" | "tool_call" | "tool_result";
-interface ConversationStepRecord {
-    id: string;
-    conversationId: string;
-    userId: string;
-    agentId: string;
-    agentName?: string;
-    operationId: string;
-    stepIndex: number;
-    type: ConversationStepType;
-    role: MessageRole;
-    content?: string;
-    arguments?: Record<string, unknown> | null;
-    result?: Record<string, unknown> | null;
-    usage?: UsageInfo;
-    subAgentId?: string;
-    subAgentName?: string;
-    createdAt: string;
-}
-interface GetConversationStepsOptions {
-    limit?: number;
-    operationId?: string;
-}
-/**
- * Memory options for MemoryManager
- */
-type MemoryOptions = {};
+type RetrieverOptions = {
+    /**
+     * Name for the default tool created from this retriever
+     * This is used for the pre-created 'tool' property
+     * @default "search_knowledge"
+     */
+    toolName?: string;
+    /**
+     * Description for the default tool created from this retriever
+     * This is used for the pre-created 'tool' property
+     * @default "Searches for relevant information in the knowledge base based on the query."
+     */
+    toolDescription?: string;
+    /**
+     * Optional logger instance for the retriever
+     * If not provided, a default logger will be created
+     */
+    logger?: Logger;
+    /**
+     * Additional configuration specific to concrete retriever implementations
+     */
+    [key: string]: any;
+};
 /**
- * Workflow state entry for suspension and resumption
- * Stores only the essential state needed to resume a workflow
+ * Options passed to retrieve method.
+ * Includes all operation context fields for user-specific and context-aware retrieval.
  */
-interface WorkflowStateEntry {
-    /** Unique execution ID */
-    id: string;
-    /** Workflow definition ID */
-    workflowId: string;
-    /** Workflow name for reference */
-    workflowName: string;
-    /** Current status */
-    status: "running" | "suspended" | "completed" | "cancelled" | "error";
-    /** Original input to the workflow */
-    input?: unknown;
-    /** Execution context */
-    context?: Array<[string | symbol, unknown]>;
-    /** Suspension metadata including checkpoint data */
-    suspension?: {
-        suspendedAt: Date;
-        reason?: string;
-        stepIndex: number;
-        lastEventSequence?: number;
-        checkpoint?: {
-            stepExecutionState?: any;
-            completedStepsData?: any[];
-        };
-        suspendData?: any;
-    };
+interface RetrieveOptions extends Partial<OperationContext> {
     /**
-     * Stream events collected during execution
-     * Used for timeline visualization in UI
+     * User-managed context map for this specific retrieval operation
+     * Can be used to store metadata, results, or any custom data
+     *
+     * Inherited from OperationContext but explicitly documented here for clarity
+     */
+    context?: Map<string | symbol, unknown>;
+    /**
+     * Optional logger instance for this retrieval operation.
+     * Provides execution-scoped logging with full context.
+     * Available when retriever is called from an agent or workflow context.
+     *
+     * Inherited from OperationContext but explicitly documented here for clarity
+     */
+    logger?: Logger;
+    /**
+     * Optional user identifier for user-specific retrieval.
+     * Can be used to filter results by user or implement multi-tenant retrieval.
+     *
+     * Inherited from OperationContext
      */
-    events?: Array<{
-        id: string;
-        type: string;
-        name?: string;
-        from?: string;
-        startTime: string;
-        endTime?: string;
-        status?: string;
-        input?: any;
-        output?: any;
-        metadata?: Record<string, unknown>;
-        context?: Record<string, unknown>;
-    }>;
-    /** Final output of the workflow execution */
-    output?: unknown;
-    /** Cancellation metadata */
-    cancellation?: {
-        cancelledAt: Date;
-        reason?: string;
-    };
-    /** User ID if applicable */
     userId?: string;
-    /** Conversation ID if applicable */
+    /**
+     * Optional conversation identifier for conversation-aware retrieval.
+     * Can be used to retrieve conversation-specific context or history.
+     *
+     * Inherited from OperationContext
+     */
     conversationId?: string;
-    /** Additional metadata */
-    metadata?: Record<string, unknown>;
-    /** Timestamps */
-    createdAt: Date;
-    updatedAt: Date;
-}
-interface WorkflowRunQuery {
-    workflowId?: string;
-    status?: WorkflowStateEntry["status"];
-    from?: Date;
-    to?: Date;
-    limit?: number;
-    offset?: number;
 }
 /**
- * Working memory scope - conversation or user level
- */
-type WorkingMemoryScope = "conversation" | "user";
-/**
- * Simple memory update modes
- */
-type MemoryUpdateMode = "replace" | "append";
-/**
- * Options for updating working memory (simplified)
+ * Retriever interface for retrieving relevant information
  */
-type WorkingMemoryUpdateOptions = {
-    /** How to update the memory (default: "replace") */
-    mode?: MemoryUpdateMode;
+type Retriever = {
+    /**
+     * Retrieve relevant documents based on input text
+     * @param text The text to use for retrieval
+     * @param options Configuration and context for the retrieval
+     * @returns Promise resolving to a string with the retrieved content
+     */
+    retrieve(text: string, options: RetrieveOptions): Promise<string>;
+    /**
+     * Configuration options for the retriever
+     * This is optional and may not be present in all implementations
+     */
+    options?: RetrieverOptions;
+    /**
+     * Pre-created tool for easy destructuring
+     * This is optional and may not be present in all implementations
+     */
+    tool?: any;
+    /**
+     * Optional observability attributes for retriever spans.
+     */
+    getObservabilityAttributes?: () => Record<string, unknown>;
 };
+
 /**
- * Working memory configuration
- * Auto-detects format: schema → JSON, template → markdown
- */
-type WorkingMemoryConfig = {
-    enabled: boolean;
-    scope?: WorkingMemoryScope;
-} & ({
-    template: string;
-    schema?: never;
-} | {
-    schema: z.ZodObject<any>;
-    template?: never;
-} | {
-    template?: never;
-    schema?: never;
-});
-/**
- * Memory V2 configuration options
+ * Abstract base class for Retriever implementations.
+ * This class provides a common structure for different types of retrievers.
  */
-interface MemoryConfig {
-    /**
-     * Storage adapter for conversations and messages
-     */
-    storage: StorageAdapter;
+declare abstract class BaseRetriever {
     /**
-     * Optional embedding adapter for semantic operations
+     * Options that configure the retriever's behavior
      */
-    embedding?: EmbeddingAdapter$1;
+    protected options: RetrieverOptions;
     /**
-     * Optional vector adapter for similarity search
+     * Logger instance for the retriever
      */
-    vector?: VectorAdapter$1;
+    protected logger: Logger;
     /**
-     * Enable caching for embeddings
-     * @default false
+     * Ready-to-use tool property for direct destructuring
+     * This can be used with object destructuring syntax
+     *
+     * @example
+     * ```typescript
+     * // ✅ You can use destructuring with the tool property
+     * const { tool } = new SimpleRetriever();
+     *
+     * // And use it directly in an agent
+     * const agent = new Agent({
+     *   name: "RAG Agent",
+     *   model: "gpt-4",
+     *   provider,
+     *   tools: [tool],
+     * });
+     * ```
      */
-    enableCache?: boolean;
+    readonly tool: AgentTool;
     /**
-     * Maximum number of embeddings to cache
-     * @default 1000
+     * Constructor for the BaseRetriever class.
+     * @param options - Configuration options for the retriever.
      */
-    cacheSize?: number;
+    constructor(options?: RetrieverOptions);
     /**
-     * Cache TTL in milliseconds
-     * @default 3600000 (1 hour)
+     * Abstract method that must be implemented by concrete retriever classes.
+     * Retrieves relevant information based on the input text or messages.
+     *
+     * @param input - The input to use for retrieval (string or BaseMessage array)
+     * @param options - Configuration and context for the retrieval
+     * @returns Promise resolving to a string with the retrieved content
      */
-    cacheTTL?: number;
+    abstract retrieve(input: string | BaseMessage[], options: RetrieveOptions): Promise<string>;
     /**
-     * Working memory configuration
-     * Enables agents to maintain important context
+     * Optional observability attributes for retriever spans.
+     * Override in subclasses to add context (e.g. knowledge base metadata).
      */
-    workingMemory?: WorkingMemoryConfig;
+    getObservabilityAttributes(): Record<string, unknown>;
 }
+
 /**
- * Metadata about the underlying storage adapter
+ * ReadableStream type for voice responses
  */
-interface MemoryStorageMetadata {
-    /** Name of the configured storage adapter */
-    adapter: string;
-}
-/**
- * Summary of working memory configuration exposed to the UI
- */
-interface WorkingMemorySummary {
-    /** Whether working memory support is enabled */
-    enabled: boolean;
-    /** Scope of working memory persistence */
-    scope?: WorkingMemoryScope;
-    /** Output format (markdown/json) */
-    format: "markdown" | "json" | null;
-    /** Indicates if a template is configured */
-    hasTemplate: boolean;
-    /** Indicates if a schema is configured */
-    hasSchema: boolean;
-    /** Template content if configured */
-    template?: string | null;
-    /** Simplified schema field map if configured */
-    schema?: Record<string, string> | null;
-}
+type ReadableStreamType = ReadableStream | NodeJS.ReadableStream | any;
 /**
- * Document type for RAG operations
+ * Voice provider options
  */
-interface Document {
-    id: string;
-    content: string;
-    metadata?: Record<string, unknown>;
-}
+type VoiceOptions = {
+    /**
+     * API key for the voice provider
+     */
+    apiKey?: string;
+    /**
+     * Model to use for speech recognition
+     */
+    speechModel?: string;
+    /**
+     * Model to use for text-to-speech
+     */
+    ttsModel?: string;
+    /**
+     * Voice ID to use for text-to-speech
+     */
+    voice?: string;
+    /**
+     * Additional provider-specific options
+     */
+    options?: Record<string, unknown>;
+};
 /**
- * Search options for semantic search
+ * Voice event types
  */
-interface SearchOptions {
-    limit?: number;
-    threshold?: number;
-    filter?: Record<string, unknown>;
-}
+type VoiceEventType = "speaking" | "listening" | "error" | "connected" | "disconnected";
 /**
- * Search result from vector operations
+ * Voice event data types
  */
-interface SearchResult$1 {
-    id: string;
-    score: number;
-    content?: string;
-    metadata?: Record<string, unknown>;
-}
+type VoiceEventData = {
+    speaking: {
+        text: string;
+        audio?: NodeJS.ReadableStream;
+    };
+    listening: {
+        audio: NodeJS.ReadableStream;
+    };
+    error: {
+        message: string;
+        code?: string;
+        details?: unknown;
+    };
+    connected: undefined;
+    disconnected: undefined;
+};
 /**
- * Vector item for batch operations
+ * Voice metadata
  */
-interface VectorItem$1 {
+type VoiceMetadata = {
     id: string;
-    vector: number[];
+    name: string;
+    language: string;
+    gender?: "male" | "female" | "neutral";
     metadata?: Record<string, unknown>;
-}
+};
 /**
- * Storage Adapter Interface
- * Handles persistence of conversations and messages
+ * Base interface for voice providers
  */
-interface StorageAdapter {
-    addMessage(message: UIMessage, userId: string, conversationId: string, context?: OperationContext): Promise<void>;
-    addMessages(messages: UIMessage[], userId: string, conversationId: string, context?: OperationContext): Promise<void>;
-    getMessages(userId: string, conversationId: string, options?: GetMessagesOptions, context?: OperationContext): Promise<UIMessage<{
-        createdAt: Date;
-    }>[]>;
-    clearMessages(userId: string, conversationId?: string, context?: OperationContext): Promise<void>;
+type Voice = {
     /**
-     * Delete specific messages by ID for a conversation.
-     * Adapters should perform an atomic delete when possible. If atomic deletes or transactions
-     * are unavailable, a best-effort deletion (for example, clear + rehydrate) may be used.
+     * Convert text to speech
      */
-    deleteMessages(messageIds: string[], userId: string, conversationId: string, context?: OperationContext): Promise<void>;
-    createConversation(input: CreateConversationInput): Promise<Conversation>;
-    getConversation(id: string): Promise<Conversation | null>;
-    getConversations(resourceId: string): Promise<Conversation[]>;
-    getConversationsByUserId(userId: string, options?: Omit<ConversationQueryOptions, "userId">): Promise<Conversation[]>;
-    queryConversations(options: ConversationQueryOptions): Promise<Conversation[]>;
+    speak(text: string | NodeJS.ReadableStream, options?: {
+        voice?: string;
+        speed?: number;
+        pitch?: number;
+    }): Promise<NodeJS.ReadableStream>;
     /**
-     * Count conversations matching query filters (limit/offset ignored).
+     * Convert speech to text
      */
-    countConversations(options: ConversationQueryOptions): Promise<number>;
-    updateConversation(id: string, updates: Partial<Omit<Conversation, "id" | "createdAt" | "updatedAt">>): Promise<Conversation>;
-    deleteConversation(id: string): Promise<void>;
-    saveConversationSteps?(steps: ConversationStepRecord[]): Promise<void>;
-    getConversationSteps?(userId: string, conversationId: string, options?: GetConversationStepsOptions): Promise<ConversationStepRecord[]>;
-    getWorkingMemory(params: {
-        conversationId?: string;
-        userId?: string;
-        scope: WorkingMemoryScope;
-    }): Promise<string | null>;
-    setWorkingMemory(params: {
-        conversationId?: string;
-        userId?: string;
-        content: string;
-        scope: WorkingMemoryScope;
-    }): Promise<void>;
-    deleteWorkingMemory(params: {
-        conversationId?: string;
-        userId?: string;
-        scope: WorkingMemoryScope;
-    }): Promise<void>;
-    getWorkflowState(executionId: string): Promise<WorkflowStateEntry | null>;
-    queryWorkflowRuns(query: WorkflowRunQuery): Promise<WorkflowStateEntry[]>;
-    setWorkflowState(executionId: string, state: WorkflowStateEntry): Promise<void>;
-    updateWorkflowState(executionId: string, updates: Partial<WorkflowStateEntry>): Promise<void>;
-    getSuspendedWorkflowStates(workflowId: string): Promise<WorkflowStateEntry[]>;
-}
-/**
- * Embedding Adapter Interface
- * Handles text to vector conversions
- */
-interface EmbeddingAdapter$1 {
+    listen(audio: NodeJS.ReadableStream, options?: {
+        language?: string;
+        model?: string;
+        stream?: boolean;
+    }): Promise<string | ReadableStreamType>;
     /**
-     * Embed a single text
+     * Connect to real-time voice service
      */
-    embed(text: string): Promise<number[]>;
+    connect(options?: Record<string, unknown>): Promise<void>;
     /**
-     * Embed multiple texts in batch
+     * Disconnect from real-time voice service
      */
-    embedBatch(texts: string[]): Promise<number[][]>;
+    disconnect(): void;
     /**
-     * Get embedding dimensions
+     * Send audio data to real-time service
      */
-    getDimensions(): number;
+    send(audioData: NodeJS.ReadableStream | Int16Array): Promise<void>;
     /**
-     * Get model name
+     * Register event listener
      */
-    getModelName(): string;
-}
+    on<E extends VoiceEventType>(event: E, callback: (data: VoiceEventData[E]) => void): void;
+    /**
+     * Remove event listener
+     */
+    off<E extends VoiceEventType>(event: E, callback: (data: VoiceEventData[E]) => void): void;
+    /**
+     * Get available voices
+     */
+    getVoices(): Promise<VoiceMetadata[]>;
+};
+
 /**
- * Vector Adapter Interface
- * Handles vector storage and similarity search
+ * Vector adapter interface for vector storage and similarity search
  */
 interface VectorAdapter$1 {
     /**
-     * Store a single vector
+     * Store a vector with associated metadata
      */
     store(id: string, vector: number[], metadata?: Record<string, unknown>): Promise<void>;
     /**
@@ -1145,13 +1346,9 @@ interface VectorAdapter$1 {
      */
     storeBatch(items: VectorItem$1[]): Promise<void>;
     /**
-     * Search for similar vectors
+     * Search for similar vectors using cosine similarity
      */
-    search(vector: number[], options?: {
-        limit?: number;
-        filter?: Record<string, unknown>;
-        threshold?: number;
-    }): Promise<SearchResult$1[]>;
+    search(vector: number[], options?: VectorSearchOptions): Promise<SearchResult$1[]>;
     /**
      * Delete a vector by ID
      */
@@ -1164,856 +1361,596 @@ interface VectorAdapter$1 {
      * Clear all vectors
      */
     clear(): Promise<void>;
+    /**
+     * Get total count of stored vectors
+     */
+    count(): Promise<number>;
+    /**
+     * Get a specific vector by ID
+     */
+    get(id: string): Promise<VectorItem$1 | null>;
 }
-
 /**
- * Custom error classes for Memory V2
+ * Item to store in vector database
  */
+interface VectorItem$1 {
+    /**
+     * Unique identifier for the vector
+     */
+    id: string;
+    /**
+     * The embedding vector
+     */
+    vector: number[];
+    /**
+     * Optional metadata associated with the vector
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * Optional text content that was embedded
+     */
+    content?: string;
+}
 /**
- * Base error class for Memory V2
+ * Options for vector search
  */
-declare class MemoryV2Error extends Error {
-    readonly code: string;
-    readonly details?: Record<string, unknown> | undefined;
-    constructor(message: string, code: string, details?: Record<string, unknown> | undefined);
+interface VectorSearchOptions {
+    /**
+     * Maximum number of results to return
+     */
+    limit?: number;
+    /**
+     * Minimum similarity threshold (0-1)
+     */
+    threshold?: number;
+    /**
+     * Filter results by metadata
+     */
+    filter?: Record<string, unknown>;
 }
 /**
- * Error thrown when a storage operation fails
+ * Search result with similarity score
  */
-declare class StorageError extends MemoryV2Error {
-    constructor(message: string, details?: Record<string, unknown>);
+interface SearchResult$1 extends VectorItem$1 {
+    /**
+     * Similarity score (0-1, higher is more similar)
+     */
+    score: number;
+    /**
+     * Distance from query vector (lower is closer)
+     */
+    distance?: number;
 }
+
 /**
- * Error thrown when an embedding operation fails
+ * Memory V2 Type Definitions
+ * Clean separation between conversation memory and telemetry
  */
-declare class EmbeddingError extends MemoryV2Error {
-    constructor(message: string, details?: Record<string, unknown>);
-}
+
 /**
- * Error thrown when a vector operation fails
+ * Extended UIMessage type with storage metadata
  */
-declare class VectorError extends MemoryV2Error {
-    constructor(message: string, details?: Record<string, unknown>);
-}
+type StoredUIMessage = UIMessage & {
+    createdAt: Date;
+    userId: string;
+    conversationId: string;
+};
 /**
- * Error thrown when a conversation is not found
+ * Conversation type
  */
-declare class ConversationNotFoundError extends MemoryV2Error {
-    constructor(conversationId: string);
-}
+type Conversation = {
+    id: string;
+    resourceId: string;
+    userId: string;
+    title: string;
+    metadata: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+};
 /**
- * Error thrown when trying to create a conversation that already exists
+ * Input type for creating a conversation
  */
-declare class ConversationAlreadyExistsError extends MemoryV2Error {
-    constructor(conversationId: string);
-}
+type CreateConversationInput = {
+    id: string;
+    resourceId: string;
+    userId: string;
+    title: string;
+    metadata: Record<string, unknown>;
+};
 /**
- * Error thrown when vector adapter is required but not configured
+ * Query builder options for conversations
  */
-declare class VectorAdapterNotConfiguredError extends MemoryV2Error {
-    constructor(operation: string);
+type ConversationQueryOptions = {
+    userId?: string;
+    resourceId?: string;
+    limit?: number;
+    offset?: number;
+    orderBy?: "created_at" | "updated_at" | "title";
+    orderDirection?: "ASC" | "DESC";
+};
+/**
+ * Options for getting messages
+ */
+type GetMessagesOptions = {
+    limit?: number;
+    before?: Date;
+    after?: Date;
+    roles?: string[];
+};
+type ConversationStepType = "text" | "tool_call" | "tool_result";
+interface ConversationStepRecord {
+    id: string;
+    conversationId: string;
+    userId: string;
+    agentId: string;
+    agentName?: string;
+    operationId: string;
+    stepIndex: number;
+    type: ConversationStepType;
+    role: MessageRole;
+    content?: string;
+    arguments?: Record<string, unknown> | null;
+    result?: Record<string, unknown> | null;
+    usage?: UsageInfo;
+    subAgentId?: string;
+    subAgentName?: string;
+    createdAt: string;
+}
+interface GetConversationStepsOptions {
+    limit?: number;
+    operationId?: string;
 }
 /**
- * Error thrown when embedding adapter is required but not configured
+ * Memory options for MemoryManager
  */
-declare class EmbeddingAdapterNotConfiguredError extends MemoryV2Error {
-    constructor(operation: string);
+type MemoryOptions = {};
+type ConversationTitleConfig = {
+    enabled?: boolean;
+    model?: AgentModelValue;
+    maxOutputTokens?: number;
+    maxLength?: number;
+    systemPrompt?: string | null;
+};
+type ConversationTitleGenerator = (params: {
+    input: OperationContext["input"] | UIMessage;
+    context: OperationContext;
+    defaultTitle: string;
+}) => Promise<string | null>;
+/**
+ * Workflow state entry for suspension and resumption
+ * Stores only the essential state needed to resume a workflow
+ */
+interface WorkflowStateEntry {
+    /** Unique execution ID */
+    id: string;
+    /** Workflow definition ID */
+    workflowId: string;
+    /** Workflow name for reference */
+    workflowName: string;
+    /** Current status */
+    status: "running" | "suspended" | "completed" | "cancelled" | "error";
+    /** Original input to the workflow */
+    input?: unknown;
+    /** Execution context */
+    context?: Array<[string | symbol, unknown]>;
+    /** Shared workflow state at the time of persistence */
+    workflowState?: Record<string, unknown>;
+    /** Suspension metadata including checkpoint data */
+    suspension?: {
+        suspendedAt: Date;
+        reason?: string;
+        stepIndex: number;
+        lastEventSequence?: number;
+        checkpoint?: {
+            stepExecutionState?: any;
+            completedStepsData?: any[];
+            workflowState?: Record<string, unknown>;
+        };
+        suspendData?: any;
+    };
+    /**
+     * Stream events collected during execution
+     * Used for timeline visualization in UI
+     */
+    events?: Array<{
+        id: string;
+        type: string;
+        name?: string;
+        from?: string;
+        startTime: string;
+        endTime?: string;
+        status?: string;
+        input?: any;
+        output?: any;
+        metadata?: Record<string, unknown>;
+        context?: Record<string, unknown>;
+    }>;
+    /** Final output of the workflow execution */
+    output?: unknown;
+    /** Cancellation metadata */
+    cancellation?: {
+        cancelledAt: Date;
+        reason?: string;
+    };
+    /** User ID if applicable */
+    userId?: string;
+    /** Conversation ID if applicable */
+    conversationId?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+    /** Timestamps */
+    createdAt: Date;
+    updatedAt: Date;
+}
+interface WorkflowRunQuery {
+    workflowId?: string;
+    status?: WorkflowStateEntry["status"];
+    from?: Date;
+    to?: Date;
+    limit?: number;
+    offset?: number;
 }
-
 /**
- * Vector adapter interface for vector storage and similarity search
+ * Working memory scope - conversation or user level
  */
-interface VectorAdapter {
+type WorkingMemoryScope = "conversation" | "user";
+/**
+ * Simple memory update modes
+ */
+type MemoryUpdateMode = "replace" | "append";
+/**
+ * Options for updating working memory (simplified)
+ */
+type WorkingMemoryUpdateOptions = {
+    /** How to update the memory (default: "replace") */
+    mode?: MemoryUpdateMode;
+};
+/**
+ * Working memory configuration
+ * Auto-detects format: schema → JSON, template → markdown
+ */
+type WorkingMemoryConfig = {
+    enabled: boolean;
+    scope?: WorkingMemoryScope;
+} & ({
+    template: string;
+    schema?: never;
+} | {
+    schema: z.ZodObject<any>;
+    template?: never;
+} | {
+    template?: never;
+    schema?: never;
+});
+/**
+ * Memory V2 configuration options
+ */
+interface MemoryConfig {
     /**
-     * Store a vector with associated metadata
+     * Storage adapter for conversations and messages
      */
-    store(id: string, vector: number[], metadata?: Record<string, unknown>): Promise<void>;
+    storage: StorageAdapter;
     /**
-     * Store multiple vectors in batch
+     * Optional embedding adapter or model reference for semantic operations
      */
-    storeBatch(items: VectorItem[]): Promise<void>;
+    embedding?: EmbeddingAdapterInput;
     /**
-     * Search for similar vectors using cosine similarity
+     * Optional vector adapter for similarity search
      */
-    search(vector: number[], options?: VectorSearchOptions): Promise<SearchResult[]>;
+    vector?: VectorAdapter;
     /**
-     * Delete a vector by ID
+     * Enable caching for embeddings
+     * @default false
      */
-    delete(id: string): Promise<void>;
+    enableCache?: boolean;
     /**
-     * Delete multiple vectors by IDs
+     * Maximum number of embeddings to cache
+     * @default 1000
      */
-    deleteBatch(ids: string[]): Promise<void>;
+    cacheSize?: number;
     /**
-     * Clear all vectors
+     * Cache TTL in milliseconds
+     * @default 3600000 (1 hour)
      */
-    clear(): Promise<void>;
+    cacheTTL?: number;
     /**
-     * Get total count of stored vectors
+     * Working memory configuration
+     * Enables agents to maintain important context
      */
-    count(): Promise<number>;
+    workingMemory?: WorkingMemoryConfig;
     /**
-     * Get a specific vector by ID
+     * Automatically generate a title for new conversations using the agent's model
+     * (or the override model if provided).
+     * @default false
      */
-    get(id: string): Promise<VectorItem | null>;
+    generateTitle?: boolean | ConversationTitleConfig;
 }
 /**
- * Item to store in vector database
+ * Embedding adapter config for Memory
  */
-interface VectorItem {
-    /**
-     * Unique identifier for the vector
-     */
-    id: string;
-    /**
-     * The embedding vector
-     */
-    vector: number[];
-    /**
-     * Optional metadata associated with the vector
-     */
-    metadata?: Record<string, unknown>;
-    /**
-     * Optional text content that was embedded
-     */
-    content?: string;
-}
+type EmbeddingAdapterConfig = EmbeddingOptions & {
+    model: EmbeddingModelReference;
+};
 /**
- * Options for vector search
+ * Embedding input options for Memory
  */
-interface VectorSearchOptions {
-    /**
-     * Maximum number of results to return
-     */
-    limit?: number;
-    /**
-     * Minimum similarity threshold (0-1)
-     */
-    threshold?: number;
-    /**
-     * Filter results by metadata
-     */
-    filter?: Record<string, unknown>;
+type EmbeddingAdapterInput = EmbeddingAdapter | EmbeddingModelReference | EmbeddingAdapterConfig;
+/**
+ * Metadata about the underlying storage adapter
+ */
+interface MemoryStorageMetadata {
+    /** Name of the configured storage adapter */
+    adapter: string;
 }
 /**
- * Search result with similarity score
+ * Summary of working memory configuration exposed to the UI
  */
-interface SearchResult extends VectorItem {
-    /**
-     * Similarity score (0-1, higher is more similar)
-     */
-    score: number;
-    /**
-     * Distance from query vector (lower is closer)
-     */
-    distance?: number;
+interface WorkingMemorySummary {
+    /** Whether working memory support is enabled */
+    enabled: boolean;
+    /** Scope of working memory persistence */
+    scope?: WorkingMemoryScope;
+    /** Output format (markdown/json) */
+    format: "markdown" | "json" | null;
+    /** Indicates if a template is configured */
+    hasTemplate: boolean;
+    /** Indicates if a schema is configured */
+    hasSchema: boolean;
+    /** Template content if configured */
+    template?: string | null;
+    /** Simplified schema field map if configured */
+    schema?: Record<string, string> | null;
 }
-
 /**
- * Vector math utilities for similarity calculations
+ * Document type for RAG operations
  */
+interface Document {
+    id: string;
+    content: string;
+    metadata?: Record<string, unknown>;
+}
 /**
- * Calculate cosine similarity between two vectors
- * Returns a value between -1 and 1, where 1 means identical direction,
- * 0 means perpendicular, and -1 means opposite direction
+ * Search options for semantic search
  */
-declare function cosineSimilarity(a: number[], b: number[]): number;
-
+interface SearchOptions {
+    limit?: number;
+    threshold?: number;
+    filter?: Record<string, unknown>;
+}
 /**
- * Memory - Clean architecture for conversation memory and state management
+ * Search result from vector operations
  */
-
+interface SearchResult {
+    id: string;
+    score: number;
+    content?: string;
+    metadata?: Record<string, unknown>;
+}
 /**
- * Memory Class
- * Handles conversation memory with optional vector search capabilities
+ * Vector item for batch operations
  */
-declare class Memory {
-    private readonly storage;
-    private readonly embedding?;
-    private readonly vector?;
-    private embeddingCache?;
-    private readonly workingMemoryConfig?;
-    private resourceId?;
-    private logger?;
-    constructor(options: MemoryConfig);
-    /**
-     * Get messages from a conversation
-     */
+interface VectorItem {
+    id: string;
+    vector: number[];
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Storage Adapter Interface
+ * Handles persistence of conversations and messages
+ */
+interface StorageAdapter {
+    addMessage(message: UIMessage, userId: string, conversationId: string, context?: OperationContext): Promise<void>;
+    addMessages(messages: UIMessage[], userId: string, conversationId: string, context?: OperationContext): Promise<void>;
     getMessages(userId: string, conversationId: string, options?: GetMessagesOptions, context?: OperationContext): Promise<UIMessage<{
         createdAt: Date;
     }>[]>;
-    /**
-     * Save a single message
-     */
-    saveMessage(message: UIMessage, userId: string, conversationId: string): Promise<void>;
-    saveConversationSteps(steps: ConversationStepRecord[]): Promise<void>;
-    /**
-     * Add a single message (alias for consistency with existing API)
-     */
-    addMessage(message: UIMessage, userId: string, conversationId: string, context?: OperationContext): Promise<void>;
-    /**
-     * Add multiple messages in batch
-     */
-    addMessages(messages: UIMessage[], userId: string, conversationId: string, context?: OperationContext): Promise<void>;
-    /**
-     * Clear messages for a user
-     */
     clearMessages(userId: string, conversationId?: string, context?: OperationContext): Promise<void>;
     /**
-     * Delete specific messages by ID for a conversation
-     * Adapters should delete atomically when possible; otherwise a best-effort delete may be used.
+     * Delete specific messages by ID for a conversation.
+     * Adapters should perform an atomic delete when possible. If atomic deletes or transactions
+     * are unavailable, a best-effort deletion (for example, clear + rehydrate) may be used.
      */
     deleteMessages(messageIds: string[], userId: string, conversationId: string, context?: OperationContext): Promise<void>;
-    getConversationSteps(userId: string, conversationId: string, options?: GetConversationStepsOptions): Promise<ConversationStepRecord[]>;
-    /**
-     * Get a conversation by ID
-     */
+    createConversation(input: CreateConversationInput): Promise<Conversation>;
     getConversation(id: string): Promise<Conversation | null>;
-    /**
-     * Get conversations for a resource
-     */
     getConversations(resourceId: string): Promise<Conversation[]>;
-    /**
-     * Get conversations by user ID with query options
-     */
     getConversationsByUserId(userId: string, options?: Omit<ConversationQueryOptions, "userId">): Promise<Conversation[]>;
-    /**
-     * Query conversations with advanced options
-     */
     queryConversations(options: ConversationQueryOptions): Promise<Conversation[]>;
     /**
-     * Count conversations with the same filtering as queryConversations (ignores limit/offset)
+     * Count conversations matching query filters (limit/offset ignored).
      */
     countConversations(options: ConversationQueryOptions): Promise<number>;
-    /**
-     * Create a new conversation
-     */
-    createConversation(input: CreateConversationInput): Promise<Conversation>;
-    /**
-     * Update a conversation
-     */
     updateConversation(id: string, updates: Partial<Omit<Conversation, "id" | "createdAt" | "updatedAt">>): Promise<Conversation>;
-    /**
-     * Delete a conversation
-     */
     deleteConversation(id: string): Promise<void>;
-    /**
-     * Get messages with semantic search
-     * Combines recent messages with semantically similar messages
-     */
-    getMessagesWithSemanticSearch(userId: string, conversationId: string, currentQuery?: string, options?: {
-        limit?: number;
-        semanticLimit?: number;
-        semanticThreshold?: number;
-        mergeStrategy?: "prepend" | "append" | "interleave";
-    }): Promise<UIMessage<{
-        createdAt: Date;
-    }>[]>;
-    /**
-     * Get messages by their IDs
-     */
-    private getMessagesByIds;
-    /**
-     * Merge two arrays of messages, removing duplicates
-     */
-    private mergeMessages;
-    /**
-     * Check if vector support is configured
-     */
-    hasVectorSupport(): boolean;
-    /**
-     * Search for similar content
-     */
-    searchSimilar(query: string, options?: SearchOptions): Promise<SearchResult$1[]>;
-    /**
-     * Add a document for RAG
-     */
-    addDocument(document: Document): Promise<void>;
-    /**
-     * Remove a document
-     */
-    removeDocument(id: string): Promise<void>;
-    /**
-     * Get embedding with caching
-     */
-    private getEmbedding;
-    /**
-     * Embed and store a message
-     */
-    private embedAndStoreMessage;
-    /**
-     * Embed and store multiple messages
-     */
-    private embedAndStoreMessages;
-    /**
-     * Get working memory for a conversation or user
-     */
+    saveConversationSteps?(steps: ConversationStepRecord[]): Promise<void>;
+    getConversationSteps?(userId: string, conversationId: string, options?: GetConversationStepsOptions): Promise<ConversationStepRecord[]>;
     getWorkingMemory(params: {
         conversationId?: string;
         userId?: string;
+        scope: WorkingMemoryScope;
     }): Promise<string | null>;
-    /**
-     * Update working memory (simplified)
-     */
-    updateWorkingMemory(params: {
+    setWorkingMemory(params: {
         conversationId?: string;
         userId?: string;
-        content: string | Record<string, unknown>;
-        options?: WorkingMemoryUpdateOptions;
+        content: string;
+        scope: WorkingMemoryScope;
+    }): Promise<void>;
+    deleteWorkingMemory(params: {
+        conversationId?: string;
+        userId?: string;
+        scope: WorkingMemoryScope;
     }): Promise<void>;
+    getWorkflowState(executionId: string): Promise<WorkflowStateEntry | null>;
+    queryWorkflowRuns(query: WorkflowRunQuery): Promise<WorkflowStateEntry[]>;
+    setWorkflowState(executionId: string, state: WorkflowStateEntry): Promise<void>;
+    updateWorkflowState(executionId: string, updates: Partial<WorkflowStateEntry>): Promise<void>;
+    getSuspendedWorkflowStates(workflowId: string): Promise<WorkflowStateEntry[]>;
+}
+/**
+ * Embedding Adapter Interface
+ * Handles text to vector conversions
+ */
+interface EmbeddingAdapter {
     /**
-     * Process content to string format
+     * Embed a single text
      */
-    private processContent;
+    embed(text: string): Promise<number[]>;
     /**
-     * Simple deep merge for JSON objects
+     * Embed multiple texts in batch
      */
-    private simpleDeepMerge;
+    embedBatch(texts: string[]): Promise<number[][]>;
     /**
-     * Clear working memory
+     * Get embedding dimensions
      */
-    clearWorkingMemory(params: {
-        conversationId?: string;
-        userId?: string;
-    }): Promise<void>;
+    getDimensions(): number;
     /**
-     * Get working memory template
+     * Get model name
      */
-    getWorkingMemoryTemplate(): string | null;
+    getModelName(): string;
+}
+/**
+ * Vector Adapter Interface
+ * Handles vector storage and similarity search
+ */
+interface VectorAdapter {
     /**
-     * Get working memory schema
+     * Store a single vector
      */
-    getWorkingMemorySchema(): z.ZodObject<any> | null;
+    store(id: string, vector: number[], metadata?: Record<string, unknown>): Promise<void>;
     /**
-     * Get working memory format
+     * Store multiple vectors in batch
      */
-    getWorkingMemoryFormat(): "markdown" | "json" | null;
+    storeBatch(items: VectorItem[]): Promise<void>;
     /**
-     * Check if working memory is supported
+     * Search for similar vectors
      */
-    hasWorkingMemorySupport(): boolean;
-    /**
-     * Generate system instructions for working memory usage
-     */
-    getWorkingMemoryInstructions(params: {
-        conversationId?: string;
-        userId?: string;
-    }): Promise<string | null>;
-    /**
-     * Get configured adapters info
-     */
-    getAdaptersInfo(): {
-        storage: boolean;
-        embedding: {
-            configured: boolean;
-            model?: string;
-            dimensions?: number;
-        };
-        vector: boolean;
-        cache: boolean;
-    };
-    /**
-     * Save a message to memory
-     * Simple version without event publishing (handled by MemoryManagerV2)
-     */
-    saveMessageWithContext(message: UIMessage, userId: string, conversationId: string, context?: {
-        logger?: Logger;
-    }, operationContext?: OperationContext): Promise<void>;
-    /**
-     * Get messages with semantic search support
-     * Simple version without event publishing (handled by MemoryManagerV2)
-     */
-    getMessagesWithContext(userId: string, conversationId: string, options?: {
+    search(vector: number[], options?: {
         limit?: number;
-        useSemanticSearch?: boolean;
-        currentQuery?: string;
-        traceId?: string;
-        logger?: Logger;
-        semanticLimit?: number;
-        semanticThreshold?: number;
-        mergeStrategy?: "prepend" | "append" | "interleave";
-    }, operationContext?: OperationContext): Promise<UIMessage<{
-        createdAt: Date;
-    }>[]>;
-    /**
-     * Internal: Set resource ID (agent ID)
-     */
-    _setResourceId(id: string): void;
-    /**
-     * Internal: Set logger
-     */
-    _setLogger(logger: Logger): void;
-    /**
-     * Get vector adapter if configured
-     */
-    getVectorAdapter(): VectorAdapter$1 | undefined;
-    /**
-     * Get embedding adapter if configured
-     */
-    getEmbeddingAdapter(): EmbeddingAdapter$1 | undefined;
-    /**
-     * Get metadata about the configured storage adapter
-     */
-    getStorageMetadata(): MemoryStorageMetadata;
-    /**
-     * Get a UI-friendly summary of working memory configuration
-     */
-    getWorkingMemorySummary(): WorkingMemorySummary | null;
-    /**
-     * Get workflow state by execution ID
-     */
-    getWorkflowState(executionId: string): Promise<WorkflowStateEntry | null>;
-    /**
-     * Query workflow states with filters
-     */
-    queryWorkflowRuns(query: WorkflowRunQuery): Promise<WorkflowStateEntry[]>;
+        filter?: Record<string, unknown>;
+        threshold?: number;
+    }): Promise<SearchResult[]>;
     /**
-     * Set workflow state
+     * Delete a vector by ID
      */
-    setWorkflowState(executionId: string, state: WorkflowStateEntry): Promise<void>;
+    delete(id: string): Promise<void>;
     /**
-     * Update workflow state
+     * Delete multiple vectors by IDs
      */
-    updateWorkflowState(executionId: string, updates: Partial<WorkflowStateEntry>): Promise<void>;
+    deleteBatch(ids: string[]): Promise<void>;
     /**
-     * Get suspended workflow states for a workflow
+     * Clear all vectors
      */
-    getSuspendedWorkflowStates(workflowId: string): Promise<WorkflowStateEntry[]>;
+    clear(): Promise<void>;
 }
 
 /**
- * LoggerProxy implements the Logger interface but delegates all calls to the current global logger.
- * This allows agents and workflows to be created before VoltAgent sets the global logger,
- * while still using the correct logger once it's available.
+ * VoltOps Client Type Definitions
  *
- * When the logger package is not available, it also emits logs via OpenTelemetry Logs API.
+ * All types related to VoltOps client functionality including
+ * prompt management, telemetry, and API interactions.
  */
-declare class LoggerProxy implements Logger {
-    private bindings;
-    private externalLogger?;
-    constructor(bindings?: Record<string, any>, externalLogger?: Logger);
-    /**
-     * Get the actual logger instance with bindings applied
-     */
-    private getActualLogger;
-    /**
-     * Check if a log level should be logged based on the configured level
-     */
-    private shouldLog;
-    /**
-     * Emit log via OpenTelemetry Logs API if available
-     */
-    private emitOtelLog;
-    trace: LogFn;
-    debug: LogFn;
-    info: LogFn;
-    warn: LogFn;
-    error: LogFn;
-    fatal: LogFn;
-    /**
-     * Create a child logger with additional bindings
-     */
-    child(childBindings: Record<string, any>): Logger;
-}
+type ManagedMemoryStatus = "provisioning" | "ready" | "failed";
 
-declare enum ActionType {
-    START = "start",
-    COMPLETE = "complete",
-    ERROR = "error",
-    GENERATION_START = "generationStart",
-    GENERATION_COMPLETE = "generationComplete",
-    STREAM_START = "streamStart",
-    STREAM_COMPLETE = "streamComplete",
-    STREAM_STEP = "streamStep",
-    STREAMING = "streaming",
-    OBJECT_GENERATION_START = "objectGenerationStart",
-    OBJECT_GENERATION_COMPLETE = "objectGenerationComplete",
-    STREAM_OBJECT_START = "streamObjectStart",
-    STREAM_OBJECT_COMPLETE = "streamObjectComplete",
-    TOOL_CALL = "toolCall",
-    TOOL_ERROR = "toolError",
-    DELEGATE = "delegate",
-    EXECUTE = "execute",
-    VALIDATE = "validate",
-    STEP_START = "stepStart",
-    STEP_COMPLETE = "stepComplete",
-    SUSPEND = "suspend",
-    RESUME = "resume",
-    ACCESS = "access",
-    STORE = "store",
-    RETRIEVE = "retrieve"
-}
 /**
- * Helper to format retriever log messages
+ * Reference to a prompt in the VoltOps system
  */
-declare function buildRetrieverLogMessage(retrieverName: string, action: ActionType | string, description: string): string;
-
+type PromptReference = {
+    /** Name of the prompt */
+    promptName: string;
+    /** Specific version number (takes precedence over label) */
+    version?: number;
+    /** Label to fetch (e.g., 'latest', 'production', 'staging') */
+    label?: string;
+    /** Variables to substitute in the template */
+    variables?: Record<string, any>;
+    /** Per-prompt cache configuration (overrides global settings) */
+    promptCache?: {
+        enabled?: boolean;
+        ttl?: number;
+        maxSize?: number;
+    };
+};
 /**
- * Get the global logger instance from registry or create a default one
+ * Helper interface for prompt operations in agent instructions
  */
-declare function getGlobalLogger(): Logger;
+type PromptHelper = {
+    /** Get prompt content by reference */
+    getPrompt: (reference: PromptReference) => Promise<PromptContent>;
+};
 /**
- * Get the global log buffer
+ * Enhanced dynamic value options with prompts support
  */
-declare function getGlobalLogBuffer(): LogBuffer;
-
+interface DynamicValueOptions {
+    /** User context map */
+    context: Map<string | symbol, unknown>;
+    /** Prompt helper (available when VoltOpsClient is configured) */
+    prompts: PromptHelper;
+}
 /**
- * Options for configuring the Retriever
+ * Dynamic value type for agent configuration
  */
-type RetrieverOptions = {
-    /**
-     * Name for the default tool created from this retriever
-     * This is used for the pre-created 'tool' property
-     * @default "search_knowledge"
-     */
-    toolName?: string;
-    /**
-     * Description for the default tool created from this retriever
-     * This is used for the pre-created 'tool' property
-     * @default "Searches for relevant information in the knowledge base based on the query."
-     */
-    toolDescription?: string;
-    /**
-     * Optional logger instance for the retriever
-     * If not provided, a default logger will be created
-     */
-    logger?: Logger;
-    /**
-     * Additional configuration specific to concrete retriever implementations
-     */
-    [key: string]: any;
-};
+type DynamicValue<T> = (options: DynamicValueOptions) => Promise<T> | T;
 /**
- * Options passed to retrieve method.
- * Includes all operation context fields for user-specific and context-aware retrieval.
+ * VoltOps client configuration options
  */
-interface RetrieveOptions extends Partial<OperationContext> {
+type VoltOpsClientOptions = {
+    /** Base URL of the VoltOps API (default: https://api.voltagent.dev) */
+    baseUrl?: string;
     /**
-     * User-managed context map for this specific retrieval operation
-     * Can be used to store metadata, results, or any custom data
+     * Public API key for VoltOps authentication
      *
-     * Inherited from OperationContext but explicitly documented here for clarity
-     */
-    context?: Map<string | symbol, unknown>;
-    /**
-     * Optional logger instance for this retrieval operation.
-     * Provides execution-scoped logging with full context.
-     * Available when retriever is called from an agent or workflow context.
+     * @description Your VoltOps public key used for API authentication and prompt management.
+     * This key is safe to use in client-side applications as it only provides read access.
      *
-     * Inherited from OperationContext but explicitly documented here for clarity
-     */
-    logger?: Logger;
-    /**
-     * Optional user identifier for user-specific retrieval.
-     * Can be used to filter results by user or implement multi-tenant retrieval.
+     * @format Should start with `pk_` prefix (e.g., `pk_1234567890abcdef`)
      *
-     * Inherited from OperationContext
+     * @example
+     * ```typescript
+     * publicKey: process.env.VOLTAGENT_PUBLIC_KEY
+     * ```
+     *
+     *
+     * @obtain Get your API keys from: https://console.voltagent.dev/settings/projects
      */
-    userId?: string;
+    publicKey?: string;
     /**
-     * Optional conversation identifier for conversation-aware retrieval.
-     * Can be used to retrieve conversation-specific context or history.
+     * Secret API key for VoltOps authentication
      *
-     * Inherited from OperationContext
-     */
-    conversationId?: string;
-}
-/**
- * Retriever interface for retrieving relevant information
- */
-type Retriever = {
-    /**
-     * Retrieve relevant documents based on input text
-     * @param text The text to use for retrieval
-     * @param options Configuration and context for the retrieval
-     * @returns Promise resolving to a string with the retrieved content
-     */
-    retrieve(text: string, options: RetrieveOptions): Promise<string>;
-    /**
-     * Configuration options for the retriever
-     * This is optional and may not be present in all implementations
-     */
-    options?: RetrieverOptions;
-    /**
-     * Pre-created tool for easy destructuring
-     * This is optional and may not be present in all implementations
-     */
-    tool?: any;
-    /**
-     * Optional observability attributes for retriever spans.
-     */
-    getObservabilityAttributes?: () => Record<string, unknown>;
-};
-
-/**
- * Abstract base class for Retriever implementations.
- * This class provides a common structure for different types of retrievers.
- */
-declare abstract class BaseRetriever {
-    /**
-     * Options that configure the retriever's behavior
-     */
-    protected options: RetrieverOptions;
-    /**
-     * Logger instance for the retriever
-     */
-    protected logger: Logger;
-    /**
-     * Ready-to-use tool property for direct destructuring
-     * This can be used with object destructuring syntax
+     * @description Your VoltOps secret key used for secure API operations and analytics.
+     * This key provides full access to your VoltOps project and should be kept secure.
+     *
+     * @format Should start with `sk_` prefix (e.g., `sk_abcdef1234567890`)
      *
      * @example
      * ```typescript
-     * // ✅ You can use destructuring with the tool property
-     * const { tool } = new SimpleRetriever();
-     *
-     * // And use it directly in an agent
-     * const agent = new Agent({
-     *   name: "RAG Agent",
-     *   model: "gpt-4",
-     *   provider,
-     *   tools: [tool],
-     * });
+     * secretKey: process.env.VOLTAGENT_SECRET_KEY
      * ```
-     */
-    readonly tool: AgentTool;
-    /**
-     * Constructor for the BaseRetriever class.
-     * @param options - Configuration options for the retriever.
-     */
-    constructor(options?: RetrieverOptions);
-    /**
-     * Abstract method that must be implemented by concrete retriever classes.
-     * Retrieves relevant information based on the input text or messages.
      *
-     * @param input - The input to use for retrieval (string or BaseMessage array)
-     * @param options - Configuration and context for the retrieval
-     * @returns Promise resolving to a string with the retrieved content
-     */
-    abstract retrieve(input: string | BaseMessage[], options: RetrieveOptions): Promise<string>;
-    /**
-     * Optional observability attributes for retriever spans.
-     * Override in subclasses to add context (e.g. knowledge base metadata).
-     */
-    getObservabilityAttributes(): Record<string, unknown>;
-}
-
-/**
- * ReadableStream type for voice responses
- */
-type ReadableStreamType = ReadableStream | NodeJS.ReadableStream | any;
-/**
- * Voice provider options
- */
-type VoiceOptions = {
-    /**
-     * API key for the voice provider
-     */
-    apiKey?: string;
-    /**
-     * Model to use for speech recognition
-     */
-    speechModel?: string;
-    /**
-     * Model to use for text-to-speech
-     */
-    ttsModel?: string;
-    /**
-     * Voice ID to use for text-to-speech
-     */
-    voice?: string;
-    /**
-     * Additional provider-specific options
-     */
-    options?: Record<string, unknown>;
-};
-/**
- * Voice event types
- */
-type VoiceEventType = "speaking" | "listening" | "error" | "connected" | "disconnected";
-/**
- * Voice event data types
- */
-type VoiceEventData = {
-    speaking: {
-        text: string;
-        audio?: NodeJS.ReadableStream;
-    };
-    listening: {
-        audio: NodeJS.ReadableStream;
-    };
-    error: {
-        message: string;
-        code?: string;
-        details?: unknown;
-    };
-    connected: undefined;
-    disconnected: undefined;
-};
-/**
- * Voice metadata
- */
-type VoiceMetadata = {
-    id: string;
-    name: string;
-    language: string;
-    gender?: "male" | "female" | "neutral";
-    metadata?: Record<string, unknown>;
-};
-/**
- * Base interface for voice providers
- */
-type Voice = {
-    /**
-     * Convert text to speech
-     */
-    speak(text: string | NodeJS.ReadableStream, options?: {
-        voice?: string;
-        speed?: number;
-        pitch?: number;
-    }): Promise<NodeJS.ReadableStream>;
-    /**
-     * Convert speech to text
-     */
-    listen(audio: NodeJS.ReadableStream, options?: {
-        language?: string;
-        model?: string;
-        stream?: boolean;
-    }): Promise<string | ReadableStreamType>;
-    /**
-     * Connect to real-time voice service
-     */
-    connect(options?: Record<string, unknown>): Promise<void>;
-    /**
-     * Disconnect from real-time voice service
-     */
-    disconnect(): void;
-    /**
-     * Send audio data to real-time service
-     */
-    send(audioData: NodeJS.ReadableStream | Int16Array): Promise<void>;
-    /**
-     * Register event listener
-     */
-    on<E extends VoiceEventType>(event: E, callback: (data: VoiceEventData[E]) => void): void;
-    /**
-     * Remove event listener
-     */
-    off<E extends VoiceEventType>(event: E, callback: (data: VoiceEventData[E]) => void): void;
-    /**
-     * Get available voices
+     *
+     * @obtain Get your API keys from: https://console.voltagent.dev/settings/projects
      */
-    getVoices(): Promise<VoiceMetadata[]>;
-};
-
-/**
- * VoltOps Client Type Definitions
- *
- * All types related to VoltOps client functionality including
- * prompt management, telemetry, and API interactions.
- */
-type ManagedMemoryStatus = "provisioning" | "ready" | "failed";
-
-/**
- * Reference to a prompt in the VoltOps system
- */
-type PromptReference = {
-    /** Name of the prompt */
-    promptName: string;
-    /** Specific version number (takes precedence over label) */
-    version?: number;
-    /** Label to fetch (e.g., 'latest', 'production', 'staging') */
-    label?: string;
-    /** Variables to substitute in the template */
-    variables?: Record<string, any>;
-    /** Per-prompt cache configuration (overrides global settings) */
+    secretKey?: string;
+    /** Custom fetch implementation (optional) */
+    fetch?: typeof fetch;
+    /** Enable prompt management (default: true) */
+    prompts?: boolean;
+    /** Optional configuration for prompt caching */
     promptCache?: {
         enabled?: boolean;
         ttl?: number;
         maxSize?: number;
     };
 };
-/**
- * Helper interface for prompt operations in agent instructions
- */
-type PromptHelper = {
-    /** Get prompt content by reference */
-    getPrompt: (reference: PromptReference) => Promise<PromptContent>;
-};
-/**
- * Enhanced dynamic value options with prompts support
- */
-interface DynamicValueOptions {
-    /** User context map */
-    context: Map<string | symbol, unknown>;
-    /** Prompt helper (available when VoltOpsClient is configured) */
-    prompts: PromptHelper;
-}
-/**
- * Dynamic value type for agent configuration
- */
-type DynamicValue<T> = (options: DynamicValueOptions) => Promise<T> | T;
-/**
- * VoltOps client configuration options
- */
-type VoltOpsClientOptions = {
-    /** Base URL of the VoltOps API (default: https://api.voltagent.dev) */
-    baseUrl?: string;
-    /**
-     * Public API key for VoltOps authentication
-     *
-     * @description Your VoltOps public key used for API authentication and prompt management.
-     * This key is safe to use in client-side applications as it only provides read access.
-     *
-     * @format Should start with `pk_` prefix (e.g., `pk_1234567890abcdef`)
-     *
-     * @example
-     * ```typescript
-     * publicKey: process.env.VOLTAGENT_PUBLIC_KEY
-     * ```
-     *
-     *
-     * @obtain Get your API keys from: https://console.voltagent.dev/settings/projects
-     */
-    publicKey?: string;
-    /**
-     * Secret API key for VoltOps authentication
-     *
-     * @description Your VoltOps secret key used for secure API operations and analytics.
-     * This key provides full access to your VoltOps project and should be kept secure.
-     *
-     * @format Should start with `sk_` prefix (e.g., `sk_abcdef1234567890`)
-     *
-     * @example
-     * ```typescript
-     * secretKey: process.env.VOLTAGENT_SECRET_KEY
-     * ```
-     *
-     *
-     * @obtain Get your API keys from: https://console.voltagent.dev/settings/projects
-     */
-    secretKey?: string;
-    /** Custom fetch implementation (optional) */
-    fetch?: typeof fetch;
-    /** Enable prompt management (default: true) */
-    prompts?: boolean;
-    /** Optional configuration for prompt caching */
-    promptCache?: {
-        enabled?: boolean;
-        ttl?: number;
-        maxSize?: number;
-    };
-};
-type VoltOpsFeedbackConfig = {
-    type: "continuous" | "categorical" | "freeform";
-    min?: number;
-    max?: number;
-    categories?: Array<{
-        value: string | number;
-        label?: string;
-        description?: string;
-    }>;
-    [key: string]: any;
+type VoltOpsFeedbackConfig = {
+    type: "continuous" | "categorical" | "freeform";
+    min?: number;
+    max?: number;
+    categories?: Array<{
+        value: string | number;
+        label?: string;
+        description?: string;
+    }>;
+    [key: string]: any;
 };
 type VoltOpsFeedbackExpiresIn = {
     days?: number;
@@ -2947,8 +2884,8 @@ interface ManagedMemoryStepsClient {
 interface ManagedMemoryVectorsClient {
     store(databaseId: string, input: ManagedMemoryStoreVectorInput): Promise<void>;
     storeBatch(databaseId: string, input: ManagedMemoryStoreVectorsBatchInput): Promise<void>;
-    search(databaseId: string, input: ManagedMemorySearchVectorsInput): Promise<SearchResult[]>;
-    get(databaseId: string, vectorId: string): Promise<VectorItem | null>;
+    search(databaseId: string, input: ManagedMemorySearchVectorsInput): Promise<SearchResult$1[]>;
+    get(databaseId: string, vectorId: string): Promise<VectorItem$1 | null>;
     delete(databaseId: string, vectorId: string): Promise<void>;
     deleteBatch(databaseId: string, input: ManagedMemoryDeleteVectorsInput): Promise<void>;
     clear(databaseId: string): Promise<void>;
@@ -6859,6 +6796,9 @@ interface OnToolEndHookArgs {
     context: OperationContext;
     options?: ToolExecuteOptions;
 }
+interface OnToolEndHookResult {
+    output?: unknown;
+}
 interface OnPrepareMessagesHookArgs {
     /** The messages that will be sent to the LLM (AI SDK UIMessage). */
     messages: UIMessage[];
@@ -6943,7 +6883,7 @@ type AgentHookOnEnd = (args: OnEndHookArgs) => Promise<void> | void;
 type AgentHookOnHandoff = (args: OnHandoffHookArgs) => Promise<void> | void;
 type AgentHookOnHandoffComplete = (args: OnHandoffCompleteHookArgs) => Promise<void> | void;
 type AgentHookOnToolStart = (args: OnToolStartHookArgs) => Promise<void> | void;
-type AgentHookOnToolEnd = (args: OnToolEndHookArgs) => Promise<void> | void;
+type AgentHookOnToolEnd = (args: OnToolEndHookArgs) => Promise<OnToolEndHookResult | undefined> | Promise<void> | OnToolEndHookResult | undefined;
 type AgentHookOnPrepareMessages = (args: OnPrepareMessagesHookArgs) => Promise<OnPrepareMessagesHookResult> | OnPrepareMessagesHookResult;
 type AgentHookOnPrepareModelMessages = (args: OnPrepareModelMessagesHookArgs) => Promise<OnPrepareModelMessagesHookResult> | OnPrepareModelMessagesHookResult;
 type AgentHookOnError = (args: OnErrorHookArgs) => Promise<void> | void;
@@ -6981,811 +6921,1149 @@ declare function createHooks(hooks?: Partial<AgentHooks>): AgentHooks;
  * 3. Context propagation works correctly across async operations
  * 4. Clean integration with VoltAgentObservability for WebSocket and storage
  */
-
-interface TraceContextOptions {
-    agentId: string;
-    agentName?: string;
-    userId?: string;
-    conversationId?: string;
-    operationId: string;
-    parentSpan?: Span;
-    parentAgentId?: string;
-    input?: string | UIMessage[] | BaseMessage[];
+
+interface TraceContextOptions {
+    agentId: string;
+    agentName?: string;
+    userId?: string;
+    conversationId?: string;
+    operationId: string;
+    parentSpan?: Span;
+    parentAgentId?: string;
+    input?: string | UIMessage[] | BaseMessage[];
+}
+declare class AgentTraceContext {
+    private rootSpan;
+    private tracer;
+    private commonAttributes;
+    private activeContext;
+    constructor(observability: VoltAgentObservability, operationName: string, options: TraceContextOptions);
+    /**
+     * Create a child span with automatic parent context and attribute inheritance
+     */
+    createChildSpan(name: string, type: "tool" | "memory" | "retriever" | "embedding" | "vector" | "agent" | "guardrail" | "middleware" | "llm" | "summary", options?: {
+        label?: string;
+        attributes?: Record<string, any>;
+        kind?: SpanKind$1;
+    }): Span;
+    /**
+     * Create a child span with a specific parent span
+     */
+    createChildSpanWithParent(parentSpan: Span, name: string, type: "tool" | "memory" | "retriever" | "embedding" | "vector" | "agent" | "guardrail" | "middleware" | "llm" | "summary", options?: {
+        label?: string;
+        attributes?: Record<string, any>;
+        kind?: SpanKind$1;
+    }): Span;
+    /**
+     * Execute a function within a span's context
+     */
+    withSpan<T>(span: Span, fn: () => T | Promise<T>): Promise<T>;
+    /**
+     * Get the root span
+     */
+    getRootSpan(): Span;
+    /**
+     * Set input on the root span
+     */
+    setInput(input: any): void;
+    /**
+     * Set output on the root span
+     */
+    setOutput(output: any): void;
+    /**
+     * Set instructions (system prompt) on the root span
+     */
+    setInstructions(instructions: any): void;
+    /**
+     * Set model attributes on the root span
+     */
+    setModelAttributes(modelName: string, temperature?: number, maxTokens?: number, topP?: number, frequencyPenalty?: number, presencePenalty?: number, maxSteps?: number): void;
+    /**
+     * Set usage information on the root span
+     */
+    setUsage(usage: {
+        promptTokens?: number;
+        completionTokens?: number;
+        totalTokens?: number;
+        cachedTokens?: number;
+        reasoningTokens?: number;
+    }): void;
+    /**
+     * Set finish reason on the root span
+     */
+    setFinishReason(finishReason: string | null | undefined): void;
+    /**
+     * Set stop condition metadata when maxSteps is reached
+     */
+    setStopConditionMet(stepCount: number, maxSteps: number): void;
+    /**
+     * End the root span with a status
+     */
+    end(status: "completed" | "error", error?: Error | any): void;
+    /**
+     * End a child span with proper status
+     */
+    endChildSpan(span: Span, status: "completed" | "error", options?: {
+        output?: any;
+        error?: Error | any;
+        attributes?: Record<string, any>;
+    }): void;
+    private resolveParentSpan;
+    /**
+     * Get the active context for manual context propagation
+     */
+    getActiveContext(): Context;
+    /**
+     * Update active context with a new span
+     */
+    updateActiveContext(span: Span): void;
+}
+
+/**
+ * Tool representation for API responses
+ */
+interface ApiToolInfo {
+    name: string;
+    description: string;
+    parameters?: any;
+}
+interface AgentToolRoutingState {
+    routers?: ApiToolInfo[];
+    expose?: ApiToolInfo[];
+    pool?: ApiToolInfo[];
+}
+type AgentFeedbackOptions = {
+    key?: string;
+    feedbackConfig?: VoltOpsFeedbackConfig | null;
+    expiresAt?: Date | string;
+    expiresIn?: VoltOpsFeedbackExpiresIn;
+};
+type AgentFeedbackMetadata = {
+    traceId: string;
+    key: string;
+    url: string;
+    tokenId?: string;
+    expiresAt?: string;
+    feedbackConfig?: VoltOpsFeedbackConfig | null;
+};
+/**
+ * Tool with node_id for agent state
+ */
+type ToolWithNodeId = (BaseTool | ProviderTool) & {
+    node_id: string;
+};
+interface AgentScorerState {
+    key: string;
+    id: string;
+    name: string;
+    node_id: string;
+    sampling?: SamplingPolicy;
+    metadata?: Record<string, unknown> | null;
+    params?: Record<string, unknown> | null;
+}
+/**
+ * SubAgent data structure for agent state
+ */
+interface SubAgentStateData {
+    id: string;
+    name: string;
+    instructions?: string;
+    status: string;
+    model: string;
+    tools: ApiToolInfo[];
+    memory?: AgentMemoryState;
+    node_id: string;
+    subAgents?: SubAgentStateData[];
+    scorers?: AgentScorerState[];
+    guardrails?: AgentGuardrailStateGroup;
+    methodConfig?: {
+        method: string;
+        schema?: string;
+        options?: string[];
+    };
+    [key: string]: unknown;
+}
+/**
+ * Memory block representation shared across agent and sub-agent state
+ */
+interface AgentMemoryState extends Record<string, unknown> {
+    node_id: string;
+    type?: string;
+    resourceId?: string;
+    options?: MemoryOptions;
+    available?: boolean;
+    status?: string;
+    storage?: MemoryStorageMetadata;
+    workingMemory?: WorkingMemorySummary | null;
+    vectorDB?: {
+        enabled: boolean;
+        adapter?: string;
+        dimension?: number;
+        status?: string;
+        node_id?: string;
+    } | null;
+    embeddingModel?: {
+        enabled: boolean;
+        model?: string;
+        dimension?: number;
+        status?: string;
+        node_id?: string;
+    } | null;
+}
+/**
+ * Full state of an agent including all properties
+ */
+interface AgentFullState {
+    id: string;
+    name: string;
+    instructions?: string;
+    status: string;
+    model: string;
+    node_id: string;
+    tools: ToolWithNodeId[];
+    toolRouting?: AgentToolRoutingState;
+    subAgents: SubAgentStateData[];
+    memory: AgentMemoryState;
+    scorers?: AgentScorerState[];
+    retriever?: {
+        name: string;
+        description?: string;
+        status?: string;
+        node_id: string;
+    } | null;
+    guardrails?: AgentGuardrailStateGroup;
+}
+/**
+ * Enhanced dynamic value for instructions that supports prompt management
+ */
+type InstructionsDynamicValue = string | DynamicValue<string | PromptContent>;
+/**
+ * Enhanced dynamic value for models that supports static or dynamic values
+ */
+type ModelDynamicValue<T> = T | DynamicValue<T>;
+/**
+ * Supported model references for agents (AI SDK models or provider/model strings)
+ */
+type AgentModelReference = LanguageModel | ModelRouterModelId;
+/**
+ * Model fallback configuration for agents.
+ */
+type AgentModelConfig = {
+    /**
+     * Optional stable identifier for the model entry (useful for logging).
+     */
+    id?: string;
+    /**
+     * Model reference (static or dynamic).
+     */
+    model: ModelDynamicValue<AgentModelReference>;
+    /**
+     * Maximum number of retries for this model before falling back.
+     * Defaults to the agent's maxRetries.
+     */
+    maxRetries?: number;
+    /**
+     * Whether this model is enabled for fallback selection.
+     * @default true
+     */
+    enabled?: boolean;
+};
+/**
+ * Agent model value that can be static, dynamic, or a fallback list.
+ */
+type AgentModelValue = ModelDynamicValue<AgentModelReference> | AgentModelConfig[];
+/**
+ * Provider options type for LLM configurations
+ */
+type ProviderOptions = {
+    temperature?: number;
+    maxTokens?: number;
+    topP?: number;
+    frequencyPenalty?: number;
+    presencePenalty?: number;
+    seed?: number;
+    stopSequences?: string[];
+    extraOptions?: Record<string, unknown>;
+    onStepFinish?: (step: StepWithContent) => Promise<void>;
+    onFinish?: (result: unknown) => Promise<void>;
+    onError?: (error: unknown) => Promise<void>;
+    [key: string]: unknown;
+};
+/**
+ * Configuration for supervisor agents that have subagents
+ */
+/**
+ * StreamEventType derived from AI SDK's TextStreamPart
+ * Includes all event types from AI SDK
+ */
+type StreamEventType = TextStreamPart<any>["type"];
+/**
+ * Configuration for forwarding events from subagents to the parent agent's stream
+ */
+type FullStreamEventForwardingConfig = {
+    /**
+     * Array of event types to forward from subagents
+     * Uses AI SDK's TextStreamPart types:
+     * - Text: 'text-start', 'text-end', 'text-delta'
+     * - Reasoning: 'reasoning-start', 'reasoning-end', 'reasoning-delta'
+     * - Tool: 'tool-input-start', 'tool-input-end', 'tool-input-delta',
+     *         'tool-call', 'tool-result', 'tool-error'
+     * - Other: 'source', 'file', 'start-step', 'finish-step',
+     *          'start', 'finish', 'abort', 'error', 'raw'
+     * @default ['tool-call', 'tool-result']
+     * @example ['tool-call', 'tool-result', 'text-delta']
+     */
+    types?: StreamEventType[];
+};
+type SupervisorConfig = {
+    /**
+     * Complete custom system message for the supervisor agent
+     * If provided, this completely replaces the default template
+     * Only agents memory section will be appended if includeAgentsMemory is true
+     */
+    systemMessage?: string;
+    /**
+     * Whether to include agents memory in the supervisor system message
+     * @default true
+     */
+    includeAgentsMemory?: boolean;
+    /**
+     * Additional custom guidelines for the supervisor agent
+     */
+    customGuidelines?: string[];
+    /**
+     * Configuration for forwarding events from subagents to the parent agent's full stream
+     * Controls which event types are forwarded
+     * @default { types: ['tool-call', 'tool-result'] }
+     */
+    fullStreamEventForwarding?: FullStreamEventForwardingConfig;
+    /**
+     * Whether to throw an exception when a subagent stream encounters an error
+     * If true, stream errors will cause the handoff to throw an exception
+     * If false, errors will be captured and returned in the result
+     * @default false
+     */
+    throwOnStreamError?: boolean;
+    /**
+     * Whether to include error message in the result when no text content was produced
+     * Only applies when throwOnStreamError is false
+     * If true, the error message will be included in the result field
+     * If false, the result will be empty but status will still be 'error'
+     * @default true
+     */
+    includeErrorInEmptyResponse?: boolean;
+};
+type GuardrailSeverity = "info" | "warning" | "critical";
+type GuardrailAction = "allow" | "modify" | "block";
+interface GuardrailBaseResult {
+    pass: boolean;
+    action?: GuardrailAction;
+    message?: string;
+    metadata?: Record<string, unknown>;
+}
+interface OutputGuardrailStreamArgs extends GuardrailContext {
+    part: VoltAgentTextStreamPart;
+    streamParts: VoltAgentTextStreamPart[];
+    state: Record<string, any>;
+    abort: (reason?: string) => never;
+}
+type OutputGuardrailStreamResult = VoltAgentTextStreamPart | null | undefined | Promise<VoltAgentTextStreamPart | null | undefined>;
+type OutputGuardrailStreamHandler = (args: OutputGuardrailStreamArgs) => OutputGuardrailStreamResult;
+type GuardrailFunctionMetadata = {
+    guardrailId?: string;
+    guardrailName?: string;
+    guardrailDescription?: string;
+    guardrailTags?: string[];
+    guardrailSeverity?: GuardrailSeverity;
+};
+type GuardrailFunction<TArgs, TResult> = ((args: TArgs) => TResult | Promise<TResult>) & GuardrailFunctionMetadata;
+interface GuardrailDefinition<TArgs, TResult> {
+    id?: string;
+    name?: string;
+    description?: string;
+    tags?: string[];
+    severity?: GuardrailSeverity;
+    metadata?: Record<string, unknown>;
+    handler: GuardrailFunction<TArgs, TResult>;
+}
+type GuardrailConfig<TArgs, TResult> = GuardrailFunction<TArgs, TResult> | GuardrailDefinition<TArgs, TResult>;
+interface AgentGuardrailState {
+    id?: string;
+    name: string;
+    direction: "input" | "output";
+    description?: string;
+    severity?: GuardrailSeverity;
+    tags?: string[];
+    metadata?: Record<string, unknown> | null;
+    node_id: string;
+}
+interface AgentGuardrailStateGroup {
+    input: AgentGuardrailState[];
+    output: AgentGuardrailState[];
+}
+interface GuardrailContext {
+    agent: Agent;
+    context: OperationContext;
+    operation: AgentEvalOperationType;
+}
+interface InputGuardrailArgs extends GuardrailContext {
+    /**
+     * The latest value after any previous guardrail modifications.
+     */
+    input: string | UIMessage[] | BaseMessage[];
+    /**
+     * Plain text representation of the latest input value.
+     */
+    inputText: string;
+    /**
+     * The original user provided value before any guardrail modifications.
+     */
+    originalInput: string | UIMessage[] | BaseMessage[];
+    /**
+     * Plain text representation of the original input value.
+     */
+    originalInputText: string;
+}
+interface InputGuardrailResult extends GuardrailBaseResult {
+    modifiedInput?: string | UIMessage[] | BaseMessage[];
+}
+interface OutputGuardrailArgs<TOutput = unknown> extends GuardrailContext {
+    /**
+     * The latest value after any previous guardrail modifications.
+     */
+    output: TOutput;
+    /**
+     * Optional plain text representation of the latest output value.
+     */
+    outputText?: string;
+    /**
+     * The original value produced by the model before guardrail modifications.
+     */
+    originalOutput: TOutput;
+    /**
+     * Optional plain text representation of the original output value.
+     */
+    originalOutputText?: string;
+    /**
+     * Optional usage metrics for the generation.
+     */
+    usage?: UsageInfo;
+    /**
+     * Optional finish reason from the model/provider.
+     */
+    finishReason?: string | null;
+    /**
+     * Optional warnings or diagnostics returned by the provider.
+     */
+    warnings?: unknown[] | null;
+}
+interface OutputGuardrailResult<TOutput = unknown> extends GuardrailBaseResult {
+    modifiedOutput?: TOutput;
+}
+type InputGuardrail = GuardrailConfig<InputGuardrailArgs, InputGuardrailResult>;
+type OutputGuardrailFunction<TOutput = unknown> = GuardrailFunction<OutputGuardrailArgs<TOutput>, OutputGuardrailResult<TOutput>> & {
+    guardrailStreamHandler?: OutputGuardrailStreamHandler;
+};
+interface OutputGuardrailDefinition<TOutput = unknown> extends GuardrailDefinition<OutputGuardrailArgs<TOutput>, OutputGuardrailResult<TOutput>> {
+    streamHandler?: OutputGuardrailStreamHandler;
+}
+type OutputGuardrail<TOutput = unknown> = OutputGuardrailFunction<TOutput> | OutputGuardrailDefinition<TOutput>;
+type MiddlewareDirection = "input" | "output";
+type MiddlewareFunctionMetadata = {
+    middlewareId?: string;
+    middlewareName?: string;
+    middlewareDescription?: string;
+    middlewareTags?: string[];
+};
+type MiddlewareFunction<TArgs, TResult> = ((args: TArgs) => TResult | Promise<TResult>) & MiddlewareFunctionMetadata;
+interface MiddlewareDefinition<TArgs, TResult> {
+    id?: string;
+    name?: string;
+    description?: string;
+    tags?: string[];
+    metadata?: Record<string, unknown>;
+    handler: MiddlewareFunction<TArgs, TResult>;
+}
+interface MiddlewareContext {
+    agent: Agent;
+    context: OperationContext;
+    operation: AgentEvalOperationType;
+    retryCount: number;
+}
+interface InputMiddlewareArgs extends MiddlewareContext {
+    input: string | UIMessage[] | BaseMessage[];
+    originalInput: string | UIMessage[] | BaseMessage[];
+    abort: <TMetadata = unknown>(reason?: string, options?: MiddlewareAbortOptions<TMetadata>) => never;
+}
+type InputMiddlewareResult = string | UIMessage[] | BaseMessage[] | undefined;
+interface OutputMiddlewareArgs<TOutput = unknown> extends MiddlewareContext {
+    output: TOutput;
+    originalOutput: TOutput;
+    usage?: UsageInfo;
+    finishReason?: string | null;
+    warnings?: unknown[] | null;
+    abort: <TMetadata = unknown>(reason?: string, options?: MiddlewareAbortOptions<TMetadata>) => never;
+}
+type OutputMiddlewareResult<TOutput = unknown> = TOutput | undefined;
+type InputMiddleware = MiddlewareDefinition<InputMiddlewareArgs, InputMiddlewareResult> | MiddlewareFunction<InputMiddlewareArgs, InputMiddlewareResult>;
+type OutputMiddleware<TOutput = unknown> = MiddlewareDefinition<OutputMiddlewareArgs<TOutput>, OutputMiddlewareResult<TOutput>> | MiddlewareFunction<OutputMiddlewareArgs<TOutput>, OutputMiddlewareResult<TOutput>>;
+type AgentSummarizationOptions = {
+    enabled?: boolean;
+    triggerTokens?: number;
+    keepMessages?: number;
+    maxOutputTokens?: number;
+    systemPrompt?: string | null;
+    model?: AgentModelValue;
+};
+/**
+ * Agent configuration options
+ */
+type AgentOptions = {
+    id?: string;
+    name: string;
+    purpose?: string;
+    model: AgentModelValue;
+    instructions: InstructionsDynamicValue;
+    tools?: (Tool<any, any> | Toolkit | Tool$1)[] | DynamicValue<(Tool<any, any> | Toolkit)[]>;
+    toolkits?: Toolkit[];
+    toolRouting?: ToolRoutingConfig | false;
+    memory?: Memory | false;
+    summarization?: AgentSummarizationOptions | false;
+    retriever?: BaseRetriever;
+    subAgents?: SubAgentConfig[];
+    supervisorConfig?: SupervisorConfig;
+    maxHistoryEntries?: number;
+    hooks?: AgentHooks;
+    inputGuardrails?: InputGuardrail[];
+    outputGuardrails?: OutputGuardrail<any>[];
+    inputMiddlewares?: InputMiddleware[];
+    outputMiddlewares?: OutputMiddleware<any>[];
+    /**
+     * Default retry count for middleware-triggered retries.
+     * Per-call maxMiddlewareRetries overrides this value.
+     */
+    maxMiddlewareRetries?: number;
+    temperature?: number;
+    maxOutputTokens?: number;
+    maxSteps?: number;
+    /**
+     * Default retry count for model calls before falling back.
+     * Overridden by per-model maxRetries or per-call maxRetries.
+     */
+    maxRetries?: number;
+    feedback?: AgentFeedbackOptions | boolean;
+    /**
+     * Default stop condition for step execution (ai-sdk `stopWhen`).
+     * Per-call `stopWhen` in method options overrides this.
+     */
+    stopWhen?: StopWhen;
+    markdown?: boolean;
+    voice?: Voice;
+    logger?: Logger;
+    voltOpsClient?: VoltOpsClient;
+    observability?: VoltAgentObservability;
+    context?: ContextInput;
+    eval?: AgentEvalConfig;
+};
+type AgentEvalOperationType = "generateText" | "generateTitle" | "streamText" | "generateObject" | "streamObject" | "workflow";
+interface AgentEvalPayload {
+    operationId: string;
+    operationType: AgentEvalOperationType;
+    input?: string | null;
+    output?: string | null;
+    rawInput?: string | UIMessage[] | BaseMessage[];
+    rawOutput?: unknown;
+    userId?: string;
+    conversationId?: string;
+    traceId: string;
+    spanId: string;
+    metadata?: Record<string, unknown>;
+}
+type AgentEvalContext = AgentEvalPayload & Record<string, unknown> & {
+    agentId: string;
+    agentName: string;
+    timestamp: string;
+    rawPayload: AgentEvalPayload;
+};
+type AgentEvalParams = Record<string, unknown>;
+type AgentEvalSamplingPolicy = SamplingPolicy;
+type AgentEvalScorerFactory = () => LocalScorerDefinition<AgentEvalContext, Record<string, unknown>> | Promise<LocalScorerDefinition<AgentEvalContext, Record<string, unknown>>>;
+type AgentEvalScorerReference = LocalScorerDefinition<AgentEvalContext, Record<string, unknown>> | AgentEvalScorerFactory;
+interface AgentEvalResult {
+    scorerId: string;
+    scorerName?: string;
+    status: "success" | "error" | "skipped";
+    score?: number | null;
+    metadata?: Record<string, unknown> | null;
+    error?: unknown;
+    durationMs?: number;
+    payload: AgentEvalPayload;
+    rawPayload: AgentEvalPayload;
+}
+type AgentEvalFeedbackSaveInput = Omit<VoltOpsFeedbackCreateInput, "traceId"> & {
+    traceId?: string;
+};
+type AgentEvalFeedbackHelper = {
+    save: (input: AgentEvalFeedbackSaveInput) => Promise<VoltOpsFeedback | null>;
+};
+type AgentEvalResultCallbackArgs = AgentEvalResult & {
+    result: AgentEvalResult;
+    feedback: AgentEvalFeedbackHelper;
+};
+interface AgentEvalScorerConfig {
+    scorer: AgentEvalScorerReference;
+    params?: AgentEvalParams | ((context: AgentEvalContext) => AgentEvalParams | undefined | Promise<AgentEvalParams | undefined>);
+    sampling?: AgentEvalSamplingPolicy;
+    id?: string;
+    onResult?: (result: AgentEvalResultCallbackArgs) => void | Promise<void>;
+    buildPayload?: (context: AgentEvalContext) => Record<string, unknown> | Promise<Record<string, unknown>>;
+    buildParams?: (context: AgentEvalContext) => AgentEvalParams | undefined | Promise<AgentEvalParams | undefined>;
+}
+interface AgentEvalConfig {
+    scorers: Record<string, AgentEvalScorerConfig>;
+    triggerSource?: string;
+    environment?: string;
+    sampling?: AgentEvalSamplingPolicy;
+    redact?: (payload: AgentEvalPayload) => AgentEvalPayload;
+}
+/**
+ * Agent status information
+ */
+type AgentStatus = "idle" | "working" | "error" | "completed" | "cancelled";
+/**
+ * Tool call definition
+ */
+type ToolCall$1 = {
+    id: string;
+    type: "function";
+    function: {
+        name: string;
+        arguments: string;
+    };
+};
+/**
+ * Model tool call format
+ */
+type ModelToolCall = {
+    type: "tool-call";
+    toolCallId: string;
+    toolName: string;
+    args: Record<string, unknown>;
+};
+/**
+ * Represents the payload used when sending a tool's result back to the chat runtime
+ *  via useChat().addToolResult in the Vercel AI SDK.
+ */
+type ClientSideToolResult = {
+    tool: string;
+    toolCallId: string;
+    output: unknown;
+} | {
+    tool: string;
+    toolCallId: string;
+    state: "output-error";
+    errorText: string;
+};
+/**
+ * Agent response format
+ */
+type AgentResponse = {
+    /**
+     * Response content
+     */
+    content: string;
+    /**
+     * Tool calls made by the model (if any)
+     */
+    toolCalls?: ToolCall$1[];
+    /**
+     * Additional metadata
+     */
+    metadata: {
+        agentId: string;
+        agentName: string;
+        [key: string]: unknown;
+    };
+};
+/**
+ * Context for a specific agent operation (e.g., one generateText call)
+ */
+type OperationContext = {
+    /** Unique identifier for the operation */
+    readonly operationId: string;
+    /** Optional user identifier associated with this operation */
+    userId?: string;
+    /** Optional conversation identifier associated with this operation */
+    conversationId?: string;
+    /** User-managed context map for this operation */
+    readonly context: Map<string | symbol, unknown>;
+    /** System-managed context map for internal operation tracking */
+    readonly systemContext: Map<string | symbol, unknown>;
+    /** Whether this operation is still active */
+    isActive: boolean;
+    /** Parent agent ID if part of a delegation chain */
+    parentAgentId?: string;
+    /** Optional elicitation bridge for requesting user input */
+    elicitation?: (request: unknown) => Promise<unknown>;
+    /** Trace context for managing span hierarchy and common attributes */
+    traceContext: AgentTraceContext;
+    /** Execution-scoped logger with full context (userId, conversationId, executionId) */
+    logger: Logger;
+    /** Conversation steps for building full message history including tool calls/results */
+    conversationSteps?: StepWithContent[];
+    /** AbortController for cancelling the operation and accessing the signal */
+    abortController: AbortController;
+    /** Start time of the operation (Date object) */
+    startTime: Date;
+    /** Cancellation error to be thrown when operation is aborted */
+    cancellationError?: CancellationError;
+    /** Input provided to the agent operation (string, UIMessages, or BaseMessages) */
+    input?: string | UIMessage[] | BaseMessage[];
+    /** Output generated by the agent operation (text or object) */
+    output?: string | object;
+};
+/**
+ * Specific information related to a tool execution error.
+ */
+interface ToolErrorInfo {
+    /** The unique identifier of the tool call. */
+    toolCallId: string;
+    /** The name of the tool that was executed. */
+    toolName: string;
+    /** The original error thrown directly by the tool during execution (if available). */
+    toolExecutionError?: unknown;
+    /** The arguments passed to the tool when the error occurred (for debugging). */
+    toolArguments?: unknown;
+}
+/**
+ * Type for onError callbacks in streaming operations.
+ * Providers must pass an error conforming to the VoltAgentError structure.
+ */
+type StreamOnErrorCallback = (error: VoltAgentError) => Promise<void> | void;
+type UserContext = Map<string | symbol, unknown>;
+/**
+ * Standardized object structure passed to the onFinish callback
+ * when streamText completes successfully.
+ */
+interface StreamTextFinishResult {
+    /** The final, consolidated text output from the stream. */
+    text: string;
+    /** Token usage information (if available). */
+    usage?: UsageInfo;
+    /** Feedback metadata for the trace, if enabled. */
+    feedback?: AgentFeedbackMetadata | null;
+    /** The reason the stream finished (if available, e.g., 'stop', 'length', 'tool-calls'). */
+    finishReason?: string;
+    /** The original completion response object from the provider (if available). */
+    providerResponse?: unknown;
+    /** Any warnings generated during the completion (if available). */
+    warnings?: unknown[];
+    /** User context containing any custom metadata from the operation. */
+    context?: UserContext;
+}
+/**
+ * Type for the onFinish callback function for streamText.
+ */
+type StreamTextOnFinishCallback = (result: StreamTextFinishResult) => Promise<void> | void;
+/**
+ * Standardized object structure passed to the onFinish callback
+ * when streamObject completes successfully.
+ * @template TObject The expected type of the fully formed object.
+ */
+interface StreamObjectFinishResult<TObject> {
+    /** The final, fully formed object from the stream. */
+    object: TObject;
+    /** Token usage information (if available). */
+    usage?: UsageInfo;
+    /** The original completion response object from the provider (if available). */
+    providerResponse?: unknown;
+    /** Any warnings generated during the completion (if available). */
+    warnings?: unknown[];
+    /** The reason the stream finished (if available). Although less common for object streams. */
+    finishReason?: string;
+    /** User context containing any custom metadata from the operation. */
+    context?: UserContext;
+}
+/**
+ * Type for the onFinish callback function for streamObject.
+ * @template TObject The expected type of the fully formed object.
+ */
+type StreamObjectOnFinishCallback<TObject> = (result: StreamObjectFinishResult<TObject>) => Promise<void> | void;
+/**
+ * Standardized success result structure for generateText.
+ */
+interface StandardizedTextResult {
+    /** The generated text. */
+    text: string;
+    /** Token usage information (if available). */
+    usage?: UsageInfo;
+    /** Feedback metadata for the trace, if enabled. */
+    feedback?: AgentFeedbackMetadata | null;
+    /** Original provider response (if needed). */
+    providerResponse?: unknown;
+    /** Finish reason (if available from provider). */
+    finishReason?: string;
+    /** Warnings (if available from provider). */
+    warnings?: unknown[];
+    /** User context containing any custom metadata from the operation. */
+    context?: UserContext;
+}
+/**
+ * Standardized success result structure for generateObject.
+ * @template TObject The expected type of the generated object.
+ */
+interface StandardizedObjectResult<TObject> {
+    /** The generated object. */
+    object: TObject;
+    /** Token usage information (if available). */
+    usage?: UsageInfo;
+    /** Original provider response (if needed). */
+    providerResponse?: unknown;
+    /** Finish reason (if available from provider). */
+    finishReason?: string;
+    /** Warnings (if available from provider). */
+    warnings?: unknown[];
+    /** User context containing any custom metadata from the operation. */
+    context?: UserContext;
+}
+/**
+ * Unified output type for the onEnd hook, representing the successful result
+ * of any core agent operation. Use 'type guarding' or check specific fields
+ * within the hook implementation to determine the concrete type.
+ * Object types are generalized to 'unknown' here for the union.
+ */
+type AgentOperationOutput = StandardizedTextResult | StreamTextFinishResult | StandardizedObjectResult<unknown> | StreamObjectFinishResult<unknown>;
+
+/**
+ * Custom error classes for Memory V2
+ */
+/**
+ * Base error class for Memory V2
+ */
+declare class MemoryV2Error extends Error {
+    readonly code: string;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(message: string, code: string, details?: Record<string, unknown> | undefined);
 }
-declare class AgentTraceContext {
-    private rootSpan;
-    private tracer;
-    private commonAttributes;
-    private activeContext;
-    constructor(observability: VoltAgentObservability, operationName: string, options: TraceContextOptions);
-    /**
-     * Create a child span with automatic parent context and attribute inheritance
-     */
-    createChildSpan(name: string, type: "tool" | "memory" | "retriever" | "embedding" | "vector" | "agent" | "guardrail" | "middleware" | "llm" | "summary", options?: {
-        label?: string;
-        attributes?: Record<string, any>;
-        kind?: SpanKind$1;
-    }): Span;
-    /**
-     * Create a child span with a specific parent span
-     */
-    createChildSpanWithParent(parentSpan: Span, name: string, type: "tool" | "memory" | "retriever" | "embedding" | "vector" | "agent" | "guardrail" | "middleware" | "llm" | "summary", options?: {
-        label?: string;
-        attributes?: Record<string, any>;
-        kind?: SpanKind$1;
-    }): Span;
-    /**
-     * Execute a function within a span's context
-     */
-    withSpan<T>(span: Span, fn: () => T | Promise<T>): Promise<T>;
-    /**
-     * Get the root span
-     */
-    getRootSpan(): Span;
-    /**
-     * Set input on the root span
-     */
-    setInput(input: any): void;
-    /**
-     * Set output on the root span
-     */
-    setOutput(output: any): void;
-    /**
-     * Set instructions (system prompt) on the root span
-     */
-    setInstructions(instructions: any): void;
-    /**
-     * Set model attributes on the root span
-     */
-    setModelAttributes(modelName: string, temperature?: number, maxTokens?: number, topP?: number, frequencyPenalty?: number, presencePenalty?: number, maxSteps?: number): void;
-    /**
-     * Set usage information on the root span
-     */
-    setUsage(usage: {
-        promptTokens?: number;
-        completionTokens?: number;
-        totalTokens?: number;
-        cachedTokens?: number;
-        reasoningTokens?: number;
-    }): void;
-    /**
-     * Set finish reason on the root span
-     */
-    setFinishReason(finishReason: string | null | undefined): void;
-    /**
-     * Set stop condition metadata when maxSteps is reached
-     */
-    setStopConditionMet(stepCount: number, maxSteps: number): void;
-    /**
-     * End the root span with a status
-     */
-    end(status: "completed" | "error", error?: Error | any): void;
-    /**
-     * End a child span with proper status
-     */
-    endChildSpan(span: Span, status: "completed" | "error", options?: {
-        output?: any;
-        error?: Error | any;
-        attributes?: Record<string, any>;
-    }): void;
-    private resolveParentSpan;
-    /**
-     * Get the active context for manual context propagation
-     */
-    getActiveContext(): Context;
-    /**
-     * Update active context with a new span
-     */
-    updateActiveContext(span: Span): void;
+/**
+ * Error thrown when a storage operation fails
+ */
+declare class StorageError extends MemoryV2Error {
+    constructor(message: string, details?: Record<string, unknown>);
 }
-
 /**
- * Tool representation for API responses
+ * Error thrown when an embedding operation fails
  */
-interface ApiToolInfo {
-    name: string;
-    description: string;
-    parameters?: any;
+declare class EmbeddingError extends MemoryV2Error {
+    constructor(message: string, details?: Record<string, unknown>);
 }
-type AgentFeedbackOptions = {
-    key?: string;
-    feedbackConfig?: VoltOpsFeedbackConfig | null;
-    expiresAt?: Date | string;
-    expiresIn?: VoltOpsFeedbackExpiresIn;
-};
-type AgentFeedbackMetadata = {
-    traceId: string;
-    key: string;
-    url: string;
-    tokenId?: string;
-    expiresAt?: string;
-    feedbackConfig?: VoltOpsFeedbackConfig | null;
-};
 /**
- * Tool with node_id for agent state
+ * Error thrown when a vector operation fails
  */
-interface ToolWithNodeId extends BaseTool {
-    node_id: string;
+declare class VectorError extends MemoryV2Error {
+    constructor(message: string, details?: Record<string, unknown>);
 }
-interface AgentScorerState {
-    key: string;
-    id: string;
-    name: string;
-    node_id: string;
-    sampling?: SamplingPolicy;
-    metadata?: Record<string, unknown> | null;
-    params?: Record<string, unknown> | null;
+/**
+ * Error thrown when a conversation is not found
+ */
+declare class ConversationNotFoundError extends MemoryV2Error {
+    constructor(conversationId: string);
 }
 /**
- * SubAgent data structure for agent state
+ * Error thrown when trying to create a conversation that already exists
  */
-interface SubAgentStateData {
-    id: string;
-    name: string;
-    instructions?: string;
-    status: string;
-    model: string;
-    tools: ApiToolInfo[];
-    memory?: AgentMemoryState;
-    node_id: string;
-    subAgents?: SubAgentStateData[];
-    scorers?: AgentScorerState[];
-    guardrails?: AgentGuardrailStateGroup;
-    methodConfig?: {
-        method: string;
-        schema?: string;
-        options?: string[];
-    };
-    [key: string]: unknown;
+declare class ConversationAlreadyExistsError extends MemoryV2Error {
+    constructor(conversationId: string);
 }
 /**
- * Memory block representation shared across agent and sub-agent state
+ * Error thrown when vector adapter is required but not configured
  */
-interface AgentMemoryState extends Record<string, unknown> {
-    node_id: string;
-    type?: string;
-    resourceId?: string;
-    options?: MemoryOptions;
-    available?: boolean;
-    status?: string;
-    storage?: MemoryStorageMetadata;
-    workingMemory?: WorkingMemorySummary | null;
-    vectorDB?: {
-        enabled: boolean;
-        adapter?: string;
-        dimension?: number;
-        status?: string;
-        node_id?: string;
-    } | null;
-    embeddingModel?: {
-        enabled: boolean;
-        model?: string;
-        dimension?: number;
-        status?: string;
-        node_id?: string;
-    } | null;
+declare class VectorAdapterNotConfiguredError extends MemoryV2Error {
+    constructor(operation: string);
 }
 /**
- * Full state of an agent including all properties
+ * Error thrown when embedding adapter is required but not configured
  */
-interface AgentFullState {
-    id: string;
-    name: string;
-    instructions?: string;
-    status: string;
-    model: string;
-    node_id: string;
-    tools: ToolWithNodeId[];
-    subAgents: SubAgentStateData[];
-    memory: AgentMemoryState;
-    scorers?: AgentScorerState[];
-    retriever?: {
-        name: string;
-        description?: string;
-        status?: string;
-        node_id: string;
-    } | null;
-    guardrails?: AgentGuardrailStateGroup;
+declare class EmbeddingAdapterNotConfiguredError extends MemoryV2Error {
+    constructor(operation: string);
 }
+
 /**
- * Enhanced dynamic value for instructions that supports prompt management
+ * Vector math utilities for similarity calculations
  */
-type InstructionsDynamicValue = string | DynamicValue<string | PromptContent>;
 /**
- * Enhanced dynamic value for models that supports static or dynamic values
+ * Calculate cosine similarity between two vectors
+ * Returns a value between -1 and 1, where 1 means identical direction,
+ * 0 means perpendicular, and -1 means opposite direction
  */
-type ModelDynamicValue<T> = T | DynamicValue<T>;
+declare function cosineSimilarity(a: number[], b: number[]): number;
+
 /**
- * Supported model references for agents (AI SDK models or provider/model strings)
+ * Memory - Clean architecture for conversation memory and state management
  */
-type AgentModelReference = LanguageModel | ModelRouterModelId;
+
 /**
- * Model fallback configuration for agents.
+ * Memory Class
+ * Handles conversation memory with optional vector search capabilities
  */
-type AgentModelConfig = {
+declare class Memory {
+    private readonly storage;
+    private readonly embedding?;
+    private readonly vector?;
+    private embeddingCache?;
+    private readonly workingMemoryConfig?;
+    private readonly titleGenerationConfig?;
+    private resourceId?;
+    private logger?;
+    constructor(options: MemoryConfig);
+    /**
+     * Get messages from a conversation
+     */
+    getMessages(userId: string, conversationId: string, options?: GetMessagesOptions, context?: OperationContext): Promise<UIMessage<{
+        createdAt: Date;
+    }>[]>;
+    /**
+     * Save a single message
+     */
+    saveMessage(message: UIMessage, userId: string, conversationId: string): Promise<void>;
+    saveConversationSteps(steps: ConversationStepRecord[]): Promise<void>;
     /**
-     * Optional stable identifier for the model entry (useful for logging).
+     * Add a single message (alias for consistency with existing API)
      */
-    id?: string;
+    addMessage(message: UIMessage, userId: string, conversationId: string, context?: OperationContext): Promise<void>;
     /**
-     * Model reference (static or dynamic).
+     * Add multiple messages in batch
      */
-    model: ModelDynamicValue<AgentModelReference>;
+    addMessages(messages: UIMessage[], userId: string, conversationId: string, context?: OperationContext): Promise<void>;
     /**
-     * Maximum number of retries for this model before falling back.
-     * Defaults to the agent's maxRetries.
+     * Clear messages for a user
      */
-    maxRetries?: number;
+    clearMessages(userId: string, conversationId?: string, context?: OperationContext): Promise<void>;
     /**
-     * Whether this model is enabled for fallback selection.
-     * @default true
+     * Delete specific messages by ID for a conversation
+     * Adapters should delete atomically when possible; otherwise a best-effort delete may be used.
      */
-    enabled?: boolean;
-};
-/**
- * Agent model value that can be static, dynamic, or a fallback list.
- */
-type AgentModelValue = ModelDynamicValue<AgentModelReference> | AgentModelConfig[];
-/**
- * Provider options type for LLM configurations
- */
-type ProviderOptions = {
-    temperature?: number;
-    maxTokens?: number;
-    topP?: number;
-    frequencyPenalty?: number;
-    presencePenalty?: number;
-    seed?: number;
-    stopSequences?: string[];
-    extraOptions?: Record<string, unknown>;
-    onStepFinish?: (step: StepWithContent) => Promise<void>;
-    onFinish?: (result: unknown) => Promise<void>;
-    onError?: (error: unknown) => Promise<void>;
-    [key: string]: unknown;
-};
-/**
- * Configuration for supervisor agents that have subagents
- */
-/**
- * StreamEventType derived from AI SDK's TextStreamPart
- * Includes all event types from AI SDK
- */
-type StreamEventType = TextStreamPart<any>["type"];
-/**
- * Configuration for forwarding events from subagents to the parent agent's stream
- */
-type FullStreamEventForwardingConfig = {
+    deleteMessages(messageIds: string[], userId: string, conversationId: string, context?: OperationContext): Promise<void>;
+    getConversationSteps(userId: string, conversationId: string, options?: GetConversationStepsOptions): Promise<ConversationStepRecord[]>;
     /**
-     * Array of event types to forward from subagents
-     * Uses AI SDK's TextStreamPart types:
-     * - Text: 'text-start', 'text-end', 'text-delta'
-     * - Reasoning: 'reasoning-start', 'reasoning-end', 'reasoning-delta'
-     * - Tool: 'tool-input-start', 'tool-input-end', 'tool-input-delta',
-     *         'tool-call', 'tool-result', 'tool-error'
-     * - Other: 'source', 'file', 'start-step', 'finish-step',
-     *          'start', 'finish', 'abort', 'error', 'raw'
-     * @default ['tool-call', 'tool-result']
-     * @example ['tool-call', 'tool-result', 'text-delta']
+     * Get a conversation by ID
      */
-    types?: StreamEventType[];
-};
-type SupervisorConfig = {
+    getConversation(id: string): Promise<Conversation | null>;
     /**
-     * Complete custom system message for the supervisor agent
-     * If provided, this completely replaces the default template
-     * Only agents memory section will be appended if includeAgentsMemory is true
+     * Get conversations for a resource
      */
-    systemMessage?: string;
+    getConversations(resourceId: string): Promise<Conversation[]>;
     /**
-     * Whether to include agents memory in the supervisor system message
-     * @default true
+     * Get conversations by user ID with query options
      */
-    includeAgentsMemory?: boolean;
+    getConversationsByUserId(userId: string, options?: Omit<ConversationQueryOptions, "userId">): Promise<Conversation[]>;
     /**
-     * Additional custom guidelines for the supervisor agent
+     * Query conversations with advanced options
      */
-    customGuidelines?: string[];
+    queryConversations(options: ConversationQueryOptions): Promise<Conversation[]>;
     /**
-     * Configuration for forwarding events from subagents to the parent agent's full stream
-     * Controls which event types are forwarded
-     * @default { types: ['tool-call', 'tool-result'] }
+     * Count conversations with the same filtering as queryConversations (ignores limit/offset)
      */
-    fullStreamEventForwarding?: FullStreamEventForwardingConfig;
+    countConversations(options: ConversationQueryOptions): Promise<number>;
     /**
-     * Whether to throw an exception when a subagent stream encounters an error
-     * If true, stream errors will cause the handoff to throw an exception
-     * If false, errors will be captured and returned in the result
-     * @default false
+     * Create a new conversation
      */
-    throwOnStreamError?: boolean;
+    createConversation(input: CreateConversationInput): Promise<Conversation>;
     /**
-     * Whether to include error message in the result when no text content was produced
-     * Only applies when throwOnStreamError is false
-     * If true, the error message will be included in the result field
-     * If false, the result will be empty but status will still be 'error'
-     * @default true
+     * Update a conversation
      */
-    includeErrorInEmptyResponse?: boolean;
-};
-type GuardrailSeverity = "info" | "warning" | "critical";
-type GuardrailAction = "allow" | "modify" | "block";
-interface GuardrailBaseResult {
-    pass: boolean;
-    action?: GuardrailAction;
-    message?: string;
-    metadata?: Record<string, unknown>;
-}
-interface OutputGuardrailStreamArgs extends GuardrailContext {
-    part: VoltAgentTextStreamPart;
-    streamParts: VoltAgentTextStreamPart[];
-    state: Record<string, any>;
-    abort: (reason?: string) => never;
-}
-type OutputGuardrailStreamResult = VoltAgentTextStreamPart | null | undefined | Promise<VoltAgentTextStreamPart | null | undefined>;
-type OutputGuardrailStreamHandler = (args: OutputGuardrailStreamArgs) => OutputGuardrailStreamResult;
-type GuardrailFunctionMetadata = {
-    guardrailId?: string;
-    guardrailName?: string;
-    guardrailDescription?: string;
-    guardrailTags?: string[];
-    guardrailSeverity?: GuardrailSeverity;
-};
-type GuardrailFunction<TArgs, TResult> = ((args: TArgs) => TResult | Promise<TResult>) & GuardrailFunctionMetadata;
-interface GuardrailDefinition<TArgs, TResult> {
-    id?: string;
-    name?: string;
-    description?: string;
-    tags?: string[];
-    severity?: GuardrailSeverity;
-    metadata?: Record<string, unknown>;
-    handler: GuardrailFunction<TArgs, TResult>;
-}
-type GuardrailConfig<TArgs, TResult> = GuardrailFunction<TArgs, TResult> | GuardrailDefinition<TArgs, TResult>;
-interface AgentGuardrailState {
-    id?: string;
-    name: string;
-    direction: "input" | "output";
-    description?: string;
-    severity?: GuardrailSeverity;
-    tags?: string[];
-    metadata?: Record<string, unknown> | null;
-    node_id: string;
-}
-interface AgentGuardrailStateGroup {
-    input: AgentGuardrailState[];
-    output: AgentGuardrailState[];
-}
-interface GuardrailContext {
-    agent: Agent;
-    context: OperationContext;
-    operation: AgentEvalOperationType;
-}
-interface InputGuardrailArgs extends GuardrailContext {
+    updateConversation(id: string, updates: Partial<Omit<Conversation, "id" | "createdAt" | "updatedAt">>): Promise<Conversation>;
     /**
-     * The latest value after any previous guardrail modifications.
+     * Delete a conversation
      */
-    input: string | UIMessage[] | BaseMessage[];
+    deleteConversation(id: string): Promise<void>;
     /**
-     * Plain text representation of the latest input value.
+     * Get messages with semantic search
+     * Combines recent messages with semantically similar messages
      */
-    inputText: string;
+    getMessagesWithSemanticSearch(userId: string, conversationId: string, currentQuery?: string, options?: {
+        limit?: number;
+        semanticLimit?: number;
+        semanticThreshold?: number;
+        mergeStrategy?: "prepend" | "append" | "interleave";
+    }): Promise<UIMessage<{
+        createdAt: Date;
+    }>[]>;
     /**
-     * The original user provided value before any guardrail modifications.
+     * Get messages by their IDs
      */
-    originalInput: string | UIMessage[] | BaseMessage[];
+    private getMessagesByIds;
     /**
-     * Plain text representation of the original input value.
+     * Merge two arrays of messages, removing duplicates
      */
-    originalInputText: string;
-}
-interface InputGuardrailResult extends GuardrailBaseResult {
-    modifiedInput?: string | UIMessage[] | BaseMessage[];
-}
-interface OutputGuardrailArgs<TOutput = unknown> extends GuardrailContext {
+    private mergeMessages;
     /**
-     * The latest value after any previous guardrail modifications.
+     * Check if vector support is configured
      */
-    output: TOutput;
+    hasVectorSupport(): boolean;
     /**
-     * Optional plain text representation of the latest output value.
+     * Search for similar content
      */
-    outputText?: string;
+    searchSimilar(query: string, options?: SearchOptions): Promise<SearchResult[]>;
     /**
-     * The original value produced by the model before guardrail modifications.
+     * Add a document for RAG
      */
-    originalOutput: TOutput;
+    addDocument(document: Document): Promise<void>;
+    /**
+     * Remove a document
+     */
+    removeDocument(id: string): Promise<void>;
+    /**
+     * Get embedding with caching
+     */
+    private getEmbedding;
+    /**
+     * Embed and store a message
+     */
+    private embedAndStoreMessage;
+    /**
+     * Embed and store multiple messages
+     */
+    private embedAndStoreMessages;
+    /**
+     * Get working memory for a conversation or user
+     */
+    getWorkingMemory(params: {
+        conversationId?: string;
+        userId?: string;
+    }): Promise<string | null>;
+    /**
+     * Update working memory (simplified)
+     */
+    updateWorkingMemory(params: {
+        conversationId?: string;
+        userId?: string;
+        content: string | Record<string, unknown>;
+        options?: WorkingMemoryUpdateOptions;
+    }): Promise<void>;
+    /**
+     * Process content to string format
+     */
+    private processContent;
+    /**
+     * Simple deep merge for JSON objects
+     */
+    private simpleDeepMerge;
+    /**
+     * Clear working memory
+     */
+    clearWorkingMemory(params: {
+        conversationId?: string;
+        userId?: string;
+    }): Promise<void>;
+    /**
+     * Get working memory template
+     */
+    getWorkingMemoryTemplate(): string | null;
+    /**
+     * Get working memory schema
+     */
+    getWorkingMemorySchema(): z.ZodObject<any> | null;
     /**
-     * Optional plain text representation of the original output value.
+     * Get working memory format
      */
-    originalOutputText?: string;
+    getWorkingMemoryFormat(): "markdown" | "json" | null;
     /**
-     * Optional usage metrics for the generation.
+     * Check if working memory is supported
      */
-    usage?: UsageInfo;
+    hasWorkingMemorySupport(): boolean;
     /**
-     * Optional finish reason from the model/provider.
+     * Generate system instructions for working memory usage
      */
-    finishReason?: string | null;
+    getWorkingMemoryInstructions(params: {
+        conversationId?: string;
+        userId?: string;
+    }): Promise<string | null>;
     /**
-     * Optional warnings or diagnostics returned by the provider.
+     * Get configured adapters info
      */
-    warnings?: unknown[] | null;
-}
-interface OutputGuardrailResult<TOutput = unknown> extends GuardrailBaseResult {
-    modifiedOutput?: TOutput;
-}
-type InputGuardrail = GuardrailConfig<InputGuardrailArgs, InputGuardrailResult>;
-type OutputGuardrailFunction<TOutput = unknown> = GuardrailFunction<OutputGuardrailArgs<TOutput>, OutputGuardrailResult<TOutput>> & {
-    guardrailStreamHandler?: OutputGuardrailStreamHandler;
-};
-interface OutputGuardrailDefinition<TOutput = unknown> extends GuardrailDefinition<OutputGuardrailArgs<TOutput>, OutputGuardrailResult<TOutput>> {
-    streamHandler?: OutputGuardrailStreamHandler;
-}
-type OutputGuardrail<TOutput = unknown> = OutputGuardrailFunction<TOutput> | OutputGuardrailDefinition<TOutput>;
-type MiddlewareDirection = "input" | "output";
-type MiddlewareFunctionMetadata = {
-    middlewareId?: string;
-    middlewareName?: string;
-    middlewareDescription?: string;
-    middlewareTags?: string[];
-};
-type MiddlewareFunction<TArgs, TResult> = ((args: TArgs) => TResult | Promise<TResult>) & MiddlewareFunctionMetadata;
-interface MiddlewareDefinition<TArgs, TResult> {
-    id?: string;
-    name?: string;
-    description?: string;
-    tags?: string[];
-    metadata?: Record<string, unknown>;
-    handler: MiddlewareFunction<TArgs, TResult>;
-}
-interface MiddlewareContext {
-    agent: Agent;
-    context: OperationContext;
-    operation: AgentEvalOperationType;
-    retryCount: number;
-}
-interface InputMiddlewareArgs extends MiddlewareContext {
-    input: string | UIMessage[] | BaseMessage[];
-    originalInput: string | UIMessage[] | BaseMessage[];
-    abort: <TMetadata = unknown>(reason?: string, options?: MiddlewareAbortOptions<TMetadata>) => never;
-}
-type InputMiddlewareResult = string | UIMessage[] | BaseMessage[] | undefined;
-interface OutputMiddlewareArgs<TOutput = unknown> extends MiddlewareContext {
-    output: TOutput;
-    originalOutput: TOutput;
-    usage?: UsageInfo;
-    finishReason?: string | null;
-    warnings?: unknown[] | null;
-    abort: <TMetadata = unknown>(reason?: string, options?: MiddlewareAbortOptions<TMetadata>) => never;
-}
-type OutputMiddlewareResult<TOutput = unknown> = TOutput | undefined;
-type InputMiddleware = MiddlewareDefinition<InputMiddlewareArgs, InputMiddlewareResult> | MiddlewareFunction<InputMiddlewareArgs, InputMiddlewareResult>;
-type OutputMiddleware<TOutput = unknown> = MiddlewareDefinition<OutputMiddlewareArgs<TOutput>, OutputMiddlewareResult<TOutput>> | MiddlewareFunction<OutputMiddlewareArgs<TOutput>, OutputMiddlewareResult<TOutput>>;
-type AgentSummarizationOptions = {
-    enabled?: boolean;
-    triggerTokens?: number;
-    keepMessages?: number;
-    maxOutputTokens?: number;
-    systemPrompt?: string | null;
-    model?: AgentModelValue;
-};
-/**
- * Agent configuration options
- */
-type AgentOptions = {
-    id?: string;
-    name: string;
-    purpose?: string;
-    model: AgentModelValue;
-    instructions: InstructionsDynamicValue;
-    tools?: (Tool<any, any> | Toolkit | Tool$1)[] | DynamicValue<(Tool<any, any> | Toolkit)[]>;
-    toolkits?: Toolkit[];
-    memory?: Memory | false;
-    summarization?: AgentSummarizationOptions | false;
-    retriever?: BaseRetriever;
-    subAgents?: SubAgentConfig[];
-    supervisorConfig?: SupervisorConfig;
-    maxHistoryEntries?: number;
-    hooks?: AgentHooks;
-    inputGuardrails?: InputGuardrail[];
-    outputGuardrails?: OutputGuardrail<any>[];
-    inputMiddlewares?: InputMiddleware[];
-    outputMiddlewares?: OutputMiddleware<any>[];
+    getAdaptersInfo(): {
+        storage: boolean;
+        embedding: {
+            configured: boolean;
+            model?: string;
+            dimensions?: number;
+        };
+        vector: boolean;
+        cache: boolean;
+    };
     /**
-     * Default retry count for middleware-triggered retries.
-     * Per-call maxMiddlewareRetries overrides this value.
+     * Save a message to memory
+     * Simple version without event publishing (handled by MemoryManagerV2)
      */
-    maxMiddlewareRetries?: number;
-    temperature?: number;
-    maxOutputTokens?: number;
-    maxSteps?: number;
+    saveMessageWithContext(message: UIMessage, userId: string, conversationId: string, context?: {
+        logger?: Logger;
+    }, operationContext?: OperationContext): Promise<void>;
     /**
-     * Default retry count for model calls before falling back.
-     * Overridden by per-model maxRetries or per-call maxRetries.
+     * Get messages with semantic search support
+     * Simple version without event publishing (handled by MemoryManagerV2)
      */
-    maxRetries?: number;
-    feedback?: AgentFeedbackOptions | boolean;
+    getMessagesWithContext(userId: string, conversationId: string, options?: {
+        limit?: number;
+        useSemanticSearch?: boolean;
+        currentQuery?: string;
+        traceId?: string;
+        logger?: Logger;
+        semanticLimit?: number;
+        semanticThreshold?: number;
+        mergeStrategy?: "prepend" | "append" | "interleave";
+    }, operationContext?: OperationContext): Promise<UIMessage<{
+        createdAt: Date;
+    }>[]>;
     /**
-     * Default stop condition for step execution (ai-sdk `stopWhen`).
-     * Per-call `stopWhen` in method options overrides this.
+     * Internal: Set resource ID (agent ID)
      */
-    stopWhen?: StopWhen;
-    markdown?: boolean;
-    voice?: Voice;
-    logger?: Logger;
-    voltOpsClient?: VoltOpsClient;
-    observability?: VoltAgentObservability;
-    context?: ContextInput;
-    eval?: AgentEvalConfig;
-};
-type AgentEvalOperationType = "generateText" | "streamText" | "generateObject" | "streamObject" | "workflow";
-interface AgentEvalPayload {
-    operationId: string;
-    operationType: AgentEvalOperationType;
-    input?: string | null;
-    output?: string | null;
-    rawInput?: string | UIMessage[] | BaseMessage[];
-    rawOutput?: unknown;
-    userId?: string;
-    conversationId?: string;
-    traceId: string;
-    spanId: string;
-    metadata?: Record<string, unknown>;
-}
-type AgentEvalContext = AgentEvalPayload & Record<string, unknown> & {
-    agentId: string;
-    agentName: string;
-    timestamp: string;
-    rawPayload: AgentEvalPayload;
-};
-type AgentEvalParams = Record<string, unknown>;
-type AgentEvalSamplingPolicy = SamplingPolicy;
-type AgentEvalScorerFactory = () => LocalScorerDefinition<AgentEvalContext, Record<string, unknown>> | Promise<LocalScorerDefinition<AgentEvalContext, Record<string, unknown>>>;
-type AgentEvalScorerReference = LocalScorerDefinition<AgentEvalContext, Record<string, unknown>> | AgentEvalScorerFactory;
-interface AgentEvalResult {
-    scorerId: string;
-    scorerName?: string;
-    status: "success" | "error" | "skipped";
-    score?: number | null;
-    metadata?: Record<string, unknown> | null;
-    error?: unknown;
-    durationMs?: number;
-    payload: AgentEvalPayload;
-    rawPayload: AgentEvalPayload;
-}
-type AgentEvalFeedbackSaveInput = Omit<VoltOpsFeedbackCreateInput, "traceId"> & {
-    traceId?: string;
-};
-type AgentEvalFeedbackHelper = {
-    save: (input: AgentEvalFeedbackSaveInput) => Promise<VoltOpsFeedback | null>;
-};
-type AgentEvalResultCallbackArgs = AgentEvalResult & {
-    result: AgentEvalResult;
-    feedback: AgentEvalFeedbackHelper;
-};
-interface AgentEvalScorerConfig {
-    scorer: AgentEvalScorerReference;
-    params?: AgentEvalParams | ((context: AgentEvalContext) => AgentEvalParams | undefined | Promise<AgentEvalParams | undefined>);
-    sampling?: AgentEvalSamplingPolicy;
-    id?: string;
-    onResult?: (result: AgentEvalResultCallbackArgs) => void | Promise<void>;
-    buildPayload?: (context: AgentEvalContext) => Record<string, unknown> | Promise<Record<string, unknown>>;
-    buildParams?: (context: AgentEvalContext) => AgentEvalParams | undefined | Promise<AgentEvalParams | undefined>;
-}
-interface AgentEvalConfig {
-    scorers: Record<string, AgentEvalScorerConfig>;
-    triggerSource?: string;
-    environment?: string;
-    sampling?: AgentEvalSamplingPolicy;
-    redact?: (payload: AgentEvalPayload) => AgentEvalPayload;
-}
-/**
- * Agent status information
- */
-type AgentStatus = "idle" | "working" | "error" | "completed" | "cancelled";
-/**
- * Tool call definition
- */
-type ToolCall$1 = {
-    id: string;
-    type: "function";
-    function: {
-        name: string;
-        arguments: string;
-    };
-};
-/**
- * Model tool call format
- */
-type ModelToolCall = {
-    type: "tool-call";
-    toolCallId: string;
-    toolName: string;
-    args: Record<string, unknown>;
-};
-/**
- * Represents the payload used when sending a tool's result back to the chat runtime
- *  via useChat().addToolResult in the Vercel AI SDK.
- */
-type ClientSideToolResult = {
-    tool: string;
-    toolCallId: string;
-    output: unknown;
-} | {
-    tool: string;
-    toolCallId: string;
-    state: "output-error";
-    errorText: string;
-};
-/**
- * Agent response format
- */
-type AgentResponse = {
+    _setResourceId(id: string): void;
+    /**
+     * Internal: Set logger
+     */
+    _setLogger(logger: Logger): void;
     /**
-     * Response content
+     * Get vector adapter if configured
      */
-    content: string;
+    getVectorAdapter(): VectorAdapter | undefined;
     /**
-     * Tool calls made by the model (if any)
+     * Get embedding adapter if configured
      */
-    toolCalls?: ToolCall$1[];
+    getEmbeddingAdapter(): EmbeddingAdapter | undefined;
     /**
-     * Additional metadata
+     * Get metadata about the configured storage adapter
      */
-    metadata: {
-        agentId: string;
-        agentName: string;
-        [key: string]: unknown;
-    };
-};
-/**
- * Context for a specific agent operation (e.g., one generateText call)
- */
-type OperationContext = {
-    /** Unique identifier for the operation */
-    readonly operationId: string;
-    /** Optional user identifier associated with this operation */
-    userId?: string;
-    /** Optional conversation identifier associated with this operation */
-    conversationId?: string;
-    /** User-managed context map for this operation */
-    readonly context: Map<string | symbol, unknown>;
-    /** System-managed context map for internal operation tracking */
-    readonly systemContext: Map<string | symbol, unknown>;
-    /** Whether this operation is still active */
-    isActive: boolean;
-    /** Parent agent ID if part of a delegation chain */
-    parentAgentId?: string;
-    /** Optional elicitation bridge for requesting user input */
-    elicitation?: (request: unknown) => Promise<unknown>;
-    /** Trace context for managing span hierarchy and common attributes */
-    traceContext: AgentTraceContext;
-    /** Execution-scoped logger with full context (userId, conversationId, executionId) */
-    logger: Logger;
-    /** Conversation steps for building full message history including tool calls/results */
-    conversationSteps?: StepWithContent[];
-    /** AbortController for cancelling the operation and accessing the signal */
-    abortController: AbortController;
-    /** Start time of the operation (Date object) */
-    startTime: Date;
-    /** Cancellation error to be thrown when operation is aborted */
-    cancellationError?: CancellationError;
-    /** Input provided to the agent operation (string, UIMessages, or BaseMessages) */
-    input?: string | UIMessage[] | BaseMessage[];
-    /** Output generated by the agent operation (text or object) */
-    output?: string | object;
-};
-/**
- * Specific information related to a tool execution error.
- */
-interface ToolErrorInfo {
-    /** The unique identifier of the tool call. */
-    toolCallId: string;
-    /** The name of the tool that was executed. */
-    toolName: string;
-    /** The original error thrown directly by the tool during execution (if available). */
-    toolExecutionError?: unknown;
-    /** The arguments passed to the tool when the error occurred (for debugging). */
-    toolArguments?: unknown;
-}
-/**
- * Type for onError callbacks in streaming operations.
- * Providers must pass an error conforming to the VoltAgentError structure.
- */
-type StreamOnErrorCallback = (error: VoltAgentError) => Promise<void> | void;
-type UserContext = Map<string | symbol, unknown>;
-/**
- * Standardized object structure passed to the onFinish callback
- * when streamText completes successfully.
- */
-interface StreamTextFinishResult {
-    /** The final, consolidated text output from the stream. */
-    text: string;
-    /** Token usage information (if available). */
-    usage?: UsageInfo;
-    /** Feedback metadata for the trace, if enabled. */
-    feedback?: AgentFeedbackMetadata | null;
-    /** The reason the stream finished (if available, e.g., 'stop', 'length', 'tool-calls'). */
-    finishReason?: string;
-    /** The original completion response object from the provider (if available). */
-    providerResponse?: unknown;
-    /** Any warnings generated during the completion (if available). */
-    warnings?: unknown[];
-    /** User context containing any custom metadata from the operation. */
-    context?: UserContext;
-}
-/**
- * Type for the onFinish callback function for streamText.
- */
-type StreamTextOnFinishCallback = (result: StreamTextFinishResult) => Promise<void> | void;
-/**
- * Standardized object structure passed to the onFinish callback
- * when streamObject completes successfully.
- * @template TObject The expected type of the fully formed object.
- */
-interface StreamObjectFinishResult<TObject> {
-    /** The final, fully formed object from the stream. */
-    object: TObject;
-    /** Token usage information (if available). */
-    usage?: UsageInfo;
-    /** The original completion response object from the provider (if available). */
-    providerResponse?: unknown;
-    /** Any warnings generated during the completion (if available). */
-    warnings?: unknown[];
-    /** The reason the stream finished (if available). Although less common for object streams. */
-    finishReason?: string;
-    /** User context containing any custom metadata from the operation. */
-    context?: UserContext;
-}
-/**
- * Type for the onFinish callback function for streamObject.
- * @template TObject The expected type of the fully formed object.
- */
-type StreamObjectOnFinishCallback<TObject> = (result: StreamObjectFinishResult<TObject>) => Promise<void> | void;
-/**
- * Standardized success result structure for generateText.
- */
-interface StandardizedTextResult {
-    /** The generated text. */
-    text: string;
-    /** Token usage information (if available). */
-    usage?: UsageInfo;
-    /** Feedback metadata for the trace, if enabled. */
-    feedback?: AgentFeedbackMetadata | null;
-    /** Original provider response (if needed). */
-    providerResponse?: unknown;
-    /** Finish reason (if available from provider). */
-    finishReason?: string;
-    /** Warnings (if available from provider). */
-    warnings?: unknown[];
-    /** User context containing any custom metadata from the operation. */
-    context?: UserContext;
-}
-/**
- * Standardized success result structure for generateObject.
- * @template TObject The expected type of the generated object.
- */
-interface StandardizedObjectResult<TObject> {
-    /** The generated object. */
-    object: TObject;
-    /** Token usage information (if available). */
-    usage?: UsageInfo;
-    /** Original provider response (if needed). */
-    providerResponse?: unknown;
-    /** Finish reason (if available from provider). */
-    finishReason?: string;
-    /** Warnings (if available from provider). */
-    warnings?: unknown[];
-    /** User context containing any custom metadata from the operation. */
-    context?: UserContext;
+    getStorageMetadata(): MemoryStorageMetadata;
+    /**
+     * Get conversation title generation configuration
+     */
+    getTitleGenerationConfig(): MemoryConfig["generateTitle"] | undefined;
+    /**
+     * Get a UI-friendly summary of working memory configuration
+     */
+    getWorkingMemorySummary(): WorkingMemorySummary | null;
+    /**
+     * Get workflow state by execution ID
+     */
+    getWorkflowState(executionId: string): Promise<WorkflowStateEntry | null>;
+    /**
+     * Query workflow states with filters
+     */
+    queryWorkflowRuns(query: WorkflowRunQuery): Promise<WorkflowStateEntry[]>;
+    /**
+     * Set workflow state
+     */
+    setWorkflowState(executionId: string, state: WorkflowStateEntry): Promise<void>;
+    /**
+     * Update workflow state
+     */
+    updateWorkflowState(executionId: string, updates: Partial<WorkflowStateEntry>): Promise<void>;
+    /**
+     * Get suspended workflow states for a workflow
+     */
+    getSuspendedWorkflowStates(workflowId: string): Promise<WorkflowStateEntry[]>;
 }
-/**
- * Unified output type for the onEnd hook, representing the successful result
- * of any core agent operation. Use 'type guarding' or check specific fields
- * within the hook implementation to determine the concrete type.
- * Object types are generalized to 'unknown' here for the union.
- */
-type AgentOperationOutput = StandardizedTextResult | StreamTextFinishResult | StandardizedObjectResult<unknown> | StreamObjectFinishResult<unknown>;
 
 /**
  * MemoryManager - Unified manager for Memory and OpenTelemetry observability
@@ -7817,10 +8095,14 @@ declare class MemoryManager {
      * Background queue for memory operations
      */
     private backgroundQueue;
+    /**
+     * Optional title generator for new conversations
+     */
+    private titleGenerator?;
     /**
      * Creates a new MemoryManager V2 with same signature as original
      */
-    constructor(resourceId: string, memory?: Memory | false, options?: MemoryOptions, logger?: Logger);
+    constructor(resourceId: string, memory?: Memory | false, options?: MemoryOptions, logger?: Logger, titleGenerator?: ConversationTitleGenerator);
     /**
      * Save a message to memory
      * PRESERVED FROM ORIGINAL WITH MEMORY V2 INTEGRATION
@@ -7877,6 +8159,10 @@ declare class MemoryManager {
      * Ensures conversation exists and then saves input without blocking.
      */
     queueSaveInput(context: OperationContext, input: string | UIMessage[], userId: string, conversationId: string): void;
+    /**
+     * Resolve conversation title using optional generator
+     */
+    private resolveConversationTitle;
     /**
      * Ensure conversation exists (background task)
      * PRESERVED FROM ORIGINAL
@@ -8048,6 +8334,10 @@ interface BaseGenerationOptions extends Partial<CallSettings> {
      */
     stopWhen?: StopWhen;
     tools?: (Tool<any, any> | Toolkit)[];
+    /**
+     * Optional per-call tool routing override.
+     */
+    toolRouting?: ToolRoutingConfig | false;
     hooks?: AgentHooks;
     inputGuardrails?: InputGuardrail[];
     outputGuardrails?: OutputGuardrail<any>[];
@@ -8106,6 +8396,7 @@ declare class Agent {
     private readonly summarization?;
     private defaultObservability?;
     private readonly toolManager;
+    private readonly toolPoolManager;
     private readonly subAgentManager;
     private readonly voltOpsClient?;
     private readonly prompts?;
@@ -8117,6 +8408,10 @@ declare class Agent {
     private readonly outputMiddlewares;
     private readonly maxMiddlewareRetries;
     private readonly observabilityAuthWarningState;
+    private toolRouting?;
+    private toolRoutingConfigured;
+    private toolRoutingExposedNames;
+    private toolRoutingPoolExplicit;
     constructor(options: AgentOptions);
     /**
      * Generate text response
@@ -8194,6 +8489,7 @@ declare class Agent {
      * Extract user query from input for semantic search
      */
     private extractUserQuery;
+    private createConversationTitleGenerator;
     /**
      * Prepare messages with system prompt and memory
      */
@@ -8244,6 +8540,20 @@ declare class Agent {
      */
     private validateToolOutput;
     private createToolExecutionFactory;
+    /**
+     * Internal: execute a tool router with access to the agent runtime.
+     */
+    __executeToolRouter(params: {
+        router: ToolRouter;
+        input: ToolRouterInput;
+        options?: ToolExecuteOptions;
+    }): Promise<ToolRouterResult>;
+    private buildToolRouterCandidates;
+    private resolveRoutedToolArgs;
+    private resolveProviderToolArgs;
+    private executeProviderToolViaRouter;
+    private ensureToolApproval;
+    private runInternalGenerateText;
     /**
      * Create step handler for memory and hooks
      */
@@ -8343,6 +8653,14 @@ declare class Agent {
      * Internal: apply a default Memory instance when none was configured explicitly.
      */
     __setDefaultMemory(memory: Memory): void;
+    /**
+     * Internal: apply a default tool routing config when none was configured explicitly.
+     */
+    __setDefaultToolRouting(toolRouting?: ToolRoutingConfig): void;
+    private applyToolRoutingConfig;
+    private resolveToolRoutingRouters;
+    private resolveToolRouting;
+    private getToolRoutingExposedNames;
     /**
      * Convert this agent into a tool that can be used by other agents.
      * This enables supervisor/coordinator patterns where one agent can delegate
@@ -8414,6 +8732,8 @@ type WorkflowState<INPUT, RESULT> = {
     input: InternalExtractWorkflowInputData<INPUT>;
     /** current data being processed */
     data: DangerouslyAllowAny;
+    /** shared workflow state across steps */
+    workflowState: WorkflowStateStore;
     /** the result of workflow execution, null until execution is complete */
     result: RESULT | null;
     error: Error | null;
@@ -8442,6 +8762,8 @@ interface WorkflowSuspensionMetadata<SUSPEND_DATA = DangerouslyAllowAny> {
         stepExecutionState?: DangerouslyAllowAny;
         /** Results from completed steps that need to be preserved */
         completedStepsData?: DangerouslyAllowAny[];
+        /** Shared workflow state snapshot */
+        workflowState?: WorkflowStateStore;
     };
 }
 interface WorkflowCancellationMetadata {
@@ -8596,6 +8918,8 @@ interface WorkflowRetryConfig {
      */
     delayMs?: number;
 }
+type WorkflowStateStore = Record<string, unknown>;
+type WorkflowStateUpdater = WorkflowStateStore | ((previous: WorkflowStateStore) => WorkflowStateStore);
 interface WorkflowRunOptions {
     /**
      * The active step, this can be used to track the current step in a workflow
@@ -8619,6 +8943,10 @@ interface WorkflowRunOptions {
      * The user context, this can be used to track the current user context in a workflow
      */
     context?: UserContext;
+    /**
+     * Shared workflow state available to all steps
+     */
+    workflowState?: WorkflowStateStore;
     /**
      * Override Memory V2 for this specific execution
      * Takes priority over workflow config memory and global memory
@@ -8672,6 +9000,7 @@ interface WorkflowResumeOptions {
     checkpoint?: {
         stepExecutionState?: DangerouslyAllowAny;
         completedStepsData?: DangerouslyAllowAny[];
+        workflowState?: WorkflowStateStore;
     };
     /**
      * The step index to resume from
@@ -8977,11 +9306,12 @@ interface WorkflowStats {
 /**
  * Event emitted during workflow streaming
  */
+type WorkflowStreamEventType = "workflow-start" | "workflow-suspended" | "workflow-complete" | "workflow-cancelled" | "workflow-error" | "step-start" | "step-complete" | (string & {});
 interface WorkflowStreamEvent {
     /**
      * Type of the event (e.g., "step-start", "step-complete", "custom", "agent-stream")
      */
-    type: "workflow-start" | "workflow-suspended" | "workflow-complete" | "workflow-cancelled" | "workflow-error" | "step-start" | "step-complete";
+    type: WorkflowStreamEventType;
     /**
      * Unique execution ID for this workflow run
      */
@@ -9034,8 +9364,8 @@ interface WorkflowStreamWriter {
     /**
      * Write a custom event to the stream
      */
-    write(event: Partial<WorkflowStreamEvent> & {
-        type: string;
+    write(event: Omit<Partial<WorkflowStreamEvent>, "type"> & {
+        type: WorkflowStreamEventType;
     }): void;
     /**
      * Pipe events from an agent's fullStream to the workflow stream
@@ -9203,6 +9533,10 @@ interface WorkflowExecutionContext {
      * User-defined context passed around during execution
      */
     context: Map<string | symbol, unknown>;
+    /**
+     * Shared workflow state available to all steps
+     */
+    workflowState: WorkflowStateStore;
     /**
      * Whether the workflow is still actively running
      */
@@ -9304,6 +9638,8 @@ interface WorkflowExecuteContext<INPUT, DATA, SUSPEND_DATA, RESUME_DATA> {
     suspend: (reason?: string, suspendData?: SUSPEND_DATA) => Promise<never>;
     resumeData?: RESUME_DATA;
     retryCount?: number;
+    workflowState: WorkflowStateStore;
+    setWorkflowState: (update: WorkflowStateUpdater) => void;
     /**
      * Logger instance for this workflow execution.
      * Provides execution-scoped logging with full context (userId, conversationId, executionId).
@@ -9521,14 +9857,20 @@ interface WorkflowStepSleepUntil<INPUT, DATA> extends InternalBaseWorkflowStep<I
     type: "sleep-until";
     date: Date | InternalWorkflowFunc<INPUT, DATA, Date, any, any>;
 }
-type WorkflowStepForEachConfig<INPUT, ITEM, RESULT> = InternalWorkflowStepConfig<{
-    step: InternalAnyWorkflowStep<INPUT, ITEM, RESULT>;
+type WorkflowStepForEachItemsFunc<INPUT, DATA, ITEM> = InternalWorkflowFunc<INPUT, DATA, ITEM[], any, any>;
+type WorkflowStepForEachMapFunc<INPUT, DATA, ITEM, MAP_DATA> = (context: WorkflowExecuteContext<INPUT, DATA, any, any>, item: ITEM, index: number) => Promise<MAP_DATA> | MAP_DATA;
+type WorkflowStepForEachConfig<INPUT, DATA, ITEM, RESULT, MAP_DATA = ITEM> = InternalWorkflowStepConfig<{
+    step: InternalAnyWorkflowStep<INPUT, MAP_DATA, RESULT>;
     concurrency?: number;
+    items?: WorkflowStepForEachItemsFunc<INPUT, DATA, ITEM>;
+    map?: WorkflowStepForEachMapFunc<INPUT, DATA, ITEM, MAP_DATA>;
 }>;
-interface WorkflowStepForEach<INPUT, ITEM, RESULT> extends InternalBaseWorkflowStep<INPUT, ITEM[], RESULT[], any, any> {
+interface WorkflowStepForEach<INPUT, DATA, ITEM, RESULT, MAP_DATA = ITEM> extends InternalBaseWorkflowStep<INPUT, DATA, RESULT[], any, any> {
     type: "foreach";
-    step: InternalAnyWorkflowStep<INPUT, ITEM, RESULT>;
+    step: InternalAnyWorkflowStep<INPUT, MAP_DATA, RESULT>;
     concurrency?: number;
+    items?: WorkflowStepForEachItemsFunc<INPUT, DATA, ITEM>;
+    map?: WorkflowStepForEachMapFunc<INPUT, DATA, ITEM, MAP_DATA>;
 }
 type WorkflowStepLoopConfig<INPUT, DATA, RESULT> = InternalWorkflowStepConfig<{
     step: InternalAnyWorkflowStep<INPUT, DATA, RESULT>;
@@ -9595,7 +9937,7 @@ interface WorkflowStepMap<INPUT, DATA, MAP extends Record<string, WorkflowStepMa
 }
 type WorkflowStepParallelDynamicStepsFunc<INPUT, DATA, RESULT> = (context: WorkflowExecuteContext<INPUT, DATA, any, any>) => Promise<WorkflowStepParallelSteps<INPUT, DATA, RESULT>>;
 type WorkflowStepParallelSteps<INPUT, DATA, RESULT> = ReadonlyArray<InternalAnyWorkflowStep<INPUT, DATA, RESULT>>;
-type WorkflowStep<INPUT, DATA, RESULT, SUSPEND_DATA = any> = WorkflowStepAgent<INPUT, DATA, RESULT> | WorkflowStepFunc<INPUT, DATA, RESULT, SUSPEND_DATA> | WorkflowStepConditionalWhen<INPUT, DATA, RESULT> | WorkflowStepGuardrail<INPUT, DATA> | WorkflowStepParallelAll<INPUT, DATA, RESULT> | WorkflowStepTap<INPUT, DATA, RESULT, SUSPEND_DATA> | WorkflowStepParallelRace<INPUT, DATA, RESULT> | WorkflowStepWorkflow<INPUT, DATA, RESULT, SUSPEND_DATA> | WorkflowStepSleep<INPUT, DATA> | WorkflowStepSleepUntil<INPUT, DATA> | WorkflowStepForEach<INPUT, any, any> | WorkflowStepLoop<INPUT, DATA, RESULT> | WorkflowStepBranch<INPUT, DATA, RESULT> | WorkflowStepMap<INPUT, DATA, Record<string, WorkflowStepMapEntry<INPUT, DATA>>>;
+type WorkflowStep<INPUT, DATA, RESULT, SUSPEND_DATA = any> = WorkflowStepAgent<INPUT, DATA, RESULT> | WorkflowStepFunc<INPUT, DATA, RESULT, SUSPEND_DATA> | WorkflowStepConditionalWhen<INPUT, DATA, RESULT> | WorkflowStepGuardrail<INPUT, DATA> | WorkflowStepParallelAll<INPUT, DATA, RESULT> | WorkflowStepTap<INPUT, DATA, RESULT, SUSPEND_DATA> | WorkflowStepParallelRace<INPUT, DATA, RESULT> | WorkflowStepWorkflow<INPUT, DATA, RESULT, SUSPEND_DATA> | WorkflowStepSleep<INPUT, DATA> | WorkflowStepSleepUntil<INPUT, DATA> | WorkflowStepForEach<INPUT, any, any, any> | WorkflowStepLoop<INPUT, DATA, RESULT> | WorkflowStepBranch<INPUT, DATA, RESULT> | WorkflowStepMap<INPUT, DATA, Record<string, WorkflowStepMapEntry<INPUT, DATA>>>;
 /**
  * Internal type to allow overriding the run method for the workflow
  */
@@ -9874,12 +10216,15 @@ declare function andSleepUntil<INPUT, DATA>({ date, ...config }: WorkflowStepSle
 
 /**
  * Creates a foreach step that runs a step for each item in an array.
+ * Use items to select the array and map to shape each item before execution.
  */
-declare function andForEach<INPUT, ITEM, RESULT>({ step, concurrency, ...config }: WorkflowStepForEachConfig<INPUT, ITEM, RESULT>): {
+declare function andForEach<INPUT, DATA, ITEM, RESULT, MAP_DATA = ITEM>({ step, concurrency, items, map, ...config }: WorkflowStepForEachConfig<INPUT, DATA, ITEM, RESULT, MAP_DATA>): {
     type: "foreach";
-    step: InternalAnyWorkflowStep<INPUT, ITEM, RESULT>;
+    step: InternalAnyWorkflowStep<INPUT, MAP_DATA, RESULT>;
     concurrency: number;
-    execute: (context: WorkflowExecuteContext<INPUT, ITEM[], any, any>) => Promise<RESULT[]>;
+    items: WorkflowStepForEachItemsFunc<INPUT, DATA, ITEM> | undefined;
+    map: WorkflowStepForEachMapFunc<INPUT, DATA, ITEM, MAP_DATA> | undefined;
+    execute: (context: WorkflowExecuteContext<INPUT, DATA, any, any>) => Promise<RESULT[]>;
     id: string;
     name: string;
     purpose: string;
@@ -10175,6 +10520,8 @@ declare class WorkflowChain<INPUT_SCHEMA extends InternalBaseWorkflowInputSchema
         execute: (context: {
             data: z.infer<IS>;
             state: WorkflowStepState<WorkflowInput<INPUT_SCHEMA>>;
+            workflowState: WorkflowStateStore;
+            setWorkflowState: (update: WorkflowStateUpdater) => void;
             getStepData: (stepId: string) => WorkflowStepData | undefined;
             suspend: (reason?: string, suspendData?: SS extends z.ZodTypeAny ? z.infer<SS> : z.infer<SUSPEND_SCHEMA>) => Promise<never>;
             resumeData?: RS extends z.ZodTypeAny ? z.infer<RS> : z.infer<RESUME_SCHEMA>;
@@ -10200,6 +10547,8 @@ declare class WorkflowChain<INPUT_SCHEMA extends InternalBaseWorkflowInputSchema
         execute: (context: {
             data: z.infer<IS>;
             state: WorkflowStepState<WorkflowInput<INPUT_SCHEMA>>;
+            workflowState: WorkflowStateStore;
+            setWorkflowState: (update: WorkflowStateUpdater) => void;
             getStepData: (stepId: string) => WorkflowStepData | undefined;
             suspend: (reason?: string, suspendData?: SS extends z.ZodTypeAny ? z.infer<SS> : z.infer<SUSPEND_SCHEMA>) => Promise<never>;
             resumeData?: RS extends z.ZodTypeAny ? z.infer<RS> : z.infer<RESUME_SCHEMA>;
@@ -10225,6 +10574,8 @@ declare class WorkflowChain<INPUT_SCHEMA extends InternalBaseWorkflowInputSchema
         execute: (context: {
             data: CURRENT_DATA;
             state: WorkflowStepState<WorkflowInput<INPUT_SCHEMA>>;
+            workflowState: WorkflowStateStore;
+            setWorkflowState: (update: WorkflowStateUpdater) => void;
             getStepData: (stepId: string) => WorkflowStepData | undefined;
             suspend: (reason?: string, suspendData?: SS extends z.ZodTypeAny ? z.infer<SS> : z.infer<SUSPEND_SCHEMA>) => Promise<never>;
             resumeData?: RS extends z.ZodTypeAny ? z.infer<RS> : z.infer<RESUME_SCHEMA>;
@@ -10250,6 +10601,8 @@ declare class WorkflowChain<INPUT_SCHEMA extends InternalBaseWorkflowInputSchema
         execute: (context: {
             data: CURRENT_DATA;
             state: WorkflowStepState<WorkflowInput<INPUT_SCHEMA>>;
+            workflowState: WorkflowStateStore;
+            setWorkflowState: (update: WorkflowStateUpdater) => void;
             getStepData: (stepId: string) => WorkflowStepData | undefined;
             suspend: (reason?: string, suspendData?: SS extends z.ZodTypeAny ? z.infer<SS> : z.infer<SUSPEND_SCHEMA>) => Promise<never>;
             resumeData?: z.infer<RS>;
@@ -10291,6 +10644,8 @@ declare class WorkflowChain<INPUT_SCHEMA extends InternalBaseWorkflowInputSchema
         execute: (context: {
             data: CURRENT_DATA;
             state: WorkflowStepState<WorkflowInput<INPUT_SCHEMA>>;
+            workflowState: WorkflowStateStore;
+            setWorkflowState: (update: WorkflowStateUpdater) => void;
             getStepData: (stepId: string) => WorkflowStepData | undefined;
             suspend: (reason?: string, suspendData?: z.infer<SUSPEND_SCHEMA>) => Promise<never>;
             resumeData?: z.infer<RESUME_SCHEMA>;
@@ -10320,6 +10675,8 @@ declare class WorkflowChain<INPUT_SCHEMA extends InternalBaseWorkflowInputSchema
         condition: (context: {
             data: z.infer<IS>;
             state: WorkflowStepState<WorkflowInput<INPUT_SCHEMA>>;
+            workflowState: WorkflowStateStore;
+            setWorkflowState: (update: WorkflowStateUpdater) => void;
             getStepData: (stepId: string) => WorkflowStepData | undefined;
             suspend: (reason?: string, suspendData?: SS extends z.ZodTypeAny ? z.infer<SS> : z.infer<SUSPEND_SCHEMA>) => Promise<never>;
             resumeData?: RS extends z.ZodTypeAny ? z.infer<RS> : z.infer<RESUME_SCHEMA>;
@@ -10378,6 +10735,8 @@ declare class WorkflowChain<INPUT_SCHEMA extends InternalBaseWorkflowInputSchema
         execute: (context: {
             data: z.infer<IS>;
             state: WorkflowStepState<WorkflowInput<INPUT_SCHEMA>>;
+            workflowState: WorkflowStateStore;
+            setWorkflowState: (update: WorkflowStateUpdater) => void;
             getStepData: (stepId: string) => WorkflowStepData | undefined;
             suspend: (reason?: string, suspendData?: SS extends z.ZodTypeAny ? z.infer<SS> : z.infer<SUSPEND_SCHEMA>) => Promise<never>;
             resumeData?: RS extends z.ZodTypeAny ? z.infer<RS> : z.infer<RESUME_SCHEMA>;
@@ -10418,6 +10777,8 @@ declare class WorkflowChain<INPUT_SCHEMA extends InternalBaseWorkflowInputSchema
         execute: (context: {
             data: CURRENT_DATA;
             state: WorkflowStepState<WorkflowInput<INPUT_SCHEMA>>;
+            workflowState: WorkflowStateStore;
+            setWorkflowState: (update: WorkflowStateUpdater) => void;
             getStepData: (stepId: string) => WorkflowStepData | undefined;
             suspend: (reason?: string, suspendData?: z.infer<SUSPEND_SCHEMA>) => Promise<never>;
             resumeData?: z.infer<RESUME_SCHEMA>;
@@ -10452,7 +10813,7 @@ declare class WorkflowChain<INPUT_SCHEMA extends InternalBaseWorkflowInputSchema
     /**
      * Add a foreach step that runs a step for each item in an array
      */
-    andForEach<ITEM, NEW_DATA>(config: WorkflowStepForEachConfig<WorkflowInput<INPUT_SCHEMA>, ITEM, NEW_DATA>): WorkflowChain<INPUT_SCHEMA, RESULT_SCHEMA, NEW_DATA[], SUSPEND_SCHEMA, RESUME_SCHEMA>;
+    andForEach<ITEM, NEW_DATA, MAP_DATA = ITEM>(config: WorkflowStepForEachConfig<WorkflowInput<INPUT_SCHEMA>, CURRENT_DATA, ITEM, NEW_DATA, MAP_DATA>): WorkflowChain<INPUT_SCHEMA, RESULT_SCHEMA, NEW_DATA[], SUSPEND_SCHEMA, RESUME_SCHEMA>;
     /**
      * Add a do-while loop step
      */
@@ -10911,6 +11272,7 @@ type PlanAgentOptions = Omit<AgentOptions, "instructions" | "tools" | "toolkits"
     systemPrompt?: InstructionsDynamicValue;
     tools?: (Tool<any, any> | Toolkit | Tool$1)[];
     toolkits?: Toolkit[];
+    toolRouting?: ToolRoutingConfig | false;
     subagents?: PlanAgentSubagentDefinition[];
     generalPurposeAgent?: boolean;
     planning?: PlanningToolkitOptions | false;
@@ -12704,6 +13066,10 @@ type VoltAgentOptions = {
      * Falls back to `memory` when not provided.
      */
     workflowMemory?: Memory;
+    /**
+     * Global tool routing defaults (applied to agents without explicit toolRouting config).
+     */
+    toolRouting?: ToolRoutingConfig;
     /** Optional VoltOps trigger handlers */
     triggers?: VoltAgentTriggersConfig;
     /**
@@ -13569,22 +13935,22 @@ declare class InMemoryStorageAdapter implements StorageAdapter {
  * Lightweight in-memory vector database adapter
  * Suitable for development, testing, and small datasets (< 10k vectors)
  */
-declare class InMemoryVectorAdapter implements VectorAdapter {
+declare class InMemoryVectorAdapter implements VectorAdapter$1 {
     private vectors;
     private dimensions;
     constructor();
     store(id: string, vector: number[], metadata?: Record<string, unknown>): Promise<void>;
-    storeBatch(items: VectorItem[]): Promise<void>;
+    storeBatch(items: VectorItem$1[]): Promise<void>;
     search(queryVector: number[], options?: {
         limit?: number;
         filter?: Record<string, unknown>;
         threshold?: number;
-    }): Promise<SearchResult[]>;
+    }): Promise<SearchResult$1[]>;
     delete(id: string): Promise<void>;
     deleteBatch(ids: string[]): Promise<void>;
     clear(): Promise<void>;
     count(): Promise<number>;
-    get(id: string): Promise<VectorItem | null>;
+    get(id: string): Promise<VectorItem$1 | null>;
     /**
      * Check if metadata matches the filter criteria
      */
@@ -13599,56 +13965,18 @@ declare class InMemoryVectorAdapter implements VectorAdapter {
     }>;
 }
 
-/**
- * Embedding adapter interface for converting text to vectors
- */
-interface EmbeddingAdapter {
-    /**
-     * Embed a single text string into a vector
-     */
-    embed(text: string): Promise<number[]>;
-    /**
-     * Embed multiple texts in a batch for efficiency
-     */
-    embedBatch(texts: string[]): Promise<number[][]>;
-    /**
-     * Get the dimensionality of the embeddings
-     * Returns undefined if dimensions are not yet known
-     */
-    getDimensions(): number | undefined;
-    /**
-     * Get the model name for debugging/logging
-     */
-    getModelName(): string;
-}
-/**
- * Options for embedding adapter initialization
- */
-interface EmbeddingOptions {
-    /**
-     * Maximum number of texts to process in a single batch
-     */
-    maxBatchSize?: number;
-    /**
-     * Timeout for embedding operations in milliseconds
-     */
-    timeout?: number;
-    /**
-     * Whether to normalize embeddings to unit vectors
-     */
-    normalize?: boolean;
-}
-
 /**
  * AI SDK Embedding Adapter
  * Wraps Vercel AI SDK embedding models for use with Memory V2
  */
-declare class AiSdkEmbeddingAdapter implements EmbeddingAdapter {
+declare class AiSdkEmbeddingAdapter implements EmbeddingAdapter$1 {
     private model;
     private dimensions;
     private modelName;
     private options;
-    constructor(model: EmbeddingModel, options?: EmbeddingOptions);
+    private modelResolvePromise?;
+    constructor(model: EmbeddingModelReference, options?: EmbeddingOptions);
+    private resolveModel;
     embed(text: string): Promise<number[]>;
     embedBatch(texts: string[]): Promise<number[][]>;
     getDimensions(): number;
@@ -13660,8 +13988,14 @@ declare class AiSdkEmbeddingAdapter implements EmbeddingAdapter {
 }
 
 type LanguageModelFactory = (modelId: string) => LanguageModel;
+type EmbeddingModelInstance = Exclude<EmbeddingModel, string>;
+type EmbeddingModelFactory = (modelId: string) => EmbeddingModelInstance;
 type ModelProvider = {
     languageModel: LanguageModelFactory;
+    embeddingModel?: EmbeddingModelFactory;
+    embedding?: EmbeddingModelFactory;
+    textEmbeddingModel?: EmbeddingModelFactory;
+    textEmbedding?: EmbeddingModelFactory;
 };
 type ModelProviderEntry = ModelProvider | LanguageModelFactory;
 type ModelProviderLoader = () => Promise<ModelProviderEntry>;
@@ -13670,8 +14004,9 @@ declare global {
 }
 declare class ModelProviderRegistry {
     private providers;
+    private providerEntries;
     private loaders;
-    private loading;
+    private entryLoading;
     private dynamicRegistry;
     private refreshInterval;
     private lastRefreshTime;
@@ -13695,7 +14030,9 @@ declare class ModelProviderRegistry {
     unregisterProvider(providerId: string): void;
     listProviders(): string[];
     resolveLanguageModel(modelId: string): Promise<LanguageModel>;
+    resolveEmbeddingModel(modelId: string): Promise<EmbeddingModelInstance>;
     private getProvider;
+    private getProviderEntry;
     private normalizeProvider;
 }
 
@@ -14286,6 +14623,7 @@ declare class AgentRegistry {
     private globalMemory?;
     private globalAgentMemory?;
     private globalWorkflowMemory?;
+    private globalToolRouting?;
     /**
      * Track parent-child relationships between agents (child -> parents)
      */
@@ -14396,6 +14734,14 @@ declare class AgentRegistry {
      * Get the global default Memory instance for workflows.
      */
     getGlobalWorkflowMemory(): Memory | undefined;
+    /**
+     * Set the global default tool routing configuration.
+     */
+    setGlobalToolRouting(toolRouting: ToolRoutingConfig | undefined): void;
+    /**
+     * Get the global default tool routing configuration.
+     */
+    getGlobalToolRouting(): ToolRoutingConfig | undefined;
 }
 
 type UpdateOptions = {
@@ -14567,4 +14913,4 @@ declare class VoltAgent {
  */
 declare function convertUsage(usage: LanguageModelUsage | undefined): UsageInfo | undefined;
 
-export { A2AServerRegistry, AbortError, Agent, type AgentEvalConfig, type AgentEvalContext, type AgentEvalFeedbackHelper, type AgentEvalFeedbackSaveInput, type AgentEvalOperationType, type AgentEvalPayload, type AgentEvalResult, type AgentEvalResultCallbackArgs, type AgentEvalSamplingPolicy, type AgentEvalScorerConfig, type AgentEvalScorerFactory, type AgentEvalScorerReference, type AgentFeedbackMetadata, type AgentFeedbackOptions, type AgentFullState, type AgentHookOnEnd, type AgentHookOnError, type AgentHookOnFallback, type AgentHookOnHandoff, type AgentHookOnHandoffComplete, type AgentHookOnPrepareMessages, type AgentHookOnPrepareModelMessages, type AgentHookOnRetry, type AgentHookOnStart, type AgentHookOnStepFinish, type AgentHookOnToolEnd, type AgentHookOnToolStart, type AgentHooks, type AgentModelConfig, type AgentModelReference, type AgentModelValue, type AgentOptions, AgentRegistry, type AgentResponse, type AgentScorerState, type AgentStatus, type AgentSummarizationOptions, type AgentTool, AiSdkEmbeddingAdapter, type AllowedVariableValue, type ApiToolInfo, type BaseEventMetadata, type BaseGenerationOptions, type BaseLLMOptions, type BaseMessage, BaseRetriever, type BaseTool, type BaseToolCall, type BuildScorerOptions, type BuildScorerRunArgs, type BuildScorerRunResult, type BuilderAnalyzeContext, type BuilderPrepareContext, type BuilderReasonContext, type BuilderScoreContext, type CachedPrompt, type ChatMessage, ClientHTTPError, type ClientSideToolResult, type CloudflareFetchHandler, CompositeFilesystemBackend, type Conversation, ConversationAlreadyExistsError, ConversationNotFoundError, type ConversationQueryOptions, type ConversationQueryOptions as ConversationQueryOptionsV2, type ConversationStepRecord, type ConversationStepType, ConversationTodoBackend, type Conversation as ConversationV2, type CreateConversationInput, type CreateConversationInput as CreateConversationInputV2, type CreateInputGuardrailOptions, type CreateInputMiddlewareOptions, type CreateOutputGuardrailOptions, type CreateOutputMiddlewareOptions, type CreateReasoningToolsOptions, type CreateScorerOptions, DEFAULT_INSTRUCTIONS, type DataContent, type Document, type DynamicValue, type DynamicValueOptions, EDIT_FILE_TOOL_DESCRIPTION, type EditResult, type EmbeddingAdapter$1 as EmbeddingAdapter, EmbeddingAdapterNotConfiguredError, EmbeddingError, type ExtractVariableNames, FEW_SHOT_EXAMPLES, FILESYSTEM_SYSTEM_PROMPT, type FallbackStage, type FileData, type FileInfo, type FilesystemBackend, type FilesystemBackendContext, type FilesystemBackendFactory, type FilesystemToolkitOptions, GLOB_TOOL_DESCRIPTION, GREP_TOOL_DESCRIPTION, type GenerateObjectOptions, type GenerateObjectResultWithContext, type GenerateObjectSubAgentConfig, type GenerateReasonResult, type GenerateScoreResult, type GenerateScoreStep, type GenerateTextOptions, type GenerateTextResultWithContext, type GenerateTextSubAgentConfig, type GetConversationStepsOptions, type GetMessagesOptions, type GrepMatch, type GuardrailAction, type GuardrailContext, type GuardrailDefinition, type GuardrailFunction, type GuardrailSeverity, type IServerProvider, type IServerlessProvider, type VoltOpsClient$1 as IVoltOpsClient, InMemoryFilesystemBackend, InMemoryStorageAdapter$1 as InMemoryObservabilityAdapter, InMemoryStorageAdapter, InMemoryVectorAdapter, type InferGenerateObjectResponse, type InferGenerateTextResponse, type InferMessage, type InferModel, type InferProviderParams, type InferStreamResponse, type InferTool, type InputGuardrail, type InputGuardrailArgs, type InputGuardrailResult, type InputMiddleware, type InputMiddlewareArgs, type InputMiddlewareResult, type KnowledgeBaseTagFilter, type LLMProvider, LS_TOOL_DESCRIPTION, type LanguageModelFactory, LazyRemoteExportProcessor, type LocalScorerDefinition, type LocalScorerExecutionResult, LocalStorageSpanProcessor, type LogFilter, LoggerProxy, type MCPAuthorizationAction, type MCPAuthorizationConfig, type MCPAuthorizationContext, MCPAuthorizationError, type MCPCanFunction, type MCPCanParams, type MCPCanResult, MCPClient, type MCPClientCallOptions, type MCPClientConfig, MCPConfiguration, type MCPConfigurationOptions, type MCPElicitationAdapter, type MCPElicitationHandler, type MCPLoggingAdapter, type MCPPromptsAdapter, type MCPResourcesAdapter, MCPServerRegistry, type ManagedMemoryAddMessageInput, type ManagedMemoryAddMessagesInput, type ManagedMemoryClearMessagesInput, type ManagedMemoryConnectionInfo, type ManagedMemoryConversationsClient, type ManagedMemoryCredentialCreateResult, type ManagedMemoryCredentialListResult, type ManagedMemoryCredentialSummary, type ManagedMemoryDatabaseSummary, type ManagedMemoryDeleteMessagesInput, type ManagedMemoryGetMessagesInput, type ManagedMemoryMessagesClient, type ManagedMemoryQueryWorkflowRunsInput, type ManagedMemorySetWorkingMemoryInput, type ManagedMemoryStatus, type ManagedMemoryUpdateConversationInput, type ManagedMemoryVoltOpsClient, type ManagedMemoryWorkflowStateUpdateInput, type ManagedMemoryWorkflowStatesClient, type ManagedMemoryWorkingMemoryClient, type ManagedMemoryWorkingMemoryInput, Memory, type MemoryConfig, type MemoryOptions, type MemoryStorageMetadata, type MemoryUpdateMode, Memory as MemoryV2, MemoryV2Error, type MessageContent, MessageContentBuilder, type MessageRole, MiddlewareAbortError, type MiddlewareAbortOptions, type MiddlewareContext, type MiddlewareDefinition, type MiddlewareDirection, type MiddlewareFunction, type ModelForProvider, type ModelProvider, type ModelProviderEntry, type ModelProviderLoader, ModelProviderRegistry, type ModelRouterModelId, type ModelToolCall, NextAction, NodeFilesystemBackend, NodeType, VoltAgentObservability$1 as NodeVoltAgentObservability, type ObservabilityConfig, type ObservabilityLogRecord, type ObservabilitySpan, type ObservabilityStorageAdapter, type ObservabilityWebSocketEvent, type OnEndHookArgs, type OnErrorHookArgs, type OnFallbackHookArgs, type OnHandoffCompleteHookArgs, type OnHandoffHookArgs, type OnPrepareMessagesHookArgs, type OnPrepareMessagesHookResult, type OnPrepareModelMessagesHookArgs, type OnPrepareModelMessagesHookResult, type OnRetryHookArgs, type OnRetryHookArgsBase, type OnRetryLLMHookArgs, type OnRetryMiddlewareHookArgs, type OnStartHookArgs, type OnStepFinishHookArgs, type OnToolEndHookArgs, type OnToolStartHookArgs, type OperationContext, type OutputGuardrail, type OutputGuardrailArgs, type OutputGuardrailResult, type OutputMiddleware, type OutputMiddlewareArgs, type OutputMiddlewareResult, type OutputSpec$1 as OutputSpec, type PackageUpdateInfo, PlanAgent, type PlanAgentExtension, type PlanAgentExtensionContext, type PlanAgentExtensionResult, type PlanAgentFileData, type PlanAgentOptions, type PlanAgentState, type PlanAgentSubagentDefinition, type PlanAgentTodoItem, type PlanAgentTodoStatus, type PlanningToolkitOptions, type PromptApiClient, type PromptApiResponse, type PromptContent, type PromptCreator, type PromptHelper, type PromptReference, type PromptTemplate, type ProviderId, type ProviderModelsMap, type ProviderObjectResponse, type ProviderObjectStreamResponse, type ProviderParams, type ProviderResponse, type ProviderTextResponse, type ProviderTextStreamResponse, type ProviderTool, READ_FILE_TOOL_DESCRIPTION, type RagKnowledgeBaseSummary, type RagSearchKnowledgeBaseChildChunk, type RagSearchKnowledgeBaseRequest, type RagSearchKnowledgeBaseResponse, type RagSearchKnowledgeBaseResult, type ReadableStreamType, type ReasoningStep, ReasoningStepSchema, type RegisterOptions, type RegisteredTrigger, type RegisteredWorkflow, type RemoteLogExportConfig, RemoteLogProcessor, type ResumableStreamAdapter, type ResumableStreamContext, type RetrieveOptions, type Retriever, type RetrieverOptions, type RetrySource, type RunLocalScorersArgs, type RunLocalScorersResult, SERVERLESS_ENV_CONTEXT_KEY, type SamplingMetadata, type SamplingPolicy, type ScorerBuilder, type ScorerContext, type ScorerLifecycleScope, type ScorerPipelineContext, type ScorerReasonContext, type ScorerResult, 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 StreamObjectResultWithContext, type StreamObjectSubAgentConfig, type StreamPart, type StreamTextFinishResult, type StreamTextOnFinishCallback, type StreamTextOptions, type StreamTextResultWithContext, type StreamTextSubAgentConfig, type SubAgentConfig, type SubAgentMethod, type SubAgentStateData, type SupervisorConfig, TRIGGER_CONTEXT_KEY, type TaskToolOptions, type TemplateVariables, type TimelineEventCoreLevel, type TimelineEventCoreStatus, type TimelineEventCoreType, type TodoBackend, type TodoBackendFactory, Tool, type ToolCall, type ToolContext, ToolDeniedError, type ToolErrorInfo, type ToolExecuteOptions, type ToolExecutionResult, ToolManager, type ToolOptions, type ToolResultOutput, type ToolSchema, type ToolStatus, type ToolStatusInfo, type ToolWithNodeId, type Toolkit, type TriggerHandler, type TriggerHandlerBody, type TriggerHandlerContext, type TriggerHandlerResponse, type TriggerHandlerResult, type TriggerHandlerReturn, type TriggerHttpMethod, TriggerRegistry, type Usage, type UsageInfo, UserInputBridge, type UserInputHandler, type VectorAdapter, VectorAdapterNotConfiguredError, VectorError, type VectorItem, type VectorSearchOptions, type Voice, type VoiceEventData, type VoiceEventType, type VoiceMetadata, type VoiceOptions, VoltAgent, VoltAgentError, VoltAgentObservability, type VoltAgentOptions, VoltAgentRagRetriever, type VoltAgentRagRetrieverOptions, type VoltAgentStreamTextResult, type VoltAgentTextStreamPart, type VoltAgentTriggerConfig, type VoltAgentTriggersConfig, type VoltOpsActionExecutionResult, type VoltOpsActionsApi, VoltOpsActionsClient, type VoltOpsActionsTransport, type VoltOpsAirtableCreateRecordParams, type VoltOpsAirtableCredential, type VoltOpsAirtableDeleteRecordParams, type VoltOpsAirtableGetRecordParams, type VoltOpsAirtableListRecordsParams, type VoltOpsAirtableUpdateRecordParams, type VoltOpsAppendEvalRunResultPayload, type VoltOpsAppendEvalRunResultsRequest, VoltOpsClient, type VoltOpsClientOptions, type VoltOpsCompleteEvalRunRequest, type VoltOpsCreateEvalRunRequest, type VoltOpsCreateScorerRequest, type VoltOpsDiscordChannelMessageParams, type VoltOpsDiscordChannelType, type VoltOpsDiscordConfig, type VoltOpsDiscordCreateChannelParams, type VoltOpsDiscordCredential, type VoltOpsDiscordDeleteChannelParams, type VoltOpsDiscordGetChannelParams, type VoltOpsDiscordListChannelsParams, type VoltOpsDiscordListMembersParams, type VoltOpsDiscordListMessagesParams, type VoltOpsDiscordMemberRoleParams, type VoltOpsDiscordReactionParams, type VoltOpsDiscordSendMessageParams, type VoltOpsDiscordSendWebhookMessageParams, type VoltOpsDiscordUpdateChannelParams, type VoltOpsEvalResultStatus, type VoltOpsEvalRunCompletionSummaryPayload, type VoltOpsEvalRunErrorPayload, type VoltOpsEvalRunResultLiveMetadata, type VoltOpsEvalRunResultScorePayload, type VoltOpsEvalRunStatus, type VoltOpsEvalRunSummary, type VoltOpsFeedback, type VoltOpsFeedbackConfig, type VoltOpsFeedbackCreateInput, type VoltOpsFeedbackExpiresIn, type VoltOpsFeedbackToken, type VoltOpsFeedbackTokenCreateInput, VoltOpsPromptApiClient, type VoltOpsPromptManager, VoltOpsPromptManagerImpl, type VoltOpsScorerSummary, type VoltOpsSlackCredential, type VoltOpsSlackDeleteMessageParams, type VoltOpsSlackPostMessageParams, type VoltOpsSlackSearchMessagesParams, type VoltOpsTerminalEvalRunStatus, type VoltOpsTriggerDefinition, VoltOpsTriggerDefinitions, type VoltOpsTriggerEnvelope, type VoltOpsTriggerGroupMap, type VoltOpsTriggerName, VoltOpsTriggerNames, WRITE_FILE_TOOL_DESCRIPTION, WRITE_TODOS_TOOL_DESCRIPTION, WRITE_TODOS_TOOL_NAME, WebSocketEventEmitter, WebSocketLogProcessor, WebSocketSpanProcessor, type WeightedBlendComponent, type WeightedBlendOptions, type Workflow, type WorkflowConfig, type WorkflowExecutionContext, type WorkflowHookContext, type WorkflowHookStatus, type WorkflowHooks, WorkflowRegistry, type WorkflowRunQuery, type WorkflowStateEntry, type WorkflowStats, type WorkflowStepContext, type WorkflowStepData, type WorkflowStepStatus, type WorkflowStepType, type WorkflowTimelineEvent, type WorkingMemoryConfig, type WorkingMemoryScope, type WorkingMemorySummary, type WorkingMemoryUpdateOptions, type WriteResult, addTimestampToMessage, andAgent, andAll, andBranch, andDoUntil, andDoWhile, andForEach, andGuardrail, andMap, andRace, andSleep, andSleepUntil, andTap, andThen, andWhen, andWorkflow, appendToMessage, buildRetrieverLogMessage, buildSamplingMetadata, buildScorer, buildSpanTree, checkForUpdates, convertUsage, cosineSimilarity, createDefaultInputSafetyGuardrails, createDefaultPIIGuardrails, createDefaultSafetyGuardrails, createEmailRedactorGuardrail, createFilesystemToolkit, createHTMLSanitizerInputGuardrail, createHooks, createInputGuardrail, createInputLengthGuardrail, createInputMiddleware, createMaxLengthGuardrail, createNodeId, createOutputGuardrail, createOutputMiddleware, createPIIInputGuardrail, createPhoneNumberGuardrail, createPlanningToolkit, createProfanityGuardrail, createProfanityInputGuardrail, createPrompt, createPromptInjectionGuardrail, createReasoningTools, createRetrieverTool, createScorer, createSensitiveNumberGuardrail, createSimpleTemplateEngine, createSubagent, createSuspendController, createTool, createToolResultEvictor, createToolkit, createTriggers, createVoltAgentObservability, createVoltOpsClient, createWorkflow, createWorkflowChain, createWorkflowStepNodeId, VoltAgent as default, defineVoltOpsTrigger, extractFileParts, extractImageParts, extractText, extractTextParts, extractWorkflowStepInfo, filterContentParts, getContentLength, getEnvVar, getGlobalLogBuffer, getGlobalLogger, getGlobalVoltOpsClient, getNodeTypeFromNodeId, getVoltOpsTriggerDefinition, getWorkflowStepNodeType, hasContent, hasFilePart, hasImagePart, hasTextPart, isAbortError, isMiddlewareAbortError, isNodeRuntime, isServerlessRuntime, isStructuredContent, isTextContent, isVoltAgentError, mapMessageContent, messageHelpers, normalizeContent, normalizeScorerResult, normalizeToArray, prependToMessage, readableLogRecordToObservabilityLog, readableSpanToObservabilitySpan, runLocalScorers, safeJsonParse, serializeValueForDebug, setWaitUntil, shouldSample, tool, transformTextContent, updateAllPackages, updateSinglePackage, weightedBlend, zodSchemaToJsonUI };
+export { A2AServerRegistry, AbortError, Agent, type AgentEvalConfig, type AgentEvalContext, type AgentEvalFeedbackHelper, type AgentEvalFeedbackSaveInput, type AgentEvalOperationType, type AgentEvalPayload, type AgentEvalResult, type AgentEvalResultCallbackArgs, type AgentEvalSamplingPolicy, type AgentEvalScorerConfig, type AgentEvalScorerFactory, type AgentEvalScorerReference, type AgentFeedbackMetadata, type AgentFeedbackOptions, type AgentFullState, type AgentHookOnEnd, type AgentHookOnError, type AgentHookOnFallback, type AgentHookOnHandoff, type AgentHookOnHandoffComplete, type AgentHookOnPrepareMessages, type AgentHookOnPrepareModelMessages, type AgentHookOnRetry, type AgentHookOnStart, type AgentHookOnStepFinish, type AgentHookOnToolEnd, type AgentHookOnToolStart, type AgentHooks, type AgentModelConfig, type AgentModelReference, type AgentModelValue, type AgentOptions, AgentRegistry, type AgentResponse, type AgentScorerState, type AgentStatus, type AgentSummarizationOptions, type AgentTool, AiSdkEmbeddingAdapter, type AllowedVariableValue, type ApiToolInfo, type BaseEventMetadata, type BaseGenerationOptions, type BaseLLMOptions, type BaseMessage, BaseRetriever, type BaseTool, type BaseToolCall, type BuildScorerOptions, type BuildScorerRunArgs, type BuildScorerRunResult, type BuilderAnalyzeContext, type BuilderPrepareContext, type BuilderReasonContext, type BuilderScoreContext, type CachedPrompt, type ChatMessage, ClientHTTPError, type ClientSideToolResult, type CloudflareFetchHandler, CompositeFilesystemBackend, type Conversation, ConversationAlreadyExistsError, ConversationNotFoundError, type ConversationQueryOptions, type ConversationQueryOptions as ConversationQueryOptionsV2, type ConversationStepRecord, type ConversationStepType, type ConversationTitleConfig, type ConversationTitleGenerator, ConversationTodoBackend, type Conversation as ConversationV2, type CreateConversationInput, type CreateConversationInput as CreateConversationInputV2, type CreateInputGuardrailOptions, type CreateInputMiddlewareOptions, type CreateOutputGuardrailOptions, type CreateOutputMiddlewareOptions, type CreateReasoningToolsOptions, type CreateScorerOptions, DEFAULT_INSTRUCTIONS, type DataContent, type Document, type DynamicValue, type DynamicValueOptions, EDIT_FILE_TOOL_DESCRIPTION, type EditResult, type EmbeddingAdapter, type EmbeddingAdapterConfig, type EmbeddingAdapterInput, EmbeddingAdapterNotConfiguredError, EmbeddingError, type EmbeddingModelFactory, type EmbeddingModelReference, type EmbeddingRouterModelId, type ExtractVariableNames, FEW_SHOT_EXAMPLES, FILESYSTEM_SYSTEM_PROMPT, type FallbackStage, type FileData, type FileInfo, type FilesystemBackend, type FilesystemBackendContext, type FilesystemBackendFactory, type FilesystemToolkitOptions, GLOB_TOOL_DESCRIPTION, GREP_TOOL_DESCRIPTION, type GenerateObjectOptions, type GenerateObjectResultWithContext, type GenerateObjectSubAgentConfig, type GenerateReasonResult, type GenerateScoreResult, type GenerateScoreStep, type GenerateTextOptions, type GenerateTextResultWithContext, type GenerateTextSubAgentConfig, type GetConversationStepsOptions, type GetMessagesOptions, type GrepMatch, type GuardrailAction, type GuardrailContext, type GuardrailDefinition, type GuardrailFunction, type GuardrailSeverity, type IServerProvider, type IServerlessProvider, type VoltOpsClient$1 as IVoltOpsClient, InMemoryFilesystemBackend, InMemoryStorageAdapter$1 as InMemoryObservabilityAdapter, InMemoryStorageAdapter, InMemoryVectorAdapter, type InferGenerateObjectResponse, type InferGenerateTextResponse, type InferMessage, type InferModel, type InferProviderParams, type InferStreamResponse, type InferTool, type InputGuardrail, type InputGuardrailArgs, type InputGuardrailResult, type InputMiddleware, type InputMiddlewareArgs, type InputMiddlewareResult, type KnowledgeBaseTagFilter, type LLMProvider, LS_TOOL_DESCRIPTION, type LanguageModelFactory, LazyRemoteExportProcessor, type LocalScorerDefinition, type LocalScorerExecutionResult, LocalStorageSpanProcessor, type LogFilter, LoggerProxy, type MCPAuthorizationAction, type MCPAuthorizationConfig, type MCPAuthorizationContext, MCPAuthorizationError, type MCPCanFunction, type MCPCanParams, type MCPCanResult, MCPClient, type MCPClientCallOptions, type MCPClientConfig, MCPConfiguration, type MCPConfigurationOptions, type MCPElicitationAdapter, type MCPElicitationHandler, type MCPLoggingAdapter, type MCPPromptsAdapter, type MCPResourcesAdapter, MCPServerRegistry, type ManagedMemoryAddMessageInput, type ManagedMemoryAddMessagesInput, type ManagedMemoryClearMessagesInput, type ManagedMemoryConnectionInfo, type ManagedMemoryConversationsClient, type ManagedMemoryCredentialCreateResult, type ManagedMemoryCredentialListResult, type ManagedMemoryCredentialSummary, type ManagedMemoryDatabaseSummary, type ManagedMemoryDeleteMessagesInput, type ManagedMemoryGetMessagesInput, type ManagedMemoryMessagesClient, type ManagedMemoryQueryWorkflowRunsInput, type ManagedMemorySetWorkingMemoryInput, type ManagedMemoryStatus, type ManagedMemoryUpdateConversationInput, type ManagedMemoryVoltOpsClient, type ManagedMemoryWorkflowStateUpdateInput, type ManagedMemoryWorkflowStatesClient, type ManagedMemoryWorkingMemoryClient, type ManagedMemoryWorkingMemoryInput, Memory, type MemoryConfig, type MemoryOptions, type MemoryStorageMetadata, type MemoryUpdateMode, Memory as MemoryV2, MemoryV2Error, type MessageContent, MessageContentBuilder, type MessageRole, MiddlewareAbortError, type MiddlewareAbortOptions, type MiddlewareContext, type MiddlewareDefinition, type MiddlewareDirection, type MiddlewareFunction, type ModelForProvider, type ModelProvider, type ModelProviderEntry, type ModelProviderLoader, ModelProviderRegistry, type ModelRouterModelId, type ModelToolCall, NextAction, NodeFilesystemBackend, NodeType, VoltAgentObservability$1 as NodeVoltAgentObservability, type ObservabilityConfig, type ObservabilityLogRecord, type ObservabilitySpan, type ObservabilityStorageAdapter, type ObservabilityWebSocketEvent, type OnEndHookArgs, type OnErrorHookArgs, type OnFallbackHookArgs, type OnHandoffCompleteHookArgs, type OnHandoffHookArgs, type OnPrepareMessagesHookArgs, type OnPrepareMessagesHookResult, type OnPrepareModelMessagesHookArgs, type OnPrepareModelMessagesHookResult, type OnRetryHookArgs, type OnRetryHookArgsBase, type OnRetryLLMHookArgs, type OnRetryMiddlewareHookArgs, type OnStartHookArgs, type OnStepFinishHookArgs, type OnToolEndHookArgs, type OnToolEndHookResult, type OnToolStartHookArgs, type OperationContext, type OutputGuardrail, type OutputGuardrailArgs, type OutputGuardrailResult, type OutputMiddleware, type OutputMiddlewareArgs, type OutputMiddlewareResult, type OutputSpec$1 as OutputSpec, type PackageUpdateInfo, PlanAgent, type PlanAgentExtension, type PlanAgentExtensionContext, type PlanAgentExtensionResult, type PlanAgentFileData, type PlanAgentOptions, type PlanAgentState, type PlanAgentSubagentDefinition, type PlanAgentTodoItem, type PlanAgentTodoStatus, type PlanningToolkitOptions, type PromptApiClient, type PromptApiResponse, type PromptContent, type PromptCreator, type PromptHelper, type PromptReference, type PromptTemplate, type ProviderId, type ProviderModelsMap, type ProviderObjectResponse, type ProviderObjectStreamResponse, type ProviderParams, type ProviderResponse, type ProviderTextResponse, type ProviderTextStreamResponse, type ProviderTool, READ_FILE_TOOL_DESCRIPTION, type RagKnowledgeBaseSummary, type RagSearchKnowledgeBaseChildChunk, type RagSearchKnowledgeBaseRequest, type RagSearchKnowledgeBaseResponse, type RagSearchKnowledgeBaseResult, type ReadableStreamType, type ReasoningStep, ReasoningStepSchema, type RegisterOptions, type RegisteredTrigger, type RegisteredWorkflow, type RemoteLogExportConfig, RemoteLogProcessor, type ResumableStreamAdapter, type ResumableStreamContext, type RetrieveOptions, type Retriever, type RetrieverOptions, type RetrySource, type RunLocalScorersArgs, type RunLocalScorersResult, SERVERLESS_ENV_CONTEXT_KEY, type SamplingMetadata, type SamplingPolicy, type ScorerBuilder, type ScorerContext, type ScorerLifecycleScope, type ScorerPipelineContext, type ScorerReasonContext, type ScorerResult, type SearchOptions, type SearchResult$1 as 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 StreamObjectResultWithContext, type StreamObjectSubAgentConfig, type StreamPart, type StreamTextFinishResult, type StreamTextOnFinishCallback, type StreamTextOptions, type StreamTextResultWithContext, type StreamTextSubAgentConfig, type SubAgentConfig, type SubAgentMethod, type SubAgentStateData, type SupervisorConfig, TRIGGER_CONTEXT_KEY, type TaskToolOptions, type TemplateVariables, type TimelineEventCoreLevel, type TimelineEventCoreStatus, type TimelineEventCoreType, type TodoBackend, type TodoBackendFactory, Tool, type ToolArgumentResolver, type ToolCall, type ToolContext, ToolDeniedError, type ToolErrorInfo, type ToolExecuteOptions, type ToolExecutionResult, type ToolHookOnEnd, type ToolHookOnEndArgs, type ToolHookOnEndResult, type ToolHookOnStart, type ToolHookOnStartArgs, type ToolHooks, ToolManager, type ToolOptions, type ToolResultOutput, type ToolRouter, type ToolRouterCandidate, type ToolRouterContext, type ToolRouterInput, type ToolRouterMode, type ToolRouterResult, type ToolRouterResultItem, type ToolRouterSelection, type ToolRouterStrategy, type ToolRoutingConfig, type ToolRoutingEmbeddingConfig, type ToolRoutingEmbeddingInput, type ToolSchema, type ToolStatus, type ToolStatusInfo, type ToolWithNodeId, type Toolkit, type TriggerHandler, type TriggerHandlerBody, type TriggerHandlerContext, type TriggerHandlerResponse, type TriggerHandlerResult, type TriggerHandlerReturn, type TriggerHttpMethod, TriggerRegistry, type Usage, type UsageInfo, UserInputBridge, type UserInputHandler, type VectorAdapter$1 as VectorAdapter, VectorAdapterNotConfiguredError, VectorError, type VectorItem$1 as VectorItem, type VectorSearchOptions, type Voice, type VoiceEventData, type VoiceEventType, type VoiceMetadata, type VoiceOptions, VoltAgent, VoltAgentError, VoltAgentObservability, type VoltAgentOptions, VoltAgentRagRetriever, type VoltAgentRagRetrieverOptions, type VoltAgentStreamTextResult, type VoltAgentTextStreamPart, type VoltAgentTriggerConfig, type VoltAgentTriggersConfig, type VoltOpsActionExecutionResult, type VoltOpsActionsApi, VoltOpsActionsClient, type VoltOpsActionsTransport, type VoltOpsAirtableCreateRecordParams, type VoltOpsAirtableCredential, type VoltOpsAirtableDeleteRecordParams, type VoltOpsAirtableGetRecordParams, type VoltOpsAirtableListRecordsParams, type VoltOpsAirtableUpdateRecordParams, type VoltOpsAppendEvalRunResultPayload, type VoltOpsAppendEvalRunResultsRequest, VoltOpsClient, type VoltOpsClientOptions, type VoltOpsCompleteEvalRunRequest, type VoltOpsCreateEvalRunRequest, type VoltOpsCreateScorerRequest, type VoltOpsDiscordChannelMessageParams, type VoltOpsDiscordChannelType, type VoltOpsDiscordConfig, type VoltOpsDiscordCreateChannelParams, type VoltOpsDiscordCredential, type VoltOpsDiscordDeleteChannelParams, type VoltOpsDiscordGetChannelParams, type VoltOpsDiscordListChannelsParams, type VoltOpsDiscordListMembersParams, type VoltOpsDiscordListMessagesParams, type VoltOpsDiscordMemberRoleParams, type VoltOpsDiscordReactionParams, type VoltOpsDiscordSendMessageParams, type VoltOpsDiscordSendWebhookMessageParams, type VoltOpsDiscordUpdateChannelParams, type VoltOpsEvalResultStatus, type VoltOpsEvalRunCompletionSummaryPayload, type VoltOpsEvalRunErrorPayload, type VoltOpsEvalRunResultLiveMetadata, type VoltOpsEvalRunResultScorePayload, type VoltOpsEvalRunStatus, type VoltOpsEvalRunSummary, type VoltOpsFeedback, type VoltOpsFeedbackConfig, type VoltOpsFeedbackCreateInput, type VoltOpsFeedbackExpiresIn, type VoltOpsFeedbackToken, type VoltOpsFeedbackTokenCreateInput, VoltOpsPromptApiClient, type VoltOpsPromptManager, VoltOpsPromptManagerImpl, type VoltOpsScorerSummary, type VoltOpsSlackCredential, type VoltOpsSlackDeleteMessageParams, type VoltOpsSlackPostMessageParams, type VoltOpsSlackSearchMessagesParams, type VoltOpsTerminalEvalRunStatus, type VoltOpsTriggerDefinition, VoltOpsTriggerDefinitions, type VoltOpsTriggerEnvelope, type VoltOpsTriggerGroupMap, type VoltOpsTriggerName, VoltOpsTriggerNames, WRITE_FILE_TOOL_DESCRIPTION, WRITE_TODOS_TOOL_DESCRIPTION, WRITE_TODOS_TOOL_NAME, WebSocketEventEmitter, WebSocketLogProcessor, WebSocketSpanProcessor, type WeightedBlendComponent, type WeightedBlendOptions, type Workflow, type WorkflowConfig, type WorkflowExecutionContext, type WorkflowHookContext, type WorkflowHookStatus, type WorkflowHooks, WorkflowRegistry, type WorkflowRunQuery, type WorkflowStateEntry, type WorkflowStateStore, type WorkflowStateUpdater, type WorkflowStats, type WorkflowStepContext, type WorkflowStepData, type WorkflowStepStatus, type WorkflowStepType, type WorkflowTimelineEvent, type WorkingMemoryConfig, type WorkingMemoryScope, type WorkingMemorySummary, type WorkingMemoryUpdateOptions, type WriteResult, addTimestampToMessage, andAgent, andAll, andBranch, andDoUntil, andDoWhile, andForEach, andGuardrail, andMap, andRace, andSleep, andSleepUntil, andTap, andThen, andWhen, andWorkflow, appendToMessage, buildRetrieverLogMessage, buildSamplingMetadata, buildScorer, buildSpanTree, checkForUpdates, convertUsage, cosineSimilarity, createDefaultInputSafetyGuardrails, createDefaultPIIGuardrails, createDefaultSafetyGuardrails, createEmailRedactorGuardrail, createEmbeddingToolRouterStrategy, createFilesystemToolkit, createHTMLSanitizerInputGuardrail, createHooks, createInputGuardrail, createInputLengthGuardrail, createInputMiddleware, createMaxLengthGuardrail, createNodeId, createOutputGuardrail, createOutputMiddleware, createPIIInputGuardrail, createPhoneNumberGuardrail, createPlanningToolkit, createProfanityGuardrail, createProfanityInputGuardrail, createPrompt, createPromptInjectionGuardrail, createReasoningTools, createRetrieverTool, createScorer, createSensitiveNumberGuardrail, createSimpleTemplateEngine, createSubagent, createSuspendController, createTool, createToolResultEvictor, createToolRouter, createToolkit, createTriggers, createVoltAgentObservability, createVoltOpsClient, createWorkflow, createWorkflowChain, createWorkflowStepNodeId, VoltAgent as default, defineVoltOpsTrigger, extractFileParts, extractImageParts, extractText, extractTextParts, extractWorkflowStepInfo, filterContentParts, getContentLength, getEnvVar, getGlobalLogBuffer, getGlobalLogger, getGlobalVoltOpsClient, getNodeTypeFromNodeId, getVoltOpsTriggerDefinition, getWorkflowStepNodeType, hasContent, hasFilePart, hasImagePart, hasTextPart, isAbortError, isMiddlewareAbortError, isNodeRuntime, isServerlessRuntime, isStructuredContent, isTextContent, isToolRouter, isVoltAgentError, mapMessageContent, messageHelpers, normalizeContent, normalizeScorerResult, normalizeToArray, prependToMessage, readableLogRecordToObservabilityLog, readableSpanToObservabilitySpan, runLocalScorers, safeJsonParse, serializeValueForDebug, setWaitUntil, shouldSample, tool, transformTextContent, updateAllPackages, updateSinglePackage, weightedBlend, zodSchemaToJsonUI };