@anuma/sdk 9.1.3 → 9.1.4

package/dist/expo/index.cjs

@@ -22927,6 +22927,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 +22956,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

package/dist/expo/index.d.mts

@@ -9931,6 +9931,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

@@ -9931,6 +9931,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.mjs

@@ -21252,6 +21252,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;
@@ -21279,93 +21281,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);
+        }
       }
-      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;
+      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));
+      }
+      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

package/dist/react/index.cjs

@@ -25240,6 +25240,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;
@@ -25267,93 +25269,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

package/dist/react/index.d.mts

@@ -11665,6 +11665,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/react/index.d.ts

@@ -11665,6 +11665,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/react/index.mjs

@@ -23357,6 +23357,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;
@@ -23384,93 +23386,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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anuma/sdk",
-  "version": "9.1.3",
+  "version": "9.1.4",
   "description": "",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",