@voltagent/core 2.1.5 → 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,443 +1009,334 @@ 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
- */
-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>;
-    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[]>;
-    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
+ * Base interface for voice providers
  */
-interface EmbeddingAdapter$1 {
-    /**
-     * Embed a single text
-     */
-    embed(text: string): Promise<number[]>;
-    /**
-     * Embed multiple texts in batch
-     */
-    embedBatch(texts: string[]): Promise<number[][]>;
+type Voice = {
     /**
-     * Get embedding dimensions
+     * Convert text to speech
      */
-    getDimensions(): number;
+    speak(text: string | NodeJS.ReadableStream, options?: {
+        voice?: string;
+        speed?: number;
+        pitch?: number;
+    }): Promise<NodeJS.ReadableStream>;
     /**
-     * Get model name
+     * Convert speech to text
      */
-    getModelName(): string;
-}
-/**
- * Vector Adapter Interface
- * Handles vector storage and similarity search
- */
-interface VectorAdapter$1 {
+    listen(audio: NodeJS.ReadableStream, options?: {
+        language?: string;
+        model?: string;
+        stream?: boolean;
+    }): Promise<string | ReadableStreamType>;
     /**
-     * Store a single vector
+     * Connect to real-time voice service
      */
-    store(id: string, vector: number[], metadata?: Record<string, unknown>): Promise<void>;
+    connect(options?: Record<string, unknown>): Promise<void>;
     /**
-     * Store multiple vectors in batch
+     * Disconnect from real-time voice service
      */
-    storeBatch(items: VectorItem$1[]): Promise<void>;
+    disconnect(): void;
     /**
-     * Search for similar vectors
+     * Send audio data to real-time service
      */
-    search(vector: number[], options?: {
-        limit?: number;
-        filter?: Record<string, unknown>;
-        threshold?: number;
-    }): Promise<SearchResult$1[]>;
+    send(audioData: NodeJS.ReadableStream | Int16Array): Promise<void>;
     /**
-     * Delete a vector by ID
+     * Register event listener
      */
-    delete(id: string): Promise<void>;
+    on<E extends VoiceEventType>(event: E, callback: (data: VoiceEventData[E]) => void): void;
     /**
-     * Delete multiple vectors by IDs
+     * Remove event listener
      */
-    deleteBatch(ids: string[]): Promise<void>;
+    off<E extends VoiceEventType>(event: E, callback: (data: VoiceEventData[E]) => void): void;
     /**
-     * Clear all vectors
+     * Get available voices
      */
-    clear(): Promise<void>;
-}
-
-/**
- * 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);
-}
-/**
- * Error thrown when a storage operation fails
- */
-declare class StorageError extends MemoryV2Error {
-    constructor(message: string, details?: Record<string, unknown>);
-}
-/**
- * Error thrown when an embedding operation fails
- */
-declare class EmbeddingError extends MemoryV2Error {
-    constructor(message: string, details?: Record<string, unknown>);
-}
-/**
- * Error thrown when a vector operation fails
- */
-declare class VectorError extends MemoryV2Error {
-    constructor(message: string, details?: Record<string, unknown>);
-}
-/**
- * Error thrown when a conversation is not found
- */
-declare class ConversationNotFoundError extends MemoryV2Error {
-    constructor(conversationId: string);
-}
-/**
- * Error thrown when trying to create a conversation that already exists
- */
-declare class ConversationAlreadyExistsError extends MemoryV2Error {
-    constructor(conversationId: string);
-}
-/**
- * Error thrown when vector adapter is required but not configured
- */
-declare class VectorAdapterNotConfiguredError extends MemoryV2Error {
-    constructor(operation: string);
-}
-/**
- * Error thrown when embedding adapter is required but not configured
- */
-declare class EmbeddingAdapterNotConfiguredError extends MemoryV2Error {
-    constructor(operation: string);
-}
+    getVoices(): Promise<VoiceMetadata[]>;
+};
 
 /**
  * Vector adapter interface for vector storage and similarity search
  */
