@mastra/core 0.10.10 → 0.10.11-alpha.1

package/dist/agent/index.cjs

@@ -1,15 +1,15 @@
 'use strict';
 
-var chunkLYF7XPUM_cjs = require('../chunk-LYF7XPUM.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 chunkLYF7XPUM_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-Bu9IeyHt.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-D6PagN3X.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-377IVDXZ.js';
-export { MessageList } from '../chunk-2H5YEBCO.js';
+export { Agent } from '../chunk-W3OZTB37.js';
+export { MessageList } from '../chunk-DPPWAOCI.js';

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

@@ -1326,9 +1326,9 @@ interface WorkflowRunState {
 /**
  * Represents an execution graph for a workflow
  */
-interface ExecutionGraph {
+interface ExecutionGraph<TEngineType = any> {
     id: string;
-    steps: StepFlowEntry[];
+    steps: StepFlowEntry<TEngineType>[];
 }
 /**
  * Execution engine abstract class for building and executing workflow graphs
@@ -1375,11 +1375,13 @@ type StepFlowEntry<TEngineType = DefaultEngineType> = {
 } | {
     type: 'sleep';
     id: string;
-    duration: number;
+    duration?: number;
+    fn?: ExecuteFunction<any, any, any, any, TEngineType>;
 } | {
     type: 'sleepUntil';
     id: string;
-    date: Date;
+    date?: Date;
+    fn?: ExecuteFunction<any, any, any, any, TEngineType>;
 } | {
     type: 'waitForEvent';
     event: string;
@@ -1423,11 +1425,13 @@ type SerializedStepFlowEntry = {
 } | {
     type: 'sleep';
     id: string;
-    duration: number;
+    duration?: number;
+    fn?: string;
 } | {
     type: 'sleepUntil';
     id: string;
-    date: Date;
+    date?: Date;
+    fn?: string;
 } | {
     type: 'waitForEvent';
     event: string;
@@ -1552,7 +1556,7 @@ declare class Workflow<TEngineType = any, TSteps extends Step<string, any, any,
     outputSchema: TOutput;
     steps: Record<string, StepWithComponent>;
     stepDefs?: TSteps;
-    protected stepFlow: StepFlowEntry[];
+    protected stepFlow: StepFlowEntry<TEngineType>[];
     protected serializedStepFlow: SerializedStepFlowEntry[];
     protected executionEngine: ExecutionEngine;
     protected executionGraph: ExecutionGraph;
@@ -1565,7 +1569,7 @@ declare class Workflow<TEngineType = any, TSteps extends Step<string, any, any,
     get mastra(): Mastra<Record<string, Agent<any, ToolsInput, Record<string, Metric>>>, Record<string, LegacyWorkflow<LegacyStep<string, any, any, StepExecutionContext<any, WorkflowContext<any, LegacyStep<string, any, any, any>[], Record<string, any>>>>[], string, any, any>>, Record<string, Workflow<any, Step<string, any, any, any, any, any>[], string, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>>>, Record<string, MastraVector<VectorFilter>>, Record<string, MastraTTS>, IMastraLogger, Record<string, AgentNetwork>, Record<string, NewAgentNetwork>, Record<string, MCPServerBase>> | undefined;
     __registerMastra(mastra: Mastra): void;
     __registerPrimitives(p: MastraPrimitives): void;
-    setStepFlow(stepFlow: StepFlowEntry[]): void;
+    setStepFlow(stepFlow: StepFlowEntry<TEngineType>[]): void;
     /**
      * Adds a step to the workflow
      * @param step The step to add to the workflow
@@ -1577,13 +1581,13 @@ declare class Workflow<TEngineType = any, TSteps extends Step<string, any, any,
      * @param duration The duration to sleep for
      * @returns The workflow instance for chaining
      */
-    sleep(duration: number): Workflow<TEngineType, TSteps, TWorkflowId, TInput, TOutput, TPrevSchema>;
+    sleep(duration: number | ExecuteFunction<z.infer<TPrevSchema>, number, any, any, TEngineType>): Workflow<TEngineType, TSteps, TWorkflowId, TInput, TOutput, TPrevSchema>;
     /**
      * Adds a sleep until step to the workflow
      * @param date The date to sleep until
      * @returns The workflow instance for chaining
      */
-    sleepUntil(date: Date): Workflow<TEngineType, TSteps, TWorkflowId, TInput, TOutput, TPrevSchema>;
+    sleepUntil(date: Date | ExecuteFunction<z.infer<TPrevSchema>, Date, any, any, TEngineType>): Workflow<TEngineType, TSteps, TWorkflowId, TInput, TOutput, TPrevSchema>;
     waitForEvent<TStepInputSchema extends TPrevSchema, TStepId extends string, TSchemaOut extends z.ZodType<any>>(event: string, step: Step<TStepId, TStepInputSchema, TSchemaOut, any, any, TEngineType>, opts?: {
         timeout?: number;
     }): Workflow<TEngineType, TSteps, TWorkflowId, TInput, TOutput, TSchemaOut>;
@@ -1623,7 +1627,7 @@ declare class Workflow<TEngineType = any, TSteps extends Step<string, any, any,
      * @returns A built workflow instance ready for execution
      */
     commit(): Workflow<TEngineType, TSteps, TWorkflowId, TInput, TOutput, TOutput>;
-    get stepGraph(): StepFlowEntry<DefaultEngineType>[];
+    get stepGraph(): StepFlowEntry<TEngineType>[];
     get serializedStepGraph(): SerializedStepFlowEntry[];
     /**
      * Creates a new workflow run instance
@@ -1926,6 +1930,7 @@ type MemoryConfig = {
     threads?: {
         generateTitle?: boolean | {
             model: DynamicArgument<MastraLanguageModel>;
+            instructions?: DynamicArgument<string>;
         };
     };
 };
@@ -2025,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;
@@ -2633,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.
@@ -2694,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.
@@ -3661,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;
@@ -3721,13 +3801,14 @@ declare class Agent<TAgentId extends string = string, TTools extends ToolsInput
      * @param tools
      */
     __setTools(tools: TTools): void;
-    generateTitleFromUserMessage({ message, runtimeContext, model, }: {
+    generateTitleFromUserMessage({ message, runtimeContext, model, instructions, }: {
         message: string | MessageInput;
         runtimeContext?: RuntimeContext;
         model?: DynamicArgument<MastraLanguageModel>;
+        instructions?: DynamicArgument<string>;
     }): Promise<string>;
     getMostRecentUserMessage(messages: Array<UIMessage>): UIMessage | undefined;
-    genTitle(userMessage: string | MessageInput | undefined, runtimeContext: RuntimeContext, model?: DynamicArgument<MastraLanguageModel>): Promise<string | undefined>;
+    genTitle(userMessage: string | MessageInput | undefined, runtimeContext: RuntimeContext, model?: DynamicArgument<MastraLanguageModel>, instructions?: DynamicArgument<string>): Promise<string | undefined>;
     fetchMemory({ threadId, thread: passedThread, memoryConfig, resourceId, runId, userMessages, systemMessage, messageList, }: {
         resourceId: string;
         threadId: string;
@@ -3747,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;
@@ -3761,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[];
@@ -3851,6 +3945,11 @@ declare class Agent<TAgentId extends string = string, TTools extends ToolsInput
      * @private
      */
     private resolveTitleGenerationConfig;
+    /**
+     * Resolves title generation instructions, handling both static strings and dynamic functions
+     * @private
+     */
+    private resolveTitleInstructions;
 }
 
 declare abstract class MastraStorage extends MastraBase {

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

@@ -1326,9 +1326,9 @@ interface WorkflowRunState {
 /**
  * Represents an execution graph for a workflow
  */
-interface ExecutionGraph {
+interface ExecutionGraph<TEngineType = any> {
     id: string;
-    steps: StepFlowEntry[];
+    steps: StepFlowEntry<TEngineType>[];
 }
 /**
  * Execution engine abstract class for building and executing workflow graphs
@@ -1375,11 +1375,13 @@ type StepFlowEntry<TEngineType = DefaultEngineType> = {
 } | {
     type: 'sleep';
     id: string;
-    duration: number;
+    duration?: number;
+    fn?: ExecuteFunction<any, any, any, any, TEngineType>;
 } | {
     type: 'sleepUntil';
     id: string;
-    date: Date;
+    date?: Date;
+    fn?: ExecuteFunction<any, any, any, any, TEngineType>;
 } | {
     type: 'waitForEvent';
     event: string;
@@ -1423,11 +1425,13 @@ type SerializedStepFlowEntry = {
 } | {
     type: 'sleep';
     id: string;
-    duration: number;
+    duration?: number;
+    fn?: string;
 } | {
     type: 'sleepUntil';
     id: string;
-    date: Date;
+    date?: Date;
+    fn?: string;
 } | {
     type: 'waitForEvent';
     event: string;
@@ -1552,7 +1556,7 @@ declare class Workflow<TEngineType = any, TSteps extends Step<string, any, any,
     outputSchema: TOutput;
     steps: Record<string, StepWithComponent>;
     stepDefs?: TSteps;
-    protected stepFlow: StepFlowEntry[];
+    protected stepFlow: StepFlowEntry<TEngineType>[];
     protected serializedStepFlow: SerializedStepFlowEntry[];
     protected executionEngine: ExecutionEngine;
     protected executionGraph: ExecutionGraph;
@@ -1565,7 +1569,7 @@ declare class Workflow<TEngineType = any, TSteps extends Step<string, any, any,
     get mastra(): Mastra<Record<string, Agent<any, ToolsInput, Record<string, Metric>>>, Record<string, LegacyWorkflow<LegacyStep<string, any, any, StepExecutionContext<any, WorkflowContext<any, LegacyStep<string, any, any, any>[], Record<string, any>>>>[], string, any, any>>, Record<string, Workflow<any, Step<string, any, any, any, any, any>[], string, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>, z.ZodType<any, z.ZodTypeDef, any>>>, Record<string, MastraVector<VectorFilter>>, Record<string, MastraTTS>, IMastraLogger, Record<string, AgentNetwork>, Record<string, NewAgentNetwork>, Record<string, MCPServerBase>> | undefined;
     __registerMastra(mastra: Mastra): void;
     __registerPrimitives(p: MastraPrimitives): void;
-    setStepFlow(stepFlow: StepFlowEntry[]): void;
+    setStepFlow(stepFlow: StepFlowEntry<TEngineType>[]): void;
     /**
      * Adds a step to the workflow
      * @param step The step to add to the workflow
@@ -1577,13 +1581,13 @@ declare class Workflow<TEngineType = any, TSteps extends Step<string, any, any,
      * @param duration The duration to sleep for
      * @returns The workflow instance for chaining
      */
-    sleep(duration: number): Workflow<TEngineType, TSteps, TWorkflowId, TInput, TOutput, TPrevSchema>;
+    sleep(duration: number | ExecuteFunction<z.infer<TPrevSchema>, number, any, any, TEngineType>): Workflow<TEngineType, TSteps, TWorkflowId, TInput, TOutput, TPrevSchema>;
     /**
      * Adds a sleep until step to the workflow
      * @param date The date to sleep until
      * @returns The workflow instance for chaining
      */
-    sleepUntil(date: Date): Workflow<TEngineType, TSteps, TWorkflowId, TInput, TOutput, TPrevSchema>;
+    sleepUntil(date: Date | ExecuteFunction<z.infer<TPrevSchema>, Date, any, any, TEngineType>): Workflow<TEngineType, TSteps, TWorkflowId, TInput, TOutput, TPrevSchema>;
     waitForEvent<TStepInputSchema extends TPrevSchema, TStepId extends string, TSchemaOut extends z.ZodType<any>>(event: string, step: Step<TStepId, TStepInputSchema, TSchemaOut, any, any, TEngineType>, opts?: {
         timeout?: number;
     }): Workflow<TEngineType, TSteps, TWorkflowId, TInput, TOutput, TSchemaOut>;
@@ -1623,7 +1627,7 @@ declare class Workflow<TEngineType = any, TSteps extends Step<string, any, any,
      * @returns A built workflow instance ready for execution
      */
     commit(): Workflow<TEngineType, TSteps, TWorkflowId, TInput, TOutput, TOutput>;
-    get stepGraph(): StepFlowEntry<DefaultEngineType>[];
+    get stepGraph(): StepFlowEntry<TEngineType>[];
     get serializedStepGraph(): SerializedStepFlowEntry[];
     /**
      * Creates a new workflow run instance
@@ -1926,6 +1930,7 @@ type MemoryConfig = {
     threads?: {
         generateTitle?: boolean | {
             model: DynamicArgument<MastraLanguageModel>;
+            instructions?: DynamicArgument<string>;
         };
     };
 };
@@ -2025,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;
@@ -2633,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.
@@ -2694,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.
@@ -3661,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;
@@ -3721,13 +3801,14 @@ declare class Agent<TAgentId extends string = string, TTools extends ToolsInput
      * @param tools
      */
     __setTools(tools: TTools): void;
-    generateTitleFromUserMessage({ message, runtimeContext, model, }: {
+    generateTitleFromUserMessage({ message, runtimeContext, model, instructions, }: {
         message: string | MessageInput;
         runtimeContext?: RuntimeContext;
         model?: DynamicArgument<MastraLanguageModel>;
+        instructions?: DynamicArgument<string>;
     }): Promise<string>;
     getMostRecentUserMessage(messages: Array<UIMessage>): UIMessage | undefined;
-    genTitle(userMessage: string | MessageInput | undefined, runtimeContext: RuntimeContext, model?: DynamicArgument<MastraLanguageModel>): Promise<string | undefined>;
+    genTitle(userMessage: string | MessageInput | undefined, runtimeContext: RuntimeContext, model?: DynamicArgument<MastraLanguageModel>, instructions?: DynamicArgument<string>): Promise<string | undefined>;
     fetchMemory({ threadId, thread: passedThread, memoryConfig, resourceId, runId, userMessages, systemMessage, messageList, }: {
         resourceId: string;
         threadId: string;
@@ -3747,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;
@@ -3761,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[];
@@ -3851,6 +3945,11 @@ declare class Agent<TAgentId extends string = string, TTools extends ToolsInput
      * @private
      */
     private resolveTitleGenerationConfig;
+    /**
+     * Resolves title generation instructions, handling both static strings and dynamic functions
+     * @private
+     */
+    private resolveTitleInstructions;
 }
 
 declare abstract class MastraStorage extends MastraBase {

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

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkLYF7XPUM_cjs = require('./chunk-LYF7XPUM.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 chunkLYF7XPUM_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] || [];