@anuma/sdk 6.32.0 → 6.33.0

package/dist/server/index.mjs

@@ -12324,7 +12324,7 @@ var require_Query = __commonJS({
     var _subscribeToCount = _interopRequireDefault(require_subscribeToCount());
     var _subscribeToQuery = _interopRequireDefault(require_subscribeToQuery());
     var _subscribeToQueryWithColumns = _interopRequireDefault(require_subscribeToQueryWithColumns());
-    var Q11 = _interopRequireWildcard(require_QueryDescription());
+    var Q12 = _interopRequireWildcard(require_QueryDescription());
     var _helpers = require_helpers2();
     var _class;
     var _descriptor;
@@ -12356,8 +12356,8 @@ var require_Query = __commonJS({
         (0, _initializerDefineProperty2.default)(this, "_cachedCountSubscribable", _descriptor2, this);
         (0, _initializerDefineProperty2.default)(this, "_cachedCountThrottledSubscribable", _descriptor3, this);
         this.collection = collection;
-        this._rawDescription = Q11.buildQueryDescription(clauses);
-        this.description = Q11.queryWithoutDeleted(this._rawDescription);
+        this._rawDescription = Q12.buildQueryDescription(clauses);
+        this.description = Q12.queryWithoutDeleted(this._rawDescription);
       }
       var _proto = Query2.prototype;
       _proto.extend = function(...args) {
@@ -12376,12 +12376,12 @@ var require_Query = __commonJS({
           sql
         } = this._rawDescription;
         (0, _invariant.default)(!sql, "Cannot extend an unsafe SQL query");
-        return new Query2(collection, [Q11.experimentalJoinTables(joinTables)].concat((0, _toConsumableArray2.default)(nestedJoinTables.map(function({
+        return new Query2(collection, [Q12.experimentalJoinTables(joinTables)].concat((0, _toConsumableArray2.default)(nestedJoinTables.map(function({
           from,
           to
         }) {
-          return Q11.experimentalNestedJoin(from, to);
-        })), (0, _toConsumableArray2.default)(where), (0, _toConsumableArray2.default)(sortBy), (0, _toConsumableArray2.default)(take ? [Q11.take(take)] : []), (0, _toConsumableArray2.default)(skip ? [Q11.skip(skip)] : []), (0, _toConsumableArray2.default)(lokiTransform ? [Q11.unsafeLokiTransform(lokiTransform)] : []), (0, _toConsumableArray2.default)(clauses)));
+          return Q12.experimentalNestedJoin(from, to);
+        })), (0, _toConsumableArray2.default)(where), (0, _toConsumableArray2.default)(sortBy), (0, _toConsumableArray2.default)(take ? [Q12.take(take)] : []), (0, _toConsumableArray2.default)(skip ? [Q12.skip(skip)] : []), (0, _toConsumableArray2.default)(lokiTransform ? [Q12.unsafeLokiTransform(lokiTransform)] : []), (0, _toConsumableArray2.default)(clauses)));
       };
       _proto.pipe = function(transform) {
         return transform(this);
@@ -13823,7 +13823,7 @@ var require_helpers5 = __commonJS({
     exports.createTimestampsFor = void 0;
     exports.fetchDescendants = fetchDescendants;
     var _fp = require_fp();
-    var Q11 = _interopRequireWildcard(require_QueryDescription());
+    var Q12 = _interopRequireWildcard(require_QueryDescription());
     function _getRequireWildcardCache(e) {
       if ("function" != typeof WeakMap) return null;
       var r = /* @__PURE__ */ new WeakMap(), t = /* @__PURE__ */ new WeakMap();
@@ -13861,7 +13861,7 @@ var require_helpers5 = __commonJS({
       });
       var childrenQueries = hasManyAssociations.map(function([key, value]) {
         var childCollection = model.collections.get(key);
-        return childCollection.query(Q11.where(value.foreignKey, model.id));
+        return childCollection.query(Q12.where(value.foreignKey, model.id));
       });
       return childrenQueries;
     }
@@ -14242,8 +14242,8 @@ var require_watermelondb = __commonJS({
     var _interopRequireDefault = require_interopRequireDefault();
     exports.__esModule = true;
     exports.tableSchema = exports.tableName = exports.localStorageKey = exports.columnName = exports.associations = exports.appSchema = exports.Relation = exports.Query = exports.Q = exports.Model = exports.Database = exports.Collection = void 0;
-    var Q11 = _interopRequireWildcard(require_QueryDescription());
-    exports.Q = Q11;
+    var Q12 = _interopRequireWildcard(require_QueryDescription());
+    exports.Q = Q12;
     var _Collection = _interopRequireDefault(require_Collection());
     exports.Collection = _Collection.default;
     var _Database = _interopRequireDefault(require_Database());
@@ -14447,7 +14447,7 @@ var require_children = __commonJS({
     var _makeDecorator = _interopRequireDefault(require_makeDecorator());
     var _logError = _interopRequireDefault(require_logError());
     var _invariant = _interopRequireDefault(require_invariant());
-    var Q11 = _interopRequireWildcard(require_QueryDescription());
+    var Q12 = _interopRequireWildcard(require_QueryDescription());
     function _getRequireWildcardCache(e) {
       if ("function" != typeof WeakMap) return null;
       var r = /* @__PURE__ */ new WeakMap(), t = /* @__PURE__ */ new WeakMap();
@@ -14481,7 +14481,7 @@ var require_children = __commonJS({
             var childCollection = model.collections.get(childTable);
             var association = model.constructor.associations[childTable];
             (0, _invariant.default)(association && "has_many" === association.type, "@children decorator used for a table that's not has_many");
-            var query = childCollection.query(Q11.where(association.foreignKey, model.id));
+            var query = childCollection.query(Q12.where(association.foreignKey, model.id));
             that._childrenQueryCache[childTable] = query;
             return query;
           },
@@ -21009,6 +21009,51 @@ async function updateVaultMemoryOp(ctx, id, opts) {
     return null;
   }
 }
+async function setMemoryEntitiesOp(ctx, memoryId, entities) {
+  const entityCtx = ctx.entityCtx;
+  if (!entityCtx) {
+    throw new Error("setMemoryEntitiesOp requires ctx.entityCtx (entity collections)");
+  }
+  let record;
+  try {
+    record = await ctx.vaultMemoryCollection.find(memoryId);
+  } catch {
+    return null;
+  }
+  if (record.isDeleted || !isOwnedByCtxUser(ctx, record)) return null;
+  let stale = false;
+  const originalUpdatedAt = record.updatedAt.getTime();
+  await ctx.database.write(async (writer) => {
+    if (record.isDeleted || !isOwnedByCtxUser(ctx, record)) {
+      stale = true;
+      return;
+    }
+    await record.update((r) => {
+      r._setRaw("topics_user_managed", true);
+      r._setRaw("updated_at", originalUpdatedAt);
+    });
+    const linked = entities.length > 0 ? await writer.callWriter(
+      () => linkMemoryEntitiesOp(entityCtx, memoryId, entities, { topicsSource: "user" })
+    ) : [];
+    const keep = new Set(linked.map((e) => e.uniqueId));
+    const existing = await entityCtx.memoryEntityCollection.query(import_watermelondb18.Q.where("memory_id", memoryId)).fetch();
+    const staleLinks = existing.filter((l) => !keep.has(String(l.entityId)));
+    if (staleLinks.length === 0 && entities.length > 0) return;
+    const topicsWrite = await resolveMemoryTopicsWrite(
+      entityCtx,
+      memoryId,
+      linked,
+      entities,
+      "user"
+    );
+    await ctx.database.batch(
+      ...staleLinks.map((l) => l.prepareDestroyPermanently()),
+      ...topicsWrite ? [prepareMemoryTopicsUpdate(topicsWrite)] : []
+    );
+  });
+  if (stale) return null;
+  return vaultMemoryToStored(record, ctx.walletAddress, ctx.signMessage, ctx.embeddedWalletSigner);
+}
 async function clearMemoryTopicsOverrideOp(ctx, memoryId, options) {
   let record;
   try {
@@ -25502,7 +25547,10 @@ async function eagerEmbedContent(content, embeddingOptions, cache, vaultCtx, mem
   if (memoryId) cacheRowVector(cache, memoryId, Float32Array.from(embedding), updatedAt, content);
   if (vaultCtx && memoryId) {
     const currentModel = embeddingOptions.model ?? DEFAULT_API_EMBEDDING_MODEL;
-    updateVaultMemoryEmbeddingOp(vaultCtx, memoryId, JSON.stringify(embedding), currentModel).catch(
+    updateVaultMemoryEmbeddingOp(vaultCtx, memoryId, JSON.stringify(embedding), currentModel, {
+      content,
+      ...updatedAt !== void 0 && { updatedAt: updatedAt.getTime() }
+    }).catch(
       // Silently swallow – SDK must not use console.*; embedding will be retried on next search
       () => {
       }
@@ -29785,6 +29833,349 @@ function parseAnswer(body, base, parseSchema) {
   };
 }
 
+// src/lib/memory/store/local.ts
+var import_watermelondb24 = __toESM(require_watermelondb());
+
+// src/lib/memory/topicExtract.ts
+var TOPIC_EXTRACTION_BATCH_SIZE = 10;
+var MAX_CHARS_PER_MEMORY = 300;
+var MAX_VOCABULARY_NAMES = 100;
+var MAX_COMPLETION_TOKENS = 8192;
+var SYSTEM_PROMPT5 = `You assign topics to saved memories for a personal memory system.
+
+Each memory is a short statement about the user. For each memory, list the NAMED entities it mentions \u2014 these become the memory's topics, used to connect related memories in a knowledge graph.
+
+Include only NAMED entities, skip generic/common nouns. A topic must identify a specific thing the user could recognize by name; if it would be equally true of thousands of unrelated memories, leave it out:
+- SKIP bare generic nouns even when the memory capitalizes them or a calendar entry is titled that way \u2014 "Home", "Work", "Meeting", "Lunch", "Birthday", "Appointment", "Trip", "Today", "Friday", "March" are NOT topics.
+- KEEP the specific thing instead, when the memory names one: "Blue Bottle on Valencia" over "cafe", "Chicago Marathon" over "event", "Hollowpoint Labs" over "work".
+- Prefer 0 entities over a weak one. A memory whose only candidate is a generic noun has NO entities.
+${ENTITY_KIND_GUIDELINES}
+
+Each memory below is written as "<id>: <text>". Output strict JSON: {"memories": [{"id": string, "entities": [{"name": string, "kind": string}]}]}
+- exactly one element per input memory; copy its id EXACTLY as written (the token before the first ": "), with no brackets, quotes, or extra characters
+- "entities" may be empty when a memory mentions no named entities \u2014 most short memories have 0-3
+No prose.`;
+async function extractEntitiesForMemories(memories, options) {
+  const out = /* @__PURE__ */ new Map();
+  if (memories.length === 0) return out;
+  const redactor = resolvePiiRedactor(options.piiRedaction);
+  const vocabulary = [];
+  for (const name of (options.existingEntityNames ?? []).filter((n) => n.trim().length > 0).slice(0, MAX_VOCABULARY_NAMES)) {
+    vocabulary.push(redactor ? (await redactor.redactTextAsync(name)).text : name);
+  }
+  const vocabularyNote = vocabulary.length > 0 ? `The user's existing topics: ${vocabulary.join(", ")}.
+When a memory refers to one of these, reuse the EXACT existing name (same spelling, casing, spacing and punctuation) instead of a variant \u2014 if "Foo.ai" is listed, never emit "Foo ai" or "Foo AI", and if "Jane Roe" is listed, emit that rather than a bare "Jane".
+
+` : "";
+  for (let i = 0; i < memories.length; i += TOPIC_EXTRACTION_BATCH_SIZE) {
+    const batch = memories.slice(i, i + TOPIC_EXTRACTION_BATCH_SIZE);
+    const rows = [];
+    for (const m of batch) {
+      const content = m.content.slice(0, MAX_CHARS_PER_MEMORY).replace(/\s+/g, " ").trim();
+      rows.push(`${m.id}: ${redactor ? (await redactor.redactTextAsync(content)).text : content}`);
+    }
+    const listing = rows.join("\n");
+    const parsed = await callPortalJsonCompletion({
+      ...options.apiKey !== void 0 && { apiKey: options.apiKey },
+      ...options.getToken !== void 0 && { getToken: options.getToken },
+      ...options.baseUrl !== void 0 && { baseUrl: options.baseUrl },
+      taskType: "memory_topic",
+      ...options.endpointOverride !== void 0 && {
+        endpointOverride: options.endpointOverride
+      },
+      model: options.model ?? DEFAULT_EXTRACTION_MODEL,
+      systemPrompt: SYSTEM_PROMPT5,
+      userMessage: `${vocabularyNote}Memories:
+${listing}
+
+List each memory's named entities.`,
+      tag: "memory/topics",
+      extra: { max_completion_tokens: MAX_COMPLETION_TOKENS },
+      ...options.fetchFn && { fetchFn: options.fetchFn },
+      ...options.maxAttempts !== void 0 && { maxAttempts: options.maxAttempts },
+      ...options.timeoutMs !== void 0 && { timeoutMs: options.timeoutMs },
+      ...options.totalTimeoutMs !== void 0 && { totalTimeoutMs: options.totalTimeoutMs },
+      ...options.backoffMs && { backoffMs: options.backoffMs }
+    });
+    if (parsed === null) {
+      getLogger().warn(
+        `[memory/topics] batch of ${batch.length} failed after retries \u2014 will retry next sweep`
+      );
+      continue;
+    }
+    const validIds = new Set(batch.map((m) => m.id));
+    const byId = parseTopicResponse(parsed, validIds);
+    if (byId === null) {
+      getLogger().warn(
+        `[memory/topics] batch of ${batch.length} returned an unrecognized shape \u2014 will retry next sweep`
+      );
+      continue;
+    }
+    for (const m of batch) {
+      const entities = byId.get(m.id);
+      if (entities === void 0) {
+        continue;
+      }
+      out.set(m.id, redactor ? restoreEntities(entities, redactor) : entities);
+    }
+  }
+  return out;
+}
+function restoreEntities(entities, redactor) {
+  return entities.map((e) => ({ kind: e.kind, restored: redactor.restoreForStorage(e.name) })).filter((e) => !e.restored.unresolved).map(
+    (e) => e.kind !== void 0 ? { name: e.restored.text, kind: e.kind } : { name: e.restored.text }
+  );
+}
+function parseTopicResponse(parsed, validIds) {
+  if (typeof parsed !== "object" || parsed === null) return null;
+  const list = parsed.memories;
+  if (!Array.isArray(list)) return null;
+  const out = /* @__PURE__ */ new Map();
+  for (const raw of list) {
+    if (typeof raw !== "object" || raw === null) continue;
+    const obj = raw;
+    if (typeof obj.id !== "string") continue;
+    const id = obj.id.trim().replace(/:$/, "").replace(/^\[([\s\S]*)\]$/, "$1").trim();
+    if (!validIds.has(id) || out.has(id)) continue;
+    const entities = Array.isArray(obj.entities) ? parseEntities(obj.entities) : [];
+    out.set(id, entities);
+  }
+  return out;
+}
+var DEGRADED_TOPIC_SKIP = {
+  excluded: false,
+  "link-declined": false,
+  "stamp-declined": false,
+  "llm-unanswered": true,
+  unreadable: true,
+  "not-found": true,
+  "link-failed": true
+};
+function isDegradedTopicSkip(reason) {
+  return DEGRADED_TOPIC_SKIP[reason] === true;
+}
+async function extractAndLinkEntitiesForMemoriesOp(ctx, memoryIds, options) {
+  const entityCtx = ctx.entityCtx;
+  if (!entityCtx) {
+    throw new Error("extractAndLinkEntitiesForMemoriesOp requires ctx.entityCtx");
+  }
+  const log = getLogger();
+  const extractedAt = options.now ?? Date.now();
+  const skippedIds = [];
+  const skippedReasons = /* @__PURE__ */ new Map();
+  const skip = (id, reason) => {
+    if (skippedReasons.has(id)) return;
+    skippedIds.push(id);
+    skippedReasons.set(id, reason);
+  };
+  const inputs = [];
+  for (const id of new Set(memoryIds)) {
+    let record;
+    try {
+      record = await ctx.vaultMemoryCollection.find(id);
+    } catch (err) {
+      log.warn("[memory/topics] vault lookup failed for extraction", err);
+      skip(id, "not-found");
+      continue;
+    }
+    if (record.isDeleted || ctx.userId !== void 0 && record.userId !== ctx.userId || record.topicsUserManaged) {
+      skip(id, "excluded");
+      continue;
+    }
+    try {
+      const stored = await vaultMemoryToStored(
+        record,
+        ctx.walletAddress,
+        ctx.signMessage,
+        ctx.embeddedWalletSigner
+      );
+      inputs.push({ id, content: stored.content });
+    } catch (err) {
+      log.warn("[memory/topics] failed to load memory for extraction", err);
+      skip(id, "unreadable");
+    }
+  }
+  const entitiesByMemory = await extractEntitiesForMemories(inputs, options);
+  const toStamp = [];
+  for (const input of inputs) {
+    const entities = entitiesByMemory.get(input.id);
+    if (entities === void 0) {
+      skip(input.id, "llm-unanswered");
+      continue;
+    }
+    try {
+      const linked = await replaceMemoryEntitiesGuardedOp(entityCtx, input.id, entities);
+      if (linked === null) {
+        skip(input.id, "link-declined");
+        entitiesByMemory.delete(input.id);
+        continue;
+      }
+    } catch (err) {
+      log.warn("[memory/topics] replaceMemoryEntitiesGuardedOp failed", err);
+      skip(input.id, "link-failed");
+      entitiesByMemory.delete(input.id);
+      continue;
+    }
+    toStamp.push(input.id);
+  }
+  const stampedIds = await stampTopicsExtractedAtOp(ctx, toStamp, extractedAt);
+  const stampedSet = new Set(stampedIds);
+  for (const id of toStamp) {
+    if (!stampedSet.has(id)) {
+      skip(id, "stamp-declined");
+      entitiesByMemory.delete(id);
+    }
+  }
+  return { entitiesByMemory, stampedIds, skippedIds, skippedReasons };
+}
+
+// src/lib/memory/store/local.ts
+function createLocalMemoryStore(options) {
+  const { database, userId } = options;
+  const entityCtx = {
+    database,
+    entityCollection: database.get("entity"),
+    memoryEntityCollection: database.get("memory_entity"),
+    ...userId !== void 0 && { userId },
+    ...options.allowUnscopedRows !== void 0 && {
+      allowUnscopedRows: options.allowUnscopedRows
+    }
+  };
+  const vaultCtx = {
+    database,
+    vaultMemoryCollection: database.get("memory_vault"),
+    walletAddress: options.walletAddress,
+    signMessage: options.signMessage,
+    embeddedWalletSigner: options.embeddedWalletSigner,
+    ...userId !== void 0 && { userId },
+    ...options.singleTenant !== void 0 && { singleTenant: options.singleTenant },
+    // Deletes cascade to memory_entity, so the graph lane never serves a
+    // deleted memory's id.
+    entityCtx
+  };
+  const vaultCache = options.vaultCache ?? createVaultEmbeddingCache();
+  const ownedBy = userId !== void 0 ? [import_watermelondb24.Q.where("user_id", userId)] : [];
+  const watchedColumns = [
+    "content",
+    "scope",
+    "updated_at",
+    "fact_type",
+    "event_time_start",
+    "event_time_end",
+    "event_time_kind",
+    "archived_at",
+    "trust_tier",
+    "superseded_by",
+    "visibility",
+    "published_at",
+    "geohash",
+    "topics",
+    "topics_user_managed",
+    "media",
+    "source"
+  ];
+  const embedInBackground = (memory) => {
+    eagerEmbedContent(
+      memory.content,
+      options.embeddingOptions,
+      vaultCache,
+      vaultCtx,
+      memory.uniqueId,
+      memory.updatedAt
+    ).catch((err) => {
+      getLogger().warn("[memory/store] Failed to embed memory:", err);
+    });
+  };
+  return {
+    list: (listOptions) => getAllVaultMemoriesOp(vaultCtx, listOptions),
+    get: (id) => getVaultMemoryOp(vaultCtx, id),
+    listArchived: async () => {
+      const ids = await vaultCtx.vaultMemoryCollection.query(import_watermelondb24.Q.where("is_deleted", false), import_watermelondb24.Q.where("archived_at", import_watermelondb24.Q.notEq(null)), ...ownedBy).fetchIds();
+      if (ids.length === 0) return [];
+      const rows = await getAllVaultMemoriesOp(vaultCtx, { memoryIds: ids, includeArchived: true });
+      return rows.sort((a, b) => (b.archivedAt ?? 0) - (a.archivedAt ?? 0));
+    },
+    memoriesByTopics: (names) => getMemoriesByEntityNamesOp(entityCtx, names),
+    topicsByMemories: (memoryIds) => getEntitiesByMemoryIdsOp(entityCtx, memoryIds),
+    create: async (input) => {
+      const created = await createVaultMemoryOp(vaultCtx, input);
+      if (input.embedding === void 0) embedInBackground(created);
+      return created;
+    },
+    createMany: async (inputs) => {
+      const created = await createVaultMemoriesBatchOp(vaultCtx, inputs);
+      created.forEach((memory, i) => {
+        if (inputs[i].embedding === void 0) embedInBackground(memory);
+      });
+      return created;
+    },
+    update: async (id, patch) => {
+      const reembed = patch.embedding === void 0;
+      const updated = await updateVaultMemoryOp(
+        vaultCtx,
+        id,
+        reembed ? { ...patch, embedding: null } : patch
+      );
+      if (!updated) return null;
+      vaultCache.delete(id);
+      if (reembed) embedInBackground(updated);
+      return updated;
+    },
+    delete: async (id) => {
+      const deleted = await deleteVaultMemoryOp(vaultCtx, id);
+      if (deleted) vaultCache.delete(id);
+      return deleted;
+    },
+    supersede: (id, supersededById) => supersedeVaultMemoryOp(vaultCtx, id, supersededById),
+    archive: (id) => archiveVaultMemoryOp(vaultCtx, id),
+    restore: (id) => restoreVaultMemoryOp(vaultCtx, id),
+    setTopics: (memoryId, topics) => setMemoryEntitiesOp(vaultCtx, memoryId, topics),
+    addTopics: (memoryId, topics) => database.write(async (writer) => {
+      const owned = await vaultCtx.vaultMemoryCollection.query(import_watermelondb24.Q.where("id", memoryId), import_watermelondb24.Q.where("is_deleted", false), ...ownedBy).fetchCount();
+      return owned > 0 ? writer.callWriter(() => linkMemoryEntitiesOp(entityCtx, memoryId, topics)) : [];
+    }),
+    setVisibility: (id, visibility, visibilityOptions) => setMemoryVisibilityOp(vaultCtx, id, { visibility, ...visibilityOptions }),
+    recall: (query, recallOptions) => recall(
+      query,
+      { vaultCtx, entityCtx, embeddingOptions: options.embeddingOptions, vaultCache },
+      { ...recallOptions, types: ["fact"] }
+    ),
+    retain: (content, retainOptions) => retain(
+      content,
+      { vaultCtx, embeddingOptions: options.embeddingOptions, vaultCache },
+      retainOptions
+    ),
+    subscribe: (onChange, subscribeOptions) => {
+      const afterFirst = () => {
+        let first = true;
+        return () => {
+          if (first) first = false;
+          else onChange();
+        };
+      };
+      const memories = subscribeOptions?.includeDeleted ? vaultCtx.vaultMemoryCollection.query(...ownedBy).observe() : vaultCtx.vaultMemoryCollection.query(import_watermelondb24.Q.where("is_deleted", false), ...ownedBy).observeWithColumns(
+        subscribeOptions?.embeddings ? [...watchedColumns, "embedding", "embedding_model"] : watchedColumns
+      );
+      const subscriptions = [memories.subscribe(afterFirst())];
+      if (subscribeOptions?.topics) {
+        const linksOwnedBy = userId === void 0 ? [] : options.allowUnscopedRows ? [import_watermelondb24.Q.or(import_watermelondb24.Q.where("user_id", userId), import_watermelondb24.Q.where("user_id", null))] : [import_watermelondb24.Q.where("user_id", userId)];
+        subscriptions.push(
+          entityCtx.memoryEntityCollection.query(...linksOwnedBy).observe().subscribe(afterFirst())
+        );
+      }
+      return () => subscriptions.forEach((s) => s.unsubscribe());
+    },
+    maintenance: {
+      createDecaySweeper: (sweeperOptions) => createDecaySweeper({ ...sweeperOptions, vaultCtx }),
+      getTopicBacklog: (backlogOptions) => getMemoriesNeedingTopicExtractionOp(vaultCtx, backlogOptions),
+      extractTopics: (memoryIds, extractOptions) => extractAndLinkEntitiesForMemoriesOp(vaultCtx, memoryIds, extractOptions),
+      stampTopicsExtracted: (memoryIds, extractedAt, version) => stampTopicsExtractedAtOp(vaultCtx, memoryIds, extractedAt, version),
+      relinkTopics: (memoryIds) => relinkMemoryTopicsOp(vaultCtx, memoryIds),
+      backfillTopics: (memoryIds) => backfillMemoryTopicsOp(vaultCtx, memoryIds)
+    }
+  };
+}
+
 // src/lib/memory/synthesizeProfile.ts
 var DEFAULT_SYNTHESIS_MODEL = "inclusionai/ling-2.6-flash";
 var DEFAULT_FACET_RECALL_LIMIT = 20;
@@ -30312,199 +30703,6 @@ function normalizeInterests(values) {
   return out.length > 0 ? out : void 0;
 }
 
-// src/lib/memory/topicExtract.ts
-var TOPIC_EXTRACTION_BATCH_SIZE = 10;
-var MAX_CHARS_PER_MEMORY = 300;
-var MAX_VOCABULARY_NAMES = 100;
-var MAX_COMPLETION_TOKENS = 8192;
-var SYSTEM_PROMPT5 = `You assign topics to saved memories for a personal memory system.
-
-Each memory is a short statement about the user. For each memory, list the NAMED entities it mentions \u2014 these become the memory's topics, used to connect related memories in a knowledge graph.
-
-Include only NAMED entities, skip generic/common nouns. A topic must identify a specific thing the user could recognize by name; if it would be equally true of thousands of unrelated memories, leave it out:
-- SKIP bare generic nouns even when the memory capitalizes them or a calendar entry is titled that way \u2014 "Home", "Work", "Meeting", "Lunch", "Birthday", "Appointment", "Trip", "Today", "Friday", "March" are NOT topics.
-- KEEP the specific thing instead, when the memory names one: "Blue Bottle on Valencia" over "cafe", "Chicago Marathon" over "event", "Hollowpoint Labs" over "work".
-- Prefer 0 entities over a weak one. A memory whose only candidate is a generic noun has NO entities.
-${ENTITY_KIND_GUIDELINES}
-
-Each memory below is written as "<id>: <text>". Output strict JSON: {"memories": [{"id": string, "entities": [{"name": string, "kind": string}]}]}
-- exactly one element per input memory; copy its id EXACTLY as written (the token before the first ": "), with no brackets, quotes, or extra characters
-- "entities" may be empty when a memory mentions no named entities \u2014 most short memories have 0-3
-No prose.`;
-async function extractEntitiesForMemories(memories, options) {
-  const out = /* @__PURE__ */ new Map();
-  if (memories.length === 0) return out;
-  const redactor = resolvePiiRedactor(options.piiRedaction);
-  const vocabulary = [];
-  for (const name of (options.existingEntityNames ?? []).filter((n) => n.trim().length > 0).slice(0, MAX_VOCABULARY_NAMES)) {
-    vocabulary.push(redactor ? (await redactor.redactTextAsync(name)).text : name);
-  }
-  const vocabularyNote = vocabulary.length > 0 ? `The user's existing topics: ${vocabulary.join(", ")}.
-When a memory refers to one of these, reuse the EXACT existing name (same spelling, casing, spacing and punctuation) instead of a variant \u2014 if "Foo.ai" is listed, never emit "Foo ai" or "Foo AI", and if "Jane Roe" is listed, emit that rather than a bare "Jane".
-
-` : "";
-  for (let i = 0; i < memories.length; i += TOPIC_EXTRACTION_BATCH_SIZE) {
-    const batch = memories.slice(i, i + TOPIC_EXTRACTION_BATCH_SIZE);
-    const rows = [];
-    for (const m of batch) {
-      const content = m.content.slice(0, MAX_CHARS_PER_MEMORY).replace(/\s+/g, " ").trim();
-      rows.push(`${m.id}: ${redactor ? (await redactor.redactTextAsync(content)).text : content}`);
-    }
-    const listing = rows.join("\n");
-    const parsed = await callPortalJsonCompletion({
-      ...options.apiKey !== void 0 && { apiKey: options.apiKey },
-      ...options.getToken !== void 0 && { getToken: options.getToken },
-      ...options.baseUrl !== void 0 && { baseUrl: options.baseUrl },
-      taskType: "memory_topic",
-      ...options.endpointOverride !== void 0 && {
-        endpointOverride: options.endpointOverride
-      },
-      model: options.model ?? DEFAULT_EXTRACTION_MODEL,
-      systemPrompt: SYSTEM_PROMPT5,
-      userMessage: `${vocabularyNote}Memories:
-${listing}
-
-List each memory's named entities.`,
-      tag: "memory/topics",
-      extra: { max_completion_tokens: MAX_COMPLETION_TOKENS },
-      ...options.fetchFn && { fetchFn: options.fetchFn },
-      ...options.maxAttempts !== void 0 && { maxAttempts: options.maxAttempts },
-      ...options.timeoutMs !== void 0 && { timeoutMs: options.timeoutMs },
-      ...options.totalTimeoutMs !== void 0 && { totalTimeoutMs: options.totalTimeoutMs },
-      ...options.backoffMs && { backoffMs: options.backoffMs }
-    });
-    if (parsed === null) {
-      getLogger().warn(
-        `[memory/topics] batch of ${batch.length} failed after retries \u2014 will retry next sweep`
-      );
-      continue;
-    }
-    const validIds = new Set(batch.map((m) => m.id));
-    const byId = parseTopicResponse(parsed, validIds);
-    if (byId === null) {
-      getLogger().warn(
-        `[memory/topics] batch of ${batch.length} returned an unrecognized shape \u2014 will retry next sweep`
-      );
-      continue;
-    }
-    for (const m of batch) {
-      const entities = byId.get(m.id);
-      if (entities === void 0) {
-        continue;
-      }
-      out.set(m.id, redactor ? restoreEntities(entities, redactor) : entities);
-    }
-  }
-  return out;
-}
-function restoreEntities(entities, redactor) {
-  return entities.map((e) => ({ kind: e.kind, restored: redactor.restoreForStorage(e.name) })).filter((e) => !e.restored.unresolved).map(
-    (e) => e.kind !== void 0 ? { name: e.restored.text, kind: e.kind } : { name: e.restored.text }
-  );
-}
-function parseTopicResponse(parsed, validIds) {
-  if (typeof parsed !== "object" || parsed === null) return null;
-  const list = parsed.memories;
-  if (!Array.isArray(list)) return null;
-  const out = /* @__PURE__ */ new Map();
-  for (const raw of list) {
-    if (typeof raw !== "object" || raw === null) continue;
-    const obj = raw;
-    if (typeof obj.id !== "string") continue;
-    const id = obj.id.trim().replace(/:$/, "").replace(/^\[([\s\S]*)\]$/, "$1").trim();
-    if (!validIds.has(id) || out.has(id)) continue;
-    const entities = Array.isArray(obj.entities) ? parseEntities(obj.entities) : [];
-    out.set(id, entities);
-  }
-  return out;
-}
-var DEGRADED_TOPIC_SKIP = {
-  excluded: false,
-  "link-declined": false,
-  "stamp-declined": false,
-  "llm-unanswered": true,
-  unreadable: true,
-  "not-found": true,
-  "link-failed": true
-};
-function isDegradedTopicSkip(reason) {
-  return DEGRADED_TOPIC_SKIP[reason] === true;
-}
-async function extractAndLinkEntitiesForMemoriesOp(ctx, memoryIds, options) {
-  const entityCtx = ctx.entityCtx;
-  if (!entityCtx) {
-    throw new Error("extractAndLinkEntitiesForMemoriesOp requires ctx.entityCtx");
-  }
-  const log = getLogger();
-  const extractedAt = options.now ?? Date.now();
-  const skippedIds = [];
-  const skippedReasons = /* @__PURE__ */ new Map();
-  const skip = (id, reason) => {
-    if (skippedReasons.has(id)) return;
-    skippedIds.push(id);
-    skippedReasons.set(id, reason);
-  };
-  const inputs = [];
-  for (const id of new Set(memoryIds)) {
-    let record;
-    try {
-      record = await ctx.vaultMemoryCollection.find(id);
-    } catch (err) {
-      log.warn("[memory/topics] vault lookup failed for extraction", err);
-      skip(id, "not-found");
-      continue;
-    }
-    if (record.isDeleted || ctx.userId !== void 0 && record.userId !== ctx.userId || record.topicsUserManaged) {
-      skip(id, "excluded");
-      continue;
-    }
-    try {
-      const stored = await vaultMemoryToStored(
-        record,
-        ctx.walletAddress,
-        ctx.signMessage,
-        ctx.embeddedWalletSigner
-      );
-      inputs.push({ id, content: stored.content });
-    } catch (err) {
-      log.warn("[memory/topics] failed to load memory for extraction", err);
-      skip(id, "unreadable");
-    }
-  }
-  const entitiesByMemory = await extractEntitiesForMemories(inputs, options);
-  const toStamp = [];
-  for (const input of inputs) {
-    const entities = entitiesByMemory.get(input.id);
-    if (entities === void 0) {
-      skip(input.id, "llm-unanswered");
-      continue;
-    }
-    try {
-      const linked = await replaceMemoryEntitiesGuardedOp(entityCtx, input.id, entities);
-      if (linked === null) {
-        skip(input.id, "link-declined");
-        entitiesByMemory.delete(input.id);
-        continue;
-      }
-    } catch (err) {
-      log.warn("[memory/topics] replaceMemoryEntitiesGuardedOp failed", err);
-      skip(input.id, "link-failed");
-      entitiesByMemory.delete(input.id);
-      continue;
-    }
-    toStamp.push(input.id);
-  }
-  const stampedIds = await stampTopicsExtractedAtOp(ctx, toStamp, extractedAt);
-  const stampedSet = new Set(stampedIds);
-  for (const id of toStamp) {
-    if (!stampedSet.has(id)) {
-      skip(id, "stamp-declined");
-      entitiesByMemory.delete(id);
-    }
-  }
-  return { entitiesByMemory, stampedIds, skippedIds, skippedReasons };
-}
-
 // src/lib/memory/verifySupport.ts
 var DEFAULT_MODEL5 = "inclusionai/ling-2.6-flash";
 var DEFAULT_ATTEMPTS3 = 2;
@@ -30895,7 +31093,7 @@ async function assembleMemoryContext(options) {
 }
 
 // src/lib/memory/durableExtraction.ts
-var import_watermelondb24 = __toESM(require_watermelondb());
+var import_watermelondb25 = __toESM(require_watermelondb());
 var MAX_JOBS_PER_PASS = 3;
 var MAX_ATTEMPTS = 3;
 var MAX_FAILED_SESSIONS = 3;
@@ -31042,7 +31240,7 @@ function createDurableAutoExtractor(options) {
               ...options.retainCtx,
               vaultCtx: {
                 ...vault,
-                canWrite: async () => !disposed && !cancelled && await storage.conversationsCollection.query(import_watermelondb24.Q.where("conversation_id", conversationId), import_watermelondb24.Q.where("is_deleted", false)).fetchCount() > 0 && await storage.messagesCollection.query(import_watermelondb24.Q.where("conversation_id", conversationId), import_watermelondb24.Q.where("id", import_watermelondb24.Q.oneOf(ids))).fetchCount() === ids.length && (!vault.canWrite || await vault.canWrite()) && !disposed && !cancelled
+                canWrite: async () => !disposed && !cancelled && await storage.conversationsCollection.query(import_watermelondb25.Q.where("conversation_id", conversationId), import_watermelondb25.Q.where("is_deleted", false)).fetchCount() > 0 && await storage.messagesCollection.query(import_watermelondb25.Q.where("conversation_id", conversationId), import_watermelondb25.Q.where("id", import_watermelondb25.Q.oneOf(ids))).fetchCount() === ids.length && (!vault.canWrite || await vault.canWrite()) && !disposed && !cancelled
               }
             },
             // The model follows the job's scope, not the mode alive at drain time.
@@ -31184,7 +31382,7 @@ function createDurableAutoExtractor(options) {
     let scheduleAfterSuccess = false;
     try {
       await writes;
-      const pending = await jobs.query(import_watermelondb24.Q.where("owner_key", owner), import_watermelondb24.Q.where("message_ids", import_watermelondb24.Q.notEq("[]"))).fetch();
+      const pending = await jobs.query(import_watermelondb25.Q.where("owner_key", owner), import_watermelondb25.Q.where("message_ids", import_watermelondb25.Q.notEq("[]"))).fetch();
       storeFailures = 0;
       let processed = 0;
       for (const job of pending) {
@@ -31200,7 +31398,7 @@ function createDurableAutoExtractor(options) {
         let ids = [];
         let loaded = [];
         try {
-          const conversations = await storage.conversationsCollection.query(import_watermelondb24.Q.where("conversation_id", conversationId), import_watermelondb24.Q.where("is_deleted", false)).fetchCount();
+          const conversations = await storage.conversationsCollection.query(import_watermelondb25.Q.where("conversation_id", conversationId), import_watermelondb25.Q.where("is_deleted", false)).fetchCount();
           if (!conversations) {
             await database.write(() => job.destroyPermanently());
             continue;
@@ -31317,12 +31515,12 @@ function createDurableAutoExtractor(options) {
       const scope = currentScope();
       writes = writes.then(
         () => database.write(async () => {
-          const existing = await jobs.query(import_watermelondb24.Q.where("owner_key", owner), import_watermelondb24.Q.where("conversation_id", conversationId)).fetch();
+          const existing = await jobs.query(import_watermelondb25.Q.where("owner_key", owner), import_watermelondb25.Q.where("conversation_id", conversationId)).fetch();
           const job = existing.find(
             (candidate) => candidate._getRaw("scope") === scope && (candidate._getRaw("folder_id") ?? null) === folderId
           );
           const positions = new Map(ids.map((id, index) => [id, index]));
-          const rows = await storage.messagesCollection.query(import_watermelondb24.Q.where("id", import_watermelondb24.Q.oneOf(ids))).fetch();
+          const rows = await storage.messagesCollection.query(import_watermelondb25.Q.where("id", import_watermelondb25.Q.oneOf(ids))).fetch();
           const sequences = /* @__PURE__ */ new Map();
           for (const row of rows) {
             const sequence = Number(row._getRaw("message_id"));
@@ -37423,6 +37621,7 @@ export {
   createDurableAutoExtractor,
   createLlmDecayClassifier,
   createLlmNeighborRefiner,
+  createLocalMemoryStore,
   createMediaBatchOp,
   createMediaOp,
   createMemoryEngineTool,