@anuma/sdk 9.1.3 → 9.1.5

package/dist/expo/index.cjs

@@ -2520,15 +2520,16 @@ async function refreshEncryptionKeyIfMatches(walletAddress, probeCiphertext, sig
   if (!parsed) {
     return false;
   }
+  const startEpoch = sessionEpoch;
   const cached = refreshCandidatesByAddress.get(walletAddress);
   if (cached) {
-    return tryCommitCandidatesIfProbeMatches(walletAddress, parsed, cached);
+    return tryCommitCandidatesIfProbeMatches(walletAddress, parsed, cached, startEpoch);
   }
   let derivePromise = pendingCandidateDerives.get(walletAddress);
   if (!derivePromise) {
     derivePromise = (async () => {
       const candidates2 = await deriveRefreshCandidates(signMessage, embeddedWalletSigner);
-      if (candidates2) {
+      if (candidates2 && sessionEpoch === startEpoch) {
         refreshCandidatesByAddress.set(walletAddress, candidates2);
       }
       return candidates2;
@@ -2540,10 +2541,10 @@ async function refreshEncryptionKeyIfMatches(walletAddress, probeCiphertext, sig
     pendingCandidateDerives.set(walletAddress, derivePromise);
   }
   const candidates = await derivePromise;
-  if (!candidates) {
+  if (!candidates || sessionEpoch !== startEpoch) {
     return false;
   }
-  return tryCommitCandidatesIfProbeMatches(walletAddress, parsed, candidates);
+  return tryCommitCandidatesIfProbeMatches(walletAddress, parsed, candidates, startEpoch);
 }
 function parsePrefixedCiphertext(probeCiphertext) {
   const version = probeCiphertext.startsWith("enc:v3:") ? "v3" : probeCiphertext.startsWith("enc:v2:") ? "v2" : null;
@@ -2586,7 +2587,7 @@ async function deriveRefreshCandidates(signMessage, embeddedWalletSigner) {
   }
   return { legacy: legacyKey, current: currentKey };
 }
-async function tryCommitCandidatesIfProbeMatches(walletAddress, parsed, candidates) {
+async function tryCommitCandidatesIfProbeMatches(walletAddress, parsed, candidates, startEpoch) {
   const candidateHex = parsed.version === "v2" ? candidates.legacy : candidates.current;
   const keyBytes = hexToBytes(candidateHex);
   const candidateCryptoKey = await crypto.subtle.importKey(
@@ -2604,6 +2605,9 @@ async function tryCommitCandidatesIfProbeMatches(walletAddress, parsed, candidat
     );
     return false;
   }
+  if (sessionEpoch !== startEpoch) {
+    return false;
+  }
   setStoredKey(walletAddress, { legacy: candidates.legacy, current: candidates.current });
   cryptoKeyCache.delete(`${walletAddress}:v2`);
   cryptoKeyCache.delete(`${walletAddress}:v3`);
@@ -17284,6 +17288,104 @@ function validate(parsed, originalQuery) {
   return { mode, subQueries };
 }
 
+// src/lib/memoryVault/vaultPreparation.ts
+function createVaultPreparation() {
+  return { corpora: /* @__PURE__ */ new WeakMap(), rows: /* @__PURE__ */ new WeakMap() };
+}
+var pendingRows = /* @__PURE__ */ new WeakMap();
+function loadVaultCorpus(ctx, options, preparation) {
+  if (!preparation) return getAllVaultMemoriesOp(ctx, options);
+  const corpusCache = preparation.corpora;
+  let pending = corpusCache.get(ctx);
+  if (!pending) {
+    pending = /* @__PURE__ */ new Map();
+    corpusCache.set(ctx, pending);
+  }
+  const key = JSON.stringify(options ?? {});
+  let request = pending.get(key);
+  if (!request) {
+    const entries = pending;
+    request = getAllVaultMemoriesOp(ctx, options).catch((error) => {
+      entries.delete(key);
+      throw error;
+    });
+    pending.set(key, request);
+  }
+  return request;
+}
+function rowRequestsFor(registry2, ctx, maskInput) {
+  let byMask = registry2.get(ctx);
+  if (!byMask) {
+    byMask = /* @__PURE__ */ new Map();
+    registry2.set(ctx, byMask);
+  }
+  let requests = byMask.get(maskInput);
+  if (!requests) {
+    requests = /* @__PURE__ */ new Map();
+    byMask.set(maskInput, requests);
+  }
+  return requests;
+}
+function embedVaultRows(ctx, options, rows, preparation) {
+  const pending = rowRequestsFor(pendingRows, ctx, options.maskInput);
+  const prepared = preparation && rowRequestsFor(preparation.rows, ctx, options.maskInput);
+  const model = options.model ?? DEFAULT_API_EMBEDDING_MODEL;
+  const keys = rows.map(
+    (row) => JSON.stringify([
+      row.uniqueId,
+      row.updatedAt?.getTime(),
+      row.content,
+      model,
+      options.baseUrl,
+      options.timeoutMs,
+      options.tokenTimeoutMs,
+      options.totalTimeoutMs
+    ])
+  );
+  const missing = /* @__PURE__ */ new Map();
+  rows.forEach((row, index) => {
+    if (!pending.has(keys[index]) && !prepared?.has(keys[index])) missing.set(keys[index], row);
+  });
+  if (missing.size > 0) {
+    const entries = pending;
+    const batch = Promise.resolve().then(
+      () => generateEmbeddings(
+        [...missing.values()].map((row) => row.content),
+        options
+      )
+    );
+    [...missing].forEach(([key, row], index) => {
+      const request = batch.then((vectors) => {
+        const vector = vectors[index];
+        updateVaultMemoryEmbeddingOp(ctx, row.uniqueId, JSON.stringify(vector), model, {
+          content: row.content,
+          updatedAt: row.updatedAt?.getTime()
+        }).catch(() => {
+        });
+        return vector;
+      }).finally(() => {
+        entries.delete(key);
+        if (entries.size === 0) pendingRows.get(ctx)?.delete(options.maskInput);
+      });
+      pending.set(key, request);
+    });
+  }
+  return Promise.all(
+    keys.map((key) => {
+      const cached = prepared?.get(key);
+      if (cached) return cached;
+      const request = pending.get(key);
+      if (!prepared) return request;
+      const retained = request.catch((error) => {
+        prepared.delete(key);
+        throw error;
+      });
+      prepared.set(key, retained);
+      return retained;
+    })
+  );
+}
+
 // src/lib/memoryVault/vectorVersion.ts
 var vectorRowVersion = /* @__PURE__ */ new WeakMap();
 function contentFingerprint(content) {
@@ -17846,11 +17948,11 @@ async function rankComposite(originalQuery, originalQueryEmbedding, subQueries,
   return combined.slice(0, limit);
 }
 async function preEmbedVaultMemories(vaultCtx, embeddingOptions, cache, options) {
-  const memories = await getAllVaultMemoriesOp(vaultCtx, options);
+  const memories = await loadVaultCorpus(vaultCtx, options);
   const currentModel = embeddingOptions.model ?? DEFAULT_API_EMBEDDING_MODEL;
   const uncachedTexts = [];
   const uncachedKeys = [];
-  const uncachedIds = [];
+  const uncachedRows = [];
   const uncachedVersions = [];
   for (const m of memories) {
     const content = m.content;
@@ -17869,12 +17971,12 @@ async function preEmbedVaultMemories(vaultCtx, embeddingOptions, cache, options)
       }
       uncachedTexts.push(m.content);
       uncachedKeys.push(m.uniqueId);
-      uncachedIds.push(m.uniqueId);
+      uncachedRows.push(m);
       uncachedVersions.push(m.updatedAt);
     }
   }
   if (uncachedTexts.length > 0) {
-    const embeddings = await generateEmbeddings(uncachedTexts, embeddingOptions);
+    const embeddings = await embedVaultRows(vaultCtx, embeddingOptions, uncachedRows);
     for (let i = 0; i < uncachedKeys.length; i++) {
       cacheRowVector(
         cache,
@@ -17883,13 +17985,6 @@ async function preEmbedVaultMemories(vaultCtx, embeddingOptions, cache, options)
         uncachedVersions[i],
         uncachedTexts[i]
       );
-      updateVaultMemoryEmbeddingOp(
-        vaultCtx,
-        uncachedIds[i],
-        JSON.stringify(embeddings[i]),
-        currentModel
-      ).catch(() => {
-      });
     }
   }
 }
@@ -18031,10 +18126,7 @@ async function buildProjectedCorpus(query, vaultCtx, embeddingOptions, cache, qu
       let laneVecs;
       if (opts.embedStats) opts.embedStats.rowsEmbedded += laneRows.length;
       try {
-        laneVecs = await generateEmbeddings(
-          laneRows.map((m) => m.content),
-          embeddingOptions
-        );
+        laneVecs = await embedVaultRows(vaultCtx, embeddingOptions, laneRows);
       } catch (err) {
         laneEmbedFailed = true;
         getLogger().warn(
@@ -18048,13 +18140,6 @@ async function buildProjectedCorpus(query, vaultCtx, embeddingOptions, cache, qu
           cacheRowVector(cache, m.uniqueId, vec, m.updatedAt, m.content);
           resolvedThisCall.add(m.uniqueId);
           vectored.push({ uniqueId: m.uniqueId, embedding: vec, updatedAt: m.updatedAt });
-          updateVaultMemoryEmbeddingOp(
-            vaultCtx,
-            m.uniqueId,
-            JSON.stringify(vecs[i]),
-            currentModel
-          ).catch(() => {
-          });
         });
       }
     }
@@ -18246,9 +18331,10 @@ async function prepareVaultCandidates(query, vaultCtx, embeddingOptions, cache,
       };
     }
   } else {
-    const loaded = await getAllVaultMemoriesOp(
+    const loaded = await loadVaultCorpus(
       vaultCtx,
-      Object.keys(queryOpts).length > 0 ? queryOpts : void 0
+      Object.keys(queryOpts).length > 0 ? queryOpts : void 0,
+      searchOptions?.vaultPreparation
     );
     vaultSize = loaded.length;
     rowsDecrypted = loaded.length;
@@ -18321,7 +18407,12 @@ async function prepareVaultCandidates(query, vaultCtx, embeddingOptions, cache,
       let newEmbeddings;
       embedStats.rowsEmbedded += uncachedTexts.length;
       try {
-        newEmbeddings = await generateEmbeddings(uncachedTexts, embeddingOptions);
+        newEmbeddings = await embedVaultRows(
+          vaultCtx,
+          embeddingOptions,
+          uncachedIndices.map((index) => memories[index]),
+          searchOptions?.vaultPreparation
+        );
       } catch (err) {
         embeddingFailure = true;
         getLogger().warn(
@@ -18337,13 +18428,6 @@ async function prepareVaultCandidates(query, vaultCtx, embeddingOptions, cache,
             memories[uncachedIndices[j]].updatedAt,
             memories[uncachedIndices[j]].content
           );
-          updateVaultMemoryEmbeddingOp(
-            vaultCtx,
-            memories[uncachedIndices[j]].uniqueId,
-            JSON.stringify(newEmbeddings[j]),
-            currentModel
-          ).catch(() => {
-          });
         }
       }
     }
@@ -20898,6 +20982,7 @@ async function recall(query, ctx, options = {}) {
         },
         ...options.rrfK !== void 0 && { rrfK: options.rrfK },
         ...options.decryptLast !== void 0 && { decryptLast: options.decryptLast },
+        ...options.vaultPreparation && { vaultPreparation: options.vaultPreparation },
         ...subQueries && { subQueries },
         ...options.scopes && { scopes: options.scopes },
         ...options.folderId !== void 0 && { folderId: options.folderId },
@@ -22927,6 +23012,8 @@ async function backfillTopics(ctx) {
   if (topicless.length > 0) await backfillMemoryTopicsOp(ctx, topicless);
 }
 async function migrateMemoriesToRemote(options) {
+  if (typeof options.withWriteBarrier !== "function" || typeof options.onActivated !== "function")
+    throw new Error("A write barrier and a remote store handoff are required");
   const { canonical, signal } = options;
   const rings = [canonical, ...options.fallbacks ?? []];
   const model = options.embeddingOptions?.model ?? DEFAULT_API_EMBEDDING_MODEL;
@@ -22954,93 +23041,98 @@ async function migrateMemoriesToRemote(options) {
   const placeholders = /* @__PURE__ */ new Set();
   const truncated = /* @__PURE__ */ new Set();
   let imported = 0;
-  for (let pass = 0; ; pass++) {
-    const rows = await getAllVaultMemoryRowsOp(options.vaultCtx);
-    for (const raw of rows) if (invalid2(raw)) skipped.set(String(raw.id), "invalid");
-    const candidates = rows.filter((raw) => !skipped.has(String(raw.id)));
-    const missing = await missingIds(request, candidates.map(revision), signal);
-    const pending = /* @__PURE__ */ new Map();
-    for (const raw of candidates)
-      if (missing.has(raw.id)) pending.set(raw.id, raw.updated_at);
-    if (pending.size === 0 && !active) {
-      const remote = await remoteMetadata(
-        request,
-        candidates.map((raw) => raw.id),
-        signal
-      );
-      const needsVector = (raw, server) => !!options.embeddingOptions && !embedding(raw, model) && server.embedding_model !== model;
-      for (const raw of candidates) {
-        const server = remote.get(raw.id);
-        if (server && server.updated_at === raw.updated_at && (!sameMetadata2(raw, server, model) || needsVector(raw, server)))
-          pending.set(raw.id, raw.updated_at + 1);
-      }
-    }
-    if (pending.size === 0) {
-      const result = (state) => ({
-        state,
-        total: rows.length,
-        imported,
-        skipped: [...skipped].map(([memoryId, reason]) => ({ memoryId, reason })),
-        reembedded: reembedded.size,
-        unembedded: unembedded.size,
-        placeholderTombstones: placeholders.size,
-        truncatedSourceChunkIds: truncated.size
-      });
-      if (skipped.size > 0 && !options.allowSkipped) return result("migrating");
-      if (!claimed) await importBatch(request, canonical.keyId, [], signal);
-      if (!active)
-        await request(
-          "/account",
-          { method: "PUT", body: JSON.stringify({ state: "active" }) },
+  const uploadPasses = async (finalizing = false) => {
+    for (let pass = 0; ; pass++) {
+      const rows = await getAllVaultMemoryRowsOp(options.vaultCtx);
+      for (const raw of rows) if (invalid2(raw)) skipped.set(String(raw.id), "invalid");
+      const candidates = rows.filter((raw) => !skipped.has(String(raw.id)));
+      const missing = await missingIds(request, candidates.map(revision), signal);
+      const pending = /* @__PURE__ */ new Map();
+      for (const raw of candidates)
+        if (missing.has(raw.id)) pending.set(raw.id, raw.updated_at);
+      if (pending.size === 0 && !active) {
+        const remote = await remoteMetadata(
+          request,
+          candidates.map((raw) => raw.id),
           signal
         );
-      return result("active");
-    }
-    if (pass >= MAX_UPLOAD_PASSES)
-      throw new RemoteMemoryError(
-        "Nearby still reports memories missing after importing them",
-        409,
-        "migration_incomplete"
-      );
-    const prepared = [];
-    for (const raw of candidates) {
-      const updatedAt = pending.get(raw.id);
-      if (updatedAt === void 0) continue;
-      try {
-        prepared.push(await prepareRow(raw, canonical, rings, model, updatedAt));
-      } catch (error) {
-        if (!(error instanceof MemoryKeyError)) throw error;
-        skipped.set(raw.id, "unreadable");
-      }
-    }
-    const usable = new Set(prepared.filter((p) => p.row.embedding).map((p) => p.row.memory_id));
-    if (options.embeddingOptions)
-      await embedMissing(prepared, options.embeddingOptions, model, signal);
-    const local = new Map(candidates.map((raw) => [raw.id, raw]));
-    const upload = [];
-    for (const { row, plaintext } of prepared) {
-      const id2 = row.memory_id;
-      if (!fitsNearby(row)) {
-        skipped.set(id2, "invalid");
-        continue;
+        const needsVector = (raw, server) => !!options.embeddingOptions && !embedding(raw, model) && server.embedding_model !== model;
+        for (const raw of candidates) {
+          const server = remote.get(raw.id);
+          if (server && server.updated_at === raw.updated_at && (!sameMetadata2(raw, server, model) || needsVector(raw, server)))
+            pending.set(raw.id, raw.updated_at + 1);
+        }
+      }
+      if (pending.size === 0) {
+        const result = (state) => ({
+          state,
+          total: rows.length,
+          imported,
+          skipped: [...skipped].map(([memoryId, reason]) => ({ memoryId, reason })),
+          reembedded: reembedded.size,
+          unembedded: unembedded.size,
+          placeholderTombstones: placeholders.size,
+          truncatedSourceChunkIds: truncated.size
+        });
+        if (skipped.size > 0 && !options.allowSkipped) return result("migrating");
+        if (!finalizing) return options.withWriteBarrier(() => uploadPasses(true));
+        if (!claimed) await importBatch(request, canonical.keyId, [], signal);
+        if (!active)
+          await request(
+            "/account",
+            { method: "PUT", body: JSON.stringify({ state: "active" }) },
+            signal
+          );
+        await options.onActivated();
+        return result("active");
+      }
+      if (pass >= MAX_UPLOAD_PASSES)
+        throw new RemoteMemoryError(
+          "Nearby still reports memories missing after importing them",
+          409,
+          "migration_incomplete"
+        );
+      const prepared = [];
+      for (const raw of candidates) {
+        const updatedAt = pending.get(raw.id);
+        if (updatedAt === void 0) continue;
+        try {
+          prepared.push(await prepareRow(raw, canonical, rings, model, updatedAt));
+        } catch (error) {
+          if (!(error instanceof MemoryKeyError)) throw error;
+          skipped.set(raw.id, "unreadable");
+        }
+      }
+      const usable = new Set(prepared.filter((p) => p.row.embedding).map((p) => p.row.memory_id));
+      if (options.embeddingOptions)
+        await embedMissing(prepared, options.embeddingOptions, model, signal);
+      const local = new Map(candidates.map((raw) => [raw.id, raw]));
+      const upload = [];
+      for (const { row, plaintext } of prepared) {
+        const id2 = row.memory_id;
+        if (!fitsNearby(row)) {
+          skipped.set(id2, "invalid");
+          continue;
+        }
+        upload.push(row);
+        const track = (set, on) => on ? set.add(id2) : set.delete(id2);
+        track(reembedded, !!row.embedding && !usable.has(id2));
+        track(unembedded, !row.embedding);
+        track(placeholders, plaintext === void 0);
+        track(truncated, row.source_chunk_ids !== text13(local.get(id2).source_chunk_ids));
       }
-      upload.push(row);
-      const track = (set, on) => on ? set.add(id2) : set.delete(id2);
-      track(reembedded, !!row.embedding && !usable.has(id2));
-      track(unembedded, !row.embedding);
-      track(placeholders, plaintext === void 0);
-      track(truncated, row.source_chunk_ids !== text13(local.get(id2).source_chunk_ids));
-    }
-    let sent = 0;
-    options.onProgress?.({ imported: sent, toImport: upload.length });
-    for (const batch of chunks(upload, IMPORT_BATCH)) {
-      await importBatch(request, canonical.keyId, batch, signal);
-      claimed = true;
-      sent += batch.length;
+      let sent = 0;
       options.onProgress?.({ imported: sent, toImport: upload.length });
+      for (const batch of chunks(upload, IMPORT_BATCH)) {
+        await importBatch(request, canonical.keyId, batch, signal);
+        claimed = true;
+        sent += batch.length;
+        options.onProgress?.({ imported: sent, toImport: upload.length });
+      }
+      imported += sent;
     }
-    imported += sent;
-  }
+  };
+  return uploadPasses();
 }
 
 // src/lib/memory/store/remoteStore.ts
@@ -24496,13 +24588,20 @@ async function synthesizeProfile(ctx, options = {}) {
       }
     }
   }
+  const vaultPreparation = createVaultPreparation();
   const settled = await Promise.allSettled(
     facets.map(async (facet) => {
       const prior = previous?.sections.find((s) => s.key === facet.key);
       if (prior && !staleKeys.has(facet.key)) {
         return prior;
       }
-      return synthesizeFacet(facet, recallCtx, options, fallbackPriors.get(facet.key));
+      return synthesizeFacet(
+        facet,
+        recallCtx,
+        options,
+        fallbackPriors.get(facet.key),
+        vaultPreparation
+      );
     })
   );
   const sections = settled.map((r, i) => {
@@ -24656,7 +24755,7 @@ async function attributeFacts(ctx, candidates, facets) {
   }
   return keys;
 }
-async function synthesizeFacet(facet, ctx, options, prior) {
+async function synthesizeFacet(facet, ctx, options, prior, vaultPreparation) {
   const scopes = options.scopes ?? DEFAULT_SCOPES;
   const limit = options.limit ?? DEFAULT_FACET_RECALL_LIMIT;
   const factTypeWeights = { ...DEFAULT_PROFILE_FACT_TYPE_WEIGHTS, ...options.factTypeWeights };
@@ -24673,6 +24772,7 @@ async function synthesizeFacet(facet, ctx, options, prior) {
     };
   }
   const recalled = await recall(facet.query, ctx, {
+    vaultPreparation,
     scopes,
     limit: hasReviewGate ? RECALL_MAX_LIMIT : limit,
     types: ["fact"],

package/dist/expo/index.d.mts

@@ -3902,6 +3902,13 @@ interface RecencyOptions {
     noDateMultiplier?: number;
 }
 
+type VaultCorpusCache = WeakMap<VaultMemoryOperationsContext, Map<string, Promise<StoredVaultMemory[]>>>;
+type RowRequests = Map<EmbeddingOptions["maskInput"], Map<string, Promise<number[]>>>;
+interface VaultPreparation {
+    corpora: VaultCorpusCache;
+    rows: WeakMap<VaultMemoryOperationsContext, RowRequests>;
+}
+
 declare const DEFAULT_VAULT_CACHE_SIZE = 5000;
 /**
  * Create a VaultEmbeddingCache backed by an LRU with a default cap of
@@ -3919,6 +3926,7 @@ type VaultEmbeddingCache = Map<string, Float32Array>;
  * Options for the vault search tool.
  */
 interface MemoryVaultSearchOptions {
+    /** @internal */ vaultPreparation?: VaultPreparation;
     onCandidateCount?: (count: number) => void;
     /** Maximum number of results to return (default: 5) */
     limit?: number;
@@ -4441,6 +4449,7 @@ interface RankedMemory {
     updatedAt: Date;
 }
 interface RecallOptions {
+    /** @internal */ vaultPreparation?: VaultPreparation;
     /** Embedding cache shared with the rest of the turn, so the query is embedded once across lanes and the send. */
     embeddingCache?: Map<string, Float32Array>;
     /** Which kinds to search. Default: ['fact']. */
@@ -9931,6 +9940,10 @@ interface MemoryMigrationOptions extends Pick<RemoteMemoryPersistenceOptions, "b
         name: string;
         kind?: string;
     }[];
+    /** Drain all local memory writes, block new writes until the task returns, and retain the block if the remote handoff fails. */
+    withWriteBarrier: (task: () => Promise<MemoryMigrationResult>) => Promise<MemoryMigrationResult>;
+    /** Route all subsequent memory writes to the remote store before this callback returns. */
+    onActivated: () => void | Promise<void>;
     signal?: AbortSignal;
     onProgress?: (progress: MemoryMigrationProgress) => void;
 }

package/dist/expo/index.d.ts

@@ -3902,6 +3902,13 @@ interface RecencyOptions {
     noDateMultiplier?: number;
 }
 
+type VaultCorpusCache = WeakMap<VaultMemoryOperationsContext, Map<string, Promise<StoredVaultMemory[]>>>;
+type RowRequests = Map<EmbeddingOptions["maskInput"], Map<string, Promise<number[]>>>;
+interface VaultPreparation {
+    corpora: VaultCorpusCache;
+    rows: WeakMap<VaultMemoryOperationsContext, RowRequests>;
+}
+
 declare const DEFAULT_VAULT_CACHE_SIZE = 5000;
 /**
  * Create a VaultEmbeddingCache backed by an LRU with a default cap of
@@ -3919,6 +3926,7 @@ type VaultEmbeddingCache = Map<string, Float32Array>;
  * Options for the vault search tool.
  */
 interface MemoryVaultSearchOptions {
+    /** @internal */ vaultPreparation?: VaultPreparation;
     onCandidateCount?: (count: number) => void;
     /** Maximum number of results to return (default: 5) */
     limit?: number;
@@ -4441,6 +4449,7 @@ interface RankedMemory {
     updatedAt: Date;
 }
 interface RecallOptions {
+    /** @internal */ vaultPreparation?: VaultPreparation;
     /** Embedding cache shared with the rest of the turn, so the query is embedded once across lanes and the send. */
     embeddingCache?: Map<string, Float32Array>;
     /** Which kinds to search. Default: ['fact']. */
@@ -9931,6 +9940,10 @@ interface MemoryMigrationOptions extends Pick<RemoteMemoryPersistenceOptions, "b
         name: string;
         kind?: string;
     }[];
+    /** Drain all local memory writes, block new writes until the task returns, and retain the block if the remote handoff fails. */
+    withWriteBarrier: (task: () => Promise<MemoryMigrationResult>) => Promise<MemoryMigrationResult>;
+    /** Route all subsequent memory writes to the remote store before this callback returns. */
+    onActivated: () => void | Promise<void>;
     signal?: AbortSignal;
     onProgress?: (progress: MemoryMigrationProgress) => void;
 }