@voltagent/core 2.6.5 → 2.6.7

package/dist/index.d.mts

@@ -8390,6 +8390,41 @@ 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;
+    /**
+     * When true, memory is read-only for the current call.
+     * Existing memory context can be loaded, but no writes are persisted.
+     */
+    readOnly?: boolean;
+}
+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;
+    readOnly?: boolean;
+}
 /**
  * Agent status information
  */
@@ -8459,6 +8494,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 */
@@ -9008,7 +9045,9 @@ declare class MemoryManager {
      * Ensures context is always loaded, optimizes non-critical operations in background
      * PRESERVED FROM ORIGINAL
      */
-    prepareConversationContext(context: OperationContext, input: string | UIMessage[], userId?: string, conversationIdParam?: string, contextLimit?: number): Promise<{
+    prepareConversationContext(context: OperationContext, input: string | UIMessage[], userId?: string, conversationIdParam?: string, contextLimit?: number, options?: {
+        persistInput?: boolean;
+    }): Promise<{
         messages: UIMessage<{
             createdAt: Date;
         }>[];
@@ -9177,7 +9216,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 +9234,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 +9374,7 @@ declare class Agent {
      */
     private normalizeConversationPersistenceOptions;
     private resolveConversationPersistenceOptions;
+    private resolveMemoryRuntimeOptions;
     private getConversationPersistenceOptionsForContext;
     /**
      * Create only the OperationContext (sync)
@@ -9330,6 +9384,8 @@ declare class Agent {
     private resetOperationAttemptState;
     private getConversationBuffer;
     private getMemoryPersistQueue;
+    private isReadOnlyMemoryForContext;
+    private shouldPersistMemoryForContext;
     private ensureStreamingResponseMessageId;
     private getOrCreateStepResponseMessageId;
     private getStepResponseMessageFingerprints;

package/dist/index.d.ts

@@ -8390,6 +8390,41 @@ 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;
+    /**
+     * When true, memory is read-only for the current call.
+     * Existing memory context can be loaded, but no writes are persisted.
+     */
+    readOnly?: boolean;
+}
+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;
+    readOnly?: boolean;
+}
 /**
  * Agent status information
  */
@@ -8459,6 +8494,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 */
@@ -9008,7 +9045,9 @@ declare class MemoryManager {
      * Ensures context is always loaded, optimizes non-critical operations in background
      * PRESERVED FROM ORIGINAL
      */
-    prepareConversationContext(context: OperationContext, input: string | UIMessage[], userId?: string, conversationIdParam?: string, contextLimit?: number): Promise<{
+    prepareConversationContext(context: OperationContext, input: string | UIMessage[], userId?: string, conversationIdParam?: string, contextLimit?: number, options?: {
+        persistInput?: boolean;
+    }): Promise<{
         messages: UIMessage<{
             createdAt: Date;
         }>[];
@@ -9177,7 +9216,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 +9234,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 +9374,7 @@ declare class Agent {
      */
     private normalizeConversationPersistenceOptions;
     private resolveConversationPersistenceOptions;
+    private resolveMemoryRuntimeOptions;
     private getConversationPersistenceOptionsForContext;
     /**
      * Create only the OperationContext (sync)
@@ -9330,6 +9384,8 @@ declare class Agent {
     private resetOperationAttemptState;
     private getConversationBuffer;
     private getMemoryPersistQueue;
+    private isReadOnlyMemoryForContext;
+    private shouldPersistMemoryForContext;
     private ensureStreamingResponseMessageId;
     private getOrCreateStepResponseMessageId;
     private getStepResponseMessageFingerprints;