@voltagent/core 2.6.4 → 2.6.6

package/dist/index.d.mts

@@ -8390,6 +8390,35 @@ interface AgentEvalConfig {
     sampling?: AgentEvalSamplingPolicy;
     redact?: (payload: AgentEvalPayload) => AgentEvalPayload;
 }
+/**
+ * Common generate options - internal version that includes historyEntryId
+ * Not exposed directly to users
+ */
+interface CommonSemanticMemoryOptions {
+    enabled?: boolean;
+    semanticLimit?: number;
+    semanticThreshold?: number;
+    mergeStrategy?: "prepend" | "append" | "interleave";
+}
+interface CommonRuntimeMemoryBehaviorOptions {
+    contextLimit?: number;
+    semanticMemory?: CommonSemanticMemoryOptions;
+    conversationPersistence?: AgentConversationPersistenceOptions;
+}
+interface CommonRuntimeMemoryEnvelope {
+    conversationId?: string;
+    userId?: string;
+    options?: CommonRuntimeMemoryBehaviorOptions;
+}
+type SemanticMemoryOptions = CommonSemanticMemoryOptions;
+type RuntimeMemoryEnvelope = CommonRuntimeMemoryEnvelope;
+interface CommonResolvedRuntimeMemoryOptions {
+    userId?: string;
+    conversationId?: string;
+    contextLimit?: number;
+    semanticMemory?: CommonSemanticMemoryOptions;
+    conversationPersistence?: AgentConversationPersistenceOptions;
+}
 /**
  * Agent status information
  */
