@voltagent/core 1.1.39 → 1.2.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,5 +1,5 @@
1
- import { ModelMessage, ToolCallOptions, DataContent as DataContent$1, UserContent, AssistantContent, ToolContent, ProviderOptions as ProviderOptions$1 } from '@ai-sdk/provider-utils';
2
- export { AssistantContent, FilePart, ImagePart, TextPart, ToolContent, UserContent } from '@ai-sdk/provider-utils';
1
+ import { ToolCallOptions, ProviderOptions as ProviderOptions$1, ModelMessage, DataContent as DataContent$1, UserContent, AssistantContent, ToolContent } from '@ai-sdk/provider-utils';
2
+ export { AssistantContent, FilePart, ImagePart, ProviderOptions, TextPart, ToolContent, UserContent } from '@ai-sdk/provider-utils';
3
3
  import { Tool as Tool$1, TextStreamPart, generateText, UIMessage, StreamTextResult, LanguageModel, CallSettings, Output, ToolSet, GenerateTextResult, GenerateObjectResult, AsyncIterableStream as AsyncIterableStream$1, CallWarning, LanguageModelUsage, FinishReason, EmbeddingModel } from 'ai';
4
4
  export { LanguageModel, Tool as VercelTool, hasToolCall, stepCountIs } from 'ai';
5
5
  import * as zod from 'zod';
@@ -191,7 +191,7 @@ declare class ToolManager extends BaseToolManager<AgentTool | Tool$1 | Toolkit,
191
191
  * @returns true if the toolkit was successfully added or replaced.
192
192
  */
193
193
  addToolkit(toolkit: Toolkit): boolean;
194
- prepareToolsForExecution(createToolExecuteFunction: (tool: AgentTool) => (args: any, options?: ToolExecuteOptions) => Promise<any>): Record<string, any>;
194
+ prepareToolsForExecution(createToolExecuteFunction: (tool: AgentTool) => (args: any, options?: ToolCallOptions) => Promise<any>): Record<string, any>;
195
195
  /**
196
196
  * Get agent's tools (including those in toolkits) for API exposure.
197
197
  */
@@ -216,6 +216,40 @@ type ToolStatusInfo = {
216
216
  parameters?: any;
217
217
  };
218
218
 
219
+ /**
220
+ * JSON value types (matches AI SDK's JSONValue)
221
+ */
222
+ type JSONValue = string | number | boolean | null | {
223
+ [key: string]: JSONValue;
224
+ } | Array<JSONValue>;
225
+ /**
226
+ * Tool result output format for multi-modal content.
227
+ * Matches AI SDK's LanguageModelV2ToolResultOutput type.
228
+ */
229
+ type ToolResultOutput = {
230
+ type: "text";
231
+ value: string;
232
+ } | {
233
+ type: "json";
234
+ value: JSONValue;
235
+ } | {
236
+ type: "error-text";
237
+ value: string;
238
+ } | {
239
+ type: "error-json";
240
+ value: JSONValue;
241
+ } | {
242
+ type: "content";
243
+ value: Array<{
244
+ type: "text";
245
+ text: string;
246
+ } | {
247
+ type: "media";
248
+ data: string;
249
+ mediaType: string;
250
+ }>;
251
+ };
252
+
219
253
  /**
220
254
  * Tool definition compatible with Vercel AI SDK
221
255
  */
@@ -251,9 +285,49 @@ type ToolOptions<T extends ToolSchema = ToolSchema, O extends ToolSchema | undef
251
285
  */
252
286
  outputSchema?: O;
253
287
  /**
254
- * Function to execute when the tool is called
288
+ * Optional user-defined tags for organizing or labeling tools.
255
289
  */
