@anuma/sdk 3.9.1 → 3.9.3

package/dist/react/index.d.ts

@@ -7243,6 +7243,16 @@ interface VaultCandidateKey {
 declare function getVaultCandidateKeysOp(ctx: VaultMemoryOperationsContext, options?: {
     scopes?: string[];
     folderId?: string | null;
+    /**
+     * Typed memory (PR1) — restrict to these fact types. Omit for no filter.
+     * MUST stay in step with `getAllVaultMemoriesOp`: this op backs the
+     * decrypt-last search path, and the two paths are meant to return the same
+     * candidate set for the same query. Dropping it here made typed recall
+     * silently path-dependent (#779).
+     */
+    factTypes?: string[];
+    /** Include archived (decayed) memories. Default `false`, as elsewhere. */
+    includeArchived?: boolean;
 }): Promise<VaultCandidateKey[]>;
 /**
  * Column-projected embedding lookup for a KNOWN set of ids — id + embedding +
@@ -7252,7 +7262,16 @@ declare function getVaultCandidateKeysOp(ctx: VaultMemoryOperationsContext, opti
  * OPFS-SQLite, falling back to the standard Q query + unsafeFetchRaw on
  * LokiJS (Q.unsafeSqlQuery throws there).
  */
-declare function getVaultEmbeddingsByIdsOp(ctx: VaultMemoryOperationsContext, ids: string[]): Promise<Array<{
+declare function getVaultEmbeddingsByIdsOp(ctx: VaultMemoryOperationsContext, ids: string[], 
+/**
+ * Must match whatever admitted these ids. The caller has already filtered the
+ * candidate set; re-applying a DEFAULT-ON exclusion here silently deletes rows
+ * it deliberately admitted — which is how archived rows passed the key scan
+ * and then vanished at hydration (#779).
+ */
+options?: {
+    includeArchived?: boolean;
+}): Promise<Array<{
     uniqueId: string;
     embedding: string | null;
     embeddingModel: string | null;
@@ -7270,7 +7289,11 @@ declare function getVaultEmbeddingsByIdsOp(ctx: VaultMemoryOperationsContext, id
  * excluded exactly as they are from recall — a caller can pass any id list and
  * only its own live rows come back.
  */
-declare function getVaultMemoriesByIdsOp(ctx: VaultMemoryOperationsContext, ids: string[]): Promise<StoredVaultMemory[]>;
+declare function getVaultMemoriesByIdsOp(ctx: VaultMemoryOperationsContext, ids: string[], 
+/** See {@link getVaultEmbeddingsByIdsOp} — must match what admitted these ids. */
+options?: {
+    includeArchived?: boolean;
+}): Promise<StoredVaultMemory[]>;
 declare function getAllVaultMemoryContentsOp(ctx: VaultMemoryOperationsContext, options?: {
     since?: Date;
 }): Promise<string[]>;

package/dist/react/index.mjs

@@ -153,7 +153,7 @@ import {
   updateVaultMemoryOp,
   useEncryption,
   vaultMemoryToStored
-} from "./chunk-GDS7GHBF.mjs";
+} from "./chunk-HLBQICNL.mjs";
 import {
   PiiRedactor,
   createStreamingDeAnonymizer,

package/dist/react/{recall-SBQ4LNRJ.mjs → recall-UCCIEG37.mjs}

@@ -1,6 +1,6 @@
 import {
   recall
-} from "./chunk-GDS7GHBF.mjs";
+} from "./chunk-HLBQICNL.mjs";
 import "./chunk-BOY27A2C.mjs";
 import "./chunk-GYKJOWEO.mjs";
 export {

package/dist/server/{chunk-QC4WHNIJ.mjs → chunk-ICGTS7X6.mjs}

@@ -16583,10 +16583,12 @@ async function getAllVaultMemoriesOp(ctx, options) {
     (raw) => vaultMemoryRawToStored(raw, ctx.walletAddress, ctx.signMessage, ctx.embeddedWalletSigner)
   );
 }
-function baseVaultSql(ctx) {
+function baseVaultSql(ctx, options) {
   const clauses = [
     '"is_deleted" = 0',
-    '"archived_at" is null',
+    // Mirrors `baseVaultConditions`' `includeArchived` branch. Defaults to
+    // excluding archived rows, so every existing caller is unchanged.
+    ...options?.includeArchived ? [] : ['"archived_at" is null'],
     `"trust_tier" is not 'quarantined'`,
     '"superseded_by" is null'
   ];
@@ -16606,7 +16608,9 @@ async function getVaultCandidateKeysOp(ctx, options) {
     updatedAt: new Date(raw.updated_at)
   });
   try {
-    const base = baseVaultSql(ctx);
+    const base = baseVaultSql(ctx, {
+      ...options?.includeArchived !== void 0 && { includeArchived: options.includeArchived }
+    });
     const clauses = [base.sql];
     const args = [...base.args];
     if (options?.scopes?.length) {
@@ -16617,6 +16621,10 @@ async function getVaultCandidateKeysOp(ctx, options) {
       clauses.push(options.folderId === null ? '"folder_id" is null' : '"folder_id" = ?');
       if (options.folderId !== null) args.push(options.folderId);
     }
+    if (options?.factTypes?.length) {
+      clauses.push(`"fact_type" in (${options.factTypes.map(() => "?").join(",")})`);
+      args.push(...options.factTypes);
+    }
     const sql = `select "id", "scope", "folder_id", "embedding_model", "updated_at" from "memory_vault" where ${clauses.join(" and ")}`;
     const rows = await ctx.vaultMemoryCollection.query(import_watermelondb3.Q.unsafeSqlQuery(sql, args)).unsafeFetchRaw();
     return rows.map(mapRaw);
@@ -16625,15 +16633,18 @@ async function getVaultCandidateKeysOp(ctx, options) {
       "memoryVault: getVaultCandidateKeysOp projected SQL unavailable, using full-load fallback: " + (err instanceof Error ? err.message : String(err))
     );
     const conditions = [
-      ...baseVaultConditions(ctx),
+      ...baseVaultConditions(ctx, {
+        ...options?.includeArchived !== void 0 && { includeArchived: options.includeArchived }
+      }),
       ...options?.scopes?.length ? [import_watermelondb3.Q.where("scope", import_watermelondb3.Q.oneOf(options.scopes))] : [],
-      ...options?.folderId !== void 0 ? [import_watermelondb3.Q.where("folder_id", options.folderId)] : []
+      ...options?.folderId !== void 0 ? [import_watermelondb3.Q.where("folder_id", options.folderId)] : [],
+      ...options?.factTypes?.length ? [import_watermelondb3.Q.where("fact_type", import_watermelondb3.Q.oneOf(options.factTypes))] : []
     ];
     const rows = await ctx.vaultMemoryCollection.query(...conditions).unsafeFetchRaw();
     return rows.map(mapRaw);
   }
 }
-async function getVaultEmbeddingsByIdsOp(ctx, ids) {
+async function getVaultEmbeddingsByIdsOp(ctx, ids, options) {
   if (ids.length === 0) return [];
   const mapRaw = (raw) => ({
     uniqueId: raw.id,
@@ -16641,7 +16652,9 @@ async function getVaultEmbeddingsByIdsOp(ctx, ids) {
     embeddingModel: raw.embedding_model ?? null
   });
   try {
-    const base = baseVaultSql(ctx);
+    const base = baseVaultSql(ctx, {
+      ...options?.includeArchived !== void 0 && { includeArchived: options.includeArchived }
+    });
     const sql = `select "id", "embedding", "embedding_model" from "memory_vault" where ${base.sql} and "id" in (${ids.map(() => "?").join(",")})`;
     const rows = await ctx.vaultMemoryCollection.query(import_watermelondb3.Q.unsafeSqlQuery(sql, [...base.args, ...ids])).unsafeFetchRaw();
     return rows.map(mapRaw);
@@ -16649,13 +16662,25 @@ async function getVaultEmbeddingsByIdsOp(ctx, ids) {
     getLogger().debug(
       "memoryVault: getVaultEmbeddingsByIdsOp projected SQL unavailable, using full-load fallback: " + (err instanceof Error ? err.message : String(err))
     );
-    const rows = await ctx.vaultMemoryCollection.query(...baseVaultConditions(ctx), import_watermelondb3.Q.where("id", import_watermelondb3.Q.oneOf(ids))).unsafeFetchRaw();
+    const rows = await ctx.vaultMemoryCollection.query(
+      ...baseVaultConditions(ctx, {
+        ...options?.includeArchived !== void 0 && {
+          includeArchived: options.includeArchived
+        }
+      }),
+      import_watermelondb3.Q.where("id", import_watermelondb3.Q.oneOf(ids))
+    ).unsafeFetchRaw();
     return rows.map(mapRaw);
   }
 }
-async function getVaultMemoriesByIdsOp(ctx, ids) {
+async function getVaultMemoriesByIdsOp(ctx, ids, options) {
   if (ids.length === 0) return [];
-  const conditions = [...baseVaultConditions(ctx), import_watermelondb3.Q.where("id", import_watermelondb3.Q.oneOf(ids))];
+  const conditions = [
+    ...baseVaultConditions(ctx, {
+      ...options?.includeArchived !== void 0 && { includeArchived: options.includeArchived }
+    }),
+    import_watermelondb3.Q.where("id", import_watermelondb3.Q.oneOf(ids))
+  ];
   const results = await ctx.vaultMemoryCollection.query(...conditions).unsafeFetchRaw();
   return mapInBatches(
     results,
@@ -19349,6 +19374,7 @@ async function buildProjectedCorpus(query, vaultCtx, embeddingOptions, cache, qu
     vaultCtx,
     Object.keys(queryOpts).length > 0 ? queryOpts : void 0
   );
+  const hydrateOpts = queryOpts.includeArchived ? { includeArchived: true } : void 0;
   const vaultSize = keys.length;
   if (keys.length === 0) {
     return { memories: [], embeddedItems: [], queryEmbedding: [], vaultSize: 0 };
@@ -19370,7 +19396,7 @@ async function buildProjectedCorpus(query, vaultCtx, embeddingOptions, cache, qu
     else noVectorIds.push(k2.uniqueId);
   }
   if (missIds.length > 0) {
-    const rows = await getVaultEmbeddingsByIdsOp(vaultCtx, missIds);
+    const rows = await getVaultEmbeddingsByIdsOp(vaultCtx, missIds, hydrateOpts);
     const gotVector = /* @__PURE__ */ new Set();
     for (const r of rows) {
       if (!r.embedding) continue;
@@ -19395,7 +19421,7 @@ async function buildProjectedCorpus(query, vaultCtx, embeddingOptions, cache, qu
         `memoryVault: projected search un-embedded lane capped at ${laneIds.length}/${noVectorIds.length}`
       );
     }
-    const laneRows = (await getVaultMemoriesByIdsOp(vaultCtx, laneIds)).filter(
+    const laneRows = (await getVaultMemoriesByIdsOp(vaultCtx, laneIds, hydrateOpts)).filter(
       (m) => !isEncrypted(m.content)
     );
     if (laneRows.length > 0) {
@@ -19425,7 +19451,7 @@ async function buildProjectedCorpus(query, vaultCtx, embeddingOptions, cache, qu
       if (keyById.has(id)) admissionSet.add(id);
     }
   }
-  const admittedRows = await getVaultMemoriesByIdsOp(vaultCtx, [...admissionSet]);
+  const admittedRows = await getVaultMemoriesByIdsOp(vaultCtx, [...admissionSet], hydrateOpts);
   const memories = admittedRows.filter((m) => !isEncrypted(m.content));
   if (memories.length < admittedRows.length) {
     getLogger().warn(
@@ -19789,7 +19815,7 @@ function createMemoryVaultSearchTool(vaultCtx, embeddingOptions, cache, searchOp
             legacy.map((r) => ({ id: r.uniqueId, content: r.content, score: r.similarity }))
           );
         }
-        const { recall: recall2 } = await import("./recall-NLJNELJY.mjs");
+        const { recall: recall2 } = await import("./recall-5OW4RJVC.mjs");
         const result = await recall2(
           query,
           { vaultCtx, embeddingOptions, vaultCache: cache },

package/dist/server/index.cjs

@@ -17389,10 +17389,12 @@ async function getAllVaultMemoriesOp(ctx, options) {
     (raw) => vaultMemoryRawToStored(raw, ctx.walletAddress, ctx.signMessage, ctx.embeddedWalletSigner)
   );
 }
-function baseVaultSql(ctx) {
+function baseVaultSql(ctx, options) {
   const clauses = [
     '"is_deleted" = 0',
-    '"archived_at" is null',
+    // Mirrors `baseVaultConditions`' `includeArchived` branch. Defaults to
+    // excluding archived rows, so every existing caller is unchanged.
+    ...options?.includeArchived ? [] : ['"archived_at" is null'],
     `"trust_tier" is not 'quarantined'`,
     '"superseded_by" is null'
   ];
@@ -17412,7 +17414,9 @@ async function getVaultCandidateKeysOp(ctx, options) {
     updatedAt: new Date(raw.updated_at)
   });
   try {
-    const base = baseVaultSql(ctx);
+    const base = baseVaultSql(ctx, {
+      ...options?.includeArchived !== void 0 && { includeArchived: options.includeArchived }
+    });
     const clauses = [base.sql];
     const args = [...base.args];
     if (options?.scopes?.length) {
@@ -17423,6 +17427,10 @@ async function getVaultCandidateKeysOp(ctx, options) {
       clauses.push(options.folderId === null ? '"folder_id" is null' : '"folder_id" = ?');
       if (options.folderId !== null) args.push(options.folderId);
     }
+    if (options?.factTypes?.length) {
+      clauses.push(`"fact_type" in (${options.factTypes.map(() => "?").join(",")})`);
+      args.push(...options.factTypes);
+    }
     const sql = `select "id", "scope", "folder_id", "embedding_model", "updated_at" from "memory_vault" where ${clauses.join(" and ")}`;
     const rows = await ctx.vaultMemoryCollection.query(import_watermelondb17.Q.unsafeSqlQuery(sql, args)).unsafeFetchRaw();
     return rows.map(mapRaw);
@@ -17431,15 +17439,18 @@ async function getVaultCandidateKeysOp(ctx, options) {
       "memoryVault: getVaultCandidateKeysOp projected SQL unavailable, using full-load fallback: " + (err instanceof Error ? err.message : String(err))
     );
     const conditions = [
-      ...baseVaultConditions(ctx),
+      ...baseVaultConditions(ctx, {
+        ...options?.includeArchived !== void 0 && { includeArchived: options.includeArchived }
+      }),
       ...options?.scopes?.length ? [import_watermelondb17.Q.where("scope", import_watermelondb17.Q.oneOf(options.scopes))] : [],
-      ...options?.folderId !== void 0 ? [import_watermelondb17.Q.where("folder_id", options.folderId)] : []
+      ...options?.folderId !== void 0 ? [import_watermelondb17.Q.where("folder_id", options.folderId)] : [],
+      ...options?.factTypes?.length ? [import_watermelondb17.Q.where("fact_type", import_watermelondb17.Q.oneOf(options.factTypes))] : []
     ];
     const rows = await ctx.vaultMemoryCollection.query(...conditions).unsafeFetchRaw();
     return rows.map(mapRaw);
   }
 }
-async function getVaultEmbeddingsByIdsOp(ctx, ids) {
+async function getVaultEmbeddingsByIdsOp(ctx, ids, options) {
   if (ids.length === 0) return [];
   const mapRaw = (raw) => ({
     uniqueId: raw.id,
@@ -17447,7 +17458,9 @@ async function getVaultEmbeddingsByIdsOp(ctx, ids) {
     embeddingModel: raw.embedding_model ?? null
   });
   try {
-    const base = baseVaultSql(ctx);
+    const base = baseVaultSql(ctx, {
+      ...options?.includeArchived !== void 0 && { includeArchived: options.includeArchived }
+    });
     const sql = `select "id", "embedding", "embedding_model" from "memory_vault" where ${base.sql} and "id" in (${ids.map(() => "?").join(",")})`;
     const rows = await ctx.vaultMemoryCollection.query(import_watermelondb17.Q.unsafeSqlQuery(sql, [...base.args, ...ids])).unsafeFetchRaw();
     return rows.map(mapRaw);
@@ -17455,13 +17468,25 @@ async function getVaultEmbeddingsByIdsOp(ctx, ids) {
     getLogger().debug(
       "memoryVault: getVaultEmbeddingsByIdsOp projected SQL unavailable, using full-load fallback: " + (err instanceof Error ? err.message : String(err))
     );
-    const rows = await ctx.vaultMemoryCollection.query(...baseVaultConditions(ctx), import_watermelondb17.Q.where("id", import_watermelondb17.Q.oneOf(ids))).unsafeFetchRaw();
+    const rows = await ctx.vaultMemoryCollection.query(
+      ...baseVaultConditions(ctx, {
+        ...options?.includeArchived !== void 0 && {
+          includeArchived: options.includeArchived
+        }
+      }),
+      import_watermelondb17.Q.where("id", import_watermelondb17.Q.oneOf(ids))
+    ).unsafeFetchRaw();
     return rows.map(mapRaw);
   }
 }
-async function getVaultMemoriesByIdsOp(ctx, ids) {
+async function getVaultMemoriesByIdsOp(ctx, ids, options) {
   if (ids.length === 0) return [];
-  const conditions = [...baseVaultConditions(ctx), import_watermelondb17.Q.where("id", import_watermelondb17.Q.oneOf(ids))];
+  const conditions = [
+    ...baseVaultConditions(ctx, {
+      ...options?.includeArchived !== void 0 && { includeArchived: options.includeArchived }
+    }),
+    import_watermelondb17.Q.where("id", import_watermelondb17.Q.oneOf(ids))
+  ];
   const results = await ctx.vaultMemoryCollection.query(...conditions).unsafeFetchRaw();
   return mapInBatches(
     results,
@@ -21450,6 +21475,7 @@ async function buildProjectedCorpus(query, vaultCtx, embeddingOptions, cache, qu
     vaultCtx,
     Object.keys(queryOpts).length > 0 ? queryOpts : void 0
   );
+  const hydrateOpts = queryOpts.includeArchived ? { includeArchived: true } : void 0;
   const vaultSize = keys.length;
   if (keys.length === 0) {
     return { memories: [], embeddedItems: [], queryEmbedding: [], vaultSize: 0 };
@@ -21471,7 +21497,7 @@ async function buildProjectedCorpus(query, vaultCtx, embeddingOptions, cache, qu
     else noVectorIds.push(k2.uniqueId);
   }
   if (missIds.length > 0) {
-    const rows = await getVaultEmbeddingsByIdsOp(vaultCtx, missIds);
+    const rows = await getVaultEmbeddingsByIdsOp(vaultCtx, missIds, hydrateOpts);
     const gotVector = /* @__PURE__ */ new Set();
     for (const r of rows) {
       if (!r.embedding) continue;
@@ -21496,7 +21522,7 @@ async function buildProjectedCorpus(query, vaultCtx, embeddingOptions, cache, qu
         `memoryVault: projected search un-embedded lane capped at ${laneIds.length}/${noVectorIds.length}`
       );
     }
-    const laneRows = (await getVaultMemoriesByIdsOp(vaultCtx, laneIds)).filter(
+    const laneRows = (await getVaultMemoriesByIdsOp(vaultCtx, laneIds, hydrateOpts)).filter(
       (m) => !isEncrypted(m.content)
     );
     if (laneRows.length > 0) {
@@ -21526,7 +21552,7 @@ async function buildProjectedCorpus(query, vaultCtx, embeddingOptions, cache, qu
       if (keyById.has(id)) admissionSet.add(id);
     }
   }
-  const admittedRows = await getVaultMemoriesByIdsOp(vaultCtx, [...admissionSet]);
+  const admittedRows = await getVaultMemoriesByIdsOp(vaultCtx, [...admissionSet], hydrateOpts);
   const memories = admittedRows.filter((m) => !isEncrypted(m.content));
   if (memories.length < admittedRows.length) {
     getLogger().warn(

package/dist/server/index.mjs

@@ -125,7 +125,7 @@ import {
   updateVaultMemoryOp,
   upsertMessageOp,
   vaultMemoryToStored
-} from "./chunk-QC4WHNIJ.mjs";
+} from "./chunk-ICGTS7X6.mjs";
 import {
   createStreamingDeAnonymizer,
   resolvePiiRedactor

package/dist/server/{recall-NLJNELJY.mjs → recall-5OW4RJVC.mjs}

@@ -1,6 +1,6 @@
 import {
   recall
-} from "./chunk-QC4WHNIJ.mjs";
+} from "./chunk-ICGTS7X6.mjs";
 import "./chunk-MIXEASUP.mjs";
 import "./chunk-3RPGXXPZ.mjs";
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anuma/sdk",
-  "version": "3.9.1",
+  "version": "3.9.3",
   "description": "",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
@@ -156,7 +156,7 @@
   "homepage": "https://github.com/anuma-ai/sdk#readme",
   "packageManager": "pnpm@10.23.0",
   "dependencies": {
-    "@anuma/portal": "1.0.0-next.20260724210432",
+    "@anuma/portal": "1.0.0-next.20260726011521",
     "@babel/parser": "^7.29.2",
     "@babel/types": "^7.29.0",
     "ai": "6.0.202",