@voltagent/core 2.2.2 → 2.3.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 +273 -311
- package/dist/index.d.ts +273 -311
- package/dist/index.js +578 -480
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +577 -478
- package/dist/index.mjs.map +1 -1
- package/docs/blog/2026-01-23-tool-routing/index.md +40 -117
- package/docs/blog/2026-01-28-agent-middleware/index.md +161 -0
- package/docs/getting-started/ai-assistants.md +1 -1
- package/docs/recipes/tool-routing.md +14 -37
- package/docs/tools/tool-routing.md +48 -154
- package/package.json +1 -1
- package/docs/repo-docs/tool-routing-plan.md +0 -99
package/dist/index.d.mts
CHANGED
|
@@ -321,102 +321,65 @@ interface EmbeddingOptions {
|
|
|
321
321
|
normalize?: boolean;
|
|
322
322
|
}
|
|
323
323
|
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
type ToolRouterMode = "agent" | "resolver";
|
|
327
|
-
type ToolRouterSelection = {
|
|
324
|
+
type ToolSearchSelection = {
|
|
328
325
|
name: string;
|
|
329
326
|
score?: number;
|
|
330
327
|
reason?: string;
|
|
331
328
|
};
|
|
332
|
-
type
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
error?: string;
|
|
329
|
+
type ToolSearchResultItem = {
|
|
330
|
+
name: string;
|
|
331
|
+
description: string | null;
|
|
332
|
+
tags: string[] | null;
|
|
333
|
+
parametersSchema: unknown | null;
|
|
334
|
+
outputSchema: unknown | null;
|
|
335
|
+
score?: number;
|
|
336
|
+
reason?: string;
|
|
341
337
|
};
|
|
342
|
-
type
|
|
338
|
+
type ToolSearchResult = {
|
|
343
339
|
query: string;
|
|
344
|
-
selections:
|
|
345
|
-
|
|
340
|
+
selections: ToolSearchSelection[];
|
|
341
|
+
tools: ToolSearchResultItem[];
|
|
346
342
|
};
|
|
347
|
-
type
|
|
343
|
+
type ToolSearchCandidate = {
|
|
348
344
|
name: string;
|
|
349
345
|
description?: string;
|
|
350
346
|
tags?: string[];
|
|
351
347
|
parameters?: unknown;
|
|
348
|
+
outputSchema?: unknown;
|
|
352
349
|
tool: Tool<any, any> | ProviderTool;
|
|
353
350
|
};
|
|
354
|
-
type
|
|
351
|
+
type ToolSearchContext = {
|
|
355
352
|
agentId: string;
|
|
356
353
|
agentName: string;
|
|
357
354
|
operationContext: OperationContext;
|
|
358
|
-
|
|
355
|
+
searchToolName?: string;
|
|
359
356
|
parentSpan?: Span;
|
|
360
357
|
};
|
|
361
|
-
type
|
|
358
|
+
type ToolSearchStrategy = {
|
|
362
359
|
select: (params: {
|
|
363
360
|
query: string;
|
|
364
|
-
tools:
|
|
361
|
+
tools: ToolSearchCandidate[];
|
|
365
362
|
topK: number;
|
|
366
|
-
context:
|
|
367
|
-
}) => Promise<
|
|
368
|
-
};
|
|
369
|
-
type ToolArgumentResolver = (params: {
|
|
370
|
-
query: string;
|
|
371
|
-
tool: Tool<any, any>;
|
|
372
|
-
context: ToolRouterContext;
|
|
373
|
-
}) => Promise<Record<string, unknown>>;
|
|
374
|
-
type ToolRouterMetadata = {
|
|
375
|
-
strategy: ToolRouterStrategy;
|
|
376
|
-
mode?: ToolRouterMode;
|
|
377
|
-
executionModel?: AgentModelValue;
|
|
378
|
-
resolver?: ToolArgumentResolver;
|
|
379
|
-
topK?: number;
|
|
380
|
-
parallel?: boolean;
|
|
381
|
-
};
|
|
382
|
-
type ToolRouter = Tool<any, any> & {
|
|
383
|
-
[TOOL_ROUTER_SYMBOL]: ToolRouterMetadata;
|
|
363
|
+
context: ToolSearchContext;
|
|
364
|
+
}) => Promise<ToolSearchSelection[]>;
|
|
384
365
|
};
|
|
385
366
|
type ToolRoutingEmbeddingConfig = {
|
|
386
367
|
model: EmbeddingAdapter$1 | EmbeddingModelReference;
|
|
387
368
|
normalize?: boolean;
|
|
388
369
|
maxBatchSize?: number;
|
|
389
370
|
topK?: number;
|
|
390
|
-
toolText?: (tool:
|
|
371
|
+
toolText?: (tool: ToolSearchCandidate) => string;
|
|
391
372
|
};
|
|
392
373
|
type ToolRoutingEmbeddingInput = ToolRoutingEmbeddingConfig | EmbeddingAdapter$1 | EmbeddingModelReference;
|
|
393
374
|
type ToolRoutingConfig = {
|
|
394
|
-
routers?: ToolRouter[];
|
|
395
375
|
pool?: (Tool<any, any> | Toolkit | Tool$1)[];
|
|
396
376
|
expose?: (Tool<any, any> | Toolkit | Tool$1)[];
|
|
397
|
-
mode?: ToolRouterMode;
|
|
398
|
-
executionModel?: AgentModelValue;
|
|
399
377
|
embedding?: ToolRoutingEmbeddingInput;
|
|
400
378
|
topK?: number;
|
|
401
|
-
|
|
379
|
+
enforceSearchBeforeCall?: boolean;
|
|
402
380
|
};
|
|
403
381
|
|
|
404
|
-
declare const
|
|
405
|
-
|
|
406
|
-
type CreateToolRouterOptions = {
|
|
407
|
-
name: string;
|
|
408
|
-
description: string;
|
|
409
|
-
strategy?: ToolRouterStrategy;
|
|
410
|
-
embedding?: ToolRoutingEmbeddingInput;
|
|
411
|
-
mode?: ToolRouterMode;
|
|
412
|
-
executionModel?: ToolRouterMetadata["executionModel"];
|
|
413
|
-
resolver?: ToolArgumentResolver;
|
|
414
|
-
topK?: number;
|
|
415
|
-
parallel?: boolean;
|
|
416
|
-
parameters?: ToolSchema;
|
|
417
|
-
};
|
|
418
|
-
declare const createToolRouter: (options: CreateToolRouterOptions) => ToolRouter;
|
|
419
|
-
declare const isToolRouter: (tool: unknown) => tool is ToolRouter;
|
|
382
|
+
declare const createEmbeddingToolSearchStrategy: (input: ToolRoutingEmbeddingInput) => ToolSearchStrategy;
|
|
420
383
|
|
|
421
384
|
/**
|
|
422
385
|
* JSON value types (matches AI SDK's JSONValue)
|
|
@@ -7029,9 +6992,12 @@ interface ApiToolInfo {
|
|
|
7029
6992
|
parameters?: any;
|
|
7030
6993
|
}
|
|
7031
6994
|
interface AgentToolRoutingState {
|
|
7032
|
-
|
|
6995
|
+
search?: ApiToolInfo;
|
|
6996
|
+
call?: ApiToolInfo;
|
|
7033
6997
|
expose?: ApiToolInfo[];
|
|
7034
6998
|
pool?: ApiToolInfo[];
|
|
6999
|
+
enforceSearchBeforeCall?: boolean;
|
|
7000
|
+
topK?: number;
|
|
7035
7001
|
}
|
|
7036
7002
|
type AgentFeedbackOptions = {
|
|
7037
7003
|
key?: string;
|
|
@@ -8420,6 +8386,7 @@ declare class Agent {
|
|
|
8420
8386
|
private toolRoutingConfigured;
|
|
8421
8387
|
private toolRoutingExposedNames;
|
|
8422
8388
|
private toolRoutingPoolExplicit;
|
|
8389
|
+
private toolRoutingSearchStrategy?;
|
|
8423
8390
|
constructor(options: AgentOptions);
|
|
8424
8391
|
/**
|
|
8425
8392
|
* Generate text response
|
|
@@ -8548,18 +8515,20 @@ declare class Agent {
|
|
|
8548
8515
|
*/
|
|
8549
8516
|
private validateToolOutput;
|
|
8550
8517
|
private createToolExecutionFactory;
|
|
8551
|
-
|
|
8552
|
-
|
|
8553
|
-
|
|
8554
|
-
|
|
8555
|
-
|
|
8556
|
-
|
|
8557
|
-
|
|
8558
|
-
|
|
8559
|
-
private
|
|
8560
|
-
private
|
|
8561
|
-
private
|
|
8562
|
-
private
|
|
8518
|
+
private getToolRoutingSupportToolNames;
|
|
8519
|
+
private isToolRoutingSupportTool;
|
|
8520
|
+
private isToolExecutableForRouting;
|
|
8521
|
+
private getToolRoutingFromContext;
|
|
8522
|
+
private getToolSearchStrategy;
|
|
8523
|
+
private buildToolSearchCandidates;
|
|
8524
|
+
private rankToolSearchCandidates;
|
|
8525
|
+
private selectToolSearchCandidates;
|
|
8526
|
+
private toToolSearchResultItem;
|
|
8527
|
+
private recordSearchedTools;
|
|
8528
|
+
private getSearchedTools;
|
|
8529
|
+
private createToolRoutingSearchTool;
|
|
8530
|
+
private createToolRoutingCallTool;
|
|
8531
|
+
private executeProviderToolViaCallTool;
|
|
8563
8532
|
private ensureToolApproval;
|
|
8564
8533
|
private runInternalGenerateText;
|
|
8565
8534
|
/**
|
|
@@ -8666,7 +8635,9 @@ declare class Agent {
|
|
|
8666
8635
|
*/
|
|
8667
8636
|
__setDefaultToolRouting(toolRouting?: ToolRoutingConfig): void;
|
|
8668
8637
|
private applyToolRoutingConfig;
|
|
8669
|
-
private
|
|
8638
|
+
private removeToolRoutingSupportTools;
|
|
8639
|
+
private upsertToolRoutingSupportTool;
|
|
8640
|
+
private assertNoToolRoutingNameConflicts;
|
|
8670
8641
|
private resolveToolRouting;
|
|
8671
8642
|
private getToolRoutingExposedNames;
|
|
8672
8643
|
/**
|
|
@@ -8726,6 +8697,230 @@ declare class Agent {
|
|
|
8726
8697
|
private createWorkingMemoryTools;
|
|
8727
8698
|
}
|
|
8728
8699
|
|
|
8700
|
+
/**
|
|
8701
|
+
* WorkflowTraceContext - Manages trace hierarchy and common attributes for workflows
|
|
8702
|
+
*
|
|
8703
|
+
* Similar to AgentTraceContext but tailored for workflow execution:
|
|
8704
|
+
* 1. Common attributes (workflowId, executionId, userId, etc.) are set once and inherited
|
|
8705
|
+
* 2. Parent-child span relationships for workflow steps
|
|
8706
|
+
* 3. Support for parallel step execution
|
|
8707
|
+
* 4. Suspend/resume state tracking
|
|
8708
|
+
* 5. Clean integration with VoltAgentObservability
|
|
8709
|
+
*/
|
|
8710
|
+
|
|
8711
|
+
interface WorkflowTraceContextOptions {
|
|
8712
|
+
workflowId: string;
|
|
8713
|
+
workflowName: string;
|
|
8714
|
+
executionId: string;
|
|
8715
|
+
userId?: string;
|
|
8716
|
+
conversationId?: string;
|
|
8717
|
+
parentSpan?: Span;
|
|
8718
|
+
input?: any;
|
|
8719
|
+
context?: Map<string | symbol, unknown>;
|
|
8720
|
+
resumedFrom?: {
|
|
8721
|
+
traceId: string;
|
|
8722
|
+
spanId: string;
|
|
8723
|
+
};
|
|
8724
|
+
}
|
|
8725
|
+
declare class WorkflowTraceContext {
|
|
8726
|
+
private rootSpan;
|
|
8727
|
+
private tracer;
|
|
8728
|
+
private commonAttributes;
|
|
8729
|
+
private activeContext;
|
|
8730
|
+
private stepSpans;
|
|
8731
|
+
constructor(observability: VoltAgentObservability, operationName: string, options: WorkflowTraceContextOptions);
|
|
8732
|
+
/**
|
|
8733
|
+
* Create a child span for a workflow step
|
|
8734
|
+
*/
|
|
8735
|
+
createStepSpan(stepIndex: number, stepType: string, stepName: string, options?: {
|
|
8736
|
+
stepId?: string;
|
|
8737
|
+
parentStepId?: string;
|
|
8738
|
+
parallelIndex?: number;
|
|
8739
|
+
input?: any;
|
|
8740
|
+
attributes?: Record<string, any>;
|
|
8741
|
+
}): Span;
|
|
8742
|
+
/**
|
|
8743
|
+
* Create spans for parallel steps
|
|
8744
|
+
*/
|
|
8745
|
+
createParallelStepSpans(parentStepIndex: number, parentStepType: string, parentStepName: string, parallelSteps: Array<{
|
|
8746
|
+
index: number;
|
|
8747
|
+
type: string;
|
|
8748
|
+
name: string;
|
|
8749
|
+
id?: string;
|
|
8750
|
+
}>): {
|
|
8751
|
+
parentSpan: Span;
|
|
8752
|
+
childSpans: Span[];
|
|
8753
|
+
};
|
|
8754
|
+
/**
|
|
8755
|
+
* Create a generic child span under the workflow root or an optional parent span
|
|
8756
|
+
*/
|
|
8757
|
+
createChildSpan(name: string, type: string, options?: {
|
|
8758
|
+
label?: string;
|
|
8759
|
+
attributes?: Record<string, any>;
|
|
8760
|
+
kind?: SpanKind$1;
|
|
8761
|
+
parentSpan?: Span;
|
|
8762
|
+
}): Span;
|
|
8763
|
+
/**
|
|
8764
|
+
* Record a suspension event on the workflow
|
|
8765
|
+
*/
|
|
8766
|
+
recordSuspension(stepIndex: number, reason: string, suspendData?: any, checkpoint?: any): void;
|
|
8767
|
+
/**
|
|
8768
|
+
* Record a cancellation event on the workflow
|
|
8769
|
+
*/
|
|
8770
|
+
recordCancellation(reason?: string): void;
|
|
8771
|
+
/**
|
|
8772
|
+
* Record a resume event on the workflow
|
|
8773
|
+
*/
|
|
8774
|
+
recordResume(stepIndex: number, resumeData?: any): void;
|
|
8775
|
+
/**
|
|
8776
|
+
* Execute a function within a span's context
|
|
8777
|
+
*/
|
|
8778
|
+
withSpan<T>(span: Span, fn: () => T | Promise<T>): Promise<T>;
|
|
8779
|
+
/**
|
|
8780
|
+
* Get the root span
|
|
8781
|
+
*/
|
|
8782
|
+
getRootSpan(): Span;
|
|
8783
|
+
/**
|
|
8784
|
+
* Set input on the root span
|
|
8785
|
+
*/
|
|
8786
|
+
setInput(input: any): void;
|
|
8787
|
+
/**
|
|
8788
|
+
* Set output on the root span
|
|
8789
|
+
*/
|
|
8790
|
+
setOutput(output: any): void;
|
|
8791
|
+
/**
|
|
8792
|
+
* Set usage information on the root span
|
|
8793
|
+
*/
|
|
8794
|
+
setUsage(usage: any): void;
|
|
8795
|
+
/**
|
|
8796
|
+
* End the root span with a status
|
|
8797
|
+
*/
|
|
8798
|
+
end(status: "completed" | "suspended" | "cancelled" | "error", error?: Error | any): void;
|
|
8799
|
+
/**
|
|
8800
|
+
* End a step span with proper status
|
|
8801
|
+
*/
|
|
8802
|
+
endStepSpan(span: Span, status: "completed" | "skipped" | "suspended" | "cancelled" | "error", options?: {
|
|
8803
|
+
output?: any;
|
|
8804
|
+
error?: Error | any;
|
|
8805
|
+
attributes?: Record<string, any>;
|
|
8806
|
+
skippedReason?: string;
|
|
8807
|
+
suspensionReason?: string;
|
|
8808
|
+
cancellationReason?: string;
|
|
8809
|
+
}): void;
|
|
8810
|
+
/**
|
|
8811
|
+
* Get the active context for manual context propagation
|
|
8812
|
+
*/
|
|
8813
|
+
getActiveContext(): Context;
|
|
8814
|
+
/**
|
|
8815
|
+
* Update active context with a new span
|
|
8816
|
+
*/
|
|
8817
|
+
updateActiveContext(span: Span): void;
|
|
8818
|
+
/**
|
|
8819
|
+
* Clear step spans (useful for cleanup after parallel execution)
|
|
8820
|
+
*/
|
|
8821
|
+
clearStepSpans(): void;
|
|
8822
|
+
}
|
|
8823
|
+
|
|
8824
|
+
/**
|
|
8825
|
+
* Context information for a workflow execution
|
|
8826
|
+
* Contains all the runtime information about a workflow execution
|
|
8827
|
+
*/
|
|
8828
|
+
interface WorkflowExecutionContext {
|
|
8829
|
+
/**
|
|
8830
|
+
* Unique identifier for the workflow definition
|
|
8831
|
+
*/
|
|
8832
|
+
workflowId: string;
|
|
8833
|
+
/**
|
|
8834
|
+
* Unique identifier for this specific execution
|
|
8835
|
+
*/
|
|
8836
|
+
executionId: string;
|
|
8837
|
+
/**
|
|
8838
|
+
* Human-readable name of the workflow
|
|
8839
|
+
*/
|
|
8840
|
+
workflowName: string;
|
|
8841
|
+
/**
|
|
8842
|
+
* User-defined context passed around during execution
|
|
8843
|
+
*/
|
|
8844
|
+
context: Map<string | symbol, unknown>;
|
|
8845
|
+
/**
|
|
8846
|
+
* Shared workflow state available to all steps
|
|
8847
|
+
*/
|
|
8848
|
+
workflowState: WorkflowStateStore;
|
|
8849
|
+
/**
|
|
8850
|
+
* Whether the workflow is still actively running
|
|
8851
|
+
*/
|
|
8852
|
+
isActive: boolean;
|
|
8853
|
+
/**
|
|
8854
|
+
* When the workflow execution started
|
|
8855
|
+
*/
|
|
8856
|
+
startTime: Date;
|
|
8857
|
+
/**
|
|
8858
|
+
* Current step index being executed
|
|
8859
|
+
*/
|
|
8860
|
+
currentStepIndex: number;
|
|
8861
|
+
/**
|
|
8862
|
+
* Array of completed steps (for tracking)
|
|
8863
|
+
*/
|
|
8864
|
+
steps: any[];
|
|
8865
|
+
/**
|
|
8866
|
+
* AbortSignal for cancelling the workflow
|
|
8867
|
+
*/
|
|
8868
|
+
signal?: AbortSignal;
|
|
8869
|
+
/**
|
|
8870
|
+
* Memory storage instance for this workflow execution
|
|
8871
|
+
* Can be workflow-specific or global
|
|
8872
|
+
*/
|
|
8873
|
+
memory?: Memory;
|
|
8874
|
+
/**
|
|
8875
|
+
* Map of executed step data (input and output) by step ID
|
|
8876
|
+
* Used for accessing previous step results
|
|
8877
|
+
*/
|
|
8878
|
+
stepData: Map<string, WorkflowStepData>;
|
|
8879
|
+
/**
|
|
8880
|
+
* Current event sequence number for this workflow execution
|
|
8881
|
+
* Used to maintain event ordering even after server restarts
|
|
8882
|
+
*/
|
|
8883
|
+
eventSequence: number;
|
|
8884
|
+
/**
|
|
8885
|
+
* Logger instance for this workflow execution
|
|
8886
|
+
* Provides execution-scoped logging with full context (userId, conversationId, executionId)
|
|
8887
|
+
*/
|
|
8888
|
+
logger: Logger;
|
|
8889
|
+
/**
|
|
8890
|
+
* Stream writer for emitting events during streaming execution
|
|
8891
|
+
* Always available - uses NoOpWorkflowStreamWriter when not streaming
|
|
8892
|
+
*/
|
|
8893
|
+
streamWriter: WorkflowStreamWriter;
|
|
8894
|
+
/**
|
|
8895
|
+
* OpenTelemetry trace context for observability
|
|
8896
|
+
* Manages span hierarchy and attributes for the workflow execution
|
|
8897
|
+
*/
|
|
8898
|
+
traceContext?: WorkflowTraceContext;
|
|
8899
|
+
/**
|
|
8900
|
+
* Optional agent instance supplied to workflow guardrails
|
|
8901
|
+
*/
|
|
8902
|
+
guardrailAgent?: Agent;
|
|
8903
|
+
/**
|
|
8904
|
+
* Current step span for passing to agents called within workflow steps
|
|
8905
|
+
* This enables agent spans to appear as children of workflow step spans
|
|
8906
|
+
*/
|
|
8907
|
+
currentStepSpan?: Span;
|
|
8908
|
+
}
|
|
8909
|
+
/**
|
|
8910
|
+
* Workflow step context for individual step tracking
|
|
8911
|
+
*/
|
|
8912
|
+
interface WorkflowStepContext {
|
|
8913
|
+
stepId: string;
|
|
8914
|
+
stepIndex: number;
|
|
8915
|
+
stepType: "agent" | "func" | "conditional-when" | "parallel-all" | "parallel-race" | "tap" | "workflow" | "guardrail" | "sleep" | "sleep-until" | "foreach" | "loop" | "branch" | "map";
|
|
8916
|
+
stepName: string;
|
|
8917
|
+
workflowId: string;
|
|
8918
|
+
executionId: string;
|
|
8919
|
+
parentStepId?: string;
|
|
8920
|
+
parallelIndex?: number;
|
|
8921
|
+
startTime: Date;
|
|
8922
|
+
}
|
|
8923
|
+
|
|
8729
8924
|
type WorkflowStateStatus = "pending" | "running" | "completed" | "failed" | "suspended" | "cancelled";
|
|
8730
8925
|
type WorkflowState<INPUT, RESULT> = {
|
|
8731
8926
|
executionId: string;
|
|
@@ -9396,252 +9591,18 @@ type WorkflowStepState<INPUT> = Omit<WorkflowState<INPUT, DangerouslyAllowAny>,
|
|
|
9396
9591
|
signal?: AbortSignal;
|
|
9397
9592
|
};
|
|
9398
9593
|
|
|
9399
|
-
/**
|
|
9400
|
-
* WorkflowTraceContext - Manages trace hierarchy and common attributes for workflows
|
|
9401
|
-
*
|
|
9402
|
-
* Similar to AgentTraceContext but tailored for workflow execution:
|
|
9403
|
-
* 1. Common attributes (workflowId, executionId, userId, etc.) are set once and inherited
|
|
9404
|
-
* 2. Parent-child span relationships for workflow steps
|
|
9405
|
-
* 3. Support for parallel step execution
|
|
9406
|
-
* 4. Suspend/resume state tracking
|
|
9407
|
-
* 5. Clean integration with VoltAgentObservability
|
|
9408
|
-
*/
|
|
9409
|
-
|
|
9410
|
-
interface WorkflowTraceContextOptions {
|
|
9411
|
-
workflowId: string;
|
|
9412
|
-
workflowName: string;
|
|
9413
|
-
executionId: string;
|
|
9414
|
-
userId?: string;
|
|
9415
|
-
conversationId?: string;
|
|
9416
|
-
parentSpan?: Span;
|
|
9417
|
-
input?: any;
|
|
9418
|
-
context?: Map<string | symbol, unknown>;
|
|
9419
|
-
resumedFrom?: {
|
|
9420
|
-
traceId: string;
|
|
9421
|
-
spanId: string;
|
|
9422
|
-
};
|
|
9423
|
-
}
|
|
9424
|
-
declare class WorkflowTraceContext {
|
|
9425
|
-
private rootSpan;
|
|
9426
|
-
private tracer;
|
|
9427
|
-
private commonAttributes;
|
|
9428
|
-
private activeContext;
|
|
9429
|
-
private stepSpans;
|
|
9430
|
-
constructor(observability: VoltAgentObservability, operationName: string, options: WorkflowTraceContextOptions);
|
|
9431
|
-
/**
|
|
9432
|
-
* Create a child span for a workflow step
|
|
9433
|
-
*/
|
|
9434
|
-
createStepSpan(stepIndex: number, stepType: string, stepName: string, options?: {
|
|
9435
|
-
stepId?: string;
|
|
9436
|
-
parentStepId?: string;
|
|
9437
|
-
parallelIndex?: number;
|
|
9438
|
-
input?: any;
|
|
9439
|
-
attributes?: Record<string, any>;
|
|
9440
|
-
}): Span;
|
|
9441
|
-
/**
|
|
9442
|
-
* Create spans for parallel steps
|
|
9443
|
-
*/
|
|
9444
|
-
createParallelStepSpans(parentStepIndex: number, parentStepType: string, parentStepName: string, parallelSteps: Array<{
|
|
9445
|
-
index: number;
|
|
9446
|
-
type: string;
|
|
9447
|
-
name: string;
|
|
9448
|
-
id?: string;
|
|
9449
|
-
}>): {
|
|
9450
|
-
parentSpan: Span;
|
|
9451
|
-
childSpans: Span[];
|
|
9452
|
-
};
|
|
9453
|
-
/**
|
|
9454
|
-
* Create a generic child span under the workflow root or an optional parent span
|
|
9455
|
-
*/
|
|
9456
|
-
createChildSpan(name: string, type: string, options?: {
|
|
9457
|
-
label?: string;
|
|
9458
|
-
attributes?: Record<string, any>;
|
|
9459
|
-
kind?: SpanKind$1;
|
|
9460
|
-
parentSpan?: Span;
|
|
9461
|
-
}): Span;
|
|
9462
|
-
/**
|
|
9463
|
-
* Record a suspension event on the workflow
|
|
9464
|
-
*/
|
|
9465
|
-
recordSuspension(stepIndex: number, reason: string, suspendData?: any, checkpoint?: any): void;
|
|
9466
|
-
/**
|
|
9467
|
-
* Record a cancellation event on the workflow
|
|
9468
|
-
*/
|
|
9469
|
-
recordCancellation(reason?: string): void;
|
|
9470
|
-
/**
|
|
9471
|
-
* Record a resume event on the workflow
|
|
9472
|
-
*/
|
|
9473
|
-
recordResume(stepIndex: number, resumeData?: any): void;
|
|
9474
|
-
/**
|
|
9475
|
-
* Execute a function within a span's context
|
|
9476
|
-
*/
|
|
9477
|
-
withSpan<T>(span: Span, fn: () => T | Promise<T>): Promise<T>;
|
|
9478
|
-
/**
|
|
9479
|
-
* Get the root span
|
|
9480
|
-
*/
|
|
9481
|
-
getRootSpan(): Span;
|
|
9482
|
-
/**
|
|
9483
|
-
* Set input on the root span
|
|
9484
|
-
*/
|
|
9485
|
-
setInput(input: any): void;
|
|
9486
|
-
/**
|
|
9487
|
-
* Set output on the root span
|
|
9488
|
-
*/
|
|
9489
|
-
setOutput(output: any): void;
|
|
9490
|
-
/**
|
|
9491
|
-
* Set usage information on the root span
|
|
9492
|
-
*/
|
|
9493
|
-
setUsage(usage: any): void;
|
|
9494
|
-
/**
|
|
9495
|
-
* End the root span with a status
|
|
9496
|
-
*/
|
|
9497
|
-
end(status: "completed" | "suspended" | "cancelled" | "error", error?: Error | any): void;
|
|
9498
|
-
/**
|
|
9499
|
-
* End a step span with proper status
|
|
9500
|
-
*/
|
|
9501
|
-
endStepSpan(span: Span, status: "completed" | "skipped" | "suspended" | "cancelled" | "error", options?: {
|
|
9502
|
-
output?: any;
|
|
9503
|
-
error?: Error | any;
|
|
9504
|
-
attributes?: Record<string, any>;
|
|
9505
|
-
skippedReason?: string;
|
|
9506
|
-
suspensionReason?: string;
|
|
9507
|
-
cancellationReason?: string;
|
|
9508
|
-
}): void;
|
|
9509
|
-
/**
|
|
9510
|
-
* Get the active context for manual context propagation
|
|
9511
|
-
*/
|
|
9512
|
-
getActiveContext(): Context;
|
|
9513
|
-
/**
|
|
9514
|
-
* Update active context with a new span
|
|
9515
|
-
*/
|
|
9516
|
-
updateActiveContext(span: Span): void;
|
|
9517
|
-
/**
|
|
9518
|
-
* Clear step spans (useful for cleanup after parallel execution)
|
|
9519
|
-
*/
|
|
9520
|
-
clearStepSpans(): void;
|
|
9521
|
-
}
|
|
9522
|
-
|
|
9523
|
-
/**
|
|
9524
|
-
* Context information for a workflow execution
|
|
9525
|
-
* Contains all the runtime information about a workflow execution
|
|
9526
|
-
*/
|
|
9527
|
-
interface WorkflowExecutionContext {
|
|
9528
|
-
/**
|
|
9529
|
-
* Unique identifier for the workflow definition
|
|
9530
|
-
*/
|
|
9531
|
-
workflowId: string;
|
|
9532
|
-
/**
|
|
9533
|
-
* Unique identifier for this specific execution
|
|
9534
|
-
*/
|
|
9535
|
-
executionId: string;
|
|
9536
|
-
/**
|
|
9537
|
-
* Human-readable name of the workflow
|
|
9538
|
-
*/
|
|
9539
|
-
workflowName: string;
|
|
9540
|
-
/**
|
|
9541
|
-
* User-defined context passed around during execution
|
|
9542
|
-
*/
|
|
9543
|
-
context: Map<string | symbol, unknown>;
|
|
9544
|
-
/**
|
|
9545
|
-
* Shared workflow state available to all steps
|
|
9546
|
-
*/
|
|
9547
|
-
workflowState: WorkflowStateStore;
|
|
9548
|
-
/**
|
|
9549
|
-
* Whether the workflow is still actively running
|
|
9550
|
-
*/
|
|
9551
|
-
isActive: boolean;
|
|
9552
|
-
/**
|
|
9553
|
-
* When the workflow execution started
|
|
9554
|
-
*/
|
|
9555
|
-
startTime: Date;
|
|
9556
|
-
/**
|
|
9557
|
-
* Current step index being executed
|
|
9558
|
-
*/
|
|
9559
|
-
currentStepIndex: number;
|
|
9560
|
-
/**
|
|
9561
|
-
* Array of completed steps (for tracking)
|
|
9562
|
-
*/
|
|
9563
|
-
steps: any[];
|
|
9564
|
-
/**
|
|
9565
|
-
* AbortSignal for cancelling the workflow
|
|
9566
|
-
*/
|
|
9567
|
-
signal?: AbortSignal;
|
|
9568
|
-
/**
|
|
9569
|
-
* Memory storage instance for this workflow execution
|
|
9570
|
-
* Can be workflow-specific or global
|
|
9571
|
-
*/
|
|
9572
|
-
memory?: Memory;
|
|
9573
|
-
/**
|
|
9574
|
-
* Map of executed step data (input and output) by step ID
|
|
9575
|
-
* Used for accessing previous step results
|
|
9576
|
-
*/
|
|
9577
|
-
stepData: Map<string, WorkflowStepData>;
|
|
9578
|
-
/**
|
|
9579
|
-
* Current event sequence number for this workflow execution
|
|
9580
|
-
* Used to maintain event ordering even after server restarts
|
|
9581
|
-
*/
|
|
9582
|
-
eventSequence: number;
|
|
9583
|
-
/**
|
|
9584
|
-
* Logger instance for this workflow execution
|
|
9585
|
-
* Provides execution-scoped logging with full context (userId, conversationId, executionId)
|
|
9586
|
-
*/
|
|
9587
|
-
logger: Logger;
|
|
9588
|
-
/**
|
|
9589
|
-
* Stream writer for emitting events during streaming execution
|
|
9590
|
-
* Always available - uses NoOpWorkflowStreamWriter when not streaming
|
|
9591
|
-
*/
|
|
9592
|
-
streamWriter: WorkflowStreamWriter;
|
|
9593
|
-
/**
|
|
9594
|
-
* OpenTelemetry trace context for observability
|
|
9595
|
-
* Manages span hierarchy and attributes for the workflow execution
|
|
9596
|
-
*/
|
|
9597
|
-
traceContext?: WorkflowTraceContext;
|
|
9598
|
-
/**
|
|
9599
|
-
* Optional agent instance supplied to workflow guardrails
|
|
9600
|
-
*/
|
|
9601
|
-
guardrailAgent?: Agent;
|
|
9602
|
-
/**
|
|
9603
|
-
* Current step span for passing to agents called within workflow steps
|
|
9604
|
-
* This enables agent spans to appear as children of workflow step spans
|
|
9605
|
-
*/
|
|
9606
|
-
currentStepSpan?: Span;
|
|
9607
|
-
}
|
|
9608
|
-
/**
|
|
9609
|
-
* Workflow step context for individual step tracking
|
|
9610
|
-
*/
|
|
9611
|
-
interface WorkflowStepContext {
|
|
9612
|
-
stepId: string;
|
|
9613
|
-
stepIndex: number;
|
|
9614
|
-
stepType: "agent" | "func" | "conditional-when" | "parallel-all" | "parallel-race" | "tap" | "workflow" | "guardrail" | "sleep" | "sleep-until" | "foreach" | "loop" | "branch" | "map";
|
|
9615
|
-
stepName: string;
|
|
9616
|
-
workflowId: string;
|
|
9617
|
-
executionId: string;
|
|
9618
|
-
parentStepId?: string;
|
|
9619
|
-
parallelIndex?: number;
|
|
9620
|
-
startTime: Date;
|
|
9621
|
-
}
|
|
9622
|
-
|
|
9623
9594
|
/**
|
|
9624
9595
|
* The base input type for the workflow
|
|
9625
9596
|
* @private - INTERNAL USE ONLY
|
|
9626
9597
|
*/
|
|
9627
9598
|
type InternalBaseWorkflowInputSchema = z.ZodTypeAny | BaseMessage | BaseMessage[] | UIMessage | UIMessage[] | string;
|
|
9628
|
-
/**
|
|
9629
|
-
* The state parameter for the workflow, used to pass the state to a step or other function (i.e. hooks)
|
|
9630
|
-
* @private - INTERNAL USE ONLY
|
|
9631
|
-
*/
|
|
9632
|
-
type InternalWorkflowStateParam<INPUT> = Omit<WorkflowState<INPUT, DangerouslyAllowAny>, "data" | "result"> & {
|
|
9633
|
-
/** Workflow execution context for event tracking */
|
|
9634
|
-
workflowContext?: WorkflowExecutionContext;
|
|
9635
|
-
/** AbortSignal for checking suspension during step execution */
|
|
9636
|
-
signal?: AbortSignal;
|
|
9637
|
-
};
|
|
9638
9599
|
/**
|
|
9639
9600
|
* Context object for new execute API with helper functions
|
|
9640
9601
|
* @private - INTERNAL USE ONLY
|
|
9641
9602
|
*/
|
|
9642
9603
|
interface WorkflowExecuteContext<INPUT, DATA, SUSPEND_DATA, RESUME_DATA> {
|
|
9643
9604
|
data: DATA;
|
|
9644
|
-
state:
|
|
9605
|
+
state: WorkflowStepState<INPUT>;
|
|
9645
9606
|
getStepData: (stepId: string) => WorkflowStepData | undefined;
|
|
9646
9607
|
suspend: (reason?: string, suspendData?: SUSPEND_DATA) => Promise<never>;
|
|
9647
9608
|
resumeData?: RESUME_DATA;
|
|
@@ -13075,7 +13036,8 @@ type VoltAgentOptions = {
|
|
|
13075
13036
|
*/
|
|
13076
13037
|
workflowMemory?: Memory;
|
|
13077
13038
|
/**
|
|
13078
|
-
* Global tool routing defaults (
|
|
13039
|
+
* Global tool routing defaults (search + call workflow).
|
|
13040
|
+
* When enabled, agents expose searchTools/callTool and hide pool tools from the model.
|
|
13079
13041
|
*/
|
|
13080
13042
|
toolRouting?: ToolRoutingConfig;
|
|
13081
13043
|
/** Optional VoltOps trigger handlers */
|
|
@@ -14921,4 +14883,4 @@ declare class VoltAgent {
|
|
|
14921
14883
|
*/
|
|
14922
14884
|
declare function convertUsage(usage: LanguageModelUsage | undefined): UsageInfo | undefined;
|
|
14923
14885
|
|
|
14924
|
-
export { A2AServerRegistry, AbortError, Agent, type AgentEvalConfig, type AgentEvalContext, type AgentEvalFeedbackHelper, type AgentEvalFeedbackSaveInput, type AgentEvalOperationType, type AgentEvalPayload, type AgentEvalResult, type AgentEvalResultCallbackArgs, type AgentEvalSamplingPolicy, type AgentEvalScorerConfig, type AgentEvalScorerFactory, type AgentEvalScorerReference, type AgentFeedbackMetadata, type AgentFeedbackOptions, type AgentFullState, type AgentHookOnEnd, type AgentHookOnError, type AgentHookOnFallback, type AgentHookOnHandoff, type AgentHookOnHandoffComplete, type AgentHookOnPrepareMessages, type AgentHookOnPrepareModelMessages, type AgentHookOnRetry, type AgentHookOnStart, type AgentHookOnStepFinish, type AgentHookOnToolEnd, type AgentHookOnToolStart, type AgentHooks, type AgentModelConfig, type AgentModelReference, type AgentModelValue, type AgentOptions, AgentRegistry, type AgentResponse, type AgentScorerState, type AgentStatus, type AgentSummarizationOptions, type AgentTool, AiSdkEmbeddingAdapter, type AllowedVariableValue, type ApiToolInfo, type BaseEventMetadata, type BaseGenerationOptions, type BaseLLMOptions, type BaseMessage, BaseRetriever, type BaseTool, type BaseToolCall, type BuildScorerOptions, type BuildScorerRunArgs, type BuildScorerRunResult, type BuilderAnalyzeContext, type BuilderPrepareContext, type BuilderReasonContext, type BuilderScoreContext, type CachedPrompt, type ChatMessage, ClientHTTPError, type ClientSideToolResult, type CloudflareFetchHandler, CompositeFilesystemBackend, type Conversation, ConversationAlreadyExistsError, ConversationNotFoundError, type ConversationQueryOptions, type ConversationQueryOptions as ConversationQueryOptionsV2, type ConversationStepRecord, type ConversationStepType, type ConversationTitleConfig, type ConversationTitleGenerator, ConversationTodoBackend, type Conversation as ConversationV2, type CreateConversationInput, type CreateConversationInput as CreateConversationInputV2, type CreateInputGuardrailOptions, type CreateInputMiddlewareOptions, type CreateOutputGuardrailOptions, type CreateOutputMiddlewareOptions, type CreateReasoningToolsOptions, type CreateScorerOptions, DEFAULT_INSTRUCTIONS, type DataContent, type Document, type DynamicValue, type DynamicValueOptions, EDIT_FILE_TOOL_DESCRIPTION, type EditResult, type EmbeddingAdapter, type EmbeddingAdapterConfig, type EmbeddingAdapterInput, EmbeddingAdapterNotConfiguredError, EmbeddingError, type EmbeddingModelFactory, type EmbeddingModelReference, type EmbeddingRouterModelId, type ExtractVariableNames, FEW_SHOT_EXAMPLES, FILESYSTEM_SYSTEM_PROMPT, type FallbackStage, type FileData, type FileInfo, type FilesystemBackend, type FilesystemBackendContext, type FilesystemBackendFactory, type FilesystemToolkitOptions, GLOB_TOOL_DESCRIPTION, GREP_TOOL_DESCRIPTION, type GenerateObjectOptions, type GenerateObjectResultWithContext, type GenerateObjectSubAgentConfig, type GenerateReasonResult, type GenerateScoreResult, type GenerateScoreStep, type GenerateTextOptions, type GenerateTextResultWithContext, type GenerateTextSubAgentConfig, type GetConversationStepsOptions, type GetMessagesOptions, type GrepMatch, type GuardrailAction, type GuardrailContext, type GuardrailDefinition, type GuardrailFunction, type GuardrailSeverity, type IServerProvider, type IServerlessProvider, type VoltOpsClient$1 as IVoltOpsClient, InMemoryFilesystemBackend, InMemoryStorageAdapter$1 as InMemoryObservabilityAdapter, InMemoryStorageAdapter, InMemoryVectorAdapter, type InferGenerateObjectResponse, type InferGenerateTextResponse, type InferMessage, type InferModel, type InferProviderParams, type InferStreamResponse, type InferTool, type InputGuardrail, type InputGuardrailArgs, type InputGuardrailResult, type InputMiddleware, type InputMiddlewareArgs, type InputMiddlewareResult, type KnowledgeBaseTagFilter, type LLMProvider, LS_TOOL_DESCRIPTION, type LanguageModelFactory, LazyRemoteExportProcessor, type LocalScorerDefinition, type LocalScorerExecutionResult, LocalStorageSpanProcessor, type LogFilter, LoggerProxy, type MCPAuthorizationAction, type MCPAuthorizationConfig, type MCPAuthorizationContext, MCPAuthorizationError, type MCPCanFunction, type MCPCanParams, type MCPCanResult, MCPClient, type MCPClientCallOptions, type MCPClientConfig, MCPConfiguration, type MCPConfigurationOptions, type MCPElicitationAdapter, type MCPElicitationHandler, type MCPLoggingAdapter, type MCPPromptsAdapter, type MCPResourcesAdapter, MCPServerRegistry, type ManagedMemoryAddMessageInput, type ManagedMemoryAddMessagesInput, type ManagedMemoryClearMessagesInput, type ManagedMemoryConnectionInfo, type ManagedMemoryConversationsClient, type ManagedMemoryCredentialCreateResult, type ManagedMemoryCredentialListResult, type ManagedMemoryCredentialSummary, type ManagedMemoryDatabaseSummary, type ManagedMemoryDeleteMessagesInput, type ManagedMemoryGetMessagesInput, type ManagedMemoryMessagesClient, type ManagedMemoryQueryWorkflowRunsInput, type ManagedMemorySetWorkingMemoryInput, type ManagedMemoryStatus, type ManagedMemoryUpdateConversationInput, type ManagedMemoryVoltOpsClient, type ManagedMemoryWorkflowStateUpdateInput, type ManagedMemoryWorkflowStatesClient, type ManagedMemoryWorkingMemoryClient, type ManagedMemoryWorkingMemoryInput, Memory, type MemoryConfig, type MemoryOptions, type MemoryStorageMetadata, type MemoryUpdateMode, Memory as MemoryV2, MemoryV2Error, type MessageContent, MessageContentBuilder, type MessageRole, MiddlewareAbortError, type MiddlewareAbortOptions, type MiddlewareContext, type MiddlewareDefinition, type MiddlewareDirection, type MiddlewareFunction, type ModelForProvider, type ModelProvider, type ModelProviderEntry, type ModelProviderLoader, ModelProviderRegistry, type ModelRouterModelId, type ModelToolCall, NextAction, NodeFilesystemBackend, NodeType, VoltAgentObservability$1 as NodeVoltAgentObservability, type ObservabilityConfig, type ObservabilityLogRecord, type ObservabilitySpan, type ObservabilityStorageAdapter, type ObservabilityWebSocketEvent, type OnEndHookArgs, type OnErrorHookArgs, type OnFallbackHookArgs, type OnHandoffCompleteHookArgs, type OnHandoffHookArgs, type OnPrepareMessagesHookArgs, type OnPrepareMessagesHookResult, type OnPrepareModelMessagesHookArgs, type OnPrepareModelMessagesHookResult, type OnRetryHookArgs, type OnRetryHookArgsBase, type OnRetryLLMHookArgs, type OnRetryMiddlewareHookArgs, type OnStartHookArgs, type OnStepFinishHookArgs, type OnToolEndHookArgs, type OnToolEndHookResult, type OnToolStartHookArgs, type OperationContext, type OutputGuardrail, type OutputGuardrailArgs, type OutputGuardrailResult, type OutputMiddleware, type OutputMiddlewareArgs, type OutputMiddlewareResult, type OutputSpec$1 as OutputSpec, type PackageUpdateInfo, PlanAgent, type PlanAgentExtension, type PlanAgentExtensionContext, type PlanAgentExtensionResult, type PlanAgentFileData, type PlanAgentOptions, type PlanAgentState, type PlanAgentSubagentDefinition, type PlanAgentTodoItem, type PlanAgentTodoStatus, type PlanningToolkitOptions, type PromptApiClient, type PromptApiResponse, type PromptContent, type PromptCreator, type PromptHelper, type PromptReference, type PromptTemplate, type ProviderId, type ProviderModelsMap, type ProviderObjectResponse, type ProviderObjectStreamResponse, type ProviderParams, type ProviderResponse, type ProviderTextResponse, type ProviderTextStreamResponse, type ProviderTool, READ_FILE_TOOL_DESCRIPTION, type RagKnowledgeBaseSummary, type RagSearchKnowledgeBaseChildChunk, type RagSearchKnowledgeBaseRequest, type RagSearchKnowledgeBaseResponse, type RagSearchKnowledgeBaseResult, type ReadableStreamType, type ReasoningStep, ReasoningStepSchema, type RegisterOptions, type RegisteredTrigger, type RegisteredWorkflow, type RemoteLogExportConfig, RemoteLogProcessor, type ResumableStreamAdapter, type ResumableStreamContext, type RetrieveOptions, type Retriever, type RetrieverOptions, type RetrySource, type RunLocalScorersArgs, type RunLocalScorersResult, SERVERLESS_ENV_CONTEXT_KEY, type SamplingMetadata, type SamplingPolicy, type ScorerBuilder, type ScorerContext, type ScorerLifecycleScope, type ScorerPipelineContext, type ScorerReasonContext, type ScorerResult, type SearchOptions, type SearchResult$1 as SearchResult, type ServerAgentResponse, type ServerApiResponse, type ServerProviderDeps, type ServerProviderFactory, type ServerWorkflowResponse, type ServerlessProviderFactory, type ServerlessRemoteEndpointConfig, type ServerlessRemoteExportConfig, type ServerlessRequestHandler, ServerlessVoltAgentObservability, type SpanAttributes, type SpanEvent, type SpanFilterConfig, SpanFilterProcessor, SpanKind, type SpanLink, type SpanStatus, SpanStatusCode, type SpanTreeNode, type StepChunkCallback, type StepFinishCallback, type StepWithContent, type StopWhen, type StorageAdapter, StorageError, StorageLogProcessor, type StoredUIMessage, type StreamObjectFinishResult, type StreamObjectOnFinishCallback, type StreamObjectOptions, type StreamObjectResultWithContext, type StreamObjectSubAgentConfig, type StreamPart, type StreamTextFinishResult, type StreamTextOnFinishCallback, type StreamTextOptions, type StreamTextResultWithContext, type StreamTextSubAgentConfig, type SubAgentConfig, type SubAgentMethod, type SubAgentStateData, type SupervisorConfig, TRIGGER_CONTEXT_KEY, type TaskToolOptions, type TemplateVariables, type TimelineEventCoreLevel, type TimelineEventCoreStatus, type TimelineEventCoreType, type TodoBackend, type TodoBackendFactory, Tool, type ToolArgumentResolver, type ToolCall, type ToolContext, ToolDeniedError, type ToolErrorInfo, type ToolExecuteOptions, type ToolExecutionResult, type ToolHookOnEnd, type ToolHookOnEndArgs, type ToolHookOnEndResult, type ToolHookOnStart, type ToolHookOnStartArgs, type ToolHooks, ToolManager, type ToolOptions, type ToolResultOutput, type ToolRouter, type ToolRouterCandidate, type ToolRouterContext, type ToolRouterInput, type ToolRouterMode, type ToolRouterResult, type ToolRouterResultItem, type ToolRouterSelection, type ToolRouterStrategy, type ToolRoutingConfig, type ToolRoutingEmbeddingConfig, type ToolRoutingEmbeddingInput, type ToolSchema, type ToolStatus, type ToolStatusInfo, type ToolWithNodeId, type Toolkit, type TriggerHandler, type TriggerHandlerBody, type TriggerHandlerContext, type TriggerHandlerResponse, type TriggerHandlerResult, type TriggerHandlerReturn, type TriggerHttpMethod, TriggerRegistry, type Usage, type UsageInfo, UserInputBridge, type UserInputHandler, type VectorAdapter$1 as VectorAdapter, VectorAdapterNotConfiguredError, VectorError, type VectorItem$1 as VectorItem, type VectorSearchOptions, type Voice, type VoiceEventData, type VoiceEventType, type VoiceMetadata, type VoiceOptions, VoltAgent, VoltAgentError, VoltAgentObservability, type VoltAgentOptions, VoltAgentRagRetriever, type VoltAgentRagRetrieverOptions, type VoltAgentStreamTextResult, type VoltAgentTextStreamPart, type VoltAgentTriggerConfig, type VoltAgentTriggersConfig, type VoltOpsActionExecutionResult, type VoltOpsActionsApi, VoltOpsActionsClient, type VoltOpsActionsTransport, type VoltOpsAirtableCreateRecordParams, type VoltOpsAirtableCredential, type VoltOpsAirtableDeleteRecordParams, type VoltOpsAirtableGetRecordParams, type VoltOpsAirtableListRecordsParams, type VoltOpsAirtableUpdateRecordParams, type VoltOpsAppendEvalRunResultPayload, type VoltOpsAppendEvalRunResultsRequest, VoltOpsClient, type VoltOpsClientOptions, type VoltOpsCompleteEvalRunRequest, type VoltOpsCreateEvalRunRequest, type VoltOpsCreateScorerRequest, type VoltOpsDiscordChannelMessageParams, type VoltOpsDiscordChannelType, type VoltOpsDiscordConfig, type VoltOpsDiscordCreateChannelParams, type VoltOpsDiscordCredential, type VoltOpsDiscordDeleteChannelParams, type VoltOpsDiscordGetChannelParams, type VoltOpsDiscordListChannelsParams, type VoltOpsDiscordListMembersParams, type VoltOpsDiscordListMessagesParams, type VoltOpsDiscordMemberRoleParams, type VoltOpsDiscordReactionParams, type VoltOpsDiscordSendMessageParams, type VoltOpsDiscordSendWebhookMessageParams, type VoltOpsDiscordUpdateChannelParams, type VoltOpsEvalResultStatus, type VoltOpsEvalRunCompletionSummaryPayload, type VoltOpsEvalRunErrorPayload, type VoltOpsEvalRunResultLiveMetadata, type VoltOpsEvalRunResultScorePayload, type VoltOpsEvalRunStatus, type VoltOpsEvalRunSummary, type VoltOpsFeedback, type VoltOpsFeedbackConfig, type VoltOpsFeedbackCreateInput, type VoltOpsFeedbackExpiresIn, type VoltOpsFeedbackToken, type VoltOpsFeedbackTokenCreateInput, VoltOpsPromptApiClient, type VoltOpsPromptManager, VoltOpsPromptManagerImpl, type VoltOpsScorerSummary, type VoltOpsSlackCredential, type VoltOpsSlackDeleteMessageParams, type VoltOpsSlackPostMessageParams, type VoltOpsSlackSearchMessagesParams, type VoltOpsTerminalEvalRunStatus, type VoltOpsTriggerDefinition, VoltOpsTriggerDefinitions, type VoltOpsTriggerEnvelope, type VoltOpsTriggerGroupMap, type VoltOpsTriggerName, VoltOpsTriggerNames, WRITE_FILE_TOOL_DESCRIPTION, WRITE_TODOS_TOOL_DESCRIPTION, WRITE_TODOS_TOOL_NAME, WebSocketEventEmitter, WebSocketLogProcessor, WebSocketSpanProcessor, type WeightedBlendComponent, type WeightedBlendOptions, type Workflow, type WorkflowConfig, type WorkflowExecutionContext, type WorkflowHookContext, type WorkflowHookStatus, type WorkflowHooks, WorkflowRegistry, type WorkflowRunQuery, type WorkflowStateEntry, type WorkflowStateStore, type WorkflowStateUpdater, type WorkflowStats, type WorkflowStepContext, type WorkflowStepData, type WorkflowStepStatus, type WorkflowStepType, type WorkflowTimelineEvent, type WorkingMemoryConfig, type WorkingMemoryScope, type WorkingMemorySummary, type WorkingMemoryUpdateOptions, type WriteResult, addTimestampToMessage, andAgent, andAll, andBranch, andDoUntil, andDoWhile, andForEach, andGuardrail, andMap, andRace, andSleep, andSleepUntil, andTap, andThen, andWhen, andWorkflow, appendToMessage, buildRetrieverLogMessage, buildSamplingMetadata, buildScorer, buildSpanTree, checkForUpdates, convertUsage, cosineSimilarity, createDefaultInputSafetyGuardrails, createDefaultPIIGuardrails, createDefaultSafetyGuardrails, createEmailRedactorGuardrail, createEmbeddingToolRouterStrategy, createFilesystemToolkit, createHTMLSanitizerInputGuardrail, createHooks, createInputGuardrail, createInputLengthGuardrail, createInputMiddleware, createMaxLengthGuardrail, createNodeId, createOutputGuardrail, createOutputMiddleware, createPIIInputGuardrail, createPhoneNumberGuardrail, createPlanningToolkit, createProfanityGuardrail, createProfanityInputGuardrail, createPrompt, createPromptInjectionGuardrail, createReasoningTools, createRetrieverTool, createScorer, createSensitiveNumberGuardrail, createSimpleTemplateEngine, createSubagent, createSuspendController, createTool, createToolResultEvictor, createToolRouter, createToolkit, createTriggers, createVoltAgentObservability, createVoltOpsClient, createWorkflow, createWorkflowChain, createWorkflowStepNodeId, VoltAgent as default, defineVoltOpsTrigger, extractFileParts, extractImageParts, extractText, extractTextParts, extractWorkflowStepInfo, filterContentParts, getContentLength, getEnvVar, getGlobalLogBuffer, getGlobalLogger, getGlobalVoltOpsClient, getNodeTypeFromNodeId, getVoltOpsTriggerDefinition, getWorkflowStepNodeType, hasContent, hasFilePart, hasImagePart, hasTextPart, isAbortError, isMiddlewareAbortError, isNodeRuntime, isServerlessRuntime, isStructuredContent, isTextContent, isToolRouter, isVoltAgentError, mapMessageContent, messageHelpers, normalizeContent, normalizeScorerResult, normalizeToArray, prependToMessage, readableLogRecordToObservabilityLog, readableSpanToObservabilitySpan, runLocalScorers, safeJsonParse, serializeValueForDebug, setWaitUntil, shouldSample, tool, transformTextContent, updateAllPackages, updateSinglePackage, weightedBlend, zodSchemaToJsonUI };
|
|
14886
|
+
export { A2AServerRegistry, AbortError, Agent, type AgentEvalConfig, type AgentEvalContext, type AgentEvalFeedbackHelper, type AgentEvalFeedbackSaveInput, type AgentEvalOperationType, type AgentEvalPayload, type AgentEvalResult, type AgentEvalResultCallbackArgs, type AgentEvalSamplingPolicy, type AgentEvalScorerConfig, type AgentEvalScorerFactory, type AgentEvalScorerReference, type AgentFeedbackMetadata, type AgentFeedbackOptions, type AgentFullState, type AgentHookOnEnd, type AgentHookOnError, type AgentHookOnFallback, type AgentHookOnHandoff, type AgentHookOnHandoffComplete, type AgentHookOnPrepareMessages, type AgentHookOnPrepareModelMessages, type AgentHookOnRetry, type AgentHookOnStart, type AgentHookOnStepFinish, type AgentHookOnToolEnd, type AgentHookOnToolStart, type AgentHooks, type AgentModelConfig, type AgentModelReference, type AgentModelValue, type AgentOptions, AgentRegistry, type AgentResponse, type AgentScorerState, type AgentStatus, type AgentSummarizationOptions, type AgentTool, AiSdkEmbeddingAdapter, type AllowedVariableValue, type ApiToolInfo, type BaseEventMetadata, type BaseGenerationOptions, type BaseLLMOptions, type BaseMessage, BaseRetriever, type BaseTool, type BaseToolCall, type BuildScorerOptions, type BuildScorerRunArgs, type BuildScorerRunResult, type BuilderAnalyzeContext, type BuilderPrepareContext, type BuilderReasonContext, type BuilderScoreContext, type CachedPrompt, type ChatMessage, ClientHTTPError, type ClientSideToolResult, type CloudflareFetchHandler, CompositeFilesystemBackend, type Conversation, ConversationAlreadyExistsError, ConversationNotFoundError, type ConversationQueryOptions, type ConversationQueryOptions as ConversationQueryOptionsV2, type ConversationStepRecord, type ConversationStepType, type ConversationTitleConfig, type ConversationTitleGenerator, ConversationTodoBackend, type Conversation as ConversationV2, type CreateConversationInput, type CreateConversationInput as CreateConversationInputV2, type CreateInputGuardrailOptions, type CreateInputMiddlewareOptions, type CreateOutputGuardrailOptions, type CreateOutputMiddlewareOptions, type CreateReasoningToolsOptions, type CreateScorerOptions, DEFAULT_INSTRUCTIONS, type DataContent, type Document, type DynamicValue, type DynamicValueOptions, EDIT_FILE_TOOL_DESCRIPTION, type EditResult, type EmbeddingAdapter, type EmbeddingAdapterConfig, type EmbeddingAdapterInput, EmbeddingAdapterNotConfiguredError, EmbeddingError, type EmbeddingModelFactory, type EmbeddingModelReference, type EmbeddingRouterModelId, type ExtractVariableNames, FEW_SHOT_EXAMPLES, FILESYSTEM_SYSTEM_PROMPT, type FallbackStage, type FileData, type FileInfo, type FilesystemBackend, type FilesystemBackendContext, type FilesystemBackendFactory, type FilesystemToolkitOptions, GLOB_TOOL_DESCRIPTION, GREP_TOOL_DESCRIPTION, type GenerateObjectOptions, type GenerateObjectResultWithContext, type GenerateObjectSubAgentConfig, type GenerateReasonResult, type GenerateScoreResult, type GenerateScoreStep, type GenerateTextOptions, type GenerateTextResultWithContext, type GenerateTextSubAgentConfig, type GetConversationStepsOptions, type GetMessagesOptions, type GrepMatch, type GuardrailAction, type GuardrailContext, type GuardrailDefinition, type GuardrailFunction, type GuardrailSeverity, type IServerProvider, type IServerlessProvider, type VoltOpsClient$1 as IVoltOpsClient, InMemoryFilesystemBackend, InMemoryStorageAdapter$1 as InMemoryObservabilityAdapter, InMemoryStorageAdapter, InMemoryVectorAdapter, type InferGenerateObjectResponse, type InferGenerateTextResponse, type InferMessage, type InferModel, type InferProviderParams, type InferStreamResponse, type InferTool, type InputGuardrail, type InputGuardrailArgs, type InputGuardrailResult, type InputMiddleware, type InputMiddlewareArgs, type InputMiddlewareResult, type KnowledgeBaseTagFilter, type LLMProvider, LS_TOOL_DESCRIPTION, type LanguageModelFactory, LazyRemoteExportProcessor, type LocalScorerDefinition, type LocalScorerExecutionResult, LocalStorageSpanProcessor, type LogFilter, LoggerProxy, type MCPAuthorizationAction, type MCPAuthorizationConfig, type MCPAuthorizationContext, MCPAuthorizationError, type MCPCanFunction, type MCPCanParams, type MCPCanResult, MCPClient, type MCPClientCallOptions, type MCPClientConfig, MCPConfiguration, type MCPConfigurationOptions, type MCPElicitationAdapter, type MCPElicitationHandler, type MCPLoggingAdapter, type MCPPromptsAdapter, type MCPResourcesAdapter, MCPServerRegistry, type ManagedMemoryAddMessageInput, type ManagedMemoryAddMessagesInput, type ManagedMemoryClearMessagesInput, type ManagedMemoryConnectionInfo, type ManagedMemoryConversationsClient, type ManagedMemoryCredentialCreateResult, type ManagedMemoryCredentialListResult, type ManagedMemoryCredentialSummary, type ManagedMemoryDatabaseSummary, type ManagedMemoryDeleteMessagesInput, type ManagedMemoryGetMessagesInput, type ManagedMemoryMessagesClient, type ManagedMemoryQueryWorkflowRunsInput, type ManagedMemorySetWorkingMemoryInput, type ManagedMemoryStatus, type ManagedMemoryUpdateConversationInput, type ManagedMemoryVoltOpsClient, type ManagedMemoryWorkflowStateUpdateInput, type ManagedMemoryWorkflowStatesClient, type ManagedMemoryWorkingMemoryClient, type ManagedMemoryWorkingMemoryInput, Memory, type MemoryConfig, type MemoryOptions, type MemoryStorageMetadata, type MemoryUpdateMode, Memory as MemoryV2, MemoryV2Error, type MessageContent, MessageContentBuilder, type MessageRole, MiddlewareAbortError, type MiddlewareAbortOptions, type MiddlewareContext, type MiddlewareDefinition, type MiddlewareDirection, type MiddlewareFunction, type ModelForProvider, type ModelProvider, type ModelProviderEntry, type ModelProviderLoader, ModelProviderRegistry, type ModelRouterModelId, type ModelToolCall, NextAction, NodeFilesystemBackend, NodeType, VoltAgentObservability$1 as NodeVoltAgentObservability, type ObservabilityConfig, type ObservabilityLogRecord, type ObservabilitySpan, type ObservabilityStorageAdapter, type ObservabilityWebSocketEvent, type OnEndHookArgs, type OnErrorHookArgs, type OnFallbackHookArgs, type OnHandoffCompleteHookArgs, type OnHandoffHookArgs, type OnPrepareMessagesHookArgs, type OnPrepareMessagesHookResult, type OnPrepareModelMessagesHookArgs, type OnPrepareModelMessagesHookResult, type OnRetryHookArgs, type OnRetryHookArgsBase, type OnRetryLLMHookArgs, type OnRetryMiddlewareHookArgs, type OnStartHookArgs, type OnStepFinishHookArgs, type OnToolEndHookArgs, type OnToolEndHookResult, type OnToolStartHookArgs, type OperationContext, type OutputGuardrail, type OutputGuardrailArgs, type OutputGuardrailResult, type OutputMiddleware, type OutputMiddlewareArgs, type OutputMiddlewareResult, type OutputSpec$1 as OutputSpec, type PackageUpdateInfo, PlanAgent, type PlanAgentExtension, type PlanAgentExtensionContext, type PlanAgentExtensionResult, type PlanAgentFileData, type PlanAgentOptions, type PlanAgentState, type PlanAgentSubagentDefinition, type PlanAgentTodoItem, type PlanAgentTodoStatus, type PlanningToolkitOptions, type PromptApiClient, type PromptApiResponse, type PromptContent, type PromptCreator, type PromptHelper, type PromptReference, type PromptTemplate, type ProviderId, type ProviderModelsMap, type ProviderObjectResponse, type ProviderObjectStreamResponse, type ProviderParams, type ProviderResponse, type ProviderTextResponse, type ProviderTextStreamResponse, type ProviderTool, READ_FILE_TOOL_DESCRIPTION, type RagKnowledgeBaseSummary, type RagSearchKnowledgeBaseChildChunk, type RagSearchKnowledgeBaseRequest, type RagSearchKnowledgeBaseResponse, type RagSearchKnowledgeBaseResult, type ReadableStreamType, type ReasoningStep, ReasoningStepSchema, type RegisterOptions, type RegisteredTrigger, type RegisteredWorkflow, type RemoteLogExportConfig, RemoteLogProcessor, type ResumableStreamAdapter, type ResumableStreamContext, type RetrieveOptions, type Retriever, type RetrieverOptions, type RetrySource, type RunLocalScorersArgs, type RunLocalScorersResult, SERVERLESS_ENV_CONTEXT_KEY, type SamplingMetadata, type SamplingPolicy, type ScorerBuilder, type ScorerContext, type ScorerLifecycleScope, type ScorerPipelineContext, type ScorerReasonContext, type ScorerResult, type SearchOptions, type SearchResult$1 as SearchResult, type ServerAgentResponse, type ServerApiResponse, type ServerProviderDeps, type ServerProviderFactory, type ServerWorkflowResponse, type ServerlessProviderFactory, type ServerlessRemoteEndpointConfig, type ServerlessRemoteExportConfig, type ServerlessRequestHandler, ServerlessVoltAgentObservability, type SpanAttributes, type SpanEvent, type SpanFilterConfig, SpanFilterProcessor, SpanKind, type SpanLink, type SpanStatus, SpanStatusCode, type SpanTreeNode, type StepChunkCallback, type StepFinishCallback, type StepWithContent, type StopWhen, type StorageAdapter, StorageError, StorageLogProcessor, type StoredUIMessage, type StreamObjectFinishResult, type StreamObjectOnFinishCallback, type StreamObjectOptions, type StreamObjectResultWithContext, type StreamObjectSubAgentConfig, type StreamPart, type StreamTextFinishResult, type StreamTextOnFinishCallback, type StreamTextOptions, type StreamTextResultWithContext, type StreamTextSubAgentConfig, type SubAgentConfig, type SubAgentMethod, type SubAgentStateData, type SupervisorConfig, TRIGGER_CONTEXT_KEY, type TaskToolOptions, type TemplateVariables, type TimelineEventCoreLevel, type TimelineEventCoreStatus, type TimelineEventCoreType, type TodoBackend, type TodoBackendFactory, Tool, type ToolCall, type ToolContext, ToolDeniedError, type ToolErrorInfo, type ToolExecuteOptions, type ToolExecutionResult, type ToolHookOnEnd, type ToolHookOnEndArgs, type ToolHookOnEndResult, type ToolHookOnStart, type ToolHookOnStartArgs, type ToolHooks, ToolManager, type ToolOptions, type ToolResultOutput, type ToolRoutingConfig, type ToolRoutingEmbeddingConfig, type ToolRoutingEmbeddingInput, type ToolSchema, type ToolSearchCandidate, type ToolSearchContext, type ToolSearchResult, type ToolSearchResultItem, type ToolSearchSelection, type ToolSearchStrategy, type ToolStatus, type ToolStatusInfo, type ToolWithNodeId, type Toolkit, type TriggerHandler, type TriggerHandlerBody, type TriggerHandlerContext, type TriggerHandlerResponse, type TriggerHandlerResult, type TriggerHandlerReturn, type TriggerHttpMethod, TriggerRegistry, type Usage, type UsageInfo, UserInputBridge, type UserInputHandler, type VectorAdapter$1 as VectorAdapter, VectorAdapterNotConfiguredError, VectorError, type VectorItem$1 as VectorItem, type VectorSearchOptions, type Voice, type VoiceEventData, type VoiceEventType, type VoiceMetadata, type VoiceOptions, VoltAgent, VoltAgentError, VoltAgentObservability, type VoltAgentOptions, VoltAgentRagRetriever, type VoltAgentRagRetrieverOptions, type VoltAgentStreamTextResult, type VoltAgentTextStreamPart, type VoltAgentTriggerConfig, type VoltAgentTriggersConfig, type VoltOpsActionExecutionResult, type VoltOpsActionsApi, VoltOpsActionsClient, type VoltOpsActionsTransport, type VoltOpsAirtableCreateRecordParams, type VoltOpsAirtableCredential, type VoltOpsAirtableDeleteRecordParams, type VoltOpsAirtableGetRecordParams, type VoltOpsAirtableListRecordsParams, type VoltOpsAirtableUpdateRecordParams, type VoltOpsAppendEvalRunResultPayload, type VoltOpsAppendEvalRunResultsRequest, VoltOpsClient, type VoltOpsClientOptions, type VoltOpsCompleteEvalRunRequest, type VoltOpsCreateEvalRunRequest, type VoltOpsCreateScorerRequest, type VoltOpsDiscordChannelMessageParams, type VoltOpsDiscordChannelType, type VoltOpsDiscordConfig, type VoltOpsDiscordCreateChannelParams, type VoltOpsDiscordCredential, type VoltOpsDiscordDeleteChannelParams, type VoltOpsDiscordGetChannelParams, type VoltOpsDiscordListChannelsParams, type VoltOpsDiscordListMembersParams, type VoltOpsDiscordListMessagesParams, type VoltOpsDiscordMemberRoleParams, type VoltOpsDiscordReactionParams, type VoltOpsDiscordSendMessageParams, type VoltOpsDiscordSendWebhookMessageParams, type VoltOpsDiscordUpdateChannelParams, type VoltOpsEvalResultStatus, type VoltOpsEvalRunCompletionSummaryPayload, type VoltOpsEvalRunErrorPayload, type VoltOpsEvalRunResultLiveMetadata, type VoltOpsEvalRunResultScorePayload, type VoltOpsEvalRunStatus, type VoltOpsEvalRunSummary, type VoltOpsFeedback, type VoltOpsFeedbackConfig, type VoltOpsFeedbackCreateInput, type VoltOpsFeedbackExpiresIn, type VoltOpsFeedbackToken, type VoltOpsFeedbackTokenCreateInput, VoltOpsPromptApiClient, type VoltOpsPromptManager, VoltOpsPromptManagerImpl, type VoltOpsScorerSummary, type VoltOpsSlackCredential, type VoltOpsSlackDeleteMessageParams, type VoltOpsSlackPostMessageParams, type VoltOpsSlackSearchMessagesParams, type VoltOpsTerminalEvalRunStatus, type VoltOpsTriggerDefinition, VoltOpsTriggerDefinitions, type VoltOpsTriggerEnvelope, type VoltOpsTriggerGroupMap, type VoltOpsTriggerName, VoltOpsTriggerNames, WRITE_FILE_TOOL_DESCRIPTION, WRITE_TODOS_TOOL_DESCRIPTION, WRITE_TODOS_TOOL_NAME, WebSocketEventEmitter, WebSocketLogProcessor, WebSocketSpanProcessor, type WeightedBlendComponent, type WeightedBlendOptions, type Workflow, type WorkflowConfig, type WorkflowExecutionContext, type WorkflowHookContext, type WorkflowHookStatus, type WorkflowHooks, WorkflowRegistry, type WorkflowRunQuery, type WorkflowStateEntry, type WorkflowStateStore, type WorkflowStateUpdater, type WorkflowStats, type WorkflowStepContext, type WorkflowStepData, type WorkflowStepStatus, type WorkflowStepType, type WorkflowTimelineEvent, type WorkingMemoryConfig, type WorkingMemoryScope, type WorkingMemorySummary, type WorkingMemoryUpdateOptions, type WriteResult, addTimestampToMessage, andAgent, andAll, andBranch, andDoUntil, andDoWhile, andForEach, andGuardrail, andMap, andRace, andSleep, andSleepUntil, andTap, andThen, andWhen, andWorkflow, appendToMessage, buildRetrieverLogMessage, buildSamplingMetadata, buildScorer, buildSpanTree, checkForUpdates, convertUsage, cosineSimilarity, createDefaultInputSafetyGuardrails, createDefaultPIIGuardrails, createDefaultSafetyGuardrails, createEmailRedactorGuardrail, createEmbeddingToolSearchStrategy, createFilesystemToolkit, createHTMLSanitizerInputGuardrail, createHooks, createInputGuardrail, createInputLengthGuardrail, createInputMiddleware, createMaxLengthGuardrail, createNodeId, createOutputGuardrail, createOutputMiddleware, createPIIInputGuardrail, createPhoneNumberGuardrail, createPlanningToolkit, createProfanityGuardrail, createProfanityInputGuardrail, createPrompt, createPromptInjectionGuardrail, createReasoningTools, createRetrieverTool, createScorer, createSensitiveNumberGuardrail, createSimpleTemplateEngine, createSubagent, createSuspendController, createTool, createToolResultEvictor, createToolkit, createTriggers, createVoltAgentObservability, createVoltOpsClient, createWorkflow, createWorkflowChain, createWorkflowStepNodeId, VoltAgent as default, defineVoltOpsTrigger, extractFileParts, extractImageParts, extractText, extractTextParts, extractWorkflowStepInfo, filterContentParts, getContentLength, getEnvVar, getGlobalLogBuffer, getGlobalLogger, getGlobalVoltOpsClient, getNodeTypeFromNodeId, getVoltOpsTriggerDefinition, getWorkflowStepNodeType, hasContent, hasFilePart, hasImagePart, hasTextPart, isAbortError, isMiddlewareAbortError, isNodeRuntime, isServerlessRuntime, isStructuredContent, isTextContent, isVoltAgentError, mapMessageContent, messageHelpers, normalizeContent, normalizeScorerResult, normalizeToArray, prependToMessage, readableLogRecordToObservabilityLog, readableSpanToObservabilitySpan, runLocalScorers, safeJsonParse, serializeValueForDebug, setWaitUntil, shouldSample, tool, transformTextContent, updateAllPackages, updateSinglePackage, weightedBlend, zodSchemaToJsonUI };
|