256
- execute?: (args: z.infer<T>, context?: OperationContext, options?: ToolExecuteOptions) => Promise<O extends ToolSchema ? z.infer<O> : unknown>;
290
+ tags?: string[];
291
+ /**
292
+ * Provider-specific options for the tool.
293
+ * Enables provider-specific functionality like cache control.
294
+ *
295
+ * @example
296
+ * ```typescript
297
+ * // Anthropic cache control
298
+ * providerOptions: {
299
+ * anthropic: {
300
+ * cacheControl: { type: 'ephemeral' }
301
+ * }
302
+ * }
303
+ * ```
304
+ */
305
+ providerOptions?: ProviderOptions$1;
306
+ /**
307
+ * Optional function to convert tool output to multi-modal content.
308
+ * Enables returning images, media, or structured content to the LLM.
309
+ *
310
+ * Supported by: Anthropic, OpenAI
311
+ *
312
+ * @example
313
+ * ```typescript
314
+ * // Return image + text
315
+ * toModelOutput: (result) => ({
316
+ * type: 'content',
317
+ * value: [
318
+ * { type: 'text', text: 'Screenshot taken' },
319
+ * { type: 'media', data: result.base64Image, mediaType: 'image/png' }
320
+ * ]
321
+ * })
322
+ * ```
323
+ */
324
+ toModelOutput?: (output: O extends ToolSchema ? z.infer<O> : unknown) => ToolResultOutput;
325
+ /**
326
+ * Function to execute when the tool is called.
327
+ * @param args - The arguments passed to the tool
328
+ * @param options - Optional execution options including context, abort signals, etc.
329
+ */
330
+ execute?: (args: z.infer<T>, options?: ToolExecuteOptions) => Promise<O extends ToolSchema ? z.infer<O> : unknown>;
257
331
  };
258
332
  /**
259
333
  * Tool class for defining tools that agents can use
@@ -279,15 +353,31 @@ declare class Tool<T extends ToolSchema = ToolSchema, O extends ToolSchema | und
279
353
  * Tool output schema
280
354
  */
281
355
  readonly outputSchema?: O;
356
+ /**
357
+ * Optional user-defined tags for organizing or labeling tools.
358
+ */
359
+ readonly tags?: string[];
360
+ /**
361
+ * Provider-specific options for the tool.
362
+ * Enables provider-specific functionality like cache control.
363
+ */
364
+ readonly providerOptions?: ProviderOptions$1;
365
+ /**
366
+ * Optional function to convert tool output to multi-modal content.
367
+ * Enables returning images, media, or structured content to the LLM.
368
+ */
369
+ readonly toModelOutput?: (output: O extends ToolSchema ? z.infer<O> : unknown) => ToolResultOutput;
282
370
  /**
283
371
  * Internal discriminator to make runtime/type checks simpler across module boundaries.
284
372
  * Marking our Tool instances with a stable string avoids instanceof issues.
285
373
  */
286
374
  readonly type: "user-defined";
287
375
  /**
288
- * Function to execute when the tool is called
376
+ * Function to execute when the tool is called.
377
+ * @param args - The arguments passed to the tool
378
+ * @param options - Optional execution options including context, abort signals, etc.
289
379
  */
290
- readonly execute?: (args: z.infer<T>, context?: OperationContext, options?: ToolExecuteOptions) => Promise<O extends ToolSchema ? z.infer<O> : unknown>;
380
+ readonly execute?: (args: z.infer<T>, options?: ToolExecuteOptions) => Promise<O extends ToolSchema ? z.infer<O> : unknown>;
291
381
  /**
292
382
  * Whether this tool should be executed on the client side.
293
383
  * Returns true when no server-side execute handler is provided.
@@ -485,21 +575,35 @@ type MessageRole = "user" | "assistant" | "system" | "tool";
485
575
  */
486
576
  type BaseMessage = ModelMessage;
487
577
  type ToolSchema = z.ZodType;
