@voltagent/core 1.1.26 → 1.1.28

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { ModelMessage, DataContent as DataContent$1, UserContent, AssistantContent, ToolContent, ProviderOptions as ProviderOptions$1 } from '@ai-sdk/provider-utils';
 export { AssistantContent, FilePart, ImagePart, TextPart, ToolContent, UserContent } from '@ai-sdk/provider-utils';
 import { TextStreamPart, generateText, UIMessage, StreamTextResult, LanguageModel, CallSettings, Output, ToolSet, GenerateTextResult, GenerateObjectResult, AsyncIterableStream as AsyncIterableStream$1, CallWarning, LanguageModelUsage, FinishReason, EmbeddingModel } from 'ai';
-export { hasToolCall, stepCountIs } from 'ai';
+export { LanguageModel, hasToolCall, stepCountIs } from 'ai';
 import * as zod from 'zod';
 import { z } from 'zod';
 import { AsyncIterableStream } from '@voltagent/internal/utils';
@@ -639,13 +639,7 @@ type GetMessagesOptions = {
 /**
  * Memory options for MemoryManager
  */
-type MemoryOptions = {
-    /**
-     * Maximum number of messages to store in the database
-     * @default 100
-     */
-    storageLimit?: number;
-};
+type MemoryOptions = {};
 /**
  * Workflow state entry for suspension and resumption
  * Stores only the essential state needed to resume a workflow
@@ -748,11 +742,6 @@ interface MemoryConfig {
      * @default 3600000 (1 hour)
      */
     cacheTTL?: number;
-    /**
-     * Maximum number of messages to store per conversation
-     * @default 100
-     */
-    storageLimit?: number;
     /**
      * Working memory configuration
      * Enables agents to maintain important context
@@ -1764,6 +1753,114 @@ interface VoltOpsPromptManager {
         entries: string[];
     };
 }
+type VoltOpsEvalRunStatus = "pending" | "running" | "succeeded" | "failed" | "cancelled";
+type VoltOpsTerminalEvalRunStatus = "succeeded" | "failed" | "cancelled";
+type VoltOpsEvalResultStatus = "pending" | "running" | "passed" | "failed" | "error";
+interface VoltOpsEvalRunSummary {
+    id: string;
+    status: VoltOpsEvalRunStatus | string;
+    triggerSource: string;
+    datasetId?: string | null;
+    datasetVersionId?: string | null;
+    datasetVersionLabel?: string | null;
+    itemCount: number;
+    successCount: number;
+    failureCount: number;
+    meanScore?: number | null;
+    medianScore?: number | null;
+    sumScore?: number | null;
+    passRate?: number | null;
+    startedAt?: string | null;
+    completedAt?: string | null;
+    durationMs?: number | null;
+    tags?: string[] | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface VoltOpsCreateEvalRunRequest {
+    experimentId?: string;
+    datasetVersionId?: string;
+    providerCredentialId?: string;
+    triggerSource?: string;
+    autoQueue?: boolean;
+}
+interface VoltOpsEvalRunResultScorePayload {
+    scorerId: string;
+    score?: number | null;
+    threshold?: number | null;
+    thresholdPassed?: boolean | null;
+    metadata?: Record<string, unknown> | null;
+}
+interface VoltOpsEvalRunResultLiveMetadata {
+    traceId?: string | null;
+    spanId?: string | null;
+    operationId?: string | null;
+    operationType?: string | null;
+    sampling?: {
+        strategy: string;
+        rate?: number | null;
+    } | null;
+    triggerSource?: string | null;
+    environment?: string | null;
+}
+interface VoltOpsAppendEvalRunResultPayload {
+    id?: string;
+    datasetItemId?: string | null;
+    datasetItemHash: string;
+    status?: VoltOpsEvalResultStatus;
+    input?: unknown;
+    expected?: unknown;
+    output?: unknown;
+    durationMs?: number | null;
+    scores?: VoltOpsEvalRunResultScorePayload[];
+    metadata?: Record<string, unknown> | null;
+    traceIds?: string[] | null;
+    liveEval?: VoltOpsEvalRunResultLiveMetadata | null;
+}
+interface VoltOpsAppendEvalRunResultsRequest {
+    results: VoltOpsAppendEvalRunResultPayload[];
+}
+interface VoltOpsEvalRunCompletionSummaryPayload {
+    itemCount?: number;
+    successCount?: number;
+    failureCount?: number;
+    meanScore?: number | null;
+    medianScore?: number | null;
+    sumScore?: number | null;
+    passRate?: number | null;
+    durationMs?: number | null;
+    metadata?: Record<string, unknown> | null;
+}
+interface VoltOpsEvalRunErrorPayload {
+    message: string;
+    code?: string;
+    details?: Record<string, unknown>;
+}
+interface VoltOpsCompleteEvalRunRequest {
+    status: VoltOpsTerminalEvalRunStatus;
+    summary?: VoltOpsEvalRunCompletionSummaryPayload;
+    error?: VoltOpsEvalRunErrorPayload;
+}
+interface VoltOpsCreateScorerRequest {
+    id: string;
+    name: string;
+    category?: string | null;
+    description?: string | null;
+    defaultThreshold?: number | null;
+    thresholdOperator?: string | null;
+    metadata?: Record<string, unknown> | null;
+}
+interface VoltOpsScorerSummary {
+    id: string;
+    name: string;
+    category?: string | null;
+    description?: string | null;
+    defaultThreshold?: number | null;
+    thresholdOperator?: string | null;
+    metadata?: Record<string, unknown> | null;
+    createdAt: string;
+    updatedAt: string;
+}
 /**
  * Main VoltOps client interface
  */
@@ -1776,6 +1873,14 @@ interface VoltOpsClient$1 {
     };
     /** Create a prompt helper for agent instructions */
     createPromptHelper(agentId: string, historyEntryId?: string): PromptHelper;
+    /** Create a new evaluation run in VoltOps */
+    createEvalRun(payload?: VoltOpsCreateEvalRunRequest): Promise<VoltOpsEvalRunSummary>;
+    /** Append evaluation results to an existing run */
+    appendEvalRunResults(runId: string, payload: VoltOpsAppendEvalRunResultsRequest): Promise<VoltOpsEvalRunSummary>;
+    /** Complete an evaluation run */
+    completeEvalRun(runId: string, payload: VoltOpsCompleteEvalRunRequest): Promise<VoltOpsEvalRunSummary>;
+    /** Upsert a scorer definition */
+    createEvalScorer(payload: VoltOpsCreateScorerRequest): Promise<VoltOpsScorerSummary>;
     /** List managed memory databases available to the project */
     listManagedMemoryDatabases(): Promise<ManagedMemoryDatabaseSummary[]>;
     /** List credentials for a managed memory database */
@@ -2013,6 +2118,10 @@ declare class VoltOpsClient implements VoltOpsClient$1 {
      * Get prompt manager for direct access
      */
     getPromptManager(): VoltOpsPromptManager | undefined;
+    createEvalRun(payload?: VoltOpsCreateEvalRunRequest): Promise<VoltOpsEvalRunSummary>;
+    appendEvalRunResults(runId: string, payload: VoltOpsAppendEvalRunResultsRequest): Promise<VoltOpsEvalRunSummary>;
+    completeEvalRun(runId: string, payload: VoltOpsCompleteEvalRunRequest): Promise<VoltOpsEvalRunSummary>;
+    createEvalScorer(payload: VoltOpsCreateScorerRequest): Promise<VoltOpsScorerSummary>;
     private request;
     private buildQueryString;
     private createManagedMemoryClient;
@@ -2054,6 +2163,9 @@ declare class VoltOpsClient implements VoltOpsClient$1 {
      * Cleanup resources when client is no longer needed
      */
     dispose(): Promise<void>;
+    private normalizeRunSummary;
+    private normalizeDate;
+    private normalizeScorerSummary;
 }
 /**
  * Factory function to create VoltOps client
@@ -2251,6 +2363,203 @@ interface VoltAgentStreamTextResult<TOOLS extends Record<string, any> = Record<s
     readonly fullStream: AsyncIterable<VoltAgentTextStreamPart<TOOLS>>;
 }
 
+type SamplingPolicy = {
+    type: "always";
+} | {
+    type: "never";
+} | {
+    type: "ratio";
+    rate: number;
+};
+interface SamplingMetadata {
+    strategy: "always" | "never" | "ratio";
+    rate?: number;
+    applied?: boolean;
+}
+interface ScorerContext<Payload extends Record<string, unknown>, Params extends Record<string, unknown> = Record<string, unknown>> {
+    payload: Payload;
+    params: Params;
+}
+type ScorerResult = {
+    status?: "success";
+    score?: number | null;
+    metadata?: Record<string, unknown> | null;
+} | {
+    status: "error";
+    score?: number | null;
+    metadata?: Record<string, unknown> | null;
+    error: unknown;
+} | {
+    status: "skipped";
+    score?: number | null;
+    metadata?: Record<string, unknown> | null;
+};
+interface LocalScorerDefinition<Payload extends Record<string, unknown>, Params extends Record<string, unknown> = Record<string, unknown>> {
+    id: string;
+    name: string;
+    scorer: (context: ScorerContext<Payload, Params>) => ScorerResult | Promise<ScorerResult>;
+    params?: Params | ((payload: Payload) => Params | undefined | Promise<Params | undefined>);
+    metadata?: Record<string, unknown> | null;
+    sampling?: SamplingPolicy;
+}
+interface LocalScorerExecutionResult {
+    id: string;
+    name: string;
+    status: "success" | "error" | "skipped";
+    score: number | null;
+    metadata: Record<string, unknown> | null;
+    sampling?: SamplingMetadata;
+    durationMs: number;
+    error?: unknown;
+}
+interface ScorerLifecycleScope {
+    run<T>(executor: () => T | Promise<T>): Promise<T>;
+}
+interface RunLocalScorersArgs<Payload extends Record<string, unknown>> {
+    payload: Payload;
+    scorers: LocalScorerDefinition<Payload>[];
+    defaultSampling?: SamplingPolicy;
+    baseArgs?: Record<string, unknown> | ((payload: Payload) => Record<string, unknown> | Promise<Record<string, unknown>>);
+    onScorerStart?: (info: {
+        definition: LocalScorerDefinition<Payload>;
+        sampling?: SamplingMetadata;
+    }) => ScorerLifecycleScope | undefined;
+    onScorerComplete?: (info: {
+        definition: LocalScorerDefinition<Payload>;
+        execution: LocalScorerExecutionResult;
+        context?: ScorerLifecycleScope;
+    }) => void;
+}
+interface RunLocalScorersResult {
+    results: LocalScorerExecutionResult[];
+    summary: {
+        successCount: number;
+        errorCount: number;
+        skippedCount: number;
+    };
+}
+interface NormalizedScorerResult {
+    score?: number | null;
+    metadata?: Record<string, unknown> | null;
+    error?: unknown;
+    status?: "success" | "error" | "skipped";
+}
+declare function runLocalScorers<Payload extends Record<string, unknown>>(args: RunLocalScorersArgs<Payload>): Promise<RunLocalScorersResult>;
+declare function shouldSample(policy?: SamplingPolicy): boolean;
+declare function buildSamplingMetadata(policy?: SamplingPolicy): SamplingMetadata | undefined;
+declare function normalizeScorerResult(result: unknown): NormalizedScorerResult;
+
+interface ScorerPipelineContext<Payload extends Record<string, unknown>, Params extends Record<string, unknown>> {
+    payload: Payload;
+    params: Params;
+    results: Record<string, unknown>;
+}
+interface ScorerReasonContext<Payload extends Record<string, unknown>, Params extends Record<string, unknown>> extends ScorerPipelineContext<Payload, Params> {
+    score: number | null;
+}
+type PreprocessFunctionStep<Payload extends Record<string, unknown>, Params extends Record<string, unknown>> = (context: ScorerPipelineContext<Payload, Params>) => unknown | Promise<unknown>;
+type AnalyzeFunctionStep<Payload extends Record<string, unknown>, Params extends Record<string, unknown>> = (context: ScorerPipelineContext<Payload, Params>) => unknown | Promise<unknown>;
+type GenerateScoreResult = number | {
+    score: number;
+    metadata?: Record<string, unknown> | null;
+};
+type PreprocessStep<Payload extends Record<string, unknown>, Params extends Record<string, unknown>> = PreprocessFunctionStep<Payload, Params>;
+type AnalyzeStep<Payload extends Record<string, unknown>, Params extends Record<string, unknown>> = AnalyzeFunctionStep<Payload, Params>;
+type GenerateScoreStep<Payload extends Record<string, unknown>, Params extends Record<string, unknown>> = (context: ScorerPipelineContext<Payload, Params>) => GenerateScoreResult | Promise<GenerateScoreResult>;
+type GenerateReasonResult = string | {
+    reason: string;
+    metadata?: Record<string, unknown> | null;
+};
+type GenerateReasonStep<Payload extends Record<string, unknown>, Params extends Record<string, unknown>> = (context: ScorerReasonContext<Payload, Params>) => GenerateReasonResult | Promise<GenerateReasonResult>;
+interface CreateScorerOptions<Payload extends Record<string, unknown> = Record<string, unknown>, Params extends Record<string, unknown> = Record<string, unknown>> {
+    id: string;
+    name?: string;
+    metadata?: Record<string, unknown> | null;
+    preprocess?: PreprocessStep<Payload, Params>;
+    analyze?: AnalyzeStep<Payload, Params>;
+    generateScore?: GenerateScoreStep<Payload, Params>;
+    generateReason?: GenerateReasonStep<Payload, Params>;
+}
+declare function createScorer<Payload extends Record<string, unknown> = Record<string, unknown>, Params extends Record<string, unknown> = Record<string, unknown>>(options: CreateScorerOptions<Payload, Params>): LocalScorerDefinition<Payload, Params>;
+interface WeightedBlendComponent<Payload extends Record<string, unknown>, Params extends Record<string, unknown>> {
+    id: string;
+    weight: number;
+    step?: GenerateScoreStep<Payload, Params>;
+}
+interface WeightedBlendOptions {
+    metadataKey?: string;
+}
+declare function weightedBlend<Payload extends Record<string, unknown>, Params extends Record<string, unknown>>(components: WeightedBlendComponent<Payload, Params>[], options?: WeightedBlendOptions): GenerateScoreStep<Payload, Params>;
+
+interface BuilderResultsSnapshot {
+    prepare?: unknown;
+    analyze?: unknown;
+    score?: number | null;
+    reason?: string | null;
+    raw: Record<string, unknown>;
+}
+interface BuilderContextBase<Payload extends Record<string, unknown>, Params extends Record<string, unknown>> {
+    payload: Payload;
+    params: Params;
+    results: BuilderResultsSnapshot;
+}
+interface BuilderPrepareContext<Payload extends Record<string, unknown>, Params extends Record<string, unknown>> extends BuilderContextBase<Payload, Params> {
+    kind: "prepare";
+}
+interface BuilderAnalyzeContext<Payload extends Record<string, unknown>, Params extends Record<string, unknown>> extends BuilderContextBase<Payload, Params> {
+    kind: "analyze";
+}
+interface BuilderScoreContext<Payload extends Record<string, unknown>, Params extends Record<string, unknown>> extends BuilderContextBase<Payload, Params> {
+    kind: "score";
+}
+interface BuilderReasonContext<Payload extends Record<string, unknown>, Params extends Record<string, unknown>> extends BuilderContextBase<Payload, Params> {
+    kind: "reason";
+    score: number | null;
+}
+type BuilderPrepareStep<Payload extends Record<string, unknown>, Params extends Record<string, unknown>> = (context: BuilderPrepareContext<Payload, Params>) => unknown | Promise<unknown>;
+type BuilderAnalyzeStep<Payload extends Record<string, unknown>, Params extends Record<string, unknown>> = (context: BuilderAnalyzeContext<Payload, Params>) => unknown | Promise<unknown>;
+type BuilderScoreStep<Payload extends Record<string, unknown>, Params extends Record<string, unknown>> = (context: BuilderScoreContext<Payload, Params>) => GenerateScoreResult | number | Promise<GenerateScoreResult | number>;
+type BuilderReasonStep<Payload extends Record<string, unknown>, Params extends Record<string, unknown>> = (context: BuilderReasonContext<Payload, Params>) => GenerateReasonResult | string | Promise<GenerateReasonResult | string>;
+type BuildScorerCustomOptions<Payload extends Record<string, unknown> = Record<string, unknown>, Params extends Record<string, unknown> = Record<string, unknown>> = {
+    id: string;
+    label?: string;
+    description?: string;
+    metadata?: Record<string, unknown> | null;
+    sampling?: SamplingPolicy;
+    params?: Params | ((payload: Payload) => Params | undefined | Promise<Params | undefined>);
+};
+type BuildScorerOptions<Payload extends Record<string, unknown> = Record<string, unknown>, Params extends Record<string, unknown> = Record<string, unknown>> = BuildScorerCustomOptions<Payload, Params>;
+interface BuildScorerRunArgs<Payload extends Record<string, unknown>, Params extends Record<string, unknown>> {
+    payload: Payload;
+    params?: Params;
+    sampling?: SamplingPolicy;
+}
+interface BuildScorerRunResult<Payload extends Record<string, unknown>, Params extends Record<string, unknown>> {
+    id: string;
+    status: "success" | "error" | "skipped";
+    score: number | null;
+    reason?: string;
+    metadata: Record<string, unknown> | null;
+    durationMs: number;
+    sampling?: ReturnType<typeof buildSamplingMetadata>;
+    rawResult: ScorerResult;
+    payload: Payload;
+    params: Params;
+    steps: BuilderResultsSnapshot;
+}
+interface ScorerBuilder<Payload extends Record<string, unknown>, Params extends Record<string, unknown>> {
+    prepare(step: BuilderPrepareStep<Payload, Params>): ScorerBuilder<Payload, Params>;
+    analyze(step: BuilderAnalyzeStep<Payload, Params>): ScorerBuilder<Payload, Params>;
+    score(step: BuilderScoreStep<Payload, Params>): ScorerBuilder<Payload, Params>;
+    reason(step: BuilderReasonStep<Payload, Params>): ScorerBuilder<Payload, Params>;
+    build(): LocalScorerDefinition<Payload, Params>;
+    run(args: BuildScorerRunArgs<Payload, Params>): Promise<BuildScorerRunResult<Payload, Params>>;
+    getId(): string;
+    getLabel(): string;
+    getDescription(): string | undefined;
+}
+declare function buildScorer<Payload extends Record<string, unknown> = Record<string, unknown>, Params extends Record<string, unknown> = Record<string, unknown>>(options: BuildScorerOptions<Payload, Params>): ScorerBuilder<Payload, Params>;
+
 /**
  * Unified Observability Types for VoltAgent
  *
@@ -3161,7 +3470,7 @@ declare class AgentTraceContext {
     /**
      * Create a child span with automatic parent context and attribute inheritance
      */
-    createChildSpan(name: string, type: "tool" | "memory" | "retriever" | "embedding" | "vector" | "agent", options?: {
+    createChildSpan(name: string, type: "tool" | "memory" | "retriever" | "embedding" | "vector" | "agent" | "guardrail", options?: {
         label?: string;
         attributes?: Record<string, any>;
         kind?: SpanKind$1;
@@ -3169,7 +3478,7 @@ declare class AgentTraceContext {
     /**
      * Create a child span with a specific parent span
      */
-    createChildSpanWithParent(parentSpan: Span, name: string, type: "tool" | "memory" | "retriever" | "embedding" | "vector" | "agent", options?: {
+    createChildSpanWithParent(parentSpan: Span, name: string, type: "tool" | "memory" | "retriever" | "embedding" | "vector" | "agent" | "guardrail", options?: {
         label?: string;
         attributes?: Record<string, any>;
         kind?: SpanKind$1;
@@ -3220,6 +3529,7 @@ declare class AgentTraceContext {
         error?: Error | any;
         attributes?: Record<string, any>;
     }): void;
+    private resolveParentSpan;
     /**
      * Get the active context for manual context propagation
      */
@@ -3244,6 +3554,15 @@ interface ApiToolInfo {
 interface ToolWithNodeId extends BaseTool {
     node_id: string;
 }
+interface AgentScorerState {
+    key: string;
+    id: string;
+    name: string;
+    node_id: string;
+    sampling?: SamplingPolicy;
+    metadata?: Record<string, unknown> | null;
+    params?: Record<string, unknown> | null;
+}
 /**
  * SubAgent data structure for agent state
  */
@@ -3257,6 +3576,8 @@ interface SubAgentStateData {
     memory?: AgentMemoryState;
     node_id: string;
     subAgents?: SubAgentStateData[];
+    scorers?: AgentScorerState[];
+    guardrails?: AgentGuardrailStateGroup;
     methodConfig?: {
         method: string;
         schema?: string;
@@ -3304,12 +3625,14 @@ interface AgentFullState {
     tools: ToolWithNodeId[];
     subAgents: SubAgentStateData[];
     memory: AgentMemoryState;
+    scorers?: AgentScorerState[];
     retriever?: {
         name: string;
         description?: string;
         status?: string;
         node_id: string;
     } | null;
+    guardrails?: AgentGuardrailStateGroup;
 }
 /**
  * Enhanced dynamic value for instructions that supports prompt management
@@ -3396,6 +3719,121 @@ type SupervisorConfig = {
      */
     includeErrorInEmptyResponse?: boolean;
 };
+type GuardrailSeverity = "info" | "warning" | "critical";
+type GuardrailAction = "allow" | "modify" | "block";
+interface GuardrailBaseResult {
+    pass: boolean;
+    action?: GuardrailAction;
+    message?: string;
+    metadata?: Record<string, unknown>;
+}
+interface OutputGuardrailStreamArgs extends GuardrailContext {
+    part: VoltAgentTextStreamPart;
+    streamParts: VoltAgentTextStreamPart[];
+    state: Record<string, any>;
+    abort: (reason?: string) => never;
+}
+type OutputGuardrailStreamResult = VoltAgentTextStreamPart | null | undefined | Promise<VoltAgentTextStreamPart | null | undefined>;
+type OutputGuardrailStreamHandler = (args: OutputGuardrailStreamArgs) => OutputGuardrailStreamResult;
+type GuardrailFunctionMetadata = {
+    guardrailId?: string;
+    guardrailName?: string;
+    guardrailDescription?: string;
+    guardrailTags?: string[];
+    guardrailSeverity?: GuardrailSeverity;
+};
+type GuardrailFunction<TArgs, TResult> = ((args: TArgs) => TResult | Promise<TResult>) & GuardrailFunctionMetadata;
+interface GuardrailDefinition<TArgs, TResult> {
+    id?: string;
+    name?: string;
+    description?: string;
+    tags?: string[];
+    severity?: GuardrailSeverity;
+    metadata?: Record<string, unknown>;
+    handler: GuardrailFunction<TArgs, TResult>;
+}
+type GuardrailConfig<TArgs, TResult> = GuardrailFunction<TArgs, TResult> | GuardrailDefinition<TArgs, TResult>;
+interface AgentGuardrailState {
+    id?: string;
+    name: string;
+    direction: "input" | "output";
+    description?: string;
+    severity?: GuardrailSeverity;
+    tags?: string[];
+    metadata?: Record<string, unknown> | null;
+    node_id: string;
+}
+interface AgentGuardrailStateGroup {
+    input: AgentGuardrailState[];
+    output: AgentGuardrailState[];
+}
+interface GuardrailContext {
+    agent: Agent;
+    context: OperationContext;
+    operation: AgentEvalOperationType;
+}
+interface InputGuardrailArgs extends GuardrailContext {
+    /**
+     * The latest value after any previous guardrail modifications.
+     */
+    input: string | UIMessage[] | BaseMessage[];
+    /**
+     * Plain text representation of the latest input value.
+     */
+    inputText: string;
+    /**
+     * The original user provided value before any guardrail modifications.
+     */
+    originalInput: string | UIMessage[] | BaseMessage[];
+    /**
+     * Plain text representation of the original input value.
+     */
+    originalInputText: string;
+}
+interface InputGuardrailResult extends GuardrailBaseResult {
+    modifiedInput?: string | UIMessage[] | BaseMessage[];
+}
+interface OutputGuardrailArgs<TOutput = unknown> extends GuardrailContext {
+    /**
+     * The latest value after any previous guardrail modifications.
+     */
+    output: TOutput;
+    /**
+     * Optional plain text representation of the latest output value.
+     */
+    outputText?: string;
+    /**
+     * The original value produced by the model before guardrail modifications.
+     */
+    originalOutput: TOutput;
+    /**
+     * Optional plain text representation of the original output value.
+     */
+    originalOutputText?: string;
+    /**
+     * Optional usage metrics for the generation.
+     */
+    usage?: UsageInfo;
+    /**
+     * Optional finish reason from the model/provider.
+     */
+    finishReason?: string | null;
+    /**
+     * Optional warnings or diagnostics returned by the provider.
+     */
+    warnings?: unknown[] | null;
+}
+interface OutputGuardrailResult<TOutput = unknown> extends GuardrailBaseResult {
+    modifiedOutput?: TOutput;
+}
+type InputGuardrail = GuardrailConfig<InputGuardrailArgs, InputGuardrailResult>;
+type OutputGuardrailFunction<TOutput = unknown> = GuardrailFunction<OutputGuardrailArgs<TOutput>, OutputGuardrailResult<TOutput>> & {
+    guardrailStreamHandler?: OutputGuardrailStreamHandler;
+};
+interface OutputGuardrailDefinition<TOutput = unknown> extends GuardrailDefinition<OutputGuardrailArgs<TOutput>, OutputGuardrailResult<TOutput>> {
+    streamHandler?: OutputGuardrailStreamHandler;
+}
+type OutputGuardrail<TOutput = unknown> = OutputGuardrailFunction<TOutput> | OutputGuardrailDefinition<TOutput>;
 /**
  * Agent configuration options
  */
@@ -3413,6 +3851,8 @@ type AgentOptions = {
     supervisorConfig?: SupervisorConfig;
     maxHistoryEntries?: number;
     hooks?: AgentHooks;
+    inputGuardrails?: InputGuardrail[];
+    outputGuardrails?: OutputGuardrail<any>[];
     temperature?: number;
     maxOutputTokens?: number;
     maxSteps?: number;
@@ -3427,7 +3867,59 @@ type AgentOptions = {
     voltOpsClient?: VoltOpsClient;
     observability?: VoltAgentObservability;
     context?: ContextInput;
+    eval?: AgentEvalConfig;
+};
+type AgentEvalOperationType = "generateText" | "streamText" | "generateObject" | "streamObject";
+interface AgentEvalPayload {
+    operationId: string;
+    operationType: AgentEvalOperationType;
+    input?: string | null;
+    output?: string | null;
+    rawInput?: string | UIMessage[] | BaseMessage[];
+    rawOutput?: unknown;
+    userId?: string;
+    conversationId?: string;
+    traceId: string;
+    spanId: string;
+    metadata?: Record<string, unknown>;
+}
+type AgentEvalContext = AgentEvalPayload & Record<string, unknown> & {
+    agentId: string;
+    agentName: string;
+    timestamp: string;
+    rawPayload: AgentEvalPayload;
 };
+type AgentEvalParams = Record<string, unknown>;
+type AgentEvalSamplingPolicy = SamplingPolicy;
+type AgentEvalScorerFactory = () => LocalScorerDefinition<AgentEvalContext, Record<string, unknown>> | Promise<LocalScorerDefinition<AgentEvalContext, Record<string, unknown>>>;
+type AgentEvalScorerReference = LocalScorerDefinition<AgentEvalContext, Record<string, unknown>> | AgentEvalScorerFactory;
+interface AgentEvalResult {
+    scorerId: string;
+    scorerName?: string;
+    status: "success" | "error" | "skipped";
+    score?: number | null;
+    metadata?: Record<string, unknown> | null;
+    error?: unknown;
+    durationMs?: number;
+    payload: AgentEvalPayload;
+    rawPayload: AgentEvalPayload;
+}
+interface AgentEvalScorerConfig {
+    scorer: AgentEvalScorerReference;
+    params?: AgentEvalParams | ((context: AgentEvalContext) => AgentEvalParams | undefined | Promise<AgentEvalParams | undefined>);
+    sampling?: AgentEvalSamplingPolicy;
+    id?: string;
+    onResult?: (result: AgentEvalResult) => void | Promise<void>;
+    buildPayload?: (context: AgentEvalContext) => Record<string, unknown> | Promise<Record<string, unknown>>;
+    buildParams?: (context: AgentEvalContext) => AgentEvalParams | undefined | Promise<AgentEvalParams | undefined>;
+}
+interface AgentEvalConfig {
+    scorers: Record<string, AgentEvalScorerConfig>;
+    triggerSource?: string;
+    environment?: string;
+    sampling?: AgentEvalSamplingPolicy;
+    redact?: (payload: AgentEvalPayload) => AgentEvalPayload;
+}
 /**
  * Agent status information
  */
@@ -3871,6 +4363,8 @@ interface BaseGenerationOptions extends Partial<CallSettings> {
     stopWhen?: StopWhen;
     tools?: (Tool<any, any> | Toolkit)[];
     hooks?: AgentHooks;
+    inputGuardrails?: InputGuardrail[];
+    outputGuardrails?: OutputGuardrail<any>[];
     providerOptions?: ProviderOptions$1;
     experimental_output?: ReturnType<typeof Output.object> | ReturnType<typeof Output.text>;
 }
@@ -3907,6 +4401,9 @@ declare class Agent {
     private readonly subAgentManager;
     private readonly voltOpsClient?;
     private readonly prompts?;
+    private readonly evalConfig?;
+    private readonly inputGuardrails;
+    private readonly outputGuardrails;
     constructor(options: AgentOptions);
     /**
      * Generate text response
@@ -3924,6 +4421,7 @@ declare class Agent {
      * Stream structured object
      */
     streamObject<T extends z.ZodType>(input: string | UIMessage[] | BaseMessage[], schema: T, options?: StreamObjectOptions): Promise<StreamObjectResultWithContext<z.infer<T>>>;
+    private resolveGuardrailSets;
     /**
      * Common preparation for all execution methods
      */
@@ -3947,6 +4445,8 @@ declare class Agent {
      * Calculate delegation depth
      */
     private calculateDelegationDepth;
+    private enqueueEvalScoring;
+    private createEvalHost;
     /**
      * Get observability instance (lazy initialization)
      */
@@ -6089,6 +6589,117 @@ type CreateReasoningToolsOptions = {
  */
 declare const createReasoningTools: (options?: CreateReasoningToolsOptions) => Toolkit;
 
+type BaseGuardrailOptions = {
+    id?: string;
+    name?: string;
+    description?: string;
+    severity?: GuardrailSeverity;
+};
+type SensitiveNumberGuardrailOptions = BaseGuardrailOptions & {
+    /**
+     * Minimum digit run length that will be redacted.
+     * @default 4
+     */
+    minimumDigits?: number;
+    /**
+     * Replacement text used for redacted segments.
+     * @default "[redacted]"
+     */
+    replacement?: string;
+};
+type EmailGuardrailOptions = BaseGuardrailOptions & {
+    replacement?: string;
+};
+type PhoneGuardrailOptions = BaseGuardrailOptions & {
+    replacement?: string;
+};
+type ProfanityGuardrailMode = "redact" | "block";
+type ProfanityGuardrailOptions = BaseGuardrailOptions & {
+    bannedWords?: string[];
+    replacement?: string;
+    mode?: ProfanityGuardrailMode;
+};
+type MaxLengthGuardrailMode = "truncate" | "block";
+type MaxLengthGuardrailOptions = BaseGuardrailOptions & {
+    maxCharacters: number;
+    mode?: MaxLengthGuardrailMode;
+};
+type InputGuardrailBaseOptions = BaseGuardrailOptions & {
+    message?: string;
+};
+type ProfanityInputGuardrailOptions = InputGuardrailBaseOptions & {
+    bannedWords?: string[];
+    replacement?: string;
+    mode?: "mask" | "block";
+};
+type PIIInputGuardrailOptions = InputGuardrailBaseOptions & {
+    replacement?: string;
+    maskEmails?: boolean;
+    maskPhones?: boolean;
+};
+type PromptInjectionGuardrailOptions = InputGuardrailBaseOptions & {
+    phrases?: string[];
+};
+type InputLengthGuardrailOptions = InputGuardrailBaseOptions & {
+    maxCharacters: number;
+    mode?: MaxLengthGuardrailMode;
+};
+type HTMLSanitizerGuardrailOptions = InputGuardrailBaseOptions & {
+    allowBasicFormatting?: boolean;
+};
+/**
+ * Creates a guardrail that redacts long numeric sequences such as account or card numbers.
+ */
+declare function createSensitiveNumberGuardrail(options?: SensitiveNumberGuardrailOptions): OutputGuardrail<string>;
+/**
+ * Creates a guardrail that redacts email addresses.
+ */
+declare function createEmailRedactorGuardrail(options?: EmailGuardrailOptions): OutputGuardrail<string>;
+/**
+ * Creates a guardrail that redacts common phone number patterns.
+ */
+declare function createPhoneNumberGuardrail(options?: PhoneGuardrailOptions): OutputGuardrail<string>;
+/**
+ * Creates a guardrail that detects profanity and either redacts or blocks output.
+ */
+declare function createProfanityGuardrail(options?: ProfanityGuardrailOptions): OutputGuardrail<string>;
+/**
+ * Guardrail that enforces a maximum character length.
+ */
+declare function createMaxLengthGuardrail(options: MaxLengthGuardrailOptions): OutputGuardrail<string>;
+declare function createProfanityInputGuardrail(options?: ProfanityInputGuardrailOptions): InputGuardrail;
+declare function createPIIInputGuardrail(options?: PIIInputGuardrailOptions): InputGuardrail;
+declare function createPromptInjectionGuardrail(options?: PromptInjectionGuardrailOptions): InputGuardrail;
+declare function createInputLengthGuardrail(options: InputLengthGuardrailOptions): InputGuardrail;
+declare function createHTMLSanitizerInputGuardrail(options?: HTMLSanitizerGuardrailOptions): InputGuardrail;
+declare function createDefaultInputSafetyGuardrails(): InputGuardrail[];
+/**
+ * Convenience helper that returns a collection of common PII guardrails.
+ */
+declare function createDefaultPIIGuardrails(options?: {
+    sensitiveNumber?: SensitiveNumberGuardrailOptions;
+    email?: EmailGuardrailOptions;
+    phone?: PhoneGuardrailOptions;
+}): OutputGuardrail<string>[];
+/**
+ * Convenience helper that returns commonly recommended safety guardrails.
+ */
+declare function createDefaultSafetyGuardrails(options?: {
+    profanity?: ProfanityGuardrailOptions;
+    maxLength?: MaxLengthGuardrailOptions;
+}): OutputGuardrail<string>[];
+
+type EmptyGuardrailExtras = Record<never, never>;
+type CreateGuardrailDefinition<TArgs, TResult, TExtra extends Record<PropertyKey, unknown> = EmptyGuardrailExtras> = Omit<GuardrailDefinition<TArgs, TResult>, keyof TExtra | "handler"> & TExtra & {
+    handler: GuardrailFunction<TArgs, TResult>;
+};
+type CreateInputGuardrailOptions = CreateGuardrailDefinition<InputGuardrailArgs, InputGuardrailResult>;
+type CreateOutputGuardrailOptions<TOutput = unknown> = CreateGuardrailDefinition<OutputGuardrailArgs<TOutput>, OutputGuardrailResult<TOutput>, {
+    streamHandler?: OutputGuardrailStreamHandler;
+}>;
+declare function createInputGuardrail(options: CreateInputGuardrailOptions): InputGuardrail;
+declare function createOutputGuardrail<TOutput = unknown>(options: CreateOutputGuardrailOptions<TOutput>): OutputGuardrail<TOutput>;
+
 /**
  * In-Memory Storage Adapter for Memory V2
  * Stores conversations and messages in memory
@@ -6104,10 +6715,6 @@ declare class InMemoryStorageAdapter implements StorageAdapter {
     private users;
     private workflowStates;
     private workflowStatesByWorkflow;
-    private storageLimit;
-    constructor(options?: {
-        storageLimit?: number;
-    });
     /**
      * Add a single message
      */
@@ -7032,9 +7639,11 @@ declare enum NodeType {
     MEMORY = "memory",
     MESSAGE = "message",
     OUTPUT = "output",
+    GUARDRAIL = "guardrail",
     RETRIEVER = "retriever",
     VECTOR = "vector",
     EMBEDDING = "embedding",
+    SCORER = "scorer",
     WORKFLOW_STEP = "workflow_step",
     WORKFLOW_AGENT_STEP = "workflow_agent_step",
     WORKFLOW_FUNC_STEP = "workflow_func_step",
@@ -7665,4 +8274,4 @@ declare class VoltAgent {
  */
 declare function convertUsage(usage: LanguageModelUsage | undefined): UsageInfo | undefined;
 
-export { A2AServerRegistry, AbortError, Agent, type AgentFullState, type AgentHookOnEnd, type AgentHookOnError, type AgentHookOnHandoff, type AgentHookOnPrepareMessages, type AgentHookOnPrepareModelMessages, type AgentHookOnStart, type AgentHookOnStepFinish, type AgentHookOnToolEnd, type AgentHookOnToolStart, type AgentHooks, type AgentOptions, AgentRegistry, type AgentResponse, type AgentStatus, type AgentTool, AiSdkEmbeddingAdapter, type AllowedVariableValue, type ApiToolInfo, type BaseEventMetadata, type BaseGenerationOptions, type BaseLLMOptions, type BaseMessage, BaseRetriever, type BaseTool, type BaseToolCall, type CachedPrompt, type ChatMessage, 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 CreateReasoningToolsOptions, DEFAULT_INSTRUCTIONS, type DataContent, type Document, type DynamicValue, type DynamicValueOptions, type EmbeddingAdapter$1 as EmbeddingAdapter, EmbeddingAdapterNotConfiguredError, EmbeddingError, type ExtractVariableNames, FEW_SHOT_EXAMPLES, type GenerateObjectOptions, type GenerateObjectSubAgentConfig, type GenerateTextOptions, type GenerateTextSubAgentConfig, type GetMessagesOptions, type IServerProvider, type IServerlessProvider, type VoltOpsClient$1 as IVoltOpsClient, InMemoryStorageAdapter$1 as InMemoryObservabilityAdapter, InMemoryStorageAdapter, InMemoryVectorAdapter, type InferGenerateObjectResponse, type InferGenerateTextResponse, type InferMessage, type InferModel, type InferProviderParams, type InferStreamResponse, type InferTool, type LLMProvider, LazyRemoteExportProcessor, LocalStorageSpanProcessor, type LogFilter, LoggerProxy, MCPConfiguration, type MCPElicitationAdapter, type MCPLoggingAdapter, type MCPPromptsAdapter, type MCPResourcesAdapter, MCPServerRegistry, 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 PackageUpdateInfo, type PromptApiClient, type PromptApiResponse, type PromptContent, type PromptCreator, type PromptHelper, type PromptReference, type PromptTemplate, type ProviderObjectResponse, type ProviderObjectStreamResponse, type ProviderParams, type ProviderResponse, type ProviderTextResponse, type ProviderTextStreamResponse, type ReadableStreamType, type ReasoningStep, ReasoningStepSchema, type RegisterOptions, type RegisteredWorkflow, type RemoteLogExportConfig, RemoteLogProcessor, type RetrieveOptions, type Retriever, type RetrieverOptions, type SearchOptions, type SearchResult, type ServerAgentResponse, type ServerApiResponse, type ServerProviderDeps, type ServerProviderFactory, type ServerWorkflowResponse, type ServerlessProviderFactory, type ServerlessRemoteEndpointConfig, type ServerlessRemoteExportConfig, type ServerlessRequestHandler, ServerlessVoltAgentObservability, type SpanAttributes, type SpanEvent, type SpanFilterConfig, SpanFilterProcessor, SpanKind, type SpanLink, type SpanStatus, SpanStatusCode, type SpanTreeNode, type StepChunkCallback, type StepFinishCallback, type StepWithContent, type StopWhen, type StorageAdapter, StorageError, StorageLogProcessor, type StoredUIMessage, type StreamObjectFinishResult, type StreamObjectOnFinishCallback, type StreamObjectOptions, type StreamObjectSubAgentConfig, type StreamPart, type StreamTextFinishResult, type StreamTextOnFinishCallback, type StreamTextOptions, type StreamTextSubAgentConfig, type SubAgentConfig, type SubAgentMethod, type SubAgentStateData, type SupervisorConfig, type TemplateVariables, type TimelineEventCoreLevel, type TimelineEventCoreStatus, type TimelineEventCoreType, Tool, type ToolCall, 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, VoltOpsClient, type VoltOpsClientOptions, VoltOpsPromptApiClient, type VoltOpsPromptManager, VoltOpsPromptManagerImpl, WebSocketEventEmitter, WebSocketLogProcessor, WebSocketSpanProcessor, type Workflow, type WorkflowConfig, type WorkflowExecutionContext, WorkflowRegistry, type WorkflowStateEntry, type WorkflowStats, type WorkflowStepContext, type WorkflowStepType, type WorkflowTimelineEvent, type WorkingMemoryConfig, type WorkingMemoryScope, type WorkingMemorySummary, type WorkingMemoryUpdateOptions, addTimestampToMessage, andAgent, andAll, andRace, andTap, andThen, andWhen, andWorkflow, appendToMessage, buildRetrieverLogMessage, buildSpanTree, checkForUpdates, convertUsage, cosineSimilarity, createHooks, createNodeId, createPrompt, createReasoningTools, createRetrieverTool, createSimpleTemplateEngine, createSubagent, createSuspendController, createTool, createToolkit, createVoltAgentObservability, createVoltOpsClient, createWorkflow, createWorkflowChain, createWorkflowStepNodeId, VoltAgent as default, extractFileParts, extractImageParts, extractText, extractTextParts, extractWorkflowStepInfo, filterContentParts, getContentLength, getEnvVar, getGlobalLogBuffer, getGlobalLogger, getNodeTypeFromNodeId, getWorkflowStepNodeType, hasContent, hasFilePart, hasImagePart, hasTextPart, isAbortError, isNodeRuntime, isServerlessRuntime, isStructuredContent, isTextContent, isVoltAgentError, mapMessageContent, messageHelpers, normalizeContent, normalizeToArray, prependToMessage, readableLogRecordToObservabilityLog, readableSpanToObservabilitySpan, safeJsonParse, serializeValueForDebug, tool, transformTextContent, updateAllPackages, updateSinglePackage, zodSchemaToJsonUI };
+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 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 };