@voltagent/core 1.1.21 → 1.1.22
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 +76 -5
- package/dist/index.d.ts +76 -5
- package/dist/index.js +58 -1
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +58 -1
- package/dist/index.mjs.map +1 -1
- package/package.json +1 -1
package/dist/index.d.mts
CHANGED
|
@@ -754,6 +754,32 @@ interface MemoryConfig {
|
|
|
754
754
|
*/
|
|
755
755
|
workingMemory?: WorkingMemoryConfig;
|
|
756
756
|
}
|
|
757
|
+
/**
|
|
758
|
+
* Metadata about the underlying storage adapter
|
|
759
|
+
*/
|
|
760
|
+
interface MemoryStorageMetadata {
|
|
761
|
+
/** Name of the configured storage adapter */
|
|
762
|
+
adapter: string;
|
|
763
|
+
}
|
|
764
|
+
/**
|
|
765
|
+
* Summary of working memory configuration exposed to the UI
|
|
766
|
+
*/
|
|
767
|
+
interface WorkingMemorySummary {
|
|
768
|
+
/** Whether working memory support is enabled */
|
|
769
|
+
enabled: boolean;
|
|
770
|
+
/** Scope of working memory persistence */
|
|
771
|
+
scope?: WorkingMemoryScope;
|
|
772
|
+
/** Output format (markdown/json) */
|
|
773
|
+
format: "markdown" | "json" | null;
|
|
774
|
+
/** Indicates if a template is configured */
|
|
775
|
+
hasTemplate: boolean;
|
|
776
|
+
/** Indicates if a schema is configured */
|
|
777
|
+
hasSchema: boolean;
|
|
778
|
+
/** Template content if configured */
|
|
779
|
+
template?: string | null;
|
|
780
|
+
/** Simplified schema field map if configured */
|
|
781
|
+
schema?: Record<string, string> | null;
|
|
782
|
+
}
|
|
757
783
|
/**
|
|
758
784
|
* Document type for RAG operations
|
|
759
785
|
*/
|
|
@@ -1249,6 +1275,14 @@ declare class Memory {
|
|
|
1249
1275
|
* Get embedding adapter if configured
|
|
1250
1276
|
*/
|
|
1251
1277
|
getEmbeddingAdapter(): EmbeddingAdapter$1 | undefined;
|
|
1278
|
+
/**
|
|
1279
|
+
* Get metadata about the configured storage adapter
|
|
1280
|
+
*/
|
|
1281
|
+
getStorageMetadata(): MemoryStorageMetadata;
|
|
1282
|
+
/**
|
|
1283
|
+
* Get a UI-friendly summary of working memory configuration
|
|
1284
|
+
*/
|
|
1285
|
+
getWorkingMemorySummary(): WorkingMemorySummary | null;
|
|
1252
1286
|
/**
|
|
1253
1287
|
* Get workflow state by execution ID
|
|
1254
1288
|
*/
|
|
@@ -2211,6 +2245,12 @@ interface ObservabilityStorageAdapter {
|
|
|
2211
2245
|
deleteOldSpans(beforeTimestamp: number): Promise<number>;
|
|
2212
2246
|
deleteOldLogs(beforeTimestamp: number): Promise<number>;
|
|
2213
2247
|
clear(): Promise<void>;
|
|
2248
|
+
getInfo?(): {
|
|
2249
|
+
adapter: string;
|
|
2250
|
+
displayName?: string;
|
|
2251
|
+
persistent?: boolean;
|
|
2252
|
+
description?: string;
|
|
2253
|
+
};
|
|
2214
2254
|
}
|
|
2215
2255
|
/**
|
|
2216
2256
|
* Log filter for querying
|
|
@@ -2653,6 +2693,12 @@ declare class InMemoryStorageAdapter$1 implements ObservabilityStorageAdapter {
|
|
|
2653
2693
|
oldestLog?: Date;
|
|
2654
2694
|
newestLog?: Date;
|
|
2655
2695
|
};
|
|
2696
|
+
getInfo(): {
|
|
2697
|
+
adapter: string;
|
|
2698
|
+
displayName: string;
|
|
2699
|
+
persistent: boolean;
|
|
2700
|
+
description: string;
|
|
2701
|
+
};
|
|
2656
2702
|
}
|
|
2657
2703
|
|
|
2658
2704
|
/**
|
|
@@ -3000,7 +3046,7 @@ interface SubAgentStateData {
|
|
|
3000
3046
|
status: string;
|
|
3001
3047
|
model: string;
|
|
3002
3048
|
tools: ApiToolInfo[];
|
|
3003
|
-
memory?:
|
|
3049
|
+
memory?: AgentMemoryState;
|
|
3004
3050
|
node_id: string;
|
|
3005
3051
|
subAgents?: SubAgentStateData[];
|
|
3006
3052
|
methodConfig?: {
|
|
@@ -3010,6 +3056,33 @@ interface SubAgentStateData {
|
|
|
3010
3056
|
};
|
|
3011
3057
|
[key: string]: unknown;
|
|
3012
3058
|
}
|
|
3059
|
+
/**
|
|
3060
|
+
* Memory block representation shared across agent and sub-agent state
|
|
3061
|
+
*/
|
|
3062
|
+
interface AgentMemoryState extends Record<string, unknown> {
|
|
3063
|
+
node_id: string;
|
|
3064
|
+
type?: string;
|
|
3065
|
+
resourceId?: string;
|
|
3066
|
+
options?: MemoryOptions;
|
|
3067
|
+
available?: boolean;
|
|
3068
|
+
status?: string;
|
|
3069
|
+
storage?: MemoryStorageMetadata;
|
|
3070
|
+
workingMemory?: WorkingMemorySummary | null;
|
|
3071
|
+
vectorDB?: {
|
|
3072
|
+
enabled: boolean;
|
|
3073
|
+
adapter?: string;
|
|
3074
|
+
dimension?: number;
|
|
3075
|
+
status?: string;
|
|
3076
|
+
node_id?: string;
|
|
3077
|
+
} | null;
|
|
3078
|
+
embeddingModel?: {
|
|
3079
|
+
enabled: boolean;
|
|
3080
|
+
model?: string;
|
|
3081
|
+
dimension?: number;
|
|
3082
|
+
status?: string;
|
|
3083
|
+
node_id?: string;
|
|
3084
|
+
} | null;
|
|
3085
|
+
}
|
|
3013
3086
|
/**
|
|
3014
3087
|
* Full state of an agent including all properties
|
|
3015
3088
|
*/
|
|
@@ -3022,9 +3095,7 @@ interface AgentFullState {
|
|
|
3022
3095
|
node_id: string;
|
|
3023
3096
|
tools: ToolWithNodeId[];
|
|
3024
3097
|
subAgents: SubAgentStateData[];
|
|
3025
|
-
memory:
|
|
3026
|
-
node_id: string;
|
|
3027
|
-
};
|
|
3098
|
+
memory: AgentMemoryState;
|
|
3028
3099
|
retriever?: {
|
|
3029
3100
|
name: string;
|
|
3030
3101
|
description?: string;
|
|
@@ -7355,4 +7426,4 @@ declare class VoltAgent {
|
|
|
7355
7426
|
*/
|
|
7356
7427
|
declare function convertUsage(usage: LanguageModelUsage | undefined): UsageInfo | undefined;
|
|
7357
7428
|
|
|
7358
|
-
export { A2AServerRegistry, AbortError, Agent, type AgentFullState, type AgentHookOnEnd, type AgentHookOnError, type AgentHookOnHandoff, type AgentHookOnPrepareMessages, type AgentHookOnPrepareModelMessages, type AgentHookOnStart, type AgentHookOnStepFinish, type AgentHookOnToolEnd, type AgentHookOnToolStart, type AgentHooks, type AgentOptions, AgentRegistry, type AgentResponse, type AgentStatus, type AgentTool, AiSdkEmbeddingAdapter, type AllowedVariableValue, type ApiToolInfo, type BaseEventMetadata, type BaseGenerationOptions, type BaseLLMOptions, type BaseMessage, BaseRetriever, type BaseTool, type BaseToolCall, type CachedPrompt, type ChatMessage, type CloudflareFetchHandler, type Conversation, ConversationAlreadyExistsError, ConversationNotFoundError, type ConversationQueryOptions, type ConversationQueryOptions as ConversationQueryOptionsV2, type Conversation as ConversationV2, type CreateConversationInput, type CreateConversationInput as CreateConversationInputV2, type CreateReasoningToolsOptions, DEFAULT_INSTRUCTIONS, type DataContent, type Document, type DynamicValue, type DynamicValueOptions, type EmbeddingAdapter$1 as EmbeddingAdapter, EmbeddingAdapterNotConfiguredError, EmbeddingError, type ExtractVariableNames, FEW_SHOT_EXAMPLES, type GenerateObjectOptions, type GenerateObjectSubAgentConfig, type GenerateTextOptions, type GenerateTextSubAgentConfig, type GetMessagesOptions, type IServerProvider, type IServerlessProvider, type VoltOpsClient$1 as IVoltOpsClient, InMemoryStorageAdapter$1 as InMemoryObservabilityAdapter, InMemoryStorageAdapter, InMemoryVectorAdapter, type InferGenerateObjectResponse, type InferGenerateTextResponse, type InferMessage, type InferModel, type InferProviderParams, type InferStreamResponse, type InferTool, type LLMProvider, LazyRemoteExportProcessor, LocalStorageSpanProcessor, type LogFilter, LoggerProxy, MCPConfiguration, type MCPElicitationAdapter, type MCPLoggingAdapter, type MCPPromptsAdapter, type MCPResourcesAdapter, MCPServerRegistry, Memory, type MemoryConfig, type MemoryOptions, type MemoryUpdateMode, Memory as MemoryV2, MemoryV2Error, type MessageContent, MessageContentBuilder, type MessageRole, type ModelToolCall, NextAction, NodeType, VoltAgentObservability$1 as NodeVoltAgentObservability, type ObservabilityConfig, type ObservabilityLogRecord, type ObservabilitySpan, type ObservabilityStorageAdapter, type ObservabilityWebSocketEvent, type OnEndHookArgs, type OnErrorHookArgs, type OnHandoffHookArgs, type OnPrepareMessagesHookArgs, type OnPrepareMessagesHookResult, type OnPrepareModelMessagesHookArgs, type OnPrepareModelMessagesHookResult, type OnStartHookArgs, type OnStepFinishHookArgs, type OnToolEndHookArgs, type OnToolStartHookArgs, type OperationContext, type PackageUpdateInfo, type PromptApiClient, type PromptApiResponse, type PromptContent, type PromptCreator, type PromptHelper, type PromptReference, type PromptTemplate, type ProviderObjectResponse, type ProviderObjectStreamResponse, type ProviderParams, type ProviderResponse, type ProviderTextResponse, type ProviderTextStreamResponse, type ReadableStreamType, type ReasoningStep, ReasoningStepSchema, type RegisterOptions, type RegisteredWorkflow, type RemoteLogExportConfig, RemoteLogProcessor, type RetrieveOptions, type Retriever, type RetrieverOptions, type SearchOptions, type SearchResult, type ServerAgentResponse, type ServerApiResponse, type ServerProviderDeps, type ServerProviderFactory, type ServerWorkflowResponse, type ServerlessProviderFactory, type ServerlessRemoteEndpointConfig, type ServerlessRemoteExportConfig, type ServerlessRequestHandler, ServerlessVoltAgentObservability, type SpanAttributes, type SpanEvent, type SpanFilterConfig, SpanFilterProcessor, SpanKind, type SpanLink, type SpanStatus, SpanStatusCode, type SpanTreeNode, type StepChunkCallback, type StepFinishCallback, type StepWithContent, type StopWhen, type StorageAdapter, StorageError, StorageLogProcessor, type StoredUIMessage, type StreamObjectFinishResult, type StreamObjectOnFinishCallback, type StreamObjectOptions, type StreamObjectSubAgentConfig, type StreamPart, type StreamTextFinishResult, type StreamTextOnFinishCallback, type StreamTextOptions, type StreamTextSubAgentConfig, type SubAgentConfig, type SubAgentMethod, type SubAgentStateData, type SupervisorConfig, type TemplateVariables, type TimelineEventCoreLevel, type TimelineEventCoreStatus, type TimelineEventCoreType, Tool, type ToolCall, type ToolErrorInfo, type ToolExecuteOptions, ToolManager, type ToolOptions, type ToolSchema, type ToolStatus, type ToolStatusInfo, type ToolWithNodeId, type Toolkit, type Usage, type UsageInfo, type VectorAdapter, VectorAdapterNotConfiguredError, VectorError, type VectorItem, type VectorSearchOptions, type Voice, type VoiceEventData, type VoiceEventType, type VoiceMetadata, type VoiceOptions, VoltAgent, VoltAgentError, VoltAgentObservability, type VoltAgentOptions, type VoltAgentStreamTextResult, type VoltAgentTextStreamPart, VoltOpsClient, type VoltOpsClientOptions, VoltOpsPromptApiClient, type VoltOpsPromptManager, VoltOpsPromptManagerImpl, WebSocketEventEmitter, WebSocketLogProcessor, WebSocketSpanProcessor, type Workflow, type WorkflowConfig, type WorkflowExecutionContext, WorkflowRegistry, type WorkflowStateEntry, type WorkflowStats, type WorkflowStepContext, type WorkflowStepType, type WorkflowTimelineEvent, type WorkingMemoryConfig, type WorkingMemoryScope, type WorkingMemoryUpdateOptions, addTimestampToMessage, andAgent, andAll, andRace, andTap, andThen, andWhen, andWorkflow, appendToMessage, buildRetrieverLogMessage, buildSpanTree, checkForUpdates, convertUsage, cosineSimilarity, createHooks, createNodeId, createPrompt, createReasoningTools, createRetrieverTool, createSimpleTemplateEngine, createSubagent, createSuspendController, createTool, createToolkit, createVoltAgentObservability, createVoltOpsClient, createWorkflow, createWorkflowChain, createWorkflowStepNodeId, VoltAgent as default, extractFileParts, extractImageParts, extractText, extractTextParts, extractWorkflowStepInfo, filterContentParts, getContentLength, getEnvVar, getGlobalLogBuffer, getGlobalLogger, getNodeTypeFromNodeId, getWorkflowStepNodeType, hasContent, hasFilePart, hasImagePart, hasTextPart, isAbortError, isNodeRuntime, isServerlessRuntime, isStructuredContent, isTextContent, isVoltAgentError, mapMessageContent, messageHelpers, normalizeContent, normalizeToArray, prependToMessage, readableLogRecordToObservabilityLog, readableSpanToObservabilitySpan, safeJsonParse, serializeValueForDebug, tool, transformTextContent, updateAllPackages, updateSinglePackage, zodSchemaToJsonUI };
|
|
7429
|
+
export { A2AServerRegistry, AbortError, Agent, type AgentFullState, type AgentHookOnEnd, type AgentHookOnError, type AgentHookOnHandoff, type AgentHookOnPrepareMessages, type AgentHookOnPrepareModelMessages, type AgentHookOnStart, type AgentHookOnStepFinish, type AgentHookOnToolEnd, type AgentHookOnToolStart, type AgentHooks, type AgentOptions, AgentRegistry, type AgentResponse, type AgentStatus, type AgentTool, AiSdkEmbeddingAdapter, type AllowedVariableValue, type ApiToolInfo, type BaseEventMetadata, type BaseGenerationOptions, type BaseLLMOptions, type BaseMessage, BaseRetriever, type BaseTool, type BaseToolCall, type CachedPrompt, type ChatMessage, type CloudflareFetchHandler, type Conversation, ConversationAlreadyExistsError, ConversationNotFoundError, type ConversationQueryOptions, type ConversationQueryOptions as ConversationQueryOptionsV2, type Conversation as ConversationV2, type CreateConversationInput, type CreateConversationInput as CreateConversationInputV2, type CreateReasoningToolsOptions, DEFAULT_INSTRUCTIONS, type DataContent, type Document, type DynamicValue, type DynamicValueOptions, type EmbeddingAdapter$1 as EmbeddingAdapter, EmbeddingAdapterNotConfiguredError, EmbeddingError, type ExtractVariableNames, FEW_SHOT_EXAMPLES, type GenerateObjectOptions, type GenerateObjectSubAgentConfig, type GenerateTextOptions, type GenerateTextSubAgentConfig, type GetMessagesOptions, type IServerProvider, type IServerlessProvider, type VoltOpsClient$1 as IVoltOpsClient, InMemoryStorageAdapter$1 as InMemoryObservabilityAdapter, InMemoryStorageAdapter, InMemoryVectorAdapter, type InferGenerateObjectResponse, type InferGenerateTextResponse, type InferMessage, type InferModel, type InferProviderParams, type InferStreamResponse, type InferTool, type LLMProvider, LazyRemoteExportProcessor, LocalStorageSpanProcessor, type LogFilter, LoggerProxy, MCPConfiguration, type MCPElicitationAdapter, type MCPLoggingAdapter, type MCPPromptsAdapter, type MCPResourcesAdapter, MCPServerRegistry, Memory, type MemoryConfig, type MemoryOptions, type MemoryStorageMetadata, type MemoryUpdateMode, Memory as MemoryV2, MemoryV2Error, type MessageContent, MessageContentBuilder, type MessageRole, type ModelToolCall, NextAction, NodeType, VoltAgentObservability$1 as NodeVoltAgentObservability, type ObservabilityConfig, type ObservabilityLogRecord, type ObservabilitySpan, type ObservabilityStorageAdapter, type ObservabilityWebSocketEvent, type OnEndHookArgs, type OnErrorHookArgs, type OnHandoffHookArgs, type OnPrepareMessagesHookArgs, type OnPrepareMessagesHookResult, type OnPrepareModelMessagesHookArgs, type OnPrepareModelMessagesHookResult, type OnStartHookArgs, type OnStepFinishHookArgs, type OnToolEndHookArgs, type OnToolStartHookArgs, type OperationContext, type PackageUpdateInfo, type PromptApiClient, type PromptApiResponse, type PromptContent, type PromptCreator, type PromptHelper, type PromptReference, type PromptTemplate, type ProviderObjectResponse, type ProviderObjectStreamResponse, type ProviderParams, type ProviderResponse, type ProviderTextResponse, type ProviderTextStreamResponse, type ReadableStreamType, type ReasoningStep, ReasoningStepSchema, type RegisterOptions, type RegisteredWorkflow, type RemoteLogExportConfig, RemoteLogProcessor, type RetrieveOptions, type Retriever, type RetrieverOptions, type SearchOptions, type SearchResult, type ServerAgentResponse, type ServerApiResponse, type ServerProviderDeps, type ServerProviderFactory, type ServerWorkflowResponse, type ServerlessProviderFactory, type ServerlessRemoteEndpointConfig, type ServerlessRemoteExportConfig, type ServerlessRequestHandler, ServerlessVoltAgentObservability, type SpanAttributes, type SpanEvent, type SpanFilterConfig, SpanFilterProcessor, SpanKind, type SpanLink, type SpanStatus, SpanStatusCode, type SpanTreeNode, type StepChunkCallback, type StepFinishCallback, type StepWithContent, type StopWhen, type StorageAdapter, StorageError, StorageLogProcessor, type StoredUIMessage, type StreamObjectFinishResult, type StreamObjectOnFinishCallback, type StreamObjectOptions, type StreamObjectSubAgentConfig, type StreamPart, type StreamTextFinishResult, type StreamTextOnFinishCallback, type StreamTextOptions, type StreamTextSubAgentConfig, type SubAgentConfig, type SubAgentMethod, type SubAgentStateData, type SupervisorConfig, type TemplateVariables, type TimelineEventCoreLevel, type TimelineEventCoreStatus, type TimelineEventCoreType, Tool, type ToolCall, type ToolErrorInfo, type ToolExecuteOptions, ToolManager, type ToolOptions, type ToolSchema, type ToolStatus, type ToolStatusInfo, type ToolWithNodeId, type Toolkit, type Usage, type UsageInfo, type VectorAdapter, VectorAdapterNotConfiguredError, VectorError, type VectorItem, type VectorSearchOptions, type Voice, type VoiceEventData, type VoiceEventType, type VoiceMetadata, type VoiceOptions, VoltAgent, VoltAgentError, VoltAgentObservability, type VoltAgentOptions, type VoltAgentStreamTextResult, type VoltAgentTextStreamPart, VoltOpsClient, type VoltOpsClientOptions, VoltOpsPromptApiClient, type VoltOpsPromptManager, VoltOpsPromptManagerImpl, WebSocketEventEmitter, WebSocketLogProcessor, WebSocketSpanProcessor, type Workflow, type WorkflowConfig, type WorkflowExecutionContext, WorkflowRegistry, type WorkflowStateEntry, type WorkflowStats, type WorkflowStepContext, type WorkflowStepType, type WorkflowTimelineEvent, type WorkingMemoryConfig, type WorkingMemoryScope, type WorkingMemorySummary, type WorkingMemoryUpdateOptions, addTimestampToMessage, andAgent, andAll, andRace, andTap, andThen, andWhen, andWorkflow, appendToMessage, buildRetrieverLogMessage, buildSpanTree, checkForUpdates, convertUsage, cosineSimilarity, createHooks, createNodeId, createPrompt, createReasoningTools, createRetrieverTool, createSimpleTemplateEngine, createSubagent, createSuspendController, createTool, createToolkit, createVoltAgentObservability, createVoltOpsClient, createWorkflow, createWorkflowChain, createWorkflowStepNodeId, VoltAgent as default, extractFileParts, extractImageParts, extractText, extractTextParts, extractWorkflowStepInfo, filterContentParts, getContentLength, getEnvVar, getGlobalLogBuffer, getGlobalLogger, getNodeTypeFromNodeId, getWorkflowStepNodeType, hasContent, hasFilePart, hasImagePart, hasTextPart, isAbortError, isNodeRuntime, isServerlessRuntime, isStructuredContent, isTextContent, isVoltAgentError, mapMessageContent, messageHelpers, normalizeContent, normalizeToArray, prependToMessage, readableLogRecordToObservabilityLog, readableSpanToObservabilitySpan, safeJsonParse, serializeValueForDebug, tool, transformTextContent, updateAllPackages, updateSinglePackage, zodSchemaToJsonUI };
|
package/dist/index.d.ts
CHANGED
|
@@ -754,6 +754,32 @@ interface MemoryConfig {
|
|
|
754
754
|
*/
|
|
755
755
|
workingMemory?: WorkingMemoryConfig;
|
|
756
756
|
}
|
|
757
|
+
/**
|
|
758
|
+
* Metadata about the underlying storage adapter
|
|
759
|
+
*/
|
|
760
|
+
interface MemoryStorageMetadata {
|
|
761
|
+
/** Name of the configured storage adapter */
|
|
762
|
+
adapter: string;
|
|
763
|
+
}
|
|
764
|
+
/**
|
|
765
|
+
* Summary of working memory configuration exposed to the UI
|
|
766
|
+
*/
|
|
767
|
+
interface WorkingMemorySummary {
|
|
768
|
+
/** Whether working memory support is enabled */
|
|
769
|
+
enabled: boolean;
|
|
770
|
+
/** Scope of working memory persistence */
|
|
771
|
+
scope?: WorkingMemoryScope;
|
|
772
|
+
/** Output format (markdown/json) */
|
|
773
|
+
format: "markdown" | "json" | null;
|
|
774
|
+
/** Indicates if a template is configured */
|
|
775
|
+
hasTemplate: boolean;
|
|
776
|
+
/** Indicates if a schema is configured */
|
|
777
|
+
hasSchema: boolean;
|
|
778
|
+
/** Template content if configured */
|
|
779
|
+
template?: string | null;
|
|
780
|
+
/** Simplified schema field map if configured */
|
|
781
|
+
schema?: Record<string, string> | null;
|
|
782
|
+
}
|
|
757
783
|
/**
|
|
758
784
|
* Document type for RAG operations
|
|
759
785
|
*/
|
|
@@ -1249,6 +1275,14 @@ declare class Memory {
|
|
|
1249
1275
|
* Get embedding adapter if configured
|
|
1250
1276
|
*/
|
|
1251
1277
|
getEmbeddingAdapter(): EmbeddingAdapter$1 | undefined;
|
|
1278
|
+
/**
|
|
1279
|
+
* Get metadata about the configured storage adapter
|
|
1280
|
+
*/
|
|
1281
|
+
getStorageMetadata(): MemoryStorageMetadata;
|
|
1282
|
+
/**
|
|
1283
|
+
* Get a UI-friendly summary of working memory configuration
|
|
1284
|
+
*/
|
|
1285
|
+
getWorkingMemorySummary(): WorkingMemorySummary | null;
|
|
1252
1286
|
/**
|
|
1253
1287
|
* Get workflow state by execution ID
|
|
1254
1288
|
*/
|
|
@@ -2211,6 +2245,12 @@ interface ObservabilityStorageAdapter {
|
|
|
2211
2245
|
deleteOldSpans(beforeTimestamp: number): Promise<number>;
|
|
2212
2246
|
deleteOldLogs(beforeTimestamp: number): Promise<number>;
|
|
2213
2247
|
clear(): Promise<void>;
|
|
2248
|
+
getInfo?(): {
|
|
2249
|
+
adapter: string;
|
|
2250
|
+
displayName?: string;
|
|
2251
|
+
persistent?: boolean;
|
|
2252
|
+
description?: string;
|
|
2253
|
+
};
|
|
2214
2254
|
}
|
|
2215
2255
|
/**
|
|
2216
2256
|
* Log filter for querying
|
|
@@ -2653,6 +2693,12 @@ declare class InMemoryStorageAdapter$1 implements ObservabilityStorageAdapter {
|
|
|
2653
2693
|
oldestLog?: Date;
|
|
2654
2694
|
newestLog?: Date;
|
|
2655
2695
|
};
|
|
2696
|
+
getInfo(): {
|
|
2697
|
+
adapter: string;
|
|
2698
|
+
displayName: string;
|
|
2699
|
+
persistent: boolean;
|
|
2700
|
+
description: string;
|
|
2701
|
+
};
|
|
2656
2702
|
}
|
|
2657
2703
|
|
|
2658
2704
|
/**
|
|
@@ -3000,7 +3046,7 @@ interface SubAgentStateData {
|
|
|
3000
3046
|
status: string;
|
|
3001
3047
|
model: string;
|
|
3002
3048
|
tools: ApiToolInfo[];
|
|
3003
|
-
memory?:
|
|
3049
|
+
memory?: AgentMemoryState;
|
|
3004
3050
|
node_id: string;
|
|
3005
3051
|
subAgents?: SubAgentStateData[];
|
|
3006
3052
|
methodConfig?: {
|
|
@@ -3010,6 +3056,33 @@ interface SubAgentStateData {
|
|
|
3010
3056
|
};
|
|
3011
3057
|
[key: string]: unknown;
|
|
3012
3058
|
}
|
|
3059
|
+
/**
|
|
3060
|
+
* Memory block representation shared across agent and sub-agent state
|
|
3061
|
+
*/
|
|
3062
|
+
interface AgentMemoryState extends Record<string, unknown> {
|
|
3063
|
+
node_id: string;
|
|
3064
|
+
type?: string;
|
|
3065
|
+
resourceId?: string;
|
|
3066
|
+
options?: MemoryOptions;
|
|
3067
|
+
available?: boolean;
|
|
3068
|
+
status?: string;
|
|
3069
|
+
storage?: MemoryStorageMetadata;
|
|
3070
|
+
workingMemory?: WorkingMemorySummary | null;
|
|
3071
|
+
vectorDB?: {
|
|
3072
|
+
enabled: boolean;
|
|
3073
|
+
adapter?: string;
|
|
3074
|
+
dimension?: number;
|
|
3075
|
+
status?: string;
|
|
3076
|
+
node_id?: string;
|
|
3077
|
+
} | null;
|
|
3078
|
+
embeddingModel?: {
|
|
3079
|
+
enabled: boolean;
|
|
3080
|
+
model?: string;
|
|
3081
|
+
dimension?: number;
|
|
3082
|
+
status?: string;
|
|
3083
|
+
node_id?: string;
|
|
3084
|
+
} | null;
|
|
3085
|
+
}
|
|
3013
3086
|
/**
|
|
3014
3087
|
* Full state of an agent including all properties
|
|
3015
3088
|
*/
|
|
@@ -3022,9 +3095,7 @@ interface AgentFullState {
|
|
|
3022
3095
|
node_id: string;
|
|
3023
3096
|
tools: ToolWithNodeId[];
|
|
3024
3097
|
subAgents: SubAgentStateData[];
|
|
3025
|
-
memory:
|
|
3026
|
-
node_id: string;
|
|
3027
|
-
};
|
|
3098
|
+
memory: AgentMemoryState;
|
|
3028
3099
|
retriever?: {
|
|
3029
3100
|
name: string;
|
|
3030
3101
|
description?: string;
|
|
@@ -7355,4 +7426,4 @@ declare class VoltAgent {
|
|
|
7355
7426
|
*/
|
|
7356
7427
|
declare function convertUsage(usage: LanguageModelUsage | undefined): UsageInfo | undefined;
|
|
7357
7428
|
|
|
7358
|
-
export { A2AServerRegistry, AbortError, Agent, type AgentFullState, type AgentHookOnEnd, type AgentHookOnError, type AgentHookOnHandoff, type AgentHookOnPrepareMessages, type AgentHookOnPrepareModelMessages, type AgentHookOnStart, type AgentHookOnStepFinish, type AgentHookOnToolEnd, type AgentHookOnToolStart, type AgentHooks, type AgentOptions, AgentRegistry, type AgentResponse, type AgentStatus, type AgentTool, AiSdkEmbeddingAdapter, type AllowedVariableValue, type ApiToolInfo, type BaseEventMetadata, type BaseGenerationOptions, type BaseLLMOptions, type BaseMessage, BaseRetriever, type BaseTool, type BaseToolCall, type CachedPrompt, type ChatMessage, type CloudflareFetchHandler, type Conversation, ConversationAlreadyExistsError, ConversationNotFoundError, type ConversationQueryOptions, type ConversationQueryOptions as ConversationQueryOptionsV2, type Conversation as ConversationV2, type CreateConversationInput, type CreateConversationInput as CreateConversationInputV2, type CreateReasoningToolsOptions, DEFAULT_INSTRUCTIONS, type DataContent, type Document, type DynamicValue, type DynamicValueOptions, type EmbeddingAdapter$1 as EmbeddingAdapter, EmbeddingAdapterNotConfiguredError, EmbeddingError, type ExtractVariableNames, FEW_SHOT_EXAMPLES, type GenerateObjectOptions, type GenerateObjectSubAgentConfig, type GenerateTextOptions, type GenerateTextSubAgentConfig, type GetMessagesOptions, type IServerProvider, type IServerlessProvider, type VoltOpsClient$1 as IVoltOpsClient, InMemoryStorageAdapter$1 as InMemoryObservabilityAdapter, InMemoryStorageAdapter, InMemoryVectorAdapter, type InferGenerateObjectResponse, type InferGenerateTextResponse, type InferMessage, type InferModel, type InferProviderParams, type InferStreamResponse, type InferTool, type LLMProvider, LazyRemoteExportProcessor, LocalStorageSpanProcessor, type LogFilter, LoggerProxy, MCPConfiguration, type MCPElicitationAdapter, type MCPLoggingAdapter, type MCPPromptsAdapter, type MCPResourcesAdapter, MCPServerRegistry, Memory, type MemoryConfig, type MemoryOptions, type MemoryUpdateMode, Memory as MemoryV2, MemoryV2Error, type MessageContent, MessageContentBuilder, type MessageRole, type ModelToolCall, NextAction, NodeType, VoltAgentObservability$1 as NodeVoltAgentObservability, type ObservabilityConfig, type ObservabilityLogRecord, type ObservabilitySpan, type ObservabilityStorageAdapter, type ObservabilityWebSocketEvent, type OnEndHookArgs, type OnErrorHookArgs, type OnHandoffHookArgs, type OnPrepareMessagesHookArgs, type OnPrepareMessagesHookResult, type OnPrepareModelMessagesHookArgs, type OnPrepareModelMessagesHookResult, type OnStartHookArgs, type OnStepFinishHookArgs, type OnToolEndHookArgs, type OnToolStartHookArgs, type OperationContext, type PackageUpdateInfo, type PromptApiClient, type PromptApiResponse, type PromptContent, type PromptCreator, type PromptHelper, type PromptReference, type PromptTemplate, type ProviderObjectResponse, type ProviderObjectStreamResponse, type ProviderParams, type ProviderResponse, type ProviderTextResponse, type ProviderTextStreamResponse, type ReadableStreamType, type ReasoningStep, ReasoningStepSchema, type RegisterOptions, type RegisteredWorkflow, type RemoteLogExportConfig, RemoteLogProcessor, type RetrieveOptions, type Retriever, type RetrieverOptions, type SearchOptions, type SearchResult, type ServerAgentResponse, type ServerApiResponse, type ServerProviderDeps, type ServerProviderFactory, type ServerWorkflowResponse, type ServerlessProviderFactory, type ServerlessRemoteEndpointConfig, type ServerlessRemoteExportConfig, type ServerlessRequestHandler, ServerlessVoltAgentObservability, type SpanAttributes, type SpanEvent, type SpanFilterConfig, SpanFilterProcessor, SpanKind, type SpanLink, type SpanStatus, SpanStatusCode, type SpanTreeNode, type StepChunkCallback, type StepFinishCallback, type StepWithContent, type StopWhen, type StorageAdapter, StorageError, StorageLogProcessor, type StoredUIMessage, type StreamObjectFinishResult, type StreamObjectOnFinishCallback, type StreamObjectOptions, type StreamObjectSubAgentConfig, type StreamPart, type StreamTextFinishResult, type StreamTextOnFinishCallback, type StreamTextOptions, type StreamTextSubAgentConfig, type SubAgentConfig, type SubAgentMethod, type SubAgentStateData, type SupervisorConfig, type TemplateVariables, type TimelineEventCoreLevel, type TimelineEventCoreStatus, type TimelineEventCoreType, Tool, type ToolCall, type ToolErrorInfo, type ToolExecuteOptions, ToolManager, type ToolOptions, type ToolSchema, type ToolStatus, type ToolStatusInfo, type ToolWithNodeId, type Toolkit, type Usage, type UsageInfo, type VectorAdapter, VectorAdapterNotConfiguredError, VectorError, type VectorItem, type VectorSearchOptions, type Voice, type VoiceEventData, type VoiceEventType, type VoiceMetadata, type VoiceOptions, VoltAgent, VoltAgentError, VoltAgentObservability, type VoltAgentOptions, type VoltAgentStreamTextResult, type VoltAgentTextStreamPart, VoltOpsClient, type VoltOpsClientOptions, VoltOpsPromptApiClient, type VoltOpsPromptManager, VoltOpsPromptManagerImpl, WebSocketEventEmitter, WebSocketLogProcessor, WebSocketSpanProcessor, type Workflow, type WorkflowConfig, type WorkflowExecutionContext, WorkflowRegistry, type WorkflowStateEntry, type WorkflowStats, type WorkflowStepContext, type WorkflowStepType, type WorkflowTimelineEvent, type WorkingMemoryConfig, type WorkingMemoryScope, type WorkingMemoryUpdateOptions, addTimestampToMessage, andAgent, andAll, andRace, andTap, andThen, andWhen, andWorkflow, appendToMessage, buildRetrieverLogMessage, buildSpanTree, checkForUpdates, convertUsage, cosineSimilarity, createHooks, createNodeId, createPrompt, createReasoningTools, createRetrieverTool, createSimpleTemplateEngine, createSubagent, createSuspendController, createTool, createToolkit, createVoltAgentObservability, createVoltOpsClient, createWorkflow, createWorkflowChain, createWorkflowStepNodeId, VoltAgent as default, extractFileParts, extractImageParts, extractText, extractTextParts, extractWorkflowStepInfo, filterContentParts, getContentLength, getEnvVar, getGlobalLogBuffer, getGlobalLogger, getNodeTypeFromNodeId, getWorkflowStepNodeType, hasContent, hasFilePart, hasImagePart, hasTextPart, isAbortError, isNodeRuntime, isServerlessRuntime, isStructuredContent, isTextContent, isVoltAgentError, mapMessageContent, messageHelpers, normalizeContent, normalizeToArray, prependToMessage, readableLogRecordToObservabilityLog, readableSpanToObservabilitySpan, safeJsonParse, serializeValueForDebug, tool, transformTextContent, updateAllPackages, updateSinglePackage, zodSchemaToJsonUI };
|
|
7429
|
+
export { A2AServerRegistry, AbortError, Agent, type AgentFullState, type AgentHookOnEnd, type AgentHookOnError, type AgentHookOnHandoff, type AgentHookOnPrepareMessages, type AgentHookOnPrepareModelMessages, type AgentHookOnStart, type AgentHookOnStepFinish, type AgentHookOnToolEnd, type AgentHookOnToolStart, type AgentHooks, type AgentOptions, AgentRegistry, type AgentResponse, type AgentStatus, type AgentTool, AiSdkEmbeddingAdapter, type AllowedVariableValue, type ApiToolInfo, type BaseEventMetadata, type BaseGenerationOptions, type BaseLLMOptions, type BaseMessage, BaseRetriever, type BaseTool, type BaseToolCall, type CachedPrompt, type ChatMessage, type CloudflareFetchHandler, type Conversation, ConversationAlreadyExistsError, ConversationNotFoundError, type ConversationQueryOptions, type ConversationQueryOptions as ConversationQueryOptionsV2, type Conversation as ConversationV2, type CreateConversationInput, type CreateConversationInput as CreateConversationInputV2, type CreateReasoningToolsOptions, DEFAULT_INSTRUCTIONS, type DataContent, type Document, type DynamicValue, type DynamicValueOptions, type EmbeddingAdapter$1 as EmbeddingAdapter, EmbeddingAdapterNotConfiguredError, EmbeddingError, type ExtractVariableNames, FEW_SHOT_EXAMPLES, type GenerateObjectOptions, type GenerateObjectSubAgentConfig, type GenerateTextOptions, type GenerateTextSubAgentConfig, type GetMessagesOptions, type IServerProvider, type IServerlessProvider, type VoltOpsClient$1 as IVoltOpsClient, InMemoryStorageAdapter$1 as InMemoryObservabilityAdapter, InMemoryStorageAdapter, InMemoryVectorAdapter, type InferGenerateObjectResponse, type InferGenerateTextResponse, type InferMessage, type InferModel, type InferProviderParams, type InferStreamResponse, type InferTool, type LLMProvider, LazyRemoteExportProcessor, LocalStorageSpanProcessor, type LogFilter, LoggerProxy, MCPConfiguration, type MCPElicitationAdapter, type MCPLoggingAdapter, type MCPPromptsAdapter, type MCPResourcesAdapter, MCPServerRegistry, Memory, type MemoryConfig, type MemoryOptions, type MemoryStorageMetadata, type MemoryUpdateMode, Memory as MemoryV2, MemoryV2Error, type MessageContent, MessageContentBuilder, type MessageRole, type ModelToolCall, NextAction, NodeType, VoltAgentObservability$1 as NodeVoltAgentObservability, type ObservabilityConfig, type ObservabilityLogRecord, type ObservabilitySpan, type ObservabilityStorageAdapter, type ObservabilityWebSocketEvent, type OnEndHookArgs, type OnErrorHookArgs, type OnHandoffHookArgs, type OnPrepareMessagesHookArgs, type OnPrepareMessagesHookResult, type OnPrepareModelMessagesHookArgs, type OnPrepareModelMessagesHookResult, type OnStartHookArgs, type OnStepFinishHookArgs, type OnToolEndHookArgs, type OnToolStartHookArgs, type OperationContext, type PackageUpdateInfo, type PromptApiClient, type PromptApiResponse, type PromptContent, type PromptCreator, type PromptHelper, type PromptReference, type PromptTemplate, type ProviderObjectResponse, type ProviderObjectStreamResponse, type ProviderParams, type ProviderResponse, type ProviderTextResponse, type ProviderTextStreamResponse, type ReadableStreamType, type ReasoningStep, ReasoningStepSchema, type RegisterOptions, type RegisteredWorkflow, type RemoteLogExportConfig, RemoteLogProcessor, type RetrieveOptions, type Retriever, type RetrieverOptions, type SearchOptions, type SearchResult, type ServerAgentResponse, type ServerApiResponse, type ServerProviderDeps, type ServerProviderFactory, type ServerWorkflowResponse, type ServerlessProviderFactory, type ServerlessRemoteEndpointConfig, type ServerlessRemoteExportConfig, type ServerlessRequestHandler, ServerlessVoltAgentObservability, type SpanAttributes, type SpanEvent, type SpanFilterConfig, SpanFilterProcessor, SpanKind, type SpanLink, type SpanStatus, SpanStatusCode, type SpanTreeNode, type StepChunkCallback, type StepFinishCallback, type StepWithContent, type StopWhen, type StorageAdapter, StorageError, StorageLogProcessor, type StoredUIMessage, type StreamObjectFinishResult, type StreamObjectOnFinishCallback, type StreamObjectOptions, type StreamObjectSubAgentConfig, type StreamPart, type StreamTextFinishResult, type StreamTextOnFinishCallback, type StreamTextOptions, type StreamTextSubAgentConfig, type SubAgentConfig, type SubAgentMethod, type SubAgentStateData, type SupervisorConfig, type TemplateVariables, type TimelineEventCoreLevel, type TimelineEventCoreStatus, type TimelineEventCoreType, Tool, type ToolCall, type ToolErrorInfo, type ToolExecuteOptions, ToolManager, type ToolOptions, type ToolSchema, type ToolStatus, type ToolStatusInfo, type ToolWithNodeId, type Toolkit, type Usage, type UsageInfo, type VectorAdapter, VectorAdapterNotConfiguredError, VectorError, type VectorItem, type VectorSearchOptions, type Voice, type VoiceEventData, type VoiceEventType, type VoiceMetadata, type VoiceOptions, VoltAgent, VoltAgentError, VoltAgentObservability, type VoltAgentOptions, type VoltAgentStreamTextResult, type VoltAgentTextStreamPart, VoltOpsClient, type VoltOpsClientOptions, VoltOpsPromptApiClient, type VoltOpsPromptManager, VoltOpsPromptManagerImpl, WebSocketEventEmitter, WebSocketLogProcessor, WebSocketSpanProcessor, type Workflow, type WorkflowConfig, type WorkflowExecutionContext, WorkflowRegistry, type WorkflowStateEntry, type WorkflowStats, type WorkflowStepContext, type WorkflowStepType, type WorkflowTimelineEvent, type WorkingMemoryConfig, type WorkingMemoryScope, type WorkingMemorySummary, type WorkingMemoryUpdateOptions, addTimestampToMessage, andAgent, andAll, andRace, andTap, andThen, andWhen, andWorkflow, appendToMessage, buildRetrieverLogMessage, buildSpanTree, checkForUpdates, convertUsage, cosineSimilarity, createHooks, createNodeId, createPrompt, createReasoningTools, createRetrieverTool, createSimpleTemplateEngine, createSubagent, createSuspendController, createTool, createToolkit, createVoltAgentObservability, createVoltOpsClient, createWorkflow, createWorkflowChain, createWorkflowStepNodeId, VoltAgent as default, extractFileParts, extractImageParts, extractText, extractTextParts, extractWorkflowStepInfo, filterContentParts, getContentLength, getEnvVar, getGlobalLogBuffer, getGlobalLogger, getNodeTypeFromNodeId, getWorkflowStepNodeType, hasContent, hasFilePart, hasImagePart, hasTextPart, isAbortError, isNodeRuntime, isServerlessRuntime, isStructuredContent, isTextContent, isVoltAgentError, mapMessageContent, messageHelpers, normalizeContent, normalizeToArray, prependToMessage, readableLogRecordToObservabilityLog, readableSpanToObservabilitySpan, safeJsonParse, serializeValueForDebug, tool, transformTextContent, updateAllPackages, updateSinglePackage, zodSchemaToJsonUI };
|
package/dist/index.js
CHANGED
|
@@ -2501,6 +2501,53 @@ Remember:
|
|
|
2501
2501
|
getEmbeddingAdapter() {
|
|
2502
2502
|
return this.embedding;
|
|
2503
2503
|
}
|
|
2504
|
+
/**
|
|
2505
|
+
* Get metadata about the configured storage adapter
|
|
2506
|
+
*/
|
|
2507
|
+
getStorageMetadata() {
|
|
2508
|
+
const adapter = this.storage?.constructor?.name || "UnknownStorageAdapter";
|
|
2509
|
+
return { adapter };
|
|
2510
|
+
}
|
|
2511
|
+
/**
|
|
2512
|
+
* Get a UI-friendly summary of working memory configuration
|
|
2513
|
+
*/
|
|
2514
|
+
getWorkingMemorySummary() {
|
|
2515
|
+
if (!this.workingMemoryConfig?.enabled) {
|
|
2516
|
+
return null;
|
|
2517
|
+
}
|
|
2518
|
+
const scope = this.workingMemoryConfig.scope || "conversation";
|
|
2519
|
+
const format = this.getWorkingMemoryFormat();
|
|
2520
|
+
const hasTemplate = Boolean(
|
|
2521
|
+
"template" in this.workingMemoryConfig && this.workingMemoryConfig.template
|
|
2522
|
+
);
|
|
2523
|
+
const hasSchema = Boolean(
|
|
2524
|
+
"schema" in this.workingMemoryConfig && this.workingMemoryConfig.schema
|
|
2525
|
+
);
|
|
2526
|
+
let template = null;
|
|
2527
|
+
let schemaSummary = null;
|
|
2528
|
+
if (hasTemplate && "template" in this.workingMemoryConfig) {
|
|
2529
|
+
template = this.workingMemoryConfig.template ?? null;
|
|
2530
|
+
}
|
|
2531
|
+
if (hasSchema && "schema" in this.workingMemoryConfig && this.workingMemoryConfig.schema) {
|
|
2532
|
+
const schemaShape = this.workingMemoryConfig.schema.shape;
|
|
2533
|
+
schemaSummary = Object.fromEntries(
|
|
2534
|
+
Object.entries(schemaShape || {}).map(([key, value]) => {
|
|
2535
|
+
const typeName = value?._def?.typeName;
|
|
2536
|
+
const friendlyName = typeName ? typeName.replace(/^Zod/, "").toLowerCase() : "unknown";
|
|
2537
|
+
return [key, friendlyName];
|
|
2538
|
+
})
|
|
2539
|
+
);
|
|
2540
|
+
}
|
|
2541
|
+
return {
|
|
2542
|
+
enabled: true,
|
|
2543
|
+
scope,
|
|
2544
|
+
format,
|
|
2545
|
+
hasTemplate,
|
|
2546
|
+
hasSchema,
|
|
2547
|
+
template,
|
|
2548
|
+
schema: schemaSummary
|
|
2549
|
+
};
|
|
2550
|
+
}
|
|
2504
2551
|
// ============================================================================
|
|
2505
2552
|
// Workflow State Operations
|
|
2506
2553
|
// ============================================================================
|
|
@@ -3204,6 +3251,14 @@ var InMemoryStorageAdapter2 = class {
|
|
|
3204
3251
|
}
|
|
3205
3252
|
return stats;
|
|
3206
3253
|
}
|
|
3254
|
+
getInfo() {
|
|
3255
|
+
return {
|
|
3256
|
+
adapter: this.constructor.name,
|
|
3257
|
+
displayName: "In-memory Storage",
|
|
3258
|
+
persistent: false,
|
|
3259
|
+
description: "Volatile storage intended for development and debugging sessions."
|
|
3260
|
+
};
|
|
3261
|
+
}
|
|
3207
3262
|
};
|
|
3208
3263
|
|
|
3209
3264
|
// src/observability/logs/storage-log-processor.ts
|
|
@@ -7655,7 +7710,9 @@ var MemoryManager = class {
|
|
|
7655
7710
|
available: !!this.conversationMemory,
|
|
7656
7711
|
status: "idle",
|
|
7657
7712
|
// Default to idle since we're only updating status during operations
|
|
7658
|
-
node_id: memoryNodeId
|
|
7713
|
+
node_id: memoryNodeId,
|
|
7714
|
+
storage: this.conversationMemory?.getStorageMetadata?.(),
|
|
7715
|
+
workingMemory: this.conversationMemory?.getWorkingMemorySummary?.() || void 0
|
|
7659
7716
|
};
|
|
7660
7717
|
return memoryObject;
|
|
7661
7718
|
}
|