@anuma/sdk 6.8.2 → 6.9.0

package/dist/react/{chunk-NPJSO5ES.mjs → chunk-EJ65X4GI.mjs}

@@ -2321,13 +2321,13 @@ async function upsertEntitiesInWrite(ctx, entities) {
   }
   const unique = Array.from(kindByName.keys());
   const out = /* @__PURE__ */ new Map();
-  if (unique.length === 0) return { entities: out, operations: [] };
+  if (unique.length === 0) return { entities: out, operations: [], kindBackfills: [] };
   const existing = await ctx.entityCollection.query(Q2.where("canonical_name", Q2.oneOf(unique))).fetch();
   const existingNames = new Set(existing.map((e) => e.canonicalName));
-  const updates = existing.filter((e) => {
+  const kindBackfills = existing.filter((e) => {
     const incoming = kindByName.get(e.canonicalName);
     return incoming !== void 0 && (e.kind === null || e.kind === void 0 || e.kind === "");
-  });
+  }).map((record) => ({ record, kind: kindByName.get(record.canonicalName) }));
   const missing = unique.filter((n) => !existingNames.has(n));
   const created = missing.map(
     (name) => ctx.entityCollection.prepareCreate((record) => {
@@ -2336,14 +2336,19 @@ async function upsertEntitiesInWrite(ctx, entities) {
       if (kind !== void 0) record._setRaw("kind", kind);
     })
   );
-  const updated = updates.map(
-    (e) => e.prepareUpdate((record) => {
-      record._setRaw("kind", kindByName.get(e.canonicalName));
-    })
-  );
   for (const e of existing) out.set(e.canonicalName, entityToStored(e));
   for (const record of created) out.set(record.canonicalName, entityToStored(record));
-  return { entities: out, operations: [...created, ...updated] };
+  for (const { record, kind } of kindBackfills) {
+    out.set(record.canonicalName, { ...entityToStored(record), kind });
+  }
+  return { entities: out, operations: created, kindBackfills };
+}
+function prepareKindBackfills(backfills) {
+  return backfills.map(
+    ({ record, kind }) => record.prepareUpdate((r) => {
+      r._setRaw("kind", kind);
+    })
+  );
 }
 async function findVaultRowInWrite(ctx, memoryId) {
   try {
@@ -2393,10 +2398,12 @@ function topicsForEntities(entities, displayNames, source) {
 function toEntityObjects(entityInputs) {
   return entityInputs.map((e) => typeof e === "string" ? { name: e } : e);
 }
-async function prepareMemoryTopicsUpdate(ctx, memoryId, linked, inputs, source) {
+async function resolveMemoryTopicsWrite(ctx, memoryId, linked, inputs, source) {
   const row = await findVaultRowInWrite(ctx, memoryId);
-  const write = resolveTopicsWrite(row, linked, displayNamesOf(toEntityObjects(inputs)), source);
-  return write === null ? null : prepareTopicsUpdate(write.row, write.topics, Date.now());
+  return resolveTopicsWrite(row, linked, displayNamesOf(toEntityObjects(inputs)), source);
+}
+function prepareMemoryTopicsUpdate(write) {
+  return prepareTopicsUpdate(write.row, write.topics, Date.now());
 }
 async function linkMemoryEntitiesOp(ctx, memoryId, entityInputs, options) {
   if (entityInputs.length === 0) return [];
@@ -2405,15 +2412,16 @@ async function linkMemoryEntitiesOp(ctx, memoryId, entityInputs, options) {
   let skipped = false;
   let entities = [];
   await ctx.database.write(async () => {
-    const { entities: byName, operations: entityOps } = await upsertEntitiesInWrite(
-      ctx,
-      normalized
-    );
+    const {
+      entities: byName,
+      operations: entityOps,
+      kindBackfills
+    } = await upsertEntitiesInWrite(ctx, normalized);
     entities = Array.from(byName.values());
     const vaultRow = await findVaultRowInWrite(ctx, memoryId);
     if (options?.unlessTopicsUserManaged && autoLinkBlocked(vaultRow)) {
-      if (entityOps.length > 0) {
-        await ctx.database.batch(...entityOps);
+      if (entityOps.length > 0 || kindBackfills.length > 0) {
+        await ctx.database.batch(...entityOps, ...prepareKindBackfills(kindBackfills));
       }
       skipped = true;
       return;
@@ -2433,7 +2441,9 @@ async function linkMemoryEntitiesOp(ctx, memoryId, entityInputs, options) {
       displayNamesOf(normalized),
       options?.topicsSource ?? "auto"
     );
-    if (entityOps.length === 0 && toCreate.length === 0 && topicsWrite === null) return;
+    if (entityOps.length === 0 && kindBackfills.length === 0 && toCreate.length === 0 && topicsWrite === null) {
+      return;
+    }
     const linkOps = toCreate.map(
       (e) => ctx.memoryEntityCollection.prepareCreate((record) => {
         record._setRaw("memory_id", memoryId);
@@ -2443,6 +2453,7 @@ async function linkMemoryEntitiesOp(ctx, memoryId, entityInputs, options) {
     );
     await ctx.database.batch(
       ...entityOps,
+      ...prepareKindBackfills(kindBackfills),
       ...linkOps,
       ...topicsWrite ? [prepareTopicsUpdate(topicsWrite.row, topicsWrite.topics, Date.now())] : []
     );
@@ -2480,10 +2491,11 @@ async function replaceMemoryEntities(ctx, memoryId, entityInputs, options) {
       skipped = true;
       return;
     }
-    const { entities: byName, operations: entityOps } = await upsertEntitiesInWrite(
-      ctx,
-      normalized
-    );
+    const {
+      entities: byName,
+      operations: entityOps,
+      kindBackfills
+    } = await upsertEntitiesInWrite(ctx, normalized);
     entities = Array.from(byName.values());
     const existingLinks = await ctx.memoryEntityCollection.query(Q2.where("memory_id", memoryId)).fetch();
     const keep = new Set(entities.map((e) => e.uniqueId));
@@ -2496,12 +2508,13 @@ async function replaceMemoryEntities(ctx, memoryId, entityInputs, options) {
       displayNamesOf(normalized),
       options.topicsSource
     );
-    if (entityOps.length === 0 && toCreate.length === 0 && toDestroy.length === 0 && topicsWrite === null) {
+    if (entityOps.length === 0 && kindBackfills.length === 0 && toCreate.length === 0 && toDestroy.length === 0 && topicsWrite === null) {
       return;
     }
     const orphans = await findOrphanedEntities(ctx, memoryId, toDestroy);
     await ctx.database.batch(
       ...entityOps,
+      ...prepareKindBackfills(kindBackfills),
       ...toCreate.map(
         (e) => ctx.memoryEntityCollection.prepareCreate((record) => {
           record._setRaw("memory_id", memoryId);
@@ -3314,10 +3327,16 @@ async function setMemoryEntitiesOp(ctx, memoryId, entities) {
     const existing = await entityCtx.memoryEntityCollection.query(Q3.where("memory_id", memoryId)).fetch();
     const staleLinks = existing.filter((l) => !keep.has(String(l.entityId)));
     if (staleLinks.length === 0 && entities.length > 0) return;
-    const topicsOp = await prepareMemoryTopicsUpdate(entityCtx, memoryId, linked, entities, "user");
+    const topicsWrite = await resolveMemoryTopicsWrite(
+      entityCtx,
+      memoryId,
+      linked,
+      entities,
+      "user"
+    );
     await ctx.database.batch(
       ...staleLinks.map((l) => l.prepareDestroyPermanently()),
-      ...topicsOp ? [topicsOp] : []
+      ...topicsWrite ? [prepareMemoryTopicsUpdate(topicsWrite)] : []
     );
   });
   if (stale) return null;
@@ -3636,27 +3655,36 @@ async function backfillMemoryTopicsOp(ctx, memoryIds) {
   if (!entityCtx) {
     throw new Error("backfillMemoryTopicsOp requires ctx.entityCtx");
   }
+  const uniqueIds = Array.from(new Set(memoryIds));
+  if (uniqueIds.length === 0) return [];
   const filled = [];
-  for (const id of Array.from(new Set(memoryIds))) {
-    let record;
-    try {
-      record = await ctx.vaultMemoryCollection.find(id);
-    } catch {
-      continue;
-    }
-    if (record.isDeleted || !isOwnedByCtxUser(ctx, record)) continue;
-    if (parseTopics(record.topics) !== null) continue;
-    const links = await entityCtx.memoryEntityCollection.query(Q3.where("memory_id", id)).unsafeFetchRaw();
-    const entityIds = links.map((l) => String(l.entity_id));
-    if (entityIds.length === 0) continue;
-    const entities = await entityCtx.entityCollection.query(Q3.where("id", Q3.oneOf(entityIds))).fetch();
-    if (entities.length === 0) continue;
-    const source = record.topicsUserManaged ? "user" : "auto";
+  const CHUNK = 500;
+  for (let i = 0; i < uniqueIds.length; i += CHUNK) {
+    const chunkIds = uniqueIds.slice(i, i + CHUNK);
     await ctx.database.write(async () => {
-      const topicsOp = await prepareMemoryTopicsUpdate(entityCtx, id, entities, [], source);
-      if (!topicsOp) return;
-      await ctx.database.batch(topicsOp);
-      filled.push(id);
+      const writes = [];
+      for (const id of chunkIds) {
+        let record;
+        try {
+          record = await ctx.vaultMemoryCollection.find(id);
+        } catch {
+          continue;
+        }
+        if (record.isDeleted || !isOwnedByCtxUser(ctx, record)) continue;
+        if (parseTopics(record.topics) !== null) continue;
+        const links = await entityCtx.memoryEntityCollection.query(Q3.where("memory_id", id)).unsafeFetchRaw();
+        const entityIds = links.map((l) => String(l.entity_id));
+        if (entityIds.length === 0) continue;
+        const entities = await entityCtx.entityCollection.query(Q3.where("id", Q3.oneOf(entityIds))).fetch();
+        if (entities.length === 0) continue;
+        const source = record.topicsUserManaged ? "user" : "auto";
+        const write = await resolveMemoryTopicsWrite(entityCtx, id, entities, [], source);
+        if (write) writes.push(write);
+      }
+      if (writes.length === 0) return;
+      const prepared = writes.map(prepareMemoryTopicsUpdate);
+      await ctx.database.batch(...prepared);
+      for (const write of writes) filled.push(write.row.id);
     });
   }
   return filled;
@@ -7096,7 +7124,7 @@ function createMemoryVaultSearchTool(vaultCtx, embeddingOptions, cache, searchOp
             subQueries = decomp.subQueries;
           }
         }
-        const { recall: recall2 } = await import("./recall-3I5GDJZE.mjs");
+        const { recall: recall2 } = await import("./recall-FWILZSFH.mjs");
         let recallDegraded = [];
         const result = await recall2(
           query,

package/dist/react/index.cjs

@@ -4888,13 +4888,13 @@ async function upsertEntitiesInWrite(ctx, entities) {
   }
   const unique = Array.from(kindByName.keys());
   const out = /* @__PURE__ */ new Map();
-  if (unique.length === 0) return { entities: out, operations: [] };
+  if (unique.length === 0) return { entities: out, operations: [], kindBackfills: [] };
   const existing = await ctx.entityCollection.query(import_watermelondb9.Q.where("canonical_name", import_watermelondb9.Q.oneOf(unique))).fetch();
   const existingNames = new Set(existing.map((e) => e.canonicalName));
-  const updates = existing.filter((e) => {
+  const kindBackfills = existing.filter((e) => {
     const incoming = kindByName.get(e.canonicalName);
     return incoming !== void 0 && (e.kind === null || e.kind === void 0 || e.kind === "");
-  });
+  }).map((record) => ({ record, kind: kindByName.get(record.canonicalName) }));
   const missing = unique.filter((n) => !existingNames.has(n));
   const created = missing.map(
     (name) => ctx.entityCollection.prepareCreate((record) => {
@@ -4903,14 +4903,19 @@ async function upsertEntitiesInWrite(ctx, entities) {
       if (kind !== void 0) record._setRaw("kind", kind);
     })
   );
-  const updated = updates.map(
-    (e) => e.prepareUpdate((record) => {
-      record._setRaw("kind", kindByName.get(e.canonicalName));
-    })
-  );
   for (const e of existing) out.set(e.canonicalName, entityToStored(e));
   for (const record of created) out.set(record.canonicalName, entityToStored(record));
-  return { entities: out, operations: [...created, ...updated] };
+  for (const { record, kind } of kindBackfills) {
+    out.set(record.canonicalName, { ...entityToStored(record), kind });
+  }
+  return { entities: out, operations: created, kindBackfills };
+}
+function prepareKindBackfills(backfills) {
+  return backfills.map(
+    ({ record, kind }) => record.prepareUpdate((r) => {
+      r._setRaw("kind", kind);
+    })
+  );
 }
 async function findVaultRowInWrite(ctx, memoryId) {
   try {
@@ -4960,10 +4965,12 @@ function topicsForEntities(entities, displayNames, source) {
 function toEntityObjects(entityInputs) {
   return entityInputs.map((e) => typeof e === "string" ? { name: e } : e);
 }
-async function prepareMemoryTopicsUpdate(ctx, memoryId, linked, inputs, source) {
+async function resolveMemoryTopicsWrite(ctx, memoryId, linked, inputs, source) {
   const row = await findVaultRowInWrite(ctx, memoryId);
-  const write = resolveTopicsWrite(row, linked, displayNamesOf(toEntityObjects(inputs)), source);
-  return write === null ? null : prepareTopicsUpdate(write.row, write.topics, Date.now());
+  return resolveTopicsWrite(row, linked, displayNamesOf(toEntityObjects(inputs)), source);
+}
+function prepareMemoryTopicsUpdate(write) {
+  return prepareTopicsUpdate(write.row, write.topics, Date.now());
 }
 async function linkMemoryEntitiesOp(ctx, memoryId, entityInputs, options) {
   if (entityInputs.length === 0) return [];
@@ -4972,15 +4979,16 @@ async function linkMemoryEntitiesOp(ctx, memoryId, entityInputs, options) {
   let skipped = false;
   let entities = [];
   await ctx.database.write(async () => {
-    const { entities: byName, operations: entityOps } = await upsertEntitiesInWrite(
-      ctx,
-      normalized
-    );
+    const {
+      entities: byName,
+      operations: entityOps,
+      kindBackfills
+    } = await upsertEntitiesInWrite(ctx, normalized);
     entities = Array.from(byName.values());
     const vaultRow = await findVaultRowInWrite(ctx, memoryId);
     if (options?.unlessTopicsUserManaged && autoLinkBlocked(vaultRow)) {
-      if (entityOps.length > 0) {
-        await ctx.database.batch(...entityOps);
+      if (entityOps.length > 0 || kindBackfills.length > 0) {
+        await ctx.database.batch(...entityOps, ...prepareKindBackfills(kindBackfills));
       }
       skipped = true;
       return;
@@ -5000,7 +5008,9 @@ async function linkMemoryEntitiesOp(ctx, memoryId, entityInputs, options) {
       displayNamesOf(normalized),
       options?.topicsSource ?? "auto"
     );
-    if (entityOps.length === 0 && toCreate.length === 0 && topicsWrite === null) return;
+    if (entityOps.length === 0 && kindBackfills.length === 0 && toCreate.length === 0 && topicsWrite === null) {
+      return;
+    }
     const linkOps = toCreate.map(
       (e) => ctx.memoryEntityCollection.prepareCreate((record) => {
         record._setRaw("memory_id", memoryId);
@@ -5010,6 +5020,7 @@ async function linkMemoryEntitiesOp(ctx, memoryId, entityInputs, options) {
     );
     await ctx.database.batch(
       ...entityOps,
+      ...prepareKindBackfills(kindBackfills),
       ...linkOps,
       ...topicsWrite ? [prepareTopicsUpdate(topicsWrite.row, topicsWrite.topics, Date.now())] : []
     );
@@ -5047,10 +5058,11 @@ async function replaceMemoryEntities(ctx, memoryId, entityInputs, options) {
       skipped = true;
       return;
     }
-    const { entities: byName, operations: entityOps } = await upsertEntitiesInWrite(
-      ctx,
-      normalized
-    );
+    const {
+      entities: byName,
+      operations: entityOps,
+      kindBackfills
+    } = await upsertEntitiesInWrite(ctx, normalized);
     entities = Array.from(byName.values());
     const existingLinks = await ctx.memoryEntityCollection.query(import_watermelondb9.Q.where("memory_id", memoryId)).fetch();
     const keep = new Set(entities.map((e) => e.uniqueId));
@@ -5063,12 +5075,13 @@ async function replaceMemoryEntities(ctx, memoryId, entityInputs, options) {
       displayNamesOf(normalized),
       options.topicsSource
     );
-    if (entityOps.length === 0 && toCreate.length === 0 && toDestroy.length === 0 && topicsWrite === null) {
+    if (entityOps.length === 0 && kindBackfills.length === 0 && toCreate.length === 0 && toDestroy.length === 0 && topicsWrite === null) {
       return;
     }
     const orphans = await findOrphanedEntities(ctx, memoryId, toDestroy);
     await ctx.database.batch(
       ...entityOps,
+      ...prepareKindBackfills(kindBackfills),
       ...toCreate.map(
         (e) => ctx.memoryEntityCollection.prepareCreate((record) => {
           record._setRaw("memory_id", memoryId);
@@ -5897,10 +5910,16 @@ async function setMemoryEntitiesOp(ctx, memoryId, entities) {
     const existing = await entityCtx.memoryEntityCollection.query(import_watermelondb10.Q.where("memory_id", memoryId)).fetch();
     const staleLinks = existing.filter((l) => !keep.has(String(l.entityId)));
     if (staleLinks.length === 0 && entities.length > 0) return;
-    const topicsOp = await prepareMemoryTopicsUpdate(entityCtx, memoryId, linked, entities, "user");
+    const topicsWrite = await resolveMemoryTopicsWrite(
+      entityCtx,
+      memoryId,
+      linked,
+      entities,
+      "user"
+    );
     await ctx.database.batch(
       ...staleLinks.map((l) => l.prepareDestroyPermanently()),
-      ...topicsOp ? [topicsOp] : []
+      ...topicsWrite ? [prepareMemoryTopicsUpdate(topicsWrite)] : []
     );
   });
   if (stale) return null;
@@ -6218,27 +6237,36 @@ async function backfillMemoryTopicsOp(ctx, memoryIds) {
   if (!entityCtx) {
     throw new Error("backfillMemoryTopicsOp requires ctx.entityCtx");
   }
+  const uniqueIds = Array.from(new Set(memoryIds));
+  if (uniqueIds.length === 0) return [];
   const filled = [];
-  for (const id of Array.from(new Set(memoryIds))) {
-    let record;
-    try {
-      record = await ctx.vaultMemoryCollection.find(id);
-    } catch {
-      continue;
-    }
-    if (record.isDeleted || !isOwnedByCtxUser(ctx, record)) continue;
-    if (parseTopics(record.topics) !== null) continue;
-    const links = await entityCtx.memoryEntityCollection.query(import_watermelondb10.Q.where("memory_id", id)).unsafeFetchRaw();
-    const entityIds = links.map((l) => String(l.entity_id));
-    if (entityIds.length === 0) continue;
-    const entities = await entityCtx.entityCollection.query(import_watermelondb10.Q.where("id", import_watermelondb10.Q.oneOf(entityIds))).fetch();
-    if (entities.length === 0) continue;
-    const source = record.topicsUserManaged ? "user" : "auto";
+  const CHUNK = 500;
+  for (let i = 0; i < uniqueIds.length; i += CHUNK) {
+    const chunkIds = uniqueIds.slice(i, i + CHUNK);
     await ctx.database.write(async () => {
-      const topicsOp = await prepareMemoryTopicsUpdate(entityCtx, id, entities, [], source);
-      if (!topicsOp) return;
-      await ctx.database.batch(topicsOp);
-      filled.push(id);
+      const writes = [];
+      for (const id of chunkIds) {
+        let record;
+        try {
+          record = await ctx.vaultMemoryCollection.find(id);
+        } catch {
+          continue;
+        }
+        if (record.isDeleted || !isOwnedByCtxUser(ctx, record)) continue;
+        if (parseTopics(record.topics) !== null) continue;
+        const links = await entityCtx.memoryEntityCollection.query(import_watermelondb10.Q.where("memory_id", id)).unsafeFetchRaw();
+        const entityIds = links.map((l) => String(l.entity_id));
+        if (entityIds.length === 0) continue;
+        const entities = await entityCtx.entityCollection.query(import_watermelondb10.Q.where("id", import_watermelondb10.Q.oneOf(entityIds))).fetch();
+        if (entities.length === 0) continue;
+        const source = record.topicsUserManaged ? "user" : "auto";
+        const write = await resolveMemoryTopicsWrite(entityCtx, id, entities, [], source);
+        if (write) writes.push(write);
+      }
+      if (writes.length === 0) return;
+      const prepared = writes.map(prepareMemoryTopicsUpdate);
+      await ctx.database.batch(...prepared);
+      for (const write of writes) filled.push(write.row.id);
     });
   }
   return filled;
@@ -18387,7 +18415,7 @@ function createAutoExtractor(options) {
     const t0 = Date.now();
     void (async () => {
       try {
-        const { candidates, results, failedCount, outcome } = await extractAndRetain(
+        const { candidates, results, failedCount, outcome, failure } = await extractAndRetain(
           window2,
           retainCtx,
           {
@@ -18427,7 +18455,11 @@ function createAutoExtractor(options) {
           failedCount,
           durationMs: Date.now() - t0,
           conversationId,
-          outcome
+          outcome,
+          // Only set alongside `outcome: "empty-after-retry"`. Spread so the key
+          // is absent rather than explicitly undefined on a healthy turn —
+          // analytics backends store an explicit undefined as a real value.
+          ...failure !== void 0 && { failure }
         });
       } catch (err) {
         options.onError?.(err instanceof Error ? err : new Error(String(err)), conversationId);

package/dist/react/index.d.mts

@@ -8114,6 +8114,14 @@ declare function relinkMemoryTopicsOp(ctx: VaultMemoryOperationsContext, memoryI
  * row has: a curated memory's topics are recorded as `user`, everything else as
  * `auto`. Skips deleted, foreign-user, unlinked rows, and rows that already have
  * a record. Returns the ids filled.
+ *
+ * Runs as ONE writer over the whole (caller-bounded) list, in two phases:
+ * resolve every row's write — all the awaits — and only then prepare and batch,
+ * synchronously. Resolving and preparing per row inside its own writer is what
+ * fired WatermelonDB's "wasn't sent to batch() synchronously" diagnostic once
+ * per memory (~107 on a single dev launch, sdk#891); it also cost N writes.
+ * Same treatment as {@link stampTopicsExtractedAtOp}, including its
+ * transpilation hazard — the prepare pass MUST stay a `.map()`.
  */
 declare function backfillMemoryTopicsOp(ctx: VaultMemoryOperationsContext, memoryIds: readonly string[]): Promise<string[]>;
 declare function deleteAllVaultMemoriesForUserOp(ctx: VaultMemoryOperationsContext, userId: string): Promise<number>;
@@ -8398,6 +8406,22 @@ interface TurnCompleteEvent {
      * previously indistinguishable (both surfaced as zero candidates).
      */
     outcome: ExtractOutcome;
+    /**
+     * Present only alongside `outcome: "empty-after-retry"` — WHICH failure ended
+     * the turn (#888).
+     *
+     * `outcome` says extraction gave up; this says why, from a stable enum. The
+     * distinction is the whole point: a 2026-08-11 audit measured ~63% of
+     * production extraction turns ending in `empty-after-retry` and could not tell
+     * from telemetry whether the cause was the freeloader 403 everyone assumed or
+     * something else. It took a Prometheus cross-check to find the real one — the
+     * portal returning HTTP 200 with an empty body, which it counts as a success.
+     *
+     * Forward `failure.reason` into your extraction analytics event; all three
+     * fields are bounded (an enum, an HTTP status, a small attempt count) and none
+     * carries content.
+     */
+    failure?: PortalLlmFailure;
 }
 /** @public */
 /**

package/dist/react/index.d.ts

@@ -8114,6 +8114,14 @@ declare function relinkMemoryTopicsOp(ctx: VaultMemoryOperationsContext, memoryI
  * row has: a curated memory's topics are recorded as `user`, everything else as
  * `auto`. Skips deleted, foreign-user, unlinked rows, and rows that already have
  * a record. Returns the ids filled.
+ *
+ * Runs as ONE writer over the whole (caller-bounded) list, in two phases:
+ * resolve every row's write — all the awaits — and only then prepare and batch,
+ * synchronously. Resolving and preparing per row inside its own writer is what
+ * fired WatermelonDB's "wasn't sent to batch() synchronously" diagnostic once
+ * per memory (~107 on a single dev launch, sdk#891); it also cost N writes.
+ * Same treatment as {@link stampTopicsExtractedAtOp}, including its
+ * transpilation hazard — the prepare pass MUST stay a `.map()`.
  */
 declare function backfillMemoryTopicsOp(ctx: VaultMemoryOperationsContext, memoryIds: readonly string[]): Promise<string[]>;
 declare function deleteAllVaultMemoriesForUserOp(ctx: VaultMemoryOperationsContext, userId: string): Promise<number>;
@@ -8398,6 +8406,22 @@ interface TurnCompleteEvent {
      * previously indistinguishable (both surfaced as zero candidates).
      */
     outcome: ExtractOutcome;
+    /**
+     * Present only alongside `outcome: "empty-after-retry"` — WHICH failure ended
+     * the turn (#888).
+     *
+     * `outcome` says extraction gave up; this says why, from a stable enum. The
+     * distinction is the whole point: a 2026-08-11 audit measured ~63% of
+     * production extraction turns ending in `empty-after-retry` and could not tell
+     * from telemetry whether the cause was the freeloader 403 everyone assumed or
+     * something else. It took a Prometheus cross-check to find the real one — the
+     * portal returning HTTP 200 with an empty body, which it counts as a success.
+     *
+     * Forward `failure.reason` into your extraction analytics event; all three
+     * fields are bounded (an enum, an HTTP status, a small attempt count) and none
+     * carries content.
+     */
+    failure?: PortalLlmFailure;
 }
 /** @public */
 /**

package/dist/react/index.mjs

@@ -178,7 +178,7 @@ import {
   updateVaultMemoryOp,
   useEncryption,
   vaultMemoryToStored
-} from "./chunk-NPJSO5ES.mjs";
+} from "./chunk-EJ65X4GI.mjs";
 import {
   PiiRedactor,
   createStreamingDeAnonymizer,
@@ -8357,7 +8357,7 @@ function createAutoExtractor(options) {
     const t0 = Date.now();
     void (async () => {
       try {
-        const { candidates, results, failedCount, outcome } = await extractAndRetain(
+        const { candidates, results, failedCount, outcome, failure } = await extractAndRetain(
           window2,
           retainCtx,
           {
@@ -8397,7 +8397,11 @@ function createAutoExtractor(options) {
           failedCount,
           durationMs: Date.now() - t0,
           conversationId,
-          outcome
+          outcome,
+          // Only set alongside `outcome: "empty-after-retry"`. Spread so the key
+          // is absent rather than explicitly undefined on a healthy turn —
+          // analytics backends store an explicit undefined as a real value.
+          ...failure !== void 0 && { failure }
         });
       } catch (err) {
         options.onError?.(err instanceof Error ? err : new Error(String(err)), conversationId);

package/dist/react/{recall-3I5GDJZE.mjs → recall-FWILZSFH.mjs}

@@ -1,6 +1,6 @@
 import {
   recall
-} from "./chunk-NPJSO5ES.mjs";
+} from "./chunk-EJ65X4GI.mjs";
 import "./chunk-CJ32HO6Q.mjs";
 import "./chunk-GYKJOWEO.mjs";
 export {