@anuma/sdk 6.7.1 → 6.7.3

package/dist/expo/index.d.ts

@@ -4880,6 +4880,60 @@ interface PortalLlmAuth {
     /** Function to get an auth token (e.g., Privy's getIdentityToken). Token is sent as `Authorization: Bearer`. */
     getToken?: () => Promise<string | null>;
 }
+/**
+ * Why a portal JSON completion gave up, as a STABLE low-cardinality code.
+ *
+ * The retry loop has always classified its failures precisely, but only as an
+ * interpolated `reason` string for `log.warn` — and prod ships no SDK log
+ * (sdk#883), so in production every one of these collapsed into a single
+ * `empty-after-retry` with no way to tell them apart. That is what made the
+ * 2026-08-11 audit need a Prometheus cross-check to discover that the portal
+ * was returning HTTP 200 with an empty body on ~60% of extraction turns.
+ *
+ * Codes are deliberately an enum, not the `reason` string: the strings embed
+ * status codes and error messages, so they are unbounded and useless as an
+ * analytics property. Keep this list SHORT and stable — it is a telemetry
+ * contract, and a value added here has to mean the same thing in six months.
+ *
+ * @public
+ */
+type PortalLlmFailureReason = 
+/** No usable credential — `getToken` returned null or threw. Terminal. */
+"auth-unavailable"
+/** Non-retryable HTTP status (400/403/404, or 401 on the static-apiKey path). */
+ | "http-terminal"
+/** Retryable status (408/409/425/429/5xx) that never succeeded. */
+ | "http-retryable"
+/** Network error or the per-attempt timeout aborted the fetch. */
+ | "network"
+/** HTTP 200 but the envelope itself wasn't JSON. */
+ | "body-parse-failed"
+/**
+ * HTTP 200 with NO completion content. The reasoning-class failure mode:
+ * the model spends its budget on unreturned thinking and answers empty.
+ */
+ | "empty-content"
+/** Content present, but no parseable JSON in it (prose, a clarifying question). */
+ | "invalid-json"
+/** Content parsed to a literal `null`, which is never a valid response. */
+ | "null-completion"
+/** `totalTimeoutMs` was spent before the next attempt could run. */
+ | "time-budget-exhausted";
+/**
+ * A give-up report: the classified {@link PortalLlmFailureReason} plus the
+ * little context worth carrying into telemetry. Both extra fields are bounded
+ * (a status code, a small attempt count), so both are safe as event properties.
+ *
+ * @public
+ */
+interface PortalLlmFailure {
+    /** Stable code for the last failure observed. */
+    reason: PortalLlmFailureReason;
+    /** HTTP status, when the failure was an HTTP one. */
+    httpStatus?: number;
+    /** How many attempts ran before giving up (1-based, ≥ 1). */
+    attempts: number;
+}
 
 /**
  * Optional LLM injection classifier — Tier-0 security second layer (PR5).
@@ -5984,8 +6038,14 @@ interface ExtractFactsOptions extends PortalLlmAuth {
      * `{candidates: []}` "nothing durable here". Lets callers distinguish a
      * silently-degrading extractor from quiet turns (the two are otherwise
      * indistinguishable). See {@link extractAndRetain}'s `outcome`.
+     *
+     * Receives the classified {@link PortalLlmFailure}. Knowing THAT extraction
+     * failed was not enough: the 2026-08-11 audit found ~60% of production turns
+     * ending here and had to cross-check Prometheus to learn that the cause was
+     * HTTP-200-with-empty-body rather than the 403 everyone assumed. Forward
+     * `failure.reason` into analytics so the next such question is a query.
      */
-    onExhaustedEmpty?: () => void;
+    onExhaustedEmpty?: (failure: PortalLlmFailure) => void;
     /**
      * Called when the extractor DID produce candidates but PII de-anonymization
      * dropped every one of them — the model mangled its placeholders (so they
@@ -6108,6 +6168,11 @@ declare function extractAndRetain(messages: AutoExtractMessage[], retainCtx: Ret
      * "extracted but held for review".
      */
     quarantined: QuarantinedMemoryInfo[];
