@voltagent/core 0.1.64 → 0.1.66
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 +148 -7
- package/dist/index.js +8604 -7115
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +8627 -7139
- package/dist/index.mjs.map +1 -1
- package/package.json +9 -3
package/dist/index.d.ts
CHANGED
|
@@ -6,6 +6,7 @@ export { AsyncIterableStream, createAsyncIterableStream } from '@voltagent/inter
|
|
|
6
6
|
import { Span } from '@opentelemetry/api';
|
|
7
7
|
import * as TF from 'type-fest';
|
|
8
8
|
import { Simplify, LiteralUnion, MergeDeep } from 'type-fest';
|
|
9
|
+
import { Logger } from '@voltagent/internal';
|
|
9
10
|
import { EventEmitter } from 'node:events';
|
|
10
11
|
import { Client } from '@libsql/client';
|
|
11
12
|
import { SpanExporter } from '@opentelemetry/sdk-trace-base';
|
|
@@ -81,11 +82,15 @@ declare class ToolManager {
|
|
|
81
82
|
* Toolkits managed by this manager.
|
|
82
83
|
*/
|
|
83
84
|
private toolkits;
|
|
85
|
+
/**
|
|
86
|
+
* Logger instance
|
|
87
|
+
*/
|
|
88
|
+
private logger;
|
|
84
89
|
/**
|
|
85
90
|
* Creates a new ToolManager.
|
|
86
91
|
* Accepts both individual tools and toolkits.
|
|
87
92
|
*/
|
|
88
|
-
constructor(items?: (AgentTool | Toolkit)[]);
|
|
93
|
+
constructor(items?: (AgentTool | Toolkit)[], logger?: Logger);
|
|
89
94
|
/**
|
|
90
95
|
* Get all individual tools and tools within toolkits as a flattened list.
|
|
91
96
|
*/
|
|
@@ -250,6 +255,11 @@ interface WorkflowExecuteContext<INPUT, DATA, SUSPEND_DATA, RESUME_DATA> {
|
|
|
250
255
|
} | undefined;
|
|
251
256
|
suspend: (reason?: string, suspendData?: SUSPEND_DATA) => Promise<never>;
|
|
252
257
|
resumeData?: RESUME_DATA;
|
|
258
|
+
/**
|
|
259
|
+
* Logger instance for this workflow execution.
|
|
260
|
+
* Provides execution-scoped logging with full context (userId, conversationId, executionId).
|
|
261
|
+
*/
|
|
262
|
+
logger: Logger;
|
|
253
263
|
}
|
|
254
264
|
/**
|
|
255
265
|
* A function that can be executed by the workflow
|
|
@@ -480,6 +490,11 @@ interface WorkflowRunOptions {
|
|
|
480
490
|
* @default 'graceful'
|
|
481
491
|
*/
|
|
482
492
|
suspensionMode?: "immediate" | "graceful";
|
|
493
|
+
/**
|
|
494
|
+
* Logger instance to use for this workflow execution
|
|
495
|
+
* If not provided, will use the workflow's logger or global logger
|
|
496
|
+
*/
|
|
497
|
+
logger?: Logger;
|
|
483
498
|
}
|
|
484
499
|
interface WorkflowResumeOptions {
|
|
485
500
|
/**
|
|
@@ -577,6 +592,11 @@ type WorkflowConfig<INPUT_SCHEMA extends InternalBaseWorkflowInputSchema, RESULT
|
|
|
577
592
|
* Overrides global workflow memory from VoltAgent
|
|
578
593
|
*/
|
|
579
594
|
memory?: Memory;
|
|
595
|
+
/**
|
|
596
|
+
* Logger instance to use for this workflow
|
|
597
|
+
* If not provided, will use the global logger or create a default one
|
|
598
|
+
*/
|
|
599
|
+
logger?: Logger;
|
|
580
600
|
};
|
|
581
601
|
/**
|
|
582
602
|
* A workflow instance that can be executed
|
|
@@ -720,6 +740,7 @@ interface CreateWorkflowExecutionOptions {
|
|
|
720
740
|
conversationId?: string;
|
|
721
741
|
userContext?: UserContext;
|
|
722
742
|
metadata?: Record<string, unknown>;
|
|
743
|
+
executionId?: string;
|
|
723
744
|
}
|
|
724
745
|
/**
|
|
725
746
|
* Options for recording workflow step
|
|
@@ -804,6 +825,11 @@ interface WorkflowExecutionContext {
|
|
|
804
825
|
* Used to maintain event ordering even after server restarts
|
|
805
826
|
*/
|
|
806
827
|
eventSequence: number;
|
|
828
|
+
/**
|
|
829
|
+
* Logger instance for this workflow execution
|
|
830
|
+
* Provides execution-scoped logging with full context (userId, conversationId, executionId)
|
|
831
|
+
*/
|
|
832
|
+
logger: Logger;
|
|
807
833
|
}
|
|
808
834
|
/**
|
|
809
835
|
* Workflow step context for individual step tracking
|
|
@@ -1153,6 +1179,10 @@ declare class HistoryManager {
|
|
|
1153
1179
|
* Uses lower concurrency to preserve operation order when telemetryExporter is enabled
|
|
1154
1180
|
*/
|
|
1155
1181
|
private historyQueue;
|
|
1182
|
+
/**
|
|
1183
|
+
* Logger instance
|
|
1184
|
+
*/
|
|
1185
|
+
private logger;
|
|
1156
1186
|
/**
|
|
1157
1187
|
* Create a new history manager
|
|
1158
1188
|
*
|
|
@@ -1161,7 +1191,7 @@ declare class HistoryManager {
|
|
|
1161
1191
|
* @param maxEntries - Maximum number of history entries to keep (0 = unlimited)
|
|
1162
1192
|
* @param voltAgentExporter - Optional exporter for telemetry
|
|
1163
1193
|
*/
|
|
1164
|
-
constructor(agentId: string, memoryManager: MemoryManager, maxEntries?: number, voltAgentExporter?: VoltAgentExporter);
|
|
1194
|
+
constructor(agentId: string, memoryManager: MemoryManager, maxEntries?: number, voltAgentExporter?: VoltAgentExporter, logger?: Logger);
|
|
1165
1195
|
/**
|
|
1166
1196
|
* Set the agent ID for this history manager
|
|
1167
1197
|
*/
|
|
@@ -1302,6 +1332,7 @@ interface VoltAgentExporterOptions {
|
|
|
1302
1332
|
declare class VoltAgentExporter {
|
|
1303
1333
|
private apiClient;
|
|
1304
1334
|
readonly publicKey: string;
|
|
1335
|
+
private logger;
|
|
1305
1336
|
/**
|
|
1306
1337
|
* Internal queue for all telemetry export operations
|
|
1307
1338
|
* Ensures non-blocking exports that don't interfere with event ordering
|
|
@@ -1386,6 +1417,7 @@ interface StreamEventForwarderOptions {
|
|
|
1386
1417
|
forwarder: (event: StreamEvent) => Promise<void>;
|
|
1387
1418
|
types: Array<LiteralUnion<StreamEventType, string>> | ReadonlyArray<LiteralUnion<StreamEventType, string>>;
|
|
1388
1419
|
addSubAgentPrefix?: boolean;
|
|
1420
|
+
logger?: Logger;
|
|
1389
1421
|
}
|
|
1390
1422
|
/**
|
|
1391
1423
|
* Forwards SubAgent events to a stream with optional filtering and prefixing
|
|
@@ -1905,6 +1937,11 @@ type AgentOptions = {
|
|
|
1905
1937
|
* Configuration for supervisor behavior when subAgents are present
|
|
1906
1938
|
*/
|
|
1907
1939
|
supervisorConfig?: SupervisorConfig;
|
|
1940
|
+
/**
|
|
1941
|
+
* Logger instance to use for this agent
|
|
1942
|
+
* If not provided, will use the global logger or create a default one
|
|
1943
|
+
*/
|
|
1944
|
+
logger?: Logger;
|
|
1908
1945
|
} & ({
|
|
1909
1946
|
/**
|
|
1910
1947
|
* @deprecated Use `instructions` instead.
|
|
@@ -2172,6 +2209,8 @@ type OperationContext = {
|
|
|
2172
2209
|
parentHistoryEntryId?: string;
|
|
2173
2210
|
/** The root OpenTelemetry span for this operation */
|
|
2174
2211
|
otelSpan?: Span;
|
|
2212
|
+
/** Execution-scoped logger with full context (userId, conversationId, executionId) */
|
|
2213
|
+
logger: Logger;
|
|
2175
2214
|
/** Map to store active OpenTelemetry spans for tool calls within this operation */
|
|
2176
2215
|
toolSpans?: Map<string, Span>;
|
|
2177
2216
|
/** Conversation steps for building full message history including tool calls/results */
|
|
@@ -2564,6 +2603,7 @@ type ToolExecuteOptions = {
|
|
|
2564
2603
|
/**
|
|
2565
2604
|
* The operation context associated with the agent invocation triggering this tool execution.
|
|
2566
2605
|
* Provides access to operation-specific state like userContext.
|
|
2606
|
+
* The context includes a logger with full execution context (userId, conversationId, executionId).
|
|
2567
2607
|
*/
|
|
2568
2608
|
operationContext?: OperationContext;
|
|
2569
2609
|
/**
|
|
@@ -3026,6 +3066,7 @@ declare class InMemoryStorage implements Memory {
|
|
|
3026
3066
|
private workflowTimelineEvents;
|
|
3027
3067
|
private workflowHistoryIndex;
|
|
3028
3068
|
private options;
|
|
3069
|
+
private logger;
|
|
3029
3070
|
/**
|
|
3030
3071
|
* Create a new in-memory storage
|
|
3031
3072
|
* @param options Configuration options
|
|
@@ -3312,6 +3353,7 @@ declare class InMemoryStorage implements Memory {
|
|
|
3312
3353
|
declare class LibSQLWorkflowExtension {
|
|
3313
3354
|
private client;
|
|
3314
3355
|
private _tablePrefix;
|
|
3356
|
+
private logger;
|
|
3315
3357
|
constructor(client: Client, _tablePrefix?: string);
|
|
3316
3358
|
/**
|
|
3317
3359
|
* Store a workflow history entry
|
|
@@ -3449,6 +3491,7 @@ declare class LibSQLStorage implements Memory {
|
|
|
3449
3491
|
private options;
|
|
3450
3492
|
private initialized;
|
|
3451
3493
|
private workflowExtension;
|
|
3494
|
+
private logger;
|
|
3452
3495
|
/**
|
|
3453
3496
|
* Create a new LibSQL storage
|
|
3454
3497
|
* @param options Configuration options
|
|
@@ -3814,6 +3857,10 @@ declare class MemoryManager {
|
|
|
3814
3857
|
* The ID of the resource (agent) that owns this memory manager
|
|
3815
3858
|
*/
|
|
3816
3859
|
private resourceId;
|
|
3860
|
+
/**
|
|
3861
|
+
* Logger instance
|
|
3862
|
+
*/
|
|
3863
|
+
private logger;
|
|
3817
3864
|
/**
|
|
3818
3865
|
* Background queue for memory operations
|
|
3819
3866
|
*/
|
|
@@ -3821,7 +3868,7 @@ declare class MemoryManager {
|
|
|
3821
3868
|
/**
|
|
3822
3869
|
* Creates a new MemoryManager
|
|
3823
3870
|
*/
|
|
3824
|
-
constructor(resourceId: string, memory?: Memory | false, options?: MemoryOptions, historyMemory?: Memory);
|
|
3871
|
+
constructor(resourceId: string, memory?: Memory | false, options?: MemoryOptions, historyMemory?: Memory, logger?: Logger);
|
|
3825
3872
|
/**
|
|
3826
3873
|
* Create and publish a timeline event for memory operations using the queue
|
|
3827
3874
|
*
|
|
@@ -3928,6 +3975,38 @@ declare class MemoryManager {
|
|
|
3928
3975
|
addTimelineEvent(agentId: string, historyId: string, eventId: string, event: NewTimelineEvent): Promise<any | undefined>;
|
|
3929
3976
|
}
|
|
3930
3977
|
|
|
3978
|
+
declare enum ActionType {
|
|
3979
|
+
START = "start",
|
|
3980
|
+
COMPLETE = "complete",
|
|
3981
|
+
ERROR = "error",
|
|
3982
|
+
GENERATION_START = "generationStart",
|
|
3983
|
+
GENERATION_COMPLETE = "generationComplete",
|
|
3984
|
+
STREAM_START = "streamStart",
|
|
3985
|
+
STREAM_COMPLETE = "streamComplete",
|
|
3986
|
+
STREAM_STEP = "streamStep",
|
|
3987
|
+
STREAMING = "streaming",
|
|
3988
|
+
OBJECT_GENERATION_START = "objectGenerationStart",
|
|
3989
|
+
OBJECT_GENERATION_COMPLETE = "objectGenerationComplete",
|
|
3990
|
+
STREAM_OBJECT_START = "streamObjectStart",
|
|
3991
|
+
STREAM_OBJECT_COMPLETE = "streamObjectComplete",
|
|
3992
|
+
TOOL_CALL = "toolCall",
|
|
3993
|
+
TOOL_ERROR = "toolError",
|
|
3994
|
+
DELEGATE = "delegate",
|
|
3995
|
+
EXECUTE = "execute",
|
|
3996
|
+
VALIDATE = "validate",
|
|
3997
|
+
STEP_START = "stepStart",
|
|
3998
|
+
STEP_COMPLETE = "stepComplete",
|
|
3999
|
+
SUSPEND = "suspend",
|
|
4000
|
+
RESUME = "resume",
|
|
4001
|
+
ACCESS = "access",
|
|
4002
|
+
STORE = "store",
|
|
4003
|
+
RETRIEVE = "retrieve"
|
|
4004
|
+
}
|
|
4005
|
+
/**
|
|
4006
|
+
* Helper to format retriever log messages
|
|
4007
|
+
*/
|
|
4008
|
+
declare function buildRetrieverLogMessage(retrieverName: string, action: ActionType | string, description: string): string;
|
|
4009
|
+
|
|
3931
4010
|
/**
|
|
3932
4011
|
* Options for configuring the Retriever
|
|
3933
4012
|
*/
|
|
@@ -3944,6 +4023,11 @@ type RetrieverOptions = {
|
|
|
3944
4023
|
* @default "Searches for relevant information in the knowledge base based on the query."
|
|
3945
4024
|
*/
|
|
3946
4025
|
toolDescription?: string;
|
|
4026
|
+
/**
|
|
4027
|
+
* Optional logger instance for the retriever
|
|
4028
|
+
* If not provided, a default logger will be created
|
|
4029
|
+
*/
|
|
4030
|
+
logger?: Logger;
|
|
3947
4031
|
/**
|
|
3948
4032
|
* Additional configuration specific to concrete retriever implementations
|
|
3949
4033
|
*/
|
|
@@ -3958,6 +4042,12 @@ interface RetrieveOptions {
|
|
|
3958
4042
|
* Can be used to store metadata, results, or any custom data
|
|
3959
4043
|
*/
|
|
3960
4044
|
userContext?: Map<string | symbol, unknown>;
|
|
4045
|
+
/**
|
|
4046
|
+
* Optional logger instance for this retrieval operation.
|
|
4047
|
+
* Provides execution-scoped logging with full context.
|
|
4048
|
+
* Available when retriever is called from an agent or workflow context.
|
|
4049
|
+
*/
|
|
4050
|
+
logger?: Logger;
|
|
3961
4051
|
}
|
|
3962
4052
|
/**
|
|
3963
4053
|
* Retriever interface for retrieving relevant information
|
|
@@ -3991,6 +4081,10 @@ declare abstract class BaseRetriever {
|
|
|
3991
4081
|
* Options that configure the retriever's behavior
|
|
3992
4082
|
*/
|
|
3993
4083
|
protected options: RetrieverOptions;
|
|
4084
|
+
/**
|
|
4085
|
+
* Logger instance for the retriever
|
|
4086
|
+
*/
|
|
4087
|
+
protected logger: Logger;
|
|
3994
4088
|
/**
|
|
3995
4089
|
* Ready-to-use tool property for direct destructuring
|
|
3996
4090
|
* This can be used with object destructuring syntax
|
|
@@ -4144,6 +4238,7 @@ declare class VoltOpsClient implements VoltOpsClient$1 {
|
|
|
4144
4238
|
};
|
|
4145
4239
|
readonly observability?: VoltAgentExporter;
|
|
4146
4240
|
readonly prompts?: VoltOpsPromptManager;
|
|
4241
|
+
private readonly logger;
|
|
4147
4242
|
constructor(options: VoltOpsClientOptions);
|
|
4148
4243
|
/**
|
|
4149
4244
|
* Create a prompt helper for agent instructions
|
|
@@ -4390,6 +4485,10 @@ declare class Agent<TProvider extends {
|
|
|
4390
4485
|
* Can be overridden during execution
|
|
4391
4486
|
*/
|
|
4392
4487
|
private readonly defaultUserContext?;
|
|
4488
|
+
/**
|
|
4489
|
+
* Logger instance for this agent
|
|
4490
|
+
*/
|
|
4491
|
+
readonly logger: Logger;
|
|
4393
4492
|
/**
|
|
4394
4493
|
* Create a new agent
|
|
4395
4494
|
*/
|
|
@@ -4415,6 +4514,10 @@ declare class Agent<TProvider extends {
|
|
|
4415
4514
|
* Resolve dynamic tools based on user context
|
|
4416
4515
|
*/
|
|
4417
4516
|
private resolveTools;
|
|
4517
|
+
/**
|
|
4518
|
+
* Generate a human-readable description for a stream step
|
|
4519
|
+
*/
|
|
4520
|
+
private getStepDescription;
|
|
4418
4521
|
/**
|
|
4419
4522
|
* Get the system message for the agent
|
|
4420
4523
|
*/
|
|
@@ -4441,6 +4544,14 @@ declare class Agent<TProvider extends {
|
|
|
4441
4544
|
* Prepare common options for text generation
|
|
4442
4545
|
*/
|
|
4443
4546
|
private prepareTextOptions;
|
|
4547
|
+
/**
|
|
4548
|
+
* Get logger with parent context if available
|
|
4549
|
+
*/
|
|
4550
|
+
protected getContextualLogger(parentAgentId?: string, parentHistoryEntryId?: string): Logger;
|
|
4551
|
+
/**
|
|
4552
|
+
* Calculate delegation depth by traversing parent chain
|
|
4553
|
+
*/
|
|
4554
|
+
private calculateDelegationDepth;
|
|
4444
4555
|
/**
|
|
4445
4556
|
* Initialize a new history entry
|
|
4446
4557
|
* @param input User input
|
|
@@ -5278,6 +5389,7 @@ declare function createWorkflowChain<INPUT_SCHEMA extends InternalBaseWorkflowIn
|
|
|
5278
5389
|
declare class WorkflowMemoryManager {
|
|
5279
5390
|
private storage;
|
|
5280
5391
|
private _exporter?;
|
|
5392
|
+
private logger;
|
|
5281
5393
|
constructor(storage: Memory, _exporter?: VoltAgentExporter);
|
|
5282
5394
|
/**
|
|
5283
5395
|
* Set the VoltAgent exporter for telemetry
|
|
@@ -5371,6 +5483,7 @@ type WorkflowEvent = WorkflowStartEvent | WorkflowSuccessEvent | WorkflowErrorEv
|
|
|
5371
5483
|
declare class WorkflowEventEmitter extends EventEmitter {
|
|
5372
5484
|
private static instance;
|
|
5373
5485
|
private workflowEventQueue;
|
|
5486
|
+
private logger;
|
|
5374
5487
|
private constructor();
|
|
5375
5488
|
/**
|
|
5376
5489
|
* Get the singleton instance of WorkflowEventEmitter
|
|
@@ -5402,7 +5515,8 @@ declare class WorkflowHistoryManager {
|
|
|
5402
5515
|
private readonly workflowId;
|
|
5403
5516
|
private memoryManager?;
|
|
5404
5517
|
private exporter?;
|
|
5405
|
-
|
|
5518
|
+
private logger;
|
|
5519
|
+
constructor(workflowId: string, memoryManager?: WorkflowMemoryManager, exporter?: VoltAgentExporter, logger?: Logger);
|
|
5406
5520
|
/**
|
|
5407
5521
|
* Set memory manager for persistence
|
|
5408
5522
|
*/
|
|
@@ -5478,6 +5592,7 @@ interface RegisteredWorkflow {
|
|
|
5478
5592
|
declare class WorkflowRegistry extends EventEmitter {
|
|
5479
5593
|
private static instance;
|
|
5480
5594
|
private workflows;
|
|
5595
|
+
private logger;
|
|
5481
5596
|
private workflowHistoryManagers;
|
|
5482
5597
|
activeExecutions: Map<string, WorkflowSuspendController>;
|
|
5483
5598
|
private constructor();
|
|
@@ -5503,6 +5618,7 @@ declare class WorkflowRegistry extends EventEmitter {
|
|
|
5503
5618
|
conversationId?: string;
|
|
5504
5619
|
userContext?: Map<string | symbol, unknown>;
|
|
5505
5620
|
metadata?: Record<string, unknown>;
|
|
5621
|
+
executionId?: string;
|
|
5506
5622
|
}): Promise<WorkflowHistoryEntry | null>;
|
|
5507
5623
|
/**
|
|
5508
5624
|
* Update a workflow execution and emit historyUpdate event
|
|
@@ -5647,10 +5763,10 @@ declare const ReasoningStepSchema: z.ZodObject<{
|
|
|
5647
5763
|
historyEntryId: z.ZodString;
|
|
5648
5764
|
agentId: z.ZodString;
|
|
5649
5765
|
}, "strip", z.ZodTypeAny, {
|
|
5766
|
+
agentId: string;
|
|
5650
5767
|
type: "thought" | "analysis";
|
|
5651
5768
|
title: string;
|
|
5652
5769
|
id: string;
|
|
5653
|
-
agentId: string;
|
|
5654
5770
|
reasoning: string;
|
|
5655
5771
|
timestamp: string;
|
|
5656
5772
|
historyEntryId: string;
|
|
@@ -5659,10 +5775,10 @@ declare const ReasoningStepSchema: z.ZodObject<{
|
|
|
5659
5775
|
action?: string | undefined;
|
|
5660
5776
|
next_action?: NextAction | undefined;
|
|
5661
5777
|
}, {
|
|
5778
|
+
agentId: string;
|
|
5662
5779
|
type: "thought" | "analysis";
|
|
5663
5780
|
title: string;
|
|
5664
5781
|
id: string;
|
|
5665
|
-
agentId: string;
|
|
5666
5782
|
reasoning: string;
|
|
5667
5783
|
timestamp: string;
|
|
5668
5784
|
historyEntryId: string;
|
|
@@ -5828,6 +5944,7 @@ declare class VoltOpsPromptManagerImpl implements VoltOpsPromptManager {
|
|
|
5828
5944
|
private readonly apiClient;
|
|
5829
5945
|
private readonly templateEngine;
|
|
5830
5946
|
private readonly cacheConfig;
|
|
5947
|
+
private readonly logger;
|
|
5831
5948
|
constructor(options: VoltOpsClientOptions);
|
|
5832
5949
|
/**
|
|
5833
5950
|
* Get prompt content by reference with caching and template processing
|
|
@@ -5894,6 +6011,7 @@ declare class VoltOpsPromptApiClient implements PromptApiClient {
|
|
|
5894
6011
|
private readonly publicKey;
|
|
5895
6012
|
private readonly secretKey;
|
|
5896
6013
|
private readonly fetchFn;
|
|
6014
|
+
private readonly logger;
|
|
5897
6015
|
constructor(options: VoltOpsClientOptions);
|
|
5898
6016
|
/**
|
|
5899
6017
|
* Fetch prompt content from VoltOps API
|
|
@@ -5976,6 +6094,11 @@ type VoltAgentOptions = {
|
|
|
5976
6094
|
* Replaces the old telemetryExporter approach with a comprehensive solution.
|
|
5977
6095
|
*/
|
|
5978
6096
|
voltOpsClient?: VoltOpsClient;
|
|
6097
|
+
/**
|
|
6098
|
+
* Global logger instance to use across all agents and workflows
|
|
6099
|
+
* If not provided, a default logger will be created
|
|
6100
|
+
*/
|
|
6101
|
+
logger?: Logger;
|
|
5979
6102
|
/**
|
|
5980
6103
|
* @deprecated Use `voltOpsClient` instead. Will be removed in a future version.
|
|
5981
6104
|
* Optional OpenTelemetry SpanExporter instance or array of instances.
|
|
@@ -6477,6 +6600,10 @@ declare class MCPClient extends EventEmitter {
|
|
|
6477
6600
|
* Maximum time allowed for requests in milliseconds.
|
|
6478
6601
|
*/
|
|
6479
6602
|
private readonly timeout;
|
|
6603
|
+
/**
|
|
6604
|
+
* Logger instance
|
|
6605
|
+
*/
|
|
6606
|
+
private logger;
|
|
6480
6607
|
/**
|
|
6481
6608
|
* Information identifying this client to the server.
|
|
6482
6609
|
*/
|
|
@@ -6493,6 +6620,10 @@ declare class MCPClient extends EventEmitter {
|
|
|
6493
6620
|
* Client capabilities for re-initialization.
|
|
6494
6621
|
*/
|
|
6495
6622
|
private readonly capabilities;
|
|
6623
|
+
/**
|
|
6624
|
+
* Get server info for logging
|
|
6625
|
+
*/
|
|
6626
|
+
private getServerInfo;
|
|
6496
6627
|
/**
|
|
6497
6628
|
* Creates a new MCP client instance.
|
|
6498
6629
|
* @param config Configuration for the client, including server details and client identity.
|
|
@@ -6659,6 +6790,7 @@ declare class AgentRegistry {
|
|
|
6659
6790
|
private isInitialized;
|
|
6660
6791
|
private globalVoltAgentExporter?;
|
|
6661
6792
|
private globalVoltOpsClient?;
|
|
6793
|
+
private globalLogger?;
|
|
6662
6794
|
/**
|
|
6663
6795
|
* Track parent-child relationships between agents (child -> parents)
|
|
6664
6796
|
*/
|
|
@@ -6737,6 +6869,14 @@ declare class AgentRegistry {
|
|
|
6737
6869
|
* Get the global VoltOpsClient instance.
|
|
6738
6870
|
*/
|
|
6739
6871
|
getGlobalVoltOpsClient(): VoltOpsClient$1 | undefined;
|
|
6872
|
+
/**
|
|
6873
|
+
* Set the global Logger instance.
|
|
6874
|
+
*/
|
|
6875
|
+
setGlobalLogger(logger: Logger): void;
|
|
6876
|
+
/**
|
|
6877
|
+
* Get the global Logger instance.
|
|
6878
|
+
*/
|
|
6879
|
+
getGlobalLogger(): Logger | undefined;
|
|
6740
6880
|
}
|
|
6741
6881
|
|
|
6742
6882
|
/**
|
|
@@ -6762,6 +6902,7 @@ declare class VoltAgent {
|
|
|
6762
6902
|
private customEndpoints;
|
|
6763
6903
|
private serverConfig;
|
|
6764
6904
|
private serverOptions;
|
|
6905
|
+
private logger;
|
|
6765
6906
|
constructor(options: VoltAgentOptions);
|
|
6766
6907
|
/**
|
|
6767
6908
|
* Setup graceful shutdown handlers
|
|
@@ -6835,4 +6976,4 @@ declare class VoltAgent {
|
|
|
6835
6976
|
shutdownTelemetry(): Promise<void>;
|
|
6836
6977
|
}
|
|
6837
6978
|
|
|
6838
|
-
export { Agent, AgentErrorEvent, AgentEventEmitter, AgentHistoryEntry, AgentHookOnEnd, AgentHookOnHandoff, AgentHookOnStart, AgentHookOnToolEnd, AgentHookOnToolStart, AgentHooks, AgentOptions, AgentRegistry, AgentResponse, AgentStartEvent, AgentStartEventMetadata, AgentSuccessEvent, AgentSuccessEventMetadata, AgentTimelineEvent, AgentTool, AllowedVariableValue, AnyToolConfig, 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, WorkflowErrorEvent, WorkflowEvent, WorkflowEventEmitter, WorkflowEventMetadata, WorkflowExecutionContext, WorkflowHistoryEntry, WorkflowRegistry, WorkflowStartEvent, WorkflowStepContext, WorkflowStepErrorEvent, WorkflowStepEventMetadata, WorkflowStepHistoryEntry, WorkflowStepStartEvent, WorkflowStepSuccessEvent, WorkflowStepSuspendEvent, WorkflowStepType, WorkflowSuccessEvent, WorkflowSuspendEvent, WorkflowTimelineEvent, andAgent, andAll, andRace, andTap, andThen, andWhen, checkForUpdates, createHooks, createNodeId, createPrompt, createReasoningTools, createRetrieverTool, createSimpleTemplateEngine, createStreamEventForwarder, createSubagent, createSuspendController, createTool, createToolkit, createVoltOpsClient, createWorkflow, createWorkflowChain, createWorkflowStepNodeId, VoltAgent as default, extractWorkflowStepInfo, getNodeTypeFromNodeId, getWorkflowStepNodeType, registerCustomEndpoint, registerCustomEndpoints, safeJsonParse, serializeValueForDebug, streamEventForwarder, tool, updateAllPackages, updateSinglePackage, zodSchemaToJsonUI };
|
|
6979
|
+
export { Agent, AgentErrorEvent, AgentEventEmitter, AgentHistoryEntry, AgentHookOnEnd, AgentHookOnHandoff, AgentHookOnStart, AgentHookOnToolEnd, AgentHookOnToolStart, AgentHooks, AgentOptions, AgentRegistry, AgentResponse, AgentStartEvent, AgentStartEventMetadata, AgentSuccessEvent, AgentSuccessEventMetadata, AgentTimelineEvent, AgentTool, AllowedVariableValue, AnyToolConfig, 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, WorkflowErrorEvent, WorkflowEvent, WorkflowEventEmitter, WorkflowEventMetadata, WorkflowExecutionContext, WorkflowHistoryEntry, WorkflowRegistry, WorkflowStartEvent, WorkflowStepContext, WorkflowStepErrorEvent, WorkflowStepEventMetadata, WorkflowStepHistoryEntry, WorkflowStepStartEvent, WorkflowStepSuccessEvent, WorkflowStepSuspendEvent, WorkflowStepType, WorkflowSuccessEvent, WorkflowSuspendEvent, WorkflowTimelineEvent, andAgent, andAll, andRace, andTap, andThen, andWhen, buildRetrieverLogMessage, checkForUpdates, createHooks, createNodeId, createPrompt, createReasoningTools, createRetrieverTool, createSimpleTemplateEngine, createStreamEventForwarder, createSubagent, createSuspendController, createTool, createToolkit, createVoltOpsClient, createWorkflow, createWorkflowChain, createWorkflowStepNodeId, VoltAgent as default, extractWorkflowStepInfo, getNodeTypeFromNodeId, getWorkflowStepNodeType, registerCustomEndpoint, registerCustomEndpoints, safeJsonParse, serializeValueForDebug, streamEventForwarder, tool, updateAllPackages, updateSinglePackage, zodSchemaToJsonUI };
|