@voltagent/core 1.5.2 → 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.mts CHANGED
@@ -1,6 +1,6 @@
1
- import { ToolCallOptions, ProviderOptions as ProviderOptions$1, ModelMessage, DataContent as DataContent$1, UserContent, AssistantContent, ToolContent } from '@ai-sdk/provider-utils';
1
+ import { ToolExecutionOptions, ToolNeedsApprovalFunction, ProviderOptions as ProviderOptions$1, ModelMessage, DataContent as DataContent$1, UserContent, AssistantContent, ToolContent } from '@ai-sdk/provider-utils';
2
2
  export { AssistantContent, FilePart, ImagePart, ProviderOptions, TextPart, ToolContent, UserContent } from '@ai-sdk/provider-utils';
3
- import { Tool as Tool$1, TextStreamPart, generateText, UIMessage, StreamTextResult, LanguageModel, CallSettings, Output, ToolSet, GenerateTextResult, GenerateObjectResult, AsyncIterableStream as AsyncIterableStream$1, CallWarning, LanguageModelUsage, FinishReason, EmbeddingModel, TextUIPart, FileUIPart } from 'ai';
3
+ import { Tool as Tool$1, TextStreamPart, generateText, UIMessage, Output, StreamTextResult, LanguageModel, CallSettings, ToolChoice, ToolSet, GenerateTextResult, GenerateObjectResult, AsyncIterableStream as AsyncIterableStream$1, Warning, LanguageModelUsage, FinishReason, EmbeddingModel, TextUIPart, FileUIPart } from 'ai';
4
4
  export { LanguageModel, Tool as VercelTool, hasToolCall, stepCountIs } from 'ai';
5
5
  import * as zod from 'zod';
6
6
  import { z } from 'zod';
@@ -126,6 +126,7 @@ declare abstract class BaseToolManager<TItems extends AgentTool | Tool$1 | Toolk
126
126
  * Check if any tool with the given name exists in this manager or nested toolkits.
127
127
  */
128
128
  hasToolInAny(toolName: string): boolean;
129
+ private getToolkitManagers;
129
130
  }
130
131
 
131
132
  declare class ToolkitManager extends BaseToolManager<AgentTool | Tool$1, never> {
@@ -191,7 +192,7 @@ declare class ToolManager extends BaseToolManager<AgentTool | Tool$1 | Toolkit,
191
192
  * @returns true if the toolkit was successfully added or replaced.
192
193
  */
193
194
  addToolkit(toolkit: Toolkit): boolean;
194
- prepareToolsForExecution(createToolExecuteFunction: (tool: AgentTool) => (args: any, options?: ToolCallOptions) => Promise<any>): Record<string, any>;
195
+ prepareToolsForExecution(createToolExecuteFunction: (tool: AgentTool) => (args: any, options?: ToolExecutionOptions) => Promise<any>): Record<string, any>;
195
196
  /**
196
197
  * Get agent's tools (including those in toolkits) for API exposure.
197
198
  */
@@ -257,9 +258,13 @@ type AgentTool = BaseTool;
257
258
  /**
258
259
  * Block access to user-defined and dynamic tools by requiring provider-defined type
259
260
  * */
260
- type ProviderTool = Extract<Tool$1, {
261
- type: "provider-defined";
262
- }>;
261
+ type ProviderTool = Tool$1 & {
262
+ type: "provider";
263
+ id: `${string}.${string}`;
264
+ args: Record<string, unknown>;
265
+ supportsDeferredResults?: boolean;
266
+ name: string;
267
+ };
263
268
  /**
264
269
  * Tool options for creating a new tool
265
270
  */
@@ -288,6 +293,11 @@ type ToolOptions<T extends ToolSchema = ToolSchema, O extends ToolSchema | undef
288
293
  * Optional user-defined tags for organizing or labeling tools.
289
294
  */
290
295
  tags?: string[];
296
+ /**
297
+ * Whether the tool requires approval before execution.
298
+ * When set to a function, it can decide dynamically per call.
299
+ */
300
+ needsApproval?: boolean | ToolNeedsApprovalFunction<z.infer<T>>;
291
301
  /**
292
302
  * Provider-specific options for the tool.
293
303
  * Enables provider-specific functionality like cache control.
@@ -312,16 +322,18 @@ type ToolOptions<T extends ToolSchema = ToolSchema, O extends ToolSchema | undef
312
322
  * @example
313
323
  * ```typescript
314
324
  * // Return image + text
315
- * toModelOutput: (result) => ({
325
+ * toModelOutput: ({ output }) => ({
316
326
  * type: 'content',
317
327
  * value: [
318
328
  * { type: 'text', text: 'Screenshot taken' },
319
- * { type: 'media', data: result.base64Image, mediaType: 'image/png' }
329
+ * { type: 'media', data: output.base64Image, mediaType: 'image/png' }
320
330
  * ]
321
331
  * })
322
332
  * ```
323
333
  */
324
- toModelOutput?: (output: O extends ToolSchema ? z.infer<O> : unknown) => ToolResultOutput;
334
+ toModelOutput?: (args: {
335
+ output: O extends ToolSchema ? z.infer<O> : unknown;
336
+ }) => ToolResultOutput;
325
337
  /**
326
338
  * Function to execute when the tool is called.
327
339
  * @param args - The arguments passed to the tool
@@ -357,6 +369,10 @@ declare class Tool<T extends ToolSchema = ToolSchema, O extends ToolSchema | und
357
369
  * Optional user-defined tags for organizing or labeling tools.
358
370
  */
359
371
  readonly tags?: string[];
372
+ /**
373
+ * Whether the tool requires approval before execution.
374
+ */
375
+ readonly needsApproval?: boolean | ToolNeedsApprovalFunction<z.infer<T>>;
360
376
  /**
361
377
  * Provider-specific options for the tool.
362
378
  * Enables provider-specific functionality like cache control.
@@ -366,7 +382,9 @@ declare class Tool<T extends ToolSchema = ToolSchema, O extends ToolSchema | und
366
382
  * Optional function to convert tool output to multi-modal content.
367
383
  * Enables returning images, media, or structured content to the LLM.
368
384
  */
369
- readonly toModelOutput?: (output: O extends ToolSchema ? z.infer<O> : unknown) => ToolResultOutput;
385
+ readonly toModelOutput?: (args: {
386
+ output: O extends ToolSchema ? z.infer<O> : unknown;
387
+ }) => ToolResultOutput;
370
388
  /**
371
389
  * Internal discriminator to make runtime/type checks simpler across module boundaries.
372
390
  * Marking our Tool instances with a stable string avoids instanceof issues.
@@ -3306,14 +3324,15 @@ type VoltAgentTextStreamPart<TOOLS extends Record<string, any> = Record<string,
3306
3324
  */
3307
3325
  agentPath?: string[];
3308
3326
  };
