@anuma/sdk 7.0.3 → 7.0.4-next.20261015012621

package/dist/react/index.d.mts

@@ -3484,6 +3484,7 @@ interface EntityOperationsContext {
      * (server / SQLite, where the migration backfill is authoritative).
      */
     allowUnscopedRows?: boolean;
+    canWrite?: () => Promise<boolean>;
 }
 /**
  * Link a memory to one or more entities. Accepts bare names (back-compat)
@@ -5021,7 +5022,7 @@ interface RecallOptions {
 }
 /** A fact source supplies bounded candidates; recall owns ranking and result handling. */
 interface RecallFactSource {
-    search: (query: string, options?: MemoryVaultSearchOptions) => ReturnType<typeof searchVaultMemoriesWithSize>;
+    search: (query: string, options?: MemoryVaultSearchOptions, embeddingCache?: Map<string, Float32Array>) => ReturnType<typeof searchVaultMemoriesWithSize>;
     graphRanking: (query: string, traverse: boolean, options: RecallOptions) => Promise<string[]>;
     temporalRanking: (query: string, now?: number) => Promise<string[]>;
 }
@@ -5764,6 +5765,10 @@ type ExtractOutcome = "extracted" | "no-facts" | "empty-after-retry" | "dropped-
  */
 declare function extractAndRetain(messages: AutoExtractMessage[], retainCtx: RetainContext, options: {
     extract: ExtractFactsOptions;
+    /** Route extracted facts through this store instead of the local vault. */
+    memoryStore?: MemoryStore | null;
+    /** Cancel remote writes for this extraction batch. */
+    signal?: AbortSignal;
     minConfidence?: number;
     /** Override scope/folder for all retained facts. */
     scope?: string;
@@ -7142,7 +7147,12 @@ type MemoryRecallOptions = Omit<RecallOptions, "types" | "includeChunks" | "conv
  * and never receives these credentials, callbacks or redactor instances.
  * @public
  */
-type MemoryRetainOptions = Omit<RetainOptions, "folderId">;
+type MemoryRetainOptions = Omit<RetainOptions, "folderId"> & {
+    /** Reject writes when the originating extraction is no longer eligible. */
+    canWrite?: () => Promise<boolean>;
+    /** Abort pending remote requests when the originating extraction is cancelled. */
+    signal?: AbortSignal;
+};
 /**
  * A topic and how many memories link to it.
  * @public
@@ -7271,7 +7281,11 @@ interface MemoryStore {
     /** Replace the memory's topics with a user-chosen set and stop auto-tagging it. */
     setTopics(memoryId: string, topics: readonly EntityInput[]): Promise<StoredVaultMemory | null>;
     /** Add topics alongside the existing ones (auto-tagging stays on). */
-    addTopics(memoryId: string, topics: readonly EntityInput[]): Promise<StoredEntity[]>;
+    addTopics(memoryId: string, topics: readonly EntityInput[], options?: {
+        unlessUserManaged?: boolean;
+        canWrite?: () => Promise<boolean>;
+        signal?: AbortSignal;
+    }): Promise<StoredEntity[]>;
     setVisibility(id: string, visibility: VaultMemoryVisibility, options?: {
         twinOptIn?: boolean;
     }): Promise<StoredVaultMemory | null>;
@@ -8386,8 +8400,8 @@ interface BaseUseChatStorageOptions {
     hooks?: RunHooks | RunHooks[];
     /** WatermelonDB database instance for storing conversations and messages */
     database: Database;
-    /** Route memory reads, writes, recall and the memory tools through this store instead of the database's vault; folders are unsupported. With `piiRedaction` on, build the store with `embeddingOptions.maskInput` (e.g. `(text) => redactor.maskText(text)` with any `PiiRedactor`) or its memory calls throw. */
-    memoryStore?: MemoryStore;
+    /** Route memory operations through this store; `null` disables memory access while `undefined` uses the local vault. Folders are unsupported. With `piiRedaction` on, build the store with `embeddingOptions.maskInput` or its memory calls throw. */
+    memoryStore?: MemoryStore | null;
     /** ID of an existing conversation to load and continue */
     conversationId?: string;
     /** Automatically create a new conversation if none is set (default: true) */
@@ -10602,6 +10616,10 @@ interface SyncKeyValueStore {
 declare function createPlatformCursorStore(storage: SyncKeyValueStore, keyPrefix?: string): ExtractionCursorStore;
 interface CreateAutoExtractorOptions {
     retainCtx: RetainContext;
+    /** Route retained facts and topics through this store; null disables memory writes. */
+    memoryStore?: MemoryStore | null;
+    /** Cancel remote writes for an extraction batch. */
+    signal?: AbortSignal;
     extract: ExtractFactsOptions;
     /** Confidence floor for retained facts. Default 0.7. */
     minConfidence?: number;
@@ -11209,6 +11227,8 @@ interface LocalMemoryStoreOptions {
     walletAddress?: string;
     signMessage?: SignMessageFn;
     embeddedWalletSigner?: EmbeddedWalletSignerFn;
+    /** Rechecked inside each serialized memory write. */
+    canWrite?: () => Promise<boolean>;
     /**
      * Scope every read/write to this user — for a shared, multi-tenant database
      * whose rows all carry their `user_id`. Rows with no `user_id` are invisible
@@ -13898,13 +13918,6 @@ type UseChatResult = BaseUseChatResult & {
  */
 declare function useChat(options?: UseChatOptions): UseChatResult;
 
-/**
- * Namespacing for a caller-shared embedding cache.
- *
- * Lives here, next to the `embeddingCache` send-arg it serves, rather than in either platform hook:
- * react and expo both thread the option through their own send paths, and a copy per platform is how
- * the two drift.
- */
 declare function maskScopedEmbeddingCache(cache: Map<string, Float32Array>, masked: boolean): Map<string, Float32Array>;
 
 /**

package/dist/react/index.d.ts

@@ -3484,6 +3484,7 @@ interface EntityOperationsContext {
      * (server / SQLite, where the migration backfill is authoritative).
      */
     allowUnscopedRows?: boolean;
+    canWrite?: () => Promise<boolean>;
 }
 /**
  * Link a memory to one or more entities. Accepts bare names (back-compat)
@@ -5021,7 +5022,7 @@ interface RecallOptions {
 }
 /** A fact source supplies bounded candidates; recall owns ranking and result handling. */
 interface RecallFactSource {
-    search: (query: string, options?: MemoryVaultSearchOptions) => ReturnType<typeof searchVaultMemoriesWithSize>;
+    search: (query: string, options?: MemoryVaultSearchOptions, embeddingCache?: Map<string, Float32Array>) => ReturnType<typeof searchVaultMemoriesWithSize>;
     graphRanking: (query: string, traverse: boolean, options: RecallOptions) => Promise<string[]>;
     temporalRanking: (query: string, now?: number) => Promise<string[]>;
 }
@@ -5764,6 +5765,10 @@ type ExtractOutcome = "extracted" | "no-facts" | "empty-after-retry" | "dropped-
  */
 declare function extractAndRetain(messages: AutoExtractMessage[], retainCtx: RetainContext, options: {
     extract: ExtractFactsOptions;
+    /** Route extracted facts through this store instead of the local vault. */
+    memoryStore?: MemoryStore | null;
+    /** Cancel remote writes for this extraction batch. */
+    signal?: AbortSignal;
     minConfidence?: number;
     /** Override scope/folder for all retained facts. */
     scope?: string;
@@ -7142,7 +7147,12 @@ type MemoryRecallOptions = Omit<RecallOptions, "types" | "includeChunks" | "conv
  * and never receives these credentials, callbacks or redactor instances.
  * @public
  */
-type MemoryRetainOptions = Omit<RetainOptions, "folderId">;
+type MemoryRetainOptions = Omit<RetainOptions, "folderId"> & {
+    /** Reject writes when the originating extraction is no longer eligible. */
+    canWrite?: () => Promise<boolean>;
+    /** Abort pending remote requests when the originating extraction is cancelled. */
+    signal?: AbortSignal;
+};
 /**
  * A topic and how many memories link to it.
  * @public
@@ -7271,7 +7281,11 @@ interface MemoryStore {
     /** Replace the memory's topics with a user-chosen set and stop auto-tagging it. */
     setTopics(memoryId: string, topics: readonly EntityInput[]): Promise<StoredVaultMemory | null>;
     /** Add topics alongside the existing ones (auto-tagging stays on). */
-    addTopics(memoryId: string, topics: readonly EntityInput[]): Promise<StoredEntity[]>;
+    addTopics(memoryId: string, topics: readonly EntityInput[], options?: {
+        unlessUserManaged?: boolean;
+        canWrite?: () => Promise<boolean>;
+        signal?: AbortSignal;
+    }): Promise<StoredEntity[]>;
     setVisibility(id: string, visibility: VaultMemoryVisibility, options?: {
         twinOptIn?: boolean;
     }): Promise<StoredVaultMemory | null>;
@@ -8386,8 +8400,8 @@ interface BaseUseChatStorageOptions {
     hooks?: RunHooks | RunHooks[];
     /** WatermelonDB database instance for storing conversations and messages */
     database: Database;
-    /** Route memory reads, writes, recall and the memory tools through this store instead of the database's vault; folders are unsupported. With `piiRedaction` on, build the store with `embeddingOptions.maskInput` (e.g. `(text) => redactor.maskText(text)` with any `PiiRedactor`) or its memory calls throw. */
-    memoryStore?: MemoryStore;
+    /** Route memory operations through this store; `null` disables memory access while `undefined` uses the local vault. Folders are unsupported. With `piiRedaction` on, build the store with `embeddingOptions.maskInput` or its memory calls throw. */
+    memoryStore?: MemoryStore | null;
     /** ID of an existing conversation to load and continue */
     conversationId?: string;
     /** Automatically create a new conversation if none is set (default: true) */
@@ -10602,6 +10616,10 @@ interface SyncKeyValueStore {
 declare function createPlatformCursorStore(storage: SyncKeyValueStore, keyPrefix?: string): ExtractionCursorStore;
 interface CreateAutoExtractorOptions {
     retainCtx: RetainContext;
+    /** Route retained facts and topics through this store; null disables memory writes. */
+    memoryStore?: MemoryStore | null;
+    /** Cancel remote writes for an extraction batch. */
+    signal?: AbortSignal;
     extract: ExtractFactsOptions;
     /** Confidence floor for retained facts. Default 0.7. */
     minConfidence?: number;
@@ -11209,6 +11227,8 @@ interface LocalMemoryStoreOptions {
     walletAddress?: string;
     signMessage?: SignMessageFn;
     embeddedWalletSigner?: EmbeddedWalletSignerFn;
+    /** Rechecked inside each serialized memory write. */
+    canWrite?: () => Promise<boolean>;
     /**
      * Scope every read/write to this user — for a shared, multi-tenant database
      * whose rows all carry their `user_id`. Rows with no `user_id` are invisible
@@ -13898,13 +13918,6 @@ type UseChatResult = BaseUseChatResult & {
  */
 declare function useChat(options?: UseChatOptions): UseChatResult;
 
-/**
- * Namespacing for a caller-shared embedding cache.
- *
- * Lives here, next to the `embeddingCache` send-arg it serves, rather than in either platform hook:
- * react and expo both thread the option through their own send paths, and a copy per platform is how
- * the two drift.
- */
 declare function maskScopedEmbeddingCache(cache: Map<string, Float32Array>, masked: boolean): Map<string, Float32Array>;
 
 /**