@@ -8459,6 +8488,8 @@ type OperationContext = {
     userId?: string;
     /** Optional conversation identifier associated with this operation */
     conversationId?: string;
+    /** Resolved runtime memory options (memory envelope preferred, legacy as fallback) */
+    resolvedMemory?: CommonResolvedRuntimeMemoryOptions;
     /** Workspace configured on the executing agent (if any). */
     workspace?: Workspace;
     /** User-managed context map for this operation */
@@ -9177,7 +9208,17 @@ interface GenerateObjectResultWithContext<T> extends GenerateObjectResult<T> {
  * Extends AI SDK's CallSettings for full compatibility
  */
 interface BaseGenerationOptions<TProviderOptions extends ProviderOptions$1 = ProviderOptions$1> extends Partial<CallSettings> {
+    /**
+     * Runtime memory envelope for per-call memory identity and behavior overrides.
+     */
+    memory?: RuntimeMemoryEnvelope;
+    /**
+     * @deprecated Use `memory.userId` instead.
+     */
     userId?: string;
+    /**
+     * @deprecated Use `memory.conversationId` instead.
+     */
     conversationId?: string;
     context?: ContextInput;
     elicitation?: (request: unknown) => Promise<unknown>;
@@ -9185,13 +9226,17 @@ interface BaseGenerationOptions<TProviderOptions extends ProviderOptions$1 = Pro
     parentOperationContext?: OperationContext;
     parentSpan?: Span;
     inheritParentSpan?: boolean;
+    /**
+     * @deprecated Use `memory.options.contextLimit` instead.
+     */
     contextLimit?: number;
-    semanticMemory?: {
-        enabled?: boolean;
-        semanticLimit?: number;
-        semanticThreshold?: number;
-        mergeStrategy?: "prepend" | "append" | "interleave";
-    };
+    /**
+     * @deprecated Use `memory.options.semanticMemory` instead.
+     */
+    semanticMemory?: SemanticMemoryOptions;
+    /**
+     * @deprecated Use `memory.options.conversationPersistence` instead.
+     */
     conversationPersistence?: AgentConversationPersistenceOptions;
     maxSteps?: number;
     feedback?: boolean | AgentFeedbackOptions;
@@ -9321,6 +9366,7 @@ declare class Agent {
      */
     private normalizeConversationPersistenceOptions;
     private resolveConversationPersistenceOptions;
+    private resolveMemoryRuntimeOptions;
     private getConversationPersistenceOptionsForContext;
     /**
      * Create only the OperationContext (sync)

package/dist/index.d.ts

@@ -8390,6 +8390,35 @@ interface AgentEvalConfig {
     sampling?: AgentEvalSamplingPolicy;
     redact?: (payload: AgentEvalPayload) => AgentEvalPayload;
 }
+/**
+ * Common generate options - internal version that includes historyEntryId
+ * Not exposed directly to users
+ */
+interface CommonSemanticMemoryOptions {
+    enabled?: boolean;
+    semanticLimit?: number;
+    semanticThreshold?: number;
+    mergeStrategy?: "prepend" | "append" | "interleave";
+}
+interface CommonRuntimeMemoryBehaviorOptions {
+    contextLimit?: number;
+    semanticMemory?: CommonSemanticMemoryOptions;
+    conversationPersistence?: AgentConversationPersistenceOptions;
+}
+interface CommonRuntimeMemoryEnvelope {
+    conversationId?: string;
+    userId?: string;
+    options?: CommonRuntimeMemoryBehaviorOptions;
+}
+type SemanticMemoryOptions = CommonSemanticMemoryOptions;
+type RuntimeMemoryEnvelope = CommonRuntimeMemoryEnvelope;
+interface CommonResolvedRuntimeMemoryOptions {
+    userId?: string;
+    conversationId?: string;
+    contextLimit?: number;
+    semanticMemory?: CommonSemanticMemoryOptions;
+    conversationPersistence?: AgentConversationPersistenceOptions;
+}
 /**
  * Agent status information
  */
@@ -8459,6 +8488,8 @@ type OperationContext = {
     userId?: string;
     /** Optional conversation identifier associated with this operation */
     conversationId?: string;
+    /** Resolved runtime memory options (memory envelope preferred, legacy as fallback) */
+    resolvedMemory?: CommonResolvedRuntimeMemoryOptions;
     /** Workspace configured on the executing agent (if any). */
     workspace?: Workspace;
     /** User-managed context map for this operation */
@@ -9177,7 +9208,17 @@ interface GenerateObjectResultWithContext<T> extends GenerateObjectResult<T> {
  * Extends AI SDK's CallSettings for full compatibility
  */
 interface BaseGenerationOptions<TProviderOptions extends ProviderOptions$1 = ProviderOptions$1> extends Partial<CallSettings> {
+    /**
+     * Runtime memory envelope for per-call memory identity and behavior overrides.
+     */
+    memory?: RuntimeMemoryEnvelope;
+    /**
+     * @deprecated Use `memory.userId` instead.
+     */
     userId?: string;
+    /**
+     * @deprecated Use `memory.conversationId` instead.
+     */
     conversationId?: string;
     context?: ContextInput;
     elicitation?: (request: unknown) => Promise<unknown>;
@@ -9185,13 +9226,17 @@ interface BaseGenerationOptions<TProviderOptions extends ProviderOptions$1 = Pro
     parentOperationContext?: OperationContext;
     parentSpan?: Span;
     inheritParentSpan?: boolean;
+    /**
+     * @deprecated Use `memory.options.contextLimit` instead.
+     */
     contextLimit?: number;
-    semanticMemory?: {
-        enabled?: boolean;
-        semanticLimit?: number;
-        semanticThreshold?: number;
-        mergeStrategy?: "prepend" | "append" | "interleave";
-    };
+    /**
+     * @deprecated Use `memory.options.semanticMemory` instead.
+     */
+    semanticMemory?: SemanticMemoryOptions;
+    /**
+     * @deprecated Use `memory.options.conversationPersistence` instead.
+     */
     conversationPersistence?: AgentConversationPersistenceOptions;
     maxSteps?: number;
     feedback?: boolean | AgentFeedbackOptions;
@@ -9321,6 +9366,7 @@ declare class Agent {
      */
     private normalizeConversationPersistenceOptions;
     private resolveConversationPersistenceOptions;
+    private resolveMemoryRuntimeOptions;
     private getConversationPersistenceOptionsForContext;
     /**
      * Create only the OperationContext (sync)