@mastra/core 0.10.11-alpha.0 → 0.10.11-alpha.1

package/dist/agent/index.cjs

@@ -1,15 +1,15 @@
 'use strict';
 
-var chunkE325IAKB_cjs = require('../chunk-E325IAKB.cjs');
-var chunkYNUNDIES_cjs = require('../chunk-YNUNDIES.cjs');
+var chunkGCB3FMQA_cjs = require('../chunk-GCB3FMQA.cjs');
+var chunkN2LZKFEP_cjs = require('../chunk-N2LZKFEP.cjs');
 
 
 
 Object.defineProperty(exports, "Agent", {
   enumerable: true,
-  get: function () { return chunkE325IAKB_cjs.Agent; }
+  get: function () { return chunkGCB3FMQA_cjs.Agent; }
 });
 Object.defineProperty(exports, "MessageList", {
   enumerable: true,
-  get: function () { return chunkYNUNDIES_cjs.MessageList; }
+  get: function () { return chunkN2LZKFEP_cjs.MessageList; }
 });

package/dist/agent/index.d.cts

@@ -1,7 +1,7 @@
 export { Message as AiMessageType } from 'ai';
 import 'json-schema';
 import 'zod';
-export { A as Agent, av as AgentConfig, c6 as AgentGenerateOptions, c5 as AgentMemoryOption, c7 as AgentStreamOptions, aZ as DynamicArgument, aY as MastraLanguageModel, c8 as MastraMessageContentV2, t as MastraMessageV2, c3 as MessageList, T as ToolsInput, c4 as ToolsetsInput } from '../base-D5f8gjBR.cjs';
+export { A as Agent, av as AgentConfig, c6 as AgentGenerateOptions, c5 as AgentMemoryOption, c7 as AgentStreamOptions, aZ as DynamicArgument, aY as MastraLanguageModel, c8 as MastraMessageContentV2, t as MastraMessageV2, c3 as MessageList, T as ToolsInput, c4 as ToolsetsInput } from '../base-WzKVgsC3.cjs';
 import '../base-B_y9sMg0.cjs';
 import '../types-Bo1uigWx.cjs';
 import '../runtime-context/index.cjs';

package/dist/agent/index.d.ts

@@ -1,7 +1,7 @@
 export { Message as AiMessageType } from 'ai';
 import 'json-schema';
 import 'zod';
-export { A as Agent, av as AgentConfig, c6 as AgentGenerateOptions, c5 as AgentMemoryOption, c7 as AgentStreamOptions, aZ as DynamicArgument, aY as MastraLanguageModel, c8 as MastraMessageContentV2, t as MastraMessageV2, c3 as MessageList, T as ToolsInput, c4 as ToolsetsInput } from '../base-CY4tR3E-.js';
+export { A as Agent, av as AgentConfig, c6 as AgentGenerateOptions, c5 as AgentMemoryOption, c7 as AgentStreamOptions, aZ as DynamicArgument, aY as MastraLanguageModel, c8 as MastraMessageContentV2, t as MastraMessageV2, c3 as MessageList, T as ToolsInput, c4 as ToolsetsInput } from '../base-CDtRsAmk.js';
 import '../base-ClrXcCRx.js';
 import '../types-Bo1uigWx.js';
 import '../runtime-context/index.js';

package/dist/agent/index.js

@@ -1,2 +1,2 @@
-export { Agent } from '../chunk-2I4D464I.js';
-export { MessageList } from '../chunk-2H5YEBCO.js';
+export { Agent } from '../chunk-W3OZTB37.js';
+export { MessageList } from '../chunk-DPPWAOCI.js';

package/dist/{base-CY4tR3E-.d.ts → base-CDtRsAmk.d.ts}