488
- type ToolExecuteOptions = ToolCallOptions & {
489
- /**
490
- * Optional AbortController for cancelling the execution and accessing the signal.
491
- * Prefer using the provided abortSignal, but we keep this for backward compatibility.
492
- */
493
- abortController?: AbortController;
578
+ /**
579
+ * Tool execution context containing all tool-specific metadata.
580
+ * Encapsulates both AI SDK fields and VoltAgent metadata for better organization.
581
+ */
582
+ type ToolContext = {
583
+ /** Name of the tool being executed */
584
+ name: string;
585
+ /** Unique identifier for this specific tool call (from AI SDK) */
586
+ callId: string;
587
+ /** Message history at the time of tool call (from AI SDK) */
588
+ messages: any[];
589
+ /** Abort signal for detecting cancellation (from AI SDK) */
590
+ abortSignal?: AbortSignal;
591
+ };
592
+ type ToolExecuteOptions = Partial<OperationContext> & {
494
593
  /**
495
- * @deprecated Use abortController.signal or options.abortSignal instead. This field will be removed in a future version.
594
+ * Tool execution context containing all tool-specific metadata.
595
+ * Includes both AI SDK fields (callId, messages, abortSignal) and
596
+ * VoltAgent metadata (name).
597
+ *
598
+ * Optional for external callers (e.g., MCP servers) that may not have tool metadata.
599
+ * When called from VoltAgent's agent, this is always populated.
496
600
  */
497
- signal?: AbortSignal;
601
+ toolContext?: ToolContext;
498
602
  /**
499
- * The operation context associated with the agent invocation triggering this tool execution.
500
- * Provides access to operation-specific state like context and logging metadata.
603
+ * Optional AbortController for cancelling the execution and accessing the signal.
604
+ * Prefer using toolContext.abortSignal.
501
605
  */
502
- operationContext?: OperationContext;
606
+ abortController?: AbortController;
503
607
  /**
504
608
  * Additional options can be added in the future.
505
609
  */
@@ -1790,6 +1894,134 @@ type CachedPrompt = {
1790
1894
  /** Time to live in milliseconds */
1791
1895
  ttl: number;
1792
1896
  };
1897
+ interface VoltOpsActionExecutionResult {
1898
+ actionId: string;
1899
+ provider: string;
1900
+ requestPayload: Record<string, unknown>;
1901
+ responsePayload: unknown;
1902
+ metadata?: Record<string, unknown> | null;
1903
+ }
1904
+ interface VoltOpsAirtableCreateRecordParams {
1905
+ credentialId: string;
1906
+ baseId: string;
1907
+ tableId: string;
1908
+ fields: Record<string, unknown>;
1909
+ typecast?: boolean;
1910
+ returnFieldsByFieldId?: boolean;
1911
+ actionId?: string;
1912
+ catalogId?: string;
1913
+ projectId?: string | null;
1914
+ }
1915
+ interface VoltOpsAirtableUpdateRecordParams {
1916
+ credentialId: string;
1917
+ baseId: string;
1918
+ tableId: string;
1919
+ recordId: string;
1920
+ fields?: Record<string, unknown>;
1921
+ typecast?: boolean;
1922
+ returnFieldsByFieldId?: boolean;
1923
+ actionId?: string;
1924
+ catalogId?: string;
1925
+ projectId?: string | null;
1926
+ }
1927
+ interface VoltOpsAirtableDeleteRecordParams {
1928
+ credentialId: string;
1929
+ baseId: string;
1930
+ tableId: string;
1931
+ recordId: string;
1932
+ actionId?: string;
1933
+ catalogId?: string;
1934
+ projectId?: string | null;
1935
+ }
1936
+ interface VoltOpsAirtableGetRecordParams {
1937
+ credentialId: string;
1938
+ baseId: string;
1939
+ tableId: string;
1940
+ recordId: string;
1941
+ returnFieldsByFieldId?: boolean;
1942
+ actionId?: string;
1943
+ catalogId?: string;
1944
+ projectId?: string | null;
1945
+ }
1946
+ interface VoltOpsAirtableListRecordsParams {
1947
+ credentialId: string;
1948
+ baseId: string;
1949
+ tableId: string;
1950
+ view?: string;
1951
+ filterByFormula?: string;
1952
+ maxRecords?: number;
1953
+ pageSize?: number;
1954
+ offset?: string;
1955
+ fields?: string[];
1956
+ sort?: Array<{
1957
+ field: string;
1958
+ direction?: "asc" | "desc";
1959
+ }>;
1960
+ returnFieldsByFieldId?: boolean;
1961
+ actionId?: string;
1962
+ catalogId?: string;
1963
+ projectId?: string | null;
1964
+ }
1965
+ interface VoltOpsSlackBaseParams {
1966
+ credentialId: string;
1967
+ actionId?: string;
1968
+ catalogId?: string;
1969
+ projectId?: string | null;
1970
+ }
1971
+ interface VoltOpsSlackPostMessageParams extends VoltOpsSlackBaseParams {
1972
+ channelId?: string;
1973
+ channelName?: string;
1974
+ channelLabel?: string | null;
1975
+ defaultThreadTs?: string | null;
1976
+ targetType?: "conversation" | "user";
1977
+ userId?: string;
1978
+ userName?: string;
1979
+ text?: string;
1980
+ blocks?: unknown;
1981
+ attachments?: unknown;
1982
+ threadTs?: string;
1983
+ metadata?: Record<string, unknown>;
1984
+ linkNames?: boolean;
1985
+ unfurlLinks?: boolean;
1986
+ unfurlMedia?: boolean;
1987
+ }
1988
+ interface VoltOpsSlackDeleteMessageParams extends VoltOpsSlackBaseParams {
1989
+ channelId: string;
1990
+ messageTs: string;
1991
+ threadTs?: string;
1992
+ }
1993
+ interface VoltOpsSlackSearchMessagesParams extends VoltOpsSlackBaseParams {
1994
+ query: string;
1995
+ sort?: "relevance" | "timestamp";
1996
+ sortDirection?: "asc" | "desc";
1997
+ channelIds?: string[];
1998
+ limit?: number;
1999
+ }
2000
+ type VoltOpsActionsApi = {
2001
+ airtable: {
2002
+ createRecord: (params: VoltOpsAirtableCreateRecordParams) => Promise<VoltOpsActionExecutionResult>;
2003
+ updateRecord: (params: VoltOpsAirtableUpdateRecordParams) => Promise<VoltOpsActionExecutionResult>;
2004
+ deleteRecord: (params: VoltOpsAirtableDeleteRecordParams) => Promise<VoltOpsActionExecutionResult>;
2005
+ getRecord: (params: VoltOpsAirtableGetRecordParams) => Promise<VoltOpsActionExecutionResult>;
2006
+ listRecords: (params: VoltOpsAirtableListRecordsParams) => Promise<VoltOpsActionExecutionResult>;
2007
+ };
2008
+ slack: {
2009
+ postMessage: (params: VoltOpsSlackPostMessageParams) => Promise<VoltOpsActionExecutionResult>;
2010
+ deleteMessage: (params: VoltOpsSlackDeleteMessageParams) => Promise<VoltOpsActionExecutionResult>;
2011
+ searchMessages: (params: VoltOpsSlackSearchMessagesParams) => Promise<VoltOpsActionExecutionResult>;
2012
+ };
2013
+ };
2014
+ interface VoltOpsEvalsApi {
2015
+ runs: {
2016
+ create(payload?: VoltOpsCreateEvalRunRequest): Promise<VoltOpsEvalRunSummary>;
2017
+ appendResults(runId: string, payload: VoltOpsAppendEvalRunResultsRequest): Promise<VoltOpsEvalRunSummary>;
2018
+ complete(runId: string, payload: VoltOpsCompleteEvalRunRequest): Promise<VoltOpsEvalRunSummary>;
2019
+ fail(runId: string, payload: VoltOpsFailEvalRunRequest): Promise<VoltOpsEvalRunSummary>;
2020
+ };
2021
+ scorers: {
2022
+ create(payload: VoltOpsCreateScorerRequest): Promise<VoltOpsScorerSummary>;
2023
+ };
2024
+ }
1793
2025
  /**
1794
2026
  * API response for prompt fetch operations
1795
2027
  * Simplified format matching the desired response structure
@@ -1934,6 +2166,9 @@ interface VoltOpsCompleteEvalRunRequest {
1934
2166
  summary?: VoltOpsEvalRunCompletionSummaryPayload;
1935
2167
  error?: VoltOpsEvalRunErrorPayload;
1936
2168
  }
2169
+ interface VoltOpsFailEvalRunRequest {
2170
+ error: VoltOpsEvalRunErrorPayload;
2171
+ }
1937
2172
  interface VoltOpsCreateScorerRequest {
1938
2173
  id: string;
1939
2174
  name: string;
@@ -1964,16 +2199,12 @@ interface VoltOpsClient$1 {
1964
2199
  options: VoltOpsClientOptions & {
1965
2200
  baseUrl: string;
1966
2201
  };
2202
+ /** Actions client for third-party integrations */
2203
+ actions: VoltOpsActionsApi;
2204
+ /** Evaluations API surface */
2205
+ evals: VoltOpsEvalsApi;
1967
2206
  /** Create a prompt helper for agent instructions */
1968
2207
  createPromptHelper(agentId: string, historyEntryId?: string): PromptHelper;
1969
- /** Create a new evaluation run in VoltOps */
1970
- createEvalRun(payload?: VoltOpsCreateEvalRunRequest): Promise<VoltOpsEvalRunSummary>;
1971
- /** Append evaluation results to an existing run */
1972
- appendEvalRunResults(runId: string, payload: VoltOpsAppendEvalRunResultsRequest): Promise<VoltOpsEvalRunSummary>;
1973
- /** Complete an evaluation run */
1974
- completeEvalRun(runId: string, payload: VoltOpsCompleteEvalRunRequest): Promise<VoltOpsEvalRunSummary>;
1975
- /** Upsert a scorer definition */
1976
- createEvalScorer(payload: VoltOpsCreateScorerRequest): Promise<VoltOpsScorerSummary>;
1977
2208
  /** List managed memory databases available to the project */
1978
2209
  listManagedMemoryDatabases(): Promise<ManagedMemoryDatabaseSummary[]>;
1979
2210
  /** List credentials for a managed memory database */
@@ -2162,6 +2393,52 @@ interface ManagedMemoryVoltOpsClient {
2162
2393
  vectors: ManagedMemoryVectorsClient;
2163
2394
  }
2164
2395
 
2396
+ interface VoltOpsActionsTransport {
2397
+ sendRequest(path: string, init?: RequestInit): Promise<Response>;
2398
+ }
2399
+ declare class VoltOpsActionsClient {
2400
+ private readonly transport;
2401
+ readonly airtable: {
2402
+ createRecord: (params: VoltOpsAirtableCreateRecordParams) => Promise<VoltOpsActionExecutionResult>;
2403
+ updateRecord: (params: VoltOpsAirtableUpdateRecordParams) => Promise<VoltOpsActionExecutionResult>;
2404
+ deleteRecord: (params: VoltOpsAirtableDeleteRecordParams) => Promise<VoltOpsActionExecutionResult>;
2405
+ getRecord: (params: VoltOpsAirtableGetRecordParams) => Promise<VoltOpsActionExecutionResult>;
2406
+ listRecords: (params: VoltOpsAirtableListRecordsParams) => Promise<VoltOpsActionExecutionResult>;
2407
+ };
2408
+ readonly slack: {
2409
+ postMessage: (params: VoltOpsSlackPostMessageParams) => Promise<VoltOpsActionExecutionResult>;
2410
+ deleteMessage: (params: VoltOpsSlackDeleteMessageParams) => Promise<VoltOpsActionExecutionResult>;
2411
+ searchMessages: (params: VoltOpsSlackSearchMessagesParams) => Promise<VoltOpsActionExecutionResult>;
2412
+ };
2413
+ constructor(transport: VoltOpsActionsTransport, options?: {
2414
+ useProjectEndpoint?: boolean;
2415
+ });
2416
+ private readonly useProjectEndpoint;
2417
+ private get actionExecutionPath();
2418
+ private createAirtableRecord;
2419
+ private updateAirtableRecord;
2420
+ private deleteAirtableRecord;
2421
+ private getAirtableRecord;
2422
+ private listAirtableRecords;
2423
+ private executeAirtableAction;
2424
+ private postSlackMessage;
2425
+ private deleteSlackMessage;
2426
+ private searchSlackMessages;
2427
+ private executeSlackAction;
2428
+ private normalizeIdentifier;
2429
+ private ensureRecord;
2430
+ private sanitizeStringArray;
2431
+ private sanitizeSortArray;
2432
+ private normalizePositiveInteger;
2433
+ private trimString;
2434
+ private postActionExecution;
2435
+ private unwrapActionResponse;
2436
+ private mapActionExecution;
2437
+ private normalizeString;
2438
+ private normalizeRecord;
2439
+ private extractErrorMessage;
2440
+ }
2441
+
2165
2442
  /**
2166
2443
  * VoltOps Client Implementation
2167
2444
  *
@@ -2179,6 +2456,8 @@ declare class VoltOpsClient implements VoltOpsClient$1 {
2179
2456
  };
2180
2457
  readonly prompts?: VoltOpsPromptManager;
2181
2458
  readonly managedMemory: ManagedMemoryVoltOpsClient;
2459
+ readonly actions: VoltOpsActionsClient;
2460
+ readonly evals: VoltOpsEvalsApi;
2182
2461
  private readonly logger;
2183
2462
  private get fetchImpl();
2184
2463
  constructor(options: VoltOpsClientOptions);
@@ -2207,14 +2486,16 @@ declare class VoltOpsClient implements VoltOpsClient$1 {
2207
2486
  * Get authentication headers for API requests
2208
2487
  */
2209
2488
  getAuthHeaders(): Record<string, string>;
2489
+ sendRequest(path: string, init?: RequestInit): Promise<Response>;
2210
2490
  /**
2211
2491
  * Get prompt manager for direct access
2212
2492
  */
2213
2493
  getPromptManager(): VoltOpsPromptManager | undefined;
2214
- createEvalRun(payload?: VoltOpsCreateEvalRunRequest): Promise<VoltOpsEvalRunSummary>;
2215
- appendEvalRunResults(runId: string, payload: VoltOpsAppendEvalRunResultsRequest): Promise<VoltOpsEvalRunSummary>;
2216
- completeEvalRun(runId: string, payload: VoltOpsCompleteEvalRunRequest): Promise<VoltOpsEvalRunSummary>;
2217
- createEvalScorer(payload: VoltOpsCreateScorerRequest): Promise<VoltOpsScorerSummary>;
2494
+ private createEvalRun;
2495
+ private appendEvalRunResults;
2496
+ private completeEvalRun;
2497
+ private failEvalRun;
2498
+ private createEvalScorer;
2218
2499
  private request;
2219
2500
  private buildQueryString;
2220
2501
  private createManagedMemoryClient;
@@ -3453,6 +3734,26 @@ interface OnHandoffHookArgs {
3453
3734
  agent: Agent;
3454
3735
  sourceAgent: Agent;
3455
3736
  }
3737
+ interface OnHandoffCompleteHookArgs {
3738
+ /** The target agent (subagent) that completed the task. */
3739
+ agent: Agent;
3740
+ /** The source agent (supervisor) that delegated the task. */
3741
+ sourceAgent: Agent;
3742
+ /** The result produced by the subagent. */
3743
+ result: string;
3744
+ /** The full conversation messages including the task and response. */
3745
+ messages: UIMessage[];
3746
+ /** Token usage information from the subagent execution. */
3747
+ usage?: UsageInfo;
3748
+ /** The operation context containing metadata about the operation. */
3749
+ context: OperationContext;
3750
+ /**
3751
+ * Call this function to bail (skip supervisor processing) and return result directly.
3752
+ * Optionally provide a transformed result to use instead of the original.
3753
+ * @param transformedResult - Optional transformed result to return instead of original
3754
+ */
3755
+ bail: (transformedResult?: string) => void;
3756
+ }
3456
3757
  interface OnToolStartHookArgs {
3457
3758
  agent: Agent;
3458
3759
  tool: AgentTool;
@@ -3511,6 +3812,7 @@ interface OnStepFinishHookArgs {
3511
3812
  type AgentHookOnStart = (args: OnStartHookArgs) => Promise<void> | void;
3512
3813
  type AgentHookOnEnd = (args: OnEndHookArgs) => Promise<void> | void;
3513
3814
  type AgentHookOnHandoff = (args: OnHandoffHookArgs) => Promise<void> | void;
3815
+ type AgentHookOnHandoffComplete = (args: OnHandoffCompleteHookArgs) => Promise<void> | void;
3514
3816
  type AgentHookOnToolStart = (args: OnToolStartHookArgs) => Promise<void> | void;
3515
3817
  type AgentHookOnToolEnd = (args: OnToolEndHookArgs) => Promise<void> | void;
3516
3818
  type AgentHookOnPrepareMessages = (args: OnPrepareMessagesHookArgs) => Promise<OnPrepareMessagesHookResult> | OnPrepareMessagesHookResult;
@@ -3524,6 +3826,7 @@ type AgentHooks = {
3524
3826
  onStart?: AgentHookOnStart;
3525
3827
  onEnd?: AgentHookOnEnd;
3526
3828
  onHandoff?: AgentHookOnHandoff;
3829
+ onHandoffComplete?: AgentHookOnHandoffComplete;
3527
3830
  onToolStart?: AgentHookOnToolStart;
3528
3831
  onToolEnd?: AgentHookOnToolEnd;
3529
3832
  onPrepareMessages?: AgentHookOnPrepareMessages;
@@ -3565,7 +3868,7 @@ declare class AgentTraceContext {
3565
3868
  /**
3566
3869
  * Create a child span with automatic parent context and attribute inheritance
3567
3870
  */
3568
- createChildSpan(name: string, type: "tool" | "memory" | "retriever" | "embedding" | "vector" | "agent" | "guardrail", options?: {
3871
+ createChildSpan(name: string, type: "tool" | "memory" | "retriever" | "embedding" | "vector" | "agent" | "guardrail" | "llm", options?: {
3569
3872
  label?: string;
3570
3873
  attributes?: Record<string, any>;
3571
3874
  kind?: SpanKind$1;
@@ -3573,7 +3876,7 @@ declare class AgentTraceContext {
3573
3876
  /**
3574
3877
  * Create a child span with a specific parent span
3575
3878
  */
3576
- createChildSpanWithParent(parentSpan: Span, name: string, type: "tool" | "memory" | "retriever" | "embedding" | "vector" | "agent" | "guardrail", options?: {
3879
+ createChildSpanWithParent(parentSpan: Span, name: string, type: "tool" | "memory" | "retriever" | "embedding" | "vector" | "agent" | "guardrail" | "llm", options?: {
3577
3880
  label?: string;
3578
3881
  attributes?: Record<string, any>;
3579
3882
  kind?: SpanKind$1;
@@ -4470,6 +4773,11 @@ interface BaseGenerationOptions extends Partial<CallSettings> {
4470
4773
  outputGuardrails?: OutputGuardrail<any>[];
4471
4774
  providerOptions?: ProviderOptions$1;
4472
4775
  experimental_output?: ReturnType<typeof Output.object> | ReturnType<typeof Output.text>;
4776
+ /**
4777
+ * Optional explicit stop sequences to pass through to the underlying provider.
4778
+ * Mirrors the `stop` option supported by ai-sdk `generateText/streamText`.
4779
+ */
4780
+ stop?: string | string[];
4473
4781
  }
4474
4782
  type GenerateTextOptions = BaseGenerationOptions;
4475
4783
  type StreamTextOptions = BaseGenerationOptions & {
@@ -4549,6 +4857,10 @@ declare class Agent {
4549
4857
  */
4550
4858
  private calculateDelegationDepth;
4551
4859
  private enqueueEvalScoring;
4860
+ private createLLMSpan;
4861
+ private createLLMSpanFinalizer;
4862
+ private buildLLMSpanAttributes;
4863
+ private recordLLMUsage;
4552
4864
  private createEvalHost;
4553
4865
  /**
4554
4866
  * Get observability instance (lazy initialization)
@@ -6692,9 +7004,9 @@ declare const ReasoningStepSchema: z.ZodObject<{
6692
7004
  id: string;
6693
7005
  reasoning: string;
6694
7006
  title: string;
7007
+ timestamp: string;
6695
7008
  historyEntryId: string;
6696
7009
  agentId: string;
6697
- timestamp: string;
6698
7010
  confidence: number;
6699
7011
  action?: string | undefined;
6700
7012
  result?: string | undefined;
@@ -6704,9 +7016,9 @@ declare const ReasoningStepSchema: z.ZodObject<{
6704
7016
  id: string;
6705
7017
  reasoning: string;
6706
7018
  title: string;
7019
+ timestamp: string;
6707
7020
  historyEntryId: string;
6708
7021
  agentId: string;
6709
- timestamp: string;
6710
7022
  action?: string | undefined;
6711
7023
  result?: string | undefined;
6712
7024
  next_action?: NextAction | undefined;
@@ -8416,4 +8728,4 @@ declare class VoltAgent {
8416
8728
  */
8417
8729
  declare function convertUsage(usage: LanguageModelUsage | undefined): UsageInfo | undefined;
8418
8730
 
8419
- 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 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 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 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 LLMProvider, LazyRemoteExportProcessor, type LocalScorerDefinition, type LocalScorerExecutionResult, LocalStorageSpanProcessor, type LogFilter, LoggerProxy, MCPConfiguration, type MCPElicitationAdapter, 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 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 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 ReadableStreamType, type ReasoningStep, ReasoningStepSchema, type RegisterOptions, 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, type TemplateVariables, type TimelineEventCoreLevel, type TimelineEventCoreStatus, type TimelineEventCoreType, Tool, type ToolCall, ToolDeniedError, type ToolErrorInfo, type ToolExecuteOptions, ToolManager, type ToolOptions, type ToolSchema, type ToolStatus, type ToolStatusInfo, type ToolWithNodeId, type Toolkit, type Usage, type UsageInfo, type VectorAdapter, VectorAdapterNotConfiguredError, VectorError, type VectorItem, type VectorSearchOptions, type Voice, type VoiceEventData, type VoiceEventType, type VoiceMetadata, type VoiceOptions, VoltAgent, VoltAgentError, VoltAgentObservability, type VoltAgentOptions, type VoltAgentStreamTextResult, type VoltAgentTextStreamPart, type VoltOpsAppendEvalRunResultPayload, type VoltOpsAppendEvalRunResultsRequest, VoltOpsClient, type VoltOpsClientOptions, type VoltOpsCompleteEvalRunRequest, type VoltOpsCreateEvalRunRequest, type VoltOpsCreateScorerRequest, type VoltOpsEvalResultStatus, type VoltOpsEvalRunCompletionSummaryPayload, type VoltOpsEvalRunErrorPayload, type VoltOpsEvalRunResultLiveMetadata, type VoltOpsEvalRunResultScorePayload, type VoltOpsEvalRunStatus, type VoltOpsEvalRunSummary, VoltOpsPromptApiClient, type VoltOpsPromptManager, VoltOpsPromptManagerImpl, type VoltOpsScorerSummary, type VoltOpsTerminalEvalRunStatus, WebSocketEventEmitter, WebSocketLogProcessor, WebSocketSpanProcessor, type WeightedBlendComponent, type WeightedBlendOptions, type Workflow, type WorkflowConfig, type WorkflowExecutionContext, WorkflowRegistry, 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, createVoltAgentObservability, createVoltOpsClient, createWorkflow, createWorkflowChain, createWorkflowStepNodeId, VoltAgent as default, extractFileParts, extractImageParts, extractText, extractTextParts, extractWorkflowStepInfo, filterContentParts, getContentLength, getEnvVar, getGlobalLogBuffer, getGlobalLogger, getNodeTypeFromNodeId, getWorkflowStepNodeType, hasContent, hasFilePart, hasImagePart, hasTextPart, isAbortError, isNodeRuntime, isServerlessRuntime, isStructuredContent, isTextContent, isVoltAgentError, mapMessageContent, messageHelpers, normalizeContent, normalizeScorerResult, normalizeToArray, prependToMessage, readableLogRecordToObservabilityLog, readableSpanToObservabilitySpan, runLocalScorers, safeJsonParse, serializeValueForDebug, shouldSample, tool, transformTextContent, updateAllPackages, updateSinglePackage, weightedBlend, zodSchemaToJsonUI };
8731
+ 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 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 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 LLMProvider, LazyRemoteExportProcessor, type LocalScorerDefinition, type LocalScorerExecutionResult, LocalStorageSpanProcessor, type LogFilter, LoggerProxy, MCPConfiguration, type MCPElicitationAdapter, 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 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 ReadableStreamType, type ReasoningStep, ReasoningStepSchema, type RegisterOptions, 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, 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 Usage, type UsageInfo, type VectorAdapter, VectorAdapterNotConfiguredError, VectorError, type VectorItem, type VectorSearchOptions, type Voice, type VoiceEventData, type VoiceEventType, type VoiceMetadata, type VoiceOptions, VoltAgent, VoltAgentError, VoltAgentObservability, type VoltAgentOptions, type VoltAgentStreamTextResult, type VoltAgentTextStreamPart, type VoltOpsActionExecutionResult, type VoltOpsActionsApi, VoltOpsActionsClient, type VoltOpsActionsTransport, type VoltOpsAirtableCreateRecordParams, type VoltOpsAirtableDeleteRecordParams, type VoltOpsAirtableGetRecordParams, type VoltOpsAirtableListRecordsParams, type VoltOpsAirtableUpdateRecordParams, type VoltOpsAppendEvalRunResultPayload, type VoltOpsAppendEvalRunResultsRequest, VoltOpsClient, type VoltOpsClientOptions, type VoltOpsCompleteEvalRunRequest, type VoltOpsCreateEvalRunRequest, type VoltOpsCreateScorerRequest, type VoltOpsEvalResultStatus, type VoltOpsEvalRunCompletionSummaryPayload, type VoltOpsEvalRunErrorPayload, type VoltOpsEvalRunResultLiveMetadata, type VoltOpsEvalRunResultScorePayload, type VoltOpsEvalRunStatus, type VoltOpsEvalRunSummary, VoltOpsPromptApiClient, type VoltOpsPromptManager, VoltOpsPromptManagerImpl, type VoltOpsScorerSummary, type VoltOpsSlackDeleteMessageParams, type VoltOpsSlackPostMessageParams, type VoltOpsSlackSearchMessagesParams, type VoltOpsTerminalEvalRunStatus, WebSocketEventEmitter, WebSocketLogProcessor, WebSocketSpanProcessor, type WeightedBlendComponent, type WeightedBlendOptions, type Workflow, type WorkflowConfig, type WorkflowExecutionContext, WorkflowRegistry, 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, createVoltAgentObservability, createVoltOpsClient, createWorkflow, createWorkflowChain, createWorkflowStepNodeId, VoltAgent as default, extractFileParts, extractImageParts, extractText, extractTextParts, extractWorkflowStepInfo, filterContentParts, getContentLength, getEnvVar, getGlobalLogBuffer, getGlobalLogger, getNodeTypeFromNodeId, getWorkflowStepNodeType, hasContent, hasFilePart, hasImagePart, hasTextPart, isAbortError, isNodeRuntime, isServerlessRuntime, isStructuredContent, isTextContent, isVoltAgentError, mapMessageContent, messageHelpers, normalizeContent, normalizeScorerResult, normalizeToArray, prependToMessage, readableLogRecordToObservabilityLog, readableSpanToObservabilitySpan, runLocalScorers, safeJsonParse, serializeValueForDebug, shouldSample, tool, transformTextContent, updateAllPackages, updateSinglePackage, weightedBlend, zodSchemaToJsonUI };