@voltagent/core 2.1.4 → 2.1.5

package/dist/index.d.mts

@@ -7877,6 +7877,10 @@ declare class MemoryManager {
      * Get the Memory V2 instance (for direct access if needed)
      */
     getMemory(): Memory | undefined;
+    /**
+     * Replace the Memory instance used for this manager.
+     */
+    setMemory(memory: Memory | false): void;
     /**
      * Get working memory content
      */
@@ -8072,6 +8076,7 @@ declare class Agent {
     private readonly logger;
     private readonly memoryManager;
     private readonly memory?;
+    private readonly memoryConfigured;
     private readonly summarization?;
     private defaultObservability?;
     private readonly toolManager;
@@ -8308,6 +8313,10 @@ declare class Agent {
      * Get Memory instance if available
      */
     getMemory(): Memory | false | undefined;
+    /**
+     * Internal: apply a default Memory instance when none was configured explicitly.
+     */
+    __setDefaultMemory(memory: Memory): void;
     /**
      * Convert this agent into a tool that can be used by other agents.
      * This enables supervisor/coordinator patterns where one agent can delegate
@@ -12655,6 +12664,20 @@ type VoltAgentOptions = {
      * Can be either Workflow instances or WorkflowChain instances
      */
     workflows?: Record<string, Workflow<DangerouslyAllowAny, DangerouslyAllowAny, DangerouslyAllowAny, DangerouslyAllowAny> | WorkflowChain<DangerouslyAllowAny, DangerouslyAllowAny, DangerouslyAllowAny, DangerouslyAllowAny, DangerouslyAllowAny>>;
+    /**
+     * Default Memory instance used when agent/workflow defaults are not provided.
+     */
+    memory?: Memory;
+    /**
+     * Default Memory instance used for agents when they don't specify one.
+     * Falls back to `memory` when not provided.
+     */
+    agentMemory?: Memory;
+    /**
+     * Default Memory instance used for workflows when they don't specify one.
+     * Falls back to `memory` when not provided.
+     */
+    workflowMemory?: Memory;
     /** Optional VoltOps trigger handlers */
     triggers?: VoltAgentTriggersConfig;
     /**
@@ -14226,6 +14249,9 @@ declare class AgentRegistry {
     private globalVoltOpsClient?;
     private globalLogger?;
     private globalObservability?;
+    private globalMemory?;
+    private globalAgentMemory?;
+    private globalWorkflowMemory?;
     /**
      * Track parent-child relationships between agents (child -> parents)
      */
@@ -14312,6 +14338,30 @@ declare class AgentRegistry {
      * Get the global VoltAgentObservability instance.
      */
     getGlobalObservability(): VoltAgentObservability | undefined;
+    /**
+     * Set the global fallback Memory instance.
+     */
+    setGlobalMemory(memory: Memory | undefined): void;
+    /**
+     * Get the global fallback Memory instance.
+     */
+    getGlobalMemory(): Memory | undefined;
+    /**
+     * Set the global default Memory instance for agents.
+     */
+    setGlobalAgentMemory(memory: Memory | undefined): void;
+    /**
+     * Get the global default Memory instance for agents.
+     */
+    getGlobalAgentMemory(): Memory | undefined;
+    /**
+     * Set the global default Memory instance for workflows.
+     */
+    setGlobalWorkflowMemory(memory: Memory | undefined): void;
+    /**
+     * Get the global default Memory instance for workflows.
+     */
+    getGlobalWorkflowMemory(): Memory | undefined;
 }
 
 type UpdateOptions = {
@@ -14373,6 +14423,8 @@ declare class VoltAgent {
     private serverlessProvider?;
     private logger;
     private observability?;
+    private defaultAgentMemory?;
+    private defaultWorkflowMemory?;
     private readonly mcpServers;
     private readonly mcpServerRegistry;
     private readonly a2aServers;
@@ -14399,6 +14451,8 @@ declare class VoltAgent {
      */
     registerTrigger(name: string, config: VoltAgentTriggerConfig): void;
     registerTriggers(triggers?: VoltAgentTriggersConfig): void;
+    private applyDefaultMemoryToAgent;
+    private applyDefaultMemoryToWorkflow;
     registerAgent(agent: Agent): void;
     /**
      * Register multiple agents

package/dist/index.d.ts

@@ -7877,6 +7877,10 @@ declare class MemoryManager {
      * Get the Memory V2 instance (for direct access if needed)
      */
     getMemory(): Memory | undefined;
+    /**
+     * Replace the Memory instance used for this manager.
+     */
+    setMemory(memory: Memory | false): void;
     /**
      * Get working memory content
      */
@@ -8072,6 +8076,7 @@ declare class Agent {
     private readonly logger;
     private readonly memoryManager;
     private readonly memory?;
+    private readonly memoryConfigured;
     private readonly summarization?;
     private defaultObservability?;
     private readonly toolManager;
@@ -8308,6 +8313,10 @@ declare class Agent {
      * Get Memory instance if available
      */
     getMemory(): Memory | false | undefined;
+    /**
+     * Internal: apply a default Memory instance when none was configured explicitly.
+     */
+    __setDefaultMemory(memory: Memory): void;
     /**
      * Convert this agent into a tool that can be used by other agents.
      * This enables supervisor/coordinator patterns where one agent can delegate
@@ -12655,6 +12664,20 @@ type VoltAgentOptions = {
      * Can be either Workflow instances or WorkflowChain instances
      */
     workflows?: Record<string, Workflow<DangerouslyAllowAny, DangerouslyAllowAny, DangerouslyAllowAny, DangerouslyAllowAny> | WorkflowChain<DangerouslyAllowAny, DangerouslyAllowAny, DangerouslyAllowAny, DangerouslyAllowAny, DangerouslyAllowAny>>;
+    /**
+     * Default Memory instance used when agent/workflow defaults are not provided.
+     */
+    memory?: Memory;
+    /**
+     * Default Memory instance used for agents when they don't specify one.
+     * Falls back to `memory` when not provided.
+     */
+    agentMemory?: Memory;
+    /**
+     * Default Memory instance used for workflows when they don't specify one.
+     * Falls back to `memory` when not provided.
+     */
+    workflowMemory?: Memory;
     /** Optional VoltOps trigger handlers */
     triggers?: VoltAgentTriggersConfig;
     /**
@@ -14226,6 +14249,9 @@ declare class AgentRegistry {
     private globalVoltOpsClient?;
     private globalLogger?;
     private globalObservability?;
+    private globalMemory?;
+    private globalAgentMemory?;
+    private globalWorkflowMemory?;
     /**
      * Track parent-child relationships between agents (child -> parents)
      */
@@ -14312,6 +14338,30 @@ declare class AgentRegistry {
      * Get the global VoltAgentObservability instance.
      */
     getGlobalObservability(): VoltAgentObservability | undefined;
+    /**
+     * Set the global fallback Memory instance.
+     */
+    setGlobalMemory(memory: Memory | undefined): void;
+    /**
+     * Get the global fallback Memory instance.
+     */
+    getGlobalMemory(): Memory | undefined;
+    /**
+     * Set the global default Memory instance for agents.
+     */
+    setGlobalAgentMemory(memory: Memory | undefined): void;
+    /**
+     * Get the global default Memory instance for agents.
+     */
+    getGlobalAgentMemory(): Memory | undefined;
+    /**
+     * Set the global default Memory instance for workflows.
+     */
+    setGlobalWorkflowMemory(memory: Memory | undefined): void;
+    /**
+     * Get the global default Memory instance for workflows.
+     */
+    getGlobalWorkflowMemory(): Memory | undefined;
 }
 
 type UpdateOptions = {
@@ -14373,6 +14423,8 @@ declare class VoltAgent {
     private serverlessProvider?;
     private logger;
     private observability?;
+    private defaultAgentMemory?;
+    private defaultWorkflowMemory?;
     private readonly mcpServers;
     private readonly mcpServerRegistry;
     private readonly a2aServers;
@@ -14399,6 +14451,8 @@ declare class VoltAgent {
      */
     registerTrigger(name: string, config: VoltAgentTriggerConfig): void;
     registerTriggers(triggers?: VoltAgentTriggersConfig): void;
+    private applyDefaultMemoryToAgent;
+    private applyDefaultMemoryToWorkflow;
     registerAgent(agent: Agent): void;
     /**
      * Register multiple agents

package/dist/index.js

@@ -926,6 +926,9 @@ var AgentRegistry = class _AgentRegistry {
   globalVoltOpsClient;
   globalLogger;
   globalObservability;
+  globalMemory;
+  globalAgentMemory;
+  globalWorkflowMemory;
   /**
    * Track parent-child relationships between agents (child -> parents)
    */
@@ -1098,6 +1101,42 @@ var AgentRegistry = class _AgentRegistry {
   getGlobalObservability() {
     return this.globalObservability;
   }
+  /**
+   * Set the global fallback Memory instance.
+   */
+  setGlobalMemory(memory) {
+    this.globalMemory = memory;
+  }
+  /**
+   * Get the global fallback Memory instance.
+   */
+  getGlobalMemory() {
+    return this.globalMemory;
+  }
+  /**
+   * Set the global default Memory instance for agents.
+   */
+  setGlobalAgentMemory(memory) {
+    this.globalAgentMemory = memory;
+  }
+  /**
+   * Get the global default Memory instance for agents.
+   */
+  getGlobalAgentMemory() {
+    return this.globalAgentMemory ?? this.globalMemory;
+  }
+  /**
+   * Set the global default Memory instance for workflows.
+   */
+  setGlobalWorkflowMemory(memory) {
+    this.globalWorkflowMemory = memory;
+  }
+  /**
+   * Get the global default Memory instance for workflows.
+   */
+  getGlobalWorkflowMemory() {
+    return this.globalWorkflowMemory ?? this.globalMemory;
+  }
 };
 
 // src/logger/console-logger.ts
@@ -7781,7 +7820,10 @@ function createWorkflow({
   observability: workflowObservability,
   retryConfig: workflowRetryConfig
 }, ...steps) {
-  const effectiveMemory = workflowMemory || new Memory({ storage: new InMemoryStorageAdapter() });
+  const hasExplicitMemory = workflowMemory !== void 0;
+  const globalWorkflowMemory = AgentRegistry.getInstance().getGlobalWorkflowMemory();
+  const fallbackMemory = new Memory({ storage: new InMemoryStorageAdapter() });
+  let defaultMemory = workflowMemory ?? globalWorkflowMemory ?? fallbackMemory;
   const saveSuspensionState = /* @__PURE__ */ __name(async (suspensionData, executionId, memory, logger2, events) => {
     try {
       logger2.trace(`Storing suspension checkpoint for execution ${executionId}`);
@@ -7827,6 +7869,7 @@ function createWorkflow({
   const effectiveResumeSchema = resumeSchema || import_zod.z.any();
   const executeInternal = /* @__PURE__ */ __name(async (input2, options, externalStreamController) => {
     const workflowRegistry = WorkflowRegistry.getInstance();
+    const executionMemory = options?.memory ?? defaultMemory;
     let executionId;
     if (options?.resumeFrom?.executionId) {
       executionId = options.resumeFrom.executionId;
@@ -7860,7 +7903,7 @@ function createWorkflow({
     let resumedFrom;
     if (options?.resumeFrom?.executionId) {
       try {
-        const workflowState2 = await effectiveMemory.getWorkflowState(executionId);
+        const workflowState2 = await executionMemory.getWorkflowState(executionId);
         if (workflowState2?.metadata?.traceId && workflowState2?.metadata?.spanId) {
           resumedFrom = {
             traceId: workflowState2.metadata.traceId,
@@ -7916,10 +7959,10 @@ function createWorkflow({
           options.resumeFrom.resumeData
         );
         try {
-          const workflowState2 = await effectiveMemory.getWorkflowState(executionId);
+          const workflowState2 = await executionMemory.getWorkflowState(executionId);
           if (workflowState2) {
             runLogger.debug(`Found existing workflow state with status: ${workflowState2.status}`);
-            await effectiveMemory.updateWorkflowState(executionId, {
+            await executionMemory.updateWorkflowState(executionId, {
               status: "running",
               suspension: void 0,
               // Clear suspension metadata
@@ -7953,7 +7996,7 @@ function createWorkflow({
           updatedAt: /* @__PURE__ */ new Date()
         };
         try {
-          await effectiveMemory.setWorkflowState(executionId, workflowState2);
+          await executionMemory.setWorkflowState(executionId, workflowState2);
           runLogger.trace(`Created workflow state in Memory V2 for ${executionId}`);
         } catch (error) {
           runLogger.error("Failed to create workflow state in Memory V2:", { error });
@@ -7976,7 +8019,7 @@ function createWorkflow({
         signal: options?.suspendController?.signal,
         // Get signal from suspendController
         // Store effective memory for use in steps if needed
-        memory: effectiveMemory,
+        memory: executionMemory,
         // Initialize step data map for tracking inputs/outputs
         stepData: /* @__PURE__ */ new Map(),
         // Initialize event sequence - restore from resume or start at 0
@@ -8153,7 +8196,7 @@ function createWorkflow({
             await safeFlushOnFinish(observability);
             workflowRegistry.activeExecutions.delete(executionId);
             try {
-              await effectiveMemory.updateWorkflowState(executionId, {
+              await executionMemory.updateWorkflowState(executionId, {
                 status: "cancelled",
                 events: collectedEvents,
                 cancellation: {
@@ -8257,7 +8300,7 @@ function createWorkflow({
               await saveSuspensionState(
                 suspensionData,
                 executionId,
-                effectiveMemory,
+                executionMemory,
                 runLogger,
                 collectedEvents
               );
@@ -8405,7 +8448,7 @@ function createWorkflow({
               await saveSuspensionState(
                 suspensionMetadata,
                 executionId,
-                effectiveMemory,
+                executionMemory,
                 runLogger,
                 collectedEvents
               );
@@ -8614,7 +8657,7 @@ function createWorkflow({
         traceContext.end("completed");
         await safeFlushOnFinish(observability);
         try {
-          await effectiveMemory.updateWorkflowState(executionContext.executionId, {
+          await executionMemory.updateWorkflowState(executionContext.executionId, {
             status: "completed",
             events: collectedEvents,
             output: finalState.result,
@@ -8676,7 +8719,7 @@ function createWorkflow({
           });
           streamController?.close();
           try {
-            await effectiveMemory.updateWorkflowState(executionId, {
+            await executionMemory.updateWorkflowState(executionId, {
               status: "cancelled",
               metadata: {
                 ...stateManager.state?.usage ? { usage: stateManager.state.usage } : {},
@@ -8752,7 +8795,7 @@ function createWorkflow({
           stateManager.fail(error);
         }
         try {
-          await effectiveMemory.updateWorkflowState(executionId, {
+          await executionMemory.updateWorkflowState(executionId, {
             status: "error",
             events: collectedEvents,
             // Store a lightweight error summary in metadata for debugging
@@ -8785,7 +8828,7 @@ function createWorkflow({
       }
     });
   }, "executeInternal");
-  return {
+  const workflow = {
     id,
     name,
     purpose: purpose ?? "No purpose provided",
@@ -8795,7 +8838,7 @@ function createWorkflow({
     suspendSchema: effectiveSuspendSchema,
     resumeSchema: effectiveResumeSchema,
     // ✅ Always expose memory for registry access
-    memory: effectiveMemory,
+    memory: defaultMemory,
     observability: workflowObservability,
     inputGuardrails: workflowInputGuardrails,
     outputGuardrails: workflowOutputGuardrails,
@@ -8975,6 +9018,15 @@ function createWorkflow({
       return streamResult;
     }, "stream")
   };
+  const setDefaultMemory = /* @__PURE__ */ __name((memory) => {
+    if (hasExplicitMemory) {
+      return;
+    }
+    defaultMemory = memory;
+    workflow.memory = memory;
+  }, "setDefaultMemory");
+  workflow.__setDefaultMemory = setDefaultMemory;
+  return workflow;
 }
 __name(createWorkflow, "createWorkflow");
 function createWorkflowExecutionResult(workflowId, executionId, startAt, endAt, status, result, usage, suspension, cancellation, error, resumeSchema) {
@@ -10078,6 +10130,18 @@ var MemoryManager = class {
   getMemory() {
     return this.conversationMemory;
   }
+  /**
+   * Replace the Memory instance used for this manager.
+   */
+  setMemory(memory) {
+    if (memory === false) {
+      this.conversationMemory = void 0;
+      return;
+    }
+    if (memory instanceof Memory) {
+      this.conversationMemory = memory;
+    }
+  }
   // ============================================================================
   // Working Memory Proxy Methods
   // ============================================================================
@@ -21228,6 +21292,7 @@ var Agent = class {
   logger;
   memoryManager;
   memory;
+  memoryConfigured;
   summarization;
   defaultObservability;
   toolManager;
@@ -21286,9 +21351,11 @@ var Agent = class {
       hasMemory: options.memory !== false,
       hasSubAgents: !!(options.subAgents && options.subAgents.length > 0)
     });
+    this.memoryConfigured = options.memory !== void 0;
     this.memory = options.memory;
     this.summarization = options.summarization;
-    this.memoryManager = new MemoryManager(this.id, this.memory, {}, this.logger);
+    const resolvedMemory = this.memoryConfigured ? options.memory : AgentRegistry.getInstance().getGlobalAgentMemory();
+    this.memoryManager = new MemoryManager(this.id, resolvedMemory, {}, this.logger);
     const staticTools = typeof options.tools === "function" ? [] : options.tools;
     this.toolManager = new ToolManager(staticTools, this.logger);
     if (options.toolkits) {
@@ -25014,6 +25081,8 @@ ${retrieverContext}`;
         node_id: createNodeId("scorer" /* SCORER */, scorerId, this.id)
       };
     }) : [];
+    const activeMemory = this.getMemory();
+    const memoryInstance = activeMemory || void 0;
     return {
       id: this.id,
       name: this.name,
@@ -25033,17 +25102,17 @@ ${retrieverContext}`;
         ...this.memoryManager.getMemoryState(),
         node_id: createNodeId("memory" /* MEMORY */, this.id),
         // Add vector DB and embedding info if Memory V2 is configured
-        vectorDB: this.memory && typeof this.memory === "object" && this.memory.getVectorAdapter?.() ? {
+        vectorDB: memoryInstance?.getVectorAdapter?.() ? {
           enabled: true,
-          adapter: this.memory.getVectorAdapter()?.constructor.name || "Unknown",
-          dimension: this.memory.getEmbeddingAdapter?.()?.getDimensions() || 0,
+          adapter: memoryInstance.getVectorAdapter()?.constructor.name || "Unknown",
+          dimension: memoryInstance.getEmbeddingAdapter?.()?.getDimensions() || 0,
           status: "idle",
           node_id: createNodeId("vector" /* VECTOR */, this.id)
         } : null,
-        embeddingModel: this.memory && typeof this.memory === "object" && this.memory.getEmbeddingAdapter?.() ? {
+        embeddingModel: memoryInstance?.getEmbeddingAdapter?.() ? {
           enabled: true,
-          model: this.memory.getEmbeddingAdapter()?.getModelName() || "unknown",
-          dimension: this.memory.getEmbeddingAdapter()?.getDimensions() || 0,
+          model: memoryInstance.getEmbeddingAdapter()?.getModelName() || "unknown",
+          dimension: memoryInstance.getEmbeddingAdapter()?.getDimensions() || 0,
           status: "idle",
           node_id: createNodeId("embedding" /* EMBEDDING */, this.id)
         } : null
@@ -25174,6 +25243,15 @@ ${retrieverContext}`;
     }
     return this.memory ?? this.memoryManager.getMemory();
   }
+  /**
+   * Internal: apply a default Memory instance when none was configured explicitly.
+   */
+  __setDefaultMemory(memory) {
+    if (this.memoryConfigured || this.memory === false) {
+      return;
+    }
+    this.memoryManager.setMemory(memory);
+  }
   /**
    * Convert this agent into a tool that can be used by other agents.
    * This enables supervisor/coordinator patterns where one agent can delegate
@@ -31680,6 +31758,8 @@ var VoltAgent = class {
   serverlessProvider;
   logger;
   observability;
+  defaultAgentMemory;
+  defaultWorkflowMemory;
   mcpServers = /* @__PURE__ */ new Set();
   mcpServerRegistry = new MCPServerRegistry();
   a2aServers = /* @__PURE__ */ new Set();
@@ -31695,6 +31775,17 @@ var VoltAgent = class {
       this.ensureEnvironment();
     };
     this.agentRefs = options.agents ?? {};
+    this.defaultAgentMemory = options.agentMemory ?? options.memory;
+    this.defaultWorkflowMemory = options.workflowMemory ?? options.memory;
+    if (options.memory) {
+      this.registry.setGlobalMemory(options.memory);
+    }
+    if (options.agentMemory) {
+      this.registry.setGlobalAgentMemory(options.agentMemory);
+    }
+    if (options.workflowMemory) {
+      this.registry.setGlobalWorkflowMemory(options.workflowMemory);
+    }
     this.logger = (options.logger || getGlobalLogger()).child({ component: "voltagent" });
     if (options.voltOpsClient) {
       this.registry.setGlobalVoltOpsClient(options.voltOpsClient);
@@ -31899,7 +31990,21 @@ var VoltAgent = class {
     }
     Object.entries(triggers).forEach(([name, config]) => this.registerTrigger(name, config));
   }
+  applyDefaultMemoryToAgent(agent) {
+    if (!this.defaultAgentMemory) {
+      return;
+    }
+    agent.__setDefaultMemory(this.defaultAgentMemory);
+  }
+  applyDefaultMemoryToWorkflow(workflow) {
+    if (!this.defaultWorkflowMemory) {
+      return;
+    }
+    const workflowWithDefaults = workflow;
+    workflowWithDefaults.__setDefaultMemory?.(this.defaultWorkflowMemory);
+  }
   registerAgent(agent) {
+    this.applyDefaultMemoryToAgent(agent);
     this.registry.registerAgent(agent);
   }
   /**
@@ -31977,6 +32082,7 @@ var VoltAgent = class {
   registerWorkflows(workflows) {
     Object.values(workflows).forEach((workflow) => {
       const workflowInstance = "toWorkflow" in workflow ? workflow.toWorkflow() : workflow;
+      this.applyDefaultMemoryToWorkflow(workflowInstance);
       this.workflowRegistry.registerWorkflow(workflowInstance);
     });
   }
@@ -31984,6 +32090,7 @@ var VoltAgent = class {
    * Register a single workflow
    */
   registerWorkflow(workflow) {
+    this.applyDefaultMemoryToWorkflow(workflow);
     this.workflowRegistry.registerWorkflow(workflow);
   }
   /**