@hasna/mementos 0.14.84 → 0.14.86

package/dist/server/index.js

@@ -243,6 +243,7 @@ function translateSql(sql) {
   let translated = sql.replace(/\?/g, () => `$${++parameterIndex}`);
   const ISO_FMT = `'YYYY-MM-DD"T"HH24:MI:SS.MS"Z"'`;
   translated = translated.replace(/datetime\s*\(\s*'now'\s*\)/gi, `to_char(now() AT TIME ZONE 'UTC', ${ISO_FMT})`);
+  translated = translated.replace(/strftime\s*\(\s*'%Y-%m-%dT%H:%M:%fZ'\s*,\s*'now'\s*\)/gi, `to_char(now() AT TIME ZONE 'UTC', ${ISO_FMT})`);
   translated = translated.replace(/datetime\s*\(\s*'now'\s*,\s*'(-?\d+)\s+(minutes?|hours?|days?|seconds?)'\s*\)/gi, (_match, amount, unit) => {
     const parsed = parseInt(String(amount), 10);
     const absolute = Math.abs(parsed);
@@ -524,8 +525,13 @@ var init_storage = __esm(() => {
     data;
     closed = false;
     lastError = null;
+    generation = 0;
     static DATA_BYTES = 128 * 1024 * 1024;
-    static QUERY_TIMEOUT_MS = 60000;
+    static queryTimeoutMs() {
+      const raw = process.env["MEMENTOS_PGSYNC_QUERY_TIMEOUT_MS"]?.trim();
+      const parsed = raw ? Number(raw) : Number.NaN;
+      return Number.isFinite(parsed) && parsed > 0 ? parsed : 60000;
+    }
     static resolveWorkerPath() {
       const ext = import.meta.url.endsWith(".ts") ? ".ts" : ".js";
       const here = fileURLToPath(new URL(".", import.meta.url));
@@ -540,12 +546,12 @@ var init_storage = __esm(() => {
       }
       return candidates[0];
     }
-    constructor(connectionString) {
-      const control = new SharedArrayBuffer(8);
+    constructor(connectionString, workerPath) {
+      const control = new SharedArrayBuffer(12);
       const dataSab = new SharedArrayBuffer(PgSyncPool.DATA_BYTES);
       this.status = new Int32Array(control);
       this.data = new Uint8Array(dataSab);
-      this.worker = new Worker(PgSyncPool.resolveWorkerPath(), {
+      this.worker = new Worker(workerPath ?? PgSyncPool.resolveWorkerPath(), {
         workerData: {
           dsn: stripSslParams(connectionString),
           ssl: sslConfigFor(connectionString),
@@ -563,21 +569,35 @@ var init_storage = __esm(() => {
         throw new Error("PgSyncPool is closed");
       if (this.lastError)
         throw this.lastError;
+      const timeoutMs = PgSyncPool.queryTimeoutMs();
+      const gen = ++this.generation;
       Atomics.store(this.status, 0, 0);
-      this.worker.postMessage({ sql, params });
-      const waitResult = Atomics.wait(this.status, 0, 0, PgSyncPool.QUERY_TIMEOUT_MS);
-      const code = Atomics.load(this.status, 0);
-      if (code === 0 || waitResult === "timed-out") {
-        if (this.lastError)
-          throw this.lastError;
-        throw new Error("PostgreSQL query timed out after 60s");
-      }
-      const len = Atomics.load(this.status, 1);
-      const payload = JSON.parse(new TextDecoder().decode(this.data.subarray(0, len)));
-      if (code === 2) {
-        throw new Error(payload.message ?? "PostgreSQL error");
+      Atomics.store(this.status, 2, 0);
+      this.worker.postMessage({ sql, params, gen });
+      const deadline = Date.now() + timeoutMs;
+      for (;; ) {
+        const remaining = deadline - Date.now();
+        const responding = Atomics.load(this.status, 0);
+        if (responding === gen) {
+          const code = Atomics.load(this.status, 2);
+          const len = Atomics.load(this.status, 1);
+          const payload = JSON.parse(new TextDecoder().decode(this.data.subarray(0, len)));
+          if (code === 2) {
+            throw new Error(payload.message ?? "PostgreSQL error");
+          }
+          return payload;
+        }
+        if (responding !== 0) {
+          Atomics.compareExchange(this.status, 0, responding, 0);
+          continue;
+        }
+        if (remaining <= 0) {
+          if (this.lastError)
+            throw this.lastError;
+          throw new Error(`PostgreSQL query timed out after ${timeoutMs}ms`);
+        }
+        Atomics.wait(this.status, 0, 0, remaining);
       }
-      return payload;
     }
     end() {
       if (this.closed)
@@ -780,7 +800,16 @@ x-api-key: ${cfg.apiKey}
 function apiJson(method, path, body, options) {
   const raw = apiRequestRaw(method, path, body);
   if (raw.status >= 200 && raw.status < 300) {
-    const data = raw.body.trim() ? JSON.parse(raw.body) : undefined;
+    let data;
+    if (raw.body.trim()) {
+      try {
+        data = JSON.parse(raw.body);
+      } catch (e) {
+        throw new ApiRequestError(`mementos cloud ${method} ${path} returned status ${raw.status} with a body that is not valid JSON (${e instanceof Error ? e.message : String(e)}) \u2014 the response is truncated or the server is unhealthy`, raw.status, raw.body.slice(0, 500));
+      }
+    } else {
+      data = undefined;
+    }
     return { status: raw.status, data };
   }
   if (raw.status === 404 && options?.allow404) {
@@ -2695,8 +2724,12 @@ __export(exports_memories, {
   updateMemory: () => updateMemory,
   touchMemory: () => touchMemory,
   semanticSearch: () => semanticSearch,
+  reservedAgentIdViolation: () => reservedAgentIdViolation,
   parseMemoryRow: () => parseMemoryRow,
+  listMemoryHistoryPage: () => listMemoryHistoryPage,
   listMemoryHistory: () => listMemoryHistory,
+  listMemoriesPage: () => listMemoriesPage,
+  listMemoriesBounded: () => listMemoriesBounded,
   listMemories: () => listMemories,
   listLowTrustMemories: () => listLowTrustMemories,
   indexMemoryEmbedding: () => indexMemoryEmbedding,
@@ -2710,6 +2743,8 @@ __export(exports_memories, {
   getMemoriesByKey: () => getMemoriesByKey,
   deleteMemory: () => deleteMemory,
   createMemory: () => createMemory,
+  countMemoryHistory: () => countMemoryHistory,
+  countMemories: () => countMemories,
   cleanExpiredMemories: () => cleanExpiredMemories,
   bulkUpsertMemories: () => bulkUpsertMemories,
   bulkDeleteMemories: () => bulkDeleteMemories
@@ -2761,7 +2796,20 @@ function parseMemoryRow(row) {
     accessed_at: row["accessed_at"] || null
   };
 }
+function reservedAgentIdViolation(agentId) {
+  if (!agentId)
+    return null;
+  const normalized = agentId.trim().toLowerCase();
+  if (RESERVED_AGENT_IDS.has(normalized)) {
+    return `Reserved placeholder agent id "${agentId}" cannot own a memory. ` + `Refusing to write: test harnesses must not write memories under placeholder agent ` + `identities. Register a real agent (mementos register-agent <name>) and pass its id.`;
+  }
+  return null;
+}
 function createMemory(input, dedupeMode = "merge", db) {
+  const reservedViolation = reservedAgentIdViolation(input.agent_id);
+  if (reservedViolation) {
+    throw new Error(reservedViolation);
+  }
   if (!db && isApiMode()) {
     const { status, data } = apiJson("POST", "/memories", { ...input, dedupe: dedupeMode });
     if (!data || !data.id) {
@@ -2811,7 +2859,8 @@ function createMemory(input, dedupeMode = "merge", db) {
            importance = ?, metadata = ?, expires_at = ?,
            when_to_use = ?,
            pinned = COALESCE(pinned, 0),
-           version = version + 1, updated_at = ?
+           version = version + 1, updated_at = ?,
+           updated_by_agent = ?
          WHERE id = ?`, [
         safeValue,
         input.category || "knowledge",
@@ -2822,6 +2871,7 @@ function createMemory(input, dedupeMode = "merge", db) {
         expiresAt,
         input.when_to_use || null,
         timestamp,
+        input.agent_id || null,
         existing.id
       ]);
       d.run("DELETE FROM memory_tags WHERE memory_id = ?", [existing.id]);
@@ -2926,6 +2976,12 @@ function bulkUpsertMemories(memories, db) {
         errors.push(`Rejected "${key}": ${formatEnumViolation(violation)}`);
         continue;
       }
+      const agentViolation = reservedAgentIdViolation(typeof mem["agent_id"] === "string" ? mem["agent_id"] : undefined);
+      if (agentViolation) {
+        rejected++;
+        errors.push(`Rejected "${key}": ${agentViolation}`);
+        continue;
+      }
       const timestamp = now();
       let tags = [];
       const rawTags = mem["tags"];
@@ -3076,29 +3132,7 @@ function getMemoriesByKey(key, scope, agentId, projectId, db) {
   const rows = d.query(sql).all(...params);
   return rows.map(parseMemoryRow);
 }
-function listMemories(filter, db) {
-  if (!db && isApiMode()) {
-    const f = filter || {};
-    const q = toQuery({
-      key: f.key,
-      scope: f.scope,
-      category: f.category,
-      status: f.status,
-      tags: f.tags,
-      min_importance: f.min_importance,
-      pinned: f.pinned,
-      agent_id: f.agent_id,
-      project_id: f.project_id,
-      session_id: f.session_id,
-      namespace: f.namespace,
-      as_of: f.as_of,
-      limit: f.limit,
-      offset: f.offset
-    });
-    const { data } = apiJson("GET", `/memories${q}`);
-    return data?.memories ?? [];
-  }
-  const d = db || getDatabase();
+function buildMemoryListConditions(filter) {
   const conditions = [];
   const params = [];
   if (filter) {
@@ -3210,21 +3244,114 @@ function listMemories(filter, db) {
   } else {
     conditions.push("status = 'active'");
   }
+  return { conditions, params };
+}
+function listMemoriesPage(filter, db) {
+  const f = filter || {};
+  if (!db && isApiMode()) {
+    const q = toQuery({
+      key: f.key,
+      scope: f.scope,
+      category: f.category,
+      status: f.status,
+      tags: f.tags,
+      min_importance: f.min_importance,
+      pinned: f.pinned,
+      agent_id: f.agent_id,
+      project_id: f.project_id,
+      session_id: f.session_id,
+      machine_id: f.machine_id,
+      visible_to_machine_id: f.visible_to_machine_id,
+      search: f.search,
+      source: f.source,
+      flag: f.flag,
+      namespace: f.namespace,
+      as_of: f.as_of,
+      limit: f.limit,
+      offset: f.offset
+    });
+    const { data } = apiJson("GET", `/memories${q}`);
+    return {
+      rows: data?.memories ?? [],
+      has_more: data?.has_more,
+      next_cursor: data?.next_cursor ?? null
+    };
+  }
+  const d = db || getDatabase();
+  const { conditions, params } = buildMemoryListConditions(f);
   let sql = "SELECT * FROM memories";
   if (conditions.length > 0) {
     sql += ` WHERE ${conditions.join(" AND ")}`;
   }
   sql += " ORDER BY importance DESC, created_at DESC";
-  if (filter?.limit) {
+  if (f.limit) {
     sql += " LIMIT ?";
-    params.push(filter.limit);
+    params.push(f.limit);
   }
-  if (filter?.offset) {
+  if (f.offset) {
     sql += " OFFSET ?";
-    params.push(filter.offset);
+    params.push(f.offset);
   }
   const rows = d.query(sql).all(...params);
-  return rows.map(parseMemoryRow);
+  const parsed = rows.map(parseMemoryRow);
+  const hasMore = f.limit !== undefined && parsed.length === f.limit;
+  return {
+    rows: parsed,
+    has_more: hasMore,
+    next_cursor: hasMore ? (f.offset ?? 0) + parsed.length : null
+  };
+}
+function listMemories(filter, db) {
+  return listMemoriesPage(filter, db).rows;
+}
+function listMemoriesBounded(filter = {}, target, db) {
+  const pageSize = 1000;
+  const maxPages = 1000;
+  const want = target === undefined ? undefined : target + 1;
+  const rows = [];
+  const seenCursors = new Set;
+  let cursor = filter.offset ?? 0;
+  let pages = 0;
+  for (;; ) {
+    if (want !== undefined && rows.length >= want)
+      break;
+    if (++pages > maxPages) {
+      throw new Error(`memories list traversal exceeded ${maxPages} pages while collecting rows \u2014 aborting (cursor cycle?)`);
+    }
+    const limit = Math.min(want === undefined ? pageSize : want - rows.length, pageSize);
+    const page = listMemoriesPage({ ...filter, limit, offset: cursor }, db);
+    rows.push(...page.rows);
+    if (page.has_more === false)
+      break;
+    if (page.has_more === undefined && page.rows.length < limit)
+      break;
+    if (page.has_more === true && (page.next_cursor === null || page.next_cursor === undefined)) {
+      throw new Error("memories list page claimed more results without a next cursor \u2014 aborting");
+    }
+    const next = page.next_cursor ?? cursor + page.rows.length;
+    if (seenCursors.has(next)) {
+      throw new Error("memories list traversal repeated a cursor \u2014 aborting");
+    }
+    seenCursors.add(next);
+    cursor = next;
+  }
+  const hasMore = target !== undefined && rows.length > target;
+  const trimmed = hasMore ? rows.slice(0, target) : rows;
+  return {
+    rows: trimmed,
+    has_more: hasMore,
+    next_cursor: hasMore ? (filter.offset ?? 0) + trimmed.length : null
+  };
+}
+function countMemories(filter, db) {
+  const d = db || getDatabase();
+  const { conditions, params } = buildMemoryListConditions(filter);
+  let sql = "SELECT COUNT(*) AS c FROM memories";
+  if (conditions.length > 0) {
+    sql += ` WHERE ${conditions.join(" AND ")}`;
+  }
+  const row = d.query(sql).get(...params);
+  return row?.c ?? 0;
 }
 function getMemoryBriefing(opts, db) {
   const limit = opts.limit ?? 20;
@@ -3286,13 +3413,17 @@ function listLowTrustMemories(opts = {}, db) {
   const rows = d.prepare(`SELECT * FROM memories WHERE ${conditions.join(" AND ")} ORDER BY trust_score ASC LIMIT ? OFFSET ?`).all(...params);
   return rows.map(parseMemoryRow);
 }
-function listMemoryHistory(opts = {}, db) {
+function listMemoryHistoryPage(opts = {}, db) {
   const limit = opts.limit ?? 20;
   const offset = opts.offset ?? 0;
   if (!db && isApiMode()) {
     const q = toQuery({ limit, offset });
     const { data } = apiJson("GET", `/memories/history${q}`);
-    return data?.memories ?? [];
+    return {
+      rows: data?.memories ?? [],
+      has_more: data?.has_more,
+      next_cursor: data?.next_cursor ?? null
+    };
   }
   const d = db || getDatabase();
   const params = [limit];
@@ -3302,7 +3433,21 @@ function listMemoryHistory(opts = {}, db) {
     params.push(offset);
   }
   const rows = d.query(sql).all(...params);
-  return rows.map(parseMemoryRow);
+  const parsed = rows.map(parseMemoryRow);
+  const hasMore = parsed.length === limit;
+  return {
+    rows: parsed,
+    has_more: hasMore,
+    next_cursor: hasMore ? offset + parsed.length : null
+  };
+}
+function listMemoryHistory(opts = {}, db) {
+  return listMemoryHistoryPage(opts, db).rows;
+}
+function countMemoryHistory(db) {
+  const d = db || getDatabase();
+  const row = d.query("SELECT COUNT(*) AS c FROM memories WHERE status = 'active' AND accessed_at IS NOT NULL").get();
+  return row?.c ?? 0;
 }
 function getMemoryChain(sequenceGroup, projectId, db) {
   if (!db && isApiMode()) {
@@ -3399,20 +3544,29 @@ function updateMemory(id, input, db) {
     sets.push("when_to_use = ?");
     params.push(input.when_to_use ?? null);
   }
+  if (input.updated_by_agent !== undefined) {
+    sets.push("updated_by_agent = ?");
+    params.push(input.updated_by_agent ?? null);
+  }
   if (input.tags !== undefined) {
     sets.push("tags = ?");
     params.push(JSON.stringify(input.tags));
-    d.run("DELETE FROM memory_tags WHERE memory_id = ?", [memoryId]);
-    const insertTag = d.prepare("INSERT OR IGNORE INTO memory_tags (memory_id, tag) VALUES (?, ?)");
-    for (const tag of input.tags) {
-      insertTag.run(memoryId, tag);
-    }
   }
   params.push(memoryId);
-  const result = d.run(`UPDATE memories SET ${sets.join(", ")} WHERE id = ?`, params);
-  if (result.changes === 0) {
-    throw new Error(`Update affected no rows for memory ${memoryId}: the record was read but not written. ` + `This is a bug in @hasna/mementos, not a bad argument \u2014 please report it.`);
-  }
+  d.transaction(() => {
+    const res = d.run(`UPDATE memories SET ${sets.join(", ")} WHERE id = ?`, params);
+    if (res.changes === 0) {
+      throw new Error(`Update affected no rows for memory ${memoryId}: the record was read but not written. ` + `This is a bug in @hasna/mementos, not a bad argument \u2014 please report it.`);
+    }
+    if (input.tags !== undefined) {
+      d.run("DELETE FROM memory_tags WHERE memory_id = ?", [memoryId]);
+      const insertTag = d.prepare("INSERT OR IGNORE INTO memory_tags (memory_id, tag) VALUES (?, ?)");
+      for (const tag of input.tags) {
+        insertTag.run(memoryId, tag);
+      }
+    }
+    return res;
+  });
   const updated = getMemory(memoryId, d);
   if (input.value !== undefined) {
     try {
@@ -3583,7 +3737,7 @@ async function semanticSearch(queryText, options = {}, db) {
   scored.sort((a, b) => b.score - a.score);
   return scored.slice(0, limit);
 }
-var RECALL_PROMOTE_THRESHOLD = 3;
+var RESERVED_AGENT_IDS, RECALL_PROMOTE_THRESHOLD = 3;
 var init_memories = __esm(() => {
   init_types();
   init_database();
@@ -3593,6 +3747,12 @@ var init_memories = __esm(() => {
   init_poisoning();
   init_entity_memories();
   init_api_mode();
+  RESERVED_AGENT_IDS = new Set([
+    "agent-a",
+    "agent-x",
+    "agent-z",
+    "nonexistent-agent"
+  ]);
 });
 
 // src/db/entities.ts
@@ -4175,7 +4335,7 @@ function buildFilterConditions(filter) {
   const conditions = [];
   const params = [];
   conditions.push("m.status = 'active'");
-  conditions.push("(m.expires_at IS NULL OR m.expires_at >= datetime('now'))");
+  conditions.push("(m.expires_at IS NULL OR m.expires_at >= strftime('%Y-%m-%dT%H:%M:%fZ', 'now'))");
   if (!filter)
     return { conditions, params };
   if (filter.scope) {
@@ -6211,7 +6371,7 @@ async function detectContradiction(newKey, newValue, options = {}, db) {
     conditions.push("project_id = ?");
     params.push(project_id);
   }
-  conditions.push("(valid_until IS NULL OR valid_until > datetime('now'))");
+  conditions.push("(valid_until IS NULL OR valid_until > strftime('%Y-%m-%dT%H:%M:%fZ', 'now'))");
   const sql = `SELECT * FROM memories WHERE ${conditions.join(" AND ")} ORDER BY importance DESC LIMIT 10`;
   const rows = d.query(sql).all(...params);
   if (rows.length === 0) {
@@ -19888,7 +20048,7 @@ class JSONSchemaGenerator {
               if (val === undefined) {
                 if (this.unrepresentable === "throw") {
                   throw new Error("Literal `undefined` cannot be represented in JSON Schema");
-                } else {}
+                }
               } else if (typeof val === "bigint") {
                 if (this.unrepresentable === "throw") {
                   throw new Error("BigInt literals cannot be represented in JSON Schema");
@@ -41538,7 +41698,7 @@ var require_tracestate_impl = __commonJS((exports) => {
           const value = listMember.slice(i + 1, part.length);
           if ((0, tracestate_validators_1.validateKey)(key) && (0, tracestate_validators_1.validateValue)(value)) {
             agg.set(key, value);
-          } else {}
+          }
         }
         return agg;
       }, new Map);
@@ -55845,6 +56005,18 @@ function getNextPendingJob(db) {
     return null;
   return parseJobRow(row);
 }
+function claimSessionJob(id, db) {
+  const d = db || getDatabase();
+  const startedAt = now();
+  const result = d.run("UPDATE session_memory_jobs SET status = 'processing', started_at = ? WHERE id = ? AND status = 'pending'", [startedAt, id]);
+  return result.changes;
+}
+function recoverStaleProcessingJobs(maxAgeMs, db) {
+  const d = db || getDatabase();
+  const cutoff = new Date(Date.now() - maxAgeMs).toISOString();
+  const result = d.run("UPDATE session_memory_jobs SET status = 'pending', started_at = NULL WHERE status = 'processing' AND started_at < ?", [cutoff]);
+  return result.changes;
+}
 
 // src/lib/session-processor.ts
 init_memories();
@@ -56347,7 +56519,11 @@ async function processSessionJob(jobId, db) {
     return result;
   }
   try {
-    updateSessionJob(jobId, { status: "processing", started_at: new Date().toISOString() }, db);
+    const changes = claimSessionJob(jobId, db);
+    if (changes === 0) {
+      result.errors.push(`Job already claimed or not pending: ${jobId}`);
+      return result;
+    }
   } catch (e) {
     result.errors.push(`Failed to mark job as processing: ${String(e)}`);
     return result;
@@ -56455,6 +56631,9 @@ function startSessionQueueWorker() {
     return;
   _workerStarted = true;
   setInterval(() => {
+    try {
+      recoverStaleProcessingJobs(30 * 60 * 1000);
+    } catch {}
     _processNext();
   }, 5000);
 }
@@ -56726,7 +56905,7 @@ function getTaskStats(db, filter) {
   const priorityRows = db.query(`SELECT priority, COUNT(*) as c FROM tasks ${where} GROUP BY priority`).all(...params);
   for (const row of priorityRows)
     byPriority[row.priority] = row.c;
-  const overdue = db.query(`SELECT COUNT(*) as c FROM tasks ${where} AND status != 'completed' AND status != 'cancelled' AND due_at IS NOT NULL AND due_at < datetime('now')`).get(...params).c;
+  const overdue = db.query(`SELECT COUNT(*) as c FROM tasks ${where} AND status != 'completed' AND status != 'cancelled' AND due_at IS NOT NULL AND due_at < strftime('%Y-%m-%dT%H:%M:%fZ', 'now')`).get(...params).c;
   return {
     total,
     by_status: {
@@ -56857,6 +57036,255 @@ async function _tick() {
 
 // src/server/index.ts
 init_storage();
+
+// src/db/analytics.ts
+init_database();
+init_api_mode();
+function getMemoryStats(db) {
+  if (!db && isApiMode()) {
+    const { data } = apiJson("GET", "/memories/stats");
+    return normalizeStats(data);
+  }
+  const d = db || getDatabase();
+  const total = d.query("SELECT COUNT(*) as c FROM memories WHERE status = 'active'").get().c;
+  const byScope = d.query("SELECT scope, COUNT(*) as c FROM memories WHERE status = 'active' GROUP BY scope").all();
+  const byCategory = d.query("SELECT category, COUNT(*) as c FROM memories WHERE status = 'active' GROUP BY category").all();
+  const byStatus = d.query("SELECT status, COUNT(*) as c FROM memories WHERE status = 'active' GROUP BY status").all();
+  const pinnedCount = d.query("SELECT COUNT(*) as c FROM memories WHERE pinned = 1 AND status = 'active'").get().c;
+  const expiredCount = d.query("SELECT COUNT(*) as c FROM memories WHERE status = 'expired'").get().c;
+  const expiresAtCount = d.query("SELECT COUNT(*) as c FROM memories WHERE expires_at IS NOT NULL").get().c;
+  const nowIso = new Date().toISOString();
+  const expiredDueCount = d.query("SELECT COUNT(*) as c FROM memories WHERE status = 'expired' OR (expires_at IS NOT NULL AND expires_at < ?)").get(nowIso).c;
+  const stats = {
+    total,
+    by_scope: { global: 0, shared: 0, private: 0, working: 0 },
+    by_category: { preference: 0, fact: 0, knowledge: 0, history: 0, procedural: 0, resource: 0 },
+    by_status: { active: 0, archived: 0, expired: 0 },
+    by_agent: {},
+    pinned_count: pinnedCount,
+    expired_count: expiredCount,
+    expires_at_count: expiresAtCount,
+    expired_due_count: expiredDueCount
+  };
+  for (const row of byScope)
+    if (row.scope in stats.by_scope)
+      stats.by_scope[row.scope] = row.c;
+  for (const row of byCategory)
+    if (row.category in stats.by_category)
+      stats.by_category[row.category] = row.c;
+  for (const row of byStatus) {
+    if (row.status in stats.by_status) {
+      stats.by_status[row.status] = row.c;
+    }
+  }
+  const byAgent = d.query("SELECT agent_id, COUNT(*) as c FROM memories WHERE status = 'active' AND agent_id IS NOT NULL GROUP BY agent_id").all();
+  for (const row of byAgent)
+    stats.by_agent[row.agent_id] = row.c;
+  return stats;
+}
+function normalizeStats(data) {
+  return {
+    total: data?.total ?? 0,
+    by_scope: { global: 0, shared: 0, private: 0, working: 0, ...data?.by_scope ?? {} },
+    by_category: {
+      preference: 0,
+      fact: 0,
+      knowledge: 0,
+      history: 0,
+      procedural: 0,
+      resource: 0,
+      ...data?.by_category ?? {}
+    },
+    by_status: { active: 0, archived: 0, expired: 0, ...data?.by_status ?? {} },
+    by_agent: data?.by_agent ?? {},
+    pinned_count: data?.pinned_count ?? 0,
+    expired_count: data?.expired_count ?? 0,
+    expires_at_count: data?.expires_at_count ?? 0,
+    expired_due_count: data?.expired_due_count ?? 0
+  };
+}
+function getMemoryActivity(filter = {}, db) {
+  const days = Math.min(filter.days || 30, 365);
+  if (!db && isApiMode()) {
+    const q = toQuery({ days, scope: filter.scope, agent_id: filter.agent_id, project_id: filter.project_id });
+    const { data } = apiJson("GET", `/activity${q}`);
+    return { activity: data?.activity ?? [], days: data?.days ?? days, total: data?.total ?? 0 };
+  }
+  const d = db || getDatabase();
+  const conditions = ["status = 'active'"];
+  const params = [];
+  if (filter.scope) {
+    conditions.push("scope = ?");
+    params.push(filter.scope);
+  }
+  if (filter.agent_id) {
+    conditions.push("agent_id = ?");
+    params.push(filter.agent_id);
+  }
+  if (filter.project_id) {
+    conditions.push("project_id = ?");
+    params.push(filter.project_id);
+  }
+  const where = conditions.map((c) => `AND ${c}`).join(" ");
+  const cutoffDate = new Date(Date.now() - days * 86400000).toISOString().slice(0, 10);
+  params.push(cutoffDate);
+  const rows = d.query(`
+    SELECT
+      date(created_at) AS date,
+      COUNT(*) AS memories_created,
+      SUM(CASE WHEN scope = 'global' THEN 1 ELSE 0 END) AS global_count,
+      SUM(CASE WHEN scope = 'shared' THEN 1 ELSE 0 END) AS shared_count,
+      SUM(CASE WHEN scope = 'private' THEN 1 ELSE 0 END) AS private_count,
+      AVG(importance) AS avg_importance
+    FROM memories
+    WHERE date(created_at) >= ? ${where}
+    GROUP BY date(created_at)
+    ORDER BY date ASC
+  `).all(...params);
+  return { activity: rows, days, total: rows.reduce((s, r) => s + r.memories_created, 0) };
+}
+function getMemoryReport(filter = {}, db) {
+  const days = Math.min(filter.days || 7, 365);
+  if (!db && isApiMode()) {
+    const q = toQuery({ days, project_id: filter.project_id, agent_id: filter.agent_id });
+    const { data } = apiJson("GET", `/report${q}`);
+    return {
+      total: data?.total ?? 0,
+      pinned: data?.pinned ?? 0,
+      days: data?.days ?? days,
+      recent: data?.recent ?? { total: 0, activity: [] },
+      by_scope: data?.by_scope ?? {},
+      by_category: data?.by_category ?? {},
+      top_memories: data?.top_memories ?? [],
+      top_agents: data?.top_agents ?? []
+    };
+  }
+  const d = db || getDatabase();
+  const cutoffDate = new Date(Date.now() - days * 86400000).toISOString().slice(0, 10);
+  const scopedCond = [
+    filter.project_id ? "AND project_id = ?" : "",
+    filter.agent_id ? "AND agent_id = ?" : ""
+  ].filter(Boolean).join(" ");
+  const scopedParams = [
+    ...filter.project_id ? [filter.project_id] : [],
+    ...filter.agent_id ? [filter.agent_id] : []
+  ];
+  const recentParams = [cutoffDate, ...scopedParams];
+  const total = d.query(`SELECT COUNT(*) as c FROM memories WHERE status = 'active' ${scopedCond}`).get(...scopedParams).c;
+  const pinned = d.query(`SELECT COUNT(*) as c FROM memories WHERE status = 'active' AND pinned = 1 ${scopedCond}`).get(...scopedParams).c;
+  const actRows = d.query(`
+    SELECT date(created_at) AS date, COUNT(*) AS memories_created
+    FROM memories WHERE status = 'active' AND date(created_at) >= ? ${scopedCond}
+    GROUP BY date(created_at) ORDER BY date(created_at) ASC
+  `).all(...recentParams);
+  const recentTotal = actRows.reduce((s, r) => s + r.memories_created, 0);
+  const byScopeRows = d.query(`SELECT scope, COUNT(*) as c FROM memories WHERE status = 'active' ${scopedCond} GROUP BY scope`).all(...scopedParams);
+  const byCatRows = d.query(`SELECT category, COUNT(*) as c FROM memories WHERE status = 'active' ${scopedCond} GROUP BY category`).all(...scopedParams);
+  const topMems = d.query(`SELECT id, key, value, importance, scope, category FROM memories WHERE status = 'active' ${scopedCond} ORDER BY importance DESC, access_count DESC LIMIT 5`).all(...scopedParams);
+  const topAgents = d.query(`SELECT agent_id, COUNT(*) as c FROM memories WHERE status = 'active' AND agent_id IS NOT NULL ${scopedCond} GROUP BY agent_id ORDER BY c DESC LIMIT 5`).all(...scopedParams);
+  return {
+    total,
+    pinned,
+    days,
+    recent: { total: recentTotal, activity: actRows },
+    by_scope: Object.fromEntries(byScopeRows.map((r) => [r.scope, r.c])),
+    by_category: Object.fromEntries(byCatRows.map((r) => [r.category, r.c])),
+    top_memories: topMems,
+    top_agents: topAgents
+  };
+}
+function getStaleMemoriesPage(filter = {}, db) {
+  const days = Math.min(filter.days || 30, 365);
+  const limit = filter.limit ?? 20;
+  const offset = filter.offset ?? 0;
+  if (!db && isApiMode()) {
+    const q = toQuery({ days, project_id: filter.project_id, agent_id: filter.agent_id, pinned: filter.pinned, limit, offset });
+    const { data } = apiJson("GET", `/memories/stale${q}`);
+    const rows2 = data?.memories ?? [];
+    return {
+      rows: rows2,
+      total: data?.total ?? rows2.length,
+      has_more: data?.has_more,
+      next_cursor: data?.next_cursor ?? null
+    };
+  }
+  const d = db || getDatabase();
+  const cutoffDate = new Date(Date.now() - days * 86400000).toISOString();
+  const conds = ["status = 'active'", "(accessed_at IS NULL OR accessed_at < ?)"];
+  const params = [cutoffDate];
+  if (filter.pinned !== undefined) {
+    conds.push("pinned = ?");
+    params.push(filter.pinned ? 1 : 0);
+  } else {
+    conds.push("pinned = 0");
+  }
+  if (filter.project_id) {
+    conds.push("project_id = ?");
+    params.push(filter.project_id);
+  }
+  if (filter.agent_id) {
+    conds.push("agent_id = ?");
+    params.push(filter.agent_id);
+  }
+  const where = conds.join(" AND ");
+  const countRow = d.query(`SELECT COUNT(*) AS c FROM memories WHERE ${where}`).get(...params);
+  let sql = `SELECT id, key, value, importance, scope, category, accessed_at, access_count, created_at FROM memories WHERE ${where} ORDER BY COALESCE(accessed_at, created_at) ASC LIMIT ?`;
+  params.push(limit);
+  if (offset) {
+    sql += " OFFSET ?";
+    params.push(offset);
+  }
+  const rows = d.query(sql).all(...params);
+  const hasMore = rows.length === limit;
+  return {
+    rows,
+    total: countRow?.c ?? 0,
+    has_more: hasMore,
+    next_cursor: hasMore ? offset + rows.length : null
+  };
+}
+function getMemoryHealth(filter = {}, db) {
+  const staleDays = filter.stale_days ?? 30;
+  const forgottenDays = filter.forgotten_days ?? 60;
+  const limit = filter.limit ?? 10;
+  if (!db && isApiMode()) {
+    const q = toQuery({
+      stale_days: staleDays,
+      forgotten_days: forgottenDays,
+      project_id: filter.project_id,
+      agent_id: filter.agent_id,
+      limit
+    });
+    const { data } = apiJson("GET", `/memories/health${q}`);
+    return { stale: data?.stale ?? [], forgotten: data?.forgotten ?? [], dupes: data?.dupes ?? [] };
+  }
+  const d = db || getDatabase();
+  const extraWhere = [
+    ...filter.project_id ? ["project_id = ?"] : [],
+    ...filter.agent_id ? ["agent_id = ?"] : []
+  ].join(" AND ");
+  const scopeParams = [
+    ...filter.project_id ? [filter.project_id] : [],
+    ...filter.agent_id ? [filter.agent_id] : []
+  ];
+  const staleCutoff = new Date(Date.now() - staleDays * 86400000).toISOString();
+  const forgottenCutoff = new Date(Date.now() - forgottenDays * 86400000).toISOString();
+  const base = `status = 'active' AND pinned = 0${extraWhere ? " AND " + extraWhere : ""}`;
+  const stale = d.prepare(`SELECT id, key, value, importance, scope, created_at FROM memories
+     WHERE ${base} AND access_count = 0 AND created_at < ?
+     ORDER BY created_at ASC LIMIT ?`).all(...scopeParams, staleCutoff, limit);
+  const forgotten = d.prepare(`SELECT id, key, value, importance, scope, accessed_at FROM memories
+     WHERE ${base} AND importance >= 7
+       AND (accessed_at IS NULL OR accessed_at < ?)
+     ORDER BY importance DESC, COALESCE(accessed_at, created_at) ASC LIMIT ?`).all(...scopeParams, forgottenCutoff, limit);
+  const dupes = d.prepare(`SELECT key, COUNT(*) as cnt, MAX(updated_at) as latest, MIN(created_at) as oldest
+     FROM memories WHERE ${base}
+     GROUP BY key HAVING COUNT(*) > 1
+     ORDER BY cnt DESC LIMIT ?`).all(...scopeParams, limit);
+  return { stale, forgotten, dupes };
+}
+
+// src/server/index.ts
 init_router();
 
 // src/server/helpers.ts
@@ -57102,6 +57530,7 @@ var FORMAT_UNITS = [
 
 // src/server/routes/memories-crud.ts
 init_router();
+init_database();
 init_enum_validation();
 init_types();
 addRoute("GET", "/api/memories", (_req, url) => {
@@ -57127,21 +57556,49 @@ addRoute("GET", "/api/memories", (_req, url) => {
     filter.project_id = q["project_id"];
   if (q["session_id"])
     filter.session_id = q["session_id"];
+  if (q["machine_id"])
+    filter.machine_id = q["machine_id"];
+  if (q["visible_to_machine_id"])
+    filter.visible_to_machine_id = q["visible_to_machine_id"];
+  if (q["search"])
+    filter.search = q["search"];
+  if (q["source"])
+    filter.source = q["source"].includes(",") ? q["source"].split(",") : q["source"];
+  if (q["flag"])
+    filter.flag = q["flag"];
   if (q["namespace"])
     filter.namespace = q["namespace"];
   if (q["status"])
     filter.status = q["status"];
-  if (q["limit"])
-    filter.limit = parseInt(q["limit"], 10);
-  if (q["offset"])
-    filter.offset = parseInt(q["offset"], 10);
+  const parsedLimit = Number(q["limit"]);
+  const limit = Number.isInteger(parsedLimit) && parsedLimit > 0 ? Math.min(parsedLimit, 1000) : 1000;
+  const parsedOffset = Number(q["offset"]);
+  filter.limit = limit;
+  filter.offset = Number.isInteger(parsedOffset) && parsedOffset >= 0 ? parsedOffset : 0;
   const memories = listMemories(filter);
+  const total = countMemories(filter, getDatabase());
+  const hasMore = memories.length === limit;
+  const nextCursor = hasMore ? (filter.offset ?? 0) + memories.length : null;
   if (q["fields"]) {
     const fields = q["fields"].split(",").map((f) => f.trim());
     const filtered = memories.map((m) => Object.fromEntries(fields.map((f) => [f, m[f]]).filter(([, v]) => v !== undefined)));
-    return json({ memories: filtered, count: filtered.length });
+    return json({
+      memories: filtered,
+      count: filtered.length,
+      total,
+      limit,
+      has_more: hasMore,
+      next_cursor: nextCursor
+    });
   }
-  return json({ memories, count: memories.length });
+  return json({
+    memories,
+    count: memories.length,
+    total,
+    limit,
+    has_more: hasMore,
+    next_cursor: nextCursor
+  });
 });
 addRoute("POST", "/api/memories", async (req) => {
   const body = await readJson(req);
@@ -57239,227 +57696,6 @@ addRoute("DELETE", "/api/memories/:id", (_req, _url, params) => {
 
 // src/server/routes/memories-stats.ts
 init_database();
-
-// src/db/analytics.ts
-init_database();
-init_api_mode();
-function getMemoryStats(db) {
-  if (!db && isApiMode()) {
-    const { data } = apiJson("GET", "/memories/stats");
-    return normalizeStats(data);
-  }
-  const d = db || getDatabase();
-  const total = d.query("SELECT COUNT(*) as c FROM memories WHERE status = 'active'").get().c;
-  const byScope = d.query("SELECT scope, COUNT(*) as c FROM memories WHERE status = 'active' GROUP BY scope").all();
-  const byCategory = d.query("SELECT category, COUNT(*) as c FROM memories WHERE status = 'active' GROUP BY category").all();
-  const byStatus = d.query("SELECT status, COUNT(*) as c FROM memories WHERE status = 'active' GROUP BY status").all();
-  const pinnedCount = d.query("SELECT COUNT(*) as c FROM memories WHERE pinned = 1 AND status = 'active'").get().c;
-  const expiredCount = d.query("SELECT COUNT(*) as c FROM memories WHERE status = 'expired' OR (expires_at IS NOT NULL AND expires_at < datetime('now'))").get().c;
-  const stats = {
-    total,
-    by_scope: { global: 0, shared: 0, private: 0, working: 0 },
-    by_category: { preference: 0, fact: 0, knowledge: 0, history: 0, procedural: 0, resource: 0 },
-    by_status: { active: 0, archived: 0, expired: 0 },
-    by_agent: {},
-    pinned_count: pinnedCount,
-    expired_count: expiredCount
-  };
-  for (const row of byScope)
-    if (row.scope in stats.by_scope)
-      stats.by_scope[row.scope] = row.c;
-  for (const row of byCategory)
-    if (row.category in stats.by_category)
-      stats.by_category[row.category] = row.c;
-  for (const row of byStatus) {
-    if (row.status in stats.by_status) {
-      stats.by_status[row.status] = row.c;
-    }
-  }
-  const byAgent = d.query("SELECT agent_id, COUNT(*) as c FROM memories WHERE status = 'active' AND agent_id IS NOT NULL GROUP BY agent_id").all();
-  for (const row of byAgent)
-    stats.by_agent[row.agent_id] = row.c;
-  return stats;
-}
-function normalizeStats(data) {
-  return {
-    total: data?.total ?? 0,
-    by_scope: { global: 0, shared: 0, private: 0, working: 0, ...data?.by_scope ?? {} },
-    by_category: {
-      preference: 0,
-      fact: 0,
-      knowledge: 0,
-      history: 0,
-      procedural: 0,
-      resource: 0,
-      ...data?.by_category ?? {}
-    },
-    by_status: { active: 0, archived: 0, expired: 0, ...data?.by_status ?? {} },
-    by_agent: data?.by_agent ?? {},
-    pinned_count: data?.pinned_count ?? 0,
-    expired_count: data?.expired_count ?? 0
-  };
-}
-function getMemoryActivity(filter = {}, db) {
-  const days = Math.min(filter.days || 30, 365);
-  if (!db && isApiMode()) {
-    const q = toQuery({ days, scope: filter.scope, agent_id: filter.agent_id, project_id: filter.project_id });
-    const { data } = apiJson("GET", `/activity${q}`);
-    return { activity: data?.activity ?? [], days: data?.days ?? days, total: data?.total ?? 0 };
-  }
-  const d = db || getDatabase();
-  const conditions = ["status = 'active'"];
-  const params = [];
-  if (filter.scope) {
-    conditions.push("scope = ?");
-    params.push(filter.scope);
-  }
-  if (filter.agent_id) {
-    conditions.push("agent_id = ?");
-    params.push(filter.agent_id);
-  }
-  if (filter.project_id) {
-    conditions.push("project_id = ?");
-    params.push(filter.project_id);
-  }
-  const where = conditions.map((c) => `AND ${c}`).join(" ");
-  const cutoffDate = new Date(Date.now() - days * 86400000).toISOString().slice(0, 10);
-  params.push(cutoffDate);
-  const rows = d.query(`
-    SELECT
-      date(created_at) AS date,
-      COUNT(*) AS memories_created,
-      SUM(CASE WHEN scope = 'global' THEN 1 ELSE 0 END) AS global_count,
-      SUM(CASE WHEN scope = 'shared' THEN 1 ELSE 0 END) AS shared_count,
-      SUM(CASE WHEN scope = 'private' THEN 1 ELSE 0 END) AS private_count,
-      AVG(importance) AS avg_importance
-    FROM memories
-    WHERE date(created_at) >= ? ${where}
-    GROUP BY date(created_at)
-    ORDER BY date ASC
-  `).all(...params);
-  return { activity: rows, days, total: rows.reduce((s, r) => s + r.memories_created, 0) };
-}
-function getMemoryReport(filter = {}, db) {
-  const days = Math.min(filter.days || 7, 365);
-  if (!db && isApiMode()) {
-    const q = toQuery({ days, project_id: filter.project_id, agent_id: filter.agent_id });
-    const { data } = apiJson("GET", `/report${q}`);
-    return {
-      total: data?.total ?? 0,
-      pinned: data?.pinned ?? 0,
-      days: data?.days ?? days,
-      recent: data?.recent ?? { total: 0, activity: [] },
-      by_scope: data?.by_scope ?? {},
-      by_category: data?.by_category ?? {},
-      top_memories: data?.top_memories ?? [],
-      top_agents: data?.top_agents ?? []
-    };
-  }
-  const d = db || getDatabase();
-  const cutoffDate = new Date(Date.now() - days * 86400000).toISOString().slice(0, 10);
-  const scopedCond = [
-    filter.project_id ? "AND project_id = ?" : "",
-    filter.agent_id ? "AND agent_id = ?" : ""
-  ].filter(Boolean).join(" ");
-  const scopedParams = [
-    ...filter.project_id ? [filter.project_id] : [],
-    ...filter.agent_id ? [filter.agent_id] : []
-  ];
-  const recentParams = [cutoffDate, ...scopedParams];
-  const total = d.query(`SELECT COUNT(*) as c FROM memories WHERE status = 'active' ${scopedCond}`).get(...scopedParams).c;
-  const pinned = d.query(`SELECT COUNT(*) as c FROM memories WHERE status = 'active' AND pinned = 1 ${scopedCond}`).get(...scopedParams).c;
-  const actRows = d.query(`
-    SELECT date(created_at) AS date, COUNT(*) AS memories_created
-    FROM memories WHERE status = 'active' AND date(created_at) >= ? ${scopedCond}
-    GROUP BY date(created_at) ORDER BY date(created_at) ASC
-  `).all(...recentParams);
-  const recentTotal = actRows.reduce((s, r) => s + r.memories_created, 0);
-  const byScopeRows = d.query(`SELECT scope, COUNT(*) as c FROM memories WHERE status = 'active' ${scopedCond} GROUP BY scope`).all(...scopedParams);
-  const byCatRows = d.query(`SELECT category, COUNT(*) as c FROM memories WHERE status = 'active' ${scopedCond} GROUP BY category`).all(...scopedParams);
-  const topMems = d.query(`SELECT id, key, value, importance, scope, category FROM memories WHERE status = 'active' ${scopedCond} ORDER BY importance DESC, access_count DESC LIMIT 5`).all(...scopedParams);
-  const topAgents = d.query(`SELECT agent_id, COUNT(*) as c FROM memories WHERE status = 'active' AND agent_id IS NOT NULL ${scopedCond} GROUP BY agent_id ORDER BY c DESC LIMIT 5`).all(...scopedParams);
-  return {
-    total,
-    pinned,
-    days,
-    recent: { total: recentTotal, activity: actRows },
-    by_scope: Object.fromEntries(byScopeRows.map((r) => [r.scope, r.c])),
-    by_category: Object.fromEntries(byCatRows.map((r) => [r.category, r.c])),
-    top_memories: topMems,
-    top_agents: topAgents
-  };
-}
-function getStaleMemories(filter = {}, db) {
-  const days = Math.min(filter.days || 30, 365);
-  const limit = filter.limit ?? 20;
-  const offset = filter.offset ?? 0;
-  if (!db && isApiMode()) {
-    const q = toQuery({ days, project_id: filter.project_id, agent_id: filter.agent_id, limit, offset });
-    const { data } = apiJson("GET", `/memories/stale${q}`);
-    return data?.memories ?? [];
-  }
-  const d = db || getDatabase();
-  const cutoffDate = new Date(Date.now() - days * 86400000).toISOString();
-  const conds = ["status = 'active'", "(accessed_at IS NULL OR accessed_at < ?)", "pinned = 0"];
-  const params = [cutoffDate];
-  if (filter.project_id) {
-    conds.push("project_id = ?");
-    params.push(filter.project_id);
-  }
-  if (filter.agent_id) {
-    conds.push("agent_id = ?");
-    params.push(filter.agent_id);
-  }
-  let sql = `SELECT id, key, value, importance, scope, category, accessed_at, access_count, created_at FROM memories WHERE ${conds.join(" AND ")} ORDER BY COALESCE(accessed_at, created_at) ASC LIMIT ?`;
-  params.push(limit);
-  if (offset) {
-    sql += " OFFSET ?";
-    params.push(offset);
-  }
-  return d.query(sql).all(...params);
-}
-function getMemoryHealth(filter = {}, db) {
-  const staleDays = filter.stale_days ?? 30;
-  const forgottenDays = filter.forgotten_days ?? 60;
-  const limit = filter.limit ?? 10;
-  if (!db && isApiMode()) {
-    const q = toQuery({
-      stale_days: staleDays,
-      forgotten_days: forgottenDays,
-      project_id: filter.project_id,
-      agent_id: filter.agent_id,
-      limit
-    });
-    const { data } = apiJson("GET", `/memories/health${q}`);
-    return { stale: data?.stale ?? [], forgotten: data?.forgotten ?? [], dupes: data?.dupes ?? [] };
-  }
-  const d = db || getDatabase();
-  const extraWhere = [
-    ...filter.project_id ? ["project_id = ?"] : [],
-    ...filter.agent_id ? ["agent_id = ?"] : []
-  ].join(" AND ");
-  const scopeParams = [
-    ...filter.project_id ? [filter.project_id] : [],
-    ...filter.agent_id ? [filter.agent_id] : []
-  ];
-  const staleCutoff = new Date(Date.now() - staleDays * 86400000).toISOString();
-  const forgottenCutoff = new Date(Date.now() - forgottenDays * 86400000).toISOString();
-  const base = `status = 'active' AND pinned = 0${extraWhere ? " AND " + extraWhere : ""}`;
-  const stale = d.prepare(`SELECT id, key, value, importance, scope, created_at FROM memories
-     WHERE ${base} AND access_count = 0 AND created_at < ?
-     ORDER BY created_at ASC LIMIT ?`).all(...scopeParams, staleCutoff, limit);
-  const forgotten = d.prepare(`SELECT id, key, value, importance, scope, accessed_at FROM memories
-     WHERE ${base} AND importance >= 7
-       AND (accessed_at IS NULL OR accessed_at < ?)
-     ORDER BY importance DESC, COALESCE(accessed_at, created_at) ASC LIMIT ?`).all(...scopeParams, forgottenCutoff, limit);
-  const dupes = d.prepare(`SELECT key, COUNT(*) as cnt, MAX(updated_at) as latest, MIN(created_at) as oldest
-     FROM memories WHERE ${base}
-     GROUP BY key HAVING COUNT(*) > 1
-     ORDER BY cnt DESC LIMIT ?`).all(...scopeParams, limit);
-  return { stale, forgotten, dupes };
-}
-
-// src/server/routes/memories-stats.ts
 init_memories();
 init_router();
 addRoute("GET", "/api/memories/stats", () => {
@@ -57499,23 +57735,45 @@ addRoute("GET", "/api/activity", (_req, url) => {
 addRoute("GET", "/api/memories/stale", (_req, url) => {
   const q = getSearchParams(url);
   const days = q["days"] ? parseInt(q["days"], 10) : undefined;
-  const limit = Math.min(q["limit"] ? parseInt(q["limit"], 10) : 20, 100);
-  const memories = getStaleMemories({
+  const parsedLimit = Number(q["limit"]);
+  const limit = Number.isInteger(parsedLimit) && parsedLimit > 0 ? Math.min(parsedLimit, 1000) : 20;
+  const parsedOffset = Number(q["offset"]);
+  const offset = Number.isInteger(parsedOffset) && parsedOffset >= 0 ? parsedOffset : 0;
+  const pinned = q["pinned"] === "1" || q["pinned"] === "true" ? true : q["pinned"] === "0" || q["pinned"] === "false" ? false : undefined;
+  const page = getStaleMemoriesPage({
     days,
+    pinned,
     project_id: q["project_id"],
     agent_id: q["agent_id"],
     limit,
-    offset: q["offset"] ? parseInt(q["offset"], 10) : undefined
+    offset
   }, getDatabase());
-  return json({ memories, count: memories.length, days: Math.min(days || 30, 365) });
+  return json({
+    memories: page.rows,
+    count: page.rows.length,
+    total: page.total,
+    days: Math.min(days || 30, 365),
+    limit,
+    has_more: page.has_more,
+    next_cursor: page.next_cursor
+  });
 });
 addRoute("GET", "/api/memories/history", (_req, url) => {
   const q = getSearchParams(url);
-  const memories = listMemoryHistory({
-    limit: Math.min(q["limit"] ? parseInt(q["limit"], 10) : 20, 200),
-    offset: q["offset"] ? parseInt(q["offset"], 10) : undefined
-  }, getDatabase());
-  return json({ memories, count: memories.length });
+  const parsedLimit = Number(q["limit"]);
+  const limit = Number.isInteger(parsedLimit) && parsedLimit > 0 ? Math.min(parsedLimit, 200) : 20;
+  const parsedOffset = Number(q["offset"]);
+  const offset = Number.isInteger(parsedOffset) && parsedOffset >= 0 ? parsedOffset : 0;
+  const page = listMemoryHistoryPage({ limit, offset }, getDatabase());
+  const total = countMemoryHistory(getDatabase());
+  return json({
+    memories: page.rows,
+    count: page.rows.length,
+    total,
+    limit,
+    has_more: page.has_more,
+    next_cursor: page.next_cursor
+  });
 });
 addRoute("GET", "/api/memories/health", (_req, url) => {
   const q = getSearchParams(url);
@@ -57556,7 +57814,7 @@ function hasFts5Table2(db) {
 function buildScopeFilter(opts) {
   const conditions = [
     "m.status = 'active'",
-    "(m.expires_at IS NULL OR m.expires_at >= datetime('now'))",
+    "(m.expires_at IS NULL OR m.expires_at >= strftime('%Y-%m-%dT%H:%M:%fZ', 'now'))",
     "m.category IN ('preference', 'fact', 'knowledge')"
   ];
   const params = [];
@@ -57824,7 +58082,7 @@ async function runTemporalAgent(db, query, opts) {
   const maxResults = opts.max_results ?? 20;
   const limit = maxResults * 3;
   const conditions = [
-    "(m.expires_at IS NULL OR m.expires_at >= datetime('now'))"
+    "(m.expires_at IS NULL OR m.expires_at >= strftime('%Y-%m-%dT%H:%M:%fZ', 'now'))"
   ];
   const params = [];
   if (opts.project_id) {
@@ -58594,6 +58852,90 @@ class MementosProjectRegistrationError extends Error {
   }
 }
 
+// src/project-registration/historical-receipt.ts
+var ROOT_TENANT_ID = "adfd95c7-ee8b-52cb-ae47-4ae65dae3313";
+var FLEET_RESOURCES_HISTORICAL_PROJECT_REGISTRATION = {
+  authority: "mementos",
+  authority_route: "mementos.project-registration.v1",
+  package_version: "1.0.0-rc.3",
+  authority_id: "mementos",
+  tenant_id: "default",
+  corpus_id: "default",
+  operation_id: "op-cli-register-full",
+  step_id: "mementos_project",
+  resource_kind: "project",
+  direction: "forward",
+  target_selector: "wks_005285827590a93b70e5",
+  target_id: "mm_project_f75606ef14e51fb577a15882ba0ab8ed333b2c29",
+  idempotency_key: "prk_786cdc6babddeae1be8d5078d0f75322d1ea1010ac5d8a50",
+  receipt_id: "mmpr_a647f9908a33bb64bf137f584202590f91b72a33",
+  request_digest: "8eb0e3fee26fdb7edb8a444aeddaaedb79a84a5a36e742ae03616f62b19f5c22",
+  precondition_digest: "0b6c22fcf75d835f9f27308b1a9d40e8902e48a97da370fd56df5acacfcd968e",
+  result_revision: "2026-08-09T13:37:43.068Z",
+  result_digest: "26fb0dd5c5e20909d3653ab0ddd8fa45e5142728e4e66d595e2419f7ed40b036",
+  created_at: "2026-08-09T13:37:43.068Z",
+  identity_digest: "1108dd972c90e4989036fb6ecec7dde10f54641a697bd53cfcd64017f589ace7",
+  target_digest: "72789fcd60668eeb66ee068936d3afa96deadcb007228830c64b6de783b6dcef",
+  operation_digest: "d7e37bfb2c0d28f8c4086c53224cd855d14694f32807b74c102b61a99963f3c0",
+  idempotency_digest: "b56d8ec37efb818759cdd2ee3b58bc1401ac13384c8d64c1813bb5c198b1e376",
+  receipt_digest: "52ce90c5de6817989f107d9d27e06156962a2b9c365e34e16a57aa37886501a2",
+  response_digest: "2fa3ed508f5f192c18753b1205ced996340fdf02f735420d32db897fc239805c"
+};
+var FLEET_RESOURCES_HISTORICAL_RECEIPT = {
+  receipt_id: FLEET_RESOURCES_HISTORICAL_PROJECT_REGISTRATION.receipt_id,
+  authority: FLEET_RESOURCES_HISTORICAL_PROJECT_REGISTRATION.authority,
+  route: FLEET_RESOURCES_HISTORICAL_PROJECT_REGISTRATION.authority_route,
+  package_version: FLEET_RESOURCES_HISTORICAL_PROJECT_REGISTRATION.package_version,
+  authority_id: FLEET_RESOURCES_HISTORICAL_PROJECT_REGISTRATION.authority_id,
+  tenant_id: FLEET_RESOURCES_HISTORICAL_PROJECT_REGISTRATION.tenant_id,
+  corpus_id: FLEET_RESOURCES_HISTORICAL_PROJECT_REGISTRATION.corpus_id,
+  operation_id: FLEET_RESOURCES_HISTORICAL_PROJECT_REGISTRATION.operation_id,
+  step_id: FLEET_RESOURCES_HISTORICAL_PROJECT_REGISTRATION.step_id,
+  resource_kind: FLEET_RESOURCES_HISTORICAL_PROJECT_REGISTRATION.resource_kind,
+  direction: FLEET_RESOURCES_HISTORICAL_PROJECT_REGISTRATION.direction,
+  idempotency_key: FLEET_RESOURCES_HISTORICAL_PROJECT_REGISTRATION.idempotency_key,
+  request_digest: FLEET_RESOURCES_HISTORICAL_PROJECT_REGISTRATION.request_digest,
+  precondition_digest: FLEET_RESOURCES_HISTORICAL_PROJECT_REGISTRATION.precondition_digest,
+  outcome: "accepted",
+  reason: null,
+  target_id: FLEET_RESOURCES_HISTORICAL_PROJECT_REGISTRATION.target_id,
+  result_revision: FLEET_RESOURCES_HISTORICAL_PROJECT_REGISTRATION.result_revision,
+  result_digest: FLEET_RESOURCES_HISTORICAL_PROJECT_REGISTRATION.result_digest,
+  duplicate_of_receipt_id: null,
+  accepted_receipt_id: null,
+  created_by_operation: true,
+  created_at: FLEET_RESOURCES_HISTORICAL_PROJECT_REGISTRATION.created_at
+};
+var FLEET_RESOURCES_CURRENT_PROJECT_REGISTRATION_IDENTITY = {
+  authority_id: "mementos",
+  tenant_id: ROOT_TENANT_ID,
+  corpus_id: "mementos:postgresql"
+};
+var FLEET_RESOURCES_HISTORICAL_LOOKUP_IDENTITY = {
+  source: {
+    authority: FLEET_RESOURCES_HISTORICAL_PROJECT_REGISTRATION.authority,
+    authority_route: FLEET_RESOURCES_HISTORICAL_PROJECT_REGISTRATION.authority_route,
+    package_version: FLEET_RESOURCES_HISTORICAL_PROJECT_REGISTRATION.package_version,
+    authority_id: FLEET_RESOURCES_HISTORICAL_PROJECT_REGISTRATION.authority_id,
+    tenant_id: FLEET_RESOURCES_HISTORICAL_PROJECT_REGISTRATION.tenant_id,
+    corpus_id: FLEET_RESOURCES_HISTORICAL_PROJECT_REGISTRATION.corpus_id,
+    operation_id: FLEET_RESOURCES_HISTORICAL_PROJECT_REGISTRATION.operation_id,
+    step_id: FLEET_RESOURCES_HISTORICAL_PROJECT_REGISTRATION.step_id,
+    resource_kind: FLEET_RESOURCES_HISTORICAL_PROJECT_REGISTRATION.resource_kind,
+    direction: FLEET_RESOURCES_HISTORICAL_PROJECT_REGISTRATION.direction,
+    target_selector: FLEET_RESOURCES_HISTORICAL_PROJECT_REGISTRATION.target_selector,
+    target_id: FLEET_RESOURCES_HISTORICAL_PROJECT_REGISTRATION.target_id,
+    idempotency_key: FLEET_RESOURCES_HISTORICAL_PROJECT_REGISTRATION.idempotency_key,
+    receipt_id: FLEET_RESOURCES_HISTORICAL_PROJECT_REGISTRATION.receipt_id
+  },
+  destination: FLEET_RESOURCES_CURRENT_PROJECT_REGISTRATION_IDENTITY,
+  lookup_only: true,
+  immutable_receipt: true
+};
+function supportsFleetResourcesHistoricalReceiptLookup(capability) {
+  return capability.authority_id === FLEET_RESOURCES_CURRENT_PROJECT_REGISTRATION_IDENTITY.authority_id && capability.tenant_id === FLEET_RESOURCES_CURRENT_PROJECT_REGISTRATION_IDENTITY.tenant_id && capability.corpus_id === FLEET_RESOURCES_CURRENT_PROJECT_REGISTRATION_IDENTITY.corpus_id;
+}
+
 // src/project-registration/identity.ts
 var MEMENTOS_PROJECT_AUTHORITY_ENV = {
   authorityId: "MEMENTOS_PROJECT_AUTHORITY_ID",
@@ -58635,12 +58977,13 @@ function resolveMementosProjectAuthorityIdentity(options = {}) {
 }
 function buildMementosProjectRegistrationCapability(options = {}) {
   const identity = resolveMementosProjectAuthorityIdentity(options);
-  return {
+  const capability = {
     authority: "mementos",
     route: MEMENTOS_PROJECT_REGISTRATION_ROUTE,
     package_version: options.packageVersion ?? getMementosPackageVersion(),
     ...identity,
     supported_resources: ["project"],
+    supported_historical_lookup_identities: [],
     conditional_create: true,
     immutable_receipts: true,
     exact_terminal_lookup: true,
@@ -58659,6 +59002,12 @@ function buildMementosProjectRegistrationCapability(options = {}) {
     stable_keyset_pagination: true,
     explicit_membership_only: true
   };
+  if (supportsFleetResourcesHistoricalReceiptLookup(capability)) {
+    capability.supported_historical_lookup_identities = [
+      FLEET_RESOURCES_HISTORICAL_LOOKUP_IDENTITY
+    ];
+  }
+  return capability;
 }
 
 // src/db/memory-project-link.ts
@@ -59567,7 +59916,7 @@ function acquireLock(agentId, resourceType, resourceId, lockType = "exclusive",
   }
   const d = db || getDatabase();
   cleanExpiredLocks(d);
-  const ownLock = d.query("SELECT * FROM resource_locks WHERE resource_type = ? AND resource_id = ? AND agent_id = ? AND lock_type = ? AND expires_at > datetime('now')").get(resourceType, resourceId, agentId, lockType);
+  const ownLock = d.query("SELECT * FROM resource_locks WHERE resource_type = ? AND resource_id = ? AND agent_id = ? AND lock_type = ? AND expires_at > strftime('%Y-%m-%dT%H:%M:%fZ', 'now')").get(resourceType, resourceId, agentId, lockType);
   if (ownLock) {
     const newExpiry = new Date(Date.now() + ttlSeconds * 1000).toISOString();
     d.run("UPDATE resource_locks SET expires_at = ? WHERE id = ?", [
@@ -59577,7 +59926,7 @@ function acquireLock(agentId, resourceType, resourceId, lockType = "exclusive",
     return parseLockRow({ ...ownLock, expires_at: newExpiry });
   }
   if (lockType === "exclusive") {
-    const existing = d.query("SELECT * FROM resource_locks WHERE resource_type = ? AND resource_id = ? AND lock_type = 'exclusive' AND agent_id != ? AND expires_at > datetime('now')").get(resourceType, resourceId, agentId);
+    const existing = d.query("SELECT * FROM resource_locks WHERE resource_type = ? AND resource_id = ? AND lock_type = 'exclusive' AND agent_id != ? AND expires_at > strftime('%Y-%m-%dT%H:%M:%fZ', 'now')").get(resourceType, resourceId, agentId);
     if (existing) {
       return null;
     }
@@ -59622,7 +59971,7 @@ function checkLock(resourceType, resourceId, lockType, db) {
   }
   const d = db || getDatabase();
   cleanExpiredLocks(d);
-  const query = lockType ? "SELECT * FROM resource_locks WHERE resource_type = ? AND resource_id = ? AND lock_type = ? AND expires_at > datetime('now')" : "SELECT * FROM resource_locks WHERE resource_type = ? AND resource_id = ? AND expires_at > datetime('now')";
+  const query = lockType ? "SELECT * FROM resource_locks WHERE resource_type = ? AND resource_id = ? AND lock_type = ? AND expires_at > strftime('%Y-%m-%dT%H:%M:%fZ', 'now')" : "SELECT * FROM resource_locks WHERE resource_type = ? AND resource_id = ? AND expires_at > strftime('%Y-%m-%dT%H:%M:%fZ', 'now')";
   const rows = lockType ? d.query(query).all(resourceType, resourceId, lockType) : d.query(query).all(resourceType, resourceId);
   return rows.map(parseLockRow);
 }
@@ -59633,7 +59982,7 @@ function listAgentLocks(agentId, db) {
   }
   const d = db || getDatabase();
   cleanExpiredLocks(d);
-  const rows = d.query("SELECT * FROM resource_locks WHERE agent_id = ? AND expires_at > datetime('now') ORDER BY locked_at DESC").all(agentId);
+  const rows = d.query("SELECT * FROM resource_locks WHERE agent_id = ? AND expires_at > strftime('%Y-%m-%dT%H:%M:%fZ', 'now') ORDER BY locked_at DESC").all(agentId);
   return rows.map(parseLockRow);
 }
 function cleanExpiredLocks(db) {
@@ -59642,7 +59991,7 @@ function cleanExpiredLocks(db) {
     return data?.cleaned ?? 0;
   }
   const d = db || getDatabase();
-  const result = d.run("DELETE FROM resource_locks WHERE expires_at <= datetime('now')");
+  const result = d.run("DELETE FROM resource_locks WHERE expires_at <= strftime('%Y-%m-%dT%H:%M:%fZ', 'now')");
   return result.changes;
 }
 
@@ -60822,12 +61171,21 @@ function assertInverseRequest(request, capability) {
   }
   return accepted;
 }
+function matchesCurrentLookupIdentity(request, capability) {
+  return request.authority_route === capability.route && request.package_version === capability.package_version && request.authority_id === capability.authority_id && request.tenant_id === capability.tenant_id && request.corpus_id === capability.corpus_id;
+}
+function matchesFleetResourcesHistoricalLookup(request, capability) {
+  if (!supportsFleetResourcesHistoricalReceiptLookup(capability))
+    return false;
+  const source = FLEET_RESOURCES_HISTORICAL_LOOKUP_IDENTITY.source;
+  return request.authority === source.authority && request.authority_route === source.authority_route && request.package_version === source.package_version && request.authority_id === source.authority_id && request.tenant_id === source.tenant_id && request.corpus_id === source.corpus_id && request.operation_id === source.operation_id && request.step_id === source.step_id && request.resource_kind === source.resource_kind && request.direction === source.direction && request.target_selector === source.target_selector && request.target_id === source.target_id && request.idempotency_key === source.idempotency_key;
+}
 function assertLookup(request, capability) {
   assertBounds(request);
   if (request.max_items !== 1) {
     throw new MementosProjectRegistrationError("MEMENTOS_PROJECT_REGISTRATION_INVALID_BOUNDS", "terminal receipt lookup requires max_items exactly 1");
   }
-  if (request.authority !== "mementos" || request.resource_kind !== "project" || request.authority_route !== capability.route || request.package_version !== capability.package_version || request.authority_id !== capability.authority_id || request.tenant_id !== capability.tenant_id || request.corpus_id !== capability.corpus_id) {
+  if (request.authority !== "mementos" || request.resource_kind !== "project" || !matchesCurrentLookupIdentity(request, capability) && !matchesFleetResourcesHistoricalLookup(request, capability)) {
     throw new MementosProjectRegistrationError("MEMENTOS_PROJECT_REGISTRATION_CAPABILITY_MISMATCH", "receipt lookup does not match this authority capability identity");
   }
   requireString(request.operation_id, "operation_id", { pattern: OPERATION_PATTERN });
@@ -60845,6 +61203,7 @@ function assertLookup(request, capability) {
       pattern: PROJECT_ID_PATTERN
     });
   }
+  return matchesCurrentLookupIdentity(request, capability) ? "current" : "fleet_resources_historical";
 }
 
 class PackageOwnedMementosProjectRegistrationAuthority {
@@ -61109,11 +61468,14 @@ class PackageOwnedMementosProjectRegistrationAuthority {
   }
   async lookupReceipt(request) {
     const startedAt = Date.now();
-    assertLookup(request, this.capabilityValue);
+    const lookupIdentity = assertLookup(request, this.capabilityValue);
     const receipt = getReceiptForLookup(this.db, request);
     if (!receipt || request.target_id !== undefined && receipt.target_id !== request.target_id) {
       throw new MementosProjectRegistrationError("MEMENTOS_PROJECT_REGISTRATION_RECEIPT_NOT_FOUND", "exact immutable terminal receipt was not found");
     }
+    if (lookupIdentity === "fleet_resources_historical" && (receipt.receipt_id !== FLEET_RESOURCES_HISTORICAL_LOOKUP_IDENTITY.source.receipt_id || canonicalMementosProjectRegistrationJson(publicReceipt(receipt)) !== canonicalMementosProjectRegistrationJson(FLEET_RESOURCES_HISTORICAL_RECEIPT))) {
+      throw new MementosProjectRegistrationError("MEMENTOS_PROJECT_REGISTRATION_RECEIPT_NOT_FOUND", "exact immutable historical terminal receipt was not found");
+    }
     return withResponseControl(publicReceipt(receipt), request, startedAt);
   }
   async compensate(request) {
@@ -64720,13 +65082,11 @@ function startServer(port) {
         const profile = getActiveProfile();
         try {
           const db = getDatabase();
-          const total = db.query("SELECT COUNT(*) as c FROM memories WHERE status = 'active'").get().c;
-          const expired = db.query("SELECT COUNT(*) as c FROM memories WHERE status = 'expired' OR (expires_at IS NOT NULL AND expires_at < datetime('now'))").get().c;
-          const pinned = db.query("SELECT COUNT(*) as c FROM memories WHERE status = 'active' AND pinned = 1").get().c;
+          const stats = getMemoryStats(db);
           const agents = db.query("SELECT COUNT(*) as c FROM agents").get().c;
           const projects = db.query("SELECT COUNT(*) as c FROM projects").get().c;
-          const status = expired > 50 ? "warn" : "ok";
-          return json({ status, version: pkgVersion(), backend, profile: profile ?? "default", db_path: getDbPath(), hostname: hostname3, memories: { total, expired, pinned }, agents, projects });
+          const status = stats.expired_due_count > 50 ? "warn" : "ok";
+          return json({ status, version: pkgVersion(), backend, profile: profile ?? "default", db_path: getDbPath(), hostname: hostname3, memories: { total: stats.total, expired: stats.expired_count, expired_due: stats.expired_due_count, pinned: stats.pinned_count }, agents, projects });
         } catch (e) {
           return json({ status: "error", version: pkgVersion(), backend, error: e instanceof Error ? e.message : String(e) }, 503);
         }