@mastra/code-sdk 1.0.3-alpha.1 → 1.1.0-alpha.2

package/dist/utils/storage-maintenance.js

@@ -1,236 +1,274 @@
-import { closeSync, existsSync, openSync, readSync, renameSync, rmSync, statSync, statfsSync } from "node:fs";
-import { dirname } from "node:path";
-import Database from "libsql";
 import { getDatabasePath, getVectorDatabasePath } from "./project.js";
+import { closeSync, existsSync, openSync, readSync, renameSync, rmSync, statSync, statfsSync } from "fs";
+import { dirname } from "path";
+import Database from "libsql";
+//#region src/utils/storage-maintenance.ts
+/**
+* Storage maintenance — retention defaults and disk reclamation for mastracode.
+*
+* Retention (`DEFAULT_RETENTION`) is wired into the inner store by the storage
+* factory so `storage.prune()` can delete aged rows across every domain,
+* including the legacy libsql observability spans table.
+*
+* `prune()` only deletes rows — SQLite keeps the freed pages inside the file.
+* `reclaimLibSQLDisk()` returns that space to the OS by streaming a
+* `VACUUM INTO` copy of each file and swapping it into place. It requires all
+* connections to be closed first, so it only runs from the post-TUI
+* maintenance flow. We deliberately do NOT expose VACUUM as a public API on
+* LibSQLStore.
+*/
+/**
+* Default retention for mastracode's own storage. Tables not listed are kept
+* forever. Ages chosen for a local dev tool where observability data dwarfs
+* everything else (spans have been observed at 17+ GB):
+* - spans/logs: short-lived debugging telemetry → 14d
+* - scorer results & workflow snapshots: medium-lived run records → 30d
+* - chat history (messages/threads): long-lived, user-visible → 90d
+*/
 const DEFAULT_RETENTION = {
-  memory: {
-    messages: { maxAge: "90d" },
-    threads: { maxAge: "90d" }
-  },
-  observability: {
-    spans: { maxAge: "14d" },
-    logs: { maxAge: "14d" }
-  },
-  scores: {
-    scorers: { maxAge: "30d" }
-  },
-  workflows: {
-    workflowSnapshot: { maxAge: "30d" }
-  }
+	memory: {
+		messages: { maxAge: "90d" },
+		threads: { maxAge: "90d" }
+	},
+	observability: {
+		spans: { maxAge: "14d" },
+		logs: { maxAge: "14d" }
+	},
+	scores: { scorers: { maxAge: "30d" } },
+	workflows: { workflowSnapshot: { maxAge: "30d" } }
 };
+/** db file size + its WAL sidecar, in bytes. Missing files count as 0. */
 function fileSizeWithWal(dbFile) {
-  let total = 0;
-  for (const candidate of [dbFile, `${dbFile}-wal`]) {
-    try {
-      total += statSync(candidate).size;
-    } catch {
-    }
-  }
-  return total;
+	let total = 0;
+	for (const candidate of [dbFile, `${dbFile}-wal`]) try {
+		total += statSync(candidate).size;
+	} catch {}
+	return total;
 }
+/** Free bytes required before compacting: the compacted copy plus 20% + 256 MB headroom. */
 function requiredFreeBytes(liveBytes) {
-  return Math.ceil(liveBytes * 1.2) + 256 * 1024 * 1024;
+	return Math.ceil(liveBytes * 1.2) + 256 * 1024 * 1024;
 }
+/** First column of the first row of a PRAGMA result, as a number. */
 function pragmaNumber(db, pragma) {
-  const rows = db.pragma(pragma);
-  const row = rows?.[0];
-  return row ? Number(Object.values(row)[0]) : 0;
+	const row = db.pragma(pragma)?.[0];
+	return row ? Number(Object.values(row)[0]) : 0;
 }
+/**
+* Journal mode straight from the SQLite file header (bytes 18/19:
+* 1 = rollback journal, 2 = WAL) — readable without opening a connection.
+*/
 function journalModeFromHeader(file) {
-  const fd = openSync(file, "r");
-  try {
-    const buf = Buffer.alloc(2);
-    if (readSync(fd, buf, 0, 2, 18) !== 2) return "unknown";
-    if (buf[0] === 2 && buf[1] === 2) return "wal";
-    if (buf[0] === 1 && buf[1] === 1) return "delete";
-    return "unknown";
-  } finally {
-    closeSync(fd);
-  }
+	const fd = openSync(file, "r");
+	try {
+		const buf = Buffer.alloc(2);
+		if (readSync(fd, buf, 0, 2, 18) !== 2) return "unknown";
+		if (buf[0] === 2 && buf[1] === 2) return "wal";
+		if (buf[0] === 1 && buf[1] === 1) return "delete";
+		return "unknown";
+	} finally {
+		closeSync(fd);
+	}
 }
