volute 0.44.0 → 0.45.1

package/dist/chunk-KVKP6VQ5.js

@@ -0,0 +1,318 @@
+#!/usr/bin/env node
+import {
+  exec
+} from "./chunk-3ERIL673.js";
+import {
+  readGlobalConfig
+} from "./chunk-322KE457.js";
+import {
+  logger_default
+} from "./chunk-T2TP6ZC6.js";
+import {
+  getDb,
+  readAllMinds,
+  voluteHome,
+  voluteSystemDir
+} from "./chunk-H7IYFRAL.js";
+
+// packages/daemon/src/lib/backup/restic.ts
+import { writeFileSync } from "fs";
+import { resolve } from "path";
+var RESTIC_INSTALL_HINT = "Install restic: `brew install restic` (macOS), `apt-get install restic` (Debian/Ubuntu), or see https://restic.net";
+async function resticVersion() {
+  try {
+    const out = await exec("restic", ["version"]);
+    return out.trim();
+  } catch (err) {
+    if (err.code !== "ENOENT") {
+      logger_default.child("backup").warn("restic exists but failed to run", logger_default.errorData(err));
+    }
+    return null;
+  }
+}
+function resticEnv(config) {
+  if (!config.repository) throw new Error("Backup repository is not configured");
+  if (!config.password) throw new Error("Backup password is not configured");
+  return {
+    ...process.env,
+    ...config.env,
+    RESTIC_REPOSITORY: config.repository,
+    RESTIC_PASSWORD: config.password
+  };
+}
+async function runRestic(args, config, options) {
+  if (!await resticVersion()) {
+    throw new Error(`restic is not installed. ${RESTIC_INSTALL_HINT}`);
+  }
+  return exec("restic", args, { cwd: options?.cwd, env: resticEnv(config) });
+}
+var BASE_EXCLUDES = [
+  // dependency trees and build output — rehydrated via lockfiles
+  "node_modules",
+  ".venv",
+  "venv",
+  "__pycache__",
+  "dist",
+  // mind runtime state that is regenerated
+  ".variants",
+  ".worktrees",
+  ".mind/tmp",
+  ".npm",
+  // toolchains and caches minds install into their home. home/.local must NOT
+  // be excluded wholesale: .local/hooks and .local/bin hold mind-authored hooks
+  // and skill shims that are never regenerated — only its toolchain subdirs go.
+  "home/.cache",
+  "home/.npm",
+  "home/.rustup",
+  "home/.cargo",
+  "home/.local/share",
+  "home/.local/state",
+  "home/.local/lib",
+  "home/.local/pipx"
+];
+function systemExcludes() {
+  const sys = voluteSystemDir();
+  return [
+    resolve(sys, "volute.db"),
+    resolve(sys, "volute.db-wal"),
+    resolve(sys, "volute.db-shm"),
+    `${resolve(sys, "extension-data")}/*/data.db`,
+    `${resolve(sys, "extension-data")}/*/data.db-wal`,
+    `${resolve(sys, "extension-data")}/*/data.db-shm`,
+    `${resolve(sys, "state")}/*/logs`,
+    resolve(sys, "daemon.log"),
+    resolve(sys, "daemon.pid"),
+    resolve(sys, "backup-excludes.txt")
+  ];
+}
+var SESSION_EXCLUDES = [
+  "home/.claude/projects",
+  "home/.claude/debug",
+  "home/.claude/telemetry",
+  "home/.claude/todos",
+  "home/.claude/session-env",
+  ".mind/codex/sessions",
+  ".mind/pi-sessions"
+];
+function buildExcludePatterns(config) {
+  const patterns = [...BASE_EXCLUDES, ...systemExcludes()];
+  if (!config.includeSessions) patterns.push(...SESSION_EXCLUDES);
+  return patterns;
+}
+function writeExcludeFile(config) {
+  const path = resolve(voluteSystemDir(), "backup-excludes.txt");
+  writeFileSync(path, `${buildExcludePatterns(config).join("\n")}
+`);
+  return path;
+}
+
+// packages/daemon/src/lib/backup/backup.ts
+import {
+  existsSync,
+  mkdirSync,
+  readdirSync,
+  readFileSync,
+  renameSync,
+  rmSync,
+  writeFileSync as writeFileSync2
+} from "fs";
+import { dirname, resolve as resolve2 } from "path";
+import { sql } from "drizzle-orm";
+var blog = logger_default.child("backup");
+var DEFAULT_KEEP = { daily: 7, weekly: 4, monthly: 12 };
+function stateFilePath() {
+  return resolve2(voluteSystemDir(), "backup-state.json");
+}
+function readBackupState() {
+  const path = stateFilePath();
+  if (!existsSync(path)) return {};
+  try {
+    return JSON.parse(readFileSync(path, "utf-8"));
+  } catch (err) {
+    blog.warn("backup-state.json unreadable, treating as empty", logger_default.errorData(err));
+    return {};
+  }
+}
+function writeBackupState(state) {
+  try {
+    writeFileSync2(stateFilePath(), `${JSON.stringify(state, null, 2)}
+`);
+  } catch (err) {
+    blog.error("failed to write backup-state.json", logger_default.errorData(err));
+  }
+}
+function stagingDir() {
+  return resolve2(voluteSystemDir(), "backup-staging");
+}
+async function stageDatabases() {
+  const staging = stagingDir();
+  rmSync(staging, { recursive: true, force: true });
+  mkdirSync(staging, { recursive: true });
+  const staged = [];
+  const mainTarget = resolve2(staging, "volute.db");
+  const db = await getDb();
+  await db.run(sql.raw(`VACUUM INTO '${mainTarget.replaceAll("'", "''")}'`));
+  staged.push(mainTarget);
+  const extDataDir = resolve2(voluteSystemDir(), "extension-data");
+  if (existsSync(extDataDir)) {
+    const { default: Database } = await import("libsql");
+    for (const id of readdirSync(extDataDir)) {
+      const dbPath = resolve2(extDataDir, id, "data.db");
+      if (!existsSync(dbPath)) continue;
+      const target = resolve2(staging, "extension-data", id, "data.db");
+      mkdirSync(dirname(target), { recursive: true });
+      const extDb = new Database(dbPath);
+      try {
+        extDb.exec(`VACUUM INTO '${target.replaceAll("'", "''")}'`);
+        staged.push(target);
+      } finally {
+        extDb.close();
+      }
+    }
+  }
+  return staged;
+}
+async function backupRoots() {
+  const roots = /* @__PURE__ */ new Set([voluteHome()]);
+  const mindsDir = process.env.VOLUTE_MINDS_DIR;
+  if (mindsDir && existsSync(mindsDir)) roots.add(resolve2(mindsDir));
+  for (const mind of await readAllMinds()) {
+    if (!mind.dir || !existsSync(mind.dir)) continue;
+    const dir = resolve2(mind.dir);
+    if (![...roots].some((root) => dir === root || dir.startsWith(`${root}/`))) {
+      roots.add(dir);
+    }
+  }
+  return [...roots];
+}
+var backupInFlight = false;
+async function runBackup() {
+  if (backupInFlight) throw new Error("A backup is already running");
+  backupInFlight = true;
+  const started = Date.now();
+  try {
+    const config = readGlobalConfig().backup ?? {};
+    if (!config.repository || !config.password) {
+      throw new Error("Backup repository is not configured. Run: volute backup init");
+    }
+    blog.info("starting backup", { repository: config.repository });
+    await stageDatabases();
+    const roots = await backupRoots();
+    const excludeFile = writeExcludeFile(config);
+    const out = await runRestic(
+      [
+        "backup",
+        ...roots,
+        "--exclude-file",
+        excludeFile,
+        "--exclude-caches",
+        "--tag",
+        "volute",
+        "--json"
+      ],
+      config
+    );
+    const summary = parseBackupSummary(out, Date.now() - started);
+    const keep = { ...DEFAULT_KEEP, ...config.keep };
+    let pruneError;
+    try {
+      await runRestic(
+        [
+          "forget",
+          "--tag",
+          "volute",
+          "--keep-daily",
+          String(keep.daily),
+          "--keep-weekly",
+          String(keep.weekly),
+          "--keep-monthly",
+          String(keep.monthly),
+          "--prune"
+        ],
+        config
+      );
+    } catch (err) {
+      pruneError = err instanceof Error ? err.message : String(err);
+      blog.warn("retention prune failed (snapshot is intact)", logger_default.errorData(err));
+    }
+    writeBackupState({
+      lastRun: (/* @__PURE__ */ new Date()).toISOString(),
+      lastSnapshotId: summary.snapshotId,
+      lastDurationMs: summary.durationMs,
+      ...pruneError ? { pruneError } : {}
+    });
+    blog.info("backup complete", { snapshot: summary.snapshotId, ms: summary.durationMs });
+    return summary;
+  } catch (err) {
+    writeBackupState({
+      ...readBackupState(),
+      lastAttempt: (/* @__PURE__ */ new Date()).toISOString(),
+      lastError: err instanceof Error ? err.message : String(err)
+    });
+    throw err;
+  } finally {
+    backupInFlight = false;
+  }
+}
+function parseBackupSummary(output, durationMs) {
+  for (const line of output.trim().split("\n").reverse()) {
+    let msg;
+    try {
+      msg = JSON.parse(line);
+    } catch {
+      continue;
+    }
+    if (msg.message_type !== "summary") continue;
+    if (!msg.snapshot_id) throw new Error("restic summary is missing snapshot_id");
+    return {
+      snapshotId: msg.snapshot_id,
+      filesNew: msg.files_new ?? 0,
+      filesChanged: msg.files_changed ?? 0,
+      dataAdded: msg.data_added ?? 0,
+      totalFilesProcessed: msg.total_files_processed ?? 0,
+      durationMs
+    };
+  }
+  throw new Error("restic backup produced no summary");
+}
+async function listSnapshots() {
+  const config = readGlobalConfig().backup ?? {};
+  const out = await runRestic(["snapshots", "--tag", "volute", "--json"], config);
+  const parsed = JSON.parse(out || "[]");
+  return parsed.map((s) => ({
+    id: s.id,
+    short_id: s.short_id,
+    time: s.time,
+    hostname: s.hostname,
+    paths: s.paths
+  }));
+}
+async function initRepo(config) {
+  try {
+    await runRestic(["init"], config);
+  } catch (err) {
+    const stderr = err.stderr ?? "";
+    const msg = err instanceof Error ? err.message : String(err);
+    if (/already exists|already initialized/i.test(stderr + msg)) return;
+    throw err;
+  }
+}
+function restoreStagedDb(stagedPath, livePath) {
+  if (!existsSync(stagedPath)) return false;
+  mkdirSync(dirname(livePath), { recursive: true });
+  rmSync(livePath, { force: true });
+  rmSync(`${livePath}-wal`, { force: true });
+  rmSync(`${livePath}-shm`, { force: true });
+  renameSync(stagedPath, livePath);
+  return true;
+}
+
+export {
+  RESTIC_INSTALL_HINT,
+  resticVersion,
+  readBackupState,
+  runBackup,
+  listSnapshots,
+  initRepo,
+  restoreStagedDb
+};

