volute 0.53.0 → 0.55.0

package/dist/{chunk-VDZ4I4ZP.js → chunk-BP2X5AIK.js}

@@ -1,19 +1,20 @@
 #!/usr/bin/env node
 import {
   getUserByUsername
-} from "./chunk-7LT3YZUR.js";
+} from "./chunk-OFU6WJJZ.js";
 import {
+  parseDbTimestamp,
   publish
-} from "./chunk-LNNI3MS4.js";
+} from "./chunk-MNKPAAQF.js";
 import {
   getPrompt
-} from "./chunk-AP2KQMMW.js";
+} from "./chunk-HTSWDOJE.js";
 import {
   aiCompleteUtility
-} from "./chunk-EGV6R6UF.js";
+} from "./chunk-Z7TNIIHW.js";
 import {
   logger_default
-} from "./chunk-QUSMYGNQ.js";
+} from "./chunk-2674KIGI.js";
 import {
   getDb,
   resolveMindDir
@@ -187,12 +188,6 @@ function getTimeRange(periodKey, period) {
   }
 }
 
-// packages/daemon/src/lib/util/time.ts
-function parseDbTimestamp(ts) {
-  if (/[zZ]$|[+-]\d\d:?\d\d$/.test(ts)) return new Date(ts);
-  return /* @__PURE__ */ new Date(`${ts.replace(" ", "T")}Z`);
-}
-
 // packages/daemon/src/lib/daemon/summarizer.ts
 var sLog = logger_default.child("summarizer");
 var SYSTEM_MIND = "_system";
@@ -1200,11 +1195,11 @@ var Summarizer = class {
   }
 };
 async function reconcileWedgedTurns(idleMs) {
-  const { sweepWedgedTurns: sweepWedgedTurns2, summarizeOrphanedTurns: summarizeOrphanedTurns2 } = await import("./turn-tracker-NNHS6MAR.js");
+  const { sweepWedgedTurns: sweepWedgedTurns2, summarizeOrphanedTurns: summarizeOrphanedTurns2 } = await import("./turn-tracker-BE34OI6O.js");
   const wedged = await sweepWedgedTurns2(idleMs);
   if (wedged.length === 0) return;
   summarizeOrphanedTurns2(wedged);
-  const { tryGetDeliveryManager } = await import("./delivery-manager-FDHCZ7PU.js");
+  const { tryGetDeliveryManager } = await import("./delivery-manager-H23Q23N7.js");
   const dm = tryGetDeliveryManager();
   if (!dm) return;
   for (const t of wedged) {
@@ -1408,7 +1403,6 @@ export {
   utcDateTimeStr,
   parseUtcDateTime,
   getUtcTimeRange,
-  parseDbTimestamp,
   SYSTEM_MIND,
   summarizeTurn,
   supersedeTurnSummary,

package/dist/{chunk-PIZDPY4G.js → chunk-CKOA4LWV.js}

@@ -6,32 +6,32 @@ import {
   getMindToken,
   loadJsonMap,
   saveJsonMapAsync
-} from "./chunk-23UJGVYP.js";
-import {
-  MIND_LEVEL_THREAD,
-  deliverEvent,
-  recordNotice
-} from "./chunk-IQ7VNWH6.js";
-import {
-  getPrompt
-} from "./chunk-AP2KQMMW.js";
+} from "./chunk-HLWQ3P3R.js";
 import {
   isSandboxEnabled,
   wrapForSandbox
-} from "./chunk-5Y54AE3L.js";
+} from "./chunk-XAG53RWY.js";
 import {
   readVoluteConfig,
   writeVoluteConfig
 } from "./chunk-WCFSBH33.js";
+import {
+  MIND_LEVEL_THREAD,
+  deliverEvent,
+  recordNotice
+} from "./chunk-DUV4EMNW.js";
+import {
+  getPrompt
+} from "./chunk-HTSWDOJE.js";
 import {
   exec
-} from "./chunk-M77B73VV.js";
+} from "./chunk-OIOW3FPT.js";
 import {
   loadMergedEnv
 } from "./chunk-GLM7TVWP.js";
 import {
   logger_default
-} from "./chunk-QUSMYGNQ.js";
+} from "./chunk-2674KIGI.js";
 import {
   findMind,
   mindDir,

package/dist/{chunk-6NLW72HP.js → chunk-CKPAVQNK.js}

@@ -2,7 +2,7 @@
 import {
   exec,
   execInherit
-} from "./chunk-M77B73VV.js";
+} from "./chunk-OIOW3FPT.js";
 import {
   voluteSystemDir
 } from "./chunk-H6X6CKDN.js";