@@ -2030,6 +2030,7 @@ declare class MessageList {
     private input;
     private response;
     drainUnsavedMessages(): MastraMessageV2[];
+    getEarliestUnsavedMessageTimestamp(): number | undefined;
     getSystemMessages(tag?: string): CoreMessage$1[];
     addSystem(messages: CoreSystemMessage$1 | CoreSystemMessage$1[] | string | string[] | null, tag?: string): this;
     private convertToCoreMessages;
@@ -2638,6 +2639,11 @@ type AgentGenerateOptions<OUTPUT extends ZodSchema | JSONSchema7 | undefined = u
     telemetry?: TelemetrySettings;
     /** RuntimeContext for dependency injection */
     runtimeContext?: RuntimeContext;
+    /**
+     * Whether to save messages incrementally on step finish
+     * @default false
+     */
+    savePerStep?: boolean;
 } & ({
     /**
      * @deprecated Use the `memory` property instead for all memory-related options.
@@ -2699,6 +2705,11 @@ type AgentStreamOptions<OUTPUT extends ZodSchema | JSONSchema7 | undefined = und
     telemetry?: TelemetrySettings;
     /** RuntimeContext for dependency injection */
     runtimeContext?: RuntimeContext;
+    /**
+     * Whether to save messages incrementally on step finish
+     * @default false
+     */
+    savePerStep?: boolean;
 } & ({
     /**
      * @deprecated Use the `memory` property instead for all memory-related options.
@@ -3666,6 +3677,70 @@ interface IAction<TId extends string, TSchemaIn extends z.ZodSchema | undefined,
     execute?: (context: TContext, options?: TOptions) => Promise<TSchemaOut extends z.ZodSchema ? z.infer<TSchemaOut> : unknown>;
 }
 
+declare class SaveQueueManager {
+    private logger?;
+    private debounceMs;
+    private memory?;
+    private static MAX_STALENESS_MS;
+    constructor({ logger, debounceMs, memory }: {
+        logger?: IMastraLogger;
+        debounceMs?: number;
+        memory?: MastraMemory;
+    });
+    private saveQueues;
+    private saveDebounceTimers;
+    /**
+     * Debounces save operations for a thread, ensuring that consecutive save requests
+     * are batched and only the latest is executed after a short delay.
+     * @param threadId - The ID of the thread to debounce saves for.
+     * @param saveFn - The save function to debounce.
+     */
+    private debounceSave;
+    /**
+     * Enqueues a save operation for a thread, ensuring that saves are executed in order and
+     * only one save runs at a time per thread. If a save is already in progress for the thread,
+     * the new save is queued to run after the previous completes.
+     *
+     * @param threadId - The ID of the thread whose messages should be saved.
+     * @param messageList - The MessageList instance containing unsaved messages.
+     * @param memoryConfig - Optional memory configuration to use for saving.
+     */
+    private enqueueSave;
+    /**
+     * Clears any pending debounced save for a thread, preventing the scheduled save
+     * from executing if it hasn't already fired.
+     *
+     * @param threadId - The ID of the thread whose debounced save should be cleared.
+     */
+    clearDebounce(threadId: string): void;
+    /**
+     * Persists any unsaved messages from the MessageList to memory storage.
+     * Drains the list of unsaved messages and writes them using the memory backend.
+     * @param messageList - The MessageList instance for the current thread.
+     * @param memoryConfig - The memory configuration for saving.
+     */
+    private persistUnsavedMessages;
+    /**
+     * Batches a save of unsaved messages for a thread, using debouncing to batch rapid updates.
+     * If the oldest unsaved message is stale (older than MAX_STALENESS_MS), the save is performed immediately.
+     * Otherwise, the save is delayed to batch multiple updates and reduce redundant writes.
+     *
+     * @param messageList - The MessageList instance containing unsaved messages.
+     * @param threadId - The ID of the thread whose messages are being saved.
+     * @param memoryConfig - Optional memory configuration for saving.
+     */
+    batchMessages(messageList: MessageList, threadId?: string, memoryConfig?: MemoryConfig): Promise<void>;
+    /**
+     * Forces an immediate save of unsaved messages for a thread, bypassing any debounce delay.
+     * This is used when a flush to persistent storage is required (e.g., on shutdown or critical transitions).
+     *
+     * @param messageList - The MessageList instance containing unsaved messages.
+     * @param threadId - The ID of the thread whose messages are being saved.
+     * @param memoryConfig - Optional memory configuration for saving.
+     */
+    flushMessages(messageList: MessageList, threadId?: string, memoryConfig?: MemoryConfig): Promise<void>;
+}
+
 type IDGenerator = () => string;
 declare class Agent<TAgentId extends string = string, TTools extends ToolsInput = ToolsInput, TMetrics extends Record<string, Metric> = Record<string, Metric>> extends MastraBase {
     #private;
@@ -3753,7 +3828,19 @@ declare class Agent<TAgentId extends string = string, TTools extends ToolsInput
     private getClientTools;
     private getWorkflowTools;
     private convertTools;
-    __primitive({ instructions, messages, context, thread, memoryConfig, resourceId, runId, toolsets, clientTools, runtimeContext, generateMessageId, }: {
+    /**
+     * Adds response messages from a step to the MessageList and schedules persistence.
+     * This is used for incremental saving: after each agent step, messages are added to a save queue
+     * and a debounced save operation is triggered to avoid redundant writes.
+     *
+     * @param result - The step result containing response messages.
+     * @param messageList - The MessageList instance for the current thread.
+     * @param threadId - The thread ID.
+     * @param memoryConfig - The memory configuration for saving.
+     * @param runId - (Optional) The run ID for logging.
+     */
+    private saveStepMessages;
+    __primitive({ instructions, messages, context, thread, memoryConfig, resourceId, runId, toolsets, clientTools, runtimeContext, generateMessageId, saveQueueManager, }: {
         instructions?: string;
         toolsets?: ToolsetsInput;
         clientTools?: ToolsInput;
@@ -3767,6 +3854,7 @@ declare class Agent<TAgentId extends string = string, TTools extends ToolsInput
         messages: string | string[] | CoreMessage$1[] | Message[];
         runtimeContext: RuntimeContext;
         generateMessageId: undefined | IDGenerator;
+        saveQueueManager: SaveQueueManager;
     }): {
         before: () => Promise<{
             messageObjects: CoreMessage$1[];

package/dist/{base-D5f8gjBR.d.cts → base-WzKVgsC3.d.cts}

@@ -2030,6 +2030,7 @@ declare class MessageList {
     private input;
     private response;
     drainUnsavedMessages(): MastraMessageV2[];
+    getEarliestUnsavedMessageTimestamp(): number | undefined;
     getSystemMessages(tag?: string): CoreMessage$1[];
     addSystem(messages: CoreSystemMessage$1 | CoreSystemMessage$1[] | string | string[] | null, tag?: string): this;
     private convertToCoreMessages;
@@ -2638,6 +2639,11 @@ type AgentGenerateOptions<OUTPUT extends ZodSchema | JSONSchema7 | undefined = u
     telemetry?: TelemetrySettings;
     /** RuntimeContext for dependency injection */
     runtimeContext?: RuntimeContext;
+    /**
+     * Whether to save messages incrementally on step finish
+     * @default false
+     */
+    savePerStep?: boolean;
 } & ({
     /**
      * @deprecated Use the `memory` property instead for all memory-related options.
@@ -2699,6 +2705,11 @@ type AgentStreamOptions<OUTPUT extends ZodSchema | JSONSchema7 | undefined = und
     telemetry?: TelemetrySettings;
     /** RuntimeContext for dependency injection */
     runtimeContext?: RuntimeContext;
+    /**
+     * Whether to save messages incrementally on step finish
+     * @default false
+     */
+    savePerStep?: boolean;
 } & ({
     /**
      * @deprecated Use the `memory` property instead for all memory-related options.
@@ -3666,6 +3677,70 @@ interface IAction<TId extends string, TSchemaIn extends z.ZodSchema | undefined,
     execute?: (context: TContext, options?: TOptions) => Promise<TSchemaOut extends z.ZodSchema ? z.infer<TSchemaOut> : unknown>;
 }
 
+declare class SaveQueueManager {
+    private logger?;
+    private debounceMs;
+    private memory?;
+    private static MAX_STALENESS_MS;
+    constructor({ logger, debounceMs, memory }: {
+        logger?: IMastraLogger;
+        debounceMs?: number;
+        memory?: MastraMemory;
+    });
+    private saveQueues;
+    private saveDebounceTimers;
+    /**
+     * Debounces save operations for a thread, ensuring that consecutive save requests
+     * are batched and only the latest is executed after a short delay.
+     * @param threadId - The ID of the thread to debounce saves for.
+     * @param saveFn - The save function to debounce.
+     */
+    private debounceSave;
+    /**
+     * Enqueues a save operation for a thread, ensuring that saves are executed in order and
+     * only one save runs at a time per thread. If a save is already in progress for the thread,
+     * the new save is queued to run after the previous completes.
+     *
+     * @param threadId - The ID of the thread whose messages should be saved.
+     * @param messageList - The MessageList instance containing unsaved messages.
+     * @param memoryConfig - Optional memory configuration to use for saving.
+     */
+    private enqueueSave;
+    /**
+     * Clears any pending debounced save for a thread, preventing the scheduled save
+     * from executing if it hasn't already fired.
+     *
+     * @param threadId - The ID of the thread whose debounced save should be cleared.
+     */
+    clearDebounce(threadId: string): void;
+    /**
+     * Persists any unsaved messages from the MessageList to memory storage.
+     * Drains the list of unsaved messages and writes them using the memory backend.
+     * @param messageList - The MessageList instance for the current thread.
+     * @param memoryConfig - The memory configuration for saving.
+     */
+    private persistUnsavedMessages;
+    /**
+     * Batches a save of unsaved messages for a thread, using debouncing to batch rapid updates.
+     * If the oldest unsaved message is stale (older than MAX_STALENESS_MS), the save is performed immediately.
+     * Otherwise, the save is delayed to batch multiple updates and reduce redundant writes.
+     *
+     * @param messageList - The MessageList instance containing unsaved messages.
+     * @param threadId - The ID of the thread whose messages are being saved.
+     * @param memoryConfig - Optional memory configuration for saving.
+     */
+    batchMessages(messageList: MessageList, threadId?: string, memoryConfig?: MemoryConfig): Promise<void>;
+    /**
+     * Forces an immediate save of unsaved messages for a thread, bypassing any debounce delay.
+     * This is used when a flush to persistent storage is required (e.g., on shutdown or critical transitions).
+     *
+     * @param messageList - The MessageList instance containing unsaved messages.
+     * @param threadId - The ID of the thread whose messages are being saved.
+     * @param memoryConfig - Optional memory configuration for saving.
+     */
+    flushMessages(messageList: MessageList, threadId?: string, memoryConfig?: MemoryConfig): Promise<void>;
+}
+
 type IDGenerator = () => string;
 declare class Agent<TAgentId extends string = string, TTools extends ToolsInput = ToolsInput, TMetrics extends Record<string, Metric> = Record<string, Metric>> extends MastraBase {
     #private;
@@ -3753,7 +3828,19 @@ declare class Agent<TAgentId extends string = string, TTools extends ToolsInput
     private getClientTools;
     private getWorkflowTools;
     private convertTools;
-    __primitive({ instructions, messages, context, thread, memoryConfig, resourceId, runId, toolsets, clientTools, runtimeContext, generateMessageId, }: {
+    /**
+     * Adds response messages from a step to the MessageList and schedules persistence.
+     * This is used for incremental saving: after each agent step, messages are added to a save queue
+     * and a debounced save operation is triggered to avoid redundant writes.
+     *
+     * @param result - The step result containing response messages.
+     * @param messageList - The MessageList instance for the current thread.
+     * @param threadId - The thread ID.
+     * @param memoryConfig - The memory configuration for saving.
+     * @param runId - (Optional) The run ID for logging.
+     */
+    private saveStepMessages;
+    __primitive({ instructions, messages, context, thread, memoryConfig, resourceId, runId, toolsets, clientTools, runtimeContext, generateMessageId, saveQueueManager, }: {
         instructions?: string;
         toolsets?: ToolsetsInput;
         clientTools?: ToolsInput;
@@ -3767,6 +3854,7 @@ declare class Agent<TAgentId extends string = string, TTools extends ToolsInput
         messages: string | string[] | CoreMessage$1[] | Message[];
         runtimeContext: RuntimeContext;
         generateMessageId: undefined | IDGenerator;
+        saveQueueManager: SaveQueueManager;
     }): {
         before: () => Promise<{
             messageObjects: CoreMessage$1[];

package/dist/{chunk-ARD5SSGR.cjs → chunk-CVOB5DQ2.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkE325IAKB_cjs = require('./chunk-E325IAKB.cjs');
+var chunkGCB3FMQA_cjs = require('./chunk-GCB3FMQA.cjs');
 var cohereAi = require('cohere-ai');
 
 var CohereRelevanceScorer = class {
@@ -38,7 +38,7 @@ Relevance score (0-1):`;
 var MastraAgentRelevanceScorer = class {
   agent;
   constructor(name, model) {
-    this.agent = new chunkE325IAKB_cjs.Agent({
+    this.agent = new chunkGCB3FMQA_cjs.Agent({
       name: `Relevance Scorer ${name}`,
       instructions: `You are a specialized agent for evaluating the relevance of text to queries.
 Your task is to rate how well a text passage answers a given query.

package/dist/{chunk-2H5YEBCO.js → chunk-DPPWAOCI.js}

@@ -438,6 +438,11 @@ var MessageList = class _MessageList {
     this.newResponseMessages.clear();
     return messages;
   }
+  getEarliestUnsavedMessageTimestamp() {
+    const unsavedMessages = this.messages.filter((m) => this.newUserMessages.has(m) || this.newResponseMessages.has(m));
+    if (unsavedMessages.length === 0) return void 0;
+    return Math.min(...unsavedMessages.map((m) => new Date(m.createdAt).getTime()));
+  }
   getSystemMessages(tag) {
     if (tag) {
       return this.taggedSystemMessages[tag] || [];