package/dist/{chunk-3GYVW2X3.js → chunk-OXXTPILE.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   readGlobalConfig
-} from "./chunk-PNV24SEP.js";
+} from "./chunk-322KE457.js";
 import {
   logger_default
 } from "./chunk-T2TP6ZC6.js";

package/dist/{chunk-J47TIYHA.js → chunk-TSK5PI4L.js}

@@ -2,7 +2,7 @@
 import {
   readGlobalConfig,
   writeGlobalConfig
-} from "./chunk-PNV24SEP.js";
+} from "./chunk-322KE457.js";
 import {
   logger_default
 } from "./chunk-T2TP6ZC6.js";

package/dist/{chunk-OMETFX5H.js → chunk-U4FNXDEJ.js}

@@ -4,13 +4,13 @@ import {
 } from "./chunk-5GT7URXJ.js";
 import {
   spiritDir
-} from "./chunk-7FT24JBQ.js";
+} from "./chunk-5AUKCNPE.js";
 import {
   hashSkillDir,
   importSkillFromDir,
   removeSharedSkill,
   sharedSkillsDir
-} from "./chunk-I2Y2YHIO.js";
+} from "./chunk-Y6OPHHGM.js";
 import {
   addMessage,
   createChannel,
@@ -20,7 +20,7 @@ import {
   getParticipants,
   joinChannel,
   publish as publish2
-} from "./chunk-FZMEVCWC.js";
+} from "./chunk-JSRMEY52.js";
 import {
   readVoluteConfig,
   writeVoluteConfig
@@ -28,7 +28,7 @@ import {
 import {
   isSandboxEnabled,
   wrapForSandbox
-} from "./chunk-3GYVW2X3.js";
+} from "./chunk-OXXTPILE.js";
 import {
   markIdle,
   onMindEvent
@@ -39,14 +39,14 @@ import {
   resolveDeliveryMode,
   resolveRoute,
   setRoutesChangeListener
-} from "./chunk-5AHYQHNT.js";
+} from "./chunk-ZIR7HSAX.js";
 import {
   clearMind,
   getPrompt,
   linkInboundToActiveTurn,
   publish as publish3,
   summarizeOrphanedTurns
-} from "./chunk-NF75HPNR.js";
+} from "./chunk-V4GYPD5L.js";
 import {
   chownMindDir,
   exec,
@@ -58,11 +58,11 @@ import {
   aiCompleteUtility,
   getAiConfig,
   resolveApiKey
-} from "./chunk-J47TIYHA.js";
+} from "./chunk-TSK5PI4L.js";
 import {
   readGlobalConfig,
   writeGlobalConfig
-} from "./chunk-PNV24SEP.js";
+} from "./chunk-322KE457.js";
 import {
   getOrCreateMindUser,
   getOrCreateSystemUser,
@@ -385,7 +385,8 @@ async function clearDeliveredNotices(mind, session, uptoId) {
 var NOTICE_HEADER = "[Notices] While you were unavailable, one or more turns failed. You're back now:";
 function formatNotices(notices) {
   if (notices.length === 0) return null;
-  const failures = notices.filter((n) => n.kind !== "extension");
+  const failures = notices.filter((n) => n.kind !== "extension" && n.kind !== "budget");
+  const budgets = notices.filter((n) => n.kind === "budget");
   const extensions = notices.filter((n) => n.kind === "extension");
   const blocks = [];
   if (failures.length > 0) {
@@ -407,6 +408,11 @@ function formatNotices(notices) {
       return `- ${g.count} ${plural} failed (${span}): ${g.detail}`;
     });
     blocks.push(`${NOTICE_HEADER}
+${lines.join("\n")}`);
+  }
+  if (budgets.length > 0) {
+    const lines = budgets.map((n) => `- ${localHM(n.created_at)} ${n.detail}`);
+    blocks.push(`[Budget]
 ${lines.join("\n")}`);
   }
   if (extensions.length > 0) {
@@ -887,6 +893,8 @@ var MindManager = class {
     const parts = [];
     if (context.type === "merge" || context.type === "merged") {
       parts.push(await getPrompt("merge_message", { name: String(context.name ?? "") }));
+    } else if (context.type === "split") {
+      parts.push(await getPrompt("split_message", { name, parent: String(context.parent ?? "") }));
     } else if (context.type === "sprouted") {
       parts.push(await getPrompt("sprout_message"));
     } else if (context.type === "upgraded") {
@@ -931,7 +939,7 @@ var MindManager = class {
       if (this.shuttingDown || this.stopping.has(name)) return;
       mlog.error(`mind ${name} exited with code ${code}`);
       try {
-        const { getSleepManagerIfReady: getSleepManagerIfReady2 } = await import("./sleep-manager-HINI6Y46.js");
+        const { getSleepManagerIfReady: getSleepManagerIfReady2 } = await import("./sleep-manager-YAHDOIU5.js");
         const sleepMgr = getSleepManagerIfReady2();
         const sleepState = sleepMgr?.getState(name);
         if (sleepState?.sleeping) {
@@ -961,7 +969,7 @@ var MindManager = class {
         (err) => mlog.warn(`failed to clear turn state for ${name} after crash`, logger_default.errorData(err))
       );
       try {
-        const { getDeliveryManager: getDeliveryManager2 } = await import("./delivery-manager-TEVOHX5W.js");
+        const { getDeliveryManager: getDeliveryManager2 } = await import("./delivery-manager-R5STGLXB.js");
         getDeliveryManager2().clearMindSessions(name);
       } catch (err) {
         if (!(err instanceof Error && err.message.includes("not initialized"))) {
@@ -1027,7 +1035,7 @@ var MindManager = class {
       mlog.warn(`failed to clear turn state for ${name} on stop`, logger_default.errorData(err));
     }
     try {
-      const { getDeliveryManager: getDeliveryManager2 } = await import("./delivery-manager-TEVOHX5W.js");
+      const { getDeliveryManager: getDeliveryManager2 } = await import("./delivery-manager-R5STGLXB.js");
       getDeliveryManager2().clearMindSessions(name);
     } catch (err) {
       if (!(err instanceof Error && err.message.includes("not initialized"))) {
@@ -1035,7 +1043,7 @@ var MindManager = class {
       }
     }
     try {
-      const { clearEchoTextCache } = await import("./echo-text-T7ZA5EYD.js");
+      const { clearEchoTextCache } = await import("./echo-text-NQXYYYCU.js");
       clearEchoTextCache(name);
     } catch (err) {
       mlog.debug(`failed to clear echo-text cache for ${name}`, logger_default.errorData(err));
@@ -2763,7 +2771,7 @@ async function wakeMind(name) {
 async function startSpiritFull(name) {
   const entry = await findMind(name);
   if (entry?.dir) {
-    const { registerMindDir } = await import("./delivery-router-GODSIS62.js");
+    const { registerMindDir } = await import("./delivery-router-6DE3BPHO.js");
     registerMindDir(name, entry.dir);
   }
   await getMindManager().startMind(name);
@@ -2786,7 +2794,7 @@ async function stopSpiritFull(name) {
 }
 async function ensureCreatorDM(mindName, creatorUsername) {
   const { getOrCreateMindUser: getOrCreateMindUser2, getUserByUsername: getUserByUsername2 } = await import("./auth-FRZJVQCS.js");
-  const { findDMConversation: findDMConversation2, createConversation: createConversation2 } = await import("./conversations-WAJYZKOC.js");
+  const { findDMConversation: findDMConversation2, createConversation: createConversation2 } = await import("./conversations-G4LYMHAA.js");
   const mindUser = await getOrCreateMindUser2(mindName);
   const creatorUser = await getUserByUsername2(creatorUsername);
   if (!creatorUser) {
@@ -2838,6 +2846,22 @@ function formatCurrentDate() {
     day: "numeric"
   });
 }
+function formatWakeTime(wakeAt) {
+  if (wakeAt) {
+    const date = new Date(wakeAt);
+    if (!Number.isNaN(date.getTime())) {
+      const time = date.toLocaleTimeString("en-US", { hour: "numeric", minute: "2-digit" });
+      const day = date.toLocaleDateString("en-US", {
+        weekday: "long",
+        month: "long",
+        day: "numeric"
+      });
+      return `at ${time} on ${day}`;
+    }
+    return `at ${wakeAt}`;
+  }
+  return "when something needs you \u2014 a message, a mention, or someone waking you";
+}
 function formatDuration(from, to) {
   const ms = to.getTime() - from.getTime();
   const hours = Math.floor(ms / 36e5);
@@ -2985,7 +3009,8 @@ var SleepManager = class {
       const entry = await findMind(name);
       if (!entry) return;
       const sleepConfig = this.getSleepConfig(name);
-      const wakeTime = opts?.voluntaryWakeAt ?? this.getNextWakeTime(sleepConfig) ?? "scheduled time";
+      const wakeAt = opts?.voluntaryWakeAt ?? this.getNextWakeTime(sleepConfig);
+      const wakeTime = formatWakeTime(wakeAt);
       const preSleepMsg = await getPrompt("pre_sleep", { wakeTime });
       let conversationId;
       try {
@@ -3161,7 +3186,7 @@ var SleepManager = class {
       const db = await getDb();
       const rows = await db.select().from(deliveryQueue).where(and2(eq3(deliveryQueue.mind, name), eq3(deliveryQueue.status, "sleep-queued"))).all();
       if (rows.length === 0) return 0;
-      const { deliverMessage: deliverMessage2 } = await import("./message-delivery-2EA5LLMD.js");
+      const { deliverMessage: deliverMessage2 } = await import("./message-delivery-IUAXRPFE.js");
       const delivered = [];
       for (const row of rows) {
         try {
@@ -4308,16 +4333,17 @@ var DeliveryManager = class {
     const channel = payload.channel ?? "unknown";
     const notification = [
       `[New channel: ${channel}]`,
+      `Someone new is reaching out \u2014 you don't have a route for this channel yet.`,
       `Sender: ${payload.sender ?? "unknown"}`,
       payload.platform ? `Platform: ${payload.platform}` : null,
       payload.participantCount ? `Participants: ${payload.participantCount}` : null,
       "",
       `Preview: ${preview}`,
       "",
-      `To accept this channel, add a routing rule for "${channel}" to your routes.json.`,
-      `Messages are being held until a route is configured.`
+      `To start hearing this channel, add a routing rule for "${channel}" to .config/routes.json.`,
+      `Messages are held safely until you do \u2014 nothing is lost. If you'd rather not engage, just leave it unrouted.`
     ].filter((line) => line !== null).join("\n");
-    const { sendSystemMessage: sendSystemMessage2 } = await import("./system-chat-4DQZOEZI.js");
+    const { sendSystemMessage: sendSystemMessage2 } = await import("./system-chat-E65T2HSW.js");
     await sendSystemMessage2(mindName, notification);
   }
   /**
@@ -4758,7 +4784,7 @@ async function generateSystemReply(conversationId, mindName, message) {
     if (config.sleep.schedule?.wake) contextParts.push(`Wake cron: ${config.sleep.schedule.wake}`);
   }
   try {
-    const { getSleepManagerIfReady: getSleepManagerIfReady2 } = await import("./sleep-manager-HINI6Y46.js");
+    const { getSleepManagerIfReady: getSleepManagerIfReady2 } = await import("./sleep-manager-YAHDOIU5.js");
     const sm = getSleepManagerIfReady2();
     if (sm) {
       const state2 = sm.getState(mindName);