@anuma/sdk 2.3.1 → 2.4.1

package/dist/expo/index.d.mts

@@ -4248,6 +4248,37 @@ declare function getConversationsByProjectLazyOp(ctx: StorageOperationsContext,
 declare function upsertMessageOp(ctx: StorageOperationsContext, opts: CreateMessageOptions & {
     uniqueId: string;
 }): Promise<StoredMessage>;
+/**
+ * Decrypted, model-native chunk vectors for one message, cached across recall
+ * calls so the chunk lane doesn't re-decrypt + re-JSON.parse every message's
+ * embeddings on every query. Keyed by message id; `version` is the message's
+ * `updated_at` at cache time, so a re-embed (which bumps `updated_at`) misses
+ * and repopulates. Vectors are stored Float32 — model-native precision, half
+ * the RAM of float64 `number[]` — mirroring the vault embedding cache (#705).
+ * Content text is deliberately NOT cached (see searchChunksOp): it isn't
+ * needed for scoring, and keeping decrypted content out of the cache preserves
+ * the SDK's data-at-rest posture.
+ */
+interface CachedChunkVectors {
+    /** Message `updated_at` (ms) at cache time — the invalidation token. */
+    version: number;
+    /**
+     * Per-chunk embedding vectors, index-aligned with the message's decrypted
+     * `chunks` array (empty-vector chunks kept as zero-length placeholders so
+     * indices stay aligned). Empty when the message has only a whole-message
+     * `fallback` vector.
+     */
+    chunks: Float32Array[];
+    /** Whole-message vector when the message was embedded without chunking. */
+    fallback?: Float32Array;
+}
+/**
+ * Cache consumed by {@link searchChunksOp}, keyed by message id. A plain `Map`
+ * (satisfied by the LRU from `createChunkVectorCache`) — mirrors
+ * `VaultEmbeddingCache` so consumers get the same `clear()`/`delete()`
+ * ergonomics on an encryption-key reset.
+ */
+type ChunkVectorCache = Map<string, CachedChunkVectors>;
 
 declare const chatStorageSchema: Readonly<{
     version: _nozbe_watermelondb_Schema.SchemaVersion;
@@ -5047,6 +5078,14 @@ interface RecallOptions {
      * resolves windows in 2026 and never overlaps stored event_time.
      */
     now?: number;
+    /**
+     * Best-effort observability hook. Called once per `recall()` with per-lane
+     * timings, lane counts, and soft-degradation signals — the raw material for
+     * tuning latency/quality and for wiring recall telemetry to PostHog. Invoked
+     * synchronously just before `recall()` returns; a throwing callback is
+     * swallowed (diagnostics must never break retrieval). Off unless provided.
+     */
+    onDiagnostics?: (diagnostics: RecallDiagnostics) => void;
     /** Number of candidates fed to the cross-encoder rerank stage. Default: 30. */
     rerankTopN?: number;
     /** Multiplicative cross-encoder blend weight. Default: 0.1. */
@@ -5077,6 +5116,12 @@ interface RecallContext {
     embeddingOptions: EmbeddingOptions;
     /** Vault embedding LRU cache. */
     vaultCache?: VaultEmbeddingCache;
+    /**
+     * Optional chunk-vector LRU cache. When provided, the chunk lane skips the
+     * per-query decrypt + JSON.parse of every message's chunk vectors on warm
+     * entries. Build via `createChunkVectorCache`. Omit for legacy behavior.
+     */
+    chunkCache?: ChunkVectorCache;
     /**
      * Optional — when provided, recall extracts entities from the query
      * and adds a graph lane to the RRF fusion (memories sharing entities
@@ -5096,6 +5141,48 @@ interface RecallResult {
     /** Diagnostic: total memories in the vault when fact lane was queried. */
     vaultSize?: number;
 }
+/** Soft-degradation signals surfaced via {@link RecallDiagnostics.degraded}. */
+type RecallDegradation = 
+/** Rerank was requested (budget mid/high) but the cross-encoder didn't run
+ *  this call — unavailable (e.g. React Native) or a transient failure. */
+"rerank-unavailable"
+/** `budget: 'high'` requested but no `decomposeOptions`, so query
+ *  decomposition was skipped and the budget downgraded to mid. */
+ | "decompose-unavailable";
+/**
+ * Per-call recall observability payload (see {@link RecallOptions.onDiagnostics}).
+ * All timings are wall-clock milliseconds. Lane counts are post-dedupe,
+ * pre-fusion. Intended to be forwarded to a metrics sink (e.g. PostHog).
+ */
+interface RecallDiagnostics {
+    /** Budget actually executed (may have downgraded from the requested one). */
+    usedBudget: Budget;
+    /** Whether the cross-encoder actually reranked the fact lane this call. */
+    reranked: boolean;
+    /** Total candidates considered before truncation. */
+    candidateCount: number;
+    /** Total vault size when the fact lane ran (absent if it didn't). */
+    vaultSize?: number;
+    /** Facts the fact lane returned (post-dedupe, pre-fusion). */
+    factCount: number;
+    /** Chunks the chunk lane returned (post-dedupe, pre-fusion). */
+    chunkCount: number;
+    /** Wall-clock phase timings (ms). */
+    timings: {
+        /** Whole `recall()` call. */
+        total: number;
+        /** Parallel query-embed + graph/temporal side-lane build. */
+        prep: number;
+        /** Vault fact-lane search (`searchVaultMemoriesWithSize`). */
+        factLane: number;
+        /** Chunk-lane search (`searchChunksOp`). */
+        chunkLane: number;
+        /** Cross-lane RRF fusion + provenance dedup after both lanes. */
+        fuse: number;
+    };
+    /** Soft-degradation signals that fired this call (empty when clean). */
+    degraded: RecallDegradation[];
+}
 type RetainAction = "create" | "merge" | "update" | "skip" | "suppressed";
 type RetainSource = "manual" | "auto-extracted" | "capsule";
 /** Why the consolidator fell back to "create" instead of a real decision. */
@@ -5446,15 +5533,32 @@ declare function extractAndRetain(messages: AutoExtractMessage[], retainCtx: Ret
  * newest (superset) message list re-covers any superseded turn. Turns for
  * different conversations queue independently and never displace each other.
  *
- * Watermark + window: the worker keeps an in-memory, per-conversation
- * watermark of the last message it extracted through. Each run sends every
- * message *after* that watermark (plus a small overlap for coreference,
- * capped at `maxWindowSize`) rather than a fixed trailing slice — so facts
- * stated in turns that arrived during a busy window are still examined instead
- * of scrolling out of a last-N window. The watermark is session-scoped (in
- * memory); it does NOT survive process death, so an extraction killed mid-flight
- * by app backgrounding is not replayed in a later session. Durable cross-process
- * replay would require a persisted watermark (out of scope here).
+ * Watermark + window: the worker keeps a per-conversation watermark of the
+ * last message it extracted through. Each run sends every message *after* that
+ * watermark (plus a small overlap for coreference, capped at `maxWindowSize`)
+ * rather than a fixed trailing slice — so facts stated in turns that arrived
+ * during a busy window are still examined instead of scrolling out of a last-N
+ * window.
+ *
+ * Durability: the in-memory watermark alone does NOT survive process death, so
+ * a session killed after messages accumulate but before extraction would, on
+ * the next launch, fall back to a trailing-window guess and could skip the
+ * un-extracted tail. Pass a {@link ExtractionCursorStore} (`cursorStore`) to
+ * persist the watermark per conversation — it is hydrated synchronously the
+ * first time a conversation is touched, and written through on every *contiguous*
+ * advance (never on a trailing-slice guess, which could jump the durable cursor
+ * past an un-extracted gap), so a later session resumes exactly after the last
+ * extracted message. The primary guarantee is single-session resume across
+ * process death.
+ *
+ * Concurrent sessions sharing one store (web `localStorage`, mobile MMKV) are
+ * best-effort, NOT exclusive: two sessions can each hydrate the same cursor
+ * before either advances it and briefly re-extract the same turn (retain()'s
+ * dedup/consolidation absorbs the duplicate — wasteful, not corrupting). The
+ * durable write is last-writer-wins with a regression guard (it won't move the
+ * cursor backwards when the currently-stored id is ahead within the same turn's
+ * messages), but it does not serialize writers. Omit `cursorStore` for the
+ * legacy in-memory-only behavior.
  *
  * Memory Studio panel subscribes by passing `onMemoryExtracted` and/or
  * `onTurnComplete` callbacks. The Studio uses `onMemoryExtracted` to
@@ -5502,6 +5606,37 @@ interface TurnCompleteEvent {
     outcome: ExtractOutcome;
 }
 /** @public */
+/**
+ * Durable per-conversation extraction cursor. Synchronous by contract (both
+ * SDK platform stores — web `localStorage`, mobile MMKV — are sync), so the
+ * worker can hydrate the watermark inline without changing its fire-and-forget
+ * control flow. Implementations should be best-effort; the worker guards every
+ * call, so a throwing store degrades to in-memory-only rather than breaking
+ * extraction.
+ *
+ * @public
+ */
+interface ExtractionCursorStore {
+    /** Last message id extracted through for `conversationId`, or undefined. */
+    get(conversationId: string): string | undefined;
+    /** Persist the last-extracted message id for `conversationId`. */
+    set(conversationId: string, messageId: string): void;
+}
+/** Minimal synchronous key/value surface — satisfied by the SDK's
+ * `PlatformStorage` (web `localStorage`, mobile MMKV). */
+interface SyncKeyValueStore {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+}
+/**
+ * Build an {@link ExtractionCursorStore} over a synchronous key/value store
+ * (e.g. the SDK's `PlatformStorage`). Keys are namespaced by `keyPrefix`.
+ * Reads/writes are guarded so a store that throws (quota, private mode) can't
+ * break extraction — the watermark just falls back to in-memory.
+ *
+ * @public
+ */
+declare function createPlatformCursorStore(storage: SyncKeyValueStore, keyPrefix?: string): ExtractionCursorStore;
 interface CreateAutoExtractorOptions {
     retainCtx: RetainContext;
     extract: ExtractFactsOptions;
@@ -5532,6 +5667,15 @@ interface CreateAutoExtractorOptions {
      * sessions in RAM-constrained hosts. Default 200.
      */
     maxTrackedConversations?: number;
+    /**
+     * Durable per-conversation watermark store. When provided, the watermark is
+     * hydrated from it the first time each conversation is touched and written
+     * through on every advance, so extraction resumes exactly after the last
+     * extracted message across process restarts (and, with a process-shared
+     * store, across concurrent sessions). Build via {@link createPlatformCursorStore}.
+     * Omit for in-memory-only (legacy) behavior.
+     */
+    cursorStore?: ExtractionCursorStore;
     /**
      * Entity / memory_entity write context — when provided, each retained
      * candidate's `entities[]` is persisted via `linkMemoryEntitiesOp`,
@@ -5607,6 +5751,24 @@ interface AutoExtractor {
  */
 declare function createAutoExtractor(options: CreateAutoExtractorOptions): AutoExtractor;
 
+/**
+ * Default entry cap for the chunk-vector cache. Entries are keyed by message
+ * id, so this bounds how many messages' decrypted chunk vectors stay resident.
+ * Matches the vault cache default (#705).
+ */
+declare const DEFAULT_CHUNK_CACHE_SIZE = 5000;
+/**
+ * Create a {@link ChunkVectorCache} backed by an LRU. Pass the returned cache
+ * into `recall()` (via `RecallContext.chunkCache`) so the chunk lane skips the
+ * per-query decrypt + JSON.parse of every message's chunk vectors on warm
+ * entries. Stale entries self-invalidate on `updated_at` mismatch, so no
+ * explicit invalidation is required beyond clearing it on an encryption-key
+ * reset (wallet switch), mirroring the vault embedding cache.
+ *
+ * @public
+ */
+declare function createChunkVectorCache(maxSize?: number): ChunkVectorCache;
+
 /**
  * Unified Recall API — single retrieval surface above vault + engine.
  *
@@ -5759,6 +5921,46 @@ interface ReflectResult {
  */
 declare function reflect(query: string, ctx: RecallContext, options: ReflectOptions): Promise<ReflectResult>;
 
+/**
+ * Cross-encoder reranker — local inference via @huggingface/transformers.
+ *
+ * Mirrors Hindsight's default reranker (`cross-encoder/ms-marco-MiniLM-L-6-v2`)
+ * for parity with their reference pipeline. Runs fully on-device — no API
+ * key, no network call, works offline. Model file ~25MB; lazy-loaded and
+ * cached for the lifetime of the process.
+ *
+ * Implementation note: transformers.js v3 doesn't expose a "text-ranking"
+ * pipeline, so we drive the cross-encoder directly via the tokenizer +
+ * sequence-classification model. The model outputs a single relevance
+ * logit per (query, doc) pair; we sigmoid it into [0, 1].
+ */
+/**
+ * Thrown when the cross-encoder cannot run because its optional peer
+ * dependency (`@huggingface/transformers`) isn't installed — the expected
+ * state on React Native, where the package isn't part of the bundle. Callers
+ * treat this as "reranker unavailable, degrade to the fused ranking" rather
+ * than a transient error worth warning about on every recall.
+ *
+ * @public
+ */
+declare class RerankerUnavailableError extends Error {
+    /** The underlying import failure, kept for debugging. */
+    readonly reason: unknown;
+    constructor(reason: unknown);
+}
+/**
+ * Whether the cross-encoder reranker can run in this environment.
+ *
+ * - `true` — the model loaded successfully at least once.
+ * - `false` — the optional `@huggingface/transformers` dependency is missing
+ *   (e.g. React Native); reranking is permanently degraded to the fused
+ *   ranking and no further load attempts are made.
+ * - `undefined` — no rerank has been attempted yet, so availability is unknown.
+ *
+ * @public
+ */
+declare function isRerankerAvailable(): boolean | undefined;
+
 /**
  * Standalone topic (entity) extraction for EXISTING memories.
  *
@@ -7133,4 +7335,4 @@ declare function refreshNotionAccessToken(params: NotionRefreshTokenParams): Pro
  */
 declare function createNotionTools(getAccessToken: () => string | null, requestNotionAccess: () => Promise<string>): ToolConfig[];
 
-export { type AutoExtractMessage, type AutoExtractor, type Budget, type CachedServerTools, Conversation as ChatConversation, Message as ChatMessage, type ChatRole, type ChunkingOptions, type ConsolidationFallbackReason, type ConversationMemoryInput, ConversationMemory as ConversationMemoryModel, type ConversationMemoryOperationsContext, type CreateAutoExtractorOptions, type CreateConversationOptions, type CreateMessageOptions, type CreateVaultFolderOptions, type CreateVaultMemoryOptions, type CryptoPriceClassification, type CryptoPricePreProcessorOptions, DEFAULT_CACHE_EXPIRATION_MS, DEFAULT_CHUNK_OVERLAP, DEFAULT_CHUNK_SIZE, DEFAULT_MIN_CHUNK_SIZE, DEFAULT_VAULT_CACHE_SIZE, DatabaseManager, type DatabaseManagerLogger, type DatabaseManagerOptions, type EmbeddedWalletSignerFn, type ExtractFactsOptions, type ExtractOutcome, type ExtractedCandidate, type ExtractedEntity, type FactType, type FileMetadata, type FlushResult, type GetMessagesPageOptions, INFERENCE_ID_HEADER, type LazyStoredConversation, type Logger, LoggerProvider, type LoggerProviderProps, type MemoriesNeedingTopicExtraction, type EmbeddingOptions as MemoryEngineEmbeddingOptions, type MemoryEngineResult, type MemoryEngineSearchOptions, type MemoryExtractedEvent, type MemoryKind, type MemoryVaultSearchOptions, type MemoryVaultToolOptions, type MessageRedactionResult, type MessageSkeleton, NOTION_OAUTH_CONFIG, type NotionAuthUrlParams, type NotionClientRegistration, type NotionExchangeCodeParams, type NotionOAuthEndpoints, type NotionPKCEChallenge, type NotionRefreshTokenParams, type NotionTokenResponse, PII_PATTERNS, type PiiCategory, type PiiMatch, type PiiPattern, PiiRedactor, type PiiRedactorOptions, type PlatformStorage, type PortalLlmAuth, type PromptPreProcessor, type PromptPreProcessorContext, type QuantizedEmbedding, QueueManager, type QueueStatus, RECALL_MAX_LIMIT, RECALL_TOOL_NAME, type RankedMemory, type RecallContext, type RecallOptions, type RecallResult, type RecallToolCallbacks, type RecallToolOptions, type RecencyOptions, type RedactionResult, type ReflectOptions, type ReflectResult, type ResumeStreamOptions, type ResumeStreamResult, type ResumeStreamWithStorageResult, type RetainAction, type RetainContext, type RetainOptions, type RetainResult, type RetainSource, SDK_SCHEMA_VERSION, STREAM_RESUMABLE_HEADER, type ScoreBreakdown, 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, TOPIC_EXTRACTION_BATCH_SIZE, type TextChunk, type TopicExtractOptions, type TopicExtractionInput, type TopicExtractionRunResult, type TurnCompleteEvent, type TurnSkippedEvent, type UpdateVaultFolderOptions, type UpdateVaultMemoryOptions, type UseChatStorageOptions, type UseChatStorageResult, type UseCreditsOptions, type UseCreditsResult, type UseModelsOptions, type UseModelsResult, type VaultEmbeddingCache, type VaultFolderOperationsContext, type VaultMemoryOperationsContext, type VaultSaveOperation, type VaultSearchResult, WalletPoller, type WeatherClassification, type WeatherPreProcessorOptions, type WebSearchClassification, type WebSearchPreProcessorOptions, addConversationMemoriesOp, buildNotionAuthUrl, chatStorageMigrations, chatStorageSchema, chunkAndEmbedAllMessages, chunkAndEmbedMessage, chunkText, classifyCryptoPrice, classifyCryptoPriceBatch, classifyStockPrice, classifyStockPriceBatch, classifyWeather, classifyWeatherBatch, classifyWebSearch, classifyWebSearchBatch, clearAllEncryptionKeys, clearAllEncryptionState, clearConversationMemoriesOp, clearEncryptionKey, clearLazyTitleCache, clearServerToolsCache, consoleLogger, conversationMemoryToStored, cosineInt8, createAutoExtractor, createCryptoPricePreProcessor, createMemoryEngineTool, createMemoryVaultSearchTool, createMemoryVaultTool, createNotionTools, createRecallTool, createStockPricePreProcessor, createStreamingDeAnonymizer, createVaultEmbeddingCache, createVaultFolderOp, createVaultMemoriesBatchOp, createVaultMemoryOp, createWeatherPreProcessor, createWebSearchPreProcessor, decryptConversationTitle, deleteAllVaultMemoriesForUserOp, deleteVaultFolderOp, deleteVaultMemoryOp, dequantizeEmbedding, discoverNotionOAuthEndpoints, eagerEmbedContent, embedAllMessages, embedMessage, ensureDefaultFoldersOp, exchangeNotionCode, extractAndLinkEntitiesForMemoriesOp, extractAndRetain, extractEntitiesForMemories, extractFacts, generateConversationId, generateEmbedding, generateEmbeddings, generateNotionPKCE, getAllVaultFoldersOp, getAllVaultMemoriesOp, getAllVaultMemoryContentsOp, getCachedServerTools, getConversationMemoriesOp, getConversationsByProjectLazyOp, getConversationsLazyOp, getLogger, getMemoriesNeedingTopicExtractionOp, getServerTools, getUnfiledVaultMemoriesOp, getVaultFolderMemoryCountOp, getVaultMemoryOp, hasEncryptionKey, isPiiRedactor, moveMemoriesToFolderOp, noopLogger, onKeyAvailable, preEmbedVaultMemories, quantizeEmbedding, queueManager, recall, reflect, refreshNotionAccessToken, registerNotionClient, requestEncryptionKey, resolvePiiRedactor, resumeStream, retain, sdkMigrations, sdkModelClasses, sdkSchema, searchVaultMemories, setLogger, shouldChunkMessage, stampTopicsExtractedAtOp, streamCancelPath, streamReplayPath, updateVaultFolderContextOp, updateVaultFolderOp, updateVaultMemoryEmbeddingOp, updateVaultMemoryOp, upsertMessageOp, useChat, useChatStorage, useCredits, useEncryption, useModels, xhrTransport };
+export { type AutoExtractMessage, type AutoExtractor, type Budget, 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 CreateMessageOptions, type CreateVaultFolderOptions, type CreateVaultMemoryOptions, type CryptoPriceClassification, type CryptoPricePreProcessorOptions, DEFAULT_CACHE_EXPIRATION_MS, DEFAULT_CHUNK_CACHE_SIZE, DEFAULT_CHUNK_OVERLAP, DEFAULT_CHUNK_SIZE, DEFAULT_MIN_CHUNK_SIZE, DEFAULT_VAULT_CACHE_SIZE, DatabaseManager, type DatabaseManagerLogger, type DatabaseManagerOptions, type EmbeddedWalletSignerFn, type ExtractFactsOptions, type ExtractOutcome, type ExtractedCandidate, type ExtractedEntity, type ExtractionCursorStore, type FactType, type FileMetadata, type FlushResult, type GetMessagesPageOptions, INFERENCE_ID_HEADER, type LazyStoredConversation, type Logger, LoggerProvider, type LoggerProviderProps, type MemoriesNeedingTopicExtraction, type EmbeddingOptions as MemoryEngineEmbeddingOptions, type MemoryEngineResult, type MemoryEngineSearchOptions, type MemoryExtractedEvent, type MemoryKind, type MemoryVaultSearchOptions, type MemoryVaultToolOptions, type MessageRedactionResult, type MessageSkeleton, NOTION_OAUTH_CONFIG, type NotionAuthUrlParams, type NotionClientRegistration, type NotionExchangeCodeParams, type NotionOAuthEndpoints, type NotionPKCEChallenge, type NotionRefreshTokenParams, type NotionTokenResponse, PII_PATTERNS, type PiiCategory, type PiiMatch, type PiiPattern, PiiRedactor, type PiiRedactorOptions, type PlatformStorage, type PortalLlmAuth, type PromptPreProcessor, type PromptPreProcessorContext, type QuantizedEmbedding, QueueManager, type QueueStatus, RECALL_MAX_LIMIT, RECALL_TOOL_NAME, type RankedMemory, type RecallContext, type RecallDegradation, type RecallDiagnostics, type RecallOptions, type RecallResult, type RecallToolCallbacks, type RecallToolOptions, type RecencyOptions, type RedactionResult, type ReflectOptions, type ReflectResult, RerankerUnavailableError, type ResumeStreamOptions, type ResumeStreamResult, type ResumeStreamWithStorageResult, type RetainAction, type RetainContext, type RetainOptions, type RetainResult, type RetainSource, SDK_SCHEMA_VERSION, STREAM_RESUMABLE_HEADER, type ScoreBreakdown, 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, TOPIC_EXTRACTION_BATCH_SIZE, type TextChunk, type TopicExtractOptions, type TopicExtractionInput, type TopicExtractionRunResult, type TurnCompleteEvent, type TurnSkippedEvent, type UpdateVaultFolderOptions, type UpdateVaultMemoryOptions, type UseChatStorageOptions, type UseChatStorageResult, type UseCreditsOptions, type UseCreditsResult, type UseModelsOptions, type UseModelsResult, type VaultEmbeddingCache, type VaultFolderOperationsContext, type VaultMemoryOperationsContext, type VaultSaveOperation, type VaultSearchResult, WalletPoller, type WeatherClassification, type WeatherPreProcessorOptions, type WebSearchClassification, type WebSearchPreProcessorOptions, addConversationMemoriesOp, buildNotionAuthUrl, chatStorageMigrations, chatStorageSchema, chunkAndEmbedAllMessages, chunkAndEmbedMessage, chunkText, classifyCryptoPrice, classifyCryptoPriceBatch, classifyStockPrice, classifyStockPriceBatch, classifyWeather, classifyWeatherBatch, classifyWebSearch, classifyWebSearchBatch, clearAllEncryptionKeys, clearAllEncryptionState, clearConversationMemoriesOp, clearEncryptionKey, clearLazyTitleCache, clearServerToolsCache, consoleLogger, conversationMemoryToStored, cosineInt8, createAutoExtractor, createChunkVectorCache, createCryptoPricePreProcessor, createMemoryEngineTool, createMemoryVaultSearchTool, createMemoryVaultTool, createNotionTools, createPlatformCursorStore, createRecallTool, createStockPricePreProcessor, createStreamingDeAnonymizer, createVaultEmbeddingCache, createVaultFolderOp, createVaultMemoriesBatchOp, createVaultMemoryOp, createWeatherPreProcessor, createWebSearchPreProcessor, decryptConversationTitle, deleteAllVaultMemoriesForUserOp, deleteVaultFolderOp, deleteVaultMemoryOp, dequantizeEmbedding, discoverNotionOAuthEndpoints, eagerEmbedContent, embedAllMessages, embedMessage, ensureDefaultFoldersOp, exchangeNotionCode, extractAndLinkEntitiesForMemoriesOp, extractAndRetain, extractEntitiesForMemories, extractFacts, generateConversationId, generateEmbedding, generateEmbeddings, generateNotionPKCE, getAllVaultFoldersOp, getAllVaultMemoriesOp, getAllVaultMemoryContentsOp, getCachedServerTools, getConversationMemoriesOp, getConversationsByProjectLazyOp, getConversationsLazyOp, getLogger, getMemoriesNeedingTopicExtractionOp, getServerTools, getUnfiledVaultMemoriesOp, getVaultFolderMemoryCountOp, getVaultMemoryOp, hasEncryptionKey, isPiiRedactor, isRerankerAvailable, moveMemoriesToFolderOp, noopLogger, onKeyAvailable, preEmbedVaultMemories, quantizeEmbedding, queueManager, recall, reflect, refreshNotionAccessToken, registerNotionClient, requestEncryptionKey, resolvePiiRedactor, resumeStream, retain, sdkMigrations, sdkModelClasses, sdkSchema, searchVaultMemories, setLogger, shouldChunkMessage, stampTopicsExtractedAtOp, streamCancelPath, streamReplayPath, updateVaultFolderContextOp, updateVaultFolderOp, updateVaultMemoryEmbeddingOp, updateVaultMemoryOp, upsertMessageOp, useChat, useChatStorage, useCredits, useEncryption, useModels, xhrTransport };

package/dist/expo/index.d.ts

@@ -4248,6 +4248,37 @@ declare function getConversationsByProjectLazyOp(ctx: StorageOperationsContext,
 declare function upsertMessageOp(ctx: StorageOperationsContext, opts: CreateMessageOptions & {
     uniqueId: string;
 }): Promise<StoredMessage>;
+/**
+ * Decrypted, model-native chunk vectors for one message, cached across recall
+ * calls so the chunk lane doesn't re-decrypt + re-JSON.parse every message's
+ * embeddings on every query. Keyed by message id; `version` is the message's
+ * `updated_at` at cache time, so a re-embed (which bumps `updated_at`) misses
+ * and repopulates. Vectors are stored Float32 — model-native precision, half
+ * the RAM of float64 `number[]` — mirroring the vault embedding cache (#705).
+ * Content text is deliberately NOT cached (see searchChunksOp): it isn't
+ * needed for scoring, and keeping decrypted content out of the cache preserves
+ * the SDK's data-at-rest posture.
+ */
+interface CachedChunkVectors {
+    /** Message `updated_at` (ms) at cache time — the invalidation token. */
+    version: number;
+    /**
+     * Per-chunk embedding vectors, index-aligned with the message's decrypted
+     * `chunks` array (empty-vector chunks kept as zero-length placeholders so
+     * indices stay aligned). Empty when the message has only a whole-message
+     * `fallback` vector.
+     */
+    chunks: Float32Array[];
+    /** Whole-message vector when the message was embedded without chunking. */
+    fallback?: Float32Array;
+}
+/**
+ * Cache consumed by {@link searchChunksOp}, keyed by message id. A plain `Map`
+ * (satisfied by the LRU from `createChunkVectorCache`) — mirrors
+ * `VaultEmbeddingCache` so consumers get the same `clear()`/`delete()`
+ * ergonomics on an encryption-key reset.
+ */
+type ChunkVectorCache = Map<string, CachedChunkVectors>;
 
 declare const chatStorageSchema: Readonly<{
     version: _nozbe_watermelondb_Schema.SchemaVersion;
@@ -5047,6 +5078,14 @@ interface RecallOptions {
      * resolves windows in 2026 and never overlaps stored event_time.
      */
     now?: number;
+    /**
+     * Best-effort observability hook. Called once per `recall()` with per-lane
+     * timings, lane counts, and soft-degradation signals — the raw material for
+     * tuning latency/quality and for wiring recall telemetry to PostHog. Invoked
+     * synchronously just before `recall()` returns; a throwing callback is
+     * swallowed (diagnostics must never break retrieval). Off unless provided.
+     */
+    onDiagnostics?: (diagnostics: RecallDiagnostics) => void;
     /** Number of candidates fed to the cross-encoder rerank stage. Default: 30. */
     rerankTopN?: number;
     /** Multiplicative cross-encoder blend weight. Default: 0.1. */
@@ -5077,6 +5116,12 @@ interface RecallContext {
     embeddingOptions: EmbeddingOptions;
     /** Vault embedding LRU cache. */
     vaultCache?: VaultEmbeddingCache;
+    /**
+     * Optional chunk-vector LRU cache. When provided, the chunk lane skips the
+     * per-query decrypt + JSON.parse of every message's chunk vectors on warm
+     * entries. Build via `createChunkVectorCache`. Omit for legacy behavior.
+     */
+    chunkCache?: ChunkVectorCache;
     /**
      * Optional — when provided, recall extracts entities from the query
      * and adds a graph lane to the RRF fusion (memories sharing entities
@@ -5096,6 +5141,48 @@ interface RecallResult {
     /** Diagnostic: total memories in the vault when fact lane was queried. */
     vaultSize?: number;
 }
+/** Soft-degradation signals surfaced via {@link RecallDiagnostics.degraded}. */
+type RecallDegradation = 
+/** Rerank was requested (budget mid/high) but the cross-encoder didn't run
+ *  this call — unavailable (e.g. React Native) or a transient failure. */
+"rerank-unavailable"
+/** `budget: 'high'` requested but no `decomposeOptions`, so query
+ *  decomposition was skipped and the budget downgraded to mid. */
+ | "decompose-unavailable";
+/**
+ * Per-call recall observability payload (see {@link RecallOptions.onDiagnostics}).
+ * All timings are wall-clock milliseconds. Lane counts are post-dedupe,
+ * pre-fusion. Intended to be forwarded to a metrics sink (e.g. PostHog).
+ */
+interface RecallDiagnostics {
+    /** Budget actually executed (may have downgraded from the requested one). */
+    usedBudget: Budget;
+    /** Whether the cross-encoder actually reranked the fact lane this call. */
+    reranked: boolean;
+    /** Total candidates considered before truncation. */
+    candidateCount: number;
+    /** Total vault size when the fact lane ran (absent if it didn't). */
+    vaultSize?: number;
+    /** Facts the fact lane returned (post-dedupe, pre-fusion). */
+    factCount: number;
+    /** Chunks the chunk lane returned (post-dedupe, pre-fusion). */
+    chunkCount: number;
+    /** Wall-clock phase timings (ms). */
+    timings: {
+        /** Whole `recall()` call. */
+        total: number;
+        /** Parallel query-embed + graph/temporal side-lane build. */
+        prep: number;
+        /** Vault fact-lane search (`searchVaultMemoriesWithSize`). */
+        factLane: number;
+        /** Chunk-lane search (`searchChunksOp`). */
+        chunkLane: number;
+        /** Cross-lane RRF fusion + provenance dedup after both lanes. */
+        fuse: number;
+    };
+    /** Soft-degradation signals that fired this call (empty when clean). */
+    degraded: RecallDegradation[];
+}
 type RetainAction = "create" | "merge" | "update" | "skip" | "suppressed";
 type RetainSource = "manual" | "auto-extracted" | "capsule";
 /** Why the consolidator fell back to "create" instead of a real decision. */
@@ -5446,15 +5533,32 @@ declare function extractAndRetain(messages: AutoExtractMessage[], retainCtx: Ret
  * newest (superset) message list re-covers any superseded turn. Turns for
  * different conversations queue independently and never displace each other.
  *
- * Watermark + window: the worker keeps an in-memory, per-conversation
- * watermark of the last message it extracted through. Each run sends every
- * message *after* that watermark (plus a small overlap for coreference,
- * capped at `maxWindowSize`) rather than a fixed trailing slice — so facts
- * stated in turns that arrived during a busy window are still examined instead
- * of scrolling out of a last-N window. The watermark is session-scoped (in
- * memory); it does NOT survive process death, so an extraction killed mid-flight
- * by app backgrounding is not replayed in a later session. Durable cross-process
- * replay would require a persisted watermark (out of scope here).
+ * Watermark + window: the worker keeps a per-conversation watermark of the
+ * last message it extracted through. Each run sends every message *after* that
+ * watermark (plus a small overlap for coreference, capped at `maxWindowSize`)
+ * rather than a fixed trailing slice — so facts stated in turns that arrived
+ * during a busy window are still examined instead of scrolling out of a last-N
+ * window.
+ *
+ * Durability: the in-memory watermark alone does NOT survive process death, so
+ * a session killed after messages accumulate but before extraction would, on
+ * the next launch, fall back to a trailing-window guess and could skip the
+ * un-extracted tail. Pass a {@link ExtractionCursorStore} (`cursorStore`) to
+ * persist the watermark per conversation — it is hydrated synchronously the
+ * first time a conversation is touched, and written through on every *contiguous*
+ * advance (never on a trailing-slice guess, which could jump the durable cursor
+ * past an un-extracted gap), so a later session resumes exactly after the last
+ * extracted message. The primary guarantee is single-session resume across
+ * process death.
+ *
+ * Concurrent sessions sharing one store (web `localStorage`, mobile MMKV) are
+ * best-effort, NOT exclusive: two sessions can each hydrate the same cursor
+ * before either advances it and briefly re-extract the same turn (retain()'s
+ * dedup/consolidation absorbs the duplicate — wasteful, not corrupting). The
+ * durable write is last-writer-wins with a regression guard (it won't move the
+ * cursor backwards when the currently-stored id is ahead within the same turn's
+ * messages), but it does not serialize writers. Omit `cursorStore` for the
+ * legacy in-memory-only behavior.
  *
  * Memory Studio panel subscribes by passing `onMemoryExtracted` and/or
  * `onTurnComplete` callbacks. The Studio uses `onMemoryExtracted` to
@@ -5502,6 +5606,37 @@ interface TurnCompleteEvent {
     outcome: ExtractOutcome;
 }
 /** @public */
+/**
+ * Durable per-conversation extraction cursor. Synchronous by contract (both
+ * SDK platform stores — web `localStorage`, mobile MMKV — are sync), so the
+ * worker can hydrate the watermark inline without changing its fire-and-forget
+ * control flow. Implementations should be best-effort; the worker guards every
+ * call, so a throwing store degrades to in-memory-only rather than breaking
+ * extraction.
+ *
+ * @public
+ */
+interface ExtractionCursorStore {
+    /** Last message id extracted through for `conversationId`, or undefined. */
+    get(conversationId: string): string | undefined;
+    /** Persist the last-extracted message id for `conversationId`. */
+    set(conversationId: string, messageId: string): void;
+}
+/** Minimal synchronous key/value surface — satisfied by the SDK's
+ * `PlatformStorage` (web `localStorage`, mobile MMKV). */
+interface SyncKeyValueStore {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+}
+/**
+ * Build an {@link ExtractionCursorStore} over a synchronous key/value store
+ * (e.g. the SDK's `PlatformStorage`). Keys are namespaced by `keyPrefix`.
+ * Reads/writes are guarded so a store that throws (quota, private mode) can't
+ * break extraction — the watermark just falls back to in-memory.
+ *
+ * @public
+ */
+declare function createPlatformCursorStore(storage: SyncKeyValueStore, keyPrefix?: string): ExtractionCursorStore;
 interface CreateAutoExtractorOptions {
     retainCtx: RetainContext;
     extract: ExtractFactsOptions;
@@ -5532,6 +5667,15 @@ interface CreateAutoExtractorOptions {
      * sessions in RAM-constrained hosts. Default 200.
      */
     maxTrackedConversations?: number;
+    /**
+     * Durable per-conversation watermark store. When provided, the watermark is
+     * hydrated from it the first time each conversation is touched and written
+     * through on every advance, so extraction resumes exactly after the last
+     * extracted message across process restarts (and, with a process-shared
+     * store, across concurrent sessions). Build via {@link createPlatformCursorStore}.
+     * Omit for in-memory-only (legacy) behavior.
+     */
+    cursorStore?: ExtractionCursorStore;
     /**
      * Entity / memory_entity write context — when provided, each retained
      * candidate's `entities[]` is persisted via `linkMemoryEntitiesOp`,
@@ -5607,6 +5751,24 @@ interface AutoExtractor {
  */
 declare function createAutoExtractor(options: CreateAutoExtractorOptions): AutoExtractor;
 
+/**
+ * Default entry cap for the chunk-vector cache. Entries are keyed by message
+ * id, so this bounds how many messages' decrypted chunk vectors stay resident.
+ * Matches the vault cache default (#705).
+ */
+declare const DEFAULT_CHUNK_CACHE_SIZE = 5000;
+/**
+ * Create a {@link ChunkVectorCache} backed by an LRU. Pass the returned cache
+ * into `recall()` (via `RecallContext.chunkCache`) so the chunk lane skips the
+ * per-query decrypt + JSON.parse of every message's chunk vectors on warm
+ * entries. Stale entries self-invalidate on `updated_at` mismatch, so no
+ * explicit invalidation is required beyond clearing it on an encryption-key
+ * reset (wallet switch), mirroring the vault embedding cache.
+ *
+ * @public
+ */
+declare function createChunkVectorCache(maxSize?: number): ChunkVectorCache;
+
 /**
  * Unified Recall API — single retrieval surface above vault + engine.
  *
@@ -5759,6 +5921,46 @@ interface ReflectResult {
  */
 declare function reflect(query: string, ctx: RecallContext, options: ReflectOptions): Promise<ReflectResult>;
 
+/**
+ * Cross-encoder reranker — local inference via @huggingface/transformers.
+ *
+ * Mirrors Hindsight's default reranker (`cross-encoder/ms-marco-MiniLM-L-6-v2`)
+ * for parity with their reference pipeline. Runs fully on-device — no API
+ * key, no network call, works offline. Model file ~25MB; lazy-loaded and
+ * cached for the lifetime of the process.
+ *
+ * Implementation note: transformers.js v3 doesn't expose a "text-ranking"
+ * pipeline, so we drive the cross-encoder directly via the tokenizer +
+ * sequence-classification model. The model outputs a single relevance
+ * logit per (query, doc) pair; we sigmoid it into [0, 1].
+ */
+/**
+ * Thrown when the cross-encoder cannot run because its optional peer
+ * dependency (`@huggingface/transformers`) isn't installed — the expected
+ * state on React Native, where the package isn't part of the bundle. Callers
+ * treat this as "reranker unavailable, degrade to the fused ranking" rather
+ * than a transient error worth warning about on every recall.
+ *
+ * @public
+ */
+declare class RerankerUnavailableError extends Error {
+    /** The underlying import failure, kept for debugging. */
+    readonly reason: unknown;
+    constructor(reason: unknown);
+}
+/**
+ * Whether the cross-encoder reranker can run in this environment.
+ *
+ * - `true` — the model loaded successfully at least once.
+ * - `false` — the optional `@huggingface/transformers` dependency is missing
+ *   (e.g. React Native); reranking is permanently degraded to the fused
+ *   ranking and no further load attempts are made.
+ * - `undefined` — no rerank has been attempted yet, so availability is unknown.
+ *
+ * @public
+ */
+declare function isRerankerAvailable(): boolean | undefined;
+
 /**
  * Standalone topic (entity) extraction for EXISTING memories.
  *
@@ -7133,4 +7335,4 @@ declare function refreshNotionAccessToken(params: NotionRefreshTokenParams): Pro
  */
 declare function createNotionTools(getAccessToken: () => string | null, requestNotionAccess: () => Promise<string>): ToolConfig[];
 
-export { type AutoExtractMessage, type AutoExtractor, type Budget, type CachedServerTools, Conversation as ChatConversation, Message as ChatMessage, type ChatRole, type ChunkingOptions, type ConsolidationFallbackReason, type ConversationMemoryInput, ConversationMemory as ConversationMemoryModel, type ConversationMemoryOperationsContext, type CreateAutoExtractorOptions, type CreateConversationOptions, type CreateMessageOptions, type CreateVaultFolderOptions, type CreateVaultMemoryOptions, type CryptoPriceClassification, type CryptoPricePreProcessorOptions, DEFAULT_CACHE_EXPIRATION_MS, DEFAULT_CHUNK_OVERLAP, DEFAULT_CHUNK_SIZE, DEFAULT_MIN_CHUNK_SIZE, DEFAULT_VAULT_CACHE_SIZE, DatabaseManager, type DatabaseManagerLogger, type DatabaseManagerOptions, type EmbeddedWalletSignerFn, type ExtractFactsOptions, type ExtractOutcome, type ExtractedCandidate, type ExtractedEntity, type FactType, type FileMetadata, type FlushResult, type GetMessagesPageOptions, INFERENCE_ID_HEADER, type LazyStoredConversation, type Logger, LoggerProvider, type LoggerProviderProps, type MemoriesNeedingTopicExtraction, type EmbeddingOptions as MemoryEngineEmbeddingOptions, type MemoryEngineResult, type MemoryEngineSearchOptions, type MemoryExtractedEvent, type MemoryKind, type MemoryVaultSearchOptions, type MemoryVaultToolOptions, type MessageRedactionResult, type MessageSkeleton, NOTION_OAUTH_CONFIG, type NotionAuthUrlParams, type NotionClientRegistration, type NotionExchangeCodeParams, type NotionOAuthEndpoints, type NotionPKCEChallenge, type NotionRefreshTokenParams, type NotionTokenResponse, PII_PATTERNS, type PiiCategory, type PiiMatch, type PiiPattern, PiiRedactor, type PiiRedactorOptions, type PlatformStorage, type PortalLlmAuth, type PromptPreProcessor, type PromptPreProcessorContext, type QuantizedEmbedding, QueueManager, type QueueStatus, RECALL_MAX_LIMIT, RECALL_TOOL_NAME, type RankedMemory, type RecallContext, type RecallOptions, type RecallResult, type RecallToolCallbacks, type RecallToolOptions, type RecencyOptions, type RedactionResult, type ReflectOptions, type ReflectResult, type ResumeStreamOptions, type ResumeStreamResult, type ResumeStreamWithStorageResult, type RetainAction, type RetainContext, type RetainOptions, type RetainResult, type RetainSource, SDK_SCHEMA_VERSION, STREAM_RESUMABLE_HEADER, type ScoreBreakdown, 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, TOPIC_EXTRACTION_BATCH_SIZE, type TextChunk, type TopicExtractOptions, type TopicExtractionInput, type TopicExtractionRunResult, type TurnCompleteEvent, type TurnSkippedEvent, type UpdateVaultFolderOptions, type UpdateVaultMemoryOptions, type UseChatStorageOptions, type UseChatStorageResult, type UseCreditsOptions, type UseCreditsResult, type UseModelsOptions, type UseModelsResult, type VaultEmbeddingCache, type VaultFolderOperationsContext, type VaultMemoryOperationsContext, type VaultSaveOperation, type VaultSearchResult, WalletPoller, type WeatherClassification, type WeatherPreProcessorOptions, type WebSearchClassification, type WebSearchPreProcessorOptions, addConversationMemoriesOp, buildNotionAuthUrl, chatStorageMigrations, chatStorageSchema, chunkAndEmbedAllMessages, chunkAndEmbedMessage, chunkText, classifyCryptoPrice, classifyCryptoPriceBatch, classifyStockPrice, classifyStockPriceBatch, classifyWeather, classifyWeatherBatch, classifyWebSearch, classifyWebSearchBatch, clearAllEncryptionKeys, clearAllEncryptionState, clearConversationMemoriesOp, clearEncryptionKey, clearLazyTitleCache, clearServerToolsCache, consoleLogger, conversationMemoryToStored, cosineInt8, createAutoExtractor, createCryptoPricePreProcessor, createMemoryEngineTool, createMemoryVaultSearchTool, createMemoryVaultTool, createNotionTools, createRecallTool, createStockPricePreProcessor, createStreamingDeAnonymizer, createVaultEmbeddingCache, createVaultFolderOp, createVaultMemoriesBatchOp, createVaultMemoryOp, createWeatherPreProcessor, createWebSearchPreProcessor, decryptConversationTitle, deleteAllVaultMemoriesForUserOp, deleteVaultFolderOp, deleteVaultMemoryOp, dequantizeEmbedding, discoverNotionOAuthEndpoints, eagerEmbedContent, embedAllMessages, embedMessage, ensureDefaultFoldersOp, exchangeNotionCode, extractAndLinkEntitiesForMemoriesOp, extractAndRetain, extractEntitiesForMemories, extractFacts, generateConversationId, generateEmbedding, generateEmbeddings, generateNotionPKCE, getAllVaultFoldersOp, getAllVaultMemoriesOp, getAllVaultMemoryContentsOp, getCachedServerTools, getConversationMemoriesOp, getConversationsByProjectLazyOp, getConversationsLazyOp, getLogger, getMemoriesNeedingTopicExtractionOp, getServerTools, getUnfiledVaultMemoriesOp, getVaultFolderMemoryCountOp, getVaultMemoryOp, hasEncryptionKey, isPiiRedactor, moveMemoriesToFolderOp, noopLogger, onKeyAvailable, preEmbedVaultMemories, quantizeEmbedding, queueManager, recall, reflect, refreshNotionAccessToken, registerNotionClient, requestEncryptionKey, resolvePiiRedactor, resumeStream, retain, sdkMigrations, sdkModelClasses, sdkSchema, searchVaultMemories, setLogger, shouldChunkMessage, stampTopicsExtractedAtOp, streamCancelPath, streamReplayPath, updateVaultFolderContextOp, updateVaultFolderOp, updateVaultMemoryEmbeddingOp, updateVaultMemoryOp, upsertMessageOp, useChat, useChatStorage, useCredits, useEncryption, useModels, xhrTransport };
+export { type AutoExtractMessage, type AutoExtractor, type Budget, 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 CreateMessageOptions, type CreateVaultFolderOptions, type CreateVaultMemoryOptions, type CryptoPriceClassification, type CryptoPricePreProcessorOptions, DEFAULT_CACHE_EXPIRATION_MS, DEFAULT_CHUNK_CACHE_SIZE, DEFAULT_CHUNK_OVERLAP, DEFAULT_CHUNK_SIZE, DEFAULT_MIN_CHUNK_SIZE, DEFAULT_VAULT_CACHE_SIZE, DatabaseManager, type DatabaseManagerLogger, type DatabaseManagerOptions, type EmbeddedWalletSignerFn, type ExtractFactsOptions, type ExtractOutcome, type ExtractedCandidate, type ExtractedEntity, type ExtractionCursorStore, type FactType, type FileMetadata, type FlushResult, type GetMessagesPageOptions, INFERENCE_ID_HEADER, type LazyStoredConversation, type Logger, LoggerProvider, type LoggerProviderProps, type MemoriesNeedingTopicExtraction, type EmbeddingOptions as MemoryEngineEmbeddingOptions, type MemoryEngineResult, type MemoryEngineSearchOptions, type MemoryExtractedEvent, type MemoryKind, type MemoryVaultSearchOptions, type MemoryVaultToolOptions, type MessageRedactionResult, type MessageSkeleton, NOTION_OAUTH_CONFIG, type NotionAuthUrlParams, type NotionClientRegistration, type NotionExchangeCodeParams, type NotionOAuthEndpoints, type NotionPKCEChallenge, type NotionRefreshTokenParams, type NotionTokenResponse, PII_PATTERNS, type PiiCategory, type PiiMatch, type PiiPattern, PiiRedactor, type PiiRedactorOptions, type PlatformStorage, type PortalLlmAuth, type PromptPreProcessor, type PromptPreProcessorContext, type QuantizedEmbedding, QueueManager, type QueueStatus, RECALL_MAX_LIMIT, RECALL_TOOL_NAME, type RankedMemory, type RecallContext, type RecallDegradation, type RecallDiagnostics, type RecallOptions, type RecallResult, type RecallToolCallbacks, type RecallToolOptions, type RecencyOptions, type RedactionResult, type ReflectOptions, type ReflectResult, RerankerUnavailableError, type ResumeStreamOptions, type ResumeStreamResult, type ResumeStreamWithStorageResult, type RetainAction, type RetainContext, type RetainOptions, type RetainResult, type RetainSource, SDK_SCHEMA_VERSION, STREAM_RESUMABLE_HEADER, type ScoreBreakdown, 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, TOPIC_EXTRACTION_BATCH_SIZE, type TextChunk, type TopicExtractOptions, type TopicExtractionInput, type TopicExtractionRunResult, type TurnCompleteEvent, type TurnSkippedEvent, type UpdateVaultFolderOptions, type UpdateVaultMemoryOptions, type UseChatStorageOptions, type UseChatStorageResult, type UseCreditsOptions, type UseCreditsResult, type UseModelsOptions, type UseModelsResult, type VaultEmbeddingCache, type VaultFolderOperationsContext, type VaultMemoryOperationsContext, type VaultSaveOperation, type VaultSearchResult, WalletPoller, type WeatherClassification, type WeatherPreProcessorOptions, type WebSearchClassification, type WebSearchPreProcessorOptions, addConversationMemoriesOp, buildNotionAuthUrl, chatStorageMigrations, chatStorageSchema, chunkAndEmbedAllMessages, chunkAndEmbedMessage, chunkText, classifyCryptoPrice, classifyCryptoPriceBatch, classifyStockPrice, classifyStockPriceBatch, classifyWeather, classifyWeatherBatch, classifyWebSearch, classifyWebSearchBatch, clearAllEncryptionKeys, clearAllEncryptionState, clearConversationMemoriesOp, clearEncryptionKey, clearLazyTitleCache, clearServerToolsCache, consoleLogger, conversationMemoryToStored, cosineInt8, createAutoExtractor, createChunkVectorCache, createCryptoPricePreProcessor, createMemoryEngineTool, createMemoryVaultSearchTool, createMemoryVaultTool, createNotionTools, createPlatformCursorStore, createRecallTool, createStockPricePreProcessor, createStreamingDeAnonymizer, createVaultEmbeddingCache, createVaultFolderOp, createVaultMemoriesBatchOp, createVaultMemoryOp, createWeatherPreProcessor, createWebSearchPreProcessor, decryptConversationTitle, deleteAllVaultMemoriesForUserOp, deleteVaultFolderOp, deleteVaultMemoryOp, dequantizeEmbedding, discoverNotionOAuthEndpoints, eagerEmbedContent, embedAllMessages, embedMessage, ensureDefaultFoldersOp, exchangeNotionCode, extractAndLinkEntitiesForMemoriesOp, extractAndRetain, extractEntitiesForMemories, extractFacts, generateConversationId, generateEmbedding, generateEmbeddings, generateNotionPKCE, getAllVaultFoldersOp, getAllVaultMemoriesOp, getAllVaultMemoryContentsOp, getCachedServerTools, getConversationMemoriesOp, getConversationsByProjectLazyOp, getConversationsLazyOp, getLogger, getMemoriesNeedingTopicExtractionOp, getServerTools, getUnfiledVaultMemoriesOp, getVaultFolderMemoryCountOp, getVaultMemoryOp, hasEncryptionKey, isPiiRedactor, isRerankerAvailable, moveMemoriesToFolderOp, noopLogger, onKeyAvailable, preEmbedVaultMemories, quantizeEmbedding, queueManager, recall, reflect, refreshNotionAccessToken, registerNotionClient, requestEncryptionKey, resolvePiiRedactor, resumeStream, retain, sdkMigrations, sdkModelClasses, sdkSchema, searchVaultMemories, setLogger, shouldChunkMessage, stampTopicsExtractedAtOp, streamCancelPath, streamReplayPath, updateVaultFolderContextOp, updateVaultFolderOp, updateVaultMemoryEmbeddingOp, updateVaultMemoryOp, upsertMessageOp, useChat, useChatStorage, useCredits, useEncryption, useModels, xhrTransport };