@mastra/memory 1.10.1-alpha.0 → 1.10.1-alpha.1

package/dist/index.d.ts

@@ -4,9 +4,9 @@ import { MastraMemory } from '@mastra/core/memory';
 import type { MemoryConfigInternal, SharedMemoryConfig, StorageThreadType, WorkingMemoryTemplate, MessageDeleteInput, ObservationalMemoryOptions, MemoryConfig } from '@mastra/core/memory';
 import type { InputProcessor, InputProcessorOrWorkflow, OutputProcessor, OutputProcessorOrWorkflow } from '@mastra/core/processors';
 import type { RequestContext } from '@mastra/core/request-context';
-import type { StorageListThreadsInput, StorageListThreadsOutput, StorageListMessagesInput, MemoryStorage, StorageCloneThreadInput, StorageCloneThreadOutput, ThreadCloneMetadata } from '@mastra/core/storage';
+import type { StorageListThreadsInput, StorageListThreadsOutput, StorageListMessagesInput, MemoryStorage, StorageCloneThreadInput, StorageCloneThreadOutput, ThreadCloneMetadata, ObservationalMemoryRecord } from '@mastra/core/storage';
 import type { ToolAction } from '@mastra/core/tools';
-import type { ObservationalMemoryConfig } from './processors/observational-memory/index.js';
+import type { ObservationalMemory, ObservationalMemoryConfig } from './processors/observational-memory/index.js';
 import { deepMergeWorkingMemory } from './tools/working-memory.js';
 export { ModelByInputTokens, type ModelByInputTokensConfig, } from './processors/observational-memory/model-by-input-tokens.js';
 /**
@@ -32,6 +32,9 @@ export { extractWorkingMemoryTags, extractWorkingMemoryContent, removeWorkingMem
  * and message injection.
  */
 export declare class Memory extends MastraMemory {
+    private _omEngine;
+    /** The shared ObservationalMemory engine. Lazily created on first access. */
+    get omEngine(): Promise<ObservationalMemory | null>;
     constructor(config?: MemoryConstructorConfig);
     /**
      * Gets the memory storage domain, throwing if not available.
@@ -172,6 +175,50 @@ export declare class Memory extends MastraMemory {
         resourceId?: string;
         memoryConfig?: MemoryConfigInternal;
     }): Promise<string | null>;
+    /**
+     * Get everything needed for an LLM call in one shot.
+     *
+     * Assembles the system message (observations + working memory), loads
+     * unobserved messages from storage, and returns them ready to use.
+     *
+     * @example
+     * ```ts
+     * const ctx = await memory.getContext({ threadId });
+     * const result = await generateText({
+     *   model: openai('gpt-4o'),
+     *   system: ctx.systemMessage,
+     *   messages: ctx.messages.map(toAiSdkMessage),
+     * });
+     * ```
+     */
+    getContext(opts: {
+        threadId: string;
+        resourceId?: string;
+        memoryConfig?: MemoryConfigInternal;
+    }): Promise<{
+        /** Fully-formed system message (observations + instructions + working memory), or undefined if none. */
+        systemMessage: string | undefined;
+        /** Messages for the LLM — unobserved messages if OM is active, or recent messages from history. */
+        messages: MastraDBMessage[];
+        /** Whether observations exist for this thread. */
+        hasObservations: boolean;
+        /** The OM record, if OM is active. */
+        omRecord: ObservationalMemoryRecord | null;
+        /** The om-continuation reminder message, if OM has observations. Caller decides where to place it. */
+        continuationMessage: MastraDBMessage | undefined;
+        /** Formatted context blocks from other threads (resource scope only). */
+        otherThreadsContext: string | undefined;
+    }>;
+    /**
+     * Raw message upsert — persist messages to storage without embedding or working memory processing.
+     * Used by the processor to save sealed messages before firing a background buffer operation.
+     */
+    persistMessages(messages: MastraDBMessage[]): Promise<void>;
+    /**
+     * One-time initialization of the shared ObservationalMemory engine.
+     * Called lazily by the `omEngine` getter on first access.
+     */
+    private _initOMEngine;
     defaultWorkingMemoryTemplate: string;
     protected getWorkingMemoryToolInstruction({ template, data, }: {
         template: WorkingMemoryTemplate;
@@ -381,9 +428,9 @@ export declare class Memory extends MastraMemory {
      */
     getOutputProcessors(configuredProcessors?: OutputProcessorOrWorkflow[], context?: RequestContext): Promise<OutputProcessor[]>;
     /**
-     * Creates an ObservationalMemory processor instance if configured and not already present.
-     * A new instance is created per call — processorStates (e.g., sealedIds) are shared
-     * via the ProcessorRunner's state map keyed by processor ID, not by instance identity.
+     * Creates an ObservationalMemory processor wrapping the shared engine.
+     * Returns null if OM is not configured, not supported, or already present
+     * in the user's configured processors.
      */
     private createOMProcessor;
 }

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,7 +1,7 @@
 import { __commonJS, require_token_error, __toESM } from './chunk-SVPZMV27.js';
 import { __commonJS as __commonJS$1, require_token_error as require_token_error$1, __toESM as __toESM$1 } from './chunk-RC6RZVYE.js';
-import { truncateStringByTokens, resolveToolResultValue, formatToolResultForObserver } from './chunk-K2NLYL2O.js';
-export { ModelByInputTokens, getObservationsAsOf } from './chunk-K2NLYL2O.js';
+import { truncateStringByTokens, resolveToolResultValue, formatToolResultForObserver } from './chunk-2QSOQQPM.js';
+export { ModelByInputTokens, getObservationsAsOf } from './chunk-2QSOQQPM.js';
 import { ZodFirstPartyTypeKind } from 'zod/v3';
 import { z } from 'zod';
 import * as z4 from 'zod/v4';
@@ -16070,6 +16070,14 @@ var DEFAULT_MESSAGE_RANGE = { before: 1, after: 1 };
 var DEFAULT_TOP_K = 4;
 var VECTOR_DELETE_BATCH_SIZE = 100;
 var Memory = class extends MastraMemory {
+  _omEngine;
+  /** The shared ObservationalMemory engine. Lazily created on first access. */
+  get omEngine() {
+    if (!this._omEngine) {
+      this._omEngine = this._initOMEngine();
+    }
+    return this._omEngine;
+  }
   constructor(config = {}) {
     super({ name: "Memory", ...config });
     const mergedConfig = this.getMergedThreadConfig({
@@ -16710,6 +16718,179 @@ ${workingMemory}`;
       data: workingMemoryData
     });
   }
+  /**
+   * Get everything needed for an LLM call in one shot.
+   *
+   * Assembles the system message (observations + working memory), loads
+   * unobserved messages from storage, and returns them ready to use.
+   *
+   * @example
+   * ```ts
+   * const ctx = await memory.getContext({ threadId });
+   * const result = await generateText({
+   *   model: openai('gpt-4o'),
+   *   system: ctx.systemMessage,
+   *   messages: ctx.messages.map(toAiSdkMessage),
+   * });
+   * ```
+   */
+  async getContext(opts) {
+    const { threadId, resourceId, memoryConfig } = opts;
+    const config = this.getMergedThreadConfig(memoryConfig);
+    const memoryStore = await this.getMemoryStore();
+    const systemParts = [];
+    let hasObservations = false;
+    let omRecord = null;
+    let continuationMessage;
+    let otherThreadsContext;
+    const omEngine = await this.omEngine;
+    if (omEngine) {
+      omRecord = await omEngine.getRecord(threadId, resourceId);
+      if (omRecord?.activeObservations) {
+        hasObservations = true;
+        if (omEngine.scope === "resource" && resourceId) {
+          otherThreadsContext = await omEngine.getOtherThreadsContext(resourceId, threadId);
+        }
+        const obsSystemMessage = await omEngine.buildContextSystemMessage({
+          threadId,
+          resourceId,
+          record: omRecord,
+          unobservedContextBlocks: otherThreadsContext
+        });
+        if (obsSystemMessage) {
+          systemParts.push(obsSystemMessage);
+        }
+        const { OBSERVATION_CONTINUATION_HINT } = await import('./constants-BDOITAO3.js');
+        continuationMessage = {
+          id: "om-continuation",
+          role: "user",
+          createdAt: /* @__PURE__ */ new Date(0),
+          content: {
+            format: 2,
+            parts: [
+              {
+                type: "text",
+                text: `<system-reminder>${OBSERVATION_CONTINUATION_HINT}</system-reminder>`
+              }
+            ]
+          },
+          threadId,
+          resourceId
+        };
+      }
+    }
+    const workingMemoryMessage = await this.getSystemMessage({ threadId, resourceId, memoryConfig: config });
+    if (workingMemoryMessage) {
+      systemParts.push(workingMemoryMessage);
+    }
+    let messages;
+    if (omEngine && omRecord) {
+      const dateFilter = omRecord.lastObservedAt ? { dateRange: { start: new Date(new Date(omRecord.lastObservedAt).getTime() + 1) } } : void 0;
+      if (omEngine.scope === "resource" && resourceId) {
+        const result = await memoryStore.listMessagesByResourceId({
+          resourceId,
+          orderBy: { field: "createdAt", direction: "ASC" },
+          perPage: false,
+          filter: dateFilter
+        });
+        messages = result.messages;
+      } else {
+        const result = await memoryStore.listMessages({
+          threadId,
+          orderBy: { field: "createdAt", direction: "ASC" },
+          perPage: false,
+          filter: dateFilter
+        });
+        messages = result.messages;
+      }
+    } else {
+      const lastMessages = config.lastMessages;
+      if (lastMessages === false) {
+        messages = [];
+      } else {
+        const result = await memoryStore.listMessages({
+          threadId,
+          resourceId,
+          orderBy: { field: "createdAt", direction: "DESC" },
+          perPage: typeof lastMessages === "number" ? lastMessages : void 0
+        });
+        messages = result.messages.reverse();
+      }
+    }
+    return {
+      systemMessage: systemParts.length > 0 ? systemParts.join("\n\n") : void 0,
+      messages,
+      hasObservations,
+      omRecord,
+      continuationMessage,
+      otherThreadsContext
+    };
+  }
+  /**
+   * Raw message upsert — persist messages to storage without embedding or working memory processing.
+   * Used by the processor to save sealed messages before firing a background buffer operation.
+   */
+  async persistMessages(messages) {
+    if (messages.length === 0) return;
+    const memoryStore = await this.getMemoryStore();
+    await memoryStore.saveMessages({ messages });
+  }
+  /**
+   * One-time initialization of the shared ObservationalMemory engine.
+   * Called lazily by the `omEngine` getter on first access.
+   */
+  async _initOMEngine() {
+    const omConfig = normalizeObservationalMemoryConfig(this.threadConfig.observationalMemory);
+    if (!omConfig) return null;
+    const memoryStore = await this.storage.getStore("memory");
+    if (!memoryStore || !memoryStore.supportsObservationalMemory) return null;
+    const coreSupportsOM = coreFeatures.has("observationalMemory");
+    if (!coreSupportsOM) {
+      throw new Error(
+        "Observational memory is enabled but the installed version of @mastra/core does not support it. Please upgrade @mastra/core to a version that includes observational memory support."
+      );
+    }
+    if (omConfig.observation?.bufferTokens !== false && !coreFeatures.has("asyncBuffering")) {
+      throw new Error(
+        "Observational memory async buffering is enabled by default but the installed version of @mastra/core does not support it. Either upgrade @mastra/core, @mastra/memory, and your storage adapter (@mastra/libsql, @mastra/pg, or @mastra/mongodb) to the latest version, or explicitly disable async buffering by setting `observation: { bufferTokens: false }` in your observationalMemory config."
+      );
+    }
+    if (!coreFeatures.has("request-response-id-rotation")) {
+      throw new Error(
+        "Observational memory requires @mastra/core support for request-response-id-rotation. Please bump @mastra/core to a newer version."
+      );
+    }
+    const { ObservationalMemory: OMClass } = await import('./observational-memory-WMCWT577.js');
+    return new OMClass({
+      storage: memoryStore,
+      scope: omConfig.scope,
+      retrieval: omConfig.retrieval,
+      shareTokenBudget: omConfig.shareTokenBudget,
+      model: omConfig.model,
+      observation: omConfig.observation ? {
+        model: omConfig.observation.model,
+        messageTokens: omConfig.observation.messageTokens,
+        modelSettings: omConfig.observation.modelSettings,
+        maxTokensPerBatch: omConfig.observation.maxTokensPerBatch,
+        providerOptions: omConfig.observation.providerOptions,
+        bufferTokens: omConfig.observation.bufferTokens,
+        bufferActivation: omConfig.observation.bufferActivation,
+        blockAfter: omConfig.observation.blockAfter,
+        previousObserverTokens: omConfig.observation.previousObserverTokens,
+        instruction: omConfig.observation.instruction,
+        threadTitle: omConfig.observation.threadTitle
+      } : void 0,
+      reflection: omConfig.reflection ? {
+        model: omConfig.reflection.model,
+        observationTokens: omConfig.reflection.observationTokens,
+        modelSettings: omConfig.reflection.modelSettings,
+        providerOptions: omConfig.reflection.providerOptions,
+        bufferActivation: omConfig.reflection.bufferActivation,
+        blockAfter: omConfig.reflection.blockAfter,
+        instruction: omConfig.reflection.instruction
+      } : void 0
+    });
+  }
   defaultWorkingMemoryTemplate = `
 # User Information
 - **First Name**: 
@@ -17371,81 +17552,29 @@ Notes:
     return processors;
   }
   /**
-   * Creates an ObservationalMemory processor instance if configured and not already present.
-   * A new instance is created per call — processorStates (e.g., sealedIds) are shared
-   * via the ProcessorRunner's state map keyed by processor ID, not by instance identity.
+   * Creates an ObservationalMemory processor wrapping the shared engine.
+   * Returns null if OM is not configured, not supported, or already present
+   * in the user's configured processors.
    */
   async createOMProcessor(configuredProcessors = [], context2) {
     const hasObservationalMemory = configuredProcessors.some(
       (p) => !("workflow" in p) && p.id === "observational-memory"
     );
-    const memoryContext = context2?.get("MastraMemory");
-    const runtimeMemoryConfig = memoryContext?.memoryConfig;
-    const effectiveConfig = runtimeMemoryConfig ? this.getMergedThreadConfig({
-      ...runtimeMemoryConfig,
-      observationalMemory: runtimeMemoryConfig.observationalMemory
+    if (hasObservationalMemory) return null;
+    const runtimeMemory = context2?.get("MastraMemory");
+    const runtimeObservationalMemory = normalizeObservationalMemoryConfig(
+      runtimeMemory?.memoryConfig?.observationalMemory
+    );
+    const threadConfig = runtimeObservationalMemory ? this.getMergedThreadConfig({
+      ...runtimeMemory?.memoryConfig,
+      observationalMemory: runtimeObservationalMemory
     }) : this.threadConfig;
-    const omConfig = normalizeObservationalMemoryConfig(effectiveConfig.observationalMemory);
-    if (!omConfig || hasObservationalMemory) {
-      return null;
-    }
-    const coreSupportsOM = coreFeatures.has("observationalMemory");
-    if (!coreSupportsOM) {
-      throw new Error(
-        "Observational memory is enabled but the installed version of @mastra/core does not support it. Please upgrade @mastra/core to a version that includes observational memory support."
-      );
-    }
-    const memoryStore = await this.storage.getStore("memory");
-    if (!memoryStore) {
-      throw new Error(
-        "Using Mastra Memory observational memory requires a storage adapter but no attached adapter was detected."
-      );
-    }
-    if (!memoryStore.supportsObservationalMemory) {
-      throw new Error(
-        `Observational memory is enabled but the storage adapter (${memoryStore.constructor.name}) does not support it. If you're using @mastra/libsql, @mastra/pg, or @mastra/mongodb, upgrade to the latest version. Otherwise, use one of those adapters or disable observational memory.`
-      );
-    }
-    if (omConfig.observation?.bufferTokens !== false && !coreFeatures.has("asyncBuffering")) {
-      throw new Error(
-        "Observational memory async buffering is enabled by default but the installed version of @mastra/core does not support it. Either upgrade @mastra/core, @mastra/memory, and your storage adapter (@mastra/libsql, @mastra/pg, or @mastra/mongodb) to the latest version, or explicitly disable async buffering by setting `observation: { bufferTokens: false }` in your observationalMemory config."
-      );
-    }
-    if (!coreFeatures.has("request-response-id-rotation")) {
-      throw new Error(
-        "Observational memory requires @mastra/core support for request-response-id-rotation. Please bump @mastra/core to a newer version."
-      );
-    }
-    const { ObservationalMemory } = await import('./observational-memory-NMQ7URIP.js');
-    return new ObservationalMemory({
-      storage: memoryStore,
-      scope: omConfig.scope,
-      retrieval: omConfig.retrieval,
-      shareTokenBudget: omConfig.shareTokenBudget,
-      model: omConfig.model,
-      observation: omConfig.observation ? {
-        model: omConfig.observation.model,
-        messageTokens: omConfig.observation.messageTokens,
-        modelSettings: omConfig.observation.modelSettings,
-        maxTokensPerBatch: omConfig.observation.maxTokensPerBatch,
-        providerOptions: omConfig.observation.providerOptions,
-        bufferTokens: omConfig.observation.bufferTokens,
-        bufferActivation: omConfig.observation.bufferActivation,
-        blockAfter: omConfig.observation.blockAfter,
-        previousObserverTokens: omConfig.observation.previousObserverTokens,
-        instruction: omConfig.observation.instruction,
-        threadTitle: omConfig.observation.threadTitle
-      } : void 0,
-      reflection: omConfig.reflection ? {
-        model: omConfig.reflection.model,
-        observationTokens: omConfig.reflection.observationTokens,
-        modelSettings: omConfig.reflection.modelSettings,
-        providerOptions: omConfig.reflection.providerOptions,
-        bufferActivation: omConfig.reflection.bufferActivation,
-        blockAfter: omConfig.reflection.blockAfter,
-        instruction: omConfig.reflection.instruction
-      } : void 0
-    });
+    const effectiveConfig = normalizeObservationalMemoryConfig(threadConfig.observationalMemory);
+    if (!effectiveConfig) return null;
+    const engine = await this.omEngine;
+    if (!engine) return null;
+    const { ObservationalMemoryProcessor } = await import('./observational-memory-WMCWT577.js');
+    return new ObservationalMemoryProcessor(engine, this);
   }
 };