@anuma/sdk 7.0.3 → 7.0.4-next.20261015012621

package/dist/server/index.d.mts

@@ -2779,6 +2779,7 @@ interface EntityOperationsContext {
      * (server / SQLite, where the migration backfill is authoritative).
      */
     allowUnscopedRows?: boolean;
+    canWrite?: () => Promise<boolean>;
 }
 
 /**
@@ -3756,7 +3757,10 @@ declare function updateConversationProjectOp(ctx: StorageOperationsContext, id:
  * Pass null to get conversations that don't belong to any project.
  */
 declare function getConversationsByProjectOp(ctx: StorageOperationsContext, projectId: string | null): Promise<StoredConversation[]>;
-declare function getMessagesOp(ctx: StorageOperationsContext, convId: string): Promise<StoredMessage[]>;
+declare function getMessagesOp(ctx: StorageOperationsContext, convId: string, opts?: {
+    /** Keeps only rows whose raw, still-encrypted columns pass; runs before decryption. */
+    rawFilter?: (raw: Record<string, unknown>) => boolean;
+}): Promise<StoredMessage[]>;
 /**
  * Clear all messages in a conversation.
  * Clears file_ids before deletion.
@@ -4187,7 +4191,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[]>;
 }
@@ -4930,6 +4934,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;
@@ -6177,7 +6185,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
@@ -6306,7 +6319,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>;
@@ -9076,6 +9093,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;
@@ -9683,6 +9704,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

package/dist/server/index.d.ts

@@ -2779,6 +2779,7 @@ interface EntityOperationsContext {
      * (server / SQLite, where the migration backfill is authoritative).
      */
     allowUnscopedRows?: boolean;
+    canWrite?: () => Promise<boolean>;
 }
 
 /**
@@ -3756,7 +3757,10 @@ declare function updateConversationProjectOp(ctx: StorageOperationsContext, id:
  * Pass null to get conversations that don't belong to any project.
  */
 declare function getConversationsByProjectOp(ctx: StorageOperationsContext, projectId: string | null): Promise<StoredConversation[]>;
-declare function getMessagesOp(ctx: StorageOperationsContext, convId: string): Promise<StoredMessage[]>;
+declare function getMessagesOp(ctx: StorageOperationsContext, convId: string, opts?: {
+    /** Keeps only rows whose raw, still-encrypted columns pass; runs before decryption. */
+    rawFilter?: (raw: Record<string, unknown>) => boolean;
+}): Promise<StoredMessage[]>;
 /**
  * Clear all messages in a conversation.
  * Clears file_ids before deletion.
@@ -4187,7 +4191,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[]>;
 }
@@ -4930,6 +4934,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;
@@ -6177,7 +6185,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
@@ -6306,7 +6319,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>;
@@ -9076,6 +9093,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;
@@ -9683,6 +9704,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