@anuma/sdk 1.1.0 → 1.1.1

package/dist/expo/{chunk-PUKP5H4F.mjs → chunk-3HZFU3PV.mjs}

@@ -1797,6 +1797,7 @@ function vaultMemoryToStoredRaw(memory) {
     eventTimeStart: memory.eventTimeStart ?? null,
     eventTimeEnd: memory.eventTimeEnd ?? null,
     eventTimeKind: memory.eventTimeKind ?? null,
+    topicsUserManaged: memory.topicsUserManaged ?? false,
     createdAt: memory.createdAt,
     updatedAt: memory.updatedAt,
     isDeleted: memory.isDeleted
@@ -1978,9 +1979,10 @@ function vaultMemoryRawToStoredRaw(raw) {
     eventTimeStart: raw.event_time_start ?? null,
     eventTimeEnd: raw.event_time_end ?? null,
     eventTimeKind: raw.event_time_kind ?? null,
+    // SQLite stores booleans as 0/1, LokiJS as true/false — coerce both.
+    topicsUserManaged: raw.topics_user_managed === true || raw.topics_user_managed === 1,
     createdAt: new Date(raw.created_at),
     updatedAt: new Date(raw.updated_at),
-    // SQLite stores booleans as 0/1, LokiJS as true/false — coerce both.
     isDeleted: raw.is_deleted === true || raw.is_deleted === 1
   };
 }
@@ -2064,6 +2066,9 @@ async function updateVaultMemoryOp(ctx, id, opts) {
           r._setRaw("event_time_end", opts.eventTime.end ?? null);
           r._setRaw("event_time_kind", opts.eventTime.kind ?? null);
         }
+        if (opts.topicsUserManaged !== void 0) {
+          r._setRaw("topics_user_managed", opts.topicsUserManaged);
+        }
         if (opts.preserveUpdatedAt) {
           r._setRaw("updated_at", originalUpdatedAt);
         }
@@ -4658,7 +4663,7 @@ function createMemoryVaultSearchTool(vaultCtx, embeddingOptions, cache, searchOp
             legacy.map((r) => ({ id: r.uniqueId, content: r.content, score: r.similarity }))
           );
         }
-        const { recall: recall2 } = await import("./recall-YRWAAU6K.mjs");
+        const { recall: recall2 } = await import("./recall-MCB3TVBW.mjs");
         const result = await recall2(
           query,
           { vaultCtx, embeddingOptions, vaultCache: cache },

package/dist/expo/index.cjs

@@ -4033,6 +4033,7 @@ function vaultMemoryToStoredRaw(memory) {
     eventTimeStart: memory.eventTimeStart ?? null,
     eventTimeEnd: memory.eventTimeEnd ?? null,
     eventTimeKind: memory.eventTimeKind ?? null,
+    topicsUserManaged: memory.topicsUserManaged ?? false,
     createdAt: memory.createdAt,
     updatedAt: memory.updatedAt,
     isDeleted: memory.isDeleted
@@ -4214,9 +4215,10 @@ function vaultMemoryRawToStoredRaw(raw) {
     eventTimeStart: raw.event_time_start ?? null,
     eventTimeEnd: raw.event_time_end ?? null,
     eventTimeKind: raw.event_time_kind ?? null,
+    // SQLite stores booleans as 0/1, LokiJS as true/false — coerce both.
+    topicsUserManaged: raw.topics_user_managed === true || raw.topics_user_managed === 1,
     createdAt: new Date(raw.created_at),
     updatedAt: new Date(raw.updated_at),
-    // SQLite stores booleans as 0/1, LokiJS as true/false — coerce both.
     isDeleted: raw.is_deleted === true || raw.is_deleted === 1
   };
 }
@@ -4300,6 +4302,9 @@ async function updateVaultMemoryOp(ctx, id, opts) {
           r._setRaw("event_time_end", opts.eventTime.end ?? null);
           r._setRaw("event_time_kind", opts.eventTime.kind ?? null);
         }
+        if (opts.topicsUserManaged !== void 0) {
+          r._setRaw("topics_user_managed", opts.topicsUserManaged);
+        }
         if (opts.preserveUpdatedAt) {
           r._setRaw("updated_at", originalUpdatedAt);
         }
@@ -10904,6 +10909,13 @@ function assembleMessagesWithHistory(historyMessages, callerMessages, summarySys
   ];
 }
 
