@anuma/sdk 6.25.0 → 6.25.2

package/dist/expo/index.d.mts

@@ -1358,6 +1358,28 @@ interface EmbeddingOptions {
      * while real PII never reaches the server. Used when PII redaction is active.
      */
     maskInput?: (text: string) => string;
+    /**
+     * Deadline, in ms, for EACH embeddings HTTP attempt (default 15000). An
+     * attempt that exceeds it is aborted and counts as a transient failure, so the
+     * bounded retry still applies. `0` disables the deadline.
+     */
+    timeoutMs?: number;
+    /**
+     * Deadline, in ms, for the `getToken()` read that precedes a request (default
+     * 10000). A provider that never settles rejects instead of hanging the
+     * embedding — and the recall waiting on it. `0` disables the deadline.
+     */
+    tokenTimeoutMs?: number;
+    /**
+     * Overall deadline, in ms, for one `generateEmbedding` call — the token read,
+     * every retry attempt and the backoff between them. Unset (the default) means
+     * only the per-attempt deadlines apply, which is right for background/bulk
+     * embeds. The recall query path sets it (see
+     * `RecallOptions.queryEmbedTotalTimeoutMs`) so an outage degrades a turn to
+     * BM25 within a few seconds instead of ~4 x `timeoutMs`. Not applied by
+     * `generateEmbeddings`.
+     */
+    totalTimeoutMs?: number;
 }
 
 /**
@@ -5393,6 +5415,12 @@ interface MemoryVaultSearchOptions {
     rerankTopN?: number;
     /** Multiplicative cross-encoder blend weight. Default 0.1. Only used when `rerank` is true. */
     ceWeight?: number;
+    /**
+     * Max ms a rerank waits for the cross-encoder's FIRST model load (default
+     * 10000). On expiry the search degrades to the fused ranking and reports
+     * `reranked: false`; the load continues in the background for later calls.
+     */
+    rerankLoadTimeoutMs?: number;
     /** Recency boost slope applied in the fused ranker. Default 1.0. */
     recencyAlpha?: number;
     /** Recency decay curve overrides (per-year decay slope, floor, no-date multiplier). */