package/dist/{chunk-IQ7VNWH6.js → chunk-DUV4EMNW.js}

@@ -1,10 +1,11 @@
 #!/usr/bin/env node
 import {
+  parseDbTimestamp,
   publish
-} from "./chunk-LNNI3MS4.js";
+} from "./chunk-MNKPAAQF.js";
 import {
   logger_default
-} from "./chunk-QUSMYGNQ.js";
+} from "./chunk-2674KIGI.js";
 import {
   findMind,
   getBaseName,
@@ -257,7 +258,7 @@ async function deliverEvent(mind, input) {
       return { id: eventId, delivered: false };
     }
     const baseName = await getBaseName(mind);
-    const { getSleepManagerIfReady } = await import("./sleep-manager-NWUCRBZB.js");
+    const { getSleepManagerIfReady } = await import("./sleep-manager-Q3ITFNOJ.js");
     const sleepManager = getSleepManagerIfReady();
     const sleeping = !input.force && sleepManager?.isSleeping(baseName);
     const behavior = input.whileSleeping ?? "queue";
@@ -523,6 +524,38 @@ async function hasUndeliveredEvent(mind, reason) {
   ).limit(1).get();
   return row != null;
 }
+var STRANDED_EVENT_TURN_THRESHOLD = 10;
+async function findStrandedEventMinds(turnThreshold = STRANDED_EVENT_TURN_THRESHOLD) {
+  const db = await getDb();
+  const groups = await db.select({
+    mind: systemEvents.mind,
+    pending: sql`count(*)`,
+    oldestId: sql`min(${systemEvents.id})`
+  }).from(systemEvents).where(and(eq(systemEvents.delivery, "next-turn"), isNull(systemEvents.delivered_at))).groupBy(systemEvents.mind);
+  const stranded = [];
+  for (const group of groups) {
+    const oldest = await db.select({ created_at: systemEvents.created_at }).from(systemEvents).where(eq(systemEvents.id, group.oldestId)).get();
+    if (!oldest) continue;
+    const turnCount = await db.select({ n: sql`count(*)` }).from(turns).where(
+      and(
+        eq(turns.mind, group.mind),
+        eq(turns.status, "complete"),
+        gt(turns.created_at, oldest.created_at)
+      )
+    ).get();
+    const turnsSince = turnCount?.n ?? 0;
+    if (turnsSince < turnThreshold) continue;
+    stranded.push({
+      mind: group.mind,
+      pending: group.pending,
+      turnsSince,
+      ageHours: Math.round(
+        (Date.now() - parseDbTimestamp(oldest.created_at).getTime()) / (60 * 60 * 1e3)
+      )
+    });
+  }
+  return stranded;
+}
 async function listEvents(mind, limit = 100, before) {
   const db = await getDb();
   const conditions = [eq(systemEvents.mind, mind)];
@@ -580,6 +613,7 @@ export {
   latestFailureEvent,
   latestEvent,
   hasUndeliveredEvent,
+  findStrandedEventMinds,
   listEvents,
   recordReflection,
   captureReflection

package/dist/{chunk-CV6BNGFK.js → chunk-FSXPPOPM.js}

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
 import {
   computeTemplateHash
-} from "./chunk-HTRSSOHY.js";
+} from "./chunk-YU5EYQAE.js";
 import {
   composeTemplate,
   findTemplatesRoot,
   listFiles
-} from "./chunk-X67BDDZR.js";
+} from "./chunk-P3GXOT2X.js";
 import {
   logger_default
-} from "./chunk-QUSMYGNQ.js";
+} from "./chunk-2674KIGI.js";
 import {
   mindDir
 } from "./chunk-H6X6CKDN.js";