+    /**
+     * Present only when `outcome` is `empty-after-retry` — the classified cause of
+     * the give-up, so "extraction is failing" can be reported as *why* it failed.
+     */
+    failure?: PortalLlmFailure;
 }>;
 
 /**
@@ -10232,4 +10297,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 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 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 };

package/dist/expo/index.mjs

@@ -132,7 +132,7 @@ import {
   upsertMessageOp,
   useEncryption,
   vaultMemoryToStored
-} from "./chunk-2YHVYDEL.mjs";
+} from "./chunk-37VWRZTL.mjs";
 import {
   PII_PATTERNS,
   PiiRedactor,
@@ -140,7 +140,7 @@ import {
   isPiiRedactor,
   notifyConsolidationFallback,
   resolvePiiRedactor
-} from "./chunk-VOMDHMKH.mjs";
+} from "./chunk-ITRFWFNS.mjs";
 import {
   INTERNAL_FLOW_MARKER,
   callPortalJsonCompletion,
@@ -153,7 +153,7 @@ import {
   supportsResponseFormat,
   validateEndpointOverride,
   withInternalFlowMarker
-} from "./chunk-B5UPJRCU.mjs";
+} from "./chunk-5GBYOWRY.mjs";
 import {
   BASE_URL,
   MCP_R2_DOMAIN,
@@ -6861,7 +6861,7 @@ async function tryConsolidate(trimmed, ctx, options, prepared) {
     content: m.content,
     similarity: m.similarity
   }));
-  const { consolidateMemory: doConsolidate } = await import("./consolidate-TWE6OSSZ.mjs");
+  const { consolidateMemory: doConsolidate } = await import("./consolidate-H6YD36XI.mjs");
   const decision = await doConsolidate(trimmed, candidates, consolidateOptions);
   if (decision.action === "create") return null;
   if (decision.action === "supersede" && decision.content) {
@@ -7078,7 +7078,11 @@ async function extractFacts(messages, options) {
   }
   const transcript = transcriptLines.join("\n");
   const today = formatLocalDate(options.now ?? Date.now());
+  let failure;
   const parsed = await callPortalJsonCompletion({
+    onFailure: (f) => {
+      failure = f;
+    },
     ...options.apiKey !== void 0 && { apiKey: options.apiKey },
     ...options.getToken !== void 0 && { getToken: options.getToken },
     ...options.baseUrl !== void 0 && { baseUrl: options.baseUrl },
@@ -7101,7 +7105,7 @@ Extract durable user facts.`,
     ...options.backoffMs && { backoffMs: options.backoffMs }
   });
   if (parsed === null) {
-    options.onExhaustedEmpty?.();
+    options.onExhaustedEmpty?.(failure ?? { reason: "empty-content", attempts: 1 });
     return [];
   }
   const fallbackSourceId = [...messages].reverse().find((m) => m.role === "user")?.id;
@@ -7145,14 +7149,16 @@ async function extractAndRetain(messages, retainCtx, options) {
     ...resolvedConsolidatePii !== void 0 && { piiRedaction: resolvedConsolidatePii }
   } : void 0;
   let exhaustedEmpty = false;
+  let exhaustedFailure;
   let droppedAfterRedaction = false;
   const callerOnExhaustedEmpty = options.extract.onExhaustedEmpty;
   const callerOnCandidatesDropped = options.extract.onCandidatesDropped;
   const candidates = await extractFacts(messages, {
     ...options.extract,
-    onExhaustedEmpty: () => {
+    onExhaustedEmpty: (failure) => {
       exhaustedEmpty = true;
-      callerOnExhaustedEmpty?.();
+      exhaustedFailure = failure;
+      callerOnExhaustedEmpty?.(failure);
     },
     onCandidatesDropped: () => {
       droppedAfterRedaction = true;
@@ -7271,12 +7277,19 @@ async function extractAndRetain(messages, retainCtx, options) {
     results,
     failedCount: failedWrites,
     outcome,
-    quarantined: quarantinedInfo
+    quarantined: quarantinedInfo,
+    // Only meaningful alongside `outcome: "empty-after-retry"`. Returned as well
+    // as pushed through the callback so a consumer that only inspects the result
+    // (rather than wiring a hook) can still report WHY.
+    ...exhaustedFailure !== void 0 && { failure: exhaustedFailure }
   };
 }
+var UTTERANCE_ECHO_RE = /^(?:said|says|asked|answered|replied|guessed|typed)\s*:\s*(?:'[^']*'|"[^"]*"|‘[^’]*’|“[^”]*”)[\s.!?]*$/iu;
 function isLowSignalContent(content, ownNames) {
-  const normalized = content.trim().replace(/[.!?]+$/, "").toLowerCase();
+  const trimmed = content.trim();
+  const normalized = trimmed.replace(/[.!?]+$/, "").toLowerCase();
   if (normalized.length < MIN_CONTENT_LENGTH) return true;
+  if (UTTERANCE_ECHO_RE.test(trimmed)) return true;
   if (ownNames.some(
     (n) => normalized === n.trim().replace(/[.!?]+$/, "").toLowerCase()
   )) {

package/dist/expo/{recall-M3JVFTZL.mjs → recall-FZ7JC4AX.mjs}

@@ -1,7 +1,7 @@
 import {
   recall
-} from "./chunk-2YHVYDEL.mjs";
-import "./chunk-B5UPJRCU.mjs";
+} from "./chunk-37VWRZTL.mjs";
+import "./chunk-5GBYOWRY.mjs";
 import "./chunk-GYKJOWEO.mjs";
 export {
   recall

package/dist/{expo/chunk-B5UPJRCU.mjs → react/chunk-5GBYOWRY.mjs}

@@ -115,9 +115,15 @@ async function callPortalJsonCompletion(req) {
   const maxAttempts = Math.max(1, req.maxAttempts ?? 3);
   const startedAt = Date.now();
   const overBudget = () => req.totalTimeoutMs !== void 0 && Date.now() - startedAt >= req.totalTimeoutMs;
+  let lastFailure;
+  const giveUp = () => {
+    req.onFailure?.(lastFailure ?? { reason: "network", attempts: maxAttempts });
+    return null;
+  };
   for (let attempt = 1; attempt <= maxAttempts; attempt++) {
     if (attempt > 1 && overBudget()) {
       log.warn(`[${req.tag}] over time budget before attempt ${attempt}, giving up`);
+      lastFailure = { reason: "time-budget-exhausted", attempts: attempt - 1 };
       break;
     }
     const attemptReq = req.totalTimeoutMs !== void 0 ? {
@@ -129,9 +135,14 @@ async function callPortalJsonCompletion(req) {
     } : req;
     const outcome = await attemptPortalJson(attemptReq, endpoint);
     if (outcome.kind === "ok") return outcome.value;
+    lastFailure = {
+      reason: outcome.code,
+      ...outcome.httpStatus !== void 0 && { httpStatus: outcome.httpStatus },
+      attempts: attempt
+    };
     if (outcome.kind === "terminal") {
       log.warn(`[${req.tag}] ${outcome.reason}`);
-      return null;
+      return giveUp();
     }
     if (attempt >= maxAttempts) {
       log.warn(`[${req.tag}] ${outcome.reason} \u2014 attempt ${attempt}/${maxAttempts}, giving up`);
@@ -143,19 +154,21 @@ async function callPortalJsonCompletion(req) {
       log.warn(
         `[${req.tag}] ${outcome.reason} \u2014 attempt ${attempt}/${maxAttempts}, over time budget, giving up`
       );
+      lastFailure = { reason: "time-budget-exhausted", attempts: attempt };
       break;
     }
     log.warn(`[${req.tag}] ${outcome.reason} \u2014 attempt ${attempt}/${maxAttempts}, retrying`);
     if (delay > 0) await sleep(delay);
   }
-  return null;
+  return giveUp();
 }
 async function attemptPortalJson(req, endpoint) {
   const baseUrl = req.baseUrl ?? defaultBaseUrl();
   const fetchImpl = req.fetchFn ?? fetch;
   const timeoutMs = req.timeoutMs ?? 6e4;
   const authHeaders = await resolvePortalAuthHeaders(req, req.tag);
-  if (authHeaders === null) return { kind: "terminal", reason: "auth unavailable (no token)" };
+  if (authHeaders === null)
+    return { kind: "terminal", code: "auth-unavailable", reason: "auth unavailable (no token)" };
   const isAnthropic = req.model.startsWith("anthropic/");
   const prefill = isAnthropic ? "{" : "";
   const messages = [
@@ -188,31 +201,55 @@ async function attemptPortalJson(req, endpoint) {
     });
   } catch (err) {
     clearTimeout(timer);
-    return { kind: "retryable", reason: `fetch failed: ${err.message}` };
+    return {
+      kind: "retryable",
+      code: "network",
+      reason: `fetch failed: ${err.message}`
+    };
   }
   if (!response.ok) {
     clearTimeout(timer);
     const reason = `portal returned ${response.status}`;
     if (response.status === 401) {
       const tokenAuth = !req.apiKey && !!req.getToken;
-      return tokenAuth ? { kind: "retryable", reason: `${reason} (token may be expired; refreshing)` } : { kind: "terminal", reason };
+      return tokenAuth ? {
+        kind: "retryable",
+        code: "http-retryable",
+        reason: `${reason} (token may be expired; refreshing)`,
+        httpStatus: response.status
+      } : { kind: "terminal", code: "http-terminal", reason, httpStatus: response.status };
     }
-    if (!isRetryableStatus(response.status)) return { kind: "terminal", reason };
+    if (!isRetryableStatus(response.status))
+      return { kind: "terminal", code: "http-terminal", reason, httpStatus: response.status };
     const retryAfterMs = parseRetryAfterMs(response.headers.get("retry-after"));
-    return retryAfterMs !== null ? { kind: "retryable", reason, retryAfterMs } : { kind: "retryable", reason };
+    return {
+      kind: "retryable",
+      code: "http-retryable",
+      reason,
+      httpStatus: response.status,
+      ...retryAfterMs !== null && { retryAfterMs }
+    };
   }
   let body;
   try {
     body = await response.json();
   } catch (err) {
     clearTimeout(timer);
-    return { kind: "retryable", reason: `response body parse failed: ${err.message}` };
+    return {
+      kind: "retryable",
+      code: "body-parse-failed",
+      reason: `response body parse failed: ${err.message}`
+    };
   }
   clearTimeout(timer);
   logPortalUsage(body, req.tag);
   const rawContent = extractCompletionContent(body);
   if (!rawContent) {
-    return { kind: "retryable", reason: "portal response had no completion content" };
+    return {
+      kind: "retryable",
+      code: "empty-content",
+      reason: "portal response had no completion content"
+    };
   }
   const looksLikeContinuation = prefill && /^\s*"/.test(rawContent);
   const content = looksLikeContinuation ? prefill + rawContent : rawContent;
@@ -223,11 +260,12 @@ async function attemptPortalJson(req, endpoint) {
   } catch (err) {
     return {
       kind: "retryable",
+      code: "invalid-json",
       reason: `completion was not valid JSON: ${err.message}`
     };
   }
   if (value === null) {
-    return { kind: "retryable", reason: "completion parsed to null" };
+    return { kind: "retryable", code: "null-completion", reason: "completion parsed to null" };
   }
   return { kind: "ok", value };
 }

package/dist/react/{chunk-S6WPXD5N.mjs → chunk-NC7BZEEF.mjs}

@@ -1,7 +1,7 @@
 import {
   callPortalJsonCompletion,
   getLogger
-} from "./chunk-B5UPJRCU.mjs";
+} from "./chunk-5GBYOWRY.mjs";
 import {
   BASE_URL,
   createClientConfig
@@ -7085,7 +7085,7 @@ function createMemoryVaultSearchTool(vaultCtx, embeddingOptions, cache, searchOp
             subQueries = decomp.subQueries;
           }
         }
-        const { recall: recall2 } = await import("./recall-ROEK55FJ.mjs");
+        const { recall: recall2 } = await import("./recall-546HTUPK.mjs");
         let recallDegraded = [];
         const result = await recall2(
           query,

package/dist/react/{chunk-2ARMO2NN.mjs → chunk-ZZDMEEHO.mjs}

@@ -1,6 +1,6 @@
 import {
   getLogger
-} from "./chunk-B5UPJRCU.mjs";
+} from "./chunk-5GBYOWRY.mjs";
 
 // src/lib/pii/patterns.ts
 function luhnCheck(digits) {

package/dist/{expo/consolidate-TWE6OSSZ.mjs → react/consolidate-FNFIDL37.mjs}

@@ -1,10 +1,10 @@
 import {
   notifyConsolidationFallback,
   resolvePiiRedactor
-} from "./chunk-VOMDHMKH.mjs";
+} from "./chunk-ZZDMEEHO.mjs";
 import {
   callPortalJsonCompletion
-} from "./chunk-B5UPJRCU.mjs";
+} from "./chunk-5GBYOWRY.mjs";
 import "./chunk-GYKJOWEO.mjs";
 
 // src/lib/memory/consolidate.ts

package/dist/react/index.cjs

@@ -6429,9 +6429,15 @@ async function callPortalJsonCompletion(req) {
   const maxAttempts = Math.max(1, req.maxAttempts ?? 3);
   const startedAt = Date.now();
   const overBudget = () => req.totalTimeoutMs !== void 0 && Date.now() - startedAt >= req.totalTimeoutMs;
+  let lastFailure;
+  const giveUp = () => {
+    req.onFailure?.(lastFailure ?? { reason: "network", attempts: maxAttempts });
+    return null;
+  };
   for (let attempt = 1; attempt <= maxAttempts; attempt++) {
     if (attempt > 1 && overBudget()) {
       log.warn(`[${req.tag}] over time budget before attempt ${attempt}, giving up`);
+      lastFailure = { reason: "time-budget-exhausted", attempts: attempt - 1 };
       break;
     }
     const attemptReq = req.totalTimeoutMs !== void 0 ? {
@@ -6443,9 +6449,14 @@ async function callPortalJsonCompletion(req) {
     } : req;
     const outcome = await attemptPortalJson(attemptReq, endpoint);
     if (outcome.kind === "ok") return outcome.value;
+    lastFailure = {
+      reason: outcome.code,
+      ...outcome.httpStatus !== void 0 && { httpStatus: outcome.httpStatus },
+      attempts: attempt
+    };
     if (outcome.kind === "terminal") {
       log.warn(`[${req.tag}] ${outcome.reason}`);
-      return null;
+      return giveUp();
     }
     if (attempt >= maxAttempts) {
       log.warn(`[${req.tag}] ${outcome.reason} \u2014 attempt ${attempt}/${maxAttempts}, giving up`);
@@ -6457,19 +6468,21 @@ async function callPortalJsonCompletion(req) {
       log.warn(
         `[${req.tag}] ${outcome.reason} \u2014 attempt ${attempt}/${maxAttempts}, over time budget, giving up`
       );
+      lastFailure = { reason: "time-budget-exhausted", attempts: attempt };
       break;
     }
     log.warn(`[${req.tag}] ${outcome.reason} \u2014 attempt ${attempt}/${maxAttempts}, retrying`);
     if (delay > 0) await sleep3(delay);
   }
-  return null;
+  return giveUp();
 }
 async function attemptPortalJson(req, endpoint) {
   const baseUrl = req.baseUrl ?? defaultBaseUrl();
   const fetchImpl = req.fetchFn ?? fetch;
   const timeoutMs = req.timeoutMs ?? 6e4;
   const authHeaders = await resolvePortalAuthHeaders(req, req.tag);
-  if (authHeaders === null) return { kind: "terminal", reason: "auth unavailable (no token)" };
+  if (authHeaders === null)
+    return { kind: "terminal", code: "auth-unavailable", reason: "auth unavailable (no token)" };
   const isAnthropic = req.model.startsWith("anthropic/");
   const prefill = isAnthropic ? "{" : "";
   const messages = [
@@ -6502,31 +6515,55 @@ async function attemptPortalJson(req, endpoint) {
     });
   } catch (err) {
     clearTimeout(timer);
-    return { kind: "retryable", reason: `fetch failed: ${err.message}` };
+    return {
+      kind: "retryable",
+      code: "network",
+      reason: `fetch failed: ${err.message}`
+    };
   }
   if (!response.ok) {
     clearTimeout(timer);
     const reason = `portal returned ${response.status}`;
     if (response.status === 401) {
       const tokenAuth = !req.apiKey && !!req.getToken;
-      return tokenAuth ? { kind: "retryable", reason: `${reason} (token may be expired; refreshing)` } : { kind: "terminal", reason };
-    }
-    if (!isRetryableStatus(response.status)) return { kind: "terminal", reason };
+      return tokenAuth ? {
+        kind: "retryable",
+        code: "http-retryable",
+        reason: `${reason} (token may be expired; refreshing)`,
+        httpStatus: response.status
+      } : { kind: "terminal", code: "http-terminal", reason, httpStatus: response.status };
+    }
+    if (!isRetryableStatus(response.status))
+      return { kind: "terminal", code: "http-terminal", reason, httpStatus: response.status };
     const retryAfterMs = parseRetryAfterMs(response.headers.get("retry-after"));
-    return retryAfterMs !== null ? { kind: "retryable", reason, retryAfterMs } : { kind: "retryable", reason };
+    return {
+      kind: "retryable",
+      code: "http-retryable",
+      reason,
+      httpStatus: response.status,
+      ...retryAfterMs !== null && { retryAfterMs }
+    };
   }
   let body;
   try {
     body = await response.json();
   } catch (err) {
     clearTimeout(timer);
-    return { kind: "retryable", reason: `response body parse failed: ${err.message}` };
+    return {
+      kind: "retryable",
+      code: "body-parse-failed",
+      reason: `response body parse failed: ${err.message}`
+    };
   }
   clearTimeout(timer);
   logPortalUsage(body, req.tag);
   const rawContent = extractCompletionContent(body);
   if (!rawContent) {
-    return { kind: "retryable", reason: "portal response had no completion content" };
+    return {
+      kind: "retryable",
+      code: "empty-content",
+      reason: "portal response had no completion content"
+    };
   }
   const looksLikeContinuation = prefill && /^\s*"/.test(rawContent);
   const content = looksLikeContinuation ? prefill + rawContent : rawContent;
@@ -6537,11 +6574,12 @@ async function attemptPortalJson(req, endpoint) {
   } catch (err) {
     return {
       kind: "retryable",
+      code: "invalid-json",
       reason: `completion was not valid JSON: ${err.message}`
     };
   }
   if (value === null) {
-    return { kind: "retryable", reason: "completion parsed to null" };
+    return { kind: "retryable", code: "null-completion", reason: "completion parsed to null" };
   }
   return { kind: "ok", value };
 }
@@ -17854,7 +17892,11 @@ async function extractFacts(messages, options) {
   }
   const transcript = transcriptLines.join("\n");
   const today = formatLocalDate(options.now ?? Date.now());
+  let failure;
   const parsed = await callPortalJsonCompletion({
+    onFailure: (f) => {
+      failure = f;
+    },
     ...options.apiKey !== void 0 && { apiKey: options.apiKey },
     ...options.getToken !== void 0 && { getToken: options.getToken },
     ...options.baseUrl !== void 0 && { baseUrl: options.baseUrl },
@@ -17877,7 +17919,7 @@ Extract durable user facts.`,
     ...options.backoffMs && { backoffMs: options.backoffMs }
   });
   if (parsed === null) {
-    options.onExhaustedEmpty?.();
+    options.onExhaustedEmpty?.(failure ?? { reason: "empty-content", attempts: 1 });
     return [];
   }
   const fallbackSourceId = [...messages].reverse().find((m) => m.role === "user")?.id;
@@ -17921,14 +17963,16 @@ async function extractAndRetain(messages, retainCtx, options) {
     ...resolvedConsolidatePii !== void 0 && { piiRedaction: resolvedConsolidatePii }
   } : void 0;
   let exhaustedEmpty = false;
+  let exhaustedFailure;
   let droppedAfterRedaction = false;
   const callerOnExhaustedEmpty = options.extract.onExhaustedEmpty;
   const callerOnCandidatesDropped = options.extract.onCandidatesDropped;
   const candidates = await extractFacts(messages, {
     ...options.extract,
-    onExhaustedEmpty: () => {
+    onExhaustedEmpty: (failure) => {
       exhaustedEmpty = true;
-      callerOnExhaustedEmpty?.();
+      exhaustedFailure = failure;
+      callerOnExhaustedEmpty?.(failure);
     },
     onCandidatesDropped: () => {
       droppedAfterRedaction = true;
@@ -18047,12 +18091,19 @@ async function extractAndRetain(messages, retainCtx, options) {
     results,
     failedCount: failedWrites,
     outcome,
-    quarantined: quarantinedInfo
+    quarantined: quarantinedInfo,
+    // Only meaningful alongside `outcome: "empty-after-retry"`. Returned as well
+    // as pushed through the callback so a consumer that only inspects the result
+    // (rather than wiring a hook) can still report WHY.
+    ...exhaustedFailure !== void 0 && { failure: exhaustedFailure }
   };
 }
+var UTTERANCE_ECHO_RE = /^(?:said|says|asked|answered|replied|guessed|typed)\s*:\s*(?:'[^']*'|"[^"]*"|‘[^’]*’|“[^”]*”)[\s.!?]*$/iu;
 function isLowSignalContent(content, ownNames) {
-  const normalized = content.trim().replace(/[.!?]+$/, "").toLowerCase();
+  const trimmed = content.trim();
+  const normalized = trimmed.replace(/[.!?]+$/, "").toLowerCase();
   if (normalized.length < MIN_CONTENT_LENGTH) return true;
+  if (UTTERANCE_ECHO_RE.test(trimmed)) return true;
   if (ownNames.some(
     (n) => normalized === n.trim().replace(/[.!?]+$/, "").toLowerCase()
   )) {