@anuma/sdk 7.0.6 → 7.1.0

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)
@@ -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
@@ -11458,6 +11478,8 @@ interface MemoryMigrationOptions extends Pick<RemoteMemoryPersistenceOptions, "b
     fallbacks?: readonly MemoryKeyRing[];
     /** Activate even when some rows could not be migrated. Default false. */
     allowSkipped?: boolean;
+    /** Re-embeds rows whose local vector nearby could not rank; without it those rows upload unembedded. */
+    embeddingOptions?: EmbeddingOptions;
     signal?: AbortSignal;
     onProgress?: (progress: MemoryMigrationProgress) => void;
 }
@@ -11484,6 +11506,14 @@ interface MemoryMigrationResult {
     total: number;
     imported: number;
     skipped: MemoryMigrationSkip[];
+    /** Rows uploaded with a vector embedded during migration. */
+    reembedded: number;
+    /** Rows uploaded without a vector nearby can rank. */
+    unembedded: number;
+    /** Deleted rows no supplied key decrypts, uploaded with placeholder content. */
+    placeholderTombstones: number;
+    /** Rows whose oldest source ids were dropped to fit nearby's limit. */
+    truncatedSourceChunkIds: number;
 }
 /**
  * Upload this device's local memories to nearby and, once nearby holds every one, make it authoritative.

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)
@@ -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
@@ -11458,6 +11478,8 @@ interface MemoryMigrationOptions extends Pick<RemoteMemoryPersistenceOptions, "b
     fallbacks?: readonly MemoryKeyRing[];
     /** Activate even when some rows could not be migrated. Default false. */
     allowSkipped?: boolean;
+    /** Re-embeds rows whose local vector nearby could not rank; without it those rows upload unembedded. */
+    embeddingOptions?: EmbeddingOptions;
     signal?: AbortSignal;
     onProgress?: (progress: MemoryMigrationProgress) => void;
 }
@@ -11484,6 +11506,14 @@ interface MemoryMigrationResult {
     total: number;
     imported: number;
     skipped: MemoryMigrationSkip[];
+    /** Rows uploaded with a vector embedded during migration. */
+    reembedded: number;
+    /** Rows uploaded without a vector nearby can rank. */
+    unembedded: number;
+    /** Deleted rows no supplied key decrypts, uploaded with placeholder content. */
+    placeholderTombstones: number;
+    /** Rows whose oldest source ids were dropped to fit nearby's limit. */
+    truncatedSourceChunkIds: number;
 }
 /**
  * Upload this device's local memories to nearby and, once nearby holds every one, make it authoritative.