@anuma/sdk 6.29.2 → 6.30.0

package/dist/react/index.cjs

@@ -20021,6 +20021,11 @@ function formatEventTime(start, end, kind) {
   if (kind === "ongoing") return `, event: since ${startDate}`;
   return `, event: ${startDate}`;
 }
+function formatSavedTime(createdAt) {
+  const ms = createdAt?.getTime();
+  if (ms === void 0 || !Number.isFinite(ms) || ms <= 0) return "";
+  return `, saved: ${new Date(ms).toISOString().slice(0, 10)}`;
+}
 function generateFenceNonce() {
   const bytes = new Uint8Array(9);
   crypto.getRandomValues(bytes);
@@ -20039,8 +20044,9 @@ function formatRecallResult(memories) {
   const lines = memories.map((m, i) => {
     let body;
     if (m.kind === "fact") {
+      const savedSuffix = formatSavedTime(m.createdAt);
       const eventSuffix = formatEventTime(m.eventTimeStart, m.eventTimeEnd, m.eventTimeKind);
-      body = `[${i + 1}] fact (id: ${m.id}${eventSuffix})
+      body = `[${i + 1}] fact (id: ${m.id}${savedSuffix}${eventSuffix})
 ${m.content}`;
     } else {
       const date10 = m.createdAt.toISOString().slice(0, 10);
@@ -20090,6 +20096,40 @@ function isDumpQuery(query) {
   if (EVERYTHING_YOU_KNOW_RE.test(q)) return true;
   return false;
 }
+async function listRecentFacts(ctx, limit, toolOptions) {
+  const vaultCtx = ctx.vaultCtx;
+  if (!vaultCtx) return [];
+  const ordered = await getVaultRankingProjectionsOp(vaultCtx, {
+    ...toolOptions?.scopes && { scopes: toolOptions.scopes },
+    ...toolOptions?.memoryIds !== void 0 && { memoryIds: toolOptions.memoryIds },
+    ...toolOptions?.folderId !== void 0 && { folderId: toolOptions.folderId }
+  });
+  const readable = [];
+  for (let i = 0; i < ordered.length && readable.length < limit; i += limit) {
+    const batch = ordered.slice(i, i + limit).map((p) => p.uniqueId);
+    const byId = new Map(
+      (await getVaultMemoriesByIdsOp(vaultCtx, batch)).map((m) => [m.uniqueId, m])
+    );
+    for (const id of batch) {
+      const m = byId.get(id);
+      if (m && !isEncrypted(m.content)) readable.push(m);
+      if (readable.length >= limit) break;
+    }
+  }
+  return readable.map((m) => ({
+    id: m.uniqueId,
+    kind: "fact",
+    content: m.content,
+    score: 0,
+    folderId: m.folderId,
+    eventTimeStart: m.eventTimeStart,
+    eventTimeEnd: m.eventTimeEnd,
+    eventTimeKind: m.eventTimeKind,
+    factType: m.factType,
+    createdAt: m.createdAt,
+    updatedAt: m.updatedAt
+  }));
+}
 function createRecallTool(ctx, toolOptions, callbacks) {
   const defaultTypes = toolOptions?.types ?? ["fact", "chunk"];
   const defaultLimit = toolOptions?.limit ?? DEFAULT_LIMIT2;
@@ -20102,7 +20142,7 @@ function createRecallTool(ctx, toolOptions, callbacks) {
     type: "function",
     function: {
       name: RECALL_TOOL_NAME,
-      description: `Search the user's memory across stored facts/preferences and past conversation excerpts. Returns a unified ranked list \u2014 facts carry an \`id\` you can reference; conversation excerpts carry a date and role. Use this whenever the user's question may relate to anything previously discussed or saved (preferences, prior decisions, past topics). Phrase the query naturally. For multi-faceted / overview questions ("tell me about the user", "what's my tech stack"), prefer several targeted searches \u2014 one facet each (e.g. name, work, hobbies) \u2014 over a single broad query; fuse the results yourself.`,
+      description: 'Search the user\'s memory across stored facts/preferences and past conversation excerpts. Returns a unified ranked list \u2014 facts carry an `id` you can reference and the date they were saved; conversation excerpts carry a date and role. Use this whenever the user\'s question may relate to anything previously discussed or saved (preferences, prior decisions, past topics). Phrase the query naturally. For multi-faceted / overview questions ("tell me about the user", "what\'s my tech stack"), prefer several targeted searches \u2014 one facet each (e.g. name, work, hobbies) \u2014 over a single broad query; fuse the results yourself. For "what did I save recently / latest memories" questions, set `sort` to "recent" to get the newest saved facts, newest first, instead of a relevance search.',
       arguments: {
         type: "object",
         properties: {
@@ -20113,6 +20153,11 @@ function createRecallTool(ctx, toolOptions, callbacks) {
           limit: {
             type: "integer",
             description: `Max number of results. Default: ${defaultLimit}.`
+          },
+          sort: {
+            type: "string",
+            enum: ["relevance", "recent"],
+            description: `"relevance" (default) ranks by match to the query. "recent" returns the newest saved facts, newest first, and ignores the query's topic.`
           }
         },
         required: ["query"]
@@ -20157,35 +20202,41 @@ function createRecallTool(ctx, toolOptions, callbacks) {
       let surfaced = 0;
       try {
         let recallDegraded = [];
-        let subQueries;
-        if (defaultBudget === "high" && toolOptions?.decomposeOptions) {
-          const decomp = await decomposeQuery(query, toolOptions.decomposeOptions);
-          if (decomp.mode === "composite" && decomp.subQueries.length >= 2) {
-            subQueries = decomp.subQueries;
+        const wantsRecent = args.sort === "recent" && defaultTypes.includes("fact") && ctx.vaultCtx !== void 0;
+        let result;
+        if (wantsRecent) {
+          result = { memories: await listRecentFacts(ctx, effectiveLimit, toolOptions) };
+        } else {
+          let subQueries;
+          if (defaultBudget === "high" && toolOptions?.decomposeOptions) {
+            const decomp = await decomposeQuery(query, toolOptions.decomposeOptions);
+            if (decomp.mode === "composite" && decomp.subQueries.length >= 2) {
+              subQueries = decomp.subQueries;
+            }
           }
+          const recallOpts = {
+            onDiagnostics: (d) => {
+              recallDegraded = d.degraded;
+            },
+            types: defaultTypes,
+            limit: effectiveLimit,
+            budget: defaultBudget,
+            ...toolOptions?.minScore !== void 0 && { minScore: toolOptions.minScore },
+            ...toolOptions?.scopes && { scopes: toolOptions.scopes },
+            ...toolOptions?.memoryIds !== void 0 && { memoryIds: toolOptions.memoryIds },
+            ...toolOptions?.folderId !== void 0 && { folderId: toolOptions.folderId },
+            ...toolOptions?.excludeConversationId && {
+              excludeConversationId: toolOptions.excludeConversationId
+            },
+            // Do NOT forward decomposeOptions into recall() — rewrite already
+            // ran above, and forwarding would falsely trip `decompose-moved`
+            // on every specific-mode high-budget call. graphRefine auth can
+            // be threaded later when the tool opts into that path.
+            ...toolOptions?.now !== void 0 && { now: toolOptions.now },
+            ...subQueries && { subQueries }
+          };
+          result = await recall(query, ctx, recallOpts);
         }
-        const recallOpts = {
-          onDiagnostics: (d) => {
-            recallDegraded = d.degraded;
-          },
-          types: defaultTypes,
-          limit: effectiveLimit,
-          budget: defaultBudget,
-          ...toolOptions?.minScore !== void 0 && { minScore: toolOptions.minScore },
-          ...toolOptions?.scopes && { scopes: toolOptions.scopes },
-          ...toolOptions?.memoryIds !== void 0 && { memoryIds: toolOptions.memoryIds },
-          ...toolOptions?.folderId !== void 0 && { folderId: toolOptions.folderId },
-          ...toolOptions?.excludeConversationId && {
-            excludeConversationId: toolOptions.excludeConversationId
-          },
-          // Do NOT forward decomposeOptions into recall() — rewrite already
-          // ran above, and forwarding would falsely trip `decompose-moved`
-          // on every specific-mode high-budget call. graphRefine auth can
-          // be threaded later when the tool opts into that path.
-          ...toolOptions?.now !== void 0 && { now: toolOptions.now },
-          ...subQueries && { subQueries }
-        };
-        const result = await recall(query, ctx, recallOpts);
         if (callbacks?.onChunksRetrieved) {
           const convIds = Array.from(
             new Set(
@@ -20198,7 +20249,7 @@ function createRecallTool(ctx, toolOptions, callbacks) {
           const facts = result.memories.filter((m) => m.kind === "fact").map((m) => ({ id: m.id, score: m.score }));
           if (facts.length > 0) {
             callbacks.onFactsRetrieved?.(facts.map((f) => f.id));
-            callbacks.onFactsRanked?.(facts);
+            if (!wantsRecent) callbacks.onFactsRanked?.(facts);
           }
         }
         surfaced = result.memories.length;
@@ -21379,6 +21430,10 @@ function createMessageSourceResolver(ctx) {
 }
 
 // src/lib/memory/context.ts
+function savedAt(createdAt) {
+  const ms = createdAt?.getTime();
+  return ms !== void 0 && Number.isFinite(ms) && ms > 0 ? { createdAt } : {};
+}
 function shouldRecallMemory(query) {
   const normalized = query.trim().toLowerCase().replace(/[.!?。！？¡¿]+$/u, "").replace(/^[¡¿]+/u, "");
   return normalized.length > 0 && !/^(hi|hi there|hello|hey|yes|no|yep|nope|sure|k|ok|okay|thanks|thank you|thank you very much|thanks a lot|cool|great|got it|sounds good|hola|buenos días|buenas|sí|si|gracias|muchas gracias|vale|bonjour|salut|oui|non|merci|merci beaucoup|d'accord|hallo|guten tag|ja|nein|danke|danke schön|alles klar|olá|obrigado|obrigada|ciao|grazie|sì|你好|谢谢|好的|こんにちは|ありがとう|안녕하세요|감사합니다)$/u.test(
@@ -21416,7 +21471,8 @@ async function assembleMemoryContext(options) {
     content: m.content,
     score,
     lane,
-    sourceIds: m.sourceChunkIds ?? []
+    sourceIds: m.sourceChunkIds ?? [],
+    ...savedAt(m.createdAt)
   });
   const empty = {
     memories: [],
@@ -21481,7 +21537,8 @@ async function assembleMemoryContext(options) {
     score: m.score,
     lane,
     ...lane === "fact" && { recalled: true },
-    sourceIds: m.sourceChunkIds ?? (m.messageId ? [m.messageId] : [])
+    sourceIds: m.sourceChunkIds ?? (m.messageId ? [m.messageId] : []),
+    ...savedAt(m.createdAt)
   }));
   const recalledFacts = toItems(facts, "fact");
   const recalledScores = /* @__PURE__ */ new Map();

package/dist/react/index.d.mts

@@ -8433,6 +8433,7 @@ declare function getVaultRankingProjectionsOp(ctx: VaultMemoryOperationsContext,
     since?: Date;
     limit?: number;
     folderId?: string | null;
+    memoryIds?: string[];
 }): Promise<RankableVaultMemory[]>;
 interface VaultCandidateKey {
     uniqueId: string;
@@ -10845,6 +10846,9 @@ interface MemoryContextItem {
     sourceIds: string[];
     /** Ranked fact evidence, retained when profile deduplication wins placement. */
     recalled?: boolean;
+    /** When the memory was written — lets the prompt show a saved date so the
+     * model can answer "what did I save recently". */
+    createdAt?: Date;
 }
 interface MemoryContextOptions {
     query: string;

package/dist/react/index.d.ts

@@ -8433,6 +8433,7 @@ declare function getVaultRankingProjectionsOp(ctx: VaultMemoryOperationsContext,
     since?: Date;
     limit?: number;
     folderId?: string | null;
+    memoryIds?: string[];
 }): Promise<RankableVaultMemory[]>;
 interface VaultCandidateKey {
     uniqueId: string;
@@ -10845,6 +10846,9 @@ interface MemoryContextItem {
     sourceIds: string[];
     /** Ranked fact evidence, retained when profile deduplication wins placement. */
     recalled?: boolean;
+    /** When the memory was written — lets the prompt show a saved date so the
+     * model can answer "what did I save recently". */
+    createdAt?: Date;
 }
 interface MemoryContextOptions {
     query: string;

package/dist/react/index.mjs

@@ -18118,6 +18118,11 @@ function formatEventTime(start, end, kind) {
   if (kind === "ongoing") return `, event: since ${startDate}`;
   return `, event: ${startDate}`;
 }
+function formatSavedTime(createdAt) {
+  const ms = createdAt?.getTime();
+  if (ms === void 0 || !Number.isFinite(ms) || ms <= 0) return "";
+  return `, saved: ${new Date(ms).toISOString().slice(0, 10)}`;
+}
 function generateFenceNonce() {
   const bytes = new Uint8Array(9);
   crypto.getRandomValues(bytes);
@@ -18136,8 +18141,9 @@ function formatRecallResult(memories) {
   const lines = memories.map((m, i) => {
     let body;
     if (m.kind === "fact") {
+      const savedSuffix = formatSavedTime(m.createdAt);
       const eventSuffix = formatEventTime(m.eventTimeStart, m.eventTimeEnd, m.eventTimeKind);
-      body = `[${i + 1}] fact (id: ${m.id}${eventSuffix})
+      body = `[${i + 1}] fact (id: ${m.id}${savedSuffix}${eventSuffix})
 ${m.content}`;
     } else {
       const date10 = m.createdAt.toISOString().slice(0, 10);
@@ -18187,6 +18193,40 @@ function isDumpQuery(query) {
   if (EVERYTHING_YOU_KNOW_RE.test(q)) return true;
   return false;
 }
+async function listRecentFacts(ctx, limit, toolOptions) {
+  const vaultCtx = ctx.vaultCtx;
+  if (!vaultCtx) return [];
+  const ordered = await getVaultRankingProjectionsOp(vaultCtx, {
+    ...toolOptions?.scopes && { scopes: toolOptions.scopes },
+    ...toolOptions?.memoryIds !== void 0 && { memoryIds: toolOptions.memoryIds },
+    ...toolOptions?.folderId !== void 0 && { folderId: toolOptions.folderId }
+  });
+  const readable = [];
+  for (let i = 0; i < ordered.length && readable.length < limit; i += limit) {
+    const batch = ordered.slice(i, i + limit).map((p) => p.uniqueId);
+    const byId = new Map(
+      (await getVaultMemoriesByIdsOp(vaultCtx, batch)).map((m) => [m.uniqueId, m])
+    );
+    for (const id of batch) {
+      const m = byId.get(id);
+      if (m && !isEncrypted(m.content)) readable.push(m);
+      if (readable.length >= limit) break;
+    }
+  }
+  return readable.map((m) => ({
+    id: m.uniqueId,
+    kind: "fact",
+    content: m.content,
+    score: 0,
+    folderId: m.folderId,
+    eventTimeStart: m.eventTimeStart,
+    eventTimeEnd: m.eventTimeEnd,
+    eventTimeKind: m.eventTimeKind,
+    factType: m.factType,
+    createdAt: m.createdAt,
+    updatedAt: m.updatedAt
+  }));
+}
 function createRecallTool(ctx, toolOptions, callbacks) {
   const defaultTypes = toolOptions?.types ?? ["fact", "chunk"];
   const defaultLimit = toolOptions?.limit ?? DEFAULT_LIMIT2;
@@ -18199,7 +18239,7 @@ function createRecallTool(ctx, toolOptions, callbacks) {
     type: "function",
     function: {
       name: RECALL_TOOL_NAME,
-      description: `Search the user's memory across stored facts/preferences and past conversation excerpts. Returns a unified ranked list \u2014 facts carry an \`id\` you can reference; conversation excerpts carry a date and role. Use this whenever the user's question may relate to anything previously discussed or saved (preferences, prior decisions, past topics). Phrase the query naturally. For multi-faceted / overview questions ("tell me about the user", "what's my tech stack"), prefer several targeted searches \u2014 one facet each (e.g. name, work, hobbies) \u2014 over a single broad query; fuse the results yourself.`,
+      description: 'Search the user\'s memory across stored facts/preferences and past conversation excerpts. Returns a unified ranked list \u2014 facts carry an `id` you can reference and the date they were saved; conversation excerpts carry a date and role. Use this whenever the user\'s question may relate to anything previously discussed or saved (preferences, prior decisions, past topics). Phrase the query naturally. For multi-faceted / overview questions ("tell me about the user", "what\'s my tech stack"), prefer several targeted searches \u2014 one facet each (e.g. name, work, hobbies) \u2014 over a single broad query; fuse the results yourself. For "what did I save recently / latest memories" questions, set `sort` to "recent" to get the newest saved facts, newest first, instead of a relevance search.',
       arguments: {
         type: "object",
         properties: {
@@ -18210,6 +18250,11 @@ function createRecallTool(ctx, toolOptions, callbacks) {
           limit: {
             type: "integer",
             description: `Max number of results. Default: ${defaultLimit}.`
+          },
+          sort: {
+            type: "string",
+            enum: ["relevance", "recent"],
+            description: `"relevance" (default) ranks by match to the query. "recent" returns the newest saved facts, newest first, and ignores the query's topic.`
           }
         },
         required: ["query"]
@@ -18254,35 +18299,41 @@ function createRecallTool(ctx, toolOptions, callbacks) {
       let surfaced = 0;
       try {
         let recallDegraded = [];
-        let subQueries;
-        if (defaultBudget === "high" && toolOptions?.decomposeOptions) {
-          const decomp = await decomposeQuery(query, toolOptions.decomposeOptions);
-          if (decomp.mode === "composite" && decomp.subQueries.length >= 2) {
-            subQueries = decomp.subQueries;
+        const wantsRecent = args.sort === "recent" && defaultTypes.includes("fact") && ctx.vaultCtx !== void 0;
+        let result;
+        if (wantsRecent) {
+          result = { memories: await listRecentFacts(ctx, effectiveLimit, toolOptions) };
+        } else {
+          let subQueries;
+          if (defaultBudget === "high" && toolOptions?.decomposeOptions) {
+            const decomp = await decomposeQuery(query, toolOptions.decomposeOptions);
+            if (decomp.mode === "composite" && decomp.subQueries.length >= 2) {
+              subQueries = decomp.subQueries;
+            }
           }
+          const recallOpts = {
+            onDiagnostics: (d) => {
+              recallDegraded = d.degraded;
+            },
+            types: defaultTypes,
+            limit: effectiveLimit,
+            budget: defaultBudget,
+            ...toolOptions?.minScore !== void 0 && { minScore: toolOptions.minScore },
+            ...toolOptions?.scopes && { scopes: toolOptions.scopes },
+            ...toolOptions?.memoryIds !== void 0 && { memoryIds: toolOptions.memoryIds },
+            ...toolOptions?.folderId !== void 0 && { folderId: toolOptions.folderId },
+            ...toolOptions?.excludeConversationId && {
+              excludeConversationId: toolOptions.excludeConversationId
+            },
+            // Do NOT forward decomposeOptions into recall() — rewrite already
+            // ran above, and forwarding would falsely trip `decompose-moved`
+            // on every specific-mode high-budget call. graphRefine auth can
+            // be threaded later when the tool opts into that path.
+            ...toolOptions?.now !== void 0 && { now: toolOptions.now },
+            ...subQueries && { subQueries }
+          };
+          result = await recall(query, ctx, recallOpts);
         }
-        const recallOpts = {
-          onDiagnostics: (d) => {
-            recallDegraded = d.degraded;
-          },
-          types: defaultTypes,
-          limit: effectiveLimit,
-          budget: defaultBudget,
-          ...toolOptions?.minScore !== void 0 && { minScore: toolOptions.minScore },
-          ...toolOptions?.scopes && { scopes: toolOptions.scopes },
-          ...toolOptions?.memoryIds !== void 0 && { memoryIds: toolOptions.memoryIds },
-          ...toolOptions?.folderId !== void 0 && { folderId: toolOptions.folderId },
-          ...toolOptions?.excludeConversationId && {
-            excludeConversationId: toolOptions.excludeConversationId
-          },
-          // Do NOT forward decomposeOptions into recall() — rewrite already
-          // ran above, and forwarding would falsely trip `decompose-moved`
-          // on every specific-mode high-budget call. graphRefine auth can
-          // be threaded later when the tool opts into that path.
-          ...toolOptions?.now !== void 0 && { now: toolOptions.now },
-          ...subQueries && { subQueries }
-        };
-        const result = await recall(query, ctx, recallOpts);
         if (callbacks?.onChunksRetrieved) {
           const convIds = Array.from(
             new Set(
@@ -18295,7 +18346,7 @@ function createRecallTool(ctx, toolOptions, callbacks) {
           const facts = result.memories.filter((m) => m.kind === "fact").map((m) => ({ id: m.id, score: m.score }));
           if (facts.length > 0) {
             callbacks.onFactsRetrieved?.(facts.map((f) => f.id));
-            callbacks.onFactsRanked?.(facts);
+            if (!wantsRecent) callbacks.onFactsRanked?.(facts);
           }
         }
         surfaced = result.memories.length;
@@ -19464,6 +19515,10 @@ function createMessageSourceResolver(ctx) {
 }
 
 // src/lib/memory/context.ts
+function savedAt(createdAt) {
+  const ms = createdAt?.getTime();
+  return ms !== void 0 && Number.isFinite(ms) && ms > 0 ? { createdAt } : {};
+}
 function shouldRecallMemory(query) {
   const normalized = query.trim().toLowerCase().replace(/[.!?。！？¡¿]+$/u, "").replace(/^[¡¿]+/u, "");
   return normalized.length > 0 && !/^(hi|hi there|hello|hey|yes|no|yep|nope|sure|k|ok|okay|thanks|thank you|thank you very much|thanks a lot|cool|great|got it|sounds good|hola|buenos días|buenas|sí|si|gracias|muchas gracias|vale|bonjour|salut|oui|non|merci|merci beaucoup|d'accord|hallo|guten tag|ja|nein|danke|danke schön|alles klar|olá|obrigado|obrigada|ciao|grazie|sì|你好|谢谢|好的|こんにちは|ありがとう|안녕하세요|감사합니다)$/u.test(
@@ -19501,7 +19556,8 @@ async function assembleMemoryContext(options) {
     content: m.content,
     score,
     lane,
-    sourceIds: m.sourceChunkIds ?? []
+    sourceIds: m.sourceChunkIds ?? [],
+    ...savedAt(m.createdAt)
   });
   const empty = {
     memories: [],
@@ -19566,7 +19622,8 @@ async function assembleMemoryContext(options) {
     score: m.score,
     lane,
     ...lane === "fact" && { recalled: true },
-    sourceIds: m.sourceChunkIds ?? (m.messageId ? [m.messageId] : [])
+    sourceIds: m.sourceChunkIds ?? (m.messageId ? [m.messageId] : []),
+    ...savedAt(m.createdAt)
   }));
   const recalledFacts = toItems(facts, "fact");
   const recalledScores = /* @__PURE__ */ new Map();

package/dist/server/index.cjs

@@ -22386,6 +22386,33 @@ async function getAllVaultMemoriesOp(ctx, options) {
     (raw) => vaultMemoryRawToStored(raw, ctx.walletAddress, ctx.signMessage, ctx.embeddedWalletSigner)
   );
 }
+function vaultMemoryRawToRankable(raw) {
+  return {
+    uniqueId: raw.id,
+    // @text coerces NULL→"" on the Model path; unsafeFetchRaw returns raw NULL, so guard.
+    scope: raw.scope ?? "",
+    folderId: raw.folder_id ?? null,
+    embedding: raw.embedding ?? null,
+    embeddingModel: raw.embedding_model ?? null,
+    createdAt: new Date(raw.created_at),
+    updatedAt: new Date(raw.updated_at),
+    // Same mapping as vaultMemoryRawToStoredRaw. A consolidation rewrite moves
+    // ONLY this column (preserveUpdatedAt pins updated_at), so a change-since
+    // check that reads this projection needs it — see the type doc.
+    lastObservedAt: raw.last_observed_at ?? null
+  };
+}
+async function getVaultRankingProjectionsOp(ctx, options) {
+  const conditions = [
+    ...baseVaultConditions(ctx, options),
+    ...options?.scopes?.length ? [import_watermelondb18.Q.where("scope", import_watermelondb18.Q.oneOf(options.scopes))] : [],
+    ...options?.folderId !== void 0 ? [import_watermelondb18.Q.where("folder_id", options.folderId)] : [],
+    import_watermelondb18.Q.sortBy(options?.since ? "updated_at" : "created_at", import_watermelondb18.Q.desc),
+    ...options?.limit !== null && options?.limit !== void 0 && options.limit > 0 ? [import_watermelondb18.Q.take(options.limit)] : []
+  ];
+  const results = await ctx.vaultMemoryCollection.query(...conditions).unsafeFetchRaw();
+  return results.map(vaultMemoryRawToRankable);
+}
 function baseVaultSql(ctx, options) {
   const clauses = [
     '"is_deleted" = 0',
@@ -30795,6 +30822,11 @@ function formatEventTime(start, end, kind) {
   if (kind === "ongoing") return `, event: since ${startDate}`;
   return `, event: ${startDate}`;
 }
+function formatSavedTime(createdAt) {
+  const ms = createdAt?.getTime();
+  if (ms === void 0 || !Number.isFinite(ms) || ms <= 0) return "";
+  return `, saved: ${new Date(ms).toISOString().slice(0, 10)}`;
+}
 function generateFenceNonce() {
   const bytes = new Uint8Array(9);
   crypto.getRandomValues(bytes);
@@ -30813,8 +30845,9 @@ function formatRecallResult(memories) {
   const lines = memories.map((m, i) => {
     let body;
     if (m.kind === "fact") {
+      const savedSuffix = formatSavedTime(m.createdAt);
       const eventSuffix = formatEventTime(m.eventTimeStart, m.eventTimeEnd, m.eventTimeKind);
-      body = `[${i + 1}] fact (id: ${m.id}${eventSuffix})
+      body = `[${i + 1}] fact (id: ${m.id}${savedSuffix}${eventSuffix})
 ${m.content}`;
     } else {
       const date10 = m.createdAt.toISOString().slice(0, 10);
@@ -30864,6 +30897,40 @@ function isDumpQuery(query) {
   if (EVERYTHING_YOU_KNOW_RE.test(q)) return true;
   return false;
 }
+async function listRecentFacts(ctx, limit, toolOptions) {
+  const vaultCtx = ctx.vaultCtx;
+  if (!vaultCtx) return [];
+  const ordered = await getVaultRankingProjectionsOp(vaultCtx, {
+    ...toolOptions?.scopes && { scopes: toolOptions.scopes },
+    ...toolOptions?.memoryIds !== void 0 && { memoryIds: toolOptions.memoryIds },
+    ...toolOptions?.folderId !== void 0 && { folderId: toolOptions.folderId }
+  });
+  const readable = [];
+  for (let i = 0; i < ordered.length && readable.length < limit; i += limit) {
+    const batch = ordered.slice(i, i + limit).map((p) => p.uniqueId);
+    const byId = new Map(
+      (await getVaultMemoriesByIdsOp(vaultCtx, batch)).map((m) => [m.uniqueId, m])
+    );
+    for (const id of batch) {
+      const m = byId.get(id);
+      if (m && !isEncrypted(m.content)) readable.push(m);
+      if (readable.length >= limit) break;
+    }
+  }
+  return readable.map((m) => ({
+    id: m.uniqueId,
+    kind: "fact",
+    content: m.content,
+    score: 0,
+    folderId: m.folderId,
+    eventTimeStart: m.eventTimeStart,
+    eventTimeEnd: m.eventTimeEnd,
+    eventTimeKind: m.eventTimeKind,
+    factType: m.factType,
+    createdAt: m.createdAt,
+    updatedAt: m.updatedAt
+  }));
+}
 function createRecallTool(ctx, toolOptions, callbacks) {
   const defaultTypes = toolOptions?.types ?? ["fact", "chunk"];
   const defaultLimit = toolOptions?.limit ?? DEFAULT_LIMIT2;
@@ -30876,7 +30943,7 @@ function createRecallTool(ctx, toolOptions, callbacks) {
     type: "function",
     function: {
       name: RECALL_TOOL_NAME,
-      description: `Search the user's memory across stored facts/preferences and past conversation excerpts. Returns a unified ranked list \u2014 facts carry an \`id\` you can reference; conversation excerpts carry a date and role. Use this whenever the user's question may relate to anything previously discussed or saved (preferences, prior decisions, past topics). Phrase the query naturally. For multi-faceted / overview questions ("tell me about the user", "what's my tech stack"), prefer several targeted searches \u2014 one facet each (e.g. name, work, hobbies) \u2014 over a single broad query; fuse the results yourself.`,
+      description: 'Search the user\'s memory across stored facts/preferences and past conversation excerpts. Returns a unified ranked list \u2014 facts carry an `id` you can reference and the date they were saved; conversation excerpts carry a date and role. Use this whenever the user\'s question may relate to anything previously discussed or saved (preferences, prior decisions, past topics). Phrase the query naturally. For multi-faceted / overview questions ("tell me about the user", "what\'s my tech stack"), prefer several targeted searches \u2014 one facet each (e.g. name, work, hobbies) \u2014 over a single broad query; fuse the results yourself. For "what did I save recently / latest memories" questions, set `sort` to "recent" to get the newest saved facts, newest first, instead of a relevance search.',
       arguments: {
         type: "object",
         properties: {
@@ -30887,6 +30954,11 @@ function createRecallTool(ctx, toolOptions, callbacks) {
           limit: {
             type: "integer",
             description: `Max number of results. Default: ${defaultLimit}.`
+          },
+          sort: {
+            type: "string",
+            enum: ["relevance", "recent"],
+            description: `"relevance" (default) ranks by match to the query. "recent" returns the newest saved facts, newest first, and ignores the query's topic.`
           }
         },
         required: ["query"]
@@ -30931,35 +31003,41 @@ function createRecallTool(ctx, toolOptions, callbacks) {
       let surfaced = 0;
       try {
         let recallDegraded = [];
-        let subQueries;
-        if (defaultBudget === "high" && toolOptions?.decomposeOptions) {
-          const decomp = await decomposeQuery(query, toolOptions.decomposeOptions);
-          if (decomp.mode === "composite" && decomp.subQueries.length >= 2) {
-            subQueries = decomp.subQueries;
+        const wantsRecent = args.sort === "recent" && defaultTypes.includes("fact") && ctx.vaultCtx !== void 0;
+        let result;
+        if (wantsRecent) {
+          result = { memories: await listRecentFacts(ctx, effectiveLimit, toolOptions) };
+        } else {
+          let subQueries;
+          if (defaultBudget === "high" && toolOptions?.decomposeOptions) {
+            const decomp = await decomposeQuery(query, toolOptions.decomposeOptions);
+            if (decomp.mode === "composite" && decomp.subQueries.length >= 2) {
+              subQueries = decomp.subQueries;
+            }
           }
+          const recallOpts = {
+            onDiagnostics: (d) => {
+              recallDegraded = d.degraded;
+            },
+            types: defaultTypes,
+            limit: effectiveLimit,
+            budget: defaultBudget,
+            ...toolOptions?.minScore !== void 0 && { minScore: toolOptions.minScore },
+            ...toolOptions?.scopes && { scopes: toolOptions.scopes },
+            ...toolOptions?.memoryIds !== void 0 && { memoryIds: toolOptions.memoryIds },
+            ...toolOptions?.folderId !== void 0 && { folderId: toolOptions.folderId },
+            ...toolOptions?.excludeConversationId && {
+              excludeConversationId: toolOptions.excludeConversationId
+            },
+            // Do NOT forward decomposeOptions into recall() — rewrite already
+            // ran above, and forwarding would falsely trip `decompose-moved`
+            // on every specific-mode high-budget call. graphRefine auth can
+            // be threaded later when the tool opts into that path.
+            ...toolOptions?.now !== void 0 && { now: toolOptions.now },
+            ...subQueries && { subQueries }
+          };
+          result = await recall(query, ctx, recallOpts);
         }
-        const recallOpts = {
-          onDiagnostics: (d) => {
-            recallDegraded = d.degraded;
-          },
-          types: defaultTypes,
-          limit: effectiveLimit,
-          budget: defaultBudget,
-          ...toolOptions?.minScore !== void 0 && { minScore: toolOptions.minScore },
-          ...toolOptions?.scopes && { scopes: toolOptions.scopes },
-          ...toolOptions?.memoryIds !== void 0 && { memoryIds: toolOptions.memoryIds },
-          ...toolOptions?.folderId !== void 0 && { folderId: toolOptions.folderId },
-          ...toolOptions?.excludeConversationId && {
-            excludeConversationId: toolOptions.excludeConversationId
-          },
-          // Do NOT forward decomposeOptions into recall() — rewrite already
-          // ran above, and forwarding would falsely trip `decompose-moved`
-          // on every specific-mode high-budget call. graphRefine auth can
-          // be threaded later when the tool opts into that path.
-          ...toolOptions?.now !== void 0 && { now: toolOptions.now },
-          ...subQueries && { subQueries }
-        };
-        const result = await recall(query, ctx, recallOpts);
         if (callbacks?.onChunksRetrieved) {
           const convIds = Array.from(
             new Set(
@@ -30972,7 +31050,7 @@ function createRecallTool(ctx, toolOptions, callbacks) {
           const facts = result.memories.filter((m) => m.kind === "fact").map((m) => ({ id: m.id, score: m.score }));
           if (facts.length > 0) {
             callbacks.onFactsRetrieved?.(facts.map((f) => f.id));
-            callbacks.onFactsRanked?.(facts);
+            if (!wantsRecent) callbacks.onFactsRanked?.(facts);
           }
         }
         surfaced = result.memories.length;
@@ -32153,6 +32231,10 @@ function createMessageSourceResolver(ctx) {
 }
 
 // src/lib/memory/context.ts
+function savedAt(createdAt) {
+  const ms = createdAt?.getTime();
+  return ms !== void 0 && Number.isFinite(ms) && ms > 0 ? { createdAt } : {};
+}
 function shouldRecallMemory(query) {
   const normalized = query.trim().toLowerCase().replace(/[.!?。！？¡¿]+$/u, "").replace(/^[¡¿]+/u, "");
   return normalized.length > 0 && !/^(hi|hi there|hello|hey|yes|no|yep|nope|sure|k|ok|okay|thanks|thank you|thank you very much|thanks a lot|cool|great|got it|sounds good|hola|buenos días|buenas|sí|si|gracias|muchas gracias|vale|bonjour|salut|oui|non|merci|merci beaucoup|d'accord|hallo|guten tag|ja|nein|danke|danke schön|alles klar|olá|obrigado|obrigada|ciao|grazie|sì|你好|谢谢|好的|こんにちは|ありがとう|안녕하세요|감사합니다)$/u.test(
@@ -32190,7 +32272,8 @@ async function assembleMemoryContext(options) {
     content: m.content,
     score,
     lane,
-    sourceIds: m.sourceChunkIds ?? []
+    sourceIds: m.sourceChunkIds ?? [],
+    ...savedAt(m.createdAt)
   });
   const empty = {
     memories: [],
@@ -32255,7 +32338,8 @@ async function assembleMemoryContext(options) {
     score: m.score,
     lane,
     ...lane === "fact" && { recalled: true },
-    sourceIds: m.sourceChunkIds ?? (m.messageId ? [m.messageId] : [])
+    sourceIds: m.sourceChunkIds ?? (m.messageId ? [m.messageId] : []),
+    ...savedAt(m.createdAt)
   }));
   const recalledFacts = toItems(facts, "fact");
   const recalledScores = /* @__PURE__ */ new Map();

package/dist/server/index.d.mts

@@ -10200,6 +10200,9 @@ interface MemoryContextItem {
     sourceIds: string[];
     /** Ranked fact evidence, retained when profile deduplication wins placement. */
     recalled?: boolean;
+    /** When the memory was written — lets the prompt show a saved date so the
+     * model can answer "what did I save recently". */
+    createdAt?: Date;
 }
 interface MemoryContextOptions {
     query: string;