@mastra/memory 1.14.0 → 1.15.0-alpha.0

package/dist/index.js

@@ -15426,10 +15426,16 @@ var DefaultEmbedManyResult3 = class {
 };
 createIdGenerator3({ prefix: "aiobj", size: 24 });
 createIdGenerator3({ prefix: "aiobj", size: 24 });
+function getMessageParts(msg) {
+  if (typeof msg.content === "string") return [];
+  if (Array.isArray(msg.content)) return msg.content;
+  const parts = msg.content?.parts;
+  return Array.isArray(parts) ? parts : [];
+}
 function hasVisibleParts(msg) {
   if (typeof msg.content === "string") return msg.content.length > 0;
-  const parts = msg.content?.parts;
-  if (!parts || !Array.isArray(parts)) return false;
+  const parts = getMessageParts(msg);
+  if (parts.length === 0) return Boolean(msg.content?.content);
   return parts.some((p) => !p.type?.startsWith("data-"));
 }
 function parseRangeFormat(cursor) {
@@ -15690,13 +15696,13 @@ function lowDetailPartLimit(type) {
   if (type === "tool-result" || type === "tool-call") return AUTO_EXPAND_TOOL_TOKENS;
   return LOW_DETAIL_PART_TOKENS;
 }
-function makePart(msg, partIndex, type, fullText, detail) {
+function makePart(msg, partIndex, type, fullText, detail, toolName) {
   if (detail === "high") {
-    return { messageId: msg.id, partIndex, role: msg.role, type, text: fullText, fullText };
+    return { messageId: msg.id, partIndex, role: msg.role, type, text: fullText, fullText, toolName };
   }
   const hint = `recall cursor="${msg.id}" partIndex=${partIndex} detail="high"`;
   const { text: text4 } = truncateByTokens(fullText, lowDetailPartLimit(type), hint);
-  return { messageId: msg.id, partIndex, role: msg.role, type, text: text4, fullText };
+  return { messageId: msg.id, partIndex, role: msg.role, type, text: text4, fullText, toolName };
 }
 function formatMessageParts(msg, detail) {
   const parts = [];
@@ -15704,32 +15710,73 @@ function formatMessageParts(msg, detail) {
     parts.push(makePart(msg, 0, "text", msg.content, detail));
     return parts;
   }
-  if (msg.content?.parts && Array.isArray(msg.content.parts)) {
-    for (let i = 0; i < msg.content.parts.length; i++) {
-      const part = msg.content.parts[i];
+  const messageParts = getMessageParts(msg);
+  if (messageParts.length > 0) {
+    for (let i = 0; i < messageParts.length; i++) {
+      const part = messageParts[i];
       const partType = part.type;
       if (partType === "text") {
         const text4 = part.text;
-        parts.push(makePart(msg, i, "text", text4, detail));
+        if (text4) {
+          parts.push(makePart(msg, i, "text", text4, detail));
+        }
       } else if (partType === "tool-invocation") {
         const inv = part.toolInvocation;
-        if (inv.state === "result") {
-          const { value: resultValue } = resolveToolResultValue(
-            part,
-            inv.result
-          );
-          const resultStr = formatToolResultForObserver(resultValue, { maxTokens: HIGH_DETAIL_TOOL_RESULT_TOKENS });
-          const fullText = `[Tool Result: ${inv.toolName}]
-${resultStr}`;
-          parts.push(makePart(msg, i, "tool-result", fullText, detail));
-        } else {
-          const argsStr = detail === "low" ? "" : `
+        if (inv?.toolName) {
+          const hasArgs = inv.args != null;
+          if (inv.state !== "partial-call" && hasArgs) {
+            const argsStr = detail === "low" ? "" : `
 ${JSON.stringify(inv.args, null, 2)}`;
-          const fullText = `[Tool Call: ${inv.toolName}]${argsStr}`;
-          parts.push({ messageId: msg.id, partIndex: i, role: msg.role, type: "tool-call", text: fullText, fullText });
+            const fullText = `[Tool Call: ${inv.toolName}]${argsStr}`;
+            parts.push({
+              messageId: msg.id,
+              partIndex: i,
+              role: msg.role,
+              type: "tool-call",
+              text: fullText,
+              fullText,
+              toolName: inv.toolName
+            });
+          }
+          if (inv.state === "result") {
+            const { value: resultValue } = resolveToolResultValue(
+              part,
+              inv.result
+            );
+            const resultStr = formatToolResultForObserver(resultValue, { maxTokens: HIGH_DETAIL_TOOL_RESULT_TOKENS });
+            const fullText = `[Tool Result: ${inv.toolName}]
+${resultStr}`;
+            parts.push(makePart(msg, i, "tool-result", fullText, detail, inv.toolName));
+          }
+        }
+      } else if (partType === "tool-call") {
+        const toolName = part.toolName;
+        if (toolName) {
+          const rawArgs = part.input ?? part.args;
+          const argsStr = detail === "low" || rawArgs == null ? "" : `
+${typeof rawArgs === "string" ? rawArgs : JSON.stringify(rawArgs, null, 2)}`;
+          const fullText = `[Tool Call: ${toolName}]${argsStr}`;
+          parts.push({
+            messageId: msg.id,
+            partIndex: i,
+            role: msg.role,
+            type: "tool-call",
+            text: fullText,
+            fullText,
+            toolName
+          });
+        }
+      } else if (partType === "tool-result") {
+        const toolName = part.toolName;
+        if (toolName) {
+          const rawResult = part.output ?? part.result;
+          const resultStr = formatToolResultForObserver(rawResult, { maxTokens: HIGH_DETAIL_TOOL_RESULT_TOKENS });
+          const fullText = `[Tool Result: ${toolName}]
+${resultStr}`;
+          parts.push(makePart(msg, i, "tool-result", fullText, detail, toolName));
         }
       } else if (partType === "reasoning") {
-        const reasoning = part.reasoning;
+        const reasoning = part.reasoning ?? part.text;
         if (reasoning) {
           parts.push(makePart(msg, i, "reasoning", reasoning, detail));
         }
@@ -15867,7 +15914,7 @@ async function recallPart({
       `Message ${cursor} has no visible content (it may be an internal system message). Try a neighboring message ID instead.`
     );
   }
-  const target = allParts.find((p) => p.partIndex === partIndex);
+  const target = [...allParts].reverse().find((p) => p.partIndex === partIndex);
   if (!target) {
     const availableIndices = allParts.map((p) => p.partIndex).join(", ");
     const highestVisiblePartIndex = Math.max(...allParts.map((p) => p.partIndex));
@@ -15920,6 +15967,8 @@ async function recallMessages({
   page = 1,
   limit = 20,
   detail = "low",
+  partType,
+  toolName,
   threadScope,
   maxTokens = DEFAULT_MAX_RESULT_TOKENS
 }) {
@@ -16009,12 +16058,18 @@ async function recallMessages({
   }
   const hasNextPage = isForward ? hasMore : pageIndex > 0;
   const hasPrevPage = isForward ? pageIndex > 0 : hasMore;
-  const allParts = [];
+  let allParts = [];
   const timestamps = /* @__PURE__ */ new Map();
   for (const msg of messages) {
     timestamps.set(msg.id, msg.createdAt);
     allParts.push(...formatMessageParts(msg, detail));
   }
+  if (toolName) {
+    allParts = allParts.filter((p) => (p.type === "tool-call" || p.type === "tool-result") && p.toolName === toolName);
+  }
+  if (partType) {
+    allParts = allParts.filter((p) => p.type === partType);
+  }
   if (detail === "high" && allParts.length > 0) {
     const firstPart = allParts[0];
     const sameMsgParts = allParts.filter((p) => p.messageId === firstPart.messageId);
@@ -16051,8 +16106,9 @@ High detail returns 1 part at a time. To continue: ${hints.join(", or ")}.`;
     };
   }
   const rendered = renderFormattedParts(allParts, timestamps, { maxTokens });
+  const emptyMessage = allParts.length === 0 ? partType || toolName ? "(no message parts matched the current filters)" : "(no visible message parts found for this page)" : "(no messages found)";
   return {
-    messages: rendered.text,
+    messages: rendered.text || emptyMessage,
     count: messages.length,
     cursor,
     page: normalizedPage,
@@ -16071,6 +16127,9 @@ async function recallThreadFromStart({
   page = 1,
   limit = 20,
   detail = "low",
+  partType,
+  toolName,
+  anchor = "start",
   maxTokens = DEFAULT_MAX_RESULT_TOKENS
 }) {
   if (!memory) {
@@ -16096,29 +16155,37 @@ async function recallThreadFromStart({
     resourceId,
     page: 0,
     perPage: fetchCount,
-    orderBy: { field: "createdAt", direction: "ASC" }
+    orderBy: { field: "createdAt", direction: anchor === "end" ? "DESC" : "ASC" }
   });
-  const visibleMessages = result.messages.filter(hasVisibleParts);
-  const total = visibleMessages.length;
+  const visibleMessages = anchor === "end" ? result.messages.slice(0, fetchCount).filter(hasVisibleParts).reverse() : result.messages.slice(0, fetchCount).filter(hasVisibleParts);
   const skip = pageIndex * normalizedLimit;
-  const hasMore = total > skip + normalizedLimit;
   const messages = visibleMessages.slice(skip, skip + normalizedLimit);
-  const allParts = [];
+  const hasExtraMessage = visibleMessages.length > skip + messages.length;
+  const hasNextPage = messages.length > 0 ? anchor === "end" ? pageIndex > 0 : hasExtraMessage : false;
+  const hasPrevPage = messages.length > 0 ? anchor === "end" ? hasExtraMessage : pageIndex > 0 : pageIndex > 0;
+  let allParts = [];
   const timestamps = /* @__PURE__ */ new Map();
   for (const msg of messages) {
     timestamps.set(msg.id, msg.createdAt);
     allParts.push(...formatMessageParts(msg, detail));
   }
+  if (toolName) {
+    allParts = allParts.filter((p) => (p.type === "tool-call" || p.type === "tool-result") && p.toolName === toolName);
+  }
+  if (partType) {
+    allParts = allParts.filter((p) => p.type === partType);
+  }
   const rendered = renderFormattedParts(allParts, timestamps, { maxTokens });
+  const emptyMessage = messages.length === 0 ? pageIndex > 0 ? `(no messages found on page ${normalizedPage} for this thread)` : "(no messages in this thread)" : partType || toolName ? "(no message parts matched the current filters)" : "(no messages found)";
   return {
-    messages: rendered.text || "(no messages in this thread)",
+    messages: rendered.text || emptyMessage,
     count: messages.length,
     cursor: messages[0]?.id || "",
     page: normalizedPage,
     limit: normalizedLimit,
     detail,
-    hasNextPage: hasMore,
-    hasPrevPage: pageIndex > 0,
+    hasNextPage,
+    hasPrevPage,
     truncated: rendered.truncated,
     tokenOffset: rendered.tokenOffset
   };
@@ -16135,7 +16202,9 @@ var recallTool = (_memoryConfig, options) => {
         mode: z.enum(["messages", "threads", "search"]).optional().describe(
           'What to retrieve. "messages" (default) pages through message history. "threads" lists all threads for the current user. "search" finds messages by semantic similarity across all threads.'
         ),
-        threadId: z.string().min(1).optional().describe('Browse a different thread. Use mode="threads" first to discover thread IDs.'),
+        threadId: z.string().min(1).optional().describe(
+          'Browse a different thread, or use "current" for the active thread. Use mode="threads" first to discover thread IDs.'
+        ),
         before: z.string().optional().describe(
           'For mode="threads": only show threads created before this date. ISO 8601 or natural date string (e.g. "2026-03-15", "2026-03-10T00:00:00Z").'
         ),
@@ -16151,6 +16220,9 @@ var recallTool = (_memoryConfig, options) => {
       cursor: z.string().min(1).optional().describe(
         'A message ID to use as the pagination cursor. For mode="messages", provide either cursor or threadId. If only cursor is provided, it must belong to the current thread. Extract it from the start or end of an observation group range.'
       ),
+      anchor: z.enum(["start", "end"]).optional().describe(
+        'For mode="messages" without a cursor, page from the start (oldest-first) or end (newest-first) of the thread. Defaults to "start".'
+      ),
       page: z.number().int().min(-50).max(50).optional().describe(
         "Pagination offset. For messages: positive pages move forward from cursor, negative move backward. For threads: page number (0-indexed). 0 is treated as 1 for messages."
       ),
@@ -16158,6 +16230,10 @@ var recallTool = (_memoryConfig, options) => {
       detail: z.enum(["low", "high"]).optional().describe(
         'Detail level for messages. "low" (default) returns truncated text and tool names. "high" returns full content with tool args/results.'
       ),
+      partType: z.enum(["text", "tool-call", "tool-result", "reasoning", "image", "file"]).optional().describe('Filter results to only include parts of this type. Only applies to mode="messages".'),
+      toolName: z.string().min(1).optional().describe(
+        'Filter results to only include tool-call and tool-result parts matching this tool name. Only applies to mode="messages".'
+      ),
       partIndex: z.number().int().min(0).optional().describe(
         "Fetch a single part from the cursor message by its positional index. When provided, returns only that part at high detail. Indices are shown as [p0], [p1], etc. in recall results."
       )
@@ -16167,9 +16243,12 @@ var recallTool = (_memoryConfig, options) => {
       query,
       cursor,
       threadId: explicitThreadId,
+      anchor,
       page,
       limit,
       detail,
+      partType,
+      toolName,
       partIndex,
       before,
       after
@@ -16177,9 +16256,13 @@ var recallTool = (_memoryConfig, options) => {
       const memory = context2?.memory;
       const currentThreadId = context2?.agent?.threadId;
       const resourceId = context2?.agent?.resourceId;
+      const resolvedExplicitThreadId = explicitThreadId === "current" ? currentThreadId : explicitThreadId;
       if (!memory) {
         throw new Error("Memory instance is required for recall");
       }
+      if (explicitThreadId === "current" && !currentThreadId) {
+        throw new Error("Could not resolve current thread.");
+      }
       if (mode === "search") {
         if (!query) {
           throw new Error('query is required for mode="search"');
@@ -16195,11 +16278,12 @@ var recallTool = (_memoryConfig, options) => {
           topK: limit ?? 10,
           before,
           after,
-          threadScope: !isResourceScope ? currentThreadId || void 0 : void 0
+          threadScope: !isResourceScope ? currentThreadId || void 0 : resolvedExplicitThreadId || void 0
         });
       }
       if (mode === "threads") {
-        if (!isResourceScope) {
+        const requestedCurrentThread = explicitThreadId === "current";
+        if (!isResourceScope || requestedCurrentThread) {
           if (!currentThreadId || !memory.getThreadById) {
             return { error: "Could not resolve current thread." };
           }
@@ -16207,6 +16291,9 @@ var recallTool = (_memoryConfig, options) => {
           if (!thread) {
             return { error: "Could not resolve current thread." };
           }
+          if (isResourceScope && resourceId && thread.resourceId !== resourceId) {
+            throw new Error("Thread does not belong to the active resource");
+          }
           return {
             threads: `- **${thread.title || "(untitled)"}** \u2190 current
   id: ${thread.id}
@@ -16229,7 +16316,7 @@ var recallTool = (_memoryConfig, options) => {
           after
         });
       }
-      const hasExplicitThreadId = typeof explicitThreadId === "string" && explicitThreadId.length > 0;
+      const hasExplicitThreadId = typeof resolvedExplicitThreadId === "string" && resolvedExplicitThreadId.length > 0;
       const hasCursor = typeof cursor === "string" && cursor.length > 0;
       if (!hasExplicitThreadId && !hasCursor) {
         throw new Error('Either cursor or threadId is required for mode="messages"');
@@ -16246,7 +16333,7 @@ var recallTool = (_memoryConfig, options) => {
         if (!memory.getThreadById) {
           throw new Error("Memory instance cannot verify thread access for recall");
         }
-        const thread = await memory.getThreadById({ threadId: explicitThreadId });
+        const thread = await memory.getThreadById({ threadId: resolvedExplicitThreadId });
         if (!thread || thread.resourceId !== resourceId) {
           throw new Error("Thread does not belong to the active resource");
         }
@@ -16287,7 +16374,10 @@ var recallTool = (_memoryConfig, options) => {
           resourceId: isResourceScope ? resourceId : void 0,
           page: page ?? 1,
           limit: limit ?? 20,
-          detail: detail ?? "low"
+          detail: detail ?? "low",
+          partType,
+          toolName,
+          anchor: anchor ?? "start"
         });
       }
       if (partIndex !== void 0 && partIndex !== null) {
@@ -16308,6 +16398,8 @@ var recallTool = (_memoryConfig, options) => {
         page,
         limit,
         detail: detail ?? "low",
+        partType,
+        toolName,
         threadScope
       });
     }