@anuma/sdk 6.8.2 → 6.10.0

package/dist/expo/index.d.ts

@@ -6768,6 +6768,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>;
@@ -7230,6 +7238,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 */
 /**
@@ -8495,6 +8519,39 @@ interface TopicExtractOptions extends PortalLlmAuth {
  * later sweep, never stamp them.
  */
 declare function extractEntitiesForMemories(memories: readonly TopicExtractionInput[], options: TopicExtractOptions): Promise<Map<string, ExtractedEntity[]>>;
+/**
+ * Why one memory was skipped by a topic sweep.
+ *
+ * Split along the line that actually matters operationally — did the sweep
+ * DECLINE this row on purpose, or did something BREAK:
+ *
+ * Deliberate (healthy; a sweep of nothing but these is a success):
+ * - `excluded`        — deleted, owned by another user, or `topicsUserManaged`.
+ * - `link-declined`   — the entity-link write's in-row guard declined (the row
+ *                       became user-managed / deleted / absent mid-run).
+ * - `stamp-declined`  — same, caught by the stamp op's own re-check.
+ *
+ * Degraded (something is wrong; see {@link isDegradedTopicSkip}):
+ * - `llm-unanswered`  — the batch failed or the model omitted this id. THE one
+ *                       to alarm on: it is how a wholly broken sweep looks.
+ * - `unreadable`      — the row could not be loaded/decrypted.
+ * - `not-found`       — the lookup threw (absent row or read fault).
+ * - `link-failed`     — the entity-link write threw.
+ *
+ * @public
+ */
+type TopicSkipReason = "excluded" | "link-declined" | "stamp-declined" | "llm-unanswered" | "unreadable" | "not-found" | "link-failed";
+/**
+ * Whether a skip reason means the sweep FAILED on that row, rather than
+ * deliberately passing over it.
+ *
+ * Exported so callers classify identically instead of each re-deriving the
+ * split — the reason this type exists is that one wrong grouping turns a broken
+ * sweep back into a healthy-looking one.
+ *
+ * @public
+ */
+declare function isDegradedTopicSkip(reason: TopicSkipReason): boolean;
 /** Outcome of one {@link extractAndLinkEntitiesForMemoriesOp} run. */
 interface TopicExtractionRunResult {
     /** memoryId → entities the LLM returned (post-validation, post-linking). */
@@ -8507,6 +8564,24 @@ interface TopicExtractionRunResult {
      * LLM batches. Skipped ids are not stamped, so failed batches are retried
      * by a later sweep — callers should apply their own attempt caps. */
     skippedIds: string[];
+    /**
+     * Why each id in {@link skippedIds} was skipped.
+     *
+     * `skippedIds` alone cannot distinguish a sweep that deliberately declined
+     * work from one that FAILED: a run where every LLM batch errored and a run
+     * over rows the user has taken manual control of produce an identical array.
+     * That is the same blindness `outcome: 'empty-after-retry'` had before #888 —
+     * a degradation wearing the shape of normal control flow.
+     *
+     * It matters here because topics feed the entity recall lane, so a silently
+     * failing sweep means memories that exist but cannot be found by entity, with
+     * nothing in production saying so.
+     *
+     * Populated in lockstep with `skippedIds` (single `skip()` helper), so the two
+     * cannot drift. Group by {@link isDegradedTopicSkip} to separate "declined" from
+     * "broke".
+     */
+    skippedReasons: Map<string, TopicSkipReason>;
 }
 /**
  * Run LLM topic extraction over existing vault memories and persist the
@@ -10353,4 +10428,4 @@ declare function refreshNotionAccessToken(params: NotionRefreshTokenParams): Pro
  */
 declare function createNotionTools(getAccessToken: () => string | null, requestNotionAccess: () => Promise<string>): ToolConfig[];
 
-export { type AutoExtractMessage, type AutoExtractor, type Budget, CHUNKS_DISCARDED_ORIGIN, type CachedChunkVectors, type CachedServerTools, Conversation as ChatConversation, Message as ChatMessage, type ChatRole, type ChunkVectorCache, type ChunkingOptions, type ConsolidationFallbackReason, type ConversationMemoryInput, ConversationMemory as ConversationMemoryModel, type ConversationMemoryOperationsContext, type CreateAutoExtractorOptions, type CreateConversationOptions, type CreateDecaySweeperOptions, type CreateMessageOptions, type CreateVaultFolderOptions, type CreateVaultMemoryOptions, type CryptoPriceClassification, type CryptoPricePreProcessorOptions, DEFAULT_CACHE_EXPIRATION_MS, DEFAULT_CHUNK_CACHE_SIZE, DEFAULT_CHUNK_OVERLAP, DEFAULT_CHUNK_SIZE, DEFAULT_DECAY_POLICY, DEFAULT_MAX_CLASSIFIER_CALLS_PER_SWEEP, DEFAULT_MIN_CHUNK_SIZE, DEFAULT_PROFILE_FACETS, DEFAULT_PROFILE_FACT_TYPE_WEIGHTS, DEFAULT_PROFILE_PROOF_ALPHA, DEFAULT_PROFILE_TREND_MULTIPLIERS, DEFAULT_VAULT_CACHE_SIZE, DatabaseManager, type DatabaseManagerLogger, type DatabaseManagerOptions, type DecayCandidateRaw, type DecayClassifier, type DecayInput, type DecayPolicy, type DecaySweepResult, type DecaySweeper, type DecayVerdict, ENTITY_FANOUT, type EmbeddedWalletSignerFn, EncryptionKeyMissingError, type ExtractFactsOptions, type ExtractOutcome, type ExtractedCandidate, type ExtractedEntity, type ExtractionCursorStore, type FactType, type FileMetadata, type FlushResult, type GetConversationsPageOptions, type GetMessagesPageOptions, type GraphTraversalOptions, HARD_DELETE_WINDOW_MS, INFERENCE_ID_HEADER, type InjectionClassifierOptions, type InjectionReason, type LazyStoredConversation, type LlmDecayClassifierOptions, type LlmNeighborRefinerOptions, type Logger, LoggerProvider, type LoggerProviderProps, MAX_HOPS, MEDIUM_TTL_MS, type MemoriesNeedingTopicExtraction, type EmbeddingOptions as MemoryEngineEmbeddingOptions, type MemoryEngineResult, type MemoryEngineSearchOptions, type MemoryExtractedEvent, type MemoryKind, type MemoryQuarantinedEvent, type MemoryToVerify, type MemoryVaultSearchOptions, type MemoryVaultToolOptions, type MemoryVerification, type MessageRedactionResult, type MessageSkeleton, NEVER_TTL_MS, NODE_BUDGET, NOTION_OAUTH_CONFIG, type NeighborRefiner, type NotionAuthUrlParams, type NotionClientRegistration, type NotionExchangeCodeParams, type NotionOAuthEndpoints, type NotionPKCEChallenge, type NotionRefreshTokenParams, type NotionTokenResponse, type NowSource, type ObservationTrend, type ObservationTrendInput, PAST_EVENT_GRACE_MS, PII_PATTERNS, PROFILE_DOC_VERSION, type PhotoIngestResult, type PhotoMediaRef, type PiiCategory, type PiiMatch, type PiiPattern, PiiRedactor, type PiiRedactorOptions, type PlatformStorage, type PortalLlmAuth, type PortalLlmFailure, type PortalLlmFailureReason, type ProfileConfigFingerprint, type ProfileDoc, type ProfileFacet, type ProfileFacetKey, type ProfileSalienceInput, type ProfileSection, type PromptPreProcessor, type PromptPreProcessorContext, type PublishedPhotoMemory, type QuantizedEmbedding, type QuarantinedMemoryInfo, QueueManager, type QueueStatus, RECALL_MAX_LIMIT, RECALL_TOOL_NAME, type RankableVaultMemory, type RankedMemory, type RankedProfileCandidate, type RecallContext, type RecallDegradation, type RecallDiagnostics, type RecallOptions, type RecallResult, type RecallToolCallbacks, type RecallToolOptions, type RecencyOptions, type RedactionResult, type ReflectOptions, type ReflectResult, type RequestEncryptionKeyOptions, RerankerUnavailableError, type ResumeStreamOptions, type ResumeStreamResult, type ResumeStreamWithStorageResult, type RetainAction, type RetainContext, type RetainOptions, type RetainResult, type RetainSource, SDK_SCHEMA_VERSION, SHORT_TTL_MS, STREAM_RESUMABLE_HEADER, type ScoreBreakdown, type ScoreProfileSalienceOptions, type ScreenResult, type ScreenedCandidate, type SearchSource, type SendMessageWithStorageArgs, type SendMessageWithStorageDetachedResult, type SendMessageWithStorageResult, type ServerToolsOptions, type ServerToolsResponse, type SignMessageFn, type StockPriceClassification, type StockPricePreProcessorOptions, type ChatCompletionUsage as StoredChatCompletionUsage, type StoredConversation, type StoredConversationMemory, type StoredMessage, type StoredMessageWithSimilarity, type StoredVaultFolder, VaultFolder as StoredVaultFolderModel, type StoredVaultMemory, VaultMemory as StoredVaultMemoryModel, StreamExpiredError, type StreamMetaEvent, type StreamResumeHandle, type SynthesizeProfileOptions, TOOL_RESULT_ORIGIN, TOPICS_EXTRACTION_VERSION, TOPIC_EXTRACTION_BATCH_SIZE, TREND_RECENT_WINDOW_DAYS, TREND_STALE_WINDOW_DAYS, type TextChunk, type TopicExtractOptions, type TopicExtractionInput, type TopicExtractionRunResult, type TurnCompleteEvent, type TurnSkippedEvent, type UncheckedReason, type UnverifiableReason, type UpdateVaultFolderOptions, type UpdateVaultMemoryOptions, type UseChatStorageOptions, type UseChatStorageResult, type UseCreditsOptions, type UseCreditsResult, type UseModelsOptions, type UseModelsResult, VAULT_SIZE_HOP_CAP, type VaultEmbeddingCache, type VaultFolderOperationsContext, type VaultMemoryOperationsContext, type VaultMemoryVisibility, type VaultSaveOperation, type VaultSearchResult, type VerificationSources, type VerifyMemoriesForPublishOptions, WalletPoller, type WeatherClassification, type WeatherPreProcessorOptions, type WebSearchClassification, type WebSearchPreProcessorOptions, addConversationMemoriesOp, archiveVaultMemoryOp, backfillMemoryTopicsOp, buildNotionAuthUrl, capHopsForDensity, chatStorageMigrations, chatStorageSchema, chunkAndEmbedAllMessages, chunkAndEmbedMessage, chunkText, classifyCryptoPrice, classifyCryptoPriceBatch, classifyDecay, classifyInjectionCandidates, classifyObservationTrend, classifyStockPrice, classifyStockPriceBatch, classifyWeather, classifyWeatherBatch, classifyWebSearch, classifyWebSearchBatch, clearAllEncryptionKeys, clearAllEncryptionState, clearConversationMemoriesOp, clearEncryptionKey, clearLazyTitleCache, clearServerToolsCache, consoleLogger, conversationMemoryToStored, cosineInt8, createAutoExtractor, createChunkVectorCache, createCryptoPricePreProcessor, createDecaySweeper, createLlmDecayClassifier, createLlmNeighborRefiner, createMemoryEngineTool, createMemoryVaultSearchTool, createMemoryVaultTool, createMessageSourceResolver, createNotionTools, createPlatformCursorStore, createRecallTool, createStockPricePreProcessor, createStreamingDeAnonymizer, createVaultEmbeddingCache, createVaultFolderOp, createVaultMemoriesBatchOp, createVaultMemoryOp, createWeatherPreProcessor, createWebSearchPreProcessor, decodeChunkVector, decryptConversationTitle, deleteAllVaultMemoriesForUserOp, deleteVaultFolderOp, deleteVaultMemoryOp, dequantizeEmbedding, discoverNotionOAuthEndpoints, eagerEmbedContent, embedAllMessages, embedMessage, encodeChunkVector, ensureDefaultFoldersOp, exchangeNotionCode, extractAndLinkEntitiesForMemoriesOp, extractAndRetain, extractEntitiesForMemories, extractFacts, generateConversationId, generateEmbedding, generateEmbeddings, generateNotionPKCE, getAllVaultFoldersOp, getAllVaultMemoriesOp, getAllVaultMemoryContentsOp, getCachedServerTools, getConversationMemoriesOp, getConversationsByProjectLazyOp, getConversationsLazyOp, getConversationsPageOp, getDecayCandidatesRawOp, getLogger, getMemoriesNeedingTopicExtractionOp, getServerTools, getUnfiledVaultMemoriesOp, getVaultFolderMemoryCountOp, getVaultMemoriesByIdsOp, getVaultMemoryOp, getVaultRankingProjectionsOp, hardDeleteDecayedOp, hasEncryptionKey, ingestPublishedPhotoMemoriesOp, injectionSignatureCatalog, isPiiRedactor, isRerankerAvailable, moveMemoriesToFolderOp, noopLogger, onKeyAvailable, parseMedia, preEmbedVaultMemories, quantizeEmbedding, queueManager, rankProfileCandidates, recall, reflect, refreshEncryptionKeyIfMatches, refreshNotionAccessToken, registerNotionClient, relinkMemoryTopicsOp, requestEncryptionKey, resolvePiiRedactor, restoreVaultMemoryOp, resumeStream, retain, scoreProfileSalience, screenCandidatesForInjection, sdkMigrations, sdkModelClasses, sdkSchema, searchVaultMemories, seedEncryptionKeys, setLogger, setMemoryVisibilityOp, shouldChunkMessage, stampTopicsExtractedAtOp, streamCancelPath, streamReplayPath, summarizeObservationTrends, supersedeVaultMemoryOp, synthesizeProfile, traverseGraphLane, ttlForType, updateVaultFolderContextOp, updateVaultFolderOp, updateVaultMemoryEmbeddingOp, updateVaultMemoryOp, upsertMessageOp, useChat, useChatStorage, useCredits, useEncryption, useModels, verifyMemoriesForPublish, xhrTransport };
+export { type AutoExtractMessage, type AutoExtractor, type Budget, CHUNKS_DISCARDED_ORIGIN, type CachedChunkVectors, type CachedServerTools, Conversation as ChatConversation, Message as ChatMessage, type ChatRole, type ChunkVectorCache, type ChunkingOptions, type ConsolidationFallbackReason, type ConversationMemoryInput, ConversationMemory as ConversationMemoryModel, type ConversationMemoryOperationsContext, type CreateAutoExtractorOptions, type CreateConversationOptions, type CreateDecaySweeperOptions, type CreateMessageOptions, type CreateVaultFolderOptions, type CreateVaultMemoryOptions, type CryptoPriceClassification, type CryptoPricePreProcessorOptions, DEFAULT_CACHE_EXPIRATION_MS, DEFAULT_CHUNK_CACHE_SIZE, DEFAULT_CHUNK_OVERLAP, DEFAULT_CHUNK_SIZE, DEFAULT_DECAY_POLICY, DEFAULT_MAX_CLASSIFIER_CALLS_PER_SWEEP, DEFAULT_MIN_CHUNK_SIZE, DEFAULT_PROFILE_FACETS, DEFAULT_PROFILE_FACT_TYPE_WEIGHTS, DEFAULT_PROFILE_PROOF_ALPHA, DEFAULT_PROFILE_TREND_MULTIPLIERS, DEFAULT_VAULT_CACHE_SIZE, DatabaseManager, type DatabaseManagerLogger, type DatabaseManagerOptions, type DecayCandidateRaw, type DecayClassifier, type DecayInput, type DecayPolicy, type DecaySweepResult, type DecaySweeper, type DecayVerdict, ENTITY_FANOUT, type EmbeddedWalletSignerFn, EncryptionKeyMissingError, type ExtractFactsOptions, type ExtractOutcome, type ExtractedCandidate, type ExtractedEntity, type ExtractionCursorStore, type FactType, type FileMetadata, type FlushResult, type GetConversationsPageOptions, type GetMessagesPageOptions, type GraphTraversalOptions, HARD_DELETE_WINDOW_MS, INFERENCE_ID_HEADER, type InjectionClassifierOptions, type InjectionReason, type LazyStoredConversation, type LlmDecayClassifierOptions, type LlmNeighborRefinerOptions, type Logger, LoggerProvider, type LoggerProviderProps, MAX_HOPS, MEDIUM_TTL_MS, type MemoriesNeedingTopicExtraction, type EmbeddingOptions as MemoryEngineEmbeddingOptions, type MemoryEngineResult, type MemoryEngineSearchOptions, type MemoryExtractedEvent, type MemoryKind, type MemoryQuarantinedEvent, type MemoryToVerify, type MemoryVaultSearchOptions, type MemoryVaultToolOptions, type MemoryVerification, type MessageRedactionResult, type MessageSkeleton, NEVER_TTL_MS, NODE_BUDGET, NOTION_OAUTH_CONFIG, type NeighborRefiner, type NotionAuthUrlParams, type NotionClientRegistration, type NotionExchangeCodeParams, type NotionOAuthEndpoints, type NotionPKCEChallenge, type NotionRefreshTokenParams, type NotionTokenResponse, type NowSource, type ObservationTrend, type ObservationTrendInput, PAST_EVENT_GRACE_MS, PII_PATTERNS, PROFILE_DOC_VERSION, type PhotoIngestResult, type PhotoMediaRef, type PiiCategory, type PiiMatch, type PiiPattern, PiiRedactor, type PiiRedactorOptions, type PlatformStorage, type PortalLlmAuth, type PortalLlmFailure, type PortalLlmFailureReason, type ProfileConfigFingerprint, type ProfileDoc, type ProfileFacet, type ProfileFacetKey, type ProfileSalienceInput, type ProfileSection, type PromptPreProcessor, type PromptPreProcessorContext, type PublishedPhotoMemory, type QuantizedEmbedding, type QuarantinedMemoryInfo, QueueManager, type QueueStatus, RECALL_MAX_LIMIT, RECALL_TOOL_NAME, type RankableVaultMemory, type RankedMemory, type RankedProfileCandidate, type RecallContext, type RecallDegradation, type RecallDiagnostics, type RecallOptions, type RecallResult, type RecallToolCallbacks, type RecallToolOptions, type RecencyOptions, type RedactionResult, type ReflectOptions, type ReflectResult, type RequestEncryptionKeyOptions, RerankerUnavailableError, type ResumeStreamOptions, type ResumeStreamResult, type ResumeStreamWithStorageResult, type RetainAction, type RetainContext, type RetainOptions, type RetainResult, type RetainSource, SDK_SCHEMA_VERSION, SHORT_TTL_MS, STREAM_RESUMABLE_HEADER, type ScoreBreakdown, type ScoreProfileSalienceOptions, type ScreenResult, type ScreenedCandidate, type SearchSource, type SendMessageWithStorageArgs, type SendMessageWithStorageDetachedResult, type SendMessageWithStorageResult, type ServerToolsOptions, type ServerToolsResponse, type SignMessageFn, type StockPriceClassification, type StockPricePreProcessorOptions, type ChatCompletionUsage as StoredChatCompletionUsage, type StoredConversation, type StoredConversationMemory, type StoredMessage, type StoredMessageWithSimilarity, type StoredVaultFolder, VaultFolder as StoredVaultFolderModel, type StoredVaultMemory, VaultMemory as StoredVaultMemoryModel, StreamExpiredError, type StreamMetaEvent, type StreamResumeHandle, type SynthesizeProfileOptions, TOOL_RESULT_ORIGIN, TOPICS_EXTRACTION_VERSION, TOPIC_EXTRACTION_BATCH_SIZE, TREND_RECENT_WINDOW_DAYS, TREND_STALE_WINDOW_DAYS, type TextChunk, type TopicExtractOptions, type TopicExtractionInput, type TopicExtractionRunResult, type TopicSkipReason, type TurnCompleteEvent, type TurnSkippedEvent, type UncheckedReason, type UnverifiableReason, type UpdateVaultFolderOptions, type UpdateVaultMemoryOptions, type UseChatStorageOptions, type UseChatStorageResult, type UseCreditsOptions, type UseCreditsResult, type UseModelsOptions, type UseModelsResult, VAULT_SIZE_HOP_CAP, type VaultEmbeddingCache, type VaultFolderOperationsContext, type VaultMemoryOperationsContext, type VaultMemoryVisibility, type VaultSaveOperation, type VaultSearchResult, type VerificationSources, type VerifyMemoriesForPublishOptions, WalletPoller, type WeatherClassification, type WeatherPreProcessorOptions, type WebSearchClassification, type WebSearchPreProcessorOptions, addConversationMemoriesOp, archiveVaultMemoryOp, backfillMemoryTopicsOp, buildNotionAuthUrl, capHopsForDensity, chatStorageMigrations, chatStorageSchema, chunkAndEmbedAllMessages, chunkAndEmbedMessage, chunkText, classifyCryptoPrice, classifyCryptoPriceBatch, classifyDecay, classifyInjectionCandidates, classifyObservationTrend, classifyStockPrice, classifyStockPriceBatch, classifyWeather, classifyWeatherBatch, classifyWebSearch, classifyWebSearchBatch, clearAllEncryptionKeys, clearAllEncryptionState, clearConversationMemoriesOp, clearEncryptionKey, clearLazyTitleCache, clearServerToolsCache, consoleLogger, conversationMemoryToStored, cosineInt8, createAutoExtractor, createChunkVectorCache, createCryptoPricePreProcessor, createDecaySweeper, createLlmDecayClassifier, createLlmNeighborRefiner, createMemoryEngineTool, createMemoryVaultSearchTool, createMemoryVaultTool, createMessageSourceResolver, createNotionTools, createPlatformCursorStore, createRecallTool, createStockPricePreProcessor, createStreamingDeAnonymizer, createVaultEmbeddingCache, createVaultFolderOp, createVaultMemoriesBatchOp, createVaultMemoryOp, createWeatherPreProcessor, createWebSearchPreProcessor, decodeChunkVector, decryptConversationTitle, deleteAllVaultMemoriesForUserOp, deleteVaultFolderOp, deleteVaultMemoryOp, dequantizeEmbedding, discoverNotionOAuthEndpoints, eagerEmbedContent, embedAllMessages, embedMessage, encodeChunkVector, ensureDefaultFoldersOp, exchangeNotionCode, extractAndLinkEntitiesForMemoriesOp, extractAndRetain, extractEntitiesForMemories, extractFacts, generateConversationId, generateEmbedding, generateEmbeddings, generateNotionPKCE, getAllVaultFoldersOp, getAllVaultMemoriesOp, getAllVaultMemoryContentsOp, getCachedServerTools, getConversationMemoriesOp, getConversationsByProjectLazyOp, getConversationsLazyOp, getConversationsPageOp, getDecayCandidatesRawOp, getLogger, getMemoriesNeedingTopicExtractionOp, getServerTools, getUnfiledVaultMemoriesOp, getVaultFolderMemoryCountOp, getVaultMemoriesByIdsOp, getVaultMemoryOp, getVaultRankingProjectionsOp, hardDeleteDecayedOp, hasEncryptionKey, ingestPublishedPhotoMemoriesOp, injectionSignatureCatalog, isDegradedTopicSkip, isPiiRedactor, isRerankerAvailable, moveMemoriesToFolderOp, noopLogger, onKeyAvailable, parseMedia, preEmbedVaultMemories, quantizeEmbedding, queueManager, rankProfileCandidates, recall, reflect, refreshEncryptionKeyIfMatches, refreshNotionAccessToken, registerNotionClient, relinkMemoryTopicsOp, requestEncryptionKey, resolvePiiRedactor, restoreVaultMemoryOp, resumeStream, retain, scoreProfileSalience, screenCandidatesForInjection, sdkMigrations, sdkModelClasses, sdkSchema, searchVaultMemories, seedEncryptionKeys, setLogger, setMemoryVisibilityOp, shouldChunkMessage, stampTopicsExtractedAtOp, streamCancelPath, streamReplayPath, summarizeObservationTrends, supersedeVaultMemoryOp, synthesizeProfile, traverseGraphLane, ttlForType, updateVaultFolderContextOp, updateVaultFolderOp, updateVaultMemoryEmbeddingOp, updateVaultMemoryOp, upsertMessageOp, useChat, useChatStorage, useCredits, useEncryption, useModels, verifyMemoriesForPublish, xhrTransport };

package/dist/expo/index.mjs

@@ -132,7 +132,7 @@ import {
   upsertMessageOp,
   useEncryption,
   vaultMemoryToStored
-} from "./chunk-LUGYCFVI.mjs";
+} from "./chunk-4M56MKBV.mjs";
 import {
   PII_PATTERNS,
   PiiRedactor,
@@ -7539,7 +7539,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(
           window,
           retainCtx,
           {
@@ -7579,7 +7579,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);
@@ -8843,6 +8847,18 @@ function parseTopicResponse(parsed, validIds) {
   }
   return out;
 }
+var DEGRADED_TOPIC_SKIP = {
+  excluded: false,
+  "link-declined": false,
+  "stamp-declined": false,
+  "llm-unanswered": true,
+  unreadable: true,
+  "not-found": true,
+  "link-failed": true
+};
+function isDegradedTopicSkip(reason) {
+  return DEGRADED_TOPIC_SKIP[reason] === true;
+}
 async function extractAndLinkEntitiesForMemoriesOp(ctx, memoryIds, options) {
   const entityCtx = ctx.entityCtx;
   if (!entityCtx) {
@@ -8851,17 +8867,24 @@ async function extractAndLinkEntitiesForMemoriesOp(ctx, memoryIds, options) {
   const log = getLogger();
   const extractedAt = options.now ?? Date.now();
   const skippedIds = [];
+  const skippedReasons = /* @__PURE__ */ new Map();
+  const skip = (id, reason) => {
+    if (skippedReasons.has(id)) return;
+    skippedIds.push(id);
+    skippedReasons.set(id, reason);
+  };
   const inputs = [];
-  for (const id of memoryIds) {
+  for (const id of new Set(memoryIds)) {
     let record;
     try {
       record = await ctx.vaultMemoryCollection.find(id);
-    } catch {
-      skippedIds.push(id);
+    } catch (err) {
+      log.warn("[memory/topics] vault lookup failed for extraction", err);
+      skip(id, "not-found");
       continue;
     }
     if (record.isDeleted || ctx.userId !== void 0 && record.userId !== ctx.userId || record.topicsUserManaged) {
-      skippedIds.push(id);
+      skip(id, "excluded");
       continue;
     }
     try {
@@ -8874,7 +8897,7 @@ async function extractAndLinkEntitiesForMemoriesOp(ctx, memoryIds, options) {
       inputs.push({ id, content: stored.content });
     } catch (err) {
       log.warn("[memory/topics] failed to load memory for extraction", err);
-      skippedIds.push(id);
+      skip(id, "unreadable");
     }
   }
   const entitiesByMemory = await extractEntitiesForMemories(inputs, options);
@@ -8882,19 +8905,19 @@ async function extractAndLinkEntitiesForMemoriesOp(ctx, memoryIds, options) {
   for (const input of inputs) {
     const entities = entitiesByMemory.get(input.id);
     if (entities === void 0) {
-      skippedIds.push(input.id);
+      skip(input.id, "llm-unanswered");
       continue;
     }
     try {
       const linked = await replaceMemoryEntitiesGuardedOp(entityCtx, input.id, entities);
       if (linked === null) {
-        skippedIds.push(input.id);
+        skip(input.id, "link-declined");
         entitiesByMemory.delete(input.id);
         continue;
       }
     } catch (err) {
       log.warn("[memory/topics] replaceMemoryEntitiesGuardedOp failed", err);
-      skippedIds.push(input.id);
+      skip(input.id, "link-failed");
       entitiesByMemory.delete(input.id);
       continue;
     }
@@ -8904,11 +8927,11 @@ async function extractAndLinkEntitiesForMemoriesOp(ctx, memoryIds, options) {
   const stampedSet = new Set(stampedIds);
   for (const id of toStamp) {
     if (!stampedSet.has(id)) {
-      skippedIds.push(id);
+      skip(id, "stamp-declined");
       entitiesByMemory.delete(id);
     }
   }
-  return { entitiesByMemory, stampedIds, skippedIds };
+  return { entitiesByMemory, stampedIds, skippedIds, skippedReasons };
 }
 
 // src/lib/memory/verifySupport.ts
@@ -14898,6 +14921,7 @@ export {
   hasEncryptionKey,
   ingestPublishedPhotoMemoriesOp,
   injectionSignatureCatalog,
+  isDegradedTopicSkip,
   isPiiRedactor,
   isRerankerAvailable,
   moveMemoriesToFolderOp,

package/dist/expo/{recall-77QK4RT6.mjs → recall-WIB7RQQZ.mjs}

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

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,