@anuma/sdk 2.3.1 → 2.4.0

package/dist/expo/index.cjs

@@ -6817,6 +6817,7 @@ __export(index_exports, {
   createMemoryVaultSearchTool: () => createMemoryVaultSearchTool,
   createMemoryVaultTool: () => createMemoryVaultTool,
   createNotionTools: () => createNotionTools,
+  createPlatformCursorStore: () => createPlatformCursorStore,
   createRecallTool: () => createRecallTool,
   createStockPricePreProcessor: () => createStockPricePreProcessor,
   createStreamingDeAnonymizer: () => createStreamingDeAnonymizer,
@@ -13245,6 +13246,23 @@ function parseLocalCalendarDay2(year, month, day) {
 // src/lib/memory/autoExtractWorker.ts
 init_logger();
 init_redactor();
+function createPlatformCursorStore(storage, keyPrefix = "anuma:mem:xcursor:") {
+  return {
+    get(conversationId) {
+      try {
+        return storage.getItem(keyPrefix + conversationId) ?? void 0;
+      } catch {
+        return void 0;
+      }
+    },
+    set(conversationId, messageId) {
+      try {
+        storage.setItem(keyPrefix + conversationId, messageId);
+      } catch {
+      }
+    }
+  };
+}
 var DEFAULT_WINDOW_SIZE = 6;
 var DEFAULT_MAX_WINDOW_SIZE = 20;
 var CONTEXT_OVERLAP = 2;
@@ -13264,12 +13282,24 @@ function createAutoExtractor(options) {
   let inflight = 0;
   let disposed = false;
   const conversations = /* @__PURE__ */ new Map();
+  const cursorStore = options.cursorStore;
+  const hydrate = (state, conversationId) => {
+    if (state.hydrated) return;
+    state.hydrated = true;
+    if (!cursorStore || conversationId === void 0 || state.watermark !== void 0) return;
+    try {
+      const persisted = cursorStore.get(conversationId);
+      if (persisted) state.watermark = persisted;
+    } catch {
+    }
+  };
   const stateFor = (conversationId) => {
     let state = conversations.get(conversationId);
     if (!state) {
       if (conversations.size >= maxTrackedConversations) evictOldestIdle(conversationId);
       state = {};
       conversations.set(conversationId, state);
+      hydrate(state, conversationId);
     }
     return state;
   };
@@ -13282,10 +13312,12 @@ function createAutoExtractor(options) {
     }
   };
   function computeWindow(messages, conversationId) {
-    const lastId = conversations.get(conversationId)?.watermark;
+    const lastId = stateFor(conversationId).watermark;
     const idx = lastId === void 0 ? -1 : messages.findIndex((m) => m.id === lastId);
-    if (idx === -1) return messages.slice(-windowSize);
-    if (idx >= messages.length - 1) return [];
+    if (idx === -1) {
+      return { window: messages.slice(-windowSize), contiguous: messages.length <= windowSize };
+    }
+    if (idx >= messages.length - 1) return { window: [], contiguous: true };
     const start = Math.max(0, idx + 1 - CONTEXT_OVERLAP);
     let window2 = messages.slice(start);
     if (window2.length > maxWindowSize) {
@@ -13294,8 +13326,21 @@ function createAutoExtractor(options) {
       );
       window2 = window2.slice(0, maxWindowSize);
     }
-    return window2;
+    return { window: window2, contiguous: true };
   }
+  const persistCursor = (conversationId, messages, advancedToId, contiguous) => {
+    if (!cursorStore || conversationId === void 0 || !contiguous) return;
+    try {
+      const stored = cursorStore.get(conversationId);
+      if (stored && stored !== advancedToId) {
+        const storedIdx = messages.findIndex((m) => m.id === stored);
+        const newIdx = messages.findIndex((m) => m.id === advancedToId);
+        if (storedIdx !== -1 && newIdx !== -1 && storedIdx >= newIdx) return;
+      }
+      cursorStore.set(conversationId, advancedToId);
+    } catch {
+    }
+  };
   const consolidateBaseUrl = options.consolidate?.baseUrl ?? options.extract.baseUrl;
   const consolidateOptions = options.consolidate ? {
     ...options.extract.apiKey !== void 0 && { apiKey: options.extract.apiKey },
@@ -13341,7 +13386,7 @@ function createAutoExtractor(options) {
     return dispatch(messages, conversationId);
   }
   function dispatch(messages, conversationId) {
-    const window2 = computeWindow(messages, conversationId);
+    const { window: window2, contiguous } = computeWindow(messages, conversationId);
     if (window2.length === 0) {
       options.onSkipped?.({ reason: "no-new-content", conversationId });
       drainPending();
@@ -13366,7 +13411,9 @@ function createAutoExtractor(options) {
             }
           }
         );
-        stateFor(conversationId).watermark = window2[window2.length - 1].id;
+        const advancedTo = window2[window2.length - 1].id;
+        stateFor(conversationId).watermark = advancedTo;
+        persistCursor(conversationId, messages, advancedTo, contiguous);
         for (let i = 0; i < results.length; i++) {
           if (results[i].action === "suppressed") continue;
           options.onMemoryExtracted?.({
@@ -18493,6 +18540,7 @@ function createNotionTools(getAccessToken, requestNotionAccess) {
   createMemoryVaultSearchTool,
   createMemoryVaultTool,
   createNotionTools,
+  createPlatformCursorStore,
   createRecallTool,
   createStockPricePreProcessor,
   createStreamingDeAnonymizer,

package/dist/expo/index.d.mts

@@ -5446,15 +5446,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 +5519,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 +5580,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`,
@@ -7133,4 +7190,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 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 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 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, 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, 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

@@ -5446,15 +5446,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 +5519,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 +5580,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`,
@@ -7133,4 +7190,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 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 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 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, 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, 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.mjs

@@ -6384,6 +6384,23 @@ function parseLocalCalendarDay(year, month, day) {
 }
 
 // src/lib/memory/autoExtractWorker.ts
+function createPlatformCursorStore(storage, keyPrefix = "anuma:mem:xcursor:") {
+  return {
+    get(conversationId) {
+      try {
+        return storage.getItem(keyPrefix + conversationId) ?? void 0;
+      } catch {
+        return void 0;
+      }
+    },
+    set(conversationId, messageId) {
+      try {
+        storage.setItem(keyPrefix + conversationId, messageId);
+      } catch {
+      }
+    }
+  };
+}
 var DEFAULT_WINDOW_SIZE = 6;
 var DEFAULT_MAX_WINDOW_SIZE = 20;
 var CONTEXT_OVERLAP = 2;
@@ -6403,12 +6420,24 @@ function createAutoExtractor(options) {
   let inflight = 0;
   let disposed = false;
   const conversations = /* @__PURE__ */ new Map();
+  const cursorStore = options.cursorStore;
+  const hydrate = (state, conversationId) => {
+    if (state.hydrated) return;
+    state.hydrated = true;
+    if (!cursorStore || conversationId === void 0 || state.watermark !== void 0) return;
+    try {
+      const persisted = cursorStore.get(conversationId);
+      if (persisted) state.watermark = persisted;
+    } catch {
+    }
+  };
   const stateFor = (conversationId) => {
     let state = conversations.get(conversationId);
     if (!state) {
       if (conversations.size >= maxTrackedConversations) evictOldestIdle(conversationId);
       state = {};
       conversations.set(conversationId, state);
+      hydrate(state, conversationId);
     }
     return state;
   };
@@ -6421,10 +6450,12 @@ function createAutoExtractor(options) {
     }
   };
   function computeWindow(messages, conversationId) {
-    const lastId = conversations.get(conversationId)?.watermark;
+    const lastId = stateFor(conversationId).watermark;
     const idx = lastId === void 0 ? -1 : messages.findIndex((m) => m.id === lastId);
-    if (idx === -1) return messages.slice(-windowSize);
-    if (idx >= messages.length - 1) return [];
+    if (idx === -1) {
+      return { window: messages.slice(-windowSize), contiguous: messages.length <= windowSize };
+    }
+    if (idx >= messages.length - 1) return { window: [], contiguous: true };
     const start = Math.max(0, idx + 1 - CONTEXT_OVERLAP);
     let window = messages.slice(start);
     if (window.length > maxWindowSize) {
@@ -6433,8 +6464,21 @@ function createAutoExtractor(options) {
       );
       window = window.slice(0, maxWindowSize);
     }
-    return window;
+    return { window, contiguous: true };
   }
+  const persistCursor = (conversationId, messages, advancedToId, contiguous) => {
+    if (!cursorStore || conversationId === void 0 || !contiguous) return;
+    try {
+      const stored = cursorStore.get(conversationId);
+      if (stored && stored !== advancedToId) {
+        const storedIdx = messages.findIndex((m) => m.id === stored);
+        const newIdx = messages.findIndex((m) => m.id === advancedToId);
+        if (storedIdx !== -1 && newIdx !== -1 && storedIdx >= newIdx) return;
+      }
+      cursorStore.set(conversationId, advancedToId);
+    } catch {
+    }
+  };
   const consolidateBaseUrl = options.consolidate?.baseUrl ?? options.extract.baseUrl;
   const consolidateOptions = options.consolidate ? {
     ...options.extract.apiKey !== void 0 && { apiKey: options.extract.apiKey },
@@ -6480,7 +6524,7 @@ function createAutoExtractor(options) {
     return dispatch(messages, conversationId);
   }
   function dispatch(messages, conversationId) {
-    const window = computeWindow(messages, conversationId);
+    const { window, contiguous } = computeWindow(messages, conversationId);
     if (window.length === 0) {
       options.onSkipped?.({ reason: "no-new-content", conversationId });
       drainPending();
@@ -6505,7 +6549,9 @@ function createAutoExtractor(options) {
             }
           }
         );
-        stateFor(conversationId).watermark = window[window.length - 1].id;
+        const advancedTo = window[window.length - 1].id;
+        stateFor(conversationId).watermark = advancedTo;
+        persistCursor(conversationId, messages, advancedTo, contiguous);
         for (let i = 0; i < results.length; i++) {
           if (results[i].action === "suppressed") continue;
           options.onMemoryExtracted?.({
@@ -11591,6 +11637,7 @@ export {
   createMemoryVaultSearchTool,
   createMemoryVaultTool,
   createNotionTools,
+  createPlatformCursorStore,
   createRecallTool,
   createStockPricePreProcessor,
   createStreamingDeAnonymizer,

package/dist/react/index.cjs

@@ -7214,6 +7214,7 @@ __export(index_exports, {
   createMemoryEngineTool: () => createMemoryEngineTool,
   createMemoryVaultSearchTool: () => createMemoryVaultSearchTool,
   createMemoryVaultTool: () => createMemoryVaultTool,
+  createPlatformCursorStore: () => createPlatformCursorStore,
   createProjectOp: () => createProjectOp,
   createRecallTool: () => createRecallTool,
   createSavedToolOp: () => createSavedToolOp,
@@ -14596,6 +14597,23 @@ function parseLocalCalendarDay2(year, month, day) {
 // src/lib/memory/autoExtractWorker.ts
 init_logger();
 init_redactor();
+function createPlatformCursorStore(storage, keyPrefix = "anuma:mem:xcursor:") {
+  return {
+    get(conversationId) {
+      try {
+        return storage.getItem(keyPrefix + conversationId) ?? void 0;
+      } catch {
+        return void 0;
+      }
+    },
+    set(conversationId, messageId) {
+      try {
+        storage.setItem(keyPrefix + conversationId, messageId);
+      } catch {
+      }
+    }
+  };
+}
 var DEFAULT_WINDOW_SIZE = 6;
 var DEFAULT_MAX_WINDOW_SIZE = 20;
 var CONTEXT_OVERLAP = 2;
@@ -14615,12 +14633,24 @@ function createAutoExtractor(options) {
   let inflight = 0;
   let disposed = false;
   const conversations = /* @__PURE__ */ new Map();
+  const cursorStore = options.cursorStore;
+  const hydrate = (state, conversationId) => {
+    if (state.hydrated) return;
+    state.hydrated = true;
+    if (!cursorStore || conversationId === void 0 || state.watermark !== void 0) return;
+    try {
+      const persisted = cursorStore.get(conversationId);
+      if (persisted) state.watermark = persisted;
+    } catch {
+    }
+  };
   const stateFor = (conversationId) => {
     let state = conversations.get(conversationId);
     if (!state) {
       if (conversations.size >= maxTrackedConversations) evictOldestIdle(conversationId);
       state = {};
       conversations.set(conversationId, state);
+      hydrate(state, conversationId);
     }
     return state;
   };
@@ -14633,10 +14663,12 @@ function createAutoExtractor(options) {
     }
   };
   function computeWindow(messages, conversationId) {
-    const lastId = conversations.get(conversationId)?.watermark;
+    const lastId = stateFor(conversationId).watermark;
     const idx = lastId === void 0 ? -1 : messages.findIndex((m) => m.id === lastId);
-    if (idx === -1) return messages.slice(-windowSize);
-    if (idx >= messages.length - 1) return [];
+    if (idx === -1) {
+      return { window: messages.slice(-windowSize), contiguous: messages.length <= windowSize };
+    }
+    if (idx >= messages.length - 1) return { window: [], contiguous: true };
     const start = Math.max(0, idx + 1 - CONTEXT_OVERLAP);
     let window2 = messages.slice(start);
     if (window2.length > maxWindowSize) {
@@ -14645,8 +14677,21 @@ function createAutoExtractor(options) {
       );
       window2 = window2.slice(0, maxWindowSize);
     }
-    return window2;
+    return { window: window2, contiguous: true };
   }
+  const persistCursor = (conversationId, messages, advancedToId, contiguous) => {
+    if (!cursorStore || conversationId === void 0 || !contiguous) return;
+    try {
+      const stored = cursorStore.get(conversationId);
+      if (stored && stored !== advancedToId) {
+        const storedIdx = messages.findIndex((m) => m.id === stored);
+        const newIdx = messages.findIndex((m) => m.id === advancedToId);
+        if (storedIdx !== -1 && newIdx !== -1 && storedIdx >= newIdx) return;
+      }
+      cursorStore.set(conversationId, advancedToId);
+    } catch {
+    }
+  };
   const consolidateBaseUrl = options.consolidate?.baseUrl ?? options.extract.baseUrl;
   const consolidateOptions = options.consolidate ? {
     ...options.extract.apiKey !== void 0 && { apiKey: options.extract.apiKey },
@@ -14692,7 +14737,7 @@ function createAutoExtractor(options) {
     return dispatch(messages, conversationId);
   }
   function dispatch(messages, conversationId) {
-    const window2 = computeWindow(messages, conversationId);
+    const { window: window2, contiguous } = computeWindow(messages, conversationId);
     if (window2.length === 0) {
       options.onSkipped?.({ reason: "no-new-content", conversationId });
       drainPending();
@@ -14717,7 +14762,9 @@ function createAutoExtractor(options) {
             }
           }
         );
-        stateFor(conversationId).watermark = window2[window2.length - 1].id;
+        const advancedTo = window2[window2.length - 1].id;
+        stateFor(conversationId).watermark = advancedTo;
+        persistCursor(conversationId, messages, advancedTo, contiguous);
         for (let i = 0; i < results.length; i++) {
           if (results[i].action === "suppressed") continue;
           options.onMemoryExtracted?.({
@@ -30023,6 +30070,7 @@ function renderAnumaJsx(jsx3) {
   createMemoryEngineTool,
   createMemoryVaultSearchTool,
   createMemoryVaultTool,
+  createPlatformCursorStore,
   createProjectOp,
   createRecallTool,
   createSavedToolOp,