@voltagent/core 0.1.58 → 0.1.59
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.ts +206 -113
- package/dist/index.js +1220 -1105
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +1219 -1105
- package/dist/index.mjs.map +1 -1
- package/package.json +1 -1
package/dist/index.d.ts
CHANGED
|
@@ -1135,6 +1135,64 @@ interface PromptContent {
|
|
|
1135
1135
|
};
|
|
1136
1136
|
}
|
|
1137
1137
|
|
|
1138
|
+
interface OnStartHookArgs {
|
|
1139
|
+
agent: Agent<any>;
|
|
1140
|
+
context: OperationContext;
|
|
1141
|
+
}
|
|
1142
|
+
interface OnEndHookArgs {
|
|
1143
|
+
/**
|
|
1144
|
+
* The conversation ID.
|
|
1145
|
+
*/
|
|
1146
|
+
conversationId: string;
|
|
1147
|
+
/**
|
|
1148
|
+
* The agent that generated the output.
|
|
1149
|
+
*/
|
|
1150
|
+
agent: Agent<any>;
|
|
1151
|
+
/** The standardized successful output object. Undefined on error. */
|
|
1152
|
+
output: AgentOperationOutput | undefined;
|
|
1153
|
+
/** The VoltAgentError object if the operation failed. Undefined on success. */
|
|
1154
|
+
error: VoltAgentError | undefined;
|
|
1155
|
+
/** The complete conversation messages including user input and assistant responses (Vercel AI SDK compatible) */
|
|
1156
|
+
context: OperationContext;
|
|
1157
|
+
}
|
|
1158
|
+
interface OnHandoffHookArgs {
|
|
1159
|
+
agent: Agent<any>;
|
|
1160
|
+
source: Agent<any>;
|
|
1161
|
+
}
|
|
1162
|
+
interface OnToolStartHookArgs {
|
|
1163
|
+
agent: Agent<any>;
|
|
1164
|
+
tool: AgentTool;
|
|
1165
|
+
context: OperationContext;
|
|
1166
|
+
}
|
|
1167
|
+
interface OnToolEndHookArgs {
|
|
1168
|
+
agent: Agent<any>;
|
|
1169
|
+
tool: AgentTool;
|
|
1170
|
+
/** The successful output from the tool. Undefined on error. */
|
|
1171
|
+
output: unknown | undefined;
|
|
1172
|
+
/** The VoltAgentError if the tool execution failed. Undefined on success. */
|
|
1173
|
+
error: VoltAgentError | undefined;
|
|
1174
|
+
context: OperationContext;
|
|
1175
|
+
}
|
|
1176
|
+
type AgentHookOnStart = (args: OnStartHookArgs) => Promise<void> | void;
|
|
1177
|
+
type AgentHookOnEnd = (args: OnEndHookArgs) => Promise<void> | void;
|
|
1178
|
+
type AgentHookOnHandoff = (args: OnHandoffHookArgs) => Promise<void> | void;
|
|
1179
|
+
type AgentHookOnToolStart = (args: OnToolStartHookArgs) => Promise<void> | void;
|
|
1180
|
+
type AgentHookOnToolEnd = (args: OnToolEndHookArgs) => Promise<void> | void;
|
|
1181
|
+
/**
|
|
1182
|
+
* Type definition for agent hooks using single argument objects.
|
|
1183
|
+
*/
|
|
1184
|
+
type AgentHooks = {
|
|
1185
|
+
onStart?: AgentHookOnStart;
|
|
1186
|
+
onEnd?: AgentHookOnEnd;
|
|
1187
|
+
onHandoff?: AgentHookOnHandoff;
|
|
1188
|
+
onToolStart?: AgentHookOnToolStart;
|
|
1189
|
+
onToolEnd?: AgentHookOnToolEnd;
|
|
1190
|
+
};
|
|
1191
|
+
/**
|
|
1192
|
+
* Create hooks from an object literal.
|
|
1193
|
+
*/
|
|
1194
|
+
declare function createHooks(hooks?: Partial<AgentHooks>): AgentHooks;
|
|
1195
|
+
|
|
1138
1196
|
/**
|
|
1139
1197
|
* Enhanced dynamic value for instructions that supports prompt management
|
|
1140
1198
|
*/
|
|
@@ -1355,6 +1413,7 @@ interface CommonGenerateOptions {
|
|
|
1355
1413
|
historyEntryId?: string;
|
|
1356
1414
|
operationContext?: OperationContext;
|
|
1357
1415
|
userContext?: UserContext;
|
|
1416
|
+
hooks?: AgentHooks;
|
|
1358
1417
|
}
|
|
1359
1418
|
/**
|
|
1360
1419
|
* Public-facing generate options for external users
|
|
@@ -3091,65 +3150,6 @@ declare abstract class BaseRetriever {
|
|
|
3091
3150
|
abstract retrieve(input: string | BaseMessage[], options: RetrieveOptions): Promise<string>;
|
|
3092
3151
|
}
|
|
3093
3152
|
|
|
3094
|
-
/**
|
|
3095
|
-
* Main VoltOps client class that provides unified access to both
|
|
3096
|
-
* telemetry export and prompt management functionality.
|
|
3097
|
-
*/
|
|
3098
|
-
declare class VoltOpsClient implements VoltOpsClient$1 {
|
|
3099
|
-
readonly options: VoltOpsClientOptions & {
|
|
3100
|
-
baseUrl: string;
|
|
3101
|
-
};
|
|
3102
|
-
readonly observability?: VoltAgentExporter;
|
|
3103
|
-
readonly prompts?: VoltOpsPromptManager;
|
|
3104
|
-
constructor(options: VoltOpsClientOptions);
|
|
3105
|
-
/**
|
|
3106
|
-
* Create a prompt helper for agent instructions
|
|
3107
|
-
*/
|
|
3108
|
-
createPromptHelper(_agentId: string): PromptHelper;
|
|
3109
|
-
get exportHistoryEntry(): ((historyEntryData: ExportAgentHistoryPayload) => Promise<{
|
|
3110
|
-
historyEntryId: string;
|
|
3111
|
-
}>) | undefined;
|
|
3112
|
-
get exportHistoryEntryAsync(): ((historyEntryData: ExportAgentHistoryPayload) => void) | undefined;
|
|
3113
|
-
get exportTimelineEvent(): ((timelineEventData: ExportTimelineEventPayload) => Promise<{
|
|
3114
|
-
timelineEventId: string;
|
|
3115
|
-
}>) | undefined;
|
|
3116
|
-
get exportTimelineEventAsync(): ((timelineEventData: ExportTimelineEventPayload) => void) | undefined;
|
|
3117
|
-
/**
|
|
3118
|
-
* Check if observability is enabled and configured
|
|
3119
|
-
*/
|
|
3120
|
-
isObservabilityEnabled(): boolean;
|
|
3121
|
-
/**
|
|
3122
|
-
* Check if prompt management is enabled and configured
|
|
3123
|
-
*/
|
|
3124
|
-
isPromptManagementEnabled(): boolean;
|
|
3125
|
-
/**
|
|
3126
|
-
* Get observability exporter for backward compatibility
|
|
3127
|
-
* @deprecated Use observability property directly
|
|
3128
|
-
*/
|
|
3129
|
-
getObservabilityExporter(): VoltAgentExporter | undefined;
|
|
3130
|
-
/**
|
|
3131
|
-
* Get prompt manager for direct access
|
|
3132
|
-
*/
|
|
3133
|
-
getPromptManager(): VoltOpsPromptManager | undefined;
|
|
3134
|
-
/**
|
|
3135
|
-
* Static method to create prompt helper with priority-based fallback
|
|
3136
|
-
* Priority: Agent VoltOpsClient > Global VoltOpsClient > Fallback instructions
|
|
3137
|
-
*/
|
|
3138
|
-
static createPromptHelperWithFallback(agentId: string, agentName: string, fallbackInstructions: string, agentVoltOpsClient?: VoltOpsClient): PromptHelper;
|
|
3139
|
-
/**
|
|
3140
|
-
* Validate API keys and provide helpful error messages
|
|
3141
|
-
*/
|
|
3142
|
-
private validateApiKeys;
|
|
3143
|
-
/**
|
|
3144
|
-
* Cleanup resources when client is no longer needed
|
|
3145
|
-
*/
|
|
3146
|
-
dispose(): Promise<void>;
|
|
3147
|
-
}
|
|
3148
|
-
/**
|
|
3149
|
-
* Factory function to create VoltOps client
|
|
3150
|
-
*/
|
|
3151
|
-
declare const createVoltOpsClient: (options: VoltOpsClientOptions) => VoltOpsClient;
|
|
3152
|
-
|
|
3153
3153
|
/**
|
|
3154
3154
|
* ReadableStream type for voice responses
|
|
3155
3155
|
*/
|
|
@@ -3258,63 +3258,64 @@ type Voice = {
|
|
|
3258
3258
|
getVoices(): Promise<VoiceMetadata[]>;
|
|
3259
3259
|
};
|
|
3260
3260
|
|
|
3261
|
-
|
|
3262
|
-
|
|
3263
|
-
|
|
3264
|
-
|
|
3265
|
-
|
|
3261
|
+
/**
|
|
3262
|
+
* Main VoltOps client class that provides unified access to both
|
|
3263
|
+
* telemetry export and prompt management functionality.
|
|
3264
|
+
*/
|
|
3265
|
+
declare class VoltOpsClient implements VoltOpsClient$1 {
|
|
3266
|
+
readonly options: VoltOpsClientOptions & {
|
|
3267
|
+
baseUrl: string;
|
|
3268
|
+
};
|
|
3269
|
+
readonly observability?: VoltAgentExporter;
|
|
3270
|
+
readonly prompts?: VoltOpsPromptManager;
|
|
3271
|
+
constructor(options: VoltOpsClientOptions);
|
|
3266
3272
|
/**
|
|
3267
|
-
*
|
|
3273
|
+
* Create a prompt helper for agent instructions
|
|
3268
3274
|
*/
|
|
3269
|
-
|
|
3275
|
+
createPromptHelper(_agentId: string): PromptHelper;
|
|
3276
|
+
get exportHistoryEntry(): ((historyEntryData: ExportAgentHistoryPayload) => Promise<{
|
|
3277
|
+
historyEntryId: string;
|
|
3278
|
+
}>) | undefined;
|
|
3279
|
+
get exportHistoryEntryAsync(): ((historyEntryData: ExportAgentHistoryPayload) => void) | undefined;
|
|
3280
|
+
get exportTimelineEvent(): ((timelineEventData: ExportTimelineEventPayload) => Promise<{
|
|
3281
|
+
timelineEventId: string;
|
|
3282
|
+
}>) | undefined;
|
|
3283
|
+
get exportTimelineEventAsync(): ((timelineEventData: ExportTimelineEventPayload) => void) | undefined;
|
|
3270
3284
|
/**
|
|
3271
|
-
*
|
|
3285
|
+
* Check if observability is enabled and configured
|
|
3272
3286
|
*/
|
|
3273
|
-
|
|
3274
|
-
/**
|
|
3275
|
-
|
|
3276
|
-
|
|
3277
|
-
|
|
3278
|
-
/**
|
|
3279
|
-
|
|
3280
|
-
|
|
3281
|
-
|
|
3282
|
-
|
|
3283
|
-
|
|
3284
|
-
|
|
3285
|
-
|
|
3286
|
-
|
|
3287
|
-
|
|
3288
|
-
|
|
3289
|
-
|
|
3290
|
-
|
|
3291
|
-
|
|
3292
|
-
|
|
3293
|
-
|
|
3294
|
-
|
|
3295
|
-
|
|
3296
|
-
|
|
3297
|
-
|
|
3287
|
+
isObservabilityEnabled(): boolean;
|
|
3288
|
+
/**
|
|
3289
|
+
* Check if prompt management is enabled and configured
|
|
3290
|
+
*/
|
|
3291
|
+
isPromptManagementEnabled(): boolean;
|
|
3292
|
+
/**
|
|
3293
|
+
* Get observability exporter for backward compatibility
|
|
3294
|
+
* @deprecated Use observability property directly
|
|
3295
|
+
*/
|
|
3296
|
+
getObservabilityExporter(): VoltAgentExporter | undefined;
|
|
3297
|
+
/**
|
|
3298
|
+
* Get prompt manager for direct access
|
|
3299
|
+
*/
|
|
3300
|
+
getPromptManager(): VoltOpsPromptManager | undefined;
|
|
3301
|
+
/**
|
|
3302
|
+
* Static method to create prompt helper with priority-based fallback
|
|
3303
|
+
* Priority: Agent VoltOpsClient > Global VoltOpsClient > Fallback instructions
|
|
3304
|
+
*/
|
|
3305
|
+
static createPromptHelperWithFallback(agentId: string, agentName: string, fallbackInstructions: string, agentVoltOpsClient?: VoltOpsClient): PromptHelper;
|
|
3306
|
+
/**
|
|
3307
|
+
* Validate API keys and provide helpful error messages
|
|
3308
|
+
*/
|
|
3309
|
+
private validateApiKeys;
|
|
3310
|
+
/**
|
|
3311
|
+
* Cleanup resources when client is no longer needed
|
|
3312
|
+
*/
|
|
3313
|
+
dispose(): Promise<void>;
|
|
3298
3314
|
}
|
|
3299
|
-
type AgentHookOnStart = (args: OnStartHookArgs) => Promise<void> | void;
|
|
3300
|
-
type AgentHookOnEnd = (args: OnEndHookArgs) => Promise<void> | void;
|
|
3301
|
-
type AgentHookOnHandoff = (args: OnHandoffHookArgs) => Promise<void> | void;
|
|
3302
|
-
type AgentHookOnToolStart = (args: OnToolStartHookArgs) => Promise<void> | void;
|
|
3303
|
-
type AgentHookOnToolEnd = (args: OnToolEndHookArgs) => Promise<void> | void;
|
|
3304
3315
|
/**
|
|
3305
|
-
*
|
|
3306
|
-
*/
|
|
3307
|
-
type AgentHooks = {
|
|
3308
|
-
onStart?: AgentHookOnStart;
|
|
3309
|
-
onEnd?: AgentHookOnEnd;
|
|
3310
|
-
onHandoff?: AgentHookOnHandoff;
|
|
3311
|
-
onToolStart?: AgentHookOnToolStart;
|
|
3312
|
-
onToolEnd?: AgentHookOnToolEnd;
|
|
3313
|
-
};
|
|
3314
|
-
/**
|
|
3315
|
-
* Create hooks from an object literal.
|
|
3316
|
+
* Factory function to create VoltOps client
|
|
3316
3317
|
*/
|
|
3317
|
-
declare
|
|
3318
|
+
declare const createVoltOpsClient: (options: VoltOpsClientOptions) => VoltOpsClient;
|
|
3318
3319
|
|
|
3319
3320
|
/**
|
|
3320
3321
|
* SubAgentManager - Manages sub-agents and delegation functionality for an Agent
|
|
@@ -3710,6 +3711,12 @@ declare class Agent<TProvider extends {
|
|
|
3710
3711
|
* This is typically called by the main VoltAgent instance after it has initialized its exporter.
|
|
3711
3712
|
*/
|
|
3712
3713
|
_INTERNAL_setVoltAgentExporter(exporter: VoltAgentExporter): void;
|
|
3714
|
+
/**
|
|
3715
|
+
* Helper method to merge the agent's hooks with the ones passed in the options
|
|
3716
|
+
* @param options - The options passed to the generate method
|
|
3717
|
+
* @returns The merged hooks
|
|
3718
|
+
*/
|
|
3719
|
+
private getMergedHooks;
|
|
3713
3720
|
/**
|
|
3714
3721
|
* Helper method to get retriever context with event handling
|
|
3715
3722
|
*/
|
|
@@ -3825,6 +3832,30 @@ type VoltAgentOptions = {
|
|
|
3825
3832
|
enableSwaggerUI?: boolean;
|
|
3826
3833
|
};
|
|
3827
3834
|
|
|
3835
|
+
interface WorkflowRunOptions {
|
|
3836
|
+
/**
|
|
3837
|
+
* The active step, this can be used to track the current step in a workflow
|
|
3838
|
+
* @default 0
|
|
3839
|
+
*/
|
|
3840
|
+
active?: number;
|
|
3841
|
+
/**
|
|
3842
|
+
* The execution ID, this can be used to track the current execution in a workflow
|
|
3843
|
+
* @default uuidv4
|
|
3844
|
+
*/
|
|
3845
|
+
executionId?: string;
|
|
3846
|
+
/**
|
|
3847
|
+
* The conversation ID, this can be used to track the current conversation in a workflow
|
|
3848
|
+
*/
|
|
3849
|
+
conversationId?: string;
|
|
3850
|
+
/**
|
|
3851
|
+
* The user ID, this can be used to track the current user in a workflow
|
|
3852
|
+
*/
|
|
3853
|
+
userId?: string;
|
|
3854
|
+
/**
|
|
3855
|
+
* The user context, this can be used to track the current user context in a workflow
|
|
3856
|
+
*/
|
|
3857
|
+
userContext?: UserContext;
|
|
3858
|
+
}
|
|
3828
3859
|
/**
|
|
3829
3860
|
* Hooks for the workflow
|
|
3830
3861
|
* @param DATA - The type of the data
|
|
@@ -3910,7 +3941,7 @@ type Workflow<INPUT_SCHEMA extends InternalBaseWorkflowInputSchema, RESULT_SCHEM
|
|
|
3910
3941
|
* @param input - The input to the workflow
|
|
3911
3942
|
* @returns The result of the workflow
|
|
3912
3943
|
*/
|
|
3913
|
-
run: (input: WorkflowInput<INPUT_SCHEMA
|
|
3944
|
+
run: (input: WorkflowInput<INPUT_SCHEMA>, options?: WorkflowRunOptions) => Promise<{
|
|
3914
3945
|
executionId: string;
|
|
3915
3946
|
startAt: Date;
|
|
3916
3947
|
endAt: Date;
|
|
@@ -4059,6 +4090,12 @@ type WorkflowStepFuncConfig<INPUT, DATA, RESULT> = InternalWorkflowStepConfig<{
|
|
|
4059
4090
|
interface WorkflowStepFunc<INPUT, DATA, RESULT> extends InternalBaseWorkflowStep<INPUT, DATA, RESULT> {
|
|
4060
4091
|
type: "func";
|
|
4061
4092
|
}
|
|
4093
|
+
type WorkflowStepTapConfig<INPUT, DATA, _RESULT> = InternalWorkflowStepConfig<{
|
|
4094
|
+
execute: InternalWorkflowFunc<INPUT, DATA, DangerouslyAllowAny>;
|
|
4095
|
+
}>;
|
|
4096
|
+
interface WorkflowStepTap<INPUT, DATA, _RESULT> extends InternalBaseWorkflowStep<INPUT, DATA, DATA> {
|
|
4097
|
+
type: "tap";
|
|
4098
|
+
}
|
|
4062
4099
|
type WorkflowStepConditionalWhenConfig<INPUT, DATA, RESULT> = InternalWorkflowStepConfig<{
|
|
4063
4100
|
condition: InternalWorkflowFunc<INPUT, DATA, boolean>;
|
|
4064
4101
|
step: InternalAnyWorkflowStep<INPUT, DATA, RESULT>;
|
|
@@ -4081,7 +4118,7 @@ interface WorkflowStepParallelAll<INPUT, DATA, RESULT> extends InternalBaseWorkf
|
|
|
4081
4118
|
type: "parallel-all";
|
|
4082
4119
|
steps: ReadonlyArray<InternalAnyWorkflowStep<INPUT, DATA, RESULT>>;
|
|
4083
4120
|
}
|
|
4084
|
-
type WorkflowStep<INPUT, DATA, RESULT> = WorkflowStepAgent<INPUT, DATA, RESULT> | WorkflowStepFunc<INPUT, DATA, RESULT> | WorkflowStepConditionalWhen<INPUT, DATA, RESULT> | WorkflowStepParallelAll<INPUT, DATA, RESULT> | WorkflowStepParallelRace<INPUT, DATA, RESULT>;
|
|
4121
|
+
type WorkflowStep<INPUT, DATA, RESULT> = WorkflowStepAgent<INPUT, DATA, RESULT> | WorkflowStepFunc<INPUT, DATA, RESULT> | WorkflowStepConditionalWhen<INPUT, DATA, RESULT> | WorkflowStepParallelAll<INPUT, DATA, RESULT> | WorkflowStepTap<INPUT, DATA, RESULT> | WorkflowStepParallelRace<INPUT, DATA, RESULT>;
|
|
4085
4122
|
|
|
4086
4123
|
/**
|
|
4087
4124
|
* Creates an async function step for the workflow
|
|
@@ -4230,6 +4267,19 @@ declare function andRace<INPUT, DATA, RESULT, STEPS extends ReadonlyArray<Intern
|
|
|
4230
4267
|
purpose: string;
|
|
4231
4268
|
};
|
|
4232
4269
|
|
|
4270
|
+
/**
|
|
4271
|
+
* A safe way to tap into the workflow state without affecting the result.
|
|
4272
|
+
* @param fn - The async function to execute
|
|
4273
|
+
* @returns A workflow step that executes the function
|
|
4274
|
+
*/
|
|
4275
|
+
declare function andTap<INPUT, DATA, RESULT>({ execute, ...config }: WorkflowStepTapConfig<INPUT, DATA, RESULT>): {
|
|
4276
|
+
type: "tap";
|
|
4277
|
+
execute: (data: InternalExtractWorkflowInputData<DATA>, context: InternalWorkflowStateParam<INPUT>) => Promise<DATA>;
|
|
4278
|
+
id: string;
|
|
4279
|
+
name: string;
|
|
4280
|
+
purpose: string;
|
|
4281
|
+
};
|
|
4282
|
+
|
|
4233
4283
|
/**
|
|
4234
4284
|
* Creates a workflow from multiple and* functions
|
|
4235
4285
|
* @param config - The workflow configuration
|
|
@@ -4371,6 +4421,29 @@ declare class WorkflowChain<INPUT_SCHEMA extends InternalBaseWorkflowInputSchema
|
|
|
4371
4421
|
* @returns A new chain with the conditional step added
|
|
4372
4422
|
*/
|
|
4373
4423
|
andWhen<NEW_DATA>({ condition, step, ...config }: WorkflowStepConditionalWhenConfig<WorkflowInput<INPUT_SCHEMA>, CURRENT_DATA, NEW_DATA>): WorkflowChain<INPUT_SCHEMA, RESULT_SCHEMA, NEW_DATA | CURRENT_DATA>;
|
|
4424
|
+
/**
|
|
4425
|
+
* Add a tap step to the workflow
|
|
4426
|
+
*
|
|
4427
|
+
* @example
|
|
4428
|
+
* ```ts
|
|
4429
|
+
* const workflow = createWorkflowChain(config)
|
|
4430
|
+
* .andTap({
|
|
4431
|
+
* execute: async (data) => {
|
|
4432
|
+
* console.log("🔄 Translating text:", data);
|
|
4433
|
+
* }
|
|
4434
|
+
* })
|
|
4435
|
+
* .andThen({
|
|
4436
|
+
* // the input data is still the same as the andTap ONLY executes, it doesn't return anything
|
|
4437
|
+
* execute: async (data) => {
|
|
4438
|
+
* return { ...data, translatedText: data.translatedText };
|
|
4439
|
+
* }
|
|
4440
|
+
* });
|
|
4441
|
+
* ```
|
|
4442
|
+
*
|
|
4443
|
+
* @param fn - The async function to execute with the current workflow data
|
|
4444
|
+
* @returns A new chain with the tap step added
|
|
4445
|
+
*/
|
|
4446
|
+
andTap<NEW_DATA>({ execute, ...config }: WorkflowStepTapConfig<WorkflowInput<INPUT_SCHEMA>, CURRENT_DATA, NEW_DATA>): WorkflowChain<INPUT_SCHEMA, RESULT_SCHEMA, CURRENT_DATA>;
|
|
4374
4447
|
/**
|
|
4375
4448
|
* Add a parallel execution step that runs multiple steps simultaneously and waits for all to complete
|
|
4376
4449
|
*
|
|
@@ -4468,7 +4541,7 @@ declare class WorkflowChain<INPUT_SCHEMA extends InternalBaseWorkflowInputSchema
|
|
|
4468
4541
|
* @param input - The input data for the workflow that matches the input schema
|
|
4469
4542
|
* @returns The workflow execution result that matches the result schema
|
|
4470
4543
|
*/
|
|
4471
|
-
run(input: WorkflowInput<INPUT_SCHEMA
|
|
4544
|
+
run(input: WorkflowInput<INPUT_SCHEMA>, options?: WorkflowRunOptions): Promise<{
|
|
4472
4545
|
executionId: string;
|
|
4473
4546
|
startAt: Date;
|
|
4474
4547
|
endAt: Date;
|
|
@@ -4853,6 +4926,11 @@ type HTTPServerConfig = {
|
|
|
4853
4926
|
* Event source initialization options (used for SSE fallback)
|
|
4854
4927
|
*/
|
|
4855
4928
|
eventSourceInit?: EventSourceInit;
|
|
4929
|
+
/**
|
|
4930
|
+
* Optional maximum request timeout in milliseconds.
|
|
4931
|
+
* If provided, passed to MCPClient as the per-request timeout.
|
|
4932
|
+
*/
|
|
4933
|
+
timeout?: number;
|
|
4856
4934
|
};
|
|
4857
4935
|
/**
|
|
4858
4936
|
* SSE-based MCP server configuration (explicit SSE transport)
|
|
@@ -4874,6 +4952,11 @@ type SSEServerConfig = {
|
|
|
4874
4952
|
* Event source initialization options
|
|
4875
4953
|
*/
|
|
4876
4954
|
eventSourceInit?: EventSourceInit;
|
|
4955
|
+
/**
|
|
4956
|
+
* Optional maximum request timeout in milliseconds.
|
|
4957
|
+
* If provided, passed to MCPClient as the per-request timeout.
|
|
4958
|
+
*/
|
|
4959
|
+
timeout?: number;
|
|
4877
4960
|
};
|
|
4878
4961
|
/**
|
|
4879
4962
|
* Streamable HTTP-based MCP server configuration (no fallback)
|
|
@@ -4895,6 +4978,11 @@ type StreamableHTTPServerConfig = {
|
|
|
4895
4978
|
* Session ID for the connection
|
|
4896
4979
|
*/
|
|
4897
4980
|
sessionId?: string;
|
|
4981
|
+
/**
|
|
4982
|
+
* Optional maximum request timeout in milliseconds.
|
|
4983
|
+
* If provided, passed to MCPClient as the per-request timeout.
|
|
4984
|
+
*/
|
|
4985
|
+
timeout?: number;
|
|
4898
4986
|
};
|
|
4899
4987
|
/**
|
|
4900
4988
|
* Stdio-based MCP server configuration
|
|
@@ -4920,6 +5008,11 @@ type StdioServerConfig = {
|
|
|
4920
5008
|
* Working directory for the MCP server process
|
|
4921
5009
|
*/
|
|
4922
5010
|
cwd?: string;
|
|
5011
|
+
/**
|
|
5012
|
+
* Optional maximum request timeout in milliseconds.
|
|
5013
|
+
* If provided, passed to MCPClient as the per-request timeout.
|
|
5014
|
+
*/
|
|
5015
|
+
timeout?: number;
|
|
4923
5016
|
};
|
|
4924
5017
|
/**
|
|
4925
5018
|
* Tool call request
|
|
@@ -5448,4 +5541,4 @@ declare class VoltAgent {
|
|
|
5448
5541
|
shutdownTelemetry(): Promise<void>;
|
|
5449
5542
|
}
|
|
5450
5543
|
|
|
5451
|
-
export { Agent, AgentErrorEvent, AgentHistoryEntry, AgentHookOnEnd, AgentHookOnHandoff, AgentHookOnStart, AgentHookOnToolEnd, AgentHookOnToolStart, AgentHooks, AgentOptions, AgentRegistry, AgentResponse, AgentStartEvent, AgentStartEventMetadata, AgentSuccessEvent, AgentSuccessEventMetadata, AgentTool, AllowedVariableValue, AnyToolConfig, AsyncIterableStream, BaseEventMetadata, BaseLLMOptions, BaseMessage, BaseRetriever, BaseTimelineEvent, BaseTool, BaseToolCall, CachedPrompt, ChatMessage, ClientInfo, Conversation, ConversationQueryOptions, CreateConversationInput, CreateReasoningToolsOptions, CustomEndpointDefinition, CustomEndpointError, CustomEndpointHandler, DEFAULT_INSTRUCTIONS, DataContent, DynamicValue, DynamicValueOptions, ErrorStreamPart, EventStatus, ExtractVariableNames, FEW_SHOT_EXAMPLES, FilePart, FinishStreamPart, GenerateObjectOptions, GenerateTextOptions, HTTPServerConfig, HistoryStatus, HttpMethod, VoltOpsClient$1 as IVoltOpsClient, ImagePart, InMemoryStorage, InferGenerateObjectResponse, InferGenerateTextResponse, InferMessage, InferModel, InferProviderParams, InferStreamResponse, InferTool, LLMProvider, LibSQLStorage, MCPClient, MCPClientConfig, MCPClientEvents, MCPConfiguration, MCPOptions, MCPServerConfig, MCPToolCall, MCPToolResult, Memory, MemoryEventMetadata, MemoryManager, MemoryMessage, MemoryOptions, MemoryReadErrorEvent, MemoryReadStartEvent, MemoryReadSuccessEvent, MemoryWriteErrorEvent, MemoryWriteStartEvent, MemoryWriteSuccessEvent, MessageContent, MessageFilterOptions, MessageRole, ModelToolCall, NewTimelineEvent, NextAction, NodeType, ObjectSubAgentConfig, OnEndHookArgs, OnHandoffHookArgs, OnStartHookArgs, OnToolEndHookArgs, OnToolStartHookArgs, OperationContext, PackageUpdateInfo, PromptApiClient, PromptApiResponse, PromptContent, PromptCreator, PromptHelper, PromptReference, PromptTemplate, ProviderObjectResponse, ProviderObjectStreamResponse, ProviderParams, ProviderResponse, ProviderTextResponse, ProviderTextStreamResponse, ReadableStreamType, ReasoningStep, ReasoningStepSchema, ReasoningStreamPart, ReasoningToolExecuteOptions, RetrieveOptions, Retriever, RetrieverErrorEvent, RetrieverOptions, RetrieverStartEvent, RetrieverSuccessEvent, SSEServerConfig, ServerOptions, SourceStreamPart, StandardEventData, StandardTimelineEvent, StdioServerConfig, StepChunkCallback, StepFinishCallback, StepWithContent, StreamEventForwarderOptions, StreamObjectFinishResult, StreamObjectOnFinishCallback, StreamObjectOptions, StreamPart, StreamTextFinishResult, StreamTextOnFinishCallback, StreamTextOptions, StreamableHTTPServerConfig, SubAgentConfig, SubAgentConfigObject, SubAgentMethod, TemplateVariables, TextDeltaStreamPart, TextPart, TextSubAgentConfig, TimelineEventCoreLevel, TimelineEventCoreStatus, TimelineEventCoreType, Tool, ToolCall, ToolCallStreamPart, ToolErrorEvent, ToolErrorInfo, ToolExecuteOptions, ToolExecutionContext, ToolManager, ToolOptions, ToolResultStreamPart, ToolSchema, ToolStartEvent, ToolStatus, ToolStatusInfo, ToolSuccessEvent, Toolkit, ToolsetMap, ToolsetWithTools, TransportError, Usage, UsageInfo, Voice, VoiceEventData, VoiceEventType, VoiceMetadata, VoiceOptions, VoltAgent, VoltAgentError, VoltAgentExporter, VoltAgentExporterOptions, VoltAgentOptions, VoltOpsClient, VoltOpsClientOptions, VoltOpsPromptApiClient, VoltOpsPromptManager, VoltOpsPromptManagerImpl, Workflow, WorkflowConfig, andAgent, andAll, andRace, andThen, andWhen, checkForUpdates, createAsyncIterableStream, createHooks, createNodeId, createPrompt, createReasoningTools, createRetrieverTool, createSimpleTemplateEngine, createStreamEventForwarder, createSubagent, createTool, createToolkit, createVoltOpsClient, createWorkflow, createWorkflowChain, VoltAgent as default, getNodeTypeFromNodeId, registerCustomEndpoint, registerCustomEndpoints, safeJsonParse, serializeValueForDebug, streamEventForwarder, tool, updateAllPackages, updateSinglePackage, zodSchemaToJsonUI };
|
|
5544
|
+
export { Agent, AgentErrorEvent, AgentHistoryEntry, AgentHookOnEnd, AgentHookOnHandoff, AgentHookOnStart, AgentHookOnToolEnd, AgentHookOnToolStart, AgentHooks, AgentOptions, AgentRegistry, AgentResponse, AgentStartEvent, AgentStartEventMetadata, AgentSuccessEvent, AgentSuccessEventMetadata, AgentTool, AllowedVariableValue, AnyToolConfig, AsyncIterableStream, BaseEventMetadata, BaseLLMOptions, BaseMessage, BaseRetriever, BaseTimelineEvent, BaseTool, BaseToolCall, CachedPrompt, ChatMessage, ClientInfo, Conversation, ConversationQueryOptions, CreateConversationInput, CreateReasoningToolsOptions, CustomEndpointDefinition, CustomEndpointError, CustomEndpointHandler, DEFAULT_INSTRUCTIONS, DataContent, DynamicValue, DynamicValueOptions, ErrorStreamPart, EventStatus, ExtractVariableNames, FEW_SHOT_EXAMPLES, FilePart, FinishStreamPart, GenerateObjectOptions, GenerateTextOptions, HTTPServerConfig, HistoryStatus, HttpMethod, VoltOpsClient$1 as IVoltOpsClient, ImagePart, InMemoryStorage, InferGenerateObjectResponse, InferGenerateTextResponse, InferMessage, InferModel, InferProviderParams, InferStreamResponse, InferTool, LLMProvider, LibSQLStorage, MCPClient, MCPClientConfig, MCPClientEvents, MCPConfiguration, MCPOptions, MCPServerConfig, MCPToolCall, MCPToolResult, Memory, MemoryEventMetadata, MemoryManager, MemoryMessage, MemoryOptions, MemoryReadErrorEvent, MemoryReadStartEvent, MemoryReadSuccessEvent, MemoryWriteErrorEvent, MemoryWriteStartEvent, MemoryWriteSuccessEvent, MessageContent, MessageFilterOptions, MessageRole, ModelToolCall, NewTimelineEvent, NextAction, NodeType, ObjectSubAgentConfig, OnEndHookArgs, OnHandoffHookArgs, OnStartHookArgs, OnToolEndHookArgs, OnToolStartHookArgs, OperationContext, PackageUpdateInfo, PromptApiClient, PromptApiResponse, PromptContent, PromptCreator, PromptHelper, PromptReference, PromptTemplate, ProviderObjectResponse, ProviderObjectStreamResponse, ProviderParams, ProviderResponse, ProviderTextResponse, ProviderTextStreamResponse, ReadableStreamType, ReasoningStep, ReasoningStepSchema, ReasoningStreamPart, ReasoningToolExecuteOptions, RetrieveOptions, Retriever, RetrieverErrorEvent, RetrieverOptions, RetrieverStartEvent, RetrieverSuccessEvent, SSEServerConfig, ServerOptions, SourceStreamPart, StandardEventData, StandardTimelineEvent, StdioServerConfig, StepChunkCallback, StepFinishCallback, StepWithContent, StreamEventForwarderOptions, StreamObjectFinishResult, StreamObjectOnFinishCallback, StreamObjectOptions, StreamPart, StreamTextFinishResult, StreamTextOnFinishCallback, StreamTextOptions, StreamableHTTPServerConfig, SubAgentConfig, SubAgentConfigObject, SubAgentMethod, TemplateVariables, TextDeltaStreamPart, TextPart, TextSubAgentConfig, TimelineEventCoreLevel, TimelineEventCoreStatus, TimelineEventCoreType, Tool, ToolCall, ToolCallStreamPart, ToolErrorEvent, ToolErrorInfo, ToolExecuteOptions, ToolExecutionContext, ToolManager, ToolOptions, ToolResultStreamPart, ToolSchema, ToolStartEvent, ToolStatus, ToolStatusInfo, ToolSuccessEvent, Toolkit, ToolsetMap, ToolsetWithTools, TransportError, Usage, UsageInfo, Voice, VoiceEventData, VoiceEventType, VoiceMetadata, VoiceOptions, VoltAgent, VoltAgentError, VoltAgentExporter, VoltAgentExporterOptions, VoltAgentOptions, VoltOpsClient, VoltOpsClientOptions, VoltOpsPromptApiClient, VoltOpsPromptManager, VoltOpsPromptManagerImpl, Workflow, WorkflowConfig, andAgent, andAll, andRace, andTap, andThen, andWhen, checkForUpdates, createAsyncIterableStream, createHooks, createNodeId, createPrompt, createReasoningTools, createRetrieverTool, createSimpleTemplateEngine, createStreamEventForwarder, createSubagent, createTool, createToolkit, createVoltOpsClient, createWorkflow, createWorkflowChain, VoltAgent as default, getNodeTypeFromNodeId, registerCustomEndpoint, registerCustomEndpoints, safeJsonParse, serializeValueForDebug, streamEventForwarder, tool, updateAllPackages, updateSinglePackage, zodSchemaToJsonUI };
|