+// src/lib/chat/imageParts.ts
+function isSendableImageURL(url) {
+  if (!url) return false;
+  const lower = url.toLowerCase();
+  return lower.startsWith("http://") || lower.startsWith("https://") || lower.startsWith("data:image/");
+}
+
 // src/lib/chat/sources.ts
 function extractSourcesFromToolCallEvents(toolCallEvents) {
   try {
@@ -12135,6 +12147,9 @@ __decorateClass([
 __decorateClass([
   (0, import_decorators3.field)("event_time_kind")
 ], VaultMemory.prototype, "eventTimeKind", 2);
+__decorateClass([
+  (0, import_decorators3.field)("topics_user_managed")
+], VaultMemory.prototype, "topicsUserManaged", 2);
 __decorateClass([
   import_decorators3.readonly,
   (0, import_decorators3.date)("created_at")
@@ -12493,6 +12508,7 @@ var WalletPoller = class {
 init_logger();
 
 // src/lib/memory/autoExtract.ts
+var import_watermelondb10 = require("@nozbe/watermelondb");
 init_operations2();
 init_types3();
 init_logger();
@@ -12550,12 +12566,15 @@ async function retain(content, ctx, options = {}) {
           preserveUpdatedAt: true,
           ...eventTimeUpdate && { eventTime: eventTimeUpdate }
         });
-        return {
-          action: "merge",
-          memoryId: targetId,
-          targetId,
-          proofCount: updated?.proofCount ?? (existing.proofCount ?? 1) + 1
-        };
+        if (updated) {
+          return {
+            action: "merge",
+            memoryId: targetId,
+            targetId,
+            proofCount: updated.proofCount ?? (existing.proofCount ?? 1) + 1
+          };
+        }
+        await assertMergeTargetGoneOrThrow(ctx, targetId);
       }
     }
   }
@@ -12638,11 +12657,15 @@ async function tryConsolidate(trimmed, ctx, options) {
       preserveUpdatedAt: true,
       ...eventTimeUpdate && { eventTime: eventTimeUpdate }
     });
+    if (!updated) {
+      await assertMergeTargetGoneOrThrow(ctx, decision.targetId);
+      return null;
+    }
     return {
       action: "merge",
       memoryId: decision.targetId,
       targetId: decision.targetId,
-      proofCount: updated?.proofCount ?? (existing.proofCount ?? 1) + 1
+      proofCount: updated.proofCount ?? (existing.proofCount ?? 1) + 1
     };
   }
   if (decision.action === "update" && decision.targetId && decision.content) {
@@ -12669,17 +12692,35 @@ async function tryConsolidate(trimmed, ctx, options) {
       preserveUpdatedAt: true,
       ...eventTimeUpdate && { eventTime: eventTimeUpdate }
     });
+    if (!updated) {
+      await assertMergeTargetGoneOrThrow(ctx, decision.targetId);
+      return null;
+    }
     return {
       action: "update",
       memoryId: decision.targetId,
       targetId: decision.targetId,
-      proofCount: updated?.proofCount ?? (existing.proofCount ?? 1) + 1
+      proofCount: updated.proofCount ?? (existing.proofCount ?? 1) + 1
     };
   }
   return null;
 }
+async function assertMergeTargetGoneOrThrow(ctx, targetId) {
+  const stillExists = await getVaultMemoryOp(ctx.vaultCtx, targetId);
+  if (stillExists) {
+    throw new Error(`retain: merge into memory ${targetId} failed to persist`);
+  }
+}
 
 // src/lib/memory/autoExtract.ts