@@ -5460,6 +5488,23 @@ interface MemoryVaultSearchOptions {
      * prefix stays byte-identical.
      */
     decryptLast?: boolean;
+    /**
+     * A vector the caller already computed for THIS query, with the model named in
+     * `embeddingOptions`. When set, the search uses it instead of embedding the
+     * query a second time — `recall()` embeds once for its chunk lane and passes
+     * the vector here. An EMPTY array means the caller's embed failed: the search
+     * degrades to BM25 (reported as embeddings unavailable) without re-trying a
+     * provider that just failed.
+     */
+    queryEmbedding?: number[];
+    /**
+     * Overall deadline, in ms, for embedding the QUERY (token read + all attempts
+     * + backoff). On expiry the search degrades to BM25 and reports embeddings
+     * unavailable. Unset = only the per-attempt deadlines apply. `recall()` sets
+     * it (default 8000 — see `RecallOptions.queryEmbedTotalTimeoutMs`); row
+     * (re)embeds are never subject to it.
+     */
+    queryEmbedTotalTimeoutMs?: number;
     /** Admission window multiplier for decrypt-last (`limit * admitFactor`). Default 3. */
     admitFactor?: number;
     /** Admission window floor for decrypt-last. Default 30. */
@@ -5476,7 +5521,14 @@ declare function preEmbedVaultMemories(vaultCtx: VaultMemoryOperationsContext, e
  * Eagerly embed a single piece of content and store it in the cache.
  * Call this when a vault memory is created or updated.
  */
-declare function eagerEmbedContent(content: string, embeddingOptions: EmbeddingOptions, cache: VaultEmbeddingCache, vaultCtx?: VaultMemoryOperationsContext, memoryId?: string): Promise<void>;
+declare function eagerEmbedContent(content: string, embeddingOptions: EmbeddingOptions, cache: VaultEmbeddingCache, vaultCtx?: VaultMemoryOperationsContext, memoryId?: string, 
+/**
+ * `updatedAt` of the committed row this content belongs to. When given, the
+ * cache entry is tied to that row version; without it the entry is
+ * unversioned and a search re-resolves it from the stored column instead of
+ * trusting it (see `vectorVersion.ts`).
+ */
+updatedAt?: Date): Promise<void>;
 /**
  * A single vault search result with its similarity score.
  */
@@ -5517,21 +5569,6 @@ interface VaultSearchResult {
  * @returns Sorted results (empty array on invalid input or empty vault)
  */
 declare function searchVaultMemories(query: string, vaultCtx: VaultMemoryOperationsContext, embeddingOptions: EmbeddingOptions, cache: VaultEmbeddingCache, searchOptions?: MemoryVaultSearchOptions): Promise<VaultSearchResult[]>;
-/**
- * Creates a memory vault search tool for use with chat completions.
- *
- * The tool allows the LLM to search through vault memories using semantic
- * similarity. Vault entries should have their embeddings pre-computed in the
- * cache (via preEmbedVaultMemories or eagerEmbedContent). Any missing
- * embeddings are computed on the fly as a fallback.
- *
- * @param vaultCtx - Vault operations context for database access
- * @param embeddingOptions - Options for embedding generation (auth, base URL)
- * @param cache - Pre-populated embedding cache
- * @param searchOptions - Optional search configuration
- * @returns A ToolConfig that can be passed to chat completion tools
- */
-declare function createMemoryVaultSearchTool(vaultCtx: VaultMemoryOperationsContext, embeddingOptions: EmbeddingOptions, cache: VaultEmbeddingCache, searchOptions?: MemoryVaultSearchOptions): ToolConfig;
 
 /**
  * C2 — Observation trend labels.
@@ -5754,6 +5791,20 @@ interface RecallOptions {
     rerankTopN?: number;
     /** Multiplicative cross-encoder blend weight. Default: 0.1. */
     ceWeight?: number;
+    /**
+     * Max ms a `mid`/`high` recall waits for the cross-encoder's FIRST model load
+     * before degrading to the fused ranking (reported as `rerank-unavailable`).
+     * Default: 10000. The load keeps going in the background for later calls.
+     */
+    rerankLoadTimeoutMs?: number;
+    /**
+     * Overall deadline, in ms, for embedding the query — token read, every retry
+     * attempt and the backoff between them. Default: 8000. On expiry the fact lane
+     * degrades to BM25 and the (cosine-only) chunk lane is skipped, reported as
+     * `embeddings-unavailable`, so an embeddings outage costs a turn at most this
+     * long rather than ~4 x the per-attempt timeout. `0` disables it.
+     */
+    queryEmbedTotalTimeoutMs?: number;
     /** Recency boost slope in the fused ranker. Default: 1.0. */
     recencyAlpha?: number;
     /** Recency decay curve overrides (per-year decay slope, floor, no-date multiplier). */
@@ -5781,7 +5832,8 @@ interface RecallOptions {
     maxHops?: number;
     /** Max neighbor entities expanded per hop. Default: 8. */
     entityFanout?: number;
-    /** Hard cap on accumulated memory IDs across all hops. Default: 64. */
+    /** Hard cap on graph-lane memory IDs — across all hops, and on the single-hop
+     *  lane `low`/`mid` run. Default: 64. */
     nodeBudget?: number;
     /**
      * PR5 — enable LLM graph path-refinement: at each traversal hop a model picks
@@ -6016,6 +6068,10 @@ interface RecallDiagnostics {
          * fast `vault_size = 0` population never established a baseline for this
          * cost, and why the ~850ms floor on the smallest NON-empty vaults had no
          * attributable owner.
+         *
+         * EXCEPTION — a mixed fact + chunk recall embeds the query ONCE, during
+         * {@link prep}, and hands the vector to both lanes. There `queryEmbed` is
+         * that shared embed and sits inside `prep`, not `factLane`.
          */
         queryEmbed: number;
         /** Chunk-lane search (`searchChunksOp`). */
@@ -7280,7 +7336,21 @@ declare function hardDeleteDecayedOp(ctx: VaultMemoryOperationsContext, id: stri
     hardDeleteWindowMs: number;
     now?: number;
 }): Promise<boolean>;
-declare function updateVaultMemoryEmbeddingOp(ctx: VaultMemoryOperationsContext, id: string, embedding: string, embeddingModel: string): Promise<boolean>;
+/**
+ * What a re-embed was computed from. A search embeds a row it READ earlier, so
+ * by the time the vector lands the row may have been edited (the tool clears
+ * the embedding on an edit, a consolidation rewrites content under
+ * preserveUpdatedAt); writing then would pin a vector for text that is gone.
+ */
+interface VaultEmbeddingExpectation {
+    /** Plaintext content the vector was computed from. */
+    content?: string;
+    /** `updatedAt` (ms) of the row as it was read. */
+    updatedAt?: number;
+}
+declare function updateVaultMemoryEmbeddingOp(ctx: VaultMemoryOperationsContext, id: string, embedding: string, embeddingModel: string, 
+/** When given, the write lands only if the row still matches it. */
+expected?: VaultEmbeddingExpectation): Promise<boolean>;
 
 /**
  * Ingest server-extracted photo memories into the local vault.
@@ -8747,7 +8817,7 @@ declare function reflect(query: string, ctx: RecallContext, options: ReflectOpti
 declare class RerankerUnavailableError extends Error {
     /** The underlying import failure, kept for debugging. */
     readonly reason: unknown;
-    constructor(reason: unknown);
+    constructor(reason: unknown, message?: string);
 }
 /**
  * Whether the cross-encoder reranker can run in this environment.
@@ -9476,14 +9546,18 @@ interface DurableAutoExtractorOptions extends Omit<CreateAutoExtractorOptions, "
     retryDelayMs?: number;
     /**
      * Ceiling on one batch, from the extraction call through retention. Defaults
-     * to 180 seconds — deliberately above the extraction call's own budget
-     * (`timeoutMs`, 60s per attempt, x `maxAttempts`), so this is a backstop
-     * against a promise that never settles at all rather than a second timeout
-     * competing with that one. Use `timeoutMs`/`totalTimeoutMs` to bound the LLM
-     * call itself. Without a ceiling here, one unsettled promise latched the
-     * drain and killed the outbox for the rest of the session.
+     * to the extraction call's own worst case — `extract.timeoutMs` (60s) x
+     * `extract.maxAttempts` (3) plus backoff, or `extract.totalTimeoutMs` when
+     * that is smaller — plus a fixed retain budget, so this is a backstop against
+     * a promise that never settles rather than a second timeout competing with
+     * the call's own. A batch past its ceiling is cancelled: its late writes are
+     * refused, so the retry cannot race it into duplicate rows. Without a
+     * ceiling, one unsettled promise latched the drain and killed the outbox for
+     * the rest of the session.
      */
     batchTimeoutMs?: number;
+    /** Clock for the failed-session spacing. Defaults to `Date.now`. */
+    now?: () => number;
 }
 /** Durable client extraction. Call once per authenticated database session.
  * Resumes pending jobs on creation, reads bounded batches from encrypted
@@ -9888,6 +9962,38 @@ declare function encodeChunkVector(vector: ArrayLike<number>): string;
  */
 declare function decodeChunkVector(vector: number[] | string | null | undefined, onMalformed?: () => void): Float32Array<ArrayBuffer>;
 
+/**
+ * `memory_vault_search` chat tool — the executor half of the vault search.
+ *
+ * Split out of `searchTool.ts` to break the `recall` <-> `searchTool` import
+ * cycle: `recall()` statically imports the vault search from `searchTool.ts`,
+ * and this executor routes through `recall()`. While both lived in one module
+ * the executor reached recall through a dynamic `import()`, and the cycle it
+ * papered over is what surfaced as the order-dependent
+ * `Cannot access 'nowMs' before initialization` flake. With the executor here,
+ * the graph is a straight line: executor -> recall -> searchTool.
+ *
+ * `searchTool.ts` must NOT import (or re-export) from this module, or the
+ * cycle comes back. The public name is re-exported from the barrel
+ * (`./index.ts`), which is the path every entry point already uses.
+ */
+
+/**
+ * Creates a memory vault search tool for use with chat completions.
+ *
+ * The tool allows the LLM to search through vault memories using semantic
+ * similarity. Vault entries should have their embeddings pre-computed in the
+ * cache (via preEmbedVaultMemories or eagerEmbedContent). Any missing
+ * embeddings are computed on the fly as a fallback.
+ *
+ * @param vaultCtx - Vault operations context for database access
+ * @param embeddingOptions - Options for embedding generation (auth, base URL)
+ * @param cache - Pre-populated embedding cache
+ * @param searchOptions - Optional search configuration
+ * @returns A ToolConfig that can be passed to chat completion tools
+ */
+declare function createMemoryVaultSearchTool(vaultCtx: VaultMemoryOperationsContext, embeddingOptions: EmbeddingOptions, cache: VaultEmbeddingCache, searchOptions?: MemoryVaultSearchOptions): ToolConfig;
+
 /**
  * Memory Vault Tool
  *
@@ -10475,8 +10581,15 @@ declare function useChatStorage(options: UseChatStorageOptions): UseChatStorageR
  *   rolling a release back past v46 after a device has run it resets that
  *   device's local database. Relevant to OTA, where a JS-only rollback can
  *   land on a database the newer build already migrated
+ * - v47: Added failed_sessions, failed_head, failed_at to
+ *   memory_extraction_jobs — the persisted poison count for a job's head batch
+ *   (how many worker sessions it failed in, which batch that count belongs to,
+ *   and when the last one was counted, so sessions minutes apart count once). Without it the retry
+ *   budget was in memory and reset on every turn, so one batch that could never
+ *   extract blocked its conversation's extraction forever. Additive, both
+ *   nullable, no backfill: NULL reads as "never failed"
  */
-declare const SDK_SCHEMA_VERSION = 46;
+declare const SDK_SCHEMA_VERSION = 47;
 /**
  * Combined WatermelonDB schema for all SDK storage modules.
  *
@@ -11095,4 +11208,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 ConsolidationAction, 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, type DurableAutoExtractorOptions, ENTITY_FANOUT, type EmbeddedWalletSignerFn, EncryptionKeyMissingError, type ExtractFactsOptions, type ExtractOutcome, type ExtractedCandidate, type ExtractedEntity, type ExtractionCursorStore, type ExtractionFunnel, type ExtractionTimings, 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 ManualFactType, type MemoriesNeedingTopicExtraction, type MemoryContextItem, type MemoryContextLane, type MemoryContextOptions, type MemoryContextResult, 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 RecallEmptyReason, 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 VaultMemoryWriter, type VaultSaveOperation, type VaultSearchResult, type VaultWriteAction, type VaultWriteInput, type VaultWriteOutcome, type VerificationSources, type VerifyMemoriesForPublishOptions, WalletPoller, type WeatherClassification, type WeatherPreProcessorOptions, type WebSearchClassification, type WebSearchPreProcessorOptions, addConversationMemoriesOp, archiveVaultMemoryOp, assembleMemoryContext, 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, createDurableAutoExtractor, createLlmDecayClassifier, createLlmNeighborRefiner, createMemoryEngineTool, createMemoryVaultSearchTool, createMemoryVaultTool, createMessageSourceResolver, createNotionTools, createPlatformCursorStore, createRecallTool, createStockPricePreProcessor, createStreamingDeAnonymizer, createVaultEmbeddingCache, createVaultFolderOp, createVaultMemoriesBatchOp, createVaultMemoryOp, createWeatherPreProcessor, createWebSearchPreProcessor, decodeChunkVector, decryptConversationTitle, deleteAllVaultMemoriesForUserOp, deleteMessageOp, 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, isEncrypted, isPiiRedactor, isRerankerAvailable, maskScopedEmbeddingCache, 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, shouldRecallMemory, 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 ConsolidationAction, 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, type DurableAutoExtractorOptions, ENTITY_FANOUT, type EmbeddedWalletSignerFn, EncryptionKeyMissingError, type ExtractFactsOptions, type ExtractOutcome, type ExtractedCandidate, type ExtractedEntity, type ExtractionCursorStore, type ExtractionFunnel, type ExtractionTimings, 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 ManualFactType, type MemoriesNeedingTopicExtraction, type MemoryContextItem, type MemoryContextLane, type MemoryContextOptions, type MemoryContextResult, 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 RecallEmptyReason, 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 VaultEmbeddingExpectation, type VaultFolderOperationsContext, type VaultMemoryOperationsContext, type VaultMemoryVisibility, type VaultMemoryWriter, type VaultSaveOperation, type VaultSearchResult, type VaultWriteAction, type VaultWriteInput, type VaultWriteOutcome, type VerificationSources, type VerifyMemoriesForPublishOptions, WalletPoller, type WeatherClassification, type WeatherPreProcessorOptions, type WebSearchClassification, type WebSearchPreProcessorOptions, addConversationMemoriesOp, archiveVaultMemoryOp, assembleMemoryContext, 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, createDurableAutoExtractor, createLlmDecayClassifier, createLlmNeighborRefiner, createMemoryEngineTool, createMemoryVaultSearchTool, createMemoryVaultTool, createMessageSourceResolver, createNotionTools, createPlatformCursorStore, createRecallTool, createStockPricePreProcessor, createStreamingDeAnonymizer, createVaultEmbeddingCache, createVaultFolderOp, createVaultMemoriesBatchOp, createVaultMemoryOp, createWeatherPreProcessor, createWebSearchPreProcessor, decodeChunkVector, decryptConversationTitle, deleteAllVaultMemoriesForUserOp, deleteMessageOp, 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, isEncrypted, isPiiRedactor, isRerankerAvailable, maskScopedEmbeddingCache, 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, shouldRecallMemory, stampTopicsExtractedAtOp, streamCancelPath, streamReplayPath, summarizeObservationTrends, supersedeVaultMemoryOp, synthesizeProfile, traverseGraphLane, ttlForType, updateVaultFolderContextOp, updateVaultFolderOp, updateVaultMemoryEmbeddingOp, updateVaultMemoryOp, upsertMessageOp, useChat, useChatStorage, useCredits, useEncryption, useModels, verifyMemoriesForPublish, xhrTransport };

package/dist/expo/index.d.ts

@@ -1358,6 +1358,28 @@ interface EmbeddingOptions {
      * while real PII never reaches the server. Used when PII redaction is active.
      */
     maskInput?: (text: string) => string;
+    /**
+     * Deadline, in ms, for EACH embeddings HTTP attempt (default 15000). An
+     * attempt that exceeds it is aborted and counts as a transient failure, so the
+     * bounded retry still applies. `0` disables the deadline.
+     */
+    timeoutMs?: number;
+    /**
+     * Deadline, in ms, for the `getToken()` read that precedes a request (default
+     * 10000). A provider that never settles rejects instead of hanging the
+     * embedding — and the recall waiting on it. `0` disables the deadline.
+     */
+    tokenTimeoutMs?: number;
+    /**
+     * Overall deadline, in ms, for one `generateEmbedding` call — the token read,
+     * every retry attempt and the backoff between them. Unset (the default) means
+     * only the per-attempt deadlines apply, which is right for background/bulk
+     * embeds. The recall query path sets it (see
+     * `RecallOptions.queryEmbedTotalTimeoutMs`) so an outage degrades a turn to
+     * BM25 within a few seconds instead of ~4 x `timeoutMs`. Not applied by
+     * `generateEmbeddings`.
+     */
+    totalTimeoutMs?: number;
 }
 
 /**
@@ -5393,6 +5415,12 @@ interface MemoryVaultSearchOptions {
     rerankTopN?: number;
     /** Multiplicative cross-encoder blend weight. Default 0.1. Only used when `rerank` is true. */
     ceWeight?: number;
