@mastra/memory 1.11.1-alpha.0 → 1.12.0-alpha.1

package/dist/index.cjs

@@ -2,7 +2,7 @@
 
 var chunkCK4U3AYR_cjs = require('./chunk-CK4U3AYR.cjs');
 var chunkIDRQZVB4_cjs = require('./chunk-IDRQZVB4.cjs');
-var chunkW2RTLXNQ_cjs = require('./chunk-W2RTLXNQ.cjs');
+var chunkHLGFIN4J_cjs = require('./chunk-HLGFIN4J.cjs');
 var v3 = require('zod/v3');
 var zod = require('zod');
 var z4 = require('zod/v4');
@@ -15487,18 +15487,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,
@@ -15666,7 +15702,7 @@ function formatTimestamp(date) {
 }
 function truncateByTokens(text4, maxTokens, hint) {
   if (tokenx.estimateTokenCount(text4) <= maxTokens) return { text: text4, wasTruncated: false };
-  const truncated = chunkW2RTLXNQ_cjs.truncateStringByTokens(text4, maxTokens);
+  const truncated = chunkHLGFIN4J_cjs.truncateStringByTokens(text4, maxTokens);
   const suffix = hint ? ` [${hint} for more]` : "";
   return { text: truncated + suffix, wasTruncated: true };
 }
@@ -15699,11 +15735,11 @@ function formatMessageParts(msg, detail) {
       } else if (partType === "tool-invocation") {
         const inv = part.toolInvocation;
         if (inv.state === "result") {
-          const { value: resultValue } = chunkW2RTLXNQ_cjs.resolveToolResultValue(
+          const { value: resultValue } = chunkHLGFIN4J_cjs.resolveToolResultValue(
             part,
             inv.result
           );
-          const resultStr = chunkW2RTLXNQ_cjs.formatToolResultForObserver(resultValue, { maxTokens: HIGH_DETAIL_TOOL_RESULT_TOKENS });
+          const resultStr = chunkHLGFIN4J_cjs.formatToolResultForObserver(resultValue, { maxTokens: HIGH_DETAIL_TOOL_RESULT_TOKENS });
           const fullText = `[Tool Result: ${inv.toolName}]
 ${resultStr}`;
           parts.push(makePart(msg, i, "tool-result", fullText, detail));
@@ -15749,6 +15785,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) {
@@ -15766,7 +15823,7 @@ function renderFormattedParts(parts, timestamps, options) {
   const text4 = buildRenderedText(parts, timestamps);
   let totalTokens = tokenx.estimateTokenCount(text4);
   if (totalTokens > options.maxTokens) {
-    const truncated = chunkW2RTLXNQ_cjs.truncateStringByTokens(text4, options.maxTokens);
+    const truncated = chunkHLGFIN4J_cjs.truncateStringByTokens(text4, options.maxTokens);
     return { text: truncated, truncated: true, tokenOffset: totalTokens - options.maxTokens };
   }
   const truncatedIndices = parts.map((p, i) => ({ part: p, index: i })).filter(({ part }) => part.text !== part.fullText).sort((a, b) => expandPriority(a.part) - expandPriority(b.part));
@@ -15799,7 +15856,7 @@ function renderFormattedParts(parts, timestamps, options) {
   if (expandedTokens <= options.maxTokens) {
     return { text: expanded, truncated: false, tokenOffset: 0 };
   }
-  const hardTruncated = chunkW2RTLXNQ_cjs.truncateStringByTokens(expanded, options.maxTokens);
+  const hardTruncated = chunkHLGFIN4J_cjs.truncateStringByTokens(expanded, options.maxTokens);
   return { text: hardTruncated, truncated: true, tokenOffset: expandedTokens - options.maxTokens };
 }
 async function recallPart({
@@ -15817,7 +15874,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);
   }
@@ -15829,11 +15890,39 @@ 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 = chunkHLGFIN4J_cjs.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 = chunkW2RTLXNQ_cjs.truncateStringByTokens(target.text, maxTokens);
+  const truncatedText = chunkHLGFIN4J_cjs.truncateStringByTokens(target.text, maxTokens);
   const wasTruncated = truncatedText !== target.text;
   return {
     text: truncatedText,
@@ -15869,7 +15958,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,
@@ -15885,9 +15978,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,
@@ -15899,7 +15993,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;
@@ -16181,7 +16278,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");
@@ -17248,7 +17363,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-JCPPBSVG.cjs');
+    const { ObservationalMemory: OMClass } = await import('./observational-memory-34W4S4I5.cjs');
     const onIndexObservations = this.hasRetrievalSearch(omConfig.retrieval) ? async (observation) => {
       await this.indexObservation(observation);
     } : void 0;
@@ -18136,18 +18251,18 @@ Notes:
     if (!effectiveConfig) return null;
     const engine = await this.omEngine;
     if (!engine) return null;
-    const { ObservationalMemoryProcessor } = await import('./observational-memory-JCPPBSVG.cjs');
+    const { ObservationalMemoryProcessor } = await import('./observational-memory-34W4S4I5.cjs');
     return new ObservationalMemoryProcessor(engine, this);
   }
 };
 
 Object.defineProperty(exports, "ModelByInputTokens", {
   enumerable: true,
-  get: function () { return chunkW2RTLXNQ_cjs.ModelByInputTokens; }
+  get: function () { return chunkHLGFIN4J_cjs.ModelByInputTokens; }
 });
 Object.defineProperty(exports, "getObservationsAsOf", {
   enumerable: true,
-  get: function () { return chunkW2RTLXNQ_cjs.getObservationsAsOf; }
+  get: function () { return chunkHLGFIN4J_cjs.getObservationsAsOf; }
 });
 Object.defineProperty(exports, "extractWorkingMemoryContent", {
   enumerable: true,