+/**
+* Compact each local libsql db file by streaming a `VACUUM INTO` copy next to
+* it, then swapping the copy into place. Reports before/after sizes.
+*
+* Deliberately NOT an in-place `VACUUM`: that copies all live content into a
+* temp store (held in memory by libsql builds with `temp_store=MEMORY`) and
+* then rewrites the entire database back through the WAL — on multi-GB
+* databases that has frozen whole machines via memory/IO exhaustion.
+* `VACUUM INTO` reads the logical database once and writes the compacted copy
+* sequentially with bounded memory, and the WAL never grows.
+*
+* Each file is preflighted: live bytes are estimated from
+* `page_count - freelist_count` and the copy is refused unless the volume has
+* `requiredFreeBytes()` available.
+*
+* MUST run with every connection to these files closed (the swap replaces the
+* inode — a surviving connection would keep writing to the unlinked old file).
+* `runStorageMaintenance()` closes storage before calling this.
+*/
 async function reclaimLibSQLDisk(dbFiles, onFileStart) {
-  const results = [];
-  for (const file of dbFiles) {
-    if (!existsSync(file) || statSync(file).size < 100) continue;
-    const bytesBefore = fileSizeWithWal(file);
-    const tmp = `${file}.vacuum-tmp`;
-    rmSync(tmp, { force: true });
-    const probe = new Database(file);
-    try {
-      probe.exec("PRAGMA busy_timeout = 2000");
-      probe.exec("PRAGMA journal_mode = WAL");
-      probe.exec("PRAGMA journal_mode = DELETE");
-    } catch {
-    } finally {
-      probe.close();
-    }
-    if (journalModeFromHeader(file) !== "delete") {
-      throw new Error(
-        `${file} is in use by another process \u2014 is another Mastra Code session running? Close other sessions and run /prune vacuum again.`
-      );
-    }
-    const db = new Database(file);
-    try {
-      db.exec("PRAGMA busy_timeout = 2000");
-      const pageSize = pragmaNumber(db, "page_size");
-      const pageCount = pragmaNumber(db, "page_count");
-      const freelistCount = pragmaNumber(db, "freelist_count");
-      const liveBytes = Math.max(0, pageCount - freelistCount) * pageSize;
-      const { bsize, bavail } = statfsSync(dirname(file));
-      const freeBytes = bsize * bavail;
-      if (freeBytes < requiredFreeBytes(liveBytes)) {
-        throw new Error(
-          `Not enough free disk space to compact ${file}: need ${formatBytes(requiredFreeBytes(liveBytes))} for a ${formatBytes(liveBytes)} compacted copy, but only ${formatBytes(freeBytes)} is free.`
-        );
-      }
-      onFileStart?.(file, bytesBefore, liveBytes);
-      db.exec(`VACUUM INTO '${tmp.replace(/'/g, "''")}'`);
-    } catch (err) {
-      rmSync(tmp, { force: true });
-      throw err;
-    } finally {
-      db.close();
-    }
-    if (journalModeFromHeader(file) !== "delete") {
-      rmSync(tmp, { force: true });
-      throw new Error(
-        `${file} was opened by another process during compaction \u2014 is another Mastra Code session running? Close other sessions and run /prune vacuum again.`
-      );
-    }
-    renameSync(file, `${file}.old`);
-    try {
-      rmSync(`${file}-wal`, { force: true });
-      rmSync(`${file}-shm`, { force: true });
-      renameSync(tmp, file);
-    } catch (err) {
-      try {
-        renameSync(`${file}.old`, file);
-      } catch {
-        throw new Error(
-          `Failed to swap compacted copy into place AND failed to restore the original \u2014 your data is intact at ${file}.old; rename it back to ${file} manually. Original error: ${err instanceof Error ? err.message : String(err)}`
-        );
-      }
-      rmSync(tmp, { force: true });
-      throw err;
-    }
-    rmSync(`${file}.old`, { force: true });
-    results.push({ file, bytesBefore, bytesAfter: fileSizeWithWal(file) });
-  }
-  return results;
+	const results = [];
+	for (const file of dbFiles) {
+		if (!existsSync(file) || statSync(file).size < 100) continue;
+		const bytesBefore = fileSizeWithWal(file);
+		const tmp = `${file}.vacuum-tmp`;
+		rmSync(tmp, { force: true });
+		const probe = new Database(file);
+		try {
+			probe.exec("PRAGMA busy_timeout = 2000");
+			probe.exec("PRAGMA journal_mode = WAL");
+			probe.exec("PRAGMA journal_mode = DELETE");
+		} catch {} finally {
+			probe.close();
+		}
+		if (journalModeFromHeader(file) !== "delete") throw new Error(`${file} is in use by another process — is another Mastra Code session running? Close other sessions and run /prune vacuum again.`);
+		const db = new Database(file);
+		try {
+			db.exec("PRAGMA busy_timeout = 2000");
+			const pageSize = pragmaNumber(db, "page_size");
+			const pageCount = pragmaNumber(db, "page_count");
+			const freelistCount = pragmaNumber(db, "freelist_count");
+			const liveBytes = Math.max(0, pageCount - freelistCount) * pageSize;
+			const { bsize, bavail } = statfsSync(dirname(file));
+			const freeBytes = bsize * bavail;
+			if (freeBytes < requiredFreeBytes(liveBytes)) throw new Error(`Not enough free disk space to compact ${file}: need ${formatBytes(requiredFreeBytes(liveBytes))} for a ${formatBytes(liveBytes)} compacted copy, but only ${formatBytes(freeBytes)} is free.`);
+			onFileStart?.(file, bytesBefore, liveBytes);
+			db.exec(`VACUUM INTO '${tmp.replace(/'/g, "''")}'`);
+		} catch (err) {
+			rmSync(tmp, { force: true });
+			throw err;
+		} finally {
+			db.close();
+		}
+		if (journalModeFromHeader(file) !== "delete") {
+			rmSync(tmp, { force: true });
+			throw new Error(`${file} was opened by another process during compaction — is another Mastra Code session running? Close other sessions and run /prune vacuum again.`);
+		}
+		renameSync(file, `${file}.old`);
+		try {
+			rmSync(`${file}-wal`, { force: true });
+			rmSync(`${file}-shm`, { force: true });
+			renameSync(tmp, file);
+		} catch (err) {
+			try {
+				renameSync(`${file}.old`, file);
+			} catch {
+				throw new Error(`Failed to swap compacted copy into place AND failed to restore the original — your data is intact at ${file}.old; rename it back to ${file} manually. Original error: ${err instanceof Error ? err.message : String(err)}`);
+			}
+			rmSync(tmp, { force: true });
+			throw err;
+		}
+		rmSync(`${file}.old`, { force: true });
+		results.push({
+			file,
+			bytesBefore,
+			bytesAfter: fileSizeWithWal(file)
+		});
+	}
+	return results;
 }
