@anuma/sdk 3.12.2 → 3.13.0

package/dist/server/index.mjs

@@ -19,6 +19,7 @@ import {
   VAULT_SIZE_HOP_CAP,
   archiveVaultMemoryOp,
   assertVaultScopeForSweep,
+  backfillMemoryTopicsOp,
   capHopsForDensity,
   chunkAndEmbedAllMessages,
   chunkAndEmbedMessage,
@@ -94,6 +95,7 @@ import {
   prepareVaultCandidates,
   rankPreparedVaultCandidates,
   recall,
+  relinkMemoryTopicsOp,
   replaceMemoryEntitiesGuardedOp,
   requestEncryptionKey,
   requestKeyPair,
@@ -131,7 +133,7 @@ import {
   updateVaultMemoryOp,
   upsertMessageOp,
   vaultMemoryToStored
-} from "./chunk-FXGG7JA5.mjs";
+} from "./chunk-ME6ZQN52.mjs";
 import {
   createStreamingDeAnonymizer,
   notifyConsolidationFallback,
@@ -1124,6 +1126,12 @@ __decorateClass([
 __decorateClass([
   (0, import_decorators6.field)("topics_user_managed")
 ], VaultMemory.prototype, "topicsUserManaged", 2);
+__decorateClass([
+  (0, import_decorators6.field)("topics")
+], VaultMemory.prototype, "topics", 2);
+__decorateClass([
+  (0, import_decorators6.field)("topics_updated_at")
+], VaultMemory.prototype, "topicsUpdatedAt", 2);
 __decorateClass([
   (0, import_decorators6.field)("topics_extracted_at")
 ], VaultMemory.prototype, "topicsExtractedAt", 2);
@@ -1307,7 +1315,7 @@ __decorateClass([
 ], VaultFolder.prototype, "context", 2);
 
 // src/lib/db/schema.ts
-var SDK_SCHEMA_VERSION = 41;
+var SDK_SCHEMA_VERSION = 42;
 var sdkSchema = (0, import_watermelondb12.appSchema)({
   version: SDK_SCHEMA_VERSION,
   tables: [
@@ -1429,9 +1437,33 @@ var sdkSchema = (0, import_watermelondb12.appSchema)({
         // 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 },
+        // The memory's topics as a DURABLE, SYNCED record: a JSON array of
+        // `{name, kind?, source}`, `name` in the caller's display casing (unlike
+        // `entity.canonical_name`, which is lowercased and has no display
+        // column). `entity` / `memory_entity` are a device-local INDEX over this
+        // — their ids are locally generated, so they can never sync — and a
+        // restored device rebuilds them from these names with no LLM call.
+        // Null = predates v42 (backfilled from the row's current links by the
+        // sweep's topicsBackfill bucket). See getMemoriesNeedingTopicExtractionOp.
+        { name: "topics", type: "string", isOptional: true },
+        // Unix ms of the last write to `topics`. A SECOND timestamp is required:
+        // every topic writer deliberately pins `updated_at` so a topic change
+        // doesn't inflate recall's recency multiplier, and both client sync
+        // paths key on `updated_at` — so without this a topic-only change would
+        // neither upload nor merge. Null = `topics` never written.
+        { name: "topics_updated_at", type: "number", isOptional: true },
         // Unix ms of the last LLM topic-extraction pass over this memory's
         // content. Null = never extracted standalone (legacy rows with entity
         // links are grandfathered — see getMemoriesNeedingTopicExtractionOp).
+        //
+        // DEPRECATED (v42) — `topics_updated_at` subsumes this and
+        // `topics_extracted_version` both: null there means never processed, and
+        // non-null with an empty `topics` means processed and found nothing
+        // (today's "answered empty" case), while a release-time
+        // EXTRACTOR_CHANGED_AT constant compared against `topics_updated_at`
+        // replaces the version check. Both columns are kept only to avoid a
+        // column-drop migration in an otherwise additive list; removing them is
+        // a follow-up once `topics` is proven in production.
         { name: "topics_extracted_at", type: "number", isOptional: true },
         // Write-time supersession (A2). When set, this fact was replaced by a
         // newer, incompatible-value fact (e.g. "Lives in Portland" superseded by
@@ -1445,6 +1477,9 @@ var sdkSchema = (0, import_watermelondb12.appSchema)({
         // The extraction-logic version this memory was last stamped under. Null
         // (pre-v38) is treated as version 0, so a bump of TOPICS_EXTRACTION_VERSION
         // re-extracts stale rows. See getMemoriesNeedingTopicExtractionOp.
+        //
+        // DEPRECATED (v42) alongside `topics_extracted_at` — same rationale and
+        // same removal follow-up; see that column's note above.
         { name: "topics_extracted_version", type: "number", isOptional: true },
         // Re-observation watermark (C3). Unix ms of the last time retain() merged
         // a duplicate observation into this fact (proof_count++). Distinct from
@@ -2178,6 +2213,23 @@ var sdkMigrations = (0, import_migrations.schemaMigrations)({
           ]
         })
       ]
+    },
+    // v41 -> v42: topics + topics_updated_at on memory_vault — the durable,
+    // synced record of a memory's topics. Existing rows keep both NULL: the
+    // sweep's topicsBackfill bucket fills them from each row's current entity
+    // links (no LLM), capped under the worker's `limit` so the one-time
+    // re-upload it triggers drains across sweeps instead of spiking.
+    {
+      toVersion: 42,
+      steps: [
+        (0, import_migrations.addColumns)({
+          table: "memory_vault",
+          columns: [
+            { name: "topics", type: "string", isOptional: true },
+            { name: "topics_updated_at", type: "number", isOptional: true }
+          ]
+        })
+      ]
     }
   ]
 });
@@ -12963,6 +13015,7 @@ export {
   activatedToolSetNames,
   analyzeStyle,
   archiveVaultMemoryOp,
+  backfillMemoryTopicsOp,
   buildConnectorGuidance,
   buildDeniedToolsRider,
   buildSystemPrompt,
@@ -13120,6 +13173,7 @@ export {
   rankProfileCandidates,
   recall,
   reflect,
+  relinkMemoryTopicsOp,
   relinkMisclassifiedVideosOp,
   renderTemplate,
   requestEncryptionKey,

package/dist/server/{recall-SLMMIFHM.mjs → recall-RMCSM6L6.mjs}

@@ -1,6 +1,6 @@
 import {
   recall
-} from "./chunk-FXGG7JA5.mjs";
+} from "./chunk-ME6ZQN52.mjs";
 import "./chunk-OBDRKQQI.mjs";
 import "./chunk-3RPGXXPZ.mjs";
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anuma/sdk",
-  "version": "3.12.2",
+  "version": "3.13.0",
   "description": "",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",