@automagik/omni 2.260501.1 → 2.260501.2

package/dist/commands/doctor.d.ts

@@ -38,6 +38,7 @@
  */
 import { Command } from 'commander';
 import { type Config, type ServerConfig } from '../config.js';
+import { type EmbeddedDumpResult } from '../lib/canonical-pgserve.js';
 /** Severity levels reported by each check. */
 export type CheckLevel = 'OK' | 'WARN' | 'FAIL';
 /** Identifier used in tests and --json output. */
@@ -141,6 +142,24 @@ export interface DoctorDeps {
      * failure. Stubbed in tests.
      */
     setupCanonicalPgserve: () => Promise<string | null>;
+    /**
+     * `pg_dump` the embedded omni DB → gzip → snapshot file. Called BEFORE
+     * the caller stops omni-api so the embedded pgserve is still live for
+     * pg_dump to connect. Returns a status so the caller can decide whether
+     * to attempt a restore later. Stubbed in tests.
+     */
+    dumpEmbeddedDb: (currentDatabaseUrl: string) => Promise<EmbeddedDumpResult>;
+    /**
+     * Pipe a dumped snapshot into the canonical pgserve via `psql`. Called
+     * AFTER `pgserve install` has brought canonical online. No-op when the
+     * dump status was anything but `dumped`. Stubbed in tests.
+     */
+    restoreSnapshotToCanonical: (dump: EmbeddedDumpResult, canonicalDatabaseUrl: string) => Promise<{
+        status: 'restored' | 'skipped';
+        snapshotPath?: string;
+    }>;
+    /** Resolve canonical pgserve's on-disk data dir for operator-facing logs. */
+    getCanonicalPgserveDataDir: () => string;
     /**
      * Persist a partial server config (merges with existing). Stubbed in
      * tests so the canonical-pgserve fix can be validated without writing

package/dist/commands/doctor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -21292,7 +21292,7 @@ var require_node_transport = __commonJS((exports) => {
   var util_1 = require_util();
   var tls_1 = __require("tls");
   var { resolve: resolve2 } = __require("path");
-  var { readFile, existsSync: existsSync9 } = __require("fs");
+  var { readFile, existsSync: existsSync10 } = __require("fs");
   var dns = __require("dns");
   var VERSION2 = "2.29.3";
   var LANG = "nats.js";
@@ -21408,7 +21408,7 @@ var require_node_transport = __commonJS((exports) => {
       const d = (0, nats_base_client_1.deferred)();
       try {
         fn = resolve2(fn);
-        if (!existsSync9(fn)) {
+        if (!existsSync10(fn)) {
           d.reject(new Error(`${fn} doesn't exist`));
         }
         readFile(fn, (err, data2) => {
@@ -27204,11 +27204,11 @@ var init_dead_letter = __esm(() => {
 });
 
 // ../core/src/events/payload-store.ts
-import { gunzipSync, gzipSync } from "zlib";
+import { gunzipSync as gunzipSync2, gzipSync as gzipSync2 } from "zlib";
 function compressPayload(payload) {
   const jsonString = JSON.stringify(payload);
   const originalSize = Buffer.byteLength(jsonString, "utf8");
-  const compressed = gzipSync(jsonString);
+  const compressed = gzipSync2(jsonString);
   const base64 = compressed.toString("base64");
   const compressedSize = compressed.length;
   return {
@@ -27220,7 +27220,7 @@ function compressPayload(payload) {
 }
 function decompressPayload(compressedBase64) {
   const buffer2 = Buffer.from(compressedBase64, "base64");
-  const decompressed = gunzipSync(buffer2);
+  const decompressed = gunzipSync2(buffer2);
   const jsonString = decompressed.toString("utf8");
   return JSON.parse(jsonString);
 }
@@ -30758,7 +30758,7 @@ var require_pushgateway = __commonJS((exports, module) => {
   var url = __require("url");
   var http = __require("http");
   var https = __require("https");
-  var { gzipSync: gzipSync2 } = __require("zlib");
+  var { gzipSync: gzipSync3 } = __require("zlib");
   var { globalRegistry } = require_registry();
 
   class Pushgateway {
@@ -30832,7 +30832,7 @@ var require_pushgateway = __commonJS((exports, module) => {
       if (method !== "DELETE") {
         this.registry.metrics().then((metrics) => {
           if (options.headers && options.headers["Content-Encoding"] === "gzip") {
-            metrics = gzipSync2(metrics);
+            metrics = gzipSync3(metrics);
           }
           req.write(metrics);
           req.end();
@@ -52201,8 +52201,8 @@ var init_a2a_provider = __esm(() => {
 
 // ../core/src/providers/nats-genie-provider.ts
 import { mkdir, writeFile } from "fs/promises";
-import { homedir as homedir7 } from "os";
-import { join as join12 } from "path";
+import { homedir as homedir8 } from "os";
+import { join as join13 } from "path";
 
 class NatsGenieProvider {
   id;
@@ -52392,10 +52392,10 @@ class NatsGenieProvider {
   }
   async writeDeadLetter(payload, error2) {
     try {
-      const dlDir = join12(homedir7(), ".omni", "dead-letters");
+      const dlDir = join13(homedir8(), ".omni", "dead-letters");
       await mkdir(dlDir, { recursive: true });
       const filename = `nats-genie-${Date.now()}-${payload.chatId}.json`;
-      await writeFile(join12(dlDir, filename), JSON.stringify({
+      await writeFile(join13(dlDir, filename), JSON.stringify({
         payload,
         error: error2 instanceof Error ? error2.message : String(error2),
         timestamp: new Date().toISOString()
@@ -54258,7 +54258,7 @@ var init_sql = __esm(() => {
       return new SQL([new StringChunk(str)]);
     }
     sql2.raw = raw2;
-    function join13(chunks, separator) {
+    function join14(chunks, separator) {
       const result = [];
       for (const [i2, chunk] of chunks.entries()) {
         if (i2 > 0 && separator !== undefined) {
@@ -54268,7 +54268,7 @@ var init_sql = __esm(() => {
       }
       return new SQL(result);
     }
-    sql2.join = join13;
+    sql2.join = join14;
     function identifier(value) {
       return new Name(value);
     }
@@ -57495,7 +57495,7 @@ var init_select2 = __esm(() => {
       return (table2, on) => {
         const baseTableName = this.tableName;
         const tableName = getTableLikeName(table2);
-        if (typeof tableName === "string" && this.config.joins?.some((join13) => join13.alias === tableName)) {
+        if (typeof tableName === "string" && this.config.joins?.some((join14) => join14.alias === tableName)) {
           throw new Error(`Alias "${tableName}" is already used in this query`);
         }
         if (!this.isPartialSelect) {
@@ -58006,7 +58006,7 @@ var init_update = __esm(() => {
     createJoin(joinType) {
       return (table2, on) => {
         const tableName = getTableLikeName(table2);
-        if (typeof tableName === "string" && this.config.joins.some((join13) => join13.alias === tableName)) {
+        if (typeof tableName === "string" && this.config.joins.some((join14) => join14.alias === tableName)) {
           throw new Error(`Alias "${tableName}" is already used in this query`);
         }
         if (typeof on === "function") {
@@ -58056,10 +58056,10 @@ var init_update = __esm(() => {
             const fromFields = this.getTableLikeFields(this.config.from);
             fields[tableName] = fromFields;
           }
-          for (const join13 of this.config.joins) {
-            const tableName2 = getTableLikeName(join13.table);
-            if (typeof tableName2 === "string" && !is(join13.table, SQL)) {
-              const fromFields = this.getTableLikeFields(join13.table);
+          for (const join14 of this.config.joins) {
+            const tableName2 = getTableLikeName(join14.table);
+            if (typeof tableName2 === "string" && !is(join14.table, SQL)) {
+              const fromFields = this.getTableLikeFields(join14.table);
               fields[tableName2] = fromFields;
             }
           }
@@ -78195,7 +78195,7 @@ var require_path = __commonJS((exports) => {
   function isAbsolute(path) {
     return path.charAt(0) === "/";
   }
-  function join15(...args) {
+  function join16(...args) {
     return normalizePath(args.join("/"));
   }
   function dirname6(path) {
@@ -78220,7 +78220,7 @@ var require_path = __commonJS((exports) => {
   exports.basename = basename6;
   exports.dirname = dirname6;
   exports.isAbsolute = isAbsolute;
-  exports.join = join15;
+  exports.join = join16;
   exports.normalizePath = normalizePath;
   exports.relative = relative;
   exports.resolve = resolve4;
@@ -114177,7 +114177,7 @@ import { fileURLToPath } from "url";
 // package.json
 var package_default = {
   name: "@automagik/omni",
-  version: "2.260501.1",
+  version: "2.260501.2",
   description: "LLM-optimized CLI for Omni",
   type: "module",
   bin: {
@@ -117717,9 +117717,9 @@ function createDeadLettersCommand() {
 }
 
 // src/commands/doctor.ts
-import { existsSync as existsSync6, readdirSync as readdirSync2, statSync } from "fs";
-import { homedir as homedir5 } from "os";
-import { join as join9, resolve } from "path";
+import { existsSync as existsSync7, readdirSync as readdirSync2, statSync as statSync2 } from "fs";
+import { homedir as homedir6 } from "os";
+import { join as join10, resolve } from "path";
 init_config();
 
 // src/health.ts
@@ -118830,6 +118830,11 @@ WantedBy=multi-user.target
 // src/lib/canonical-pgserve.ts
 init_config();
 init_output();
+import { spawnSync } from "child_process";
+import { existsSync as existsSync6, mkdirSync as mkdirSync4, readFileSync as readFileSync4, renameSync, statSync, writeFileSync as writeFileSync5 } from "fs";
+import { homedir as homedir5 } from "os";
+import { join as join8 } from "path";
+import { gunzipSync, gzipSync } from "zlib";
 var PGSERVE_REQUIRED_VERSION = "^2.1.0";
 async function isPgserveInstalled() {
   try {
@@ -118923,30 +118928,148 @@ async function resolveCanonicalPgservePreference(isReinstall, cfg) {
   raw("");
   return true;
 }
+var OMNI_EMBEDDED_PGSERVE_DATA_DIR = join8(homedir5(), ".omni", "data", "pgserve");
+var PGSERVE_DEFAULT_DATA_DIR = join8(homedir5(), ".pgserve", "data");
+var PGSERVE_CONFIG_PATH = join8(homedir5(), ".pgserve", "config.json");
+var OMNI_BACKUPS_DIR = join8(homedir5(), ".omni", "backups");
+function getEmbeddedPgserveDataDir() {
+  return OMNI_EMBEDDED_PGSERVE_DATA_DIR;
+}
+function getCanonicalPgserveDataDir() {
+  if (!existsSync6(PGSERVE_CONFIG_PATH))
+    return PGSERVE_DEFAULT_DATA_DIR;
+  try {
+    const raw2 = readFileSync4(PGSERVE_CONFIG_PATH, "utf8");
+    const parsed = JSON.parse(raw2);
+    return typeof parsed.dataDir === "string" && parsed.dataDir.length > 0 ? parsed.dataDir : PGSERVE_DEFAULT_DATA_DIR;
+  } catch {
+    return PGSERVE_DEFAULT_DATA_DIR;
+  }
+}
+function looksLikePgDataDir(path) {
+  return existsSync6(join8(path, "PG_VERSION")) && existsSync6(join8(path, "base"));
+}
+function getSnapshotPath(timestamp = new Date) {
+  const ts = timestamp.toISOString().replace(/[:.]/g, "-");
+  return join8(OMNI_BACKUPS_DIR, `embedded-migration-${ts}.sql.gz`);
+}
+function commandIsAvailable(cmd) {
+  try {
+    const result = spawnSync(cmd, ["--version"], { stdio: ["ignore", "pipe", "pipe"], timeout: 3000 });
+    return result.status === 0;
+  } catch {
+    return false;
+  }
+}
+function pgEnvFromUrl(url) {
+  const parsed = new URL(url);
+  const env2 = {
+    PGHOST: parsed.hostname,
+    PGUSER: decodeURIComponent(parsed.username || "postgres"),
+    PGDATABASE: parsed.pathname.replace(/^\//, "") || "omni"
+  };
+  if (parsed.port)
+    env2.PGPORT = parsed.port;
+  if (parsed.password)
+    env2.PGPASSWORD = decodeURIComponent(parsed.password);
+  return env2;
+}
+async function dumpEmbeddedDb(currentDatabaseUrl) {
+  const embeddedDir = getEmbeddedPgserveDataDir();
+  if (!existsSync6(embeddedDir)) {
+    return { status: "no-embedded-data", embeddedDir };
+  }
+  if (!looksLikePgDataDir(embeddedDir)) {
+    warn(`Embedded pgserve dir at ${embeddedDir} is missing PG_VERSION or base/ \u2014 does not look like a Postgres data dir. Skipping dump; canonical will start empty.`);
+    return { status: "embedded-data-invalid", embeddedDir };
+  }
+  if (!commandIsAvailable("pg_dump")) {
+    throw new Error("pg_dump not found in PATH \u2014 install postgresql-client (apt install postgresql-client / brew install postgresql) and retry");
+  }
+  const snapshotPath = getSnapshotPath();
+  mkdirSync4(OMNI_BACKUPS_DIR, { recursive: true, mode: 448 });
+  raw("  Dumping embedded database via pg_dump...");
+  raw(`    source data dir: ${embeddedDir}`);
+  raw(`    snapshot:        ${snapshotPath}`);
+  const result = spawnSync("pg_dump", ["--no-owner", "--no-acl", "--clean", "--if-exists"], {
+    env: { ...process.env, ...pgEnvFromUrl(currentDatabaseUrl) },
+    stdio: ["pipe", "pipe", "pipe"],
+    timeout: 600000,
+    maxBuffer: 1024 * 1024 * 1024 * 4
+  });
+  if (result.status !== 0) {
+    const stderr = result.stderr?.toString().trim() || "unknown error";
+    throw new Error(`pg_dump failed (exit ${result.status}): ${stderr}`);
+  }
+  const compressed = gzipSync(result.stdout);
+  const tmpPath = `${snapshotPath}.tmp`;
+  writeFileSync5(tmpPath, compressed, { mode: 384 });
+  renameSync(tmpPath, snapshotPath);
+  const bytes = statSync(snapshotPath).size;
+  raw(`    snapshot size:   ${formatBytes(bytes)}`);
+  await Promise.resolve();
+  return { status: "dumped", embeddedDir, snapshotPath, bytes };
+}
+async function restoreSnapshotToCanonical(dump, canonicalDatabaseUrl) {
+  if (dump.status !== "dumped") {
+    return { status: "skipped" };
+  }
+  if (!commandIsAvailable("psql")) {
+    throw new Error("psql not found in PATH \u2014 install postgresql-client (apt install postgresql-client / brew install postgresql) and retry");
+  }
+  raw("  Restoring snapshot into canonical pgserve via psql...");
+  raw(`    snapshot:           ${dump.snapshotPath}`);
+  raw(`    canonical data dir: ${getCanonicalPgserveDataDir()}`);
+  raw(`    canonical URL:      ${canonicalDatabaseUrl}`);
+  const compressed = readFileSync4(dump.snapshotPath);
+  const sql = gunzipSync(compressed);
+  const result = spawnSync("psql", ["-v", "ON_ERROR_STOP=1"], {
+    env: { ...process.env, ...pgEnvFromUrl(canonicalDatabaseUrl) },
+    input: sql,
+    stdio: ["pipe", "pipe", "pipe"],
+    timeout: 600000,
+    maxBuffer: 1024 * 1024 * 1024 * 4
+  });
+  if (result.status !== 0) {
+    const stderr = result.stderr?.toString().trim() || "unknown error";
+    throw new Error(`psql restore failed (exit ${result.status}): ${stderr}`);
+  }
+  await Promise.resolve();
+  return { status: "restored", snapshotPath: dump.snapshotPath };
+}
+function formatBytes(n) {
+  if (n < 1024)
+    return `${n} B`;
+  if (n < 1024 * 1024)
+    return `${(n / 1024).toFixed(1)} KB`;
+  if (n < 1024 * 1024 * 1024)
+    return `${(n / 1024 / 1024).toFixed(1)} MB`;
+  return `${(n / 1024 / 1024 / 1024).toFixed(2)} GB`;
+}
 
 // src/commands/doctor.ts
 init_output();
 
 // src/server-bundle.ts
 init_output();
-import { dirname as dirname2, join as join8 } from "path";
+import { dirname as dirname2, join as join9 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 function getServerBundlePath() {
   try {
     const thisFile = fileURLToPath2(import.meta.url);
     const distDir = dirname2(thisFile);
-    return join8(distDir, "server", "index.js");
+    return join9(distDir, "server", "index.js");
   } catch {
-    return join8(process.cwd(), "dist", "server", "index.js");
+    return join9(process.cwd(), "dist", "server", "index.js");
   }
 }
 function getServerLauncherPath() {
   try {
     const thisFile = fileURLToPath2(import.meta.url);
     const distDir = dirname2(thisFile);
-    return join8(distDir, "..", "bin", "omni-server");
+    return join9(distDir, "..", "bin", "omni-server");
   } catch {
-    return join8(process.cwd(), "bin", "omni-server");
+    return join9(process.cwd(), "bin", "omni-server");
   }
 }
 function bundleNotFoundError(bundlePath) {
@@ -119011,10 +119134,10 @@ function productionDeps() {
       }
     },
     findOrphanedDataDirs: () => {
-      const roots = [process.cwd(), join9(homedir5(), "workspace"), join9(homedir5(), "repos")];
+      const roots = [process.cwd(), join10(homedir6(), "workspace"), join10(homedir6(), "repos")];
       const found = [];
       for (const root of roots) {
-        if (!existsSync6(root))
+        if (!existsSync7(root))
           continue;
         try {
           scanForOrphans(root, found, 0);
@@ -119080,6 +119203,9 @@ function productionDeps() {
     },
     cliHasSigningKey: () => loadSigningContext() !== null,
     setupCanonicalPgserve,
+    dumpEmbeddedDb,
+    restoreSnapshotToCanonical,
+    getCanonicalPgserveDataDir,
     saveServerConfig
   };
 }
@@ -119095,10 +119221,10 @@ function scanForOrphans(dir, acc, depth, maxDepth = 4) {
   for (const name of entries) {
     if (name === "node_modules" || name === ".git")
       continue;
-    const full = join9(dir, name);
+    const full = join10(dir, name);
     let stats;
     try {
-      stats = statSync(full);
+      stats = statSync2(full);
     } catch {
       continue;
     }
@@ -119351,12 +119477,26 @@ async function fixCliKeyValid(deps) {
 }
 async function fixPgserveCanonical(deps) {
   const { serverConfig, cliConfig } = deps.loadState();
+  let dumpResult;
+  try {
+    dumpResult = await deps.dumpEmbeddedDb(serverConfig.databaseUrl);
+  } catch (err) {
+    throw new Error(`pg_dump of embedded omni DB failed (${err instanceof Error ? err.message : String(err)}); omni-api still running on embedded \u2014 install postgresql-client (apt install postgresql-client) if pg_dump is missing, then retry`);
+  }
   await deps.runPm2(["stop", PM2_PROCESSES.api]);
   const url = await deps.setupCanonicalPgserve();
   if (!url) {
     await deps.runPm2(["start", PM2_PROCESSES.api]);
     throw new Error("canonical pgserve setup failed (pgserve binary unavailable or install failed) \u2014 install manually: bun add -g pgserve@^2.1.0");
   }
+  let restoreOutcome;
+  try {
+    restoreOutcome = await deps.restoreSnapshotToCanonical(dumpResult, url);
+  } catch (err) {
+    await deps.runPm2(["start", PM2_PROCESSES.api]);
+    const snapshotHint = dumpResult.status === "dumped" ? ` snapshot preserved at ${dumpResult.snapshotPath}` : "";
+    throw new Error(`psql restore into canonical pgserve failed (${err instanceof Error ? err.message : String(err)}); omni-api restarted on embedded \u2014${snapshotHint} retry by replaying the dump manually or re-running \`omni doctor --fix\``);
+  }
   deps.saveServerConfig({ databaseUrl: url, useCanonicalPgserve: true });
   const env2 = buildRuntimeEnv({ ...serverConfig, databaseUrl: url, useCanonicalPgserve: true }, cliConfig);
   await deps.runPm2(["delete", PM2_PROCESSES.api], env2);
@@ -119370,7 +119510,9 @@ async function fixPgserveCanonical(deps) {
   if (startCode !== 0) {
     throw new Error(`pm2 start ${PM2_PROCESSES.api} exited ${startCode} after canonical migration`);
   }
-  return `migrated to canonical pgserve@^2.1.0; omni-api now connects to ${url}`;
+  const canonicalDir = deps.getCanonicalPgserveDataDir();
+  const dataNote = dumpResult.status === "dumped" && restoreOutcome.status === "restored" ? `restored ${dumpResult.snapshotPath} into ${canonicalDir} (omni-api \u2192 ${url})` : dumpResult.status === "no-embedded-data" ? `no embedded data to migrate; canonical started empty at ${canonicalDir} (omni-api \u2192 ${url})` : `embedded data dir invalid; canonical started empty at ${canonicalDir} (omni-api \u2192 ${url})`;
+  return `migrated to canonical pgserve@^2.1.0; ${dataNote}`;
 }
 function fixOrphanedDataDirs(deps) {
   const found = deps.findOrphanedDataDirs();
@@ -119570,7 +119712,7 @@ Safety:
 }
 
 // src/commands/done.ts
-import { existsSync as existsSync7, readFileSync as readFileSync4 } from "fs";
+import { existsSync as existsSync8, readFileSync as readFileSync5 } from "fs";
 import { basename, extname } from "path";
 
 // src/context.ts
@@ -119679,12 +119821,12 @@ async function handleReact(client, ctx, emoji) {
   await closeTurn(client, "react", `Reacted ${emoji} + turn closed`);
 }
 async function handleMedia(client, ctx, mediaPath, caption) {
-  if (!existsSync7(mediaPath)) {
+  if (!existsSync8(mediaPath)) {
     return error(`File not found: ${mediaPath}`);
   }
   try {
     const mediaType = getMediaType(mediaPath);
-    const buffer = readFileSync4(mediaPath);
+    const buffer = readFileSync5(mediaPath);
     const base64 = buffer.toString("base64");
     const filename = basename(mediaPath);
     await client.messages.sendMedia({
@@ -120116,7 +120258,7 @@ function createEventsCommand() {
 }
 
 // src/commands/film.ts
-import { writeFileSync as writeFileSync5 } from "fs";
+import { writeFileSync as writeFileSync6 } from "fs";
 import { resolve as resolvePath } from "path";
 init_output();
 function createFilmCommand() {
@@ -120180,7 +120322,7 @@ function createFilmCommand() {
       const videoBuffer = Buffer.from(result.videoBase64, "base64");
       if (options.output) {
         const outPath = resolvePath(options.output);
-        writeFileSync5(outPath, videoBuffer);
+        writeFileSync6(outPath, videoBuffer);
         success("Video saved", { path: outPath, sizeBytes: videoBuffer.length });
         return;
       }
@@ -120204,7 +120346,7 @@ function createFilmCommand() {
 }
 
 // src/commands/follow-up.ts
-import { readFileSync as readFileSync5 } from "fs";
+import { readFileSync as readFileSync6 } from "fs";
 init_output();
 var VALID_SCOPES = ["agents", "instances", "chats"];
 function assertScope(scope) {
@@ -120222,9 +120364,9 @@ async function resolveScopedId(scope, id) {
 function readJsonArg(raw2) {
   let body = raw2;
   if (body === "-") {
-    body = readFileSync5(0, "utf8");
+    body = readFileSync6(0, "utf8");
   } else if (body.startsWith("@")) {
-    body = readFileSync5(body.slice(1), "utf8");
+    body = readFileSync6(body.slice(1), "utf8");
   }
   try {
     return JSON.parse(body);
@@ -120376,8 +120518,8 @@ function createHistoryCommand() {
 }
 
 // src/commands/imagine.ts
-import { writeFileSync as writeFileSync6 } from "fs";
-import { basename as basename2, dirname as dirname3, extname as extname2, join as join10 } from "path";
+import { writeFileSync as writeFileSync7 } from "fs";
+import { basename as basename2, dirname as dirname3, extname as extname2, join as join11 } from "path";
 init_output();
 var ALLOWED_ASPECT_RATIOS = ["1:1", "4:3", "3:4", "16:9", "9:16", "3:2", "2:3"];
 function extensionForMime(mimeType) {
@@ -120392,9 +120534,9 @@ function buildOutputPath(outputBase, index, total, mimeType) {
   const ext = extname2(outputBase) || extensionForMime(mimeType);
   const stem = basename2(outputBase, extname2(outputBase));
   if (total <= 1) {
-    return join10(dir, `${stem}${ext}`);
+    return join11(dir, `${stem}${ext}`);
   }
-  return join10(dir, `${stem}-${index + 1}${ext}`);
+  return join11(dir, `${stem}-${index + 1}${ext}`);
 }
 function parseAspectRatio(value) {
   if (!value)
@@ -120467,7 +120609,7 @@ function createImagineCommand() {
           continue;
         const path = buildOutputPath(options.output, i, result.images.length, image.mimeType);
         try {
-          writeFileSync6(path, Buffer.from(image.base64, "base64"));
+          writeFileSync7(path, Buffer.from(image.base64, "base64"));
           savedPaths.push(path);
         } catch (err) {
           const message = err instanceof Error ? err.message : "Unknown error";
@@ -120512,12 +120654,12 @@ function createImagineCommand() {
 }
 
 // src/commands/install.ts
-import { existsSync as existsSync8, mkdirSync as mkdirSync4 } from "fs";
-import { homedir as homedir6 } from "os";
-import { join as join11 } from "path";
+import { existsSync as existsSync9, mkdirSync as mkdirSync5 } from "fs";
+import { homedir as homedir7 } from "os";
+import { join as join12 } from "path";
 init_config();
 init_output();
-var DEFAULT_DATA_DIR2 = join11(homedir6(), ".omni", "data");
+var DEFAULT_DATA_DIR2 = join12(homedir7(), ".omni", "data");
 function computeDefaultDatabaseUrl() {
   return buildEmbeddedDatabaseUrl();
 }
@@ -120616,13 +120758,13 @@ async function startServices(cfg, forceCleanup, forceSystemd, useCanonicalPgserv
     return false;
   }
   const bundlePath = getServerBundlePath();
-  if (!existsSync8(bundlePath)) {
+  if (!existsSync9(bundlePath)) {
     warn(`Server bundle not found at: ${bundlePath}
   Install @automagik/omni from npm: bun add -g @automagik/omni
   Or build locally: make cli-build-full`);
     return false;
   }
-  mkdirSync4(getPm2LogDir(), { recursive: true });
+  mkdirSync5(getPm2LogDir(), { recursive: true });
   await installPm2Logrotate();
   const runtimeEnv = buildInstallRuntimeEnv(cfg, forceCleanup, useCanonicalPgserve);
   await runPm2(["delete", PM2_PROCESSES.api]);
@@ -120640,10 +120782,10 @@ async function startServices(cfg, forceCleanup, forceSystemd, useCanonicalPgserv
     return false;
   }
   apiSpinner.succeed(`${PM2_PROCESSES.api} started`);
-  if (existsSync8(NATS_BINARY_PATH)) {
+  if (existsSync9(NATS_BINARY_PATH)) {
     const natsSpinner = ora(`Starting ${PM2_PROCESSES.nats}...`).start();
-    const natsDataDir = join11(cfg.dataDir, "nats");
-    mkdirSync4(natsDataDir, { recursive: true });
+    const natsDataDir = join12(cfg.dataDir, "nats");
+    mkdirSync5(natsDataDir, { recursive: true });
     const natsArgs = buildPm2StartArgs({
       kind: "nats",
       script: NATS_BINARY_PATH,
@@ -122319,7 +122461,7 @@ function createLogsCommand() {
 }
 
 // src/commands/media.ts
-import { createWriteStream as createWriteStream2, existsSync as existsSync10, mkdirSync as mkdirSync6, statSync as statSync3 } from "fs";
+import { createWriteStream as createWriteStream2, existsSync as existsSync11, mkdirSync as mkdirSync7, statSync as statSync4 } from "fs";
 import { basename as basename4, dirname as dirname4, resolve as resolve2 } from "path";
 import { Readable } from "stream";
 import { pipeline } from "stream/promises";
@@ -122382,14 +122524,14 @@ function resolveOutputPath(outputPath, result) {
   const resolved = resolve2(outputPath);
   if (isDirHint)
     return resolve2(resolved, filename);
-  if (existsSync10(resolved) && statSync3(resolved).isDirectory())
+  if (existsSync11(resolved) && statSync4(resolved).isDirectory())
     return resolve2(resolved, filename);
   return resolved;
 }
 async function downloadToFile(url, apiKey, destinationPath) {
   const destDir = dirname4(destinationPath);
-  if (!existsSync10(destDir))
-    mkdirSync6(destDir, { recursive: true });
+  if (!existsSync11(destDir))
+    mkdirSync7(destDir, { recursive: true });
   const resp = await fetch(url, {
     method: "GET",
     headers: apiKey ? { "x-api-key": apiKey } : undefined
@@ -123342,8 +123484,8 @@ init_output();
 init_src();
 import { execFileSync as execFileSync2, execSync } from "child_process";
 import * as nodeCrypto2 from "crypto";
-import { existsSync as existsSync11, mkdirSync as mkdirSync7, readFileSync as readFileSync7, writeFileSync as writeFileSync7 } from "fs";
-import { homedir as homedir8 } from "os";
+import { existsSync as existsSync12, mkdirSync as mkdirSync8, readFileSync as readFileSync8, writeFileSync as writeFileSync8 } from "fs";
+import { homedir as homedir9 } from "os";
 import { dirname as dirname5, resolve as resolve3 } from "path";
 import { createInterface as createInterface2 } from "readline";
 init_config();
@@ -123570,19 +123712,19 @@ async function pairDevice(gatewayUrl, gatewayToken, keypair, spinner) {
     ws.close(1000, "pairing complete");
   }
 }
-var OPENCLAW_CONFIG_PATH = resolve3(homedir8(), ".openclaw", "openclaw.json");
+var OPENCLAW_CONFIG_PATH = resolve3(homedir9(), ".openclaw", "openclaw.json");
 var PLUGIN_MARKER = "plugin-openclaw/omni.ts";
 function readOpenClawConfig(configPath) {
-  if (!existsSync11(configPath))
+  if (!existsSync12(configPath))
     return {};
-  const raw2 = readFileSync7(configPath, "utf-8").trim();
+  const raw2 = readFileSync8(configPath, "utf-8").trim();
   if (!raw2)
     return {};
   return JSON.parse(raw2);
 }
 function writeOpenClawConfig(configPath, config2) {
-  mkdirSync7(dirname5(configPath), { recursive: true, mode: 448 });
-  writeFileSync7(configPath, `${JSON.stringify(config2, null, 2)}
+  mkdirSync8(dirname5(configPath), { recursive: true, mode: 448 });
+  writeFileSync8(configPath, `${JSON.stringify(config2, null, 2)}
 `, { mode: 384 });
 }
 function isPluginRegistered(config2, marker, pluginPath) {
@@ -123614,10 +123756,10 @@ function isValidUuid2(value) {
 }
 function resolvePluginPath(explicit) {
   if (explicit) {
-    return existsSync11(explicit) ? resolve3(explicit) : null;
+    return existsSync12(explicit) ? resolve3(explicit) : null;
   }
   const cwdCandidate = resolve3(process.cwd(), "packages/plugin-openclaw/omni.ts");
-  return existsSync11(cwdCandidate) ? cwdCandidate : null;
+  return existsSync12(cwdCandidate) ? cwdCandidate : null;
 }
 function registerPlugin(config2, pluginPath, configPath) {
   if (hasOpenClawCli()) {
@@ -124506,7 +124648,7 @@ function createSayCommand() {
 }
 
 // src/commands/see.ts
-import { existsSync as existsSync12, readFileSync as readFileSync8, statSync as statSync4 } from "fs";
+import { existsSync as existsSync13, readFileSync as readFileSync9, statSync as statSync5 } from "fs";
 import { extname as extname4 } from "path";
 init_output();
 var MIME_BY_EXT = {
@@ -124538,10 +124680,10 @@ function parseMaxTokens(value) {
   return n3;
 }
 function loadMedia(file) {
-  if (!existsSync12(file)) {
+  if (!existsSync13(file)) {
     error(`File not found: ${file}`);
   }
-  const stat = statSync4(file);
+  const stat = statSync5(file);
   if (!stat.isFile()) {
     error(`Not a regular file: ${file}`);
   }
@@ -124549,7 +124691,7 @@ function loadMedia(file) {
     error(`File is empty: ${file}`);
   }
   try {
-    return { buffer: readFileSync8(file), mimeType: guessMimeType(file) };
+    return { buffer: readFileSync9(file), mimeType: guessMimeType(file) };
   } catch (err2) {
     const message2 = err2 instanceof Error ? err2.message : "Unknown error";
     return error(`Failed to read ${file}: ${message2}`);
@@ -124624,7 +124766,7 @@ function createSeeCommand() {
 }
 
 // src/commands/send.ts
-import { existsSync as existsSync13, readFileSync as readFileSync9 } from "fs";
+import { existsSync as existsSync14, readFileSync as readFileSync10 } from "fs";
 import { basename as basename5, extname as extname5 } from "path";
 init_source();
 init_config();
@@ -124644,7 +124786,7 @@ function getMediaType2(path) {
   return "document";
 }
 function readFileAsBase64(path) {
-  const buffer3 = readFileSync9(path);
+  const buffer3 = readFileSync10(path);
   return buffer3.toString("base64");
 }
 var messageSenders = {
@@ -124665,7 +124807,7 @@ var messageSenders = {
     const { to, media } = options3;
     if (!to || !media)
       return;
-    if (!existsSync13(media)) {
+    if (!existsSync14(media)) {
       error(`File not found: ${media}`);
       return;
     }
@@ -125197,9 +125339,9 @@ function pickFilename(mimeType, provider) {
 }
 
 // src/commands/start.ts
-import { existsSync as existsSync14, mkdirSync as mkdirSync8 } from "fs";
-import { homedir as homedir9 } from "os";
-import { join as join13 } from "path";
+import { existsSync as existsSync15, mkdirSync as mkdirSync9 } from "fs";
+import { homedir as homedir10 } from "os";
+import { join as join14 } from "path";
 init_config();
 init_output();
 var START_HEALTH_TIMEOUT_MS = 1e4;
@@ -125208,12 +125350,12 @@ async function runStart() {
     pm2NotFoundError();
   }
   const bundlePath = getServerBundlePath();
-  if (!existsSync14(bundlePath)) {
+  if (!existsSync15(bundlePath)) {
     bundleNotFoundError(bundlePath);
   }
   const serverConfig = loadServerConfig();
   const apiPort = serverConfig.port;
-  mkdirSync8(getPm2LogDir(), { recursive: true });
+  mkdirSync9(getPm2LogDir(), { recursive: true });
   info(`Starting ${PM2_PROCESSES.api} (port ${apiPort})...`);
   const cliConfig = loadConfig();
   const env2 = buildRuntimeEnv(serverConfig, cliConfig);
@@ -125229,11 +125371,11 @@ async function runStart() {
     error(`Failed to start ${PM2_PROCESSES.api} (pm2 exit code ${apiCode})`, undefined, 1);
     return;
   }
-  const natsPath = join13(homedir9(), ".omni", "nats-server");
-  if (existsSync14(natsPath)) {
+  const natsPath = join14(homedir10(), ".omni", "nats-server");
+  if (existsSync15(natsPath)) {
     info(`Starting ${PM2_PROCESSES.nats}...`);
-    const natsDataDir = join13(serverConfig.dataDir, "nats");
-    mkdirSync8(natsDataDir, { recursive: true });
+    const natsDataDir = join14(serverConfig.dataDir, "nats");
+    mkdirSync9(natsDataDir, { recursive: true });
     const natsArgs = buildPm2StartArgs({
       kind: "nats",
       script: natsPath,
@@ -126240,9 +126382,9 @@ function createVoiceCommand() {
     const startTime = Date.now();
     let saveDir = "";
     if (opts.save) {
-      const { mkdirSync: mkdirSync9 } = await import("fs");
+      const { mkdirSync: mkdirSync10 } = await import("fs");
       saveDir = opts.save;
-      mkdirSync9(saveDir, { recursive: true });
+      mkdirSync10(saveDir, { recursive: true });
       info(`Saving audio to: ${saveDir}`);
     }
     ws.onopen = () => {
@@ -126466,17 +126608,17 @@ init_config();
 init_output();
 
 // src/manifest-pin.ts
-import { existsSync as existsSync15, readFileSync as readFileSync10, renameSync as renameSync2, writeFileSync as writeFileSync8 } from "fs";
-import { homedir as homedir10 } from "os";
-import { join as join14 } from "path";
+import { existsSync as existsSync16, readFileSync as readFileSync11, renameSync as renameSync3, writeFileSync as writeFileSync9 } from "fs";
+import { homedir as homedir11 } from "os";
+import { join as join15 } from "path";
 var PACKAGE_NAME2 = "@automagik/omni";
-var BUN_GLOBAL_MANIFEST = join14(homedir10(), ".bun", "install", "global", "package.json");
+var BUN_GLOBAL_MANIFEST = join15(homedir11(), ".bun", "install", "global", "package.json");
 function pinManifestEntry(manifestPath, exactVersion) {
-  if (!existsSync15(manifestPath))
+  if (!existsSync16(manifestPath))
     return false;
   let manifest;
   try {
-    manifest = JSON.parse(readFileSync10(manifestPath, "utf-8"));
+    manifest = JSON.parse(readFileSync11(manifestPath, "utf-8"));
   } catch {
     return false;
   }
@@ -126502,9 +126644,9 @@ function pinManifestEntry(manifestPath, exactVersion) {
     return false;
   const tmp = `${manifestPath}.tmp.${process.pid}`;
   try {
-    writeFileSync8(tmp, `${JSON.stringify(manifest, null, 2)}
+    writeFileSync9(tmp, `${JSON.stringify(manifest, null, 2)}
 `, { mode: 420 });
-    renameSync2(tmp, manifestPath);
+    renameSync3(tmp, manifestPath);
   } catch {
     return false;
   }

package/dist/lib/canonical-pgserve.d.ts

@@ -47,4 +47,59 @@ export declare function setupCanonicalPgserve(): Promise<string | null>;
 export declare function resolveCanonicalPgservePreference(isReinstall: boolean, cfg: {
     databaseUrl: string;
 }): Promise<boolean>;
+/**
+ * Resolve the canonical pgserve data dir from `~/.pgserve/config.json`.
+ * pgserve writes `{dataDir, port, registeredAt}` during `pgserve install`.
+ * Falls back to `~/.pgserve/data` (pgserve's documented default) when the
+ * config file doesn't exist yet.
+ *
+ * Surfaced in operator output so the migration's destination is explicit:
+ * the operator can `du -sh` and `ls` that path post-migration to verify
+ * the cluster is on disk where they expect.
+ */
+export declare function getCanonicalPgserveDataDir(): string;
+/**
+ * Outcome of the dump step. Caller decides whether to proceed with restore.
+ */
+export type EmbeddedDumpResult = {
+    status: 'no-embedded-data';
+    embeddedDir: string;
+} | {
+    status: 'embedded-data-invalid';
+    embeddedDir: string;
+} | {
+    status: 'dumped';
+    embeddedDir: string;
+    snapshotPath: string;
+    bytes: number;
+};
+/**
+ * Dump the embedded `omni` database to a gzipped SQL snapshot. Called BEFORE
+ * the caller stops omni-api — embedded pgserve must still be live so pg_dump
+ * can connect.
+ *
+ * Returns:
+ *   - `no-embedded-data` when there's no embedded data dir (fresh install
+ *     case — caller proceeds with an empty canonical).
+ *   - `embedded-data-invalid` when the dir exists but isn't a Postgres data
+ *     dir (corrupt / partial init — caller warns + proceeds empty).
+ *   - `dumped` with snapshot path + size on success.
+ *
+ * Throws when pg_dump is missing from PATH or exits non-zero. Caller is
+ * responsible for catching and rolling back omni-api to embedded.
+ */
+export declare function dumpEmbeddedDb(currentDatabaseUrl: string): Promise<EmbeddedDumpResult>;
+/**
+ * Restore a dumped snapshot into the canonical pgserve. Called AFTER the
+ * caller has run `pgserve install` and confirmed canonical is reachable
+ * at the URL. No-op when the snapshot status was anything but `dumped`.
+ *
+ * Uses `psql ON_ERROR_STOP=1` so a partial failure surfaces a non-zero exit
+ * instead of leaving the canonical DB half-restored. Throws on any psql
+ * error — caller rolls back to embedded.
+ */
+export declare function restoreSnapshotToCanonical(dump: EmbeddedDumpResult, canonicalDatabaseUrl: string): Promise<{
+    status: 'restored' | 'skipped';
+    snapshotPath?: string;
+}>;
 //# sourceMappingURL=canonical-pgserve.d.ts.map

package/dist/lib/canonical-pgserve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canonical-pgserve.d.ts","sourceRoot":"","sources":["../../src/lib/canonical-pgserve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAqIH;;;;;;GAMG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CASpE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,iCAAiC,CACrD,WAAW,EAAE,OAAO,EACpB,GAAG,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAC3B,OAAO,CAAC,OAAO,CAAC,CA6BlB"}
+{"version":3,"file":"canonical-pgserve.d.ts","sourceRoot":"","sources":["../../src/lib/canonical-pgserve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AA2IH;;;;;;GAMG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CASpE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,iCAAiC,CACrD,WAAW,EAAE,OAAO,EACpB,GAAG,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAC3B,OAAO,CAAC,OAAO,CAAC,CA6BlB;AAwDD;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CASnD;AAuCD;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,MAAM,EAAE,kBAAkB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,MAAM,EAAE,uBAAuB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnF;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,cAAc,CAAC,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA6D5F;AAED;;;;;;;;GAQG;AACH,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,kBAAkB,EACxB,oBAAoB,EAAE,MAAM,GAC3B,OAAO,CAAC;IAAE,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAoCpE"}

package/dist/server/index.js

@@ -224654,7 +224654,7 @@ var init_sentry_scrub = __esm(() => {
 var require_package8 = __commonJS((exports, module) => {
   module.exports = {
     name: "@omni/api",
-    version: "2.260501.1",
+    version: "2.260501.2",
     type: "module",
     exports: {
       ".": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automagik/omni",
-  "version": "2.260501.1",
+  "version": "2.260501.2",
   "description": "LLM-optimized CLI for Omni",
   "type": "module",
   "bin": {
@@ -51,15 +51,15 @@
     "qrcode-terminal": "^0.12.0"
   },
   "devDependencies": {
-    "@omni/api": "2.260430.16",
-    "@omni/channel-discord": "2.260430.16",
-    "@omni/channel-gupshup": "2.260430.16",
-    "@omni/channel-sdk": "2.260430.16",
-    "@omni/channel-slack": "2.260430.16",
-    "@omni/channel-telegram": "2.260430.16",
-    "@omni/channel-whatsapp": "2.260430.16",
-    "@omni/core": "2.260430.16",
-    "@omni/sdk": "2.260430.16",
+    "@omni/api": "2.260501.1",
+    "@omni/channel-discord": "2.260501.1",
+    "@omni/channel-gupshup": "2.260501.1",
+    "@omni/channel-sdk": "2.260501.1",
+    "@omni/channel-slack": "2.260501.1",
+    "@omni/channel-telegram": "2.260501.1",
+    "@omni/channel-whatsapp": "2.260501.1",
+    "@omni/core": "2.260501.1",
+    "@omni/sdk": "2.260501.1",
     "@types/node": "^22.10.3",
     "@types/qrcode-terminal": "^0.12.2",
     "typescript": "^5.7.3"