-interface VectorAdapter {
+interface VectorAdapter$1 {
     /**
      * Store a vector with associated metadata
      */
@@ -1221,11 +1344,11 @@ interface VectorAdapter {
     /**
      * Store multiple vectors in batch
      */
-    storeBatch(items: VectorItem[]): Promise<void>;
+    storeBatch(items: VectorItem$1[]): Promise<void>;
     /**
      * Search for similar vectors using cosine similarity
      */
-    search(vector: number[], options?: VectorSearchOptions): Promise<SearchResult[]>;
+    search(vector: number[], options?: VectorSearchOptions): Promise<SearchResult$1[]>;
     /**
      * Delete a vector by ID
      */
@@ -1245,12 +1368,12 @@ interface VectorAdapter {
     /**
      * Get a specific vector by ID
      */
-    get(id: string): Promise<VectorItem | null>;
+    get(id: string): Promise<VectorItem$1 | null>;
 }
 /**
  * Item to store in vector database
  */
-interface VectorItem {
+interface VectorItem$1 {
     /**
      * Unique identifier for the vector
      */
@@ -1288,7 +1411,7 @@ interface VectorSearchOptions {
 /**
  * Search result with similarity score
  */
-interface SearchResult extends VectorItem {
+interface SearchResult$1 extends VectorItem$1 {
     /**
      * Similarity score (0-1, higher is more similar)
      */
@@ -1300,678 +1423,511 @@ interface SearchResult extends VectorItem {
 }
 
 /**
- * Vector math utilities for similarity calculations
+ * Memory V2 Type Definitions
+ * Clean separation between conversation memory and telemetry
  */
+
 /**
- * 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
+ * Extended UIMessage type with storage metadata
  */
-declare function cosineSimilarity(a: number[], b: number[]): number;
-
+type StoredUIMessage = UIMessage & {
+    createdAt: Date;
+    userId: string;
+    conversationId: string;
+};
 /**
- * Memory - Clean architecture for conversation memory and state management
+ * Conversation type
  */
-
+type Conversation = {
+    id: string;
+    resourceId: string;
+    userId: string;
+    title: string;
+    metadata: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+};
 /**
- * Memory Class
- * Handles conversation memory with optional vector search capabilities
+ * Input type for creating a conversation
  */
-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
-     */
-    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>;
+type CreateConversationInput = {
+    id: string;
+    resourceId: string;
+    userId: string;
+    title: string;
+    metadata: Record<string, unknown>;
+};
+/**
+ * Query builder options for conversations
+ */
+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;
+}
+/**
+ * Memory options for MemoryManager
+ */
+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;
+    };
     /**
-     * Add multiple messages in batch
+     * Stream events collected during execution
+     * Used for timeline visualization in UI
      */
-    addMessages(messages: UIMessage[], userId: string, conversationId: string, context?: OperationContext): Promise<void>;
+    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;
+}
+/**
+ * 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)
+ */
+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 {
     /**
-     * Clear messages for a user
+     * Storage adapter for conversations and messages
      */
-    clearMessages(userId: string, conversationId?: string, context?: OperationContext): Promise<void>;
-    getConversationSteps(userId: string, conversationId: string, options?: GetConversationStepsOptions): Promise<ConversationStepRecord[]>;
+    storage: StorageAdapter;
     /**
-     * Get a conversation by ID
+     * Optional embedding adapter or model reference for semantic operations
      */
-    getConversation(id: string): Promise<Conversation | null>;
+    embedding?: EmbeddingAdapterInput;
     /**
-     * Get conversations for a resource
+     * Optional vector adapter for similarity search
      */
-    getConversations(resourceId: string): Promise<Conversation[]>;
+    vector?: VectorAdapter;
     /**
-     * Get conversations by user ID with query options
+     * Enable caching for embeddings
+     * @default false
      */
-    getConversationsByUserId(userId: string, options?: Omit<ConversationQueryOptions, "userId">): Promise<Conversation[]>;
+    enableCache?: boolean;
     /**
-     * Query conversations with advanced options
+     * Maximum number of embeddings to cache
+     * @default 1000
      */
-    queryConversations(options: ConversationQueryOptions): Promise<Conversation[]>;
+    cacheSize?: number;
     /**
-     * Create a new conversation
+     * Cache TTL in milliseconds
+     * @default 3600000 (1 hour)
      */
-    createConversation(input: CreateConversationInput): Promise<Conversation>;
+    cacheTTL?: number;
     /**
-     * Update a conversation
+     * Working memory configuration
+     * Enables agents to maintain important context
      */
-    updateConversation(id: string, updates: Partial<Omit<Conversation, "id" | "createdAt" | "updatedAt">>): Promise<Conversation>;
+    workingMemory?: WorkingMemoryConfig;
     /**
-     * Delete a conversation
+     * Automatically generate a title for new conversations using the agent's model
+     * (or the override model if provided).
+     * @default false
      */
-    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<{
+    generateTitle?: boolean | ConversationTitleConfig;
+}
+/**
+ * Embedding adapter config for Memory
+ */
+type EmbeddingAdapterConfig = EmbeddingOptions & {
+    model: EmbeddingModelReference;
+};
+/**
+ * Embedding input options for Memory
+ */
+type EmbeddingAdapterInput = EmbeddingAdapter | EmbeddingModelReference | EmbeddingAdapterConfig;
+/**
+ * Metadata about the underlying storage adapter
+ */
+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;
+}
+/**
+ * Document type for RAG operations
+ */
+interface Document {
+    id: string;
+    content: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Search options for semantic search
+ */
+interface SearchOptions {
+    limit?: number;
+    threshold?: number;
+    filter?: Record<string, unknown>;
+}
+/**
+ * Search result from vector operations
+ */
+interface SearchResult {
+    id: string;
+    score: number;
+    content?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Vector item for batch operations
+ */
+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;
     }>[]>;
+    clearMessages(userId: string, conversationId?: string, context?: OperationContext): Promise<void>;
     /**
-     * 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
+     * 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.
      */
-    private embedAndStoreMessages;
+    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[]>;
     /**
-     * Get working memory for a conversation or user
+     * Count conversations matching query filters (limit/offset ignored).
      */
+    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>;
-    /**
-     * 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>;
-    /**
-     * Process content to string format
-     */
-    private processContent;
-    /**
-     * Simple deep merge for JSON objects
-     */
-    private simpleDeepMerge;
-    /**
-     * Clear working memory
-     */
-    clearWorkingMemory(params: {
+    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 {
     /**
-     * Get working memory template
-     */
-    getWorkingMemoryTemplate(): string | null;
-    /**
-     * Get working memory schema
+     * Embed a single text
      */
-    getWorkingMemorySchema(): z.ZodObject<any> | null;
+    embed(text: string): Promise<number[]>;
     /**
-     * Get working memory format
+     * Embed multiple texts in batch
      */
-    getWorkingMemoryFormat(): "markdown" | "json" | null;
+    embedBatch(texts: string[]): Promise<number[][]>;
     /**
-     * Check if working memory is supported
+     * Get embedding dimensions
      */
-    hasWorkingMemorySupport(): boolean;
+    getDimensions(): number;
     /**
-     * Generate system instructions for working memory usage
+     * Get model name
      */
-    getWorkingMemoryInstructions(params: {
-        conversationId?: string;
-        userId?: string;
-    }): Promise<string | null>;
+    getModelName(): string;
+}
+/**
+ * Vector Adapter Interface
+ * Handles vector storage and similarity search
+ */
+interface VectorAdapter {
     /**
-     * Get configured adapters info
+     * Store a single vector
      */
-    getAdaptersInfo(): {
-        storage: boolean;
-        embedding: {
-            configured: boolean;
-            model?: string;
-            dimensions?: number;
-        };
-        vector: boolean;
-        cache: boolean;
-    };
+    store(id: string, vector: number[], metadata?: Record<string, unknown>): Promise<void>;
     /**
-     * Save a message to memory
-     * Simple version without event publishing (handled by MemoryManagerV2)
+     * Store multiple vectors in batch
      */
-    saveMessageWithContext(message: UIMessage, userId: string, conversationId: string, context?: {
-        logger?: Logger;
-    }, operationContext?: OperationContext): Promise<void>;
+    storeBatch(items: VectorItem[]): Promise<void>;
     /**
-     * Get messages with semantic search support
-     * Simple version without event publishing (handled by MemoryManagerV2)
+     * Search for similar vectors
      */
-    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;
+        filter?: Record<string, unknown>;
+        threshold?: number;
+    }): Promise<SearchResult[]>;
     /**
-     * Get a UI-friendly summary of working memory configuration
+     * Delete a vector by ID
      */
-    getWorkingMemorySummary(): WorkingMemorySummary | null;
+    delete(id: string): Promise<void>;
     /**
-     * Get workflow state by execution ID
+     * Delete multiple vectors by IDs
      */
-    getWorkflowState(executionId: string): Promise<WorkflowStateEntry | null>;
+    deleteBatch(ids: string[]): Promise<void>;
     /**
-     * Query workflow states with filters
+     * Clear all vectors
      */
-    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[]>;
+    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
-     */
-    userId?: string;
-    /**
-     * Optional conversation identifier for conversation-aware retrieval.
-     * Can be used to retrieve conversation-specific context or history.
+     * @example
+     * ```typescript
+     * publicKey: process.env.VOLTAGENT_PUBLIC_KEY
+     * ```
      *
-     * 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
+     *
+     * @obtain Get your API keys from: https://console.voltagent.dev/settings/projects
      */
-    protected logger: Logger;
+    publicKey?: string;
     /**
-     * Ready-to-use tool property for direct destructuring
-     * This can be used with object destructuring syntax
+     * 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
-     * // ✅ 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
-     */
-    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) */
-    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
+     *
+     * @obtain Get your API keys from: https://console.voltagent.dev/settings/projects
      */
     secretKey?: string;
     /** Custom fetch implementation (optional) */
@@ -2842,6 +2798,11 @@ interface ManagedMemoryClearMessagesInput {
     userId: string;
     conversationId?: string;
 }
+interface ManagedMemoryDeleteMessagesInput {
+    conversationId: string;
+    userId: string;
+    messageIds: string[];
+}
 interface ManagedMemoryGetConversationStepsInput {
     conversationId: string;
     userId: string;
@@ -2894,6 +2855,7 @@ interface ManagedMemoryMessagesClient {
     addBatch(databaseId: string, input: ManagedMemoryAddMessagesInput): Promise<void>;
     list(databaseId: string, input: ManagedMemoryGetMessagesInput): Promise<UIMessage[]>;
     clear(databaseId: string, input: ManagedMemoryClearMessagesInput): Promise<void>;
+    delete(databaseId: string, input: ManagedMemoryDeleteMessagesInput): Promise<void>;
 }
 interface ManagedMemoryConversationsClient {
     create(databaseId: string, input: CreateConversationInput): Promise<Conversation>;
@@ -2922,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>;
@@ -3161,6 +3123,7 @@ declare class VoltOpsClient implements VoltOpsClient$1 {
     private addManagedMemoryMessages;
     private getManagedMemoryMessages;
     private clearManagedMemoryMessages;
+    private deleteManagedMemoryMessages;
     private storeManagedMemoryVector;
     private storeManagedMemoryVectors;
     private searchManagedMemoryVectors;
@@ -6833,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[];
@@ -6917,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;
@@ -7061,6 +7027,11 @@ interface ApiToolInfo {
     description: string;
     parameters?: any;
 }
+interface AgentToolRoutingState {
+    routers?: ApiToolInfo[];
+    expose?: ApiToolInfo[];
+    pool?: ApiToolInfo[];
+}
 type AgentFeedbackOptions = {
     key?: string;
     feedbackConfig?: VoltOpsFeedbackConfig | null;
@@ -7078,9 +7049,9 @@ type AgentFeedbackMetadata = {
 /**
  * Tool with node_id for agent state
  */
-interface ToolWithNodeId extends BaseTool {
+type ToolWithNodeId = (BaseTool | ProviderTool) & {
     node_id: string;
-}
+};
 interface AgentScorerState {
     key: string;
     id: string;
@@ -7150,6 +7121,7 @@ interface AgentFullState {
     model: string;
     node_id: string;
     tools: ToolWithNodeId[];
+    toolRouting?: AgentToolRoutingState;
     subAgents: SubAgentStateData[];
     memory: AgentMemoryState;
     scorers?: AgentScorerState[];
@@ -7454,6 +7426,7 @@ type AgentOptions = {
     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;
@@ -7492,7 +7465,7 @@ type AgentOptions = {
     context?: ContextInput;
     eval?: AgentEvalConfig;
 };
-type AgentEvalOperationType = "generateText" | "streamText" | "generateObject" | "streamObject" | "workflow";
+type AgentEvalOperationType = "generateText" | "generateTitle" | "streamText" | "generateObject" | "streamObject" | "workflow";
 interface AgentEvalPayload {
     operationId: string;
     operationType: AgentEvalOperationType;
@@ -7596,170 +7569,501 @@ type ClientSideToolResult = {
  */
 type AgentResponse = {
     /**
-     * Response content
+     * 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);
+}
+/**
+ * Error thrown when a storage operation fails
+ */
+declare class StorageError extends MemoryV2Error {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/**
+ * Error thrown when an embedding operation fails
+ */
+declare class EmbeddingError extends MemoryV2Error {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/**
+ * Error thrown when a vector operation fails
+ */
+declare class VectorError extends MemoryV2Error {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/**
+ * Error thrown when a conversation is not found
+ */
+declare class ConversationNotFoundError extends MemoryV2Error {
+    constructor(conversationId: string);
+}
+/**
+ * Error thrown when trying to create a conversation that already exists
+ */
+declare class ConversationAlreadyExistsError extends MemoryV2Error {
+    constructor(conversationId: string);
+}
+/**
+ * Error thrown when vector adapter is required but not configured
+ */
+declare class VectorAdapterNotConfiguredError extends MemoryV2Error {
+    constructor(operation: string);
+}
+/**
+ * Error thrown when embedding adapter is required but not configured
+ */
+declare class EmbeddingAdapterNotConfiguredError extends MemoryV2Error {
+    constructor(operation: string);
+}
+
+/**
+ * Vector math utilities for similarity calculations
+ */
+/**
+ * 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
+ */
+declare function cosineSimilarity(a: number[], b: number[]): number;
+
+/**
+ * Memory - Clean architecture for conversation memory and state management
+ */
+
+/**
+ * Memory Class
+ * Handles conversation memory with optional vector search capabilities
+ */
+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>;
+    /**
+     * 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.
+     */
+    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
+     */
+    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)
+     */
+    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[]>;
+    /**
+     * 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
+     */
+    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;
+    /**
+     * Get working memory format
+     */
+    getWorkingMemoryFormat(): "markdown" | "json" | null;
+    /**
+     * Check if working memory is supported
+     */
+    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?: {
+        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 | undefined;
+    /**
+     * Get embedding adapter if configured
      */
-    content: string;
+    getEmbeddingAdapter(): EmbeddingAdapter | undefined;
     /**
-     * Tool calls made by the model (if any)
+     * Get metadata about the configured storage adapter
      */
-    toolCalls?: ToolCall$1[];
+    getStorageMetadata(): MemoryStorageMetadata;
     /**
-     * Additional metadata
+     * Get conversation title generation configuration
      */
-    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;
+    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
@@ -7791,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
@@ -7851,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
@@ -8022,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>[];
@@ -8080,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?;
@@ -8091,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
@@ -8168,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
      */
@@ -8218,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
      */
@@ -8317,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
@@ -8388,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;
@@ -8416,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 {
@@ -8570,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
@@ -8593,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
@@ -8646,6 +9000,7 @@ interface WorkflowResumeOptions {
     checkpoint?: {
         stepExecutionState?: DangerouslyAllowAny;
         completedStepsData?: DangerouslyAllowAny[];
+        workflowState?: WorkflowStateStore;
     };
     /**
      * The step index to resume from
@@ -8951,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
      */
@@ -9008,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
@@ -9177,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
      */
@@ -9278,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).
@@ -9495,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>;
@@ -9569,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
  */
@@ -9848,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;
@@ -10149,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>;
@@ -10174,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>;
@@ -10199,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>;
@@ -10224,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>;
@@ -10265,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>;
@@ -10294,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>;
@@ -10352,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>;
@@ -10392,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>;
@@ -10426,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
      */
@@ -10885,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;
@@ -12678,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;
     /**
@@ -13431,6 +13823,10 @@ declare class InMemoryStorageAdapter implements StorageAdapter {
     }>[]>;
     saveConversationSteps(steps: ConversationStepRecord[]): Promise<void>;
     getConversationSteps(userId: string, conversationId: string, options?: GetConversationStepsOptions): Promise<ConversationStepRecord[]>;
+    /**
+     * Delete specific messages by ID for a conversation
+     */
+    deleteMessages(messageIds: string[], userId: string, conversationId: string, _context?: OperationContext): Promise<void>;
     /**
      * Clear messages for a user
      */
@@ -13455,6 +13851,10 @@ declare class InMemoryStorageAdapter implements StorageAdapter {
      * Query conversations with advanced options
      */
     queryConversations(options: ConversationQueryOptions): Promise<Conversation[]>;
+    /**
+     * Count conversations matching query filters
+     */
+    countConversations(options: ConversationQueryOptions): Promise<number>;
     /**
      * Update a conversation
      */
@@ -13535,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
      */
@@ -13565,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;
@@ -13626,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>;
@@ -13636,8 +14004,9 @@ declare global {
 }
 declare class ModelProviderRegistry {
     private providers;
+    private providerEntries;
     private loaders;
-    private loading;
+    private entryLoading;
     private dynamicRegistry;
     private refreshInterval;
     private lastRefreshTime;
@@ -13661,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;
 }
 
@@ -14252,6 +14623,7 @@ declare class AgentRegistry {
     private globalMemory?;
     private globalAgentMemory?;
     private globalWorkflowMemory?;
+    private globalToolRouting?;
     /**
      * Track parent-child relationships between agents (child -> parents)
      */
@@ -14362,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 = {
@@ -14533,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 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 };