@anuma/sdk 6.2.0 → 6.3.0

package/dist/server/index.cjs

@@ -17419,6 +17419,27 @@ var init_encryption2 = __esm({
   }
 });
 
+// src/lib/db/memoryVault/types.ts
+function parseMedia(value) {
+  if (typeof value !== "string" || value === "") return null;
+  try {
+    const parsed = JSON.parse(value);
+    if (!Array.isArray(parsed)) return null;
+    const refs = parsed.filter((r) => typeof r === "object" && r !== null).map((r) => ({
+      feedItemId: Number(r.feedItemId ?? r.feed_item_id),
+      objectKey: r.objectKey ?? r.object_key ?? null
+    })).filter((r) => Number.isFinite(r.feedItemId));
+    return refs.length > 0 ? refs : null;
+  } catch {
+    return null;
+  }
+}
+var init_types4 = __esm({
+  "src/lib/db/memoryVault/types.ts"() {
+    "use strict";
+  }
+});
+
 // src/lib/db/memoryVault/operations.ts
 function visibilityOrPrivate(value) {
   return value === "public" ? value : "private";
@@ -17480,6 +17501,7 @@ function vaultMemoryToStoredRaw(memory) {
     sourceChunkIds,
     proofCount: memory.proofCount ?? null,
     source: memory.source ?? null,
+    media: parseMedia(memory.media),
     eventTimeStart: memory.eventTimeStart ?? null,
     eventTimeEnd: memory.eventTimeEnd ?? null,
     eventTimeKind: memory.eventTimeKind ?? null,
@@ -17762,6 +17784,7 @@ function vaultMemoryRawToStoredRaw(raw) {
     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,
+    media: parseMedia(raw.media),
     topics: parseTopics(raw.topics),
     topicsUpdatedAt: raw.topics_updated_at ?? null,
     topicsExtractedAt: raw.topics_extracted_at ?? null,
@@ -18486,6 +18509,7 @@ var init_operations3 = __esm({
     init_operations2();
     init_types3();
     init_encryption2();
+    init_types4();
     NON_PRIVATE_VISIBILITIES = ["public"];
     KNOWN_TRUST_TIERS = /* @__PURE__ */ new Set(["quarantined", "trusted"]);
     TOPICS_EXTRACTION_VERSION = 3;
@@ -19997,17 +20021,17 @@ function recencyMultiplier(updatedAt, opts = {}) {
   const now = opts.now ?? /* @__PURE__ */ new Date();
   const nowMs2 = now.getTime();
   if (!Number.isFinite(nowMs2)) return noDate;
-  const ageDays2 = Math.max(0, (nowMs2 - updatedMs) / DAY_MS);
+  const ageDays2 = Math.max(0, (nowMs2 - updatedMs) / DAY_MS2);
   const perYearDecay = opts.perYearDecay ?? DEFAULT_PER_YEAR_DECAY;
   const floor = opts.floor ?? DEFAULT_FLOOR;
   const decay = perYearDecay * (ageDays2 / 365);
   return Math.max(floor, 1 - decay);
 }
-var DAY_MS, DEFAULT_PER_YEAR_DECAY, DEFAULT_FLOOR, DEFAULT_NO_DATE_MULTIPLIER;
+var DAY_MS2, DEFAULT_PER_YEAR_DECAY, DEFAULT_FLOOR, DEFAULT_NO_DATE_MULTIPLIER;
 var init_recency = __esm({
   "src/lib/memory/recency.ts"() {
     "use strict";
-    DAY_MS = 1e3 * 60 * 60 * 24;
+    DAY_MS2 = 1e3 * 60 * 60 * 24;
     DEFAULT_PER_YEAR_DECAY = 0.2;
     DEFAULT_FLOOR = 0.1;
     DEFAULT_NO_DATE_MULTIPLIER = 0.5;
@@ -20997,8 +21021,8 @@ function classifyObservationTrend(input, now = Date.now()) {
   const lastMsRaw = input.lastObservedAt;
   const lastMs = lastMsRaw !== null && lastMsRaw !== void 0 && Number.isFinite(lastMsRaw) ? Math.max(createdMs, lastMsRaw) : createdMs;
   const proofs = Math.max(1, input.proofCount ?? 1);
-  const ageDays2 = Math.max(0, (now - createdMs) / DAY_MS2);
-  const daysSinceLast = Math.max(0, (now - lastMs) / DAY_MS2);
+  const ageDays2 = Math.max(0, (now - createdMs) / DAY_MS3);
+  const daysSinceLast = Math.max(0, (now - lastMs) / DAY_MS3);
   if (daysSinceLast >= TREND_STALE_WINDOW_DAYS) return "stale";
   if (daysSinceLast >= TREND_RECENT_WINDOW_DAYS) return "weakening";
   if (ageDays2 <= TREND_RECENT_WINDOW_DAYS && proofs <= 2) return "new";
@@ -21019,11 +21043,11 @@ function summarizeObservationTrends(inputs, now = Date.now()) {
   }
   return counts;
 }
-var DAY_MS2, TREND_RECENT_WINDOW_DAYS, TREND_STALE_WINDOW_DAYS;
+var DAY_MS3, TREND_RECENT_WINDOW_DAYS, TREND_STALE_WINDOW_DAYS;
 var init_observationTrend = __esm({
   "src/lib/memory/observationTrend.ts"() {
     "use strict";
-    DAY_MS2 = 1e3 * 60 * 60 * 24;
+    DAY_MS3 = 1e3 * 60 * 60 * 24;
     TREND_RECENT_WINDOW_DAYS = 30;
     TREND_STALE_WINDOW_DAYS = 90;
   }
@@ -24039,6 +24063,7 @@ __export(index_exports, {
   hardDeleteMediaOp: () => hardDeleteMediaOp,
   hasEncryptionKey: () => hasEncryptionKey,
   hasKeyPair: () => hasKeyPair,
+  ingestPublishedPhotoMemoriesOp: () => ingestPublishedPhotoMemoriesOp,
   injectionSignatureCatalog: () => injectionSignatureCatalog,
   isRerankerAvailable: () => isRerankerAvailable,
   isSupportedFile: () => isSupportedFile,
@@ -24049,6 +24074,7 @@ __export(index_exports, {
   mediaToStored: () => mediaToStored,
   migrateFromModelPreferencesOp: () => migrateFromModelPreferencesOp,
   onKeyAvailable: () => onKeyAvailable,
+  parseMedia: () => parseMedia,
   preEmbedVaultMemories: () => preEmbedVaultMemories,
   preprocessFiles: () => preprocessFiles,
   progressiveSummarize: () => progressiveSummarize,
@@ -24456,6 +24482,9 @@ __decorateClass([
 __decorateClass([
   (0, import_decorators6.field)("topics_updated_at")
 ], VaultMemory.prototype, "topicsUpdatedAt", 2);
+__decorateClass([
+  (0, import_decorators6.field)("media")
+], VaultMemory.prototype, "media", 2);
 __decorateClass([
   (0, import_decorators6.field)("topics_extracted_at")
 ], VaultMemory.prototype, "topicsExtractedAt", 2);
@@ -24639,7 +24668,7 @@ __decorateClass([
 ], VaultFolder.prototype, "context", 2);
 
 // src/lib/db/schema.ts
-var SDK_SCHEMA_VERSION = 44;
+var SDK_SCHEMA_VERSION = 45;
 var sdkSchema = (0, import_watermelondb12.appSchema)({
   version: SDK_SCHEMA_VERSION,
   tables: [
@@ -24787,6 +24816,18 @@ var sdkSchema = (0, import_watermelondb12.appSchema)({
         // 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 },
+        // The photo(s) a SERVER-EXTRACTED memory was read out of, as a JSON
+        // array of `{feed_item_id, object_key}` — exactly what
+        // GET /api/memories/published returns in `media[]`. Enough to render the
+        // source image without a second round-trip per memory.
+        //
+        // A JSON column rather than a join table: nothing on the client ever
+        // queries BY photo (the only direction is memory -> render its image),
+        // so a table would add a sync lane and a local-id space to serve a
+        // question nobody asks. `topics` and `source_chunk_ids` set the
+        // precedent for a list that is only ever read back whole. Null on
+        // anything not extracted from a photo.
+        { name: "media", type: "string", 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).
@@ -25621,6 +25662,20 @@ var sdkMigrations = (0, import_migrations.schemaMigrations)({
           columns: [{ name: "origin", type: "string", isOptional: true }]
         })
       ]
+    },
+    // v44 -> v45: `media` on memory_vault — the photo(s) a server-extracted
+    // memory was read out of, as JSON `[{feed_item_id, object_key}]`, mirroring
+    // the `media[]` that GET /api/memories/published already returns. Existing
+    // rows keep NULL, which is the correct value for every memory that did not
+    // come from a photo (i.e. all of them until photo ingest runs).
+    {
+      toVersion: 45,
+      steps: [
+        (0, import_migrations.addColumns)({
+          table: "memory_vault",
+          columns: [{ name: "media", type: "string", isOptional: true }]
+        })
+      ]
     }
   ]
 });
@@ -26912,6 +26967,138 @@ async function cleanupConversationSummary(database, conversationId) {
 // src/lib/db/memoryVault/index.ts
 init_operations3();
 
+// src/lib/memory/decay.ts
+init_logger();
+var DAY_MS = 24 * 60 * 60 * 1e3;
+var SHORT_TTL_MS = 30 * DAY_MS;
+var MEDIUM_TTL_MS = 180 * DAY_MS;
+var SOURCE_PHOTO = "photo";
+var NEVER_TTL_MS = Number.POSITIVE_INFINITY;
+var HARD_DELETE_WINDOW_MS = 30 * DAY_MS;
+var PAST_EVENT_GRACE_MS = 7 * DAY_MS;
+var DEFAULT_DECAY_POLICY = {
+  ttlByType: {
+    identity: NEVER_TTL_MS,
+    preference: NEVER_TTL_MS,
+    relationship: NEVER_TTL_MS,
+    constraint: NEVER_TTL_MS,
+    plan: SHORT_TTL_MS,
+    ongoing_context: SHORT_TTL_MS,
+    other: MEDIUM_TTL_MS
+  },
+  fallbackTtlMs: MEDIUM_TTL_MS,
+  hardDeleteWindowMs: HARD_DELETE_WINDOW_MS,
+  pastEventGraceMs: PAST_EVENT_GRACE_MS
+};
+function resolvePolicy(policy) {
+  if (!policy) return DEFAULT_DECAY_POLICY;
+  return {
+    ttlByType: { ...DEFAULT_DECAY_POLICY.ttlByType, ...policy.ttlByType },
+    fallbackTtlMs: policy.fallbackTtlMs ?? DEFAULT_DECAY_POLICY.fallbackTtlMs,
+    hardDeleteWindowMs: policy.hardDeleteWindowMs ?? DEFAULT_DECAY_POLICY.hardDeleteWindowMs,
+    pastEventGraceMs: policy.pastEventGraceMs ?? DEFAULT_DECAY_POLICY.pastEventGraceMs
+  };
+}
+function ttlForType(factType, policy) {
+  const resolved = resolvePolicy(policy);
+  if (factType === null) return resolved.fallbackTtlMs;
+  return resolved.ttlByType[factType] ?? resolved.fallbackTtlMs;
+}
+function isTimeSensitiveType(factType) {
+  return factType === "plan" || factType === "ongoing_context";
+}
+function hasFiniteTimestamps(m, now) {
+  return Number.isFinite(now) && Number.isFinite(m.updatedAt) && (m.archivedAt === null || Number.isFinite(m.archivedAt));
+}
+function classifyDecay(m, now, policy) {
+  const resolved = resolvePolicy(policy);
+  if (!hasFiniteTimestamps(m, now)) {
+    getLogger().warn("[memory/decay] non-finite timestamp on a memory row; keeping it", {
+      now,
+      updatedAt: m.updatedAt,
+      archivedAt: m.archivedAt,
+      factType: m.factType
+    });
+    return "keep";
+  }
+  if (m.archivedAt !== null) {
+    return now - m.archivedAt > resolved.hardDeleteWindowMs ? "delete" : "keep";
+  }
+  if (m.source === "manual" || m.source === SOURCE_PHOTO) return "keep";
+  if (isTimeSensitiveType(m.factType) && m.eventTimeEnd !== null) {
+    if (m.eventTimeEnd < now - resolved.pastEventGraceMs) return "archive";
+    if (m.eventTimeEnd >= now) return "keep";
+  }
+  if (now - m.updatedAt > ttlForType(m.factType, resolved)) return "archive";
+  return "keep";
+}
+
+// src/lib/db/memoryVault/photoIngest.ts
+init_encryption2();
+var PHOTO_MEMORY_ID_PREFIX = "photo:";
+async function ingestPublishedPhotoMemoriesOp(ctx, rows) {
+  const byId = /* @__PURE__ */ new Map();
+  for (const r of rows) {
+    if (typeof r.memoryId !== "string" || !r.memoryId.startsWith(PHOTO_MEMORY_ID_PREFIX)) continue;
+    if (!byId.has(r.memoryId)) byId.set(r.memoryId, r);
+  }
+  const photoRows = [...byId.values()];
+  if (photoRows.length === 0) return { inserted: 0, skipped: 0 };
+  const known = await ctx.vaultMemoryCollection.query().fetchIds().then((ids) => new Set(ids));
+  const candidates = photoRows.filter((r) => !known.has(r.memoryId));
+  if (candidates.length === 0) return { inserted: 0, skipped: photoRows.length };
+  const fresh = candidates;
+  const contents = await Promise.all(
+    fresh.map(async (r) => {
+      if (ctx.walletAddress && ctx.signMessage) {
+        return encryptVaultMemoryContent(
+          r.text,
+          ctx.walletAddress,
+          ctx.signMessage,
+          ctx.embeddedWalletSigner
+        );
+      }
+      return r.text;
+    })
+  );
+  const now = Date.now();
+  let inserted = 0;
+  await ctx.database.write(async () => {
+    const present = new Set(await ctx.vaultMemoryCollection.query().fetchIds());
+    const writable = fresh.map((row, i) => ({ row, content: contents[i] })).filter(({ row }) => !present.has(row.memoryId));
+    inserted = writable.length;
+    if (writable.length === 0) return;
+    const prepared = writable.map(
+      ({ row, content }) => ctx.vaultMemoryCollection.prepareCreate((record) => {
+        record._raw.id = row.memoryId;
+        record._setRaw("content", content);
+        record._setRaw("scope", "private");
+        record._setRaw("folder_id", null);
+        record._setRaw("user_id", ctx.userId ?? null);
+        record._setRaw("is_deleted", false);
+        record._setRaw("proof_count", 1);
+        record._setRaw("source", SOURCE_PHOTO);
+        record._setRaw(
+          "media",
+          row.media && row.media.length > 0 ? JSON.stringify(row.media) : null
+        );
+        record._setRaw("visibility", "public");
+        record._setRaw("published_at", now);
+        if (row.eventTime) {
+          record._setRaw("event_time_start", row.eventTime.start ?? null);
+          record._setRaw("event_time_end", row.eventTime.end ?? null);
+          record._setRaw("event_time_kind", row.eventTime.kind ?? null);
+        }
+      })
+    );
+    await ctx.database.batch(...prepared);
+  });
+  return { inserted, skipped: photoRows.length - inserted };
+}
+
+// src/lib/db/memoryVault/index.ts
+init_types4();
+
 // src/lib/db/project/operations.ts
 var import_watermelondb18 = __toESM(require_watermelondb());
 init_operations();
@@ -29619,71 +29806,6 @@ function createChunkVectorCache(maxSize = DEFAULT_CHUNK_CACHE_SIZE) {
   return new LRUCache(maxSize);
 }
 
-// src/lib/memory/decay.ts
-init_logger();
-var DAY_MS3 = 24 * 60 * 60 * 1e3;
-var SHORT_TTL_MS = 30 * DAY_MS3;
-var MEDIUM_TTL_MS = 180 * DAY_MS3;
-var NEVER_TTL_MS = Number.POSITIVE_INFINITY;
-var HARD_DELETE_WINDOW_MS = 30 * DAY_MS3;
-var PAST_EVENT_GRACE_MS = 7 * DAY_MS3;
-var DEFAULT_DECAY_POLICY = {
-  ttlByType: {
-    identity: NEVER_TTL_MS,
-    preference: NEVER_TTL_MS,
-    relationship: NEVER_TTL_MS,
-    constraint: NEVER_TTL_MS,
-    plan: SHORT_TTL_MS,
-    ongoing_context: SHORT_TTL_MS,
-    other: MEDIUM_TTL_MS
-  },
-  fallbackTtlMs: MEDIUM_TTL_MS,
-  hardDeleteWindowMs: HARD_DELETE_WINDOW_MS,
-  pastEventGraceMs: PAST_EVENT_GRACE_MS
-};
-function resolvePolicy(policy) {
-  if (!policy) return DEFAULT_DECAY_POLICY;
-  return {
-    ttlByType: { ...DEFAULT_DECAY_POLICY.ttlByType, ...policy.ttlByType },
-    fallbackTtlMs: policy.fallbackTtlMs ?? DEFAULT_DECAY_POLICY.fallbackTtlMs,
-    hardDeleteWindowMs: policy.hardDeleteWindowMs ?? DEFAULT_DECAY_POLICY.hardDeleteWindowMs,
-    pastEventGraceMs: policy.pastEventGraceMs ?? DEFAULT_DECAY_POLICY.pastEventGraceMs
-  };
-}
-function ttlForType(factType, policy) {
-  const resolved = resolvePolicy(policy);
-  if (factType === null) return resolved.fallbackTtlMs;
-  return resolved.ttlByType[factType] ?? resolved.fallbackTtlMs;
-}
-function isTimeSensitiveType(factType) {
-  return factType === "plan" || factType === "ongoing_context";
-}
-function hasFiniteTimestamps(m, now) {
-  return Number.isFinite(now) && Number.isFinite(m.updatedAt) && (m.archivedAt === null || Number.isFinite(m.archivedAt));
-}
-function classifyDecay(m, now, policy) {
-  const resolved = resolvePolicy(policy);
-  if (!hasFiniteTimestamps(m, now)) {
-    getLogger().warn("[memory/decay] non-finite timestamp on a memory row; keeping it", {
-      now,
-      updatedAt: m.updatedAt,
-      archivedAt: m.archivedAt,
-      factType: m.factType
-    });
-    return "keep";
-  }
-  if (m.archivedAt !== null) {
-    return now - m.archivedAt > resolved.hardDeleteWindowMs ? "delete" : "keep";
-  }
-  if (m.source === "manual") return "keep";
-  if (isTimeSensitiveType(m.factType) && m.eventTimeEnd !== null) {
-    if (m.eventTimeEnd < now - resolved.pastEventGraceMs) return "archive";
-    if (m.eventTimeEnd >= now) return "keep";
-  }
-  if (now - m.updatedAt > ttlForType(m.factType, resolved)) return "archive";
-  return "keep";
-}
-
 // src/lib/memory/decayClassifier.ts
 init_logger();
 init_redactor();
@@ -29786,7 +29908,7 @@ function toDecayInput(c) {
   };
 }
 function isBorderline(input) {
-  if (input.source === "manual") return false;
+  if (input.source === "manual" || input.source === SOURCE_PHOTO) return false;
   if (input.trustTier === "quarantined") return false;
   if (input.archivedAt !== null) return false;
   if (input.factType === null || input.factType === "other") return true;
@@ -37106,6 +37228,7 @@ function buildSystemPrompt(ctx, options) {
   hardDeleteMediaOp,
   hasEncryptionKey,
   hasKeyPair,
+  ingestPublishedPhotoMemoriesOp,
   injectionSignatureCatalog,
   isRerankerAvailable,
   isSupportedFile,
@@ -37116,6 +37239,7 @@ function buildSystemPrompt(ctx, options) {
   mediaToStored,
   migrateFromModelPreferencesOp,
   onKeyAvailable,
+  parseMedia,
   preEmbedVaultMemories,
   preprocessFiles,
   progressiveSummarize,

package/dist/server/index.d.mts

@@ -103,8 +103,11 @@ import { ResultCallback } from '@nozbe/watermelondb/utils/fp/Result';
  *   unreadable flag would fail open. Existing rows stay NULL (= legacy,
  *   unknown provenance, embedded as before) with no backfill, matching the v37
  *   read-time-fallback precedent
+ * - v45: Added `media` to memory_vault — the photo(s) a server-extracted
+ *   memory came from, as JSON `[{feed_item_id, object_key}]`. Null on every
+ *   row that did not come from a photo, which is all of them before this
  */
-declare const SDK_SCHEMA_VERSION = 44;
+declare const SDK_SCHEMA_VERSION = 45;
 /**
  * Combined WatermelonDB schema for all SDK storage modules.
  *
@@ -4524,6 +4527,10 @@ declare class VaultMemory extends Model$1 {
     /** Unix ms of the last `topics` write. Separate from `updated_at`, which every
      *  topic writer pins on purpose (recall recency) — see the schema note. */
     topicsUpdatedAt: number | null;
+    /** The photo(s) a SERVER-EXTRACTED memory came from — JSON
+     *  `[{feed_item_id, object_key}]`, exactly the shape
+     *  GET /api/memories/published returns. Null on anything not from a photo. */
+    media: string | null;
     /** Unix ms of the last LLM topic-extraction pass. Null = never extracted
      *  standalone (linked legacy rows are grandfathered as extracted).
      *  DEPRECATED (v42) — subsumed by `topics_updated_at`; see the schema note. */
@@ -5999,8 +6006,16 @@ interface StoredVaultMemory {
     sourceChunkIds: string[] | null;
     /** Times this fact has been re-observed (for ranking + UX badges). */
     proofCount: number | null;
-    /** How the memory was created: manual | auto-extracted | capsule. */
+    /** How the memory was created: manual | auto-extracted | capsule | photo. */
     source: string | null;
+    /** The photo(s) a SERVER-EXTRACTED memory was read out of. Null on every
+     * memory that did not come from a photo. See {@link PhotoMediaRef}.
+     *
+     * OPTIONAL rather than required: every read path sets it (the row mappers
+     * always call parseMedia), but making it required would be a compile-break
+     * for any caller that CONSTRUCTS a StoredVaultMemory — fixtures, mocks, and
+     * anything downstream — for a field that is null on all but photo rows. */
+    media?: PhotoMediaRef[] | null;
     /** W6 temporal lane — Unix ms when the event occurred (point/start of range). */
     eventTimeStart: number | null;
     /** W6 temporal lane — Unix ms when the event ended (range only). */
@@ -6059,6 +6074,26 @@ interface StoredVaultMemory {
     updatedAt: Date;
     isDeleted: boolean;
 }
+/**
+ * A photo a server-extracted memory came from, as
+ * GET /api/memories/published returns it in `media[]`.
+ *
+ * Both identifiers travel because both are needed: `feedItemId` is the server's
+ * handle for the photo, and `objectKey` is what a client turns into a CDN URL
+ * without another round-trip per memory.
+ */
+interface PhotoMediaRef {
+    feedItemId: number;
+    objectKey: string | null;
+}
+/**
+ * Decode the stored `media` column. Returns null for "no photo behind this
+ * memory" (the column is null on every non-photo row) and tolerates a corrupt
+ * or unexpected payload by reading it as null too — a memory whose photo
+ * reference cannot be parsed is still a perfectly good memory, and losing the
+ * thumbnail is a better failure than losing the row.
+ */
+declare function parseMedia(value: unknown): PhotoMediaRef[] | null;
 interface CreateVaultMemoryOptions {
     content: string;
     /** Scope for the memory. Defaults to "private" if omitted. */
@@ -6500,6 +6535,95 @@ declare function hardDeleteDecayedOp(ctx: VaultMemoryOperationsContext, id: stri
 }): Promise<boolean>;
 declare function updateVaultMemoryEmbeddingOp(ctx: VaultMemoryOperationsContext, id: string, embedding: string, embeddingModel: string): Promise<boolean>;
 
+/**
+ * Ingest server-extracted photo memories into the local vault.
+ *
+ * A photo uploaded to People Nearby is read by the server, which extracts
+ * durable facts about the user, embeds them and publishes them
+ * (anuma-ai/nearby#114). Until those rows reach the device they exist only
+ * server-side: the user's own assistant cannot recall them, and no screen can
+ * show them — so the "visible and deletable" promise the design makes is not
+ * kept. This is the path that brings them home.
+ *
+ * Three things about the shape of this, each of which is load-bearing:
+ *
+ *  1. **It takes rows; it does not fetch them.** The publish reconciler already
+ *     calls `listPublished()` on every pass and gets `text`, `media[]`,
+ *     `event_time` and `user_authored` back. Ingest consumes that response. No
+ *     new endpoint, no second network call, no change to nearby's API.
+ *
+ *  2. **The vault row's id IS the server's `memory_id`.** That is what makes a
+ *     revoke addressable: the reconciler's ledger, its published set and its
+ *     `toRevoke` list are all keyed on that id, so a locally-minted id would
+ *     leave the user with a switch that cannot reach the row it appears to
+ *     control. It is also what makes ingest idempotent for free — a second pass
+ *     sees the id already present and writes nothing.
+ *
+ *  3. **These rows never go through `retain()`.** That path is for facts being
+ *     learned on-device: it dedupes and merges candidates against local rows and
+ *     mints its own ids, both of which would break (2). A photo memory is not a
+ *     candidate to be reconciled against the vault — it is an already-decided
+ *     fact the server has published.
+ *
+ * The rows are written `visibility: "public"` because they genuinely ARE
+ * published — the reconciler reads local visibility as the user's intent, and
+ * anything else would make it immediately revoke a memory the user never turned
+ * off. They carry `source: SOURCE_PHOTO`, which is what exempts them from
+ * decay's auto-archive; see the note there for why archiving one would silently
+ * unpublish it.
+ *
+ * No embedding is computed here. `searchTool`'s un-embedded lane embeds any row
+ * lacking a vector at search time, uses it in that same search and persists it
+ * via `updateVaultMemoryEmbeddingOp` — so a row ingested without one is picked
+ * up on first recall rather than costing an embedding call at ingest.
+ */
+
+/**
+ * One row of `GET /api/memories/published`, narrowed to what ingest needs.
+ *
+ * Deliberately structural rather than an import from the transport client: this
+ * op is in the SDK and the two hand-written nearby clients live in the app, so
+ * a shared nominal type would drag one across a package boundary for no gain.
+ */
+interface PublishedPhotoMemory {
+    /** The server-minted memory id. `photo:<feedItemID>:fact:NN` or `:caption`. */
+    memoryId: string;
+    /** The projected fact text. */
+    text: string;
+    /** The photo(s) this fact was read out of. */
+    media?: PhotoMediaRef[] | null;
+    /** When the event in the memory happened, if the server knows. */
+    eventTime?: {
+        start: number | null;
+        end: number | null;
+        kind: "point" | "range" | "ongoing" | null;
+    } | null;
+    /** True when the text is the user's own words (a kept caption). */
+    userAuthored?: boolean;
+}
+/** What one ingest pass did, for the caller's logs and tests. */
+interface PhotoIngestResult {
+    /** Rows newly written to the vault. */
+    inserted: number;
+    /** Rows already present, left untouched. */
+    skipped: number;
+}
+/**
+ * Write the published photo memories this vault does not already have.
+ *
+ * Idempotent on `memoryId`: a row whose id is already in the vault is counted as
+ * skipped and NOT rewritten, even when the server's text has since changed.
+ * That is deliberate — the local row is the user's copy, they may have edited
+ * it, and silently overwriting an edit to match the server would be the same
+ * class of bug as publishing a version the user has since changed. Re-ingesting
+ * changed text is a follow-up that needs a merge decision, not a clobber.
+ *
+ * Non-`photo:` ids are ignored: everything else in the published set is a
+ * client-published memory that by definition already lives in this vault (or in
+ * another device's, which is not ours to recreate).
+ */
+declare function ingestPublishedPhotoMemoriesOp(ctx: VaultMemoryOperationsContext, rows: PublishedPhotoMemory[]): Promise<PhotoIngestResult>;
+
 declare class Project extends Model$1 {
     static table: string;
     static associations: Associations;
@@ -7703,6 +7827,15 @@ declare function createChunkVectorCache(maxSize?: number): ChunkVectorCache;
  * shared purge buffer for every row, so an already-archived manual memory is
  * still deleted after the window (the archived check runs before the manual
  * short-circuit by design).
+ *
+ * `source === "photo"` (server-extracted photo memories) is protected the same
+ * way, and for a sharper reason than curation: those rows are PUBLISHED, and
+ * auto-archiving one would silently un-publish it. Archived rows drop out of the
+ * default vault read, the publish reconciler builds its desired set from that
+ * read, and anything it previously adopted but no longer sees goes into
+ * `toRevoke` — so an age-archive at the medium TTL would revoke a memory from
+ * the server that the user never switched off. Revoking is the user's decision
+ * and has exactly one entry point: the publish switch.
  */
 /** The verdict for a single memory. */
 type DecayVerdict = "keep" | "archive" | "delete";
@@ -10069,4 +10202,4 @@ declare function sanitizeQuotes(s: string): string;
 declare function renderTemplate(value: string | null | undefined, template: string): string | null;
 declare function buildSystemPrompt(ctx: PromptContext, options?: BuildPromptOptions): BuildPromptResult;
 
-export { type AnalyzeStyleOptions, type AnalyzeStyleResult, type ApiResponse, type ApiType, type AutoExecutedToolResult, type AutoExtractMessage, type AutoExtractor, type Budget, type BuildPromptOptions, type BuildPromptResult, type CachedChunkVectors, type CachedServerTools, type ChatCompletionUsage, type ChatRole, type ChunkSearchResult, type ChunkVectorCache, type ChunkingOptions, type ConnectorGuidance, type ConnectorGuidanceInput, type ConsolidationFallbackReason, Conversation, ConversationSummary, type CreateAutoExtractorOptions, type CreateConversationOptions, type CreateDecaySweeperOptions, type CreateMediaOptions, type CreateMessageOptions, type CreateModelPreferenceOptions, type CreateProjectOptions, type CreateUserPreferenceOptions, type CreateVaultMemoryOptions, type CryptoPriceClassification, type CryptoPricePreProcessorOptions, DEFAULT_ANALYSIS_PROMPT, DEFAULT_ANALYZE_AFTER_MESSAGES, DEFAULT_CACHE_EXPIRATION_MS, DEFAULT_CHUNK_CACHE_SIZE, DEFAULT_CHUNK_OVERLAP, DEFAULT_CHUNK_SIZE, DEFAULT_DECAY_POLICY, DEFAULT_DOCUMENT_PATTERN, DEFAULT_EXCLUDED_SERVER_TOOLS, DEFAULT_MAX_CLASSIFIER_CALLS_PER_SWEEP, DEFAULT_MAX_INPUT_MESSAGES, DEFAULT_MAX_PROFILE_LENGTH, DEFAULT_MIN_CHUNK_SIZE, DEFAULT_MIN_MESSAGES, DEFAULT_PERSONALITY_SETTINGS, DEFAULT_PROFILE_FACETS, DEFAULT_PROFILE_FACT_TYPE_WEIGHTS, DEFAULT_PROFILE_PROOF_ALPHA, DEFAULT_PROFILE_TREND_MULTIPLIERS, DEFAULT_PROMPT_TEMPLATES, DEFAULT_REFRESH_EVERY_MESSAGES, DEFAULT_SERVER_TOOLS_MATCH_OPTIONS, DEFAULT_SUMMARY_MIN_WINDOW_MESSAGES, DEFAULT_SUMMARY_MODEL, DEFAULT_SUMMARY_TOKEN_THRESHOLD, DEFAULT_VAULT_CACHE_SIZE, DatabaseManager, type DatabaseManagerLogger, type DatabaseManagerOptions, type DecayCandidateRaw, type DecayClassifier, type DecayInput, type DecayPolicy, type DecaySweepResult, type DecaySweeper, type DecayVerdict, ENTITY_FANOUT, type EmbeddedWalletSignerFn, EncryptionKeyMissingError, ExcelProcessor, type ExtractFactsOptions, type ExtractOutcome, type ExtractedCandidate, type ExtractedEntity, type ExtractionCursorStore, type FactType, type FileMetadata, type FileProcessor, type FileTypeQuery, type FileWithData, type FlushResult, type GetConversationsPageOptions, type GraphTraversalOptions, HARD_DELETE_WINDOW_MS, INFERENCE_ID_HEADER, type InjectionClassifierOptions, type InjectionReason, type LazyStoredConversation, type LlmDecayClassifierOptions, type LlmNeighborRefinerOptions, type LlmTokenUsage, MAX_HOPS, MAX_MESSAGES_PER_SUMMARIZATION, MEDIUM_TTL_MS, Media, type MediaDimensions, type MediaFilterOptions, type MediaMetadata, type MediaOperationsContext, type MediaRole, type MediaType, type MemoriesNeedingTopicExtraction, type EmbeddingOptions as MemoryEngineEmbeddingOptions, type MemoryEngineResult, type MemoryEngineSearchOptions, type MemoryExtractedEvent, type MemoryKind, type MemoryQuarantinedEvent, type MemoryToVerify, type MemoryVaultSearchOptions, type MemoryVaultToolOptions, type MemoryVerification, Message, type MessageChunk, type MessageFeedback, type MessageOrigin, type ModelCallEndEvent, type ModelCallStartEvent, ModelPreference, NEVER_TTL_MS, NODE_BUDGET, type NeighborRefiner, type NowSource, type ObservationTrend, type ObservationTrendInput, type OperationExecutor, PAST_EVENT_GRACE_MS, PROFILE_DOC_VERSION, type ParsedServerToolsResponse, PdfProcessor, type PersonalitySettings, type PersonalitySliders, type PersonalityStyle, type PgClientLike, type PgPoolLike, type PlatformStorage, type PortalLlmAuth, PostgreSQLAdapter, type PostgreSQLAdapterOptions, type PreprocessingOptions, type PreprocessingResult, type ProcessedFileResult, ProcessorRegistry, type ProfileConfigFingerprint, type ProfileDoc, type ProfileFacet, type ProfileFacetKey, type ProfileSalienceInput, type ProfileSection, type ProfileUpdate, Project, type ProjectOperationsContext, type PromptContext, type PromptPreProcessor, type PromptPreProcessorContext, type PromptSection, type PromptTemplates, type QuarantinedMemoryInfo, type QueueEncryptionContext, QueueManager, type QueueStatus, type QueuedOperation, type QueuedOperationType, RECALL_MAX_LIMIT, RECALL_TOOL_NAME, type RankedMemory, type RankedProfileCandidate, type RecallContext, type RecallDegradation, type RecallDiagnostics, type RecallOptions, type RecallResult, type RecallToolCallbacks, type RecallToolOptions, type RecencyOptions, type ReflectOptions, type ReflectResult, type RequestEncryptionKeyOptions, RerankerUnavailableError, type ResumeStreamOptions, type ResumeStreamResult, type RetainAction, type RetainContext, type RetainOptions, type RetainResult, type RetainSource, type RunEndEvent, type RunErrorEvent, type RunHooks, type RunStartEvent, type RunTerminalState, type RunToolLoopOptions, type RunToolLoopResult, SDK_SCHEMA_VERSION, SERVER_TOOL_DEPENDENCY_SETS, SHORT_TTL_MS, SLIDER_CONFIG, STREAM_RESUMABLE_HEADER, type ScoreBreakdown, type ScoreProfileSalienceOptions, type ScreenResult, type ScreenedCandidate, type SearchSource, type SelectServerToolsForPromptOptions, type ServerTool, type ServerToolCallEvent, type ServerToolsFilterFunction, type ServerToolsOptions, type ServerToolsResponse, type SettingsStorageOperationsContext, type SignMessageFn, type StepFinishEvent, type StockPriceClassification, type StockPricePreProcessorOptions, type StorageOperationsContext, type StoredConversation, type StoredConversationSummary, type StoredFileWithContext, type StoredMedia, type StoredMessage, type StoredMessageWithSimilarity, type StoredModelPreference, type StoredProject, type StoredUserPreference, type StoredVaultMemory, StreamExpiredError, type StreamMetaEvent, type StreamResumeHandle, type StreamSmoothingConfig, type StreamingTransport, type StreamingTransportOptions, type StreamingTransportResult, type StyleAnalysisSchedule, type SynthesizeProfileOptions, TOOL_CATALOG, TOPICS_EXTRACTION_VERSION, TOPIC_EXTRACTION_BATCH_SIZE, TREND_RECENT_WINDOW_DAYS, TREND_STALE_WINDOW_DAYS, type TextChunk, TextProcessor, type ToolConfig, type ToolExecutor, type ToolMatchOptions, type ToolMatchResult, type ToolSet, type ToolUseEndEvent, type ToolUseStartEvent, type TopicExtractOptions, type TopicExtractionInput, type TopicExtractionRunResult, type TurnCompleteEvent, type TurnSkippedEvent, type UncheckedReason, type UnverifiableReason, type UpdateMediaOptions, type UpdateModelPreferenceOptions, type UpdateProjectOptions, type UpdateUserPreferenceOptions, type UpdateVaultMemoryOptions, UserPreference, type UserPreferencesStorageOperationsContext, VAULT_SIZE_HOP_CAP, type VaultEmbeddingCache, VaultMemory, type VaultMemoryOperationsContext, type VaultMemoryVisibility, type VaultSaveOperation, type VaultSearchResult, type VerificationSources, type VerifyMemoriesForPublishOptions, WalletPoller, type WeatherClassification, type WeatherPreProcessorOptions, type WebSearchClassification, type WebSearchPreProcessorOptions, WordProcessor, ZipProcessor, type ZipProcessorOptions, activatedToolSetNames, analyzeStyle, archiveVaultMemoryOp, backfillMemoryTopicsOp, buildConnectorGuidance, buildDeniedToolsRider, buildSystemPrompt, capHopsForDensity, chunkAndEmbedAllMessages, chunkAndEmbedMessage, chunkText, classifyCryptoPrice, classifyCryptoPriceBatch, classifyDecay, classifyInjectionCandidates, classifyObservationTrend, classifyStockPrice, classifyStockPriceBatch, classifyWeather, classifyWeatherBatch, classifyWebSearch, classifyWebSearchBatch, cleanupConversationSummary, clearAllEncryptionKeys, clearAllEncryptionState, clearAllKeyPairs, clearEncryptionKey, clearKeyPair, clearLazyTitleCache, clearMessagesOp, clearServerToolsCache, composeHooks, createAutoExtractor, createChunkVectorCache, createConversationOp, createCryptoPricePreProcessor, createDecaySweeper, createLlmDecayClassifier, createLlmNeighborRefiner, createMediaBatchOp, createMediaOp, createMemoryEngineTool, createMemoryVaultSearchTool, createMemoryVaultTool, createMessageOp, createMessageSourceResolver, createPlatformCursorStore, createProjectOp, createRecallTool, createServerToolsFilter, createStockPricePreProcessor, createSummaryContext, createVaultEmbeddingCache, createVaultMemoriesBatchOp, createVaultMemoryOp, createWeatherPreProcessor, createWebSearchPreProcessor, decryptConversationTitle, decryptData, decryptDataBatch, decryptDataBytes, decryptDataBytesFromBytes, decryptDataWithKey, defaultServerToolsFilter, deleteAllVaultMemoriesForUserOp, deleteConversationOp, deleteConversationSummaryOp, deleteMediaByConversationOp, deleteMediaByMessageOp, deleteMediaOp, deleteModelPreferenceOp, deleteProjectOp, deleteUserPreferenceOp, deleteVaultMemoryOp, eagerEmbedContent, embedAllMessages, embedMessage, encryptData, encryptDataBatch, encryptDataBytes, encryptDataWithKey, estimateMessagesTokens, estimateTokens, exportPublicKey, extractAndLinkEntitiesForMemoriesOp, extractAndRetain, extractEntitiesForMemories, extractFacts, findMatchingTools, generateConversationId, generateEmbedding, generateEmbeddings, generateMediaId, generateProjectId, getAIGeneratedMediaOp, getAllFilesOp, getAllVaultMemoriesOp, getAllVaultMemoryContentsOp, getAudioOp, getCachedServerTools, getConversationOp, getConversationSummaryOp, getConversationsByProjectLazyOp, getConversationsByProjectOp, getConversationsLazyOp, getConversationsOp, getConversationsPageOp, getDecayCandidatesRawOp, getDocumentsOp, getEncryptionKey, getImagesOp, getMediaByConversationOp, getMediaByIdOp, getMediaByIdsOp, getMediaByMessageOp, getMediaByModelOp, getMediaByRoleOp, getMediaBySourceUrlOp, getMediaByTypeOp, getMediaCountOp, getMediaCountsByTypeOp, getMediaOp, getMediaTypeFromMime, getMemoriesNeedingTopicExtractionOp, getMessageOp, getMessagesOp, getModelPreferenceOp, getProjectConversationCountOp, getProjectConversationsOp, getProjectOp, getProjectsOp, getRecentMediaOp, getServerTools, getSupportedFileTypes, getToolsChecksum, getUnfiledVaultMemoriesOp, getUserPreferenceOp, getUserUploadedMediaOp, getVaultMemoryOp, getVideosOp, hardDeleteDecayedOp, hardDeleteMediaOp, hasEncryptionKey, hasKeyPair, injectionSignatureCatalog, isRerankerAvailable, isSupportedFile, isSupportedMediaType, makeSyntheticStoredConversation, makeSyntheticStoredMessage, maybeSummarizeHistory, mediaToStored, migrateFromModelPreferencesOp, onKeyAvailable, preEmbedVaultMemories, preprocessFiles, progressiveSummarize, projectToStored, queueManager, rankProfileCandidates, recall, reflect, refreshEncryptionKeyIfMatches, relinkMemoryTopicsOp, relinkMisclassifiedVideosOp, renderTemplate, requestEncryptionKey, requestKeyPair, restoreVaultMemoryOp, resumeStream, retain, runToolLoop, sanitizeQuotes, schemaToCreateSQL, scoreProfileSalience, screenCandidatesForInjection, sdkMigrations, sdkModelClasses, sdkSchema, searchChunksOp, searchMediaOp, searchMessagesOp, searchVaultMemories, seedEncryptionKeys, selectServerToolsForPrompt, serverPlatformStorage, setMemoryVisibilityOp, setModelPreferenceOp, setUserPreferenceOp, shouldAnalyzeStyle, shouldChunkMessage, shouldRefreshTools, splitMessagesAtThreshold, stampTopicsExtractedAtOp, streamCancelPath, streamReplayPath, summarizeObservationTrends, summaryToSystemMessage, supersedeVaultMemoryOp, synthesizeProfile, toolSetSystemPrompts, traverseGraphLane, ttlForType, updateConversationProjectOp, updateConversationTitleOp, updateMediaMessageIdBatchOp, updateMediaOp, updateMessageChunksOp, updateMessageEmbeddingOp, updateMessageErrorOp, updateMessageFeedbackOp, updateModelsOp, updatePersonalityOp, updateProfileOp, updateProjectNameOp, updateProjectOp, updateVaultMemoryEmbeddingOp, updateVaultMemoryOp, upsertConversationSummaryOp, upsertMessageOp, verifyMemoriesForPublish };
+export { type AnalyzeStyleOptions, type AnalyzeStyleResult, type ApiResponse, type ApiType, type AutoExecutedToolResult, type AutoExtractMessage, type AutoExtractor, type Budget, type BuildPromptOptions, type BuildPromptResult, type CachedChunkVectors, type CachedServerTools, type ChatCompletionUsage, type ChatRole, type ChunkSearchResult, type ChunkVectorCache, type ChunkingOptions, type ConnectorGuidance, type ConnectorGuidanceInput, type ConsolidationFallbackReason, Conversation, ConversationSummary, type CreateAutoExtractorOptions, type CreateConversationOptions, type CreateDecaySweeperOptions, type CreateMediaOptions, type CreateMessageOptions, type CreateModelPreferenceOptions, type CreateProjectOptions, type CreateUserPreferenceOptions, type CreateVaultMemoryOptions, type CryptoPriceClassification, type CryptoPricePreProcessorOptions, DEFAULT_ANALYSIS_PROMPT, DEFAULT_ANALYZE_AFTER_MESSAGES, DEFAULT_CACHE_EXPIRATION_MS, DEFAULT_CHUNK_CACHE_SIZE, DEFAULT_CHUNK_OVERLAP, DEFAULT_CHUNK_SIZE, DEFAULT_DECAY_POLICY, DEFAULT_DOCUMENT_PATTERN, DEFAULT_EXCLUDED_SERVER_TOOLS, DEFAULT_MAX_CLASSIFIER_CALLS_PER_SWEEP, DEFAULT_MAX_INPUT_MESSAGES, DEFAULT_MAX_PROFILE_LENGTH, DEFAULT_MIN_CHUNK_SIZE, DEFAULT_MIN_MESSAGES, DEFAULT_PERSONALITY_SETTINGS, DEFAULT_PROFILE_FACETS, DEFAULT_PROFILE_FACT_TYPE_WEIGHTS, DEFAULT_PROFILE_PROOF_ALPHA, DEFAULT_PROFILE_TREND_MULTIPLIERS, DEFAULT_PROMPT_TEMPLATES, DEFAULT_REFRESH_EVERY_MESSAGES, DEFAULT_SERVER_TOOLS_MATCH_OPTIONS, DEFAULT_SUMMARY_MIN_WINDOW_MESSAGES, DEFAULT_SUMMARY_MODEL, DEFAULT_SUMMARY_TOKEN_THRESHOLD, DEFAULT_VAULT_CACHE_SIZE, DatabaseManager, type DatabaseManagerLogger, type DatabaseManagerOptions, type DecayCandidateRaw, type DecayClassifier, type DecayInput, type DecayPolicy, type DecaySweepResult, type DecaySweeper, type DecayVerdict, ENTITY_FANOUT, type EmbeddedWalletSignerFn, EncryptionKeyMissingError, ExcelProcessor, type ExtractFactsOptions, type ExtractOutcome, type ExtractedCandidate, type ExtractedEntity, type ExtractionCursorStore, type FactType, type FileMetadata, type FileProcessor, type FileTypeQuery, type FileWithData, type FlushResult, type GetConversationsPageOptions, type GraphTraversalOptions, HARD_DELETE_WINDOW_MS, INFERENCE_ID_HEADER, type InjectionClassifierOptions, type InjectionReason, type LazyStoredConversation, type LlmDecayClassifierOptions, type LlmNeighborRefinerOptions, type LlmTokenUsage, MAX_HOPS, MAX_MESSAGES_PER_SUMMARIZATION, MEDIUM_TTL_MS, Media, type MediaDimensions, type MediaFilterOptions, type MediaMetadata, type MediaOperationsContext, type MediaRole, type MediaType, type MemoriesNeedingTopicExtraction, type EmbeddingOptions as MemoryEngineEmbeddingOptions, type MemoryEngineResult, type MemoryEngineSearchOptions, type MemoryExtractedEvent, type MemoryKind, type MemoryQuarantinedEvent, type MemoryToVerify, type MemoryVaultSearchOptions, type MemoryVaultToolOptions, type MemoryVerification, Message, type MessageChunk, type MessageFeedback, type MessageOrigin, type ModelCallEndEvent, type ModelCallStartEvent, ModelPreference, NEVER_TTL_MS, NODE_BUDGET, type NeighborRefiner, type NowSource, type ObservationTrend, type ObservationTrendInput, type OperationExecutor, PAST_EVENT_GRACE_MS, PROFILE_DOC_VERSION, type ParsedServerToolsResponse, PdfProcessor, type PersonalitySettings, type PersonalitySliders, type PersonalityStyle, type PgClientLike, type PgPoolLike, type PhotoIngestResult, type PhotoMediaRef, type PlatformStorage, type PortalLlmAuth, PostgreSQLAdapter, type PostgreSQLAdapterOptions, type PreprocessingOptions, type PreprocessingResult, type ProcessedFileResult, ProcessorRegistry, type ProfileConfigFingerprint, type ProfileDoc, type ProfileFacet, type ProfileFacetKey, type ProfileSalienceInput, type ProfileSection, type ProfileUpdate, Project, type ProjectOperationsContext, type PromptContext, type PromptPreProcessor, type PromptPreProcessorContext, type PromptSection, type PromptTemplates, type PublishedPhotoMemory, type QuarantinedMemoryInfo, type QueueEncryptionContext, QueueManager, type QueueStatus, type QueuedOperation, type QueuedOperationType, RECALL_MAX_LIMIT, RECALL_TOOL_NAME, type RankedMemory, type RankedProfileCandidate, type RecallContext, type RecallDegradation, type RecallDiagnostics, type RecallOptions, type RecallResult, type RecallToolCallbacks, type RecallToolOptions, type RecencyOptions, type ReflectOptions, type ReflectResult, type RequestEncryptionKeyOptions, RerankerUnavailableError, type ResumeStreamOptions, type ResumeStreamResult, type RetainAction, type RetainContext, type RetainOptions, type RetainResult, type RetainSource, type RunEndEvent, type RunErrorEvent, type RunHooks, type RunStartEvent, type RunTerminalState, type RunToolLoopOptions, type RunToolLoopResult, SDK_SCHEMA_VERSION, SERVER_TOOL_DEPENDENCY_SETS, SHORT_TTL_MS, SLIDER_CONFIG, STREAM_RESUMABLE_HEADER, type ScoreBreakdown, type ScoreProfileSalienceOptions, type ScreenResult, type ScreenedCandidate, type SearchSource, type SelectServerToolsForPromptOptions, type ServerTool, type ServerToolCallEvent, type ServerToolsFilterFunction, type ServerToolsOptions, type ServerToolsResponse, type SettingsStorageOperationsContext, type SignMessageFn, type StepFinishEvent, type StockPriceClassification, type StockPricePreProcessorOptions, type StorageOperationsContext, type StoredConversation, type StoredConversationSummary, type StoredFileWithContext, type StoredMedia, type StoredMessage, type StoredMessageWithSimilarity, type StoredModelPreference, type StoredProject, type StoredUserPreference, type StoredVaultMemory, StreamExpiredError, type StreamMetaEvent, type StreamResumeHandle, type StreamSmoothingConfig, type StreamingTransport, type StreamingTransportOptions, type StreamingTransportResult, type StyleAnalysisSchedule, type SynthesizeProfileOptions, TOOL_CATALOG, TOPICS_EXTRACTION_VERSION, TOPIC_EXTRACTION_BATCH_SIZE, TREND_RECENT_WINDOW_DAYS, TREND_STALE_WINDOW_DAYS, type TextChunk, TextProcessor, type ToolConfig, type ToolExecutor, type ToolMatchOptions, type ToolMatchResult, type ToolSet, type ToolUseEndEvent, type ToolUseStartEvent, type TopicExtractOptions, type TopicExtractionInput, type TopicExtractionRunResult, type TurnCompleteEvent, type TurnSkippedEvent, type UncheckedReason, type UnverifiableReason, type UpdateMediaOptions, type UpdateModelPreferenceOptions, type UpdateProjectOptions, type UpdateUserPreferenceOptions, type UpdateVaultMemoryOptions, UserPreference, type UserPreferencesStorageOperationsContext, VAULT_SIZE_HOP_CAP, type VaultEmbeddingCache, VaultMemory, type VaultMemoryOperationsContext, type VaultMemoryVisibility, type VaultSaveOperation, type VaultSearchResult, type VerificationSources, type VerifyMemoriesForPublishOptions, WalletPoller, type WeatherClassification, type WeatherPreProcessorOptions, type WebSearchClassification, type WebSearchPreProcessorOptions, WordProcessor, ZipProcessor, type ZipProcessorOptions, activatedToolSetNames, analyzeStyle, archiveVaultMemoryOp, backfillMemoryTopicsOp, buildConnectorGuidance, buildDeniedToolsRider, buildSystemPrompt, capHopsForDensity, chunkAndEmbedAllMessages, chunkAndEmbedMessage, chunkText, classifyCryptoPrice, classifyCryptoPriceBatch, classifyDecay, classifyInjectionCandidates, classifyObservationTrend, classifyStockPrice, classifyStockPriceBatch, classifyWeather, classifyWeatherBatch, classifyWebSearch, classifyWebSearchBatch, cleanupConversationSummary, clearAllEncryptionKeys, clearAllEncryptionState, clearAllKeyPairs, clearEncryptionKey, clearKeyPair, clearLazyTitleCache, clearMessagesOp, clearServerToolsCache, composeHooks, createAutoExtractor, createChunkVectorCache, createConversationOp, createCryptoPricePreProcessor, createDecaySweeper, createLlmDecayClassifier, createLlmNeighborRefiner, createMediaBatchOp, createMediaOp, createMemoryEngineTool, createMemoryVaultSearchTool, createMemoryVaultTool, createMessageOp, createMessageSourceResolver, createPlatformCursorStore, createProjectOp, createRecallTool, createServerToolsFilter, createStockPricePreProcessor, createSummaryContext, createVaultEmbeddingCache, createVaultMemoriesBatchOp, createVaultMemoryOp, createWeatherPreProcessor, createWebSearchPreProcessor, decryptConversationTitle, decryptData, decryptDataBatch, decryptDataBytes, decryptDataBytesFromBytes, decryptDataWithKey, defaultServerToolsFilter, deleteAllVaultMemoriesForUserOp, deleteConversationOp, deleteConversationSummaryOp, deleteMediaByConversationOp, deleteMediaByMessageOp, deleteMediaOp, deleteModelPreferenceOp, deleteProjectOp, deleteUserPreferenceOp, deleteVaultMemoryOp, eagerEmbedContent, embedAllMessages, embedMessage, encryptData, encryptDataBatch, encryptDataBytes, encryptDataWithKey, estimateMessagesTokens, estimateTokens, exportPublicKey, extractAndLinkEntitiesForMemoriesOp, extractAndRetain, extractEntitiesForMemories, extractFacts, findMatchingTools, generateConversationId, generateEmbedding, generateEmbeddings, generateMediaId, generateProjectId, getAIGeneratedMediaOp, getAllFilesOp, getAllVaultMemoriesOp, getAllVaultMemoryContentsOp, getAudioOp, getCachedServerTools, getConversationOp, getConversationSummaryOp, getConversationsByProjectLazyOp, getConversationsByProjectOp, getConversationsLazyOp, getConversationsOp, getConversationsPageOp, getDecayCandidatesRawOp, getDocumentsOp, getEncryptionKey, getImagesOp, getMediaByConversationOp, getMediaByIdOp, getMediaByIdsOp, getMediaByMessageOp, getMediaByModelOp, getMediaByRoleOp, getMediaBySourceUrlOp, getMediaByTypeOp, getMediaCountOp, getMediaCountsByTypeOp, getMediaOp, getMediaTypeFromMime, getMemoriesNeedingTopicExtractionOp, getMessageOp, getMessagesOp, getModelPreferenceOp, getProjectConversationCountOp, getProjectConversationsOp, getProjectOp, getProjectsOp, getRecentMediaOp, getServerTools, getSupportedFileTypes, getToolsChecksum, getUnfiledVaultMemoriesOp, getUserPreferenceOp, getUserUploadedMediaOp, getVaultMemoryOp, getVideosOp, hardDeleteDecayedOp, hardDeleteMediaOp, hasEncryptionKey, hasKeyPair, ingestPublishedPhotoMemoriesOp, injectionSignatureCatalog, isRerankerAvailable, isSupportedFile, isSupportedMediaType, makeSyntheticStoredConversation, makeSyntheticStoredMessage, maybeSummarizeHistory, mediaToStored, migrateFromModelPreferencesOp, onKeyAvailable, parseMedia, preEmbedVaultMemories, preprocessFiles, progressiveSummarize, projectToStored, queueManager, rankProfileCandidates, recall, reflect, refreshEncryptionKeyIfMatches, relinkMemoryTopicsOp, relinkMisclassifiedVideosOp, renderTemplate, requestEncryptionKey, requestKeyPair, restoreVaultMemoryOp, resumeStream, retain, runToolLoop, sanitizeQuotes, schemaToCreateSQL, scoreProfileSalience, screenCandidatesForInjection, sdkMigrations, sdkModelClasses, sdkSchema, searchChunksOp, searchMediaOp, searchMessagesOp, searchVaultMemories, seedEncryptionKeys, selectServerToolsForPrompt, serverPlatformStorage, setMemoryVisibilityOp, setModelPreferenceOp, setUserPreferenceOp, shouldAnalyzeStyle, shouldChunkMessage, shouldRefreshTools, splitMessagesAtThreshold, stampTopicsExtractedAtOp, streamCancelPath, streamReplayPath, summarizeObservationTrends, summaryToSystemMessage, supersedeVaultMemoryOp, synthesizeProfile, toolSetSystemPrompts, traverseGraphLane, ttlForType, updateConversationProjectOp, updateConversationTitleOp, updateMediaMessageIdBatchOp, updateMediaOp, updateMessageChunksOp, updateMessageEmbeddingOp, updateMessageErrorOp, updateMessageFeedbackOp, updateModelsOp, updatePersonalityOp, updateProfileOp, updateProjectNameOp, updateProjectOp, updateVaultMemoryEmbeddingOp, updateVaultMemoryOp, upsertConversationSummaryOp, upsertMessageOp, verifyMemoriesForPublish };