+async function isMemoryTopicsUserManaged(ctx, memoryId) {
+  try {
+    const rows = await ctx.database.get(VaultMemory.table).query(import_watermelondb10.Q.where("id", memoryId)).fetch();
+    return rows[0]?.topicsUserManaged === true;
+  } catch {
+    return true;
+  }
+}
 var DEFAULT_MODEL3 = "gpt-oss/gpt-oss-120b";
 var DEFAULT_MIN_CONFIDENCE = 0.7;
 var MAX_CONTENT_LENGTH = 200;
@@ -12838,7 +12879,9 @@ async function extractAndRetain(messages, retainCtx, options) {
       results.push(result);
       if (options.entityCtx && candidate.entities.length > 0) {
         try {
-          await linkMemoryEntitiesOp(options.entityCtx, result.memoryId, candidate.entities);
+          if (!await isMemoryTopicsUserManaged(options.entityCtx, result.memoryId)) {
+            await linkMemoryEntitiesOp(options.entityCtx, result.memoryId, candidate.entities);
+          }
         } catch (err) {
           log.warn("[memory/extract] linkMemoryEntitiesOp failed", err);
         }
@@ -14266,7 +14309,7 @@ function storedToLlmapiMessage(stored) {
   const content = [{ type: "text", text: stored.content }];
   if (stored.role !== "assistant" && stored.files?.length) {
     for (const file of stored.files) {
-      if (file.url) {
+      if (isSendableImageURL(file.url)) {
         content.push({
           type: "image_url",
           image_url: { url: file.url }
@@ -15690,13 +15733,13 @@ init_redactor();
 init_useEncryption();
 
 // src/lib/db/schema.ts
-var import_watermelondb17 = require("@nozbe/watermelondb");
+var import_watermelondb18 = require("@nozbe/watermelondb");
 var import_migrations2 = require("@nozbe/watermelondb/Schema/migrations");
 
 // src/lib/db/appFiles/models.ts
-var import_watermelondb10 = require("@nozbe/watermelondb");
+var import_watermelondb11 = require("@nozbe/watermelondb");
 var import_decorators4 = require("@nozbe/watermelondb/decorators");
-var AppFile = class extends import_watermelondb10.Model {
+var AppFile = class extends import_watermelondb11.Model {
 };
 AppFile.table = "app_files";
 AppFile.associations = {};
@@ -15718,9 +15761,9 @@ __decorateClass([
 ], AppFile.prototype, "updatedAt", 2);
 
 // src/lib/db/entities/models.ts
-var import_watermelondb11 = require("@nozbe/watermelondb");
+var import_watermelondb12 = require("@nozbe/watermelondb");
 var import_decorators5 = require("@nozbe/watermelondb/decorators");
-var Entity = class extends import_watermelondb11.Model {
+var Entity = class extends import_watermelondb12.Model {
 };
 Entity.table = "entity";
 __decorateClass([
@@ -15736,7 +15779,7 @@ __decorateClass([
 __decorateClass([
   (0, import_decorators5.date)("updated_at")
 ], Entity.prototype, "updatedAt", 2);
-var MemoryEntity = class extends import_watermelondb11.Model {
+var MemoryEntity = class extends import_watermelondb12.Model {
 };
 MemoryEntity.table = "memory_entity";
 __decorateClass([
@@ -15754,9 +15797,9 @@ __decorateClass([
 ], MemoryEntity.prototype, "createdAt", 2);
 
 // src/lib/db/project/models.ts
-var import_watermelondb12 = require("@nozbe/watermelondb");
+var import_watermelondb13 = require("@nozbe/watermelondb");
 var import_decorators6 = require("@nozbe/watermelondb/decorators");
-var Project = class extends import_watermelondb12.Model {
+var Project = class extends import_watermelondb13.Model {
 };
 Project.table = "projects";
 Project.associations = {
@@ -15779,10 +15822,10 @@ __decorateClass([
 ], Project.prototype, "isDeleted", 2);
 
 // src/lib/db/savedTools/models.ts
-var import_watermelondb13 = require("@nozbe/watermelondb");
+var import_watermelondb14 = require("@nozbe/watermelondb");
 var import_decorators7 = require("@nozbe/watermelondb/decorators");
 var sanitizeParameters = (raw) => raw ?? {};
-var SavedTool = class extends import_watermelondb13.Model {
+var SavedTool = class extends import_watermelondb14.Model {
 };
 SavedTool.table = "saved_tools";
 SavedTool.associations = {};
@@ -15816,9 +15859,9 @@ __decorateClass([
 ], SavedTool.prototype, "isDeleted", 2);
 
 // src/lib/db/settings/models.ts
-var import_watermelondb14 = require("@nozbe/watermelondb");
+var import_watermelondb15 = require("@nozbe/watermelondb");
 var import_decorators8 = require("@nozbe/watermelondb/decorators");
-var ModelPreference = class extends import_watermelondb14.Model {
+var ModelPreference = class extends import_watermelondb15.Model {
 };
 ModelPreference.table = "modelPreferences";
 __decorateClass([
@@ -15829,9 +15872,9 @@ __decorateClass([
 ], ModelPreference.prototype, "models", 2);
 
 // src/lib/db/userPreferences/models.ts
-var import_watermelondb15 = require("@nozbe/watermelondb");
+var import_watermelondb16 = require("@nozbe/watermelondb");
 var import_decorators9 = require("@nozbe/watermelondb/decorators");
-var UserPreference = class extends import_watermelondb15.Model {
+var UserPreference = class extends import_watermelondb16.Model {
 };
 UserPreference.table = "userPreferences";
 __decorateClass([
@@ -15860,9 +15903,9 @@ __decorateClass([
 ], UserPreference.prototype, "updatedAt", 2);
 
 // src/lib/db/vaultFolders/models.ts
-var import_watermelondb16 = require("@nozbe/watermelondb");
+var import_watermelondb17 = require("@nozbe/watermelondb");
 var import_decorators10 = require("@nozbe/watermelondb/decorators");
-var VaultFolder = class extends import_watermelondb16.Model {
+var VaultFolder = class extends import_watermelondb17.Model {
 };
 VaultFolder.table = "vault_folders";
 __decorateClass([
@@ -15889,12 +15932,12 @@ __decorateClass([
 ], VaultFolder.prototype, "context", 2);
 
 // src/lib/db/schema.ts
-var SDK_SCHEMA_VERSION = 33;
-var sdkSchema = (0, import_watermelondb17.appSchema)({
+var SDK_SCHEMA_VERSION = 34;
+var sdkSchema = (0, import_watermelondb18.appSchema)({
   version: SDK_SCHEMA_VERSION,
   tables: [
     // Chat storage tables
-    (0, import_watermelondb17.tableSchema)({
+    (0, import_watermelondb18.tableSchema)({
       name: "history",
       columns: [
         { name: "message_id", type: "number" },
@@ -15931,7 +15974,7 @@ var sdkSchema = (0, import_watermelondb17.appSchema)({
         // JSON stringified LlmapiToolCallEvent[]
       ]
     }),
-    (0, import_watermelondb17.tableSchema)({
+    (0, import_watermelondb18.tableSchema)({
       name: "conversations",
       columns: [
         { name: "conversation_id", type: "string", isIndexed: true },
@@ -15944,7 +15987,7 @@ var sdkSchema = (0, import_watermelondb17.appSchema)({
       ]
     }),
     // Project storage table
-    (0, import_watermelondb17.tableSchema)({
+    (0, import_watermelondb18.tableSchema)({
       name: "projects",
       columns: [
         { name: "project_id", type: "string", isIndexed: true },
@@ -15955,7 +15998,7 @@ var sdkSchema = (0, import_watermelondb17.appSchema)({
       ]
     }),
     // Settings storage tables (deprecated - use userPreferences)
-    (0, import_watermelondb17.tableSchema)({
+    (0, import_watermelondb18.tableSchema)({
       name: "modelPreferences",
       columns: [
         { name: "wallet_address", type: "string", isIndexed: true },
@@ -15963,7 +16006,7 @@ var sdkSchema = (0, import_watermelondb17.appSchema)({
       ]
     }),
     // Unified user preferences storage
-    (0, import_watermelondb17.tableSchema)({
+    (0, import_watermelondb18.tableSchema)({
       name: "userPreferences",
       columns: [
         // Identity
@@ -15982,7 +16025,7 @@ var sdkSchema = (0, import_watermelondb17.appSchema)({
       ]
     }),
     // Memory vault storage
-    (0, import_watermelondb17.tableSchema)({
+    (0, import_watermelondb18.tableSchema)({
       name: "memory_vault",
       columns: [
         { name: "content", type: "string" },
@@ -16006,11 +16049,15 @@ var sdkSchema = (0, import_watermelondb17.appSchema)({
         // (start set, end null + kind='ongoing'), or none (both null).
         { name: "event_time_start", type: "number", isOptional: true, isIndexed: true },
         { name: "event_time_end", type: "number", isOptional: true },
-        { name: "event_time_kind", type: "string", isOptional: true }
+        { name: "event_time_kind", type: "string", isOptional: true },
+        // When true, the user has manually set this memory's topics (entity
+        // links). Auto-extraction then leaves its links alone — the user owns
+        // them. Null/false = topics are auto-derived (default).
+        { name: "topics_user_managed", type: "boolean", isOptional: true }
       ]
     }),
     // Entity table — canonical names extracted from auto-extraction (W5).
-    (0, import_watermelondb17.tableSchema)({
+    (0, import_watermelondb18.tableSchema)({
       name: "entity",
       columns: [
         { name: "canonical_name", type: "string", isIndexed: true },
@@ -16020,7 +16067,7 @@ var sdkSchema = (0, import_watermelondb17.appSchema)({
       ]
     }),
     // Many-to-many join: which memories reference which entities.
-    (0, import_watermelondb17.tableSchema)({
+    (0, import_watermelondb18.tableSchema)({
       name: "memory_entity",
       columns: [
         { name: "memory_id", type: "string", isIndexed: true },
@@ -16030,7 +16077,7 @@ var sdkSchema = (0, import_watermelondb17.appSchema)({
       ]
     }),
     // Vault folder organization
-    (0, import_watermelondb17.tableSchema)({
+    (0, import_watermelondb18.tableSchema)({
       name: "vault_folders",
       columns: [
         { name: "name", type: "string" },
@@ -16043,7 +16090,7 @@ var sdkSchema = (0, import_watermelondb17.appSchema)({
       ]
     }),
     // Conversation summary cache for progressive history summarization
-    (0, import_watermelondb17.tableSchema)({
+    (0, import_watermelondb18.tableSchema)({
       name: "conversation_summaries",
       columns: [
         { name: "conversation_id", type: "string", isIndexed: true },
@@ -16056,7 +16103,7 @@ var sdkSchema = (0, import_watermelondb17.appSchema)({
       ]
     }),
     // Media library storage (images, videos, audio, documents)
-    (0, import_watermelondb17.tableSchema)({
+    (0, import_watermelondb18.tableSchema)({
       name: "media",
       columns: [
         // Identity
@@ -16092,7 +16139,7 @@ var sdkSchema = (0, import_watermelondb17.appSchema)({
       ]
     }),
     // ── App files ─────────────────────────────────────────────────────────
-    (0, import_watermelondb17.tableSchema)({
+    (0, import_watermelondb18.tableSchema)({
       name: "app_files",
       columns: [
         { name: "conversation_id", type: "string", isIndexed: true },
@@ -16103,7 +16150,7 @@ var sdkSchema = (0, import_watermelondb17.appSchema)({
       ]
     }),
     // ── Saved tools ──────────────────────────────────────────────────────
-    (0, import_watermelondb17.tableSchema)({
+    (0, import_watermelondb18.tableSchema)({
       name: "saved_tools",
       columns: [
         { name: "name", type: "string" },
@@ -16565,6 +16612,18 @@ var sdkMigrations = (0, import_migrations2.schemaMigrations)({
           columns: [{ name: "embedding_model", type: "string", isOptional: true }]
         })
       ]
+    },
+    // v33 -> v34: user-managed topics. `topics_user_managed` marks a memory
+    // whose entity links the user has taken manual control of, so
+    // auto-extraction stops touching them.
+    {
+      toVersion: 34,
+      steps: [
+        (0, import_migrations2.addColumns)({
+          table: "memory_vault",
+          columns: [{ name: "topics_user_managed", type: "boolean", isOptional: true }]
+        })
+      ]
     }
   ]
 });
@@ -16585,7 +16644,7 @@ var sdkModelClasses = [
 ];
 
 // src/lib/db/manager.ts
-var import_watermelondb18 = require("@nozbe/watermelondb");
+var import_watermelondb19 = require("@nozbe/watermelondb");
 var DESTRUCTIVE_MIGRATION_VERSION = 8;
 var webPlatformStorage = {
   getItem: (key) => localStorage.getItem(key),
@@ -16663,7 +16722,7 @@ var DatabaseManager = class {
       walletAddress
     });
     const adapter = this.createAdapter(dbName, sdkSchema, sdkMigrations);
-    this.database = new import_watermelondb18.Database({
+    this.database = new import_watermelondb19.Database({
       adapter,
       modelClasses: sdkModelClasses
     });
@@ -16733,7 +16792,7 @@ var DatabaseManager = class {
 };
 
 // src/lib/db/vaultFolders/operations.ts
-var import_watermelondb19 = require("@nozbe/watermelondb");
+var import_watermelondb20 = require("@nozbe/watermelondb");
 function folderToStored(folder) {
   return {
     uniqueId: folder.id,
@@ -16758,7 +16817,7 @@ async function createVaultFolderOp(ctx, opts) {
   return folderToStored(created);
 }
 async function getAllVaultFoldersOp(ctx) {
-  const results = await ctx.vaultFolderCollection.query(import_watermelondb19.Q.where("is_deleted", false), import_watermelondb19.Q.sortBy("created_at", import_watermelondb19.Q.desc)).fetch();
+  const results = await ctx.vaultFolderCollection.query(import_watermelondb20.Q.where("is_deleted", false), import_watermelondb20.Q.sortBy("created_at", import_watermelondb20.Q.desc)).fetch();
   return results.map(folderToStored);
 }
 async function updateVaultFolderOp(ctx, id, opts) {
@@ -16775,7 +16834,7 @@ async function updateVaultFolderOp(ctx, id, opts) {
         })
       );
       if (scopeChanged) {
-        const memories = await ctx.vaultMemoryCollection.query(import_watermelondb19.Q.where("folder_id", id), import_watermelondb19.Q.where("is_deleted", false)).fetch();
+        const memories = await ctx.vaultMemoryCollection.query(import_watermelondb20.Q.where("folder_id", id), import_watermelondb20.Q.where("is_deleted", false)).fetch();
         for (const memory of memories) {
           updates.push(
             memory.prepareUpdate((r) => {
@@ -16797,7 +16856,7 @@ async function deleteVaultFolderOp(ctx, id) {
     const record = await ctx.vaultFolderCollection.find(id);
     if (record.isDeleted) return false;
     await ctx.database.write(async () => {
-      const memories = await ctx.vaultMemoryCollection.query(import_watermelondb19.Q.where("folder_id", id), import_watermelondb19.Q.where("is_deleted", false)).fetch();
+      const memories = await ctx.vaultMemoryCollection.query(import_watermelondb20.Q.where("folder_id", id), import_watermelondb20.Q.where("is_deleted", false)).fetch();
       const preparedMemories = memories.map(
         (memory) => memory.prepareUpdate((r) => {
           r._setRaw("folder_id", null);
@@ -16866,7 +16925,7 @@ async function updateVaultFolderContextOp(ctx, id, context) {
   }
 }
 async function getVaultFolderMemoryCountOp(ctx, folderId) {
-  return await ctx.vaultMemoryCollection.query(import_watermelondb19.Q.where("folder_id", folderId), import_watermelondb19.Q.where("is_deleted", false)).fetchCount();
+  return await ctx.vaultMemoryCollection.query(import_watermelondb20.Q.where("folder_id", folderId), import_watermelondb20.Q.where("is_deleted", false)).fetchCount();
 }
 
 // src/lib/db/vaultFolders/defaults.ts

package/dist/expo/index.d.mts

@@ -4279,6 +4279,9 @@ declare class VaultMemory extends Model {
     eventTimeEnd: number | null;
     /** W6 temporal lane — `point | range | ongoing | null`. */
     eventTimeKind: string | null;
+    /** When true, the user has manually set this memory's topics; auto-extraction
+     *  leaves its entity links alone. Null on legacy rows (treated as false). */
+    topicsUserManaged: boolean | null;
     createdAt: Date;
     updatedAt: Date;
     isDeleted: boolean;
@@ -4379,6 +4382,9 @@ interface StoredVaultMemory {
     eventTimeEnd: number | null;
     /** W6 temporal lane — `point | range | ongoing | null`. */
     eventTimeKind: string | null;
+    /** When true, the user has manually set this memory's topics (entity links);
+     * auto-extraction leaves them alone. False on legacy/auto rows. */
+    topicsUserManaged: boolean;
     createdAt: Date;
     updatedAt: Date;
     isDeleted: boolean;
@@ -4452,6 +4458,9 @@ interface UpdateVaultMemoryOptions {
      * without inflating recency on top.
      */
     preserveUpdatedAt?: boolean;
+    /** If provided, sets whether the user has taken manual control of this
+     * memory's topics. Set by {@link setMemoryEntitiesOp}. */
+    topicsUserManaged?: boolean;
 }
 
 interface VaultMemoryOperationsContext {
@@ -6330,7 +6339,7 @@ declare function useChatStorage(options: UseChatStorageOptions): UseChatStorageR
  *   detectable and re-embeddable after an embedding-model change (null = legacy
  *   rows, grandfathered as compatible with the current model)
  */
-declare const SDK_SCHEMA_VERSION = 33;
+declare const SDK_SCHEMA_VERSION = 34;
 /**
  * Combined WatermelonDB schema for all SDK storage modules.
  *

package/dist/expo/index.d.ts

@@ -4279,6 +4279,9 @@ declare class VaultMemory extends Model {
     eventTimeEnd: number | null;
     /** W6 temporal lane — `point | range | ongoing | null`. */
     eventTimeKind: string | null;
+    /** When true, the user has manually set this memory's topics; auto-extraction
+     *  leaves its entity links alone. Null on legacy rows (treated as false). */
+    topicsUserManaged: boolean | null;
     createdAt: Date;
     updatedAt: Date;
     isDeleted: boolean;
@@ -4379,6 +4382,9 @@ interface StoredVaultMemory {
     eventTimeEnd: number | null;
     /** W6 temporal lane — `point | range | ongoing | null`. */
     eventTimeKind: string | null;
+    /** When true, the user has manually set this memory's topics (entity links);
+     * auto-extraction leaves them alone. False on legacy/auto rows. */
+    topicsUserManaged: boolean;
     createdAt: Date;
     updatedAt: Date;
     isDeleted: boolean;
@@ -4452,6 +4458,9 @@ interface UpdateVaultMemoryOptions {
      * without inflating recency on top.
      */
     preserveUpdatedAt?: boolean;
+    /** If provided, sets whether the user has taken manual control of this
+     * memory's topics. Set by {@link setMemoryEntitiesOp}. */
+    topicsUserManaged?: boolean;
 }
 
 interface VaultMemoryOperationsContext {
@@ -6330,7 +6339,7 @@ declare function useChatStorage(options: UseChatStorageOptions): UseChatStorageR
  *   detectable and re-embeddable after an embedding-model change (null = legacy
  *   rows, grandfathered as compatible with the current model)
  */
-declare const SDK_SCHEMA_VERSION = 33;
+declare const SDK_SCHEMA_VERSION = 34;
 /**
  * Combined WatermelonDB schema for all SDK storage modules.
  *