3327
+ type OutputSpec$1 = ReturnType<typeof Output.text> | ReturnType<typeof Output.object> | ReturnType<typeof Output.array> | ReturnType<typeof Output.choice> | ReturnType<typeof Output.json>;
3309
3328
  /**
3310
3329
  * Extended StreamTextResult that uses VoltAgentTextStreamPart for fullStream.
3311
3330
  * This maintains compatibility with ai-sdk while adding subagent metadata support.
3312
3331
  *
3313
3332
  * @template TOOLS - The tool set type parameter
3314
- * @template PARTIAL_OUTPUT - The partial output type parameter
3333
+ * @template OUTPUT - The output spec type parameter
3315
3334
  */
3316
- interface VoltAgentStreamTextResult<TOOLS extends Record<string, any> = Record<string, any>, PARTIAL_OUTPUT = any> extends Omit<StreamTextResult<TOOLS, PARTIAL_OUTPUT>, "fullStream"> {
3335
+ interface VoltAgentStreamTextResult<TOOLS extends Record<string, any> = Record<string, any>, OUTPUT extends OutputSpec$1 = OutputSpec$1> extends Omit<StreamTextResult<TOOLS, OUTPUT>, "fullStream"> {
3317
3336
  /**
3318
3337
  * Full stream with subagent metadata support
3319
3338
  */
@@ -4486,7 +4505,7 @@ declare class AgentTraceContext {
4486
4505
  /**
4487
4506
  * Create a child span with automatic parent context and attribute inheritance
4488
4507
  */
4489
- createChildSpan(name: string, type: "tool" | "memory" | "retriever" | "embedding" | "vector" | "agent" | "guardrail" | "llm", options?: {
4508
+ createChildSpan(name: string, type: "tool" | "memory" | "retriever" | "embedding" | "vector" | "agent" | "guardrail" | "llm" | "summary", options?: {
4490
4509
  label?: string;
4491
4510
  attributes?: Record<string, any>;
4492
4511
  kind?: SpanKind$1;
@@ -4494,7 +4513,7 @@ declare class AgentTraceContext {
4494
4513
  /**
4495
4514
  * Create a child span with a specific parent span
4496
4515
  */
4497
- createChildSpanWithParent(parentSpan: Span, name: string, type: "tool" | "memory" | "retriever" | "embedding" | "vector" | "agent" | "guardrail" | "llm", options?: {
4516
+ createChildSpanWithParent(parentSpan: Span, name: string, type: "tool" | "memory" | "retriever" | "embedding" | "vector" | "agent" | "guardrail" | "llm" | "summary", options?: {
4498
4517
  label?: string;
4499
4518
  attributes?: Record<string, any>;
4500
4519
  kind?: SpanKind$1;
@@ -4858,6 +4877,14 @@ interface OutputGuardrailDefinition<TOutput = unknown> extends GuardrailDefiniti
4858
4877
  streamHandler?: OutputGuardrailStreamHandler;
4859
4878
  }
4860
4879
  type OutputGuardrail<TOutput = unknown> = OutputGuardrailFunction<TOutput> | OutputGuardrailDefinition<TOutput>;
4880
+ type AgentSummarizationOptions = {
4881
+ enabled?: boolean;
4882
+ triggerTokens?: number;
4883
+ keepMessages?: number;
4884
+ maxOutputTokens?: number;
4885
+ systemPrompt?: string | null;
4886
+ model?: LanguageModel | DynamicValue<LanguageModel>;
4887
+ };
4861
4888
  /**
4862
4889
  * Agent configuration options
4863
4890
  */
@@ -4870,6 +4897,7 @@ type AgentOptions = {
4870
4897
  tools?: (Tool<any, any> | Toolkit | Tool$1)[] | DynamicValue<(Tool<any, any> | Toolkit)[]>;
4871
4898
  toolkits?: Toolkit[];
4872
4899
  memory?: Memory | false;
4900
+ summarization?: AgentSummarizationOptions | false;
4873
4901
  retriever?: BaseRetriever;
4874
4902
  subAgents?: SubAgentConfig[];
4875
4903
  supervisorConfig?: SupervisorConfig;
@@ -5315,6 +5343,7 @@ declare class MemoryManager {
5315
5343
  shutdown(): Promise<void>;
5316
5344
  }
5317
5345
 
5346
+ type OutputSpec = ReturnType<typeof Output.text> | ReturnType<typeof Output.object> | ReturnType<typeof Output.array> | ReturnType<typeof Output.choice> | ReturnType<typeof Output.json>;
5318
5347
  /**
5319
5348
  * Context input type that accepts both Map and plain object
5320
5349
  */
@@ -5325,18 +5354,18 @@ type ContextInput = Map<string | symbol, unknown> | Record<string | symbol, unkn
5325
5354
  /**
5326
5355
  * Extended StreamTextResult that includes context
5327
5356
  */
5328
- interface StreamTextResultWithContext<TOOLS extends ToolSet = Record<string, any>, PARTIAL_OUTPUT = any> {
5329
- readonly text: StreamTextResult<TOOLS, PARTIAL_OUTPUT>["text"];
5330
- readonly textStream: StreamTextResult<TOOLS, PARTIAL_OUTPUT>["textStream"];
5357
+ interface StreamTextResultWithContext<TOOLS extends ToolSet = Record<string, any>, OUTPUT extends OutputSpec = OutputSpec> {
5358
+ readonly text: StreamTextResult<TOOLS, OUTPUT>["text"];
5359
+ readonly textStream: StreamTextResult<TOOLS, OUTPUT>["textStream"];
5331
5360
  readonly fullStream: AsyncIterable<VoltAgentTextStreamPart<TOOLS>>;
5332
- readonly usage: StreamTextResult<TOOLS, PARTIAL_OUTPUT>["usage"];
5333
- readonly finishReason: StreamTextResult<TOOLS, PARTIAL_OUTPUT>["finishReason"];
5334
- readonly experimental_partialOutputStream?: StreamTextResult<TOOLS, PARTIAL_OUTPUT>["experimental_partialOutputStream"];
5335
- toUIMessageStream: StreamTextResult<TOOLS, PARTIAL_OUTPUT>["toUIMessageStream"];
5336
- toUIMessageStreamResponse: StreamTextResult<TOOLS, PARTIAL_OUTPUT>["toUIMessageStreamResponse"];
5337
- pipeUIMessageStreamToResponse: StreamTextResult<TOOLS, PARTIAL_OUTPUT>["pipeUIMessageStreamToResponse"];
5338
- pipeTextStreamToResponse: StreamTextResult<TOOLS, PARTIAL_OUTPUT>["pipeTextStreamToResponse"];
5339
- toTextStreamResponse: StreamTextResult<TOOLS, PARTIAL_OUTPUT>["toTextStreamResponse"];
5361
+ readonly usage: StreamTextResult<TOOLS, OUTPUT>["usage"];
5362
+ readonly finishReason: StreamTextResult<TOOLS, OUTPUT>["finishReason"];
5363
+ readonly partialOutputStream?: StreamTextResult<TOOLS, OUTPUT>["partialOutputStream"];
5364
+ toUIMessageStream: StreamTextResult<TOOLS, OUTPUT>["toUIMessageStream"];
5365
+ toUIMessageStreamResponse: StreamTextResult<TOOLS, OUTPUT>["toUIMessageStreamResponse"];
5366
+ pipeUIMessageStreamToResponse: StreamTextResult<TOOLS, OUTPUT>["pipeUIMessageStreamToResponse"];
5367
+ pipeTextStreamToResponse: StreamTextResult<TOOLS, OUTPUT>["pipeTextStreamToResponse"];
5368
+ toTextStreamResponse: StreamTextResult<TOOLS, OUTPUT>["toTextStreamResponse"];
5340
5369
  context: Map<string | symbol, unknown>;
5341
5370
  }
5342
5371
  /**
@@ -5346,7 +5375,7 @@ interface StreamObjectResultWithContext<T> {
5346
5375
  readonly object: Promise<T>;
5347
5376
  readonly partialObjectStream: ReadableStream<Partial<T>>;
5348
5377
  readonly textStream: AsyncIterableStream$1<string>;
5349
- readonly warnings: Promise<CallWarning[] | undefined>;
5378
+ readonly warnings: Promise<Warning[] | undefined>;
5350
5379
  readonly usage: Promise<LanguageModelUsage>;
5351
5380
  readonly finishReason: Promise<FinishReason>;
5352
5381
  pipeTextStreamToResponse(response: any, init?: ResponseInit): void;
@@ -5356,7 +5385,7 @@ interface StreamObjectResultWithContext<T> {
5356
5385
  /**
5357
5386
  * Extended GenerateTextResult that includes context
5358
5387
  */
5359
- type GenerateTextResultWithContext<TOOLS extends ToolSet = Record<string, any>, OUTPUT = any> = GenerateTextResult<TOOLS, OUTPUT> & {
5388
+ type GenerateTextResultWithContext<TOOLS extends ToolSet = Record<string, any>, OUTPUT extends OutputSpec = OutputSpec> = GenerateTextResult<TOOLS, OUTPUT> & {
5360
5389
  context: Map<string | symbol, unknown>;
5361
5390
  };
5362
5391
  /**
@@ -5397,12 +5426,16 @@ interface BaseGenerationOptions extends Partial<CallSettings> {
5397
5426
  inputGuardrails?: InputGuardrail[];
5398
5427
  outputGuardrails?: OutputGuardrail<any>[];
5399
5428
  providerOptions?: ProviderOptions$1;
5400
- experimental_output?: ReturnType<typeof Output.object> | ReturnType<typeof Output.text>;
5429
+ output?: OutputSpec;
5401
5430
  /**
5402
5431
  * Optional explicit stop sequences to pass through to the underlying provider.
5403
5432
  * Mirrors the `stop` option supported by ai-sdk `generateText/streamText`.
5404
5433
  */
5405
5434
  stop?: string | string[];
5435
+ /**
5436
+ * Tool choice strategy for AI SDK calls.
5437
+ */
5438
+ toolChoice?: ToolChoice<Record<string, unknown>>;
5406
5439
  }
5407
5440
  type GenerateTextOptions = BaseGenerationOptions;
5408
5441
  type StreamTextOptions = BaseGenerationOptions & {
@@ -5432,6 +5465,7 @@ declare class Agent {
5432
5465
  private readonly logger;
5433
5466
  private readonly memoryManager;
5434
5467
  private readonly memory?;
5468
+ private readonly summarization?;
5435
5469
  private defaultObservability?;
5436
5470
  private readonly toolManager;
5437
5471
  private readonly subAgentManager;
@@ -5440,6 +5474,7 @@ declare class Agent {
5440
5474
  private readonly evalConfig?;
5441
5475
  private readonly inputGuardrails;
5442
5476
  private readonly outputGuardrails;
5477
+ private readonly observabilityAuthWarningState;
5443
5478
  constructor(options: AgentOptions);
5444
5479
  /**
5445
5480
  * Generate text response
@@ -5451,10 +5486,12 @@ declare class Agent {
5451
5486
  streamText(input: string | UIMessage[] | BaseMessage[], options?: StreamTextOptions): Promise<StreamTextResultWithContext>;
5452
5487
  /**
5453
5488
  * Generate structured object
5489
+ * @deprecated Use generateText with Output.object instead. generateObject will be removed in a future release.
5454
5490
  */
5455
5491
  generateObject<T extends z.ZodType>(input: string | UIMessage[] | BaseMessage[], schema: T, options?: GenerateObjectOptions): Promise<GenerateObjectResultWithContext<z.infer<T>>>;
5456
5492
  /**
5457
5493
  * Stream structured object
5494
+ * @deprecated Use streamText with Output.object instead. streamObject will be removed in a future release.
5458
5495
  */
5459
5496
  streamObject<T extends z.ZodType>(input: string | UIMessage[] | BaseMessage[], schema: T, options?: StreamObjectOptions): Promise<StreamObjectResultWithContext<z.infer<T>>>;
5460
5497
  private resolveGuardrailSets;
@@ -5579,8 +5616,8 @@ declare class Agent {
5579
5616
  /**
5580
5617
  * Add tools or toolkits to the agent
5581
5618
  */
5582
- addTools(tools: (Tool<any, any> | Toolkit)[]): {
5583
- added: (Tool<any, any> | Toolkit)[];
5619
+ addTools(tools: (Tool<any, any> | Toolkit | Tool$1)[]): {
5620
+ added: (Tool<any, any> | Toolkit | Tool$1)[];
5584
5621
  };
5585
5622
  /**
5586
5623
  * Remove one or more tools by name
@@ -7618,6 +7655,219 @@ declare class WorkflowRegistry extends SimpleEventEmitter {
7618
7655
  */
7619
7656
  declare function createSuspendController(): WorkflowSuspendController;
7620
7657
 
7658
+ type PlanAgentTodoStatus = "pending" | "in_progress" | "done";
7659
+ type PlanAgentTodoItem = {
7660
+ id: string;
7661
+ content: string;
7662
+ status: PlanAgentTodoStatus;
7663
+ createdAt?: string;
7664
+ updatedAt?: string;
7665
+ };
7666
+ type PlanAgentFileData = {
7667
+ content: string[];
7668
+ created_at: string;
7669
+ modified_at: string;
7670
+ };
7671
+ type PlanAgentState = {
7672
+ todos?: PlanAgentTodoItem[];
7673
+ files?: Record<string, PlanAgentFileData>;
7674
+ };
7675
+
7676
+ type MaybePromise<T> = T | Promise<T>;
7677
+ interface FileInfo {
7678
+ path: string;
7679
+ is_dir?: boolean;
7680
+ size?: number;
7681
+ modified_at?: string;
7682
+ }
7683
+ interface GrepMatch {
7684
+ path: string;
7685
+ line: number;
7686
+ text: string;
7687
+ }
7688
+ type FileData = PlanAgentFileData;
7689
+ interface WriteResult {
7690
+ error?: string;
7691
+ path?: string;
7692
+ filesUpdate?: Record<string, FileData> | null;
7693
+ metadata?: Record<string, unknown>;
7694
+ }
7695
+ interface EditResult {
7696
+ error?: string;
7697
+ path?: string;
7698
+ filesUpdate?: Record<string, FileData> | null;
7699
+ occurrences?: number;
7700
+ metadata?: Record<string, unknown>;
7701
+ }
7702
+ interface FilesystemBackend {
7703
+ lsInfo(path: string): MaybePromise<FileInfo[]>;
7704
+ read(filePath: string, offset?: number, limit?: number): MaybePromise<string>;
7705
+ readRaw(filePath: string): MaybePromise<FileData>;
7706
+ grepRaw(pattern: string, path?: string | null, glob?: string | null): MaybePromise<GrepMatch[] | string>;
7707
+ globInfo(pattern: string, path?: string): MaybePromise<FileInfo[]>;
7708
+ write(filePath: string, content: string): MaybePromise<WriteResult>;
7709
+ edit(filePath: string, oldString: string, newString: string, replaceAll?: boolean): MaybePromise<EditResult>;
7710
+ }
7711
+ type FilesystemBackendContext = {
7712
+ agent: Agent;
7713
+ operationContext: OperationContext;
7714
+ state: {
7715
+ files?: Record<string, FileData>;
7716
+ };
7717
+ };
7718
+ type FilesystemBackendFactory = (context: FilesystemBackendContext) => FilesystemBackend;
7719
+
7720
+ declare class CompositeFilesystemBackend implements FilesystemBackend {
7721
+ private defaultBackend;
7722
+ private routes;
7723
+ private sortedRoutes;
7724
+ constructor(defaultBackend: FilesystemBackend, routes: Record<string, FilesystemBackend>);
7725
+ private getBackendAndKey;
7726
+ lsInfo(path: string): Promise<FileInfo[]>;
7727
+ read(filePath: string, offset?: number, limit?: number): Promise<string>;
7728
+ readRaw(filePath: string): Promise<FileData>;
7729
+ grepRaw(pattern: string, path?: string, glob?: string | null): Promise<GrepMatch[] | string>;
7730
+ globInfo(pattern: string, path?: string): Promise<FileInfo[]>;
7731
+ write(filePath: string, content: string): Promise<WriteResult>;
7732
+ edit(filePath: string, oldString: string, newString: string, replaceAll?: boolean): Promise<EditResult>;
7733
+ }
7734
+
7735
+ declare class NodeFilesystemBackend implements FilesystemBackend {
7736
+ private cwd;
7737
+ private virtualMode;
7738
+ private maxFileSizeBytes;
7739
+ constructor(options?: {
7740
+ rootDir?: string;
7741
+ virtualMode?: boolean;
7742
+ maxFileSizeMb?: number;
7743
+ });
7744
+ private resolvePath;
7745
+ lsInfo(dirPath: string): Promise<FileInfo[]>;
7746
+ read(filePath: string, offset?: number, limit?: number): Promise<string>;
7747
+ readRaw(filePath: string): Promise<FileData>;
7748
+ write(filePath: string, content: string): Promise<WriteResult>;
7749
+ edit(filePath: string, oldString: string, newString: string, replaceAll?: boolean): Promise<EditResult>;
7750
+ grepRaw(pattern: string, dirPath?: string, glob?: string | null): Promise<GrepMatch[] | string>;
7751
+ private ripgrepSearch;
7752
+ private fallbackSearch;
7753
+ globInfo(pattern: string, searchPath?: string): Promise<FileInfo[]>;
7754
+ }
7755
+
7756
+ declare class InMemoryFilesystemBackend implements FilesystemBackend {
7757
+ private files;
7758
+ constructor(files?: Record<string, FileData>);
7759
+ private getFiles;
7760
+ lsInfo(path: string): FileInfo[];
7761
+ read(filePath: string, offset?: number, limit?: number): string;
7762
+ readRaw(filePath: string): FileData;
7763
+ write(filePath: string, content: string): WriteResult;
7764
+ edit(filePath: string, oldString: string, newString: string, replaceAll?: boolean): EditResult;
7765
+ grepRaw(pattern: string, path?: string, glob?: string | null): GrepMatch[] | string;
7766
+ globInfo(pattern: string, path?: string): FileInfo[];
7767
+ }
7768
+
7769
+ declare const FILESYSTEM_SYSTEM_PROMPT = "You have access to a virtual filesystem. All file paths must start with a /.\n\n- ls: list files in a directory (requires absolute path)\n- read_file: read a file from the filesystem\n- write_file: write to a file in the filesystem\n- edit_file: edit a file in the filesystem\n- glob: find files matching a pattern (e.g., \"**/*.ts\")\n- grep: search for text within files";
7770
+ declare const LS_TOOL_DESCRIPTION = "List files and directories in a directory";
7771
+ declare const READ_FILE_TOOL_DESCRIPTION = "Read the contents of a file";
7772
+ declare const WRITE_FILE_TOOL_DESCRIPTION = "Write content to a new file. Returns an error if the file already exists";
7773
+ declare const EDIT_FILE_TOOL_DESCRIPTION = "Edit a file by replacing a specific string with a new string";
7774
+ declare const GLOB_TOOL_DESCRIPTION = "Find files matching a glob pattern (e.g., '**/*.ts' for all TypeScript files)";
7775
+ declare const GREP_TOOL_DESCRIPTION = "Search for a regex pattern in files. Returns matching files and line numbers";
7776
+ type FilesystemToolkitOptions = {
7777
+ backend?: FilesystemBackend | FilesystemBackendFactory;
7778
+ systemPrompt?: string | null;
7779
+ customToolDescriptions?: Record<string, string> | null;
7780
+ toolTokenLimitBeforeEvict?: number | null;
7781
+ };
7782
+ declare function createFilesystemToolkit(agent: Agent, options?: FilesystemToolkitOptions): Toolkit;
7783
+ declare function createToolResultEvictor(options: {
7784
+ agent: Agent;
7785
+ backend: FilesystemBackend | FilesystemBackendFactory;
7786
+ tokenLimit: number;
7787
+ excludeToolNames?: string[];
7788
+ }): (tool: Tool<any, any>) => Tool<any, any>;
7789
+
7790
+ type TodoBackend = {
7791
+ listTodos(): Promise<PlanAgentTodoItem[]>;
7792
+ setTodos(todos: PlanAgentTodoItem[]): Promise<void>;
7793
+ };
7794
+ type TodoBackendFactory = (context: {
7795
+ agent: Agent;
7796
+ operationContext: OperationContext;
7797
+ }) => TodoBackend;
7798
+ declare class ConversationTodoBackend implements TodoBackend {
7799
+ private agent;
7800
+ private operationContext;
7801
+ constructor(agent: Agent, operationContext: OperationContext);
7802
+ listTodos(): Promise<PlanAgentTodoItem[]>;
7803
+ setTodos(todos: PlanAgentTodoItem[]): Promise<void>;
7804
+ }
7805
+
7806
+ declare const WRITE_TODOS_TOOL_NAME = "write_todos";
7807
+ declare const WRITE_TODOS_TOOL_DESCRIPTION = "Write or update the current todo list for the conversation";
7808
+ type PlanningToolkitOptions = {
7809
+ backend?: TodoBackend | TodoBackendFactory;
7810
+ systemPrompt?: string | null;
7811
+ };
7812
+ declare function createPlanningToolkit(agent: Agent, options?: PlanningToolkitOptions): Toolkit;
7813
+
7814
+ type PlanAgentSubagentDefinition = Agent | SubAgentConfig | (Omit<AgentOptions, "instructions" | "tools" | "toolkits" | "subAgents" | "supervisorConfig"> & {
7815
+ name: string;
7816
+ description?: string;
7817
+ systemPrompt: string;
7818
+ model?: AgentOptions["model"];
7819
+ tools?: (Tool<any, any> | Toolkit | Tool$1)[];
7820
+ toolkits?: Toolkit[];
7821
+ });
7822
+ type TaskToolOptions = {
7823
+ systemPrompt?: string | null;
7824
+ taskDescription?: string | null;
7825
+ maxSteps?: number;
7826
+ };
7827
+ type PlanAgentOptions = Omit<AgentOptions, "instructions" | "tools" | "toolkits" | "subAgents" | "supervisorConfig"> & {
7828
+ systemPrompt?: string;
7829
+ tools?: (Tool<any, any> | Toolkit | Tool$1)[];
7830
+ toolkits?: Toolkit[];
7831
+ subagents?: PlanAgentSubagentDefinition[];
7832
+ generalPurposeAgent?: boolean;
7833
+ planning?: PlanningToolkitOptions | false;
7834
+ summarization?: AgentOptions["summarization"];
7835
+ filesystem?: FilesystemToolkitOptions | false;
7836
+ task?: TaskToolOptions | false;
7837
+ extensions?: PlanAgentExtension[];
7838
+ toolResultEviction?: {
7839
+ enabled?: boolean;
7840
+ tokenLimit?: number;
7841
+ };
7842
+ };
7843
+ type PlanAgentExtensionContext = {
7844
+ agentRef: () => Agent | undefined;
7845
+ options: PlanAgentOptions;
7846
+ planningEnabled: boolean;
7847
+ };
7848
+ type PlanAgentExtensionResult = {
7849
+ systemPrompt?: string | null;
7850
+ hooks?: AgentHooks;
7851
+ tools?: (Tool<any, any> | Toolkit | Tool$1)[];
7852
+ toolkits?: Toolkit[] | ((agent: Agent) => Toolkit[]);
7853
+ subagents?: PlanAgentSubagentDefinition[];
7854
+ afterSubagents?: (options: {
7855
+ agent: Agent;
7856
+ subagents: Array<{
7857
+ name: string;
7858
+ description: string;
7859
+ config: SubAgentConfig;
7860
+ }>;
7861
+ }) => Toolkit | Toolkit[] | null;
7862
+ };
7863
+ type PlanAgentExtension = {
7864
+ name: string;
7865
+ apply: (context: PlanAgentExtensionContext) => PlanAgentExtensionResult | null | undefined;
7866
+ };
7867
+ declare class PlanAgent extends Agent {
7868
+ constructor(options: PlanAgentOptions);
7869
+ }
7870
+
7621
7871
  /**
7622
7872
  * Enum defining the next action to take after a reasoning step.
7623
7873
  */
@@ -7643,9 +7893,9 @@ declare const ReasoningStepSchema: z.ZodObject<{
7643
7893
  agentId: z.ZodString;
7644
7894
  }, "strip", z.ZodTypeAny, {
7645
7895
  type: "thought" | "analysis";
7896
+ title: string;
7646
7897
  id: string;
7647
7898
  reasoning: string;
7648
- title: string;
7649
7899
  timestamp: string;
7650
7900
  historyEntryId: string;
7651
7901
  agentId: string;
@@ -7655,9 +7905,9 @@ declare const ReasoningStepSchema: z.ZodObject<{
7655
7905
  next_action?: NextAction | undefined;
7656
7906
  }, {
7657
7907
  type: "thought" | "analysis";
7908
+ title: string;
7658
7909
  id: string;
7659
7910
  reasoning: string;
7660
- title: string;
7661
7911
  timestamp: string;
7662
7912
  historyEntryId: string;
7663
7913
  agentId: string;
@@ -10264,7 +10514,7 @@ declare class AiSdkEmbeddingAdapter implements EmbeddingAdapter {
10264
10514
  private dimensions;
10265
10515
  private modelName;
10266
10516
  private options;
10267
- constructor(model: EmbeddingModel<string>, options?: EmbeddingOptions);
10517
+ constructor(model: EmbeddingModel, options?: EmbeddingOptions);
10268
10518
  embed(text: string): Promise<number[]>;
10269
10519
  embedBatch(texts: string[]): Promise<number[][]>;
10270
10520
  getDimensions(): number;
@@ -11101,4 +11351,4 @@ declare class VoltAgent {
11101
11351
  */
11102
11352
  declare function convertUsage(usage: LanguageModelUsage | undefined): UsageInfo | undefined;
11103
11353
 
11104
- export { A2AServerRegistry, AbortError, Agent, type AgentEvalConfig, type AgentEvalContext, type AgentEvalOperationType, type AgentEvalPayload, type AgentEvalResult, type AgentEvalSamplingPolicy, type AgentEvalScorerConfig, type AgentEvalScorerFactory, type AgentEvalScorerReference, type AgentFullState, type AgentHookOnEnd, type AgentHookOnError, type AgentHookOnHandoff, type AgentHookOnHandoffComplete, type AgentHookOnPrepareMessages, type AgentHookOnPrepareModelMessages, type AgentHookOnStart, type AgentHookOnStepFinish, type AgentHookOnToolEnd, type AgentHookOnToolStart, type AgentHooks, type AgentOptions, AgentRegistry, type AgentResponse, type AgentScorerState, type AgentStatus, 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, type Conversation, ConversationAlreadyExistsError, ConversationNotFoundError, type ConversationQueryOptions, type ConversationQueryOptions as ConversationQueryOptionsV2, type ConversationStepRecord, type ConversationStepType, type Conversation as ConversationV2, type CreateConversationInput, type CreateConversationInput as CreateConversationInputV2, type CreateInputGuardrailOptions, type CreateOutputGuardrailOptions, type CreateReasoningToolsOptions, type CreateScorerOptions, DEFAULT_INSTRUCTIONS, type DataContent, type Document, type DynamicValue, type DynamicValueOptions, type EmbeddingAdapter$1 as EmbeddingAdapter, EmbeddingAdapterNotConfiguredError, EmbeddingError, type ExtractVariableNames, FEW_SHOT_EXAMPLES, type GenerateObjectOptions, type GenerateObjectSubAgentConfig, type GenerateReasonResult, type GenerateScoreResult, type GenerateScoreStep, type GenerateTextOptions, type GenerateTextSubAgentConfig, type GetConversationStepsOptions, type GetMessagesOptions, type GuardrailAction, type GuardrailContext, type GuardrailDefinition, type GuardrailFunction, type GuardrailSeverity, type IServerProvider, type IServerlessProvider, type VoltOpsClient$1 as IVoltOpsClient, InMemoryStorageAdapter$1 as InMemoryObservabilityAdapter, InMemoryStorageAdapter, InMemoryVectorAdapter, type InferGenerateObjectResponse, type InferGenerateTextResponse, type InferMessage, type InferModel, type InferProviderParams, type InferStreamResponse, type InferTool, type InputGuardrail, type InputGuardrailArgs, type InputGuardrailResult, type KnowledgeBaseTagFilter, type LLMProvider, 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, type ModelToolCall, NextAction, NodeType, VoltAgentObservability$1 as NodeVoltAgentObservability, type ObservabilityConfig, type ObservabilityLogRecord, type ObservabilitySpan, type ObservabilityStorageAdapter, type ObservabilityWebSocketEvent, type OnEndHookArgs, type OnErrorHookArgs, type OnHandoffCompleteHookArgs, type OnHandoffHookArgs, type OnPrepareMessagesHookArgs, type OnPrepareMessagesHookResult, type OnPrepareModelMessagesHookArgs, type OnPrepareModelMessagesHookResult, type OnStartHookArgs, type OnStepFinishHookArgs, type OnToolEndHookArgs, type OnToolStartHookArgs, type OperationContext, type OutputGuardrail, type OutputGuardrailArgs, type OutputGuardrailResult, type PackageUpdateInfo, type PromptApiClient, type PromptApiResponse, type PromptContent, type PromptCreator, type PromptHelper, type PromptReference, type PromptTemplate, type ProviderObjectResponse, type ProviderObjectStreamResponse, type ProviderParams, type ProviderResponse, type ProviderTextResponse, type ProviderTextStreamResponse, type ProviderTool, 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 RetrieveOptions, type Retriever, type RetrieverOptions, type RunLocalScorersArgs, type RunLocalScorersResult, 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 StreamObjectSubAgentConfig, type StreamPart, type StreamTextFinishResult, type StreamTextOnFinishCallback, type StreamTextOptions, type StreamTextSubAgentConfig, type SubAgentConfig, type SubAgentMethod, type SubAgentStateData, type SupervisorConfig, TRIGGER_CONTEXT_KEY, type TemplateVariables, type TimelineEventCoreLevel, type TimelineEventCoreStatus, type TimelineEventCoreType, Tool, type ToolCall, type ToolContext, ToolDeniedError, type ToolErrorInfo, type ToolExecuteOptions, 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, 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, WebSocketEventEmitter, WebSocketLogProcessor, WebSocketSpanProcessor, type WeightedBlendComponent, type WeightedBlendOptions, type Workflow, type WorkflowConfig, type WorkflowExecutionContext, WorkflowRegistry, type WorkflowRunQuery, type WorkflowStateEntry, type WorkflowStats, type WorkflowStepContext, type WorkflowStepType, type WorkflowTimelineEvent, type WorkingMemoryConfig, type WorkingMemoryScope, type WorkingMemorySummary, type WorkingMemoryUpdateOptions, addTimestampToMessage, andAgent, andAll, andRace, andTap, andThen, andWhen, andWorkflow, appendToMessage, buildRetrieverLogMessage, buildSamplingMetadata, buildScorer, buildSpanTree, checkForUpdates, convertUsage, cosineSimilarity, createDefaultInputSafetyGuardrails, createDefaultPIIGuardrails, createDefaultSafetyGuardrails, createEmailRedactorGuardrail, createHTMLSanitizerInputGuardrail, createHooks, createInputGuardrail, createInputLengthGuardrail, createMaxLengthGuardrail, createNodeId, createOutputGuardrail, createPIIInputGuardrail, createPhoneNumberGuardrail, createProfanityGuardrail, createProfanityInputGuardrail, createPrompt, createPromptInjectionGuardrail, createReasoningTools, createRetrieverTool, createScorer, createSensitiveNumberGuardrail, createSimpleTemplateEngine, createSubagent, createSuspendController, createTool, createToolkit, createTriggers, createVoltAgentObservability, createVoltOpsClient, createWorkflow, createWorkflowChain, createWorkflowStepNodeId, VoltAgent as default, defineVoltOpsTrigger, extractFileParts, extractImageParts, extractText, extractTextParts, extractWorkflowStepInfo, filterContentParts, getContentLength, getEnvVar, getGlobalLogBuffer, getGlobalLogger, getNodeTypeFromNodeId, getVoltOpsTriggerDefinition, getWorkflowStepNodeType, hasContent, hasFilePart, hasImagePart, hasTextPart, isAbortError, isNodeRuntime, isServerlessRuntime, isStructuredContent, isTextContent, isVoltAgentError, mapMessageContent, messageHelpers, normalizeContent, normalizeScorerResult, normalizeToArray, prependToMessage, readableLogRecordToObservabilityLog, readableSpanToObservabilitySpan, runLocalScorers, safeJsonParse, serializeValueForDebug, setWaitUntil, shouldSample, tool, transformTextContent, updateAllPackages, updateSinglePackage, weightedBlend, zodSchemaToJsonUI };
11354
+ export { A2AServerRegistry, AbortError, Agent, type AgentEvalConfig, type AgentEvalContext, type AgentEvalOperationType, type AgentEvalPayload, type AgentEvalResult, type AgentEvalSamplingPolicy, type AgentEvalScorerConfig, type AgentEvalScorerFactory, type AgentEvalScorerReference, type AgentFullState, type AgentHookOnEnd, type AgentHookOnError, type AgentHookOnHandoff, type AgentHookOnHandoffComplete, type AgentHookOnPrepareMessages, type AgentHookOnPrepareModelMessages, type AgentHookOnStart, type AgentHookOnStepFinish, type AgentHookOnToolEnd, type AgentHookOnToolStart, type AgentHooks, 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 CreateOutputGuardrailOptions, 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 FileData, type FileInfo, type FilesystemBackend, type FilesystemBackendContext, type FilesystemBackendFactory, type FilesystemToolkitOptions, GLOB_TOOL_DESCRIPTION, GREP_TOOL_DESCRIPTION, type GenerateObjectOptions, type GenerateObjectSubAgentConfig, type GenerateReasonResult, type GenerateScoreResult, type GenerateScoreStep, type GenerateTextOptions, 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 KnowledgeBaseTagFilter, type LLMProvider, LS_TOOL_DESCRIPTION, 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, type ModelToolCall, NextAction, NodeFilesystemBackend, NodeType, VoltAgentObservability$1 as NodeVoltAgentObservability, type ObservabilityConfig, type ObservabilityLogRecord, type ObservabilitySpan, type ObservabilityStorageAdapter, type ObservabilityWebSocketEvent, type OnEndHookArgs, type OnErrorHookArgs, type OnHandoffCompleteHookArgs, type OnHandoffHookArgs, type OnPrepareMessagesHookArgs, type OnPrepareMessagesHookResult, type OnPrepareModelMessagesHookArgs, type OnPrepareModelMessagesHookResult, type OnStartHookArgs, type OnStepFinishHookArgs, type OnToolEndHookArgs, type OnToolStartHookArgs, type OperationContext, type OutputGuardrail, type OutputGuardrailArgs, type OutputGuardrailResult, 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 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 RetrieveOptions, type Retriever, type RetrieverOptions, type RunLocalScorersArgs, type RunLocalScorersResult, 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 StreamObjectSubAgentConfig, type StreamPart, type StreamTextFinishResult, type StreamTextOnFinishCallback, type StreamTextOptions, 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, 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, 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, WorkflowRegistry, type WorkflowRunQuery, type WorkflowStateEntry, type WorkflowStats, type WorkflowStepContext, type WorkflowStepType, type WorkflowTimelineEvent, type WorkingMemoryConfig, type WorkingMemoryScope, type WorkingMemorySummary, type WorkingMemoryUpdateOptions, type WriteResult, addTimestampToMessage, andAgent, andAll, andRace, andTap, andThen, andWhen, andWorkflow, appendToMessage, buildRetrieverLogMessage, buildSamplingMetadata, buildScorer, buildSpanTree, checkForUpdates, convertUsage, cosineSimilarity, createDefaultInputSafetyGuardrails, createDefaultPIIGuardrails, createDefaultSafetyGuardrails, createEmailRedactorGuardrail, createFilesystemToolkit, createHTMLSanitizerInputGuardrail, createHooks, createInputGuardrail, createInputLengthGuardrail, createMaxLengthGuardrail, createNodeId, createOutputGuardrail, 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, getNodeTypeFromNodeId, getVoltOpsTriggerDefinition, getWorkflowStepNodeType, hasContent, hasFilePart, hasImagePart, hasTextPart, isAbortError, isNodeRuntime, isServerlessRuntime, isStructuredContent, isTextContent, isVoltAgentError, mapMessageContent, messageHelpers, normalizeContent, normalizeScorerResult, normalizeToArray, prependToMessage, readableLogRecordToObservabilityLog, readableSpanToObservabilitySpan, runLocalScorers, safeJsonParse, serializeValueForDebug, setWaitUntil, shouldSample, tool, transformTextContent, updateAllPackages, updateSinglePackage, weightedBlend, zodSchemaToJsonUI };