+    /**
+     * Max ms a rerank waits for the cross-encoder's FIRST model load (default
+     * 10000). On expiry the search degrades to the fused ranking and reports
+     * `reranked: false`; the load continues in the background for later calls.
+     */
+    rerankLoadTimeoutMs?: number;
     /** Recency boost slope applied in the fused ranker. Default 1.0. */
     recencyAlpha?: number;
     /** Recency decay curve overrides (per-year decay slope, floor, no-date multiplier). */
@@ -5460,6 +5488,23 @@ interface MemoryVaultSearchOptions {
      * prefix stays byte-identical.
      */
     decryptLast?: boolean;
+    /**
+     * A vector the caller already computed for THIS query, with the model named in
+     * `embeddingOptions`. When set, the search uses it instead of embedding the
+     * query a second time — `recall()` embeds once for its chunk lane and passes
+     * the vector here. An EMPTY array means the caller's embed failed: the search
+     * degrades to BM25 (reported as embeddings unavailable) without re-trying a
+     * provider that just failed.
+     */
+    queryEmbedding?: number[];
+    /**
+     * Overall deadline, in ms, for embedding the QUERY (token read + all attempts
+     * + backoff). On expiry the search degrades to BM25 and reports embeddings
+     * unavailable. Unset = only the per-attempt deadlines apply. `recall()` sets
+     * it (default 8000 — see `RecallOptions.queryEmbedTotalTimeoutMs`); row
+     * (re)embeds are never subject to it.
+     */
+    queryEmbedTotalTimeoutMs?: number;
     /** Admission window multiplier for decrypt-last (`limit * admitFactor`). Default 3. */
     admitFactor?: number;
     /** Admission window floor for decrypt-last. Default 30. */
@@ -5476,7 +5521,14 @@ declare function preEmbedVaultMemories(vaultCtx: VaultMemoryOperationsContext, e
  * Eagerly embed a single piece of content and store it in the cache.
  * Call this when a vault memory is created or updated.
  */
-declare function eagerEmbedContent(content: string, embeddingOptions: EmbeddingOptions, cache: VaultEmbeddingCache, vaultCtx?: VaultMemoryOperationsContext, memoryId?: string): Promise<void>;
+declare function eagerEmbedContent(content: string, embeddingOptions: EmbeddingOptions, cache: VaultEmbeddingCache, vaultCtx?: VaultMemoryOperationsContext, memoryId?: string, 
+/**
+ * `updatedAt` of the committed row this content belongs to. When given, the
+ * cache entry is tied to that row version; without it the entry is
+ * unversioned and a search re-resolves it from the stored column instead of
+ * trusting it (see `vectorVersion.ts`).
+ */
+updatedAt?: Date): Promise<void>;
 /**
  * A single vault search result with its similarity score.
  */
@@ -5517,21 +5569,6 @@ interface VaultSearchResult {
  * @returns Sorted results (empty array on invalid input or empty vault)
  */
 declare function searchVaultMemories(query: string, vaultCtx: VaultMemoryOperationsContext, embeddingOptions: EmbeddingOptions, cache: VaultEmbeddingCache, searchOptions?: MemoryVaultSearchOptions): Promise<VaultSearchResult[]>;
-/**
- * Creates a memory vault search tool for use with chat completions.
- *
- * The tool allows the LLM to search through vault memories using semantic
- * similarity. Vault entries should have their embeddings pre-computed in the
- * cache (via preEmbedVaultMemories or eagerEmbedContent). Any missing
- * embeddings are computed on the fly as a fallback.
- *
- * @param vaultCtx - Vault operations context for database access
- * @param embeddingOptions - Options for embedding generation (auth, base URL)
- * @param cache - Pre-populated embedding cache
- * @param searchOptions - Optional search configuration
- * @returns A ToolConfig that can be passed to chat completion tools
- */
-declare function createMemoryVaultSearchTool(vaultCtx: VaultMemoryOperationsContext, embeddingOptions: EmbeddingOptions, cache: VaultEmbeddingCache, searchOptions?: MemoryVaultSearchOptions): ToolConfig;
 
 /**
  * C2 — Observation trend labels.
@@ -5754,6 +5791,20 @@ interface RecallOptions {
     rerankTopN?: number;
     /** Multiplicative cross-encoder blend weight. Default: 0.1. */
     ceWeight?: number;
+    /**
+     * Max ms a `mid`/`high` recall waits for the cross-encoder's FIRST model load
+     * before degrading to the fused ranking (reported as `rerank-unavailable`).
+     * Default: 10000. The load keeps going in the background for later calls.
+     */
+    rerankLoadTimeoutMs?: number;
+    /**
+     * Overall deadline, in ms, for embedding the query — token read, every retry
+     * attempt and the backoff between them. Default: 8000. On expiry the fact lane
+     * degrades to BM25 and the (cosine-only) chunk lane is skipped, reported as
+     * `embeddings-unavailable`, so an embeddings outage costs a turn at most this
+     * long rather than ~4 x the per-attempt timeout. `0` disables it.
+     */
+    queryEmbedTotalTimeoutMs?: number;
     /** Recency boost slope in the fused ranker. Default: 1.0. */
     recencyAlpha?: number;
     /** Recency decay curve overrides (per-year decay slope, floor, no-date multiplier). */
@@ -5781,7 +5832,8 @@ interface RecallOptions {
     maxHops?: number;
     /** Max neighbor entities expanded per hop. Default: 8. */
     entityFanout?: number;
-    /** Hard cap on accumulated memory IDs across all hops. Default: 64. */
+    /** Hard cap on graph-lane memory IDs — across all hops, and on the single-hop
+     *  lane `low`/`mid` run. Default: 64. */
     nodeBudget?: number;
     /**
      * PR5 — enable LLM graph path-refinement: at each traversal hop a model picks
@@ -6016,6 +6068,10 @@ interface RecallDiagnostics {
          * fast `vault_size = 0` population never established a baseline for this
          * cost, and why the ~850ms floor on the smallest NON-empty vaults had no
          * attributable owner.
+         *
+         * EXCEPTION — a mixed fact + chunk recall embeds the query ONCE, during
+         * {@link prep}, and hands the vector to both lanes. There `queryEmbed` is
+         * that shared embed and sits inside `prep`, not `factLane`.
          */
         queryEmbed: number;
         /** Chunk-lane search (`searchChunksOp`). */
@@ -7280,7 +7336,21 @@ declare function hardDeleteDecayedOp(ctx: VaultMemoryOperationsContext, id: stri
     hardDeleteWindowMs: number;
     now?: number;
 }): Promise<boolean>;
-declare function updateVaultMemoryEmbeddingOp(ctx: VaultMemoryOperationsContext, id: string, embedding: string, embeddingModel: string): Promise<boolean>;
+/**
+ * What a re-embed was computed from. A search embeds a row it READ earlier, so
+ * by the time the vector lands the row may have been edited (the tool clears
+ * the embedding on an edit, a consolidation rewrites content under
+ * preserveUpdatedAt); writing then would pin a vector for text that is gone.
+ */
+interface VaultEmbeddingExpectation {
+    /** Plaintext content the vector was computed from. */
+    content?: string;
+    /** `updatedAt` (ms) of the row as it was read. */
+    updatedAt?: number;
+}
+declare function updateVaultMemoryEmbeddingOp(ctx: VaultMemoryOperationsContext, id: string, embedding: string, embeddingModel: string, 
+/** When given, the write lands only if the row still matches it. */
+expected?: VaultEmbeddingExpectation): Promise<boolean>;
 
 /**
  * Ingest server-extracted photo memories into the local vault.
@@ -8747,7 +8817,7 @@ declare function reflect(query: string, ctx: RecallContext, options: ReflectOpti
 declare class RerankerUnavailableError extends Error {
     /** The underlying import failure, kept for debugging. */
     readonly reason: unknown;
-    constructor(reason: unknown);
+    constructor(reason: unknown, message?: string);
 }
 /**
  * Whether the cross-encoder reranker can run in this environment.
@@ -9476,14 +9546,18 @@ interface DurableAutoExtractorOptions extends Omit<CreateAutoExtractorOptions, "
     retryDelayMs?: number;
     /**
      * Ceiling on one batch, from the extraction call through retention. Defaults
-     * to 180 seconds — deliberately above the extraction call's own budget
-     * (`timeoutMs`, 60s per attempt, x `maxAttempts`), so this is a backstop
-     * against a promise that never settles at all rather than a second timeout
-     * competing with that one. Use `timeoutMs`/`totalTimeoutMs` to bound the LLM
-     * call itself. Without a ceiling here, one unsettled promise latched the
-     * drain and killed the outbox for the rest of the session.
+     * to the extraction call's own worst case — `extract.timeoutMs` (60s) x
+     * `extract.maxAttempts` (3) plus backoff, or `extract.totalTimeoutMs` when
+     * that is smaller — plus a fixed retain budget, so this is a backstop against
+     * a promise that never settles rather than a second timeout competing with
+     * the call's own. A batch past its ceiling is cancelled: its late writes are
+     * refused, so the retry cannot race it into duplicate rows. Without a
+     * ceiling, one unsettled promise latched the drain and killed the outbox for
+     * the rest of the session.
      */
     batchTimeoutMs?: number;
+    /** Clock for the failed-session spacing. Defaults to `Date.now`. */
+    now?: () => number;
 }
 /** Durable client extraction. Call once per authenticated database session.
  * Resumes pending jobs on creation, reads bounded batches from encrypted
@@ -9888,6 +9962,38 @@ declare function encodeChunkVector(vector: ArrayLike<number>): string;
  */
 declare function decodeChunkVector(vector: number[] | string | null | undefined, onMalformed?: () => void): Float32Array<ArrayBuffer>;
 
+/**
+ * `memory_vault_search` chat tool — the executor half of the vault search.
+ *
+ * Split out of `searchTool.ts` to break the `recall` <-> `searchTool` import
+ * cycle: `recall()` statically imports the vault search from `searchTool.ts`,
+ * and this executor routes through `recall()`. While both lived in one module
+ * the executor reached recall through a dynamic `import()`, and the cycle it
+ * papered over is what surfaced as the order-dependent
+ * `Cannot access 'nowMs' before initialization` flake. With the executor here,
+ * the graph is a straight line: executor -> recall -> searchTool.
+ *
+ * `searchTool.ts` must NOT import (or re-export) from this module, or the
+ * cycle comes back. The public name is re-exported from the barrel
+ * (`./index.ts`), which is the path every entry point already uses.
+ */
+
+/**
+ * Creates a memory vault search tool for use with chat completions.
+ *
+ * The tool allows the LLM to search through vault memories using semantic
+ * similarity. Vault entries should have their embeddings pre-computed in the
+ * cache (via preEmbedVaultMemories or eagerEmbedContent). Any missing
+ * embeddings are computed on the fly as a fallback.
+ *
+ * @param vaultCtx - Vault operations context for database access
+ * @param embeddingOptions - Options for embedding generation (auth, base URL)
+ * @param cache - Pre-populated embedding cache
+ * @param searchOptions - Optional search configuration
+ * @returns A ToolConfig that can be passed to chat completion tools
+ */
+declare function createMemoryVaultSearchTool(vaultCtx: VaultMemoryOperationsContext, embeddingOptions: EmbeddingOptions, cache: VaultEmbeddingCache, searchOptions?: MemoryVaultSearchOptions): ToolConfig;
+
 /**
  * Memory Vault Tool
  *
@@ -10475,8 +10581,15 @@ declare function useChatStorage(options: UseChatStorageOptions): UseChatStorageR
  *   rolling a release back past v46 after a device has run it resets that
  *   device's local database. Relevant to OTA, where a JS-only rollback can
  *   land on a database the newer build already migrated
+ * - v47: Added failed_sessions, failed_head, failed_at to
+ *   memory_extraction_jobs — the persisted poison count for a job's head batch
+ *   (how many worker sessions it failed in, which batch that count belongs to,
+ *   and when the last one was counted, so sessions minutes apart count once). Without it the retry
+ *   budget was in memory and reset on every turn, so one batch that could never
+ *   extract blocked its conversation's extraction forever. Additive, both
+ *   nullable, no backfill: NULL reads as "never failed"
  */
-declare const SDK_SCHEMA_VERSION = 46;
+declare const SDK_SCHEMA_VERSION = 47;
 /**
  * Combined WatermelonDB schema for all SDK storage modules.
  *
@@ -11095,4 +11208,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 ConsolidationAction, 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, type DurableAutoExtractorOptions, ENTITY_FANOUT, type EmbeddedWalletSignerFn, EncryptionKeyMissingError, type ExtractFactsOptions, type ExtractOutcome, type ExtractedCandidate, type ExtractedEntity, type ExtractionCursorStore, type ExtractionFunnel, type ExtractionTimings, 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 ManualFactType, type MemoriesNeedingTopicExtraction, type MemoryContextItem, type MemoryContextLane, type MemoryContextOptions, type MemoryContextResult, 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 RecallEmptyReason, 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 VaultMemoryWriter, type VaultSaveOperation, type VaultSearchResult, type VaultWriteAction, type VaultWriteInput, type VaultWriteOutcome, type VerificationSources, type VerifyMemoriesForPublishOptions, WalletPoller, type WeatherClassification, type WeatherPreProcessorOptions, type WebSearchClassification, type WebSearchPreProcessorOptions, addConversationMemoriesOp, archiveVaultMemoryOp, assembleMemoryContext, 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, createDurableAutoExtractor, createLlmDecayClassifier, createLlmNeighborRefiner, createMemoryEngineTool, createMemoryVaultSearchTool, createMemoryVaultTool, createMessageSourceResolver, createNotionTools, createPlatformCursorStore, createRecallTool, createStockPricePreProcessor, createStreamingDeAnonymizer, createVaultEmbeddingCache, createVaultFolderOp, createVaultMemoriesBatchOp, createVaultMemoryOp, createWeatherPreProcessor, createWebSearchPreProcessor, decodeChunkVector, decryptConversationTitle, deleteAllVaultMemoriesForUserOp, deleteMessageOp, 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, isEncrypted, isPiiRedactor, isRerankerAvailable, maskScopedEmbeddingCache, 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, shouldRecallMemory, 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 ConsolidationAction, 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, type DurableAutoExtractorOptions, ENTITY_FANOUT, type EmbeddedWalletSignerFn, EncryptionKeyMissingError, type ExtractFactsOptions, type ExtractOutcome, type ExtractedCandidate, type ExtractedEntity, type ExtractionCursorStore, type ExtractionFunnel, type ExtractionTimings, 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 ManualFactType, type MemoriesNeedingTopicExtraction, type MemoryContextItem, type MemoryContextLane, type MemoryContextOptions, type MemoryContextResult, 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 RecallEmptyReason, 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 VaultEmbeddingExpectation, type VaultFolderOperationsContext, type VaultMemoryOperationsContext, type VaultMemoryVisibility, type VaultMemoryWriter, type VaultSaveOperation, type VaultSearchResult, type VaultWriteAction, type VaultWriteInput, type VaultWriteOutcome, type VerificationSources, type VerifyMemoriesForPublishOptions, WalletPoller, type WeatherClassification, type WeatherPreProcessorOptions, type WebSearchClassification, type WebSearchPreProcessorOptions, addConversationMemoriesOp, archiveVaultMemoryOp, assembleMemoryContext, 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, createDurableAutoExtractor, createLlmDecayClassifier, createLlmNeighborRefiner, createMemoryEngineTool, createMemoryVaultSearchTool, createMemoryVaultTool, createMessageSourceResolver, createNotionTools, createPlatformCursorStore, createRecallTool, createStockPricePreProcessor, createStreamingDeAnonymizer, createVaultEmbeddingCache, createVaultFolderOp, createVaultMemoriesBatchOp, createVaultMemoryOp, createWeatherPreProcessor, createWebSearchPreProcessor, decodeChunkVector, decryptConversationTitle, deleteAllVaultMemoriesForUserOp, deleteMessageOp, 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, isEncrypted, isPiiRedactor, isRerankerAvailable, maskScopedEmbeddingCache, 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, shouldRecallMemory, stampTopicsExtractedAtOp, streamCancelPath, streamReplayPath, summarizeObservationTrends, supersedeVaultMemoryOp, synthesizeProfile, traverseGraphLane, ttlForType, updateVaultFolderContextOp, updateVaultFolderOp, updateVaultMemoryEmbeddingOp, updateVaultMemoryOp, upsertMessageOp, useChat, useChatStorage, useCredits, useEncryption, useModels, verifyMemoriesForPublish, xhrTransport };