+/** `file:/path` or `file:///path` → filesystem path; undefined for non-file urls. */
 function fileUrlToPath(url) {
-  if (!url.startsWith("file:")) return void 0;
-  return url.replace(/^file:\/\//, "").replace(/^file:/, "");
+	if (!url.startsWith("file:")) return void 0;
+	return url.replace(/^file:\/\//, "").replace(/^file:/, "");
 }
+/**
+* Resolve the local libsql db files eligible for checkpoint + VACUUM.
+* Returns [] for remote (turso) urls and PG backends. When PG was requested
+* but the factory fell back to libsql, the fallback uses the default files.
+*/
 function resolveLocalDbFiles(config, effectiveBackend) {
-  if (effectiveBackend !== "libsql") return [];
-  if (config.backend === "pg") {
-    return [getDatabasePath(), getVectorDatabasePath()];
-  }
-  if (config.isRemote) return [];
-  const files = [];
-  const main = fileUrlToPath(config.url);
-  if (main) files.push(main);
-  const vector = config.vectorUrl ? fileUrlToPath(config.vectorUrl) : getVectorDatabasePath();
-  if (vector) files.push(vector);
-  return files;
+	if (effectiveBackend !== "libsql") return [];
+	if (config.backend === "pg") return [getDatabasePath(), getVectorDatabasePath()];
+	if (config.isRemote) return [];
+	const files = [];
+	const main = fileUrlToPath(config.url);
+	if (main) files.push(main);
+	const vector = config.vectorUrl ? fileUrlToPath(config.vectorUrl) : getVectorDatabasePath();
+	if (vector) files.push(vector);
+	return files;
 }
+/**
+* Build the maintenance handle for the effective storage backend.
+* `localDbFiles` are the local libsql file paths eligible for VACUUM;
+* pass an empty array for remote (turso) or PG backends.
+*/
 function createStorageMaintenance(opts) {
-  const { storage, backend, retention, localDbFiles, closeVector } = opts;
-  return {
-    backend,
-    retention,
-    prune: (options) => storage.prune(options),
-    closeStorage: async () => {
-      await storage.close?.();
-      await closeVector?.();
-    },
-    ...backend === "libsql" && localDbFiles.length > 0 ? {
-      reclaimDisk: (onFileStart) => reclaimLibSQLDisk(localDbFiles, onFileStart)
-    } : {}
-  };
+	const { storage, backend, retention, localDbFiles, closeVector } = opts;
+	return {
+		backend,
+		retention,
+		prune: (options) => storage.prune(options),
+		closeStorage: async () => {
+			await storage.close?.();
+			await closeVector?.();
+		},
+		...backend === "libsql" && localDbFiles.length > 0 ? { reclaimDisk: (onFileStart) => reclaimLibSQLDisk(localDbFiles, onFileStart) } : {}
+	};
 }
 function formatBytes(bytes) {
-  if (bytes < 1024) return `${bytes} B`;
-  const units = ["KB", "MB", "GB", "TB"];
-  let value = bytes;
-  let unit = "B";
-  for (const next of units) {
-    if (value < 1024) break;
-    value /= 1024;
-    unit = next;
-  }
-  return `${value.toFixed(1)} ${unit}`;
+	if (bytes < 1024) return `${bytes} B`;
+	const units = [
+		"KB",
+		"MB",
+		"GB",
+		"TB"
+	];
+	let value = bytes;
+	let unit = "B";
+	for (const next of units) {
+		if (value < 1024) break;
+		value /= 1024;
+		unit = next;
+	}
+	return `${value.toFixed(1)} ${unit}`;
 }
+/** Rows deleted per table per pass: default batchSize (1000) × 20 batches. */
 const PASS_MAX_BATCHES = 20;
+/**
+* Run storage maintenance with exclusive access to the database, reporting
+* progress through `log` (one line per pass so large deletes are visible).
+*
+* Must run AFTER the TUI is stopped and background writers are quiesced —
+* batched deletes and VACUUM contend with live writes (SQLITE_BUSY) and can
+* starve the event loop that renders the TUI. The storage connection is
+* closed at the end (checkpointing the WAL for local libsql), so the process
+* must exit afterwards.
+*/
 async function runStorageMaintenance(opts) {
-  const { maintenance, vacuum, keepMemory = false, log } = opts;
-  const { memory: _memory, ...withoutMemory } = maintenance.retention;
-  const retentionForRun = keepMemory ? { retention: withoutMemory } : {};
-  log("Pruning rows older than the retention policies:");
-  for (const [domain, tables] of Object.entries(maintenance.retention)) {
-    for (const [table, policy] of Object.entries(tables ?? {})) {
-      const kept = keepMemory && domain === "memory";
-      log(`  ${domain}.${table}: ${kept ? "kept (keep-memory)" : policy.maxAge}`);
-    }
-  }
-  const totals = /* @__PURE__ */ new Map();
-  for (; ; ) {
-    const results = await maintenance.prune({ maxBatches: PASS_MAX_BATCHES, ...retentionForRun });
-    if (results.length === 0) break;
-    let remaining = false;
-    let deletedThisPass = 0;
-    for (const r of results) {
-      const key = `${r.domain}.${r.table}`;
-      totals.set(key, (totals.get(key) ?? 0) + r.deleted);
-      deletedThisPass += r.deleted;
-      if (!r.done) remaining = true;
-      if (r.deleted > 0) {
-        log(`  ${key}: ${totals.get(key)} rows deleted${r.done ? "" : " so far\u2026"}`);
-      }
-    }
-    if (!remaining) break;
-    if (deletedThisPass === 0) {
-      log("  stopping: no progress in the last pass.");
-      break;
-    }
-  }
-  const totalDeleted = [...totals.values()].reduce((sum, n) => sum + n, 0);
-  log(
-    totalDeleted === 0 ? "Nothing to prune \u2014 no retention-eligible rows found." : `Prune complete: ${totalDeleted} rows deleted.`
-  );
-  await maintenance.closeStorage?.();
-  if (!vacuum) {
-    if (maintenance.reclaimDisk) {
-      log("Deleted rows free pages inside the db file but not on disk. Run /prune vacuum to reclaim disk space.");
-    }
-    return;
-  }
-  if (!maintenance.reclaimDisk) {
-    log("Disk reclamation (VACUUM) is only available for local libsql storage.");
-    return;
-  }
-  log("Reclaiming disk (compacting database files)\u2026 this can take several minutes on large databases.");
-  const reclaimed = await maintenance.reclaimDisk((file, bytesBefore, liveBytes) => {
-    log(`  vacuuming ${file} (${formatBytes(bytesBefore)}, ~${formatBytes(liveBytes)} live)\u2026`);
-  });
-  if (reclaimed.length === 0) {
-    log("No local database files found to vacuum.");
-    return;
-  }
-  for (const r of reclaimed) {
-    log(`  ${r.file}: ${formatBytes(r.bytesBefore)} \u2192 ${formatBytes(r.bytesAfter)}`);
-  }
-  const saved = reclaimed.reduce((sum, r) => sum + Math.max(0, r.bytesBefore - r.bytesAfter), 0);
-  log(`Reclaimed ${formatBytes(saved)}.`);
+	const { maintenance, vacuum, keepMemory = false, log } = opts;
+	const { memory: _memory, ...withoutMemory } = maintenance.retention;
+	const retentionForRun = keepMemory ? { retention: withoutMemory } : {};
+	log("Pruning rows older than the retention policies:");
+	for (const [domain, tables] of Object.entries(maintenance.retention)) for (const [table, policy] of Object.entries(tables ?? {})) log(`  ${domain}.${table}: ${keepMemory && domain === "memory" ? "kept (keep-memory)" : policy.maxAge}`);
+	const totals = /* @__PURE__ */ new Map();
+	for (;;) {
+		const results = await maintenance.prune({
+			maxBatches: PASS_MAX_BATCHES,
+			...retentionForRun
+		});
+		if (results.length === 0) break;
+		let remaining = false;
+		let deletedThisPass = 0;
+		for (const r of results) {
+			const key = `${r.domain}.${r.table}`;
+			totals.set(key, (totals.get(key) ?? 0) + r.deleted);
+			deletedThisPass += r.deleted;
+			if (!r.done) remaining = true;
+			if (r.deleted > 0) log(`  ${key}: ${totals.get(key)} rows deleted${r.done ? "" : " so far…"}`);
+		}
+		if (!remaining) break;
+		if (deletedThisPass === 0) {
+			log("  stopping: no progress in the last pass.");
+			break;
+		}
+	}
+	const totalDeleted = [...totals.values()].reduce((sum, n) => sum + n, 0);
+	log(totalDeleted === 0 ? "Nothing to prune — no retention-eligible rows found." : `Prune complete: ${totalDeleted} rows deleted.`);
+	await maintenance.closeStorage?.();
+	if (!vacuum) {
+		if (maintenance.reclaimDisk) log("Deleted rows free pages inside the db file but not on disk. Run /prune vacuum to reclaim disk space.");
+		return;
+	}
+	if (!maintenance.reclaimDisk) {
+		log("Disk reclamation (VACUUM) is only available for local libsql storage.");
+		return;
+	}
+	log("Reclaiming disk (compacting database files)… this can take several minutes on large databases.");
+	const reclaimed = await maintenance.reclaimDisk((file, bytesBefore, liveBytes) => {
+		log(`  vacuuming ${file} (${formatBytes(bytesBefore)}, ~${formatBytes(liveBytes)} live)…`);
+	});
+	if (reclaimed.length === 0) {
+		log("No local database files found to vacuum.");
+		return;
+	}
+	for (const r of reclaimed) log(`  ${r.file}: ${formatBytes(r.bytesBefore)} → ${formatBytes(r.bytesAfter)}`);
+	log(`Reclaimed ${formatBytes(reclaimed.reduce((sum, r) => sum + Math.max(0, r.bytesBefore - r.bytesAfter), 0))}.`);
 }
-export {
-  DEFAULT_RETENTION,
-  createStorageMaintenance,
-  formatBytes,
-  reclaimLibSQLDisk,
-  requiredFreeBytes,
-  resolveLocalDbFiles,
-  runStorageMaintenance
-};
+//#endregion
+export { DEFAULT_RETENTION, createStorageMaintenance, formatBytes, reclaimLibSQLDisk, requiredFreeBytes, resolveLocalDbFiles, runStorageMaintenance };
+
 //# sourceMappingURL=storage-maintenance.js.map

package/dist/utils/storage-maintenance.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/storage-maintenance.ts"],"sourcesContent":["/**\n * Storage maintenance — retention defaults and disk reclamation for mastracode.\n *\n * Retention (`DEFAULT_RETENTION`) is wired into the inner store by the storage\n * factory so `storage.prune()` can delete aged rows across every domain,\n * including the legacy libsql observability spans table.\n *\n * `prune()` only deletes rows — SQLite keeps the freed pages inside the file.\n * `reclaimLibSQLDisk()` returns that space to the OS by streaming a\n * `VACUUM INTO` copy of each file and swapping it into place. It requires all\n * connections to be closed first, so it only runs from the post-TUI\n * maintenance flow. We deliberately do NOT expose VACUUM as a public API on\n * LibSQLStore.\n */\n\nimport { closeSync, existsSync, openSync, readSync, renameSync, rmSync, statSync, statfsSync } from 'node:fs';\nimport { dirname } from 'node:path';\n\nimport type { MastraCompositeStore, PruneOptions, PruneResult, RetentionConfig } from '@mastra/core/storage';\n// Native `libsql` driver, deliberately alongside `@libsql/client` (used by the\n// stores): maintenance needs deterministic connection close for the\n// exclusivity probe, and the wrapper's close() can leave the file lock held\n// until GC finalizes cached statements. Don't \"clean up\" either dependency.\n// Upstream report: https://github.com/tursodatabase/libsql-js/issues/228\nimport Database from 'libsql';\n\nimport type { StorageConfig } from './project.js';\nimport { getDatabasePath, getVectorDatabasePath } from './project.js';\n\n/**\n * Default retention for mastracode's own storage. Tables not listed are kept\n * forever. Ages chosen for a local dev tool where observability data dwarfs\n * everything else (spans have been observed at 17+ GB):\n * - spans/logs: short-lived debugging telemetry → 14d\n * - scorer results & workflow snapshots: medium-lived run records → 30d\n * - chat history (messages/threads): long-lived, user-visible → 90d\n */\nexport const DEFAULT_RETENTION: RetentionConfig = {\n  memory: {\n    messages: { maxAge: '90d' },\n    threads: { maxAge: '90d' },\n  },\n  observability: {\n    spans: { maxAge: '14d' },\n    logs: { maxAge: '14d' },\n  },\n  scores: {\n    scorers: { maxAge: '30d' },\n  },\n  workflows: {\n    workflowSnapshot: { maxAge: '30d' },\n  },\n};\n\n/** Result of reclaiming disk for one database file (sizes include the WAL). */\nexport interface ReclaimResult {\n  file: string;\n  bytesBefore: number;\n  bytesAfter: number;\n}\n\n/** Handle the TUI uses to run storage maintenance without reaching into store internals. */\nexport interface StorageMaintenance {\n  backend: 'libsql' | 'pg';\n  /** Retention policies in effect (for display in /prune output). */\n  retention: RetentionConfig;\n  /** Delete rows older than the retention policies. Safe to re-run; batched and cancellable. `options.retention` replaces the standing policies for this call only. */\n  prune: (options?: PruneOptions) => Promise<PruneResult[]>;\n  /** Close the long-lived storage connection (checkpoints WAL for local libsql). Nothing can use the store afterwards. */\n  closeStorage?: () => Promise<void>;\n  /** Compact local libsql files (VACUUM INTO + swap) to return freed pages to the OS. Only set for local libsql backends. */\n  reclaimDisk?: (\n    onFileStart?: (file: string, bytesBefore: number, liveBytes: number) => void,\n  ) => Promise<ReclaimResult[]>;\n}\n\n/** db file size + its WAL sidecar, in bytes. Missing files count as 0. */\nfunction fileSizeWithWal(dbFile: string): number {\n  let total = 0;\n  for (const candidate of [dbFile, `${dbFile}-wal`]) {\n    try {\n      total += statSync(candidate).size;\n    } catch {\n      // file may not exist (e.g. WAL already truncated)\n    }\n  }\n  return total;\n}\n\n/** Free bytes required before compacting: the compacted copy plus 20% + 256 MB headroom. */\nexport function requiredFreeBytes(liveBytes: number): number {\n  return Math.ceil(liveBytes * 1.2) + 256 * 1024 * 1024;\n}\n\n/** First column of the first row of a PRAGMA result, as a number. */\nfunction pragmaNumber(db: InstanceType<typeof Database>, pragma: string): number {\n  const rows = db.pragma(pragma) as Array<Record<string, unknown>> | undefined;\n  const row = rows?.[0];\n  return row ? Number(Object.values(row)[0]) : 0;\n}\n\n/**\n * Journal mode straight from the SQLite file header (bytes 18/19:\n * 1 = rollback journal, 2 = WAL) — readable without opening a connection.\n */\nfunction journalModeFromHeader(file: string): 'wal' | 'delete' | 'unknown' {\n  const fd = openSync(file, 'r');\n  try {\n    const buf = Buffer.alloc(2);\n    if (readSync(fd, buf, 0, 2, 18) !== 2) return 'unknown';\n    if (buf[0] === 2 && buf[1] === 2) return 'wal';\n    if (buf[0] === 1 && buf[1] === 1) return 'delete';\n    return 'unknown';\n  } finally {\n    closeSync(fd);\n  }\n}\n\n/**\n * Compact each local libsql db file by streaming a `VACUUM INTO` copy next to\n * it, then swapping the copy into place. Reports before/after sizes.\n *\n * Deliberately NOT an in-place `VACUUM`: that copies all live content into a\n * temp store (held in memory by libsql builds with `temp_store=MEMORY`) and\n * then rewrites the entire database back through the WAL — on multi-GB\n * databases that has frozen whole machines via memory/IO exhaustion.\n * `VACUUM INTO` reads the logical database once and writes the compacted copy\n * sequentially with bounded memory, and the WAL never grows.\n *\n * Each file is preflighted: live bytes are estimated from\n * `page_count - freelist_count` and the copy is refused unless the volume has\n * `requiredFreeBytes()` available.\n *\n * MUST run with every connection to these files closed (the swap replaces the\n * inode — a surviving connection would keep writing to the unlinked old file).\n * `runStorageMaintenance()` closes storage before calling this.\n */\nexport async function reclaimLibSQLDisk(\n  dbFiles: string[],\n  onFileStart?: (file: string, bytesBefore: number, liveBytes: number) => void,\n): Promise<ReclaimResult[]> {\n  const results: ReclaimResult[] = [];\n  for (const file of dbFiles) {\n    // Skip missing files and files too small to have a SQLite header — nothing to reclaim\n    if (!existsSync(file) || statSync(file).size < 100) continue;\n    const bytesBefore = fileSizeWithWal(file);\n    const tmp = `${file}.vacuum-tmp`;\n    rmSync(tmp, { force: true });\n    // Prove we're the only connection before the swap: every open WAL-mode\n    // connection (all Mastra Code sessions run WAL) holds a shared-memory\n    // lock, so switching WAL -> DELETE only succeeds with exclusive access.\n    // A surviving connection would keep writing to the unlinked old inode\n    // after the swap and silently lose data.\n    //\n    // The probe uses exec() only and verifies the outcome from the SQLite\n    // file header: prepared statements (including db.pragma()) pin a libsql\n    // connection open past close(), so a failed in-connection probe would\n    // itself hold the WAL lock and poison every retry in this process.\n    // Upstream bug (libsql 0.5.x / @libsql/client 0.17.x): Database.close()\n    // does not finalize outstanding statements — they are only finalized by\n    // GC, so lock release after close() is nondeterministic. Reported as\n    // https://github.com/tursodatabase/libsql-js/issues/228 (fix in flight in\n    // PR #214). Once that lands, the header check can become a plain\n    // journal_mode query.\n    const probe = new Database(file);\n    try {\n      probe.exec('PRAGMA busy_timeout = 2000');\n      // Round-trip through WAL so the probe also works when a clean shutdown\n      // already left the file in rollback mode.\n      probe.exec('PRAGMA journal_mode = WAL');\n      probe.exec('PRAGMA journal_mode = DELETE');\n    } catch {\n      // busy — the header check below reports the failure\n    } finally {\n      probe.close();\n    }\n    if (journalModeFromHeader(file) !== 'delete') {\n      throw new Error(\n        `${file} is in use by another process — is another Mastra Code session running? ` +\n          `Close other sessions and run /prune vacuum again.`,\n      );\n    }\n    // Native `libsql` driver, not `@libsql/client`: the wrapper's close() can\n    // leave the file lock held in-process (cached statements), which would\n    // block other connections afterwards. This connection stays in rollback\n    // mode, so even a pinned statement holds no lock once we're done.\n    const db = new Database(file);\n    try {\n      db.exec('PRAGMA busy_timeout = 2000');\n      const pageSize = pragmaNumber(db, 'page_size');\n      const pageCount = pragmaNumber(db, 'page_count');\n      const freelistCount = pragmaNumber(db, 'freelist_count');\n      const liveBytes = Math.max(0, pageCount - freelistCount) * pageSize;\n      const { bsize, bavail } = statfsSync(dirname(file));\n      const freeBytes = bsize * bavail;\n      if (freeBytes < requiredFreeBytes(liveBytes)) {\n        throw new Error(\n          `Not enough free disk space to compact ${file}: need ${formatBytes(requiredFreeBytes(liveBytes))} ` +\n            `for a ${formatBytes(liveBytes)} compacted copy, but only ${formatBytes(freeBytes)} is free.`,\n        );\n      }\n      onFileStart?.(file, bytesBefore, liveBytes);\n      db.exec(`VACUUM INTO '${tmp.replace(/'/g, \"''\")}'`);\n    } catch (err) {\n      rmSync(tmp, { force: true });\n      throw err;\n    } finally {\n      db.close();\n    }\n    // Re-probe right before the swap: `VACUUM INTO` can take tens of seconds\n    // on multi-GB files, and a session started in that window reopens the db\n    // in WAL mode (flipping the header back). Swapping under it would orphan\n    // that session's inode and silently lose its writes.\n    if (journalModeFromHeader(file) !== 'delete') {\n      rmSync(tmp, { force: true });\n      throw new Error(\n        `${file} was opened by another process during compaction — is another Mastra Code session running? ` +\n          `Close other sessions and run /prune vacuum again.`,\n      );\n    }\n    // Swap the compacted copy into place. The old WAL/SHM sidecars belong to\n    // the old inode — they must never be paired with the new file. If any step\n    // after the first rename fails, restore the original so the db path is\n    // never left empty (a naive restart would otherwise create a fresh db).\n    renameSync(file, `${file}.old`);\n    try {\n      rmSync(`${file}-wal`, { force: true });\n      rmSync(`${file}-shm`, { force: true });\n      renameSync(tmp, file);\n    } catch (err) {\n      try {\n        renameSync(`${file}.old`, file);\n      } catch {\n        throw new Error(\n          `Failed to swap compacted copy into place AND failed to restore the original — ` +\n            `your data is intact at ${file}.old; rename it back to ${file} manually. ` +\n            `Original error: ${err instanceof Error ? err.message : String(err)}`,\n        );\n      }\n      rmSync(tmp, { force: true });\n      throw err;\n    }\n    rmSync(`${file}.old`, { force: true });\n    results.push({ file, bytesBefore, bytesAfter: fileSizeWithWal(file) });\n  }\n  return results;\n}\n\n/** `file:/path` or `file:///path` → filesystem path; undefined for non-file urls. */\nfunction fileUrlToPath(url: string): string | undefined {\n  if (!url.startsWith('file:')) return undefined;\n  return url.replace(/^file:\\/\\//, '').replace(/^file:/, '');\n}\n\n/**\n * Resolve the local libsql db files eligible for checkpoint + VACUUM.\n * Returns [] for remote (turso) urls and PG backends. When PG was requested\n * but the factory fell back to libsql, the fallback uses the default files.\n */\nexport function resolveLocalDbFiles(config: StorageConfig, effectiveBackend: 'libsql' | 'pg'): string[] {\n  if (effectiveBackend !== 'libsql') return [];\n  if (config.backend === 'pg') {\n    // PG requested but fell back to the default local libsql files\n    return [getDatabasePath(), getVectorDatabasePath()];\n  }\n  if (config.isRemote) return [];\n  const files: string[] = [];\n  const main = fileUrlToPath(config.url);\n  if (main) files.push(main);\n  const vector = config.vectorUrl ? fileUrlToPath(config.vectorUrl) : getVectorDatabasePath();\n  if (vector) files.push(vector);\n  return files;\n}\n\n/**\n * Build the maintenance handle for the effective storage backend.\n * `localDbFiles` are the local libsql file paths eligible for VACUUM;\n * pass an empty array for remote (turso) or PG backends.\n */\nexport function createStorageMaintenance(opts: {\n  storage: MastraCompositeStore;\n  backend: 'libsql' | 'pg';\n  retention: RetentionConfig;\n  localDbFiles: string[];\n  /** Closes the vector store's connection; required for local libsql so the compaction swap isn't blocked by our own handle. */\n  closeVector?: () => Promise<void>;\n}): StorageMaintenance {\n  const { storage, backend, retention, localDbFiles, closeVector } = opts;\n  return {\n    backend,\n    retention,\n    prune: options => storage.prune(options),\n    closeStorage: async () => {\n      await storage.close?.();\n      await closeVector?.();\n    },\n    ...(backend === 'libsql' && localDbFiles.length > 0\n      ? {\n          reclaimDisk: (onFileStart?: (file: string, bytesBefore: number, liveBytes: number) => void) =>\n            reclaimLibSQLDisk(localDbFiles, onFileStart),\n        }\n      : {}),\n  };\n}\n\nexport function formatBytes(bytes: number): string {\n  if (bytes < 1024) return `${bytes} B`;\n  const units = ['KB', 'MB', 'GB', 'TB'];\n  let value = bytes;\n  let unit = 'B';\n  for (const next of units) {\n    if (value < 1024) break;\n    value /= 1024;\n    unit = next;\n  }\n  return `${value.toFixed(1)} ${unit}`;\n}\n\n/** Rows deleted per table per pass: default batchSize (1000) × 20 batches. */\nconst PASS_MAX_BATCHES = 20;\n\n/**\n * Run storage maintenance with exclusive access to the database, reporting\n * progress through `log` (one line per pass so large deletes are visible).\n *\n * Must run AFTER the TUI is stopped and background writers are quiesced —\n * batched deletes and VACUUM contend with live writes (SQLITE_BUSY) and can\n * starve the event loop that renders the TUI. The storage connection is\n * closed at the end (checkpointing the WAL for local libsql), so the process\n * must exit afterwards.\n */\nexport async function runStorageMaintenance(opts: {\n  maintenance: StorageMaintenance;\n  vacuum: boolean;\n  /** Skip the memory domain (messages/threads) so chat history is preserved. */\n  keepMemory?: boolean;\n  log: (line: string) => void;\n}): Promise<void> {\n  const { maintenance, vacuum, keepMemory = false, log } = opts;\n\n  // keep-memory: prune with the standing policies minus the memory domain,\n  // for this run only. The configured retention is untouched.\n  const { memory: _memory, ...withoutMemory } = maintenance.retention;\n  const retentionForRun = keepMemory ? { retention: withoutMemory } : {};\n\n  log('Pruning rows older than the retention policies:');\n  for (const [domain, tables] of Object.entries(maintenance.retention)) {\n    for (const [table, policy] of Object.entries(tables ?? {})) {\n      const kept = keepMemory && domain === 'memory';\n      log(`  ${domain}.${table}: ${kept ? 'kept (keep-memory)' : (policy as { maxAge: string | number }).maxAge}`);\n    }\n  }\n\n  const totals = new Map<string, number>();\n  for (;;) {\n    const results = await maintenance.prune({ maxBatches: PASS_MAX_BATCHES, ...retentionForRun });\n    if (results.length === 0) break;\n    let remaining = false;\n    let deletedThisPass = 0;\n    for (const r of results) {\n      const key = `${r.domain}.${r.table}`;\n      totals.set(key, (totals.get(key) ?? 0) + r.deleted);\n      deletedThisPass += r.deleted;\n      if (!r.done) remaining = true;\n      if (r.deleted > 0) {\n        log(`  ${key}: ${totals.get(key)} rows deleted${r.done ? '' : ' so far…'}`);\n      }\n    }\n    if (!remaining) break;\n    // Safety valve: a table reported more eligible rows but nothing was\n    // deleted this pass — bail instead of spinning forever.\n    if (deletedThisPass === 0) {\n      log('  stopping: no progress in the last pass.');\n      break;\n    }\n  }\n  const totalDeleted = [...totals.values()].reduce((sum, n) => sum + n, 0);\n  log(\n    totalDeleted === 0\n      ? 'Nothing to prune — no retention-eligible rows found.'\n      : `Prune complete: ${totalDeleted} rows deleted.`,\n  );\n\n  // Release the long-lived connection: checkpoints the WAL for local libsql\n  // and guarantees VACUUM below isn't blocked by our own open handles.\n  await maintenance.closeStorage?.();\n\n  if (!vacuum) {\n    if (maintenance.reclaimDisk) {\n      log('Deleted rows free pages inside the db file but not on disk. Run /prune vacuum to reclaim disk space.');\n    }\n    return;\n  }\n\n  if (!maintenance.reclaimDisk) {\n    log('Disk reclamation (VACUUM) is only available for local libsql storage.');\n    return;\n  }\n\n  log('Reclaiming disk (compacting database files)… this can take several minutes on large databases.');\n  const reclaimed = await maintenance.reclaimDisk((file, bytesBefore, liveBytes) => {\n    log(`  vacuuming ${file} (${formatBytes(bytesBefore)}, ~${formatBytes(liveBytes)} live)…`);\n  });\n  if (reclaimed.length === 0) {\n    log('No local database files found to vacuum.');\n    return;\n  }\n  for (const r of reclaimed) {\n    log(`  ${r.file}: ${formatBytes(r.bytesBefore)} → ${formatBytes(r.bytesAfter)}`);\n  }\n  const saved = reclaimed.reduce((sum, r) => sum + Math.max(0, r.bytesBefore - r.bytesAfter), 0);\n  log(`Reclaimed ${formatBytes(saved)}.`);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"file":"storage-maintenance.js","names":[],"sources":["../../src/utils/storage-maintenance.ts"],"sourcesContent":["/**\n * Storage maintenance — retention defaults and disk reclamation for mastracode.\n *\n * Retention (`DEFAULT_RETENTION`) is wired into the inner store by the storage\n * factory so `storage.prune()` can delete aged rows across every domain,\n * including the legacy libsql observability spans table.\n *\n * `prune()` only deletes rows — SQLite keeps the freed pages inside the file.\n * `reclaimLibSQLDisk()` returns that space to the OS by streaming a\n * `VACUUM INTO` copy of each file and swapping it into place. It requires all\n * connections to be closed first, so it only runs from the post-TUI\n * maintenance flow. We deliberately do NOT expose VACUUM as a public API on\n * LibSQLStore.\n */\n\nimport { closeSync, existsSync, openSync, readSync, renameSync, rmSync, statSync, statfsSync } from 'node:fs';\nimport { dirname } from 'node:path';\n\nimport type { MastraCompositeStore, PruneOptions, PruneResult, RetentionConfig } from '@mastra/core/storage';\n// Native `libsql` driver, deliberately alongside `@libsql/client` (used by the\n// stores): maintenance needs deterministic connection close for the\n// exclusivity probe, and the wrapper's close() can leave the file lock held\n// until GC finalizes cached statements. Don't \"clean up\" either dependency.\n// Upstream report: https://github.com/tursodatabase/libsql-js/issues/228\nimport Database from 'libsql';\n\nimport type { StorageConfig } from './project.js';\nimport { getDatabasePath, getVectorDatabasePath } from './project.js';\n\n/**\n * Default retention for mastracode's own storage. Tables not listed are kept\n * forever. Ages chosen for a local dev tool where observability data dwarfs\n * everything else (spans have been observed at 17+ GB):\n * - spans/logs: short-lived debugging telemetry → 14d\n * - scorer results & workflow snapshots: medium-lived run records → 30d\n * - chat history (messages/threads): long-lived, user-visible → 90d\n */\nexport const DEFAULT_RETENTION: RetentionConfig = {\n  memory: {\n    messages: { maxAge: '90d' },\n    threads: { maxAge: '90d' },\n  },\n  observability: {\n    spans: { maxAge: '14d' },\n    logs: { maxAge: '14d' },\n  },\n  scores: {\n    scorers: { maxAge: '30d' },\n  },\n  workflows: {\n    workflowSnapshot: { maxAge: '30d' },\n  },\n};\n\n/** Result of reclaiming disk for one database file (sizes include the WAL). */\nexport interface ReclaimResult {\n  file: string;\n  bytesBefore: number;\n  bytesAfter: number;\n}\n\n/** Handle the TUI uses to run storage maintenance without reaching into store internals. */\nexport interface StorageMaintenance {\n  backend: 'libsql' | 'pg';\n  /** Retention policies in effect (for display in /prune output). */\n  retention: RetentionConfig;\n  /** Delete rows older than the retention policies. Safe to re-run; batched and cancellable. `options.retention` replaces the standing policies for this call only. */\n  prune: (options?: PruneOptions) => Promise<PruneResult[]>;\n  /** Close the long-lived storage connection (checkpoints WAL for local libsql). Nothing can use the store afterwards. */\n  closeStorage?: () => Promise<void>;\n  /** Compact local libsql files (VACUUM INTO + swap) to return freed pages to the OS. Only set for local libsql backends. */\n  reclaimDisk?: (\n    onFileStart?: (file: string, bytesBefore: number, liveBytes: number) => void,\n  ) => Promise<ReclaimResult[]>;\n}\n\n/** db file size + its WAL sidecar, in bytes. Missing files count as 0. */\nfunction fileSizeWithWal(dbFile: string): number {\n  let total = 0;\n  for (const candidate of [dbFile, `${dbFile}-wal`]) {\n    try {\n      total += statSync(candidate).size;\n    } catch {\n      // file may not exist (e.g. WAL already truncated)\n    }\n  }\n  return total;\n}\n\n/** Free bytes required before compacting: the compacted copy plus 20% + 256 MB headroom. */\nexport function requiredFreeBytes(liveBytes: number): number {\n  return Math.ceil(liveBytes * 1.2) + 256 * 1024 * 1024;\n}\n\n/** First column of the first row of a PRAGMA result, as a number. */\nfunction pragmaNumber(db: InstanceType<typeof Database>, pragma: string): number {\n  const rows = db.pragma(pragma) as Array<Record<string, unknown>> | undefined;\n  const row = rows?.[0];\n  return row ? Number(Object.values(row)[0]) : 0;\n}\n\n/**\n * Journal mode straight from the SQLite file header (bytes 18/19:\n * 1 = rollback journal, 2 = WAL) — readable without opening a connection.\n */\nfunction journalModeFromHeader(file: string): 'wal' | 'delete' | 'unknown' {\n  const fd = openSync(file, 'r');\n  try {\n    const buf = Buffer.alloc(2);\n    if (readSync(fd, buf, 0, 2, 18) !== 2) return 'unknown';\n    if (buf[0] === 2 && buf[1] === 2) return 'wal';\n    if (buf[0] === 1 && buf[1] === 1) return 'delete';\n    return 'unknown';\n  } finally {\n    closeSync(fd);\n  }\n}\n\n/**\n * Compact each local libsql db file by streaming a `VACUUM INTO` copy next to\n * it, then swapping the copy into place. Reports before/after sizes.\n *\n * Deliberately NOT an in-place `VACUUM`: that copies all live content into a\n * temp store (held in memory by libsql builds with `temp_store=MEMORY`) and\n * then rewrites the entire database back through the WAL — on multi-GB\n * databases that has frozen whole machines via memory/IO exhaustion.\n * `VACUUM INTO` reads the logical database once and writes the compacted copy\n * sequentially with bounded memory, and the WAL never grows.\n *\n * Each file is preflighted: live bytes are estimated from\n * `page_count - freelist_count` and the copy is refused unless the volume has\n * `requiredFreeBytes()` available.\n *\n * MUST run with every connection to these files closed (the swap replaces the\n * inode — a surviving connection would keep writing to the unlinked old file).\n * `runStorageMaintenance()` closes storage before calling this.\n */\nexport async function reclaimLibSQLDisk(\n  dbFiles: string[],\n  onFileStart?: (file: string, bytesBefore: number, liveBytes: number) => void,\n): Promise<ReclaimResult[]> {\n  const results: ReclaimResult[] = [];\n  for (const file of dbFiles) {\n    // Skip missing files and files too small to have a SQLite header — nothing to reclaim\n    if (!existsSync(file) || statSync(file).size < 100) continue;\n    const bytesBefore = fileSizeWithWal(file);\n    const tmp = `${file}.vacuum-tmp`;\n    rmSync(tmp, { force: true });\n    // Prove we're the only connection before the swap: every open WAL-mode\n    // connection (all Mastra Code sessions run WAL) holds a shared-memory\n    // lock, so switching WAL -> DELETE only succeeds with exclusive access.\n    // A surviving connection would keep writing to the unlinked old inode\n    // after the swap and silently lose data.\n    //\n    // The probe uses exec() only and verifies the outcome from the SQLite\n    // file header: prepared statements (including db.pragma()) pin a libsql\n    // connection open past close(), so a failed in-connection probe would\n    // itself hold the WAL lock and poison every retry in this process.\n    // Upstream bug (libsql 0.5.x / @libsql/client 0.17.x): Database.close()\n    // does not finalize outstanding statements — they are only finalized by\n    // GC, so lock release after close() is nondeterministic. Reported as\n    // https://github.com/tursodatabase/libsql-js/issues/228 (fix in flight in\n    // PR #214). Once that lands, the header check can become a plain\n    // journal_mode query.\n    const probe = new Database(file);\n    try {\n      probe.exec('PRAGMA busy_timeout = 2000');\n      // Round-trip through WAL so the probe also works when a clean shutdown\n      // already left the file in rollback mode.\n      probe.exec('PRAGMA journal_mode = WAL');\n      probe.exec('PRAGMA journal_mode = DELETE');\n    } catch {\n      // busy — the header check below reports the failure\n    } finally {\n      probe.close();\n    }\n    if (journalModeFromHeader(file) !== 'delete') {\n      throw new Error(\n        `${file} is in use by another process — is another Mastra Code session running? ` +\n          `Close other sessions and run /prune vacuum again.`,\n      );\n    }\n    // Native `libsql` driver, not `@libsql/client`: the wrapper's close() can\n    // leave the file lock held in-process (cached statements), which would\n    // block other connections afterwards. This connection stays in rollback\n    // mode, so even a pinned statement holds no lock once we're done.\n    const db = new Database(file);\n    try {\n      db.exec('PRAGMA busy_timeout = 2000');\n      const pageSize = pragmaNumber(db, 'page_size');\n      const pageCount = pragmaNumber(db, 'page_count');\n      const freelistCount = pragmaNumber(db, 'freelist_count');\n      const liveBytes = Math.max(0, pageCount - freelistCount) * pageSize;\n      const { bsize, bavail } = statfsSync(dirname(file));\n      const freeBytes = bsize * bavail;\n      if (freeBytes < requiredFreeBytes(liveBytes)) {\n        throw new Error(\n          `Not enough free disk space to compact ${file}: need ${formatBytes(requiredFreeBytes(liveBytes))} ` +\n            `for a ${formatBytes(liveBytes)} compacted copy, but only ${formatBytes(freeBytes)} is free.`,\n        );\n      }\n      onFileStart?.(file, bytesBefore, liveBytes);\n      db.exec(`VACUUM INTO '${tmp.replace(/'/g, \"''\")}'`);\n    } catch (err) {\n      rmSync(tmp, { force: true });\n      throw err;\n    } finally {\n      db.close();\n    }\n    // Re-probe right before the swap: `VACUUM INTO` can take tens of seconds\n    // on multi-GB files, and a session started in that window reopens the db\n    // in WAL mode (flipping the header back). Swapping under it would orphan\n    // that session's inode and silently lose its writes.\n    if (journalModeFromHeader(file) !== 'delete') {\n      rmSync(tmp, { force: true });\n      throw new Error(\n        `${file} was opened by another process during compaction — is another Mastra Code session running? ` +\n          `Close other sessions and run /prune vacuum again.`,\n      );\n    }\n    // Swap the compacted copy into place. The old WAL/SHM sidecars belong to\n    // the old inode — they must never be paired with the new file. If any step\n    // after the first rename fails, restore the original so the db path is\n    // never left empty (a naive restart would otherwise create a fresh db).\n    renameSync(file, `${file}.old`);\n    try {\n      rmSync(`${file}-wal`, { force: true });\n      rmSync(`${file}-shm`, { force: true });\n      renameSync(tmp, file);\n    } catch (err) {\n      try {\n        renameSync(`${file}.old`, file);\n      } catch {\n        throw new Error(\n          `Failed to swap compacted copy into place AND failed to restore the original — ` +\n            `your data is intact at ${file}.old; rename it back to ${file} manually. ` +\n            `Original error: ${err instanceof Error ? err.message : String(err)}`,\n        );\n      }\n      rmSync(tmp, { force: true });\n      throw err;\n    }\n    rmSync(`${file}.old`, { force: true });\n    results.push({ file, bytesBefore, bytesAfter: fileSizeWithWal(file) });\n  }\n  return results;\n}\n\n/** `file:/path` or `file:///path` → filesystem path; undefined for non-file urls. */\nfunction fileUrlToPath(url: string): string | undefined {\n  if (!url.startsWith('file:')) return undefined;\n  return url.replace(/^file:\\/\\//, '').replace(/^file:/, '');\n}\n\n/**\n * Resolve the local libsql db files eligible for checkpoint + VACUUM.\n * Returns [] for remote (turso) urls and PG backends. When PG was requested\n * but the factory fell back to libsql, the fallback uses the default files.\n */\nexport function resolveLocalDbFiles(config: StorageConfig, effectiveBackend: 'libsql' | 'pg'): string[] {\n  if (effectiveBackend !== 'libsql') return [];\n  if (config.backend === 'pg') {\n    // PG requested but fell back to the default local libsql files\n    return [getDatabasePath(), getVectorDatabasePath()];\n  }\n  if (config.isRemote) return [];\n  const files: string[] = [];\n  const main = fileUrlToPath(config.url);\n  if (main) files.push(main);\n  const vector = config.vectorUrl ? fileUrlToPath(config.vectorUrl) : getVectorDatabasePath();\n  if (vector) files.push(vector);\n  return files;\n}\n\n/**\n * Build the maintenance handle for the effective storage backend.\n * `localDbFiles` are the local libsql file paths eligible for VACUUM;\n * pass an empty array for remote (turso) or PG backends.\n */\nexport function createStorageMaintenance(opts: {\n  storage: MastraCompositeStore;\n  backend: 'libsql' | 'pg';\n  retention: RetentionConfig;\n  localDbFiles: string[];\n  /** Closes the vector store's connection; required for local libsql so the compaction swap isn't blocked by our own handle. */\n  closeVector?: () => Promise<void>;\n}): StorageMaintenance {\n  const { storage, backend, retention, localDbFiles, closeVector } = opts;\n  return {\n    backend,\n    retention,\n    prune: options => storage.prune(options),\n    closeStorage: async () => {\n      await storage.close?.();\n      await closeVector?.();\n    },\n    ...(backend === 'libsql' && localDbFiles.length > 0\n      ? {\n          reclaimDisk: (onFileStart?: (file: string, bytesBefore: number, liveBytes: number) => void) =>\n            reclaimLibSQLDisk(localDbFiles, onFileStart),\n        }\n      : {}),\n  };\n}\n\nexport function formatBytes(bytes: number): string {\n  if (bytes < 1024) return `${bytes} B`;\n  const units = ['KB', 'MB', 'GB', 'TB'];\n  let value = bytes;\n  let unit = 'B';\n  for (const next of units) {\n    if (value < 1024) break;\n    value /= 1024;\n    unit = next;\n  }\n  return `${value.toFixed(1)} ${unit}`;\n}\n\n/** Rows deleted per table per pass: default batchSize (1000) × 20 batches. */\nconst PASS_MAX_BATCHES = 20;\n\n/**\n * Run storage maintenance with exclusive access to the database, reporting\n * progress through `log` (one line per pass so large deletes are visible).\n *\n * Must run AFTER the TUI is stopped and background writers are quiesced —\n * batched deletes and VACUUM contend with live writes (SQLITE_BUSY) and can\n * starve the event loop that renders the TUI. The storage connection is\n * closed at the end (checkpointing the WAL for local libsql), so the process\n * must exit afterwards.\n */\nexport async function runStorageMaintenance(opts: {\n  maintenance: StorageMaintenance;\n  vacuum: boolean;\n  /** Skip the memory domain (messages/threads) so chat history is preserved. */\n  keepMemory?: boolean;\n  log: (line: string) => void;\n}): Promise<void> {\n  const { maintenance, vacuum, keepMemory = false, log } = opts;\n\n  // keep-memory: prune with the standing policies minus the memory domain,\n  // for this run only. The configured retention is untouched.\n  const { memory: _memory, ...withoutMemory } = maintenance.retention;\n  const retentionForRun = keepMemory ? { retention: withoutMemory } : {};\n\n  log('Pruning rows older than the retention policies:');\n  for (const [domain, tables] of Object.entries(maintenance.retention)) {\n    for (const [table, policy] of Object.entries(tables ?? {})) {\n      const kept = keepMemory && domain === 'memory';\n      log(`  ${domain}.${table}: ${kept ? 'kept (keep-memory)' : (policy as { maxAge: string | number }).maxAge}`);\n    }\n  }\n\n  const totals = new Map<string, number>();\n  for (;;) {\n    const results = await maintenance.prune({ maxBatches: PASS_MAX_BATCHES, ...retentionForRun });\n    if (results.length === 0) break;\n    let remaining = false;\n    let deletedThisPass = 0;\n    for (const r of results) {\n      const key = `${r.domain}.${r.table}`;\n      totals.set(key, (totals.get(key) ?? 0) + r.deleted);\n      deletedThisPass += r.deleted;\n      if (!r.done) remaining = true;\n      if (r.deleted > 0) {\n        log(`  ${key}: ${totals.get(key)} rows deleted${r.done ? '' : ' so far…'}`);\n      }\n    }\n    if (!remaining) break;\n    // Safety valve: a table reported more eligible rows but nothing was\n    // deleted this pass — bail instead of spinning forever.\n    if (deletedThisPass === 0) {\n      log('  stopping: no progress in the last pass.');\n      break;\n    }\n  }\n  const totalDeleted = [...totals.values()].reduce((sum, n) => sum + n, 0);\n  log(\n    totalDeleted === 0\n      ? 'Nothing to prune — no retention-eligible rows found.'\n      : `Prune complete: ${totalDeleted} rows deleted.`,\n  );\n\n  // Release the long-lived connection: checkpoints the WAL for local libsql\n  // and guarantees VACUUM below isn't blocked by our own open handles.\n  await maintenance.closeStorage?.();\n\n  if (!vacuum) {\n    if (maintenance.reclaimDisk) {\n      log('Deleted rows free pages inside the db file but not on disk. Run /prune vacuum to reclaim disk space.');\n    }\n    return;\n  }\n\n  if (!maintenance.reclaimDisk) {\n    log('Disk reclamation (VACUUM) is only available for local libsql storage.');\n    return;\n  }\n\n  log('Reclaiming disk (compacting database files)… this can take several minutes on large databases.');\n  const reclaimed = await maintenance.reclaimDisk((file, bytesBefore, liveBytes) => {\n    log(`  vacuuming ${file} (${formatBytes(bytesBefore)}, ~${formatBytes(liveBytes)} live)…`);\n  });\n  if (reclaimed.length === 0) {\n    log('No local database files found to vacuum.');\n    return;\n  }\n  for (const r of reclaimed) {\n    log(`  ${r.file}: ${formatBytes(r.bytesBefore)} → ${formatBytes(r.bytesAfter)}`);\n  }\n  const saved = reclaimed.reduce((sum, r) => sum + Math.max(0, r.bytesBefore - r.bytesAfter), 0);\n  log(`Reclaimed ${formatBytes(saved)}.`);\n}\n"],"mappings":"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"}