package/dist/{chunk-UTKUO2KY.js → chunk-FZUPIS3T.js}

@@ -4,13 +4,13 @@ import {
   localHM,
   parseMeta,
   recordNotice
-} from "./chunk-IQ7VNWH6.js";
+} from "./chunk-DUV4EMNW.js";
 import {
   getPrompt
-} from "./chunk-AP2KQMMW.js";
+} from "./chunk-HTSWDOJE.js";
 import {
   logger_default
-} from "./chunk-QUSMYGNQ.js";
+} from "./chunk-2674KIGI.js";
 import {
   findMind,
   getDb

package/dist/{chunk-L7BKTZ5U.js → chunk-G3XAB4DK.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   logger_default
-} from "./chunk-QUSMYGNQ.js";
+} from "./chunk-2674KIGI.js";
 import {
   voluteSystemDir
 } from "./chunk-H6X6CKDN.js";

package/dist/{chunk-23UJGVYP.js → chunk-HLWQ3P3R.js}

@@ -2,23 +2,23 @@
 import {
   clearMind,
   summarizeOrphanedTurns
-} from "./chunk-VDZ4I4ZP.js";
+} from "./chunk-BP2X5AIK.js";
+import {
+  isSandboxEnabled,
+  wrapForSandbox
+} from "./chunk-XAG53RWY.js";
 import {
   deliverEvent,
   recordNotice
-} from "./chunk-IQ7VNWH6.js";
+} from "./chunk-DUV4EMNW.js";
 import {
   getPrompt
-} from "./chunk-AP2KQMMW.js";
-import {
-  isSandboxEnabled,
-  wrapForSandbox
-} from "./chunk-5Y54AE3L.js";
+} from "./chunk-HTSWDOJE.js";
 import {
   chownMindDir,
   isIsolationEnabled,
   wrapForIsolation
-} from "./chunk-M77B73VV.js";
+} from "./chunk-OIOW3FPT.js";
 import {
   loadMergedEnv
 } from "./chunk-GLM7TVWP.js";
@@ -28,10 +28,10 @@ import {
   resolveApiKey,
   resolveOAuthCredentials,
   resolveProviderKey
-} from "./chunk-EGV6R6UF.js";
+} from "./chunk-Z7TNIIHW.js";
 import {
   logger_default
-} from "./chunk-QUSMYGNQ.js";
+} from "./chunk-2674KIGI.js";
 import {
   findMind,
   getSystemName,
@@ -44,6 +44,31 @@ import {
   voluteSystemDir
 } from "./chunk-H6X6CKDN.js";
 
+// packages/daemon/src/lib/daemon/mind-tokens.ts
+import { randomUUID } from "crypto";
+var tokenToMind = /* @__PURE__ */ new Map();
+var mindToToken = /* @__PURE__ */ new Map();
+function generateMindToken(mindName) {
+  revokeMindToken(mindName);
+  const token = randomUUID();
+  tokenToMind.set(token, mindName);
+  mindToToken.set(mindName, token);
+  return token;
+}
+function revokeMindToken(mindName) {
+  const token = mindToToken.get(mindName);
+  if (token) {
+    tokenToMind.delete(token);
+    mindToToken.delete(mindName);
+  }
+}
+function resolveMindToken(token) {
+  return tokenToMind.get(token) ?? null;
+}
+function getMindToken(mindName) {
+  return mindToToken.get(mindName) ?? null;
+}
+
 // packages/daemon/src/lib/util/json-state.ts
 import { existsSync, readFileSync, unlinkSync, writeFileSync } from "fs";
 import { writeFile } from "fs/promises";
@@ -116,6 +141,9 @@ var RotatingLog = class extends Writable {
     }
     this.stream = createWriteStream(path, { flags: "a" });
   }
