@mastra/memory 1.11.1-alpha.0 → 1.12.0

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-2NZR2XHO.js';
-export { ModelByInputTokens, getObservationsAsOf } from './chunk-2NZR2XHO.js';
+import { truncateStringByTokens, resolveToolResultValue, formatToolResultForObserver } from './chunk-DDQHE4NV.js';
+export { ModelByInputTokens, getObservationsAsOf } from './chunk-DDQHE4NV.js';
 import { ZodFirstPartyTypeKind } from 'zod/v3';
 import { z } from 'zod';
 import * as z4 from 'zod/v4';
@@ -15465,18 +15465,54 @@ async function resolveCursorMessage(memory, cursor, access) {
   }
   const memoryStore = await memory.getMemoryStore();
   const result = await memoryStore.listMessagesById({ messageIds: [normalized] });
-  const message = result.messages.find((message2) => message2.id === normalized);
+  let message = result.messages.find((message2) => message2.id === normalized) ?? null;
+  if (!message) {
+    message = await resolveCursorMessageByRecall(memory, normalized, access);
+  }
   if (!message) {
     throw new Error(`Could not resolve cursor message: ${cursor}`);
   }
   if (access?.resourceId && message.resourceId !== access.resourceId) {
     throw new Error(`Could not resolve cursor message: ${cursor}`);
   }
-  if (access?.threadScope && message.threadId !== access.threadScope) {
+  if (access?.enforceThreadScope && access.threadScope && message.threadId !== access.threadScope) {
     throw new Error(`Could not resolve cursor message: ${cursor}`);
   }
   return message;
 }