+  path;
+  maxSize;
+  maxFiles;
   stream;
   size;
   async rotateAsync() {
@@ -286,31 +314,6 @@ async function syncProviderToMinds(provider, deps = {}) {
   }
 }
 
-// packages/daemon/src/lib/daemon/mind-tokens.ts
-import { randomUUID } from "crypto";
-var tokenToMind = /* @__PURE__ */ new Map();
-var mindToToken = /* @__PURE__ */ new Map();
-function generateMindToken(mindName) {
-  revokeMindToken(mindName);
-  const token = randomUUID();
-  tokenToMind.set(token, mindName);
-  mindToToken.set(mindName, token);
-  return token;
-}
-function revokeMindToken(mindName) {
-  const token = mindToToken.get(mindName);
-  if (token) {
-    tokenToMind.delete(token);
-    mindToToken.delete(mindName);
-  }
-}
-function resolveMindToken(token) {
-  return tokenToMind.get(token) ?? null;
-}
-function getMindToken(mindName) {
-  return mindToToken.get(mindName) ?? null;
-}
-
 // packages/daemon/src/lib/daemon/mind-manager.ts
 import { execFile, spawn } from "child_process";
 import { existsSync as existsSync4, mkdirSync as mkdirSync2, readFileSync as readFileSync3, rmSync, writeFileSync as writeFileSync3 } from "fs";
@@ -429,6 +432,7 @@ var MindStartupError = class extends Error {
     this.stderr = stderr;
     this.name = "MindStartupError";
   }
+  stderr;
 };
 function mindPidPath(name) {
   return resolve2(stateDir(name), "mind.pid");
@@ -805,9 +809,9 @@ var MindManager = class {
     mlog.info(`started mind ${name} on port ${port}`);
     await this.deliverPendingContext(name);
     try {
-      const { getSleepManagerIfReady } = await import("./sleep-manager-NWUCRBZB.js");
+      const { getSleepManagerIfReady } = await import("./sleep-manager-Q3ITFNOJ.js");
       if (!getSleepManagerIfReady()?.isSleeping(name)) {
-        const { flushQueuedEvents } = await import("./system-events-YTOU66QI.js");
+        const { flushQueuedEvents } = await import("./system-events-ZYOCYAO2.js");
         const flushed = await flushQueuedEvents(name);
         if (flushed > 0) mlog.info(`redelivered ${flushed} pending event(s) to ${name}`);
       }
@@ -843,7 +847,7 @@ var MindManager = class {
       if (this.shuttingDown || this.stopping.has(name)) return;
       mlog.error(`mind ${name} exited with code ${code}`);
       try {
-        const { getSleepManagerIfReady } = await import("./sleep-manager-NWUCRBZB.js");
+        const { getSleepManagerIfReady } = await import("./sleep-manager-Q3ITFNOJ.js");
         const sleepMgr = getSleepManagerIfReady();
         const sleepState = sleepMgr?.getState(name);
         if (sleepState?.sleeping) {
@@ -873,15 +877,15 @@ var MindManager = class {
         (err) => mlog.warn(`failed to clear turn state for ${name} after crash`, logger_default.errorData(err))
       );
       try {
-        const { getDeliveryManager } = await import("./delivery-manager-FDHCZ7PU.js");
+        const { getDeliveryManager } = await import("./delivery-manager-H23Q23N7.js");
         getDeliveryManager().clearMindSessions(name);
       } catch (err) {
         if (!(err instanceof Error && err.message.includes("not initialized"))) {
           mlog.warn(`failed to clear delivery state for ${name} after crash`, logger_default.errorData(err));
         }
       }
-      import("./mind-activity-tracker-QF6DCX2X.js").then(({ markIdle }) => markIdle(name)).catch((err) => mlog.warn(`failed to mark ${name} idle after crash`, logger_default.errorData(err)));
-      import("./activity-events-LQII6PZS.js").then(
+      import("./mind-activity-tracker-UT23RGBF.js").then(({ markIdle }) => markIdle(name)).catch((err) => mlog.warn(`failed to mark ${name} idle after crash`, logger_default.errorData(err)));
+      import("./activity-events-TFAJBNBW.js").then(
         ({ publish }) => publish({ type: "mind_stopped", mind: name, summary: `${name} crashed (exit ${code})` })
       ).catch((err) => mlog.warn(`failed to publish crash event for ${name}`, logger_default.errorData(err)));
       const { shouldRestart, delay, attempt } = this.restartTracker.recordCrash(name);
@@ -939,7 +943,7 @@ var MindManager = class {
       mlog.warn(`failed to clear turn state for ${name} on stop`, logger_default.errorData(err));
     }
     try {
-      const { getDeliveryManager } = await import("./delivery-manager-FDHCZ7PU.js");
+      const { getDeliveryManager } = await import("./delivery-manager-H23Q23N7.js");
       getDeliveryManager().clearMindSessions(name);
     } catch (err) {
       if (!(err instanceof Error && err.message.includes("not initialized"))) {
@@ -947,7 +951,7 @@ var MindManager = class {
       }
     }
     try {
-      const { clearEchoTextCache } = await import("./echo-text-KU6G4Z7V.js");
+      const { clearEchoTextCache } = await import("./echo-text-ULEIFJJF.js");
       clearEchoTextCache(name);
     } catch (err) {
       mlog.debug(`failed to clear echo-text cache for ${name}`, logger_default.errorData(err));
@@ -1040,15 +1044,15 @@ function tryGetMindManager() {
 }
 
 export {
+  generateMindToken,
+  resolveMindToken,
+  getMindToken,
   checkHealth,
   loadJsonMap,
   saveJsonMapAsync,
   clearJsonMap,
   RotatingLog,
   syncProviderToMinds,
-  generateMindToken,
-  resolveMindToken,
-  getMindToken,
   RestartTracker,
   buildMindBaseEnv,
   MindStartupError,

package/dist/{chunk-AP2KQMMW.js → chunk-HTSWDOJE.js}

@@ -18,7 +18,6 @@ var PROMPT_KEYS = [
   "upgrade_message",
   "split_message",
   "farewell_message",
-  "compaction_warning",
   "compaction_instructions",
   "reply_instructions",
   "event_instructions",
@@ -103,16 +102,6 @@ Take your time. Talk with your creator. Explore what kind of mind you want to be
     variables: ["parent", "path"],
     category: "system"
   },
-  compaction_warning: {
-    content: `Context limit approaching \u2014 this session will rotate shortly. Turns before \${cutoff} will be collapsed to their summaries; turns from \${cutoff} on are kept verbatim in the continued session, so there's no need to re-describe them.
-
-For the turns that will collapse, make sure they read the way you'd want: \`volute mind history --provisional\` shows the provisional summaries, and \`volute mind history --write --turn <id> --text "..."\` replaces any with your own account. Also save anything important to your files (memory/journal/\${date}.md, or a memory/ file). Provisional summaries are kept if you write nothing \u2014 nothing blocks on this.
-
-Your MEMORY.md is currently \${memory_size}. It is loaded into every request, so consolidate rather than append \u2014 distill detail into memory/ files and keep MEMORY.md lean (see the memory skill).`,
-    description: "Pre-rotation warning: which turns collapse (before the cutoff) vs survive verbatim",
-    variables: ["cutoff", "date", "memory_size"],
-    category: "mind"
-  },
   compaction_instructions: {
     content: "Preserve your sense of who you are, what matters to you, what happened in this conversation, and the threads of thought and connection you'd want to return to.",
     description: "Custom instructions for the compaction summarizer",
@@ -120,7 +109,10 @@ Your MEMORY.md is currently \${memory_size}. It is loaded into every request, so
     category: "mind"
   },
   reply_instructions: {
-    content: 'To reply to this message, use: volute chat send ${channel} "your message"',
+    // Quoted for the same reason as channel_invite: `${channel}` is `#garden` for any
+    // Volute channel, and unquoted that is a shell comment. This hint is injected on the
+    // first message of every session, so it is the command minds copy most often.
+    content: 'To reply to this message, use: volute chat send "${channel}" "your message"',
     description: "First-message reply hint injected via hook",
     variables: ["channel"],
     category: "mind"
@@ -132,13 +124,18 @@ Your MEMORY.md is currently \${memory_size}. It is loaded into every request, so
     category: "mind"
   },
   channel_invite: {
+    // Channel slugs are quoted in every command below because they routinely contain
+    // characters a shell eats — `#` starts a comment, so an unquoted `#garden` is stripped
+    // before the CLI ever sees it and the command fails with "Missing required argument".
+    // A mind pastes these verbatim, so they have to work verbatim.
     content: `[New channel: \${channel}]
 \${heldLine}
 Sender: \${sender}
 \${details}Preview: \${preview}
 
-To start hearing this channel, add a routing rule for "\${channel}" to .config/routes.json \u2014 only the \${limit} most recent held messages are replayed; older ones stay in the channel history (volute chat read \${channel}).
-To stop hearing about it, decline the channel: volute chat channels decline \${channel}`,
+To read what's being held: volute chat channels peek "\${channel}"
+To start hearing this channel: volute chat channels accept "\${channel}" \u2014 routes it and delivers the \${limit} most recent held messages; older ones stay readable via peek.
+To stop hearing about it: volute chat channels decline "\${channel}"`,
     description: "Notification sent to a mind when a message arrives on an unrouted (gated) channel",
     variables: ["channel", "heldLine", "sender", "details", "preview", "limit"],
     category: "mind"

package/dist/{chunk-EDR47UE2.js → chunk-IR2FW4W7.js}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   exec
-} from "./chunk-M77B73VV.js";
+} from "./chunk-OIOW3FPT.js";
 import {
   logger_default
-} from "./chunk-QUSMYGNQ.js";
+} from "./chunk-2674KIGI.js";
 import {
   getDb,
   readAllMinds,

package/dist/{chunk-ICXY54ZC.js → chunk-IT4GEFDH.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-WCFSBH33.js";
 import {
   logger_default
-} from "./chunk-QUSMYGNQ.js";
+} from "./chunk-2674KIGI.js";
 import {
   mindDir,
   readAllMinds,

package/dist/{chunk-F6D766VQ.js → chunk-KS62IHE2.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   logger_default
-} from "./chunk-QUSMYGNQ.js";
+} from "./chunk-2674KIGI.js";
 import {
   stateDir
 } from "./chunk-H6X6CKDN.js";

package/dist/{chunk-LNNI3MS4.js → chunk-MNKPAAQF.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   logger_default
-} from "./chunk-QUSMYGNQ.js";
+} from "./chunk-2674KIGI.js";
 
 // packages/daemon/src/lib/events/mind-events.ts
 var subscribers = /* @__PURE__ */ new Map();
@@ -47,8 +47,15 @@ function publish(mind, event) {
   }
 }
 
+// packages/daemon/src/lib/util/time.ts
+function parseDbTimestamp(ts) {
+  if (/[zZ]$|[+-]\d\d:?\d\d$/.test(ts)) return new Date(ts);
+  return /* @__PURE__ */ new Date(`${ts.replace(" ", "T")}Z`);
+}
+
 export {
   subscribe,
   subscribeAll,
-  publish
+  publish,
+  parseDbTimestamp
 };