+async function resolveCursorMessageByRecall(memory, cursor, access) {
+  if (access?.enforceThreadScope && access.threadScope) {
+    const result = await memory.recall({
+      threadId: access.threadScope,
+      resourceId: access.resourceId,
+      page: 0,
+      perPage: false
+    });
+    return result.messages.find((message) => message.id === cursor) ?? null;
+  }
+  if (!access?.resourceId) {
+    return null;
+  }
+  const threads = await memory.listThreads({
+    page: 0,
+    perPage: 100,
+    orderBy: { field: "updatedAt", direction: "DESC" },
+    filter: { resourceId: access.resourceId }
+  });
+  for (const thread of threads.threads) {
+    const result = await memory.recall({
+      threadId: thread.id,
+      resourceId: access.resourceId,
+      page: 0,
+      perPage: false
+    });
+    const message = result.messages.find((message2) => message2.id === cursor);
+    if (message) {
+      return message;
+    }
+  }
+  return null;
+}
 async function listThreadsForResource({
   memory,
   resourceId,
@@ -15727,6 +15763,27 @@ function buildRenderedText(parts, timestamps) {
   }
   return lines.join("\n");
 }
+async function getNextVisibleMessage({
+  memory,
+  threadId,
+  resourceId,
+  after
+}) {
+  const result = await memory.recall({
+    threadId,
+    resourceId,
+    page: 0,
+    perPage: 50,
+    orderBy: { field: "createdAt", direction: "ASC" },
+    filter: {
+      dateRange: {
+        start: after,
+        startExclusive: true
+      }
+    }
+  });
+  return result.messages.find(hasVisibleParts) ?? null;
+}
 var MAX_EXPAND_USER_TEXT_TOKENS = 200;
 var MAX_EXPAND_OTHER_TOKENS = 50;
 function expandLimit(part) {
@@ -15795,7 +15852,11 @@ async function recallPart({
   if (!threadId) {
     throw new Error("Thread ID is required for recall");
   }
-  const resolved = await resolveCursorMessage(memory, cursor, { resourceId, threadScope });
+  const resolved = await resolveCursorMessage(memory, cursor, {
+    resourceId,
+    threadScope,
+    enforceThreadScope: false
+  });
   if ("hint" in resolved) {
     throw new Error(resolved.hint);
   }
@@ -15807,9 +15868,37 @@ async function recallPart({
   }
   const target = allParts.find((p) => p.partIndex === partIndex);
   if (!target) {
-    throw new Error(
-      `Part index ${partIndex} not found in message ${cursor}. Available indices: ${allParts.map((p) => p.partIndex).join(", ")}`
-    );
+    const availableIndices = allParts.map((p) => p.partIndex).join(", ");
+    const highestVisiblePartIndex = Math.max(...allParts.map((p) => p.partIndex));
+    if (partIndex > highestVisiblePartIndex) {
+      const nextMessage = await getNextVisibleMessage({
+        memory,
+        threadId,
+        resourceId,
+        after: resolved.createdAt
+      });
+      if (nextMessage) {
+        const nextParts = formatMessageParts(nextMessage, "high");
+        const firstNextPart = nextParts[0];
+        if (firstNextPart) {
+          const fallbackNote = `Part index ${partIndex} not found in message ${cursor}; showing partIndex ${firstNextPart.partIndex} from next message ${firstNextPart.messageId}.
+
+`;
+          const fallbackText = `${fallbackNote}${firstNextPart.text}`;
+          const truncatedText2 = truncateStringByTokens(fallbackText, maxTokens);
+          const wasTruncated2 = truncatedText2 !== fallbackText;
+          return {
+            text: truncatedText2,
+            messageId: firstNextPart.messageId,
+            partIndex: firstNextPart.partIndex,
+            role: firstNextPart.role,
+            type: firstNextPart.type,
+            truncated: wasTruncated2
+          };
+        }
+      }
+    }
+    throw new Error(`Part index ${partIndex} not found in message ${cursor}. Available indices: ${availableIndices}`);
   }
   const truncatedText = truncateStringByTokens(target.text, maxTokens);
   const wasTruncated = truncatedText !== target.text;
@@ -15847,7 +15936,11 @@ async function recallMessages({
   const rawPage = page === 0 ? 1 : page;
   const normalizedPage = Math.max(Math.min(rawPage, MAX_PAGE), -MAX_PAGE);
   const normalizedLimit = Math.min(limit, MAX_LIMIT);
-  const resolved = await resolveCursorMessage(memory, cursor, { resourceId, threadScope });
+  const resolved = await resolveCursorMessage(memory, cursor, {
+    resourceId,
+    threadScope,
+    enforceThreadScope: false
+  });
   if ("hint" in resolved) {
     return {
       messages: resolved.hint,
@@ -15863,9 +15956,10 @@ async function recallMessages({
     };
   }
   const anchor = resolved;
-  if (anchor.threadId && anchor.threadId !== threadId) {
+  const crossThreadId = anchor.threadId && anchor.threadId !== threadId ? anchor.threadId : void 0;
+  if (crossThreadId && threadScope) {
     return {
-      messages: `Cursor does not belong to the active thread. Expected thread "${threadId}" but cursor "${cursor}" belongs to "${anchor.threadId}".`,
+      messages: `Cursor does not belong to the active thread. Expected thread "${threadId}" but cursor "${cursor}" belongs to "${anchor.threadId}". Pass threadId="${anchor.threadId}" to browse that thread, or omit threadId and use this cursor directly in resource scope.`,
       count: 0,
       cursor,
       page: normalizedPage,
@@ -15877,7 +15971,10 @@ async function recallMessages({
       tokenOffset: 0
     };
   }
-  const resolvedThreadId = threadId;
+  const resolvedThreadId = crossThreadId ?? threadId;
+  if (!resolvedThreadId) {
+    throw new Error("Thread ID is required for recall");
+  }
   const isForward = normalizedPage > 0;
   const pageIndex = Math.max(Math.abs(normalizedPage), 1) - 1;
   const skip = pageIndex * normalizedLimit;
@@ -16159,7 +16256,25 @@ var recallTool = (_memoryConfig, options) => {
         threadScope = currentThreadId || void 0;
       }
       if (hasCursor && !hasExplicitThreadId && !currentThreadId) {
-        throw new Error("Current thread is required when browsing by cursor");
+        if (!isResourceScope) {
+          throw new Error("Current thread is required when browsing by cursor");
+        }
+        const resolved = await resolveCursorMessage(memory, cursor, { resourceId });
+        if ("hint" in resolved) {
+          return {
+            messages: resolved.hint,
+            count: 0,
+            cursor,
+            page: page ?? 1,
+            limit: Math.min(limit ?? 20, 20),
+            detail: detail ?? "low",
+            hasNextPage: false,
+            hasPrevPage: false,
+            truncated: false,
+            tokenOffset: 0
+          };
+        }
+        targetThreadId = resolved.threadId;
       }
       if (!targetThreadId) {
         throw new Error("Thread ID is required for recall");
@@ -17226,7 +17341,7 @@ ${workingMemory}`;
         "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-SASGM6OW.js');
+    const { ObservationalMemory: OMClass } = await import('./observational-memory-B25SASRW.js');
     const onIndexObservations = this.hasRetrievalSearch(omConfig.retrieval) ? async (observation) => {
       await this.indexObservation(observation);
     } : void 0;
@@ -18114,7 +18229,7 @@ Notes:
     if (!effectiveConfig) return null;
     const engine = await this.omEngine;
     if (!engine) return null;
-    const { ObservationalMemoryProcessor } = await import('./observational-memory-SASGM6OW.js');
+    const { ObservationalMemoryProcessor } = await import('./observational-memory-B25SASRW.js');
     return new ObservationalMemoryProcessor(engine, this);
   }
 };