volute 0.50.0 → 0.52.0

package/dist/{chunk-JI67D7O2.js → chunk-RU74YG46.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   tryGetMindManager
-} from "./chunk-ALIVXDM4.js";
+} from "./chunk-724DVYHU.js";
 import {
   extractTextContent,
   getRoutingConfig,
@@ -9,23 +9,27 @@ import {
   resolveRoute,
   setRoutesChangeListener,
   shouldGate
-} from "./chunk-6BM2I736.js";
+} from "./chunk-UDZLPR34.js";
 import {
   linkInboundToActiveTurn
-} from "./chunk-7DXLIYPY.js";
+} from "./chunk-YVR6EHWL.js";
+import {
+  MIND_LEVEL_THREAD,
+  newEphemeralSession
+} from "./chunk-AXFLY5GU.js";
 import {
   publish
 } from "./chunk-LNNI3MS4.js";
 import {
   getParticipants,
   publish as publish2
-} from "./chunk-574M6I7F.js";
+} from "./chunk-TPX6E6PL.js";
 import {
   onMindEvent
-} from "./chunk-E5S3ILVA.js";
+} from "./chunk-UFTDRTCP.js";
 import {
   renderAvatarBlock
-} from "./chunk-X67VT4QO.js";
+} from "./chunk-ICXY54ZC.js";
 import {
   readVoluteConfig
 } from "./chunk-WCFSBH33.js";
@@ -38,13 +42,13 @@ import {
   getDb,
   mindDir,
   voluteHome
-} from "./chunk-CAIYV33P.js";
+} from "./chunk-H6X6CKDN.js";
 import {
   channelGates,
   deliveryQueue,
   messages,
   mindHistory
-} from "./chunk-5IIVOWSP.js";
+} from "./chunk-2RNMBXD2.js";
 
 // packages/daemon/src/lib/delivery/delivery-manager.ts
 import { realpath } from "fs/promises";
@@ -214,6 +218,7 @@ var REDRIVE_INTERVAL_MS = 15e3;
 var RETRY_BASE_MS = 5e3;
 var RETRY_MAX_MS = 5 * 6e4;
 var REDRIVE_BATCH_LIMIT = 200;
+var MAX_DELIVERY_ATTEMPTS = 10;
 var GATED_RELEASE_LIMIT_PER_CHANNEL = 10;
 var GATED_NOTIFY_EVERY = 10;
 var mentionRegexCache = /* @__PURE__ */ new Map();
@@ -238,9 +243,14 @@ var DeliveryManager = class {
   isMindRunning = (name) => tryGetMindManager()?.isRunning(name) ?? false;
   /** Delivers a channel event to a mind (invites, release summaries); overridable in tests. */
   notify = async (mindName, text) => {
-    const { deliverEvent } = await import("./system-events-A6IGCEC3.js");
+    const { deliverEvent } = await import("./system-events-V43HDA3T.js");
     await deliverEvent(mindName, { type: "channel", body: text });
   };
+  /** Surfaces a dead-lettered delivery as a next-turn failure notice; overridable in tests. */
+  notifyFailure = async (input) => {
+    const { recordNotice } = await import("./system-events-V43HDA3T.js");
+    await recordNotice(input);
+  };
   constructor() {
     setRoutesChangeListener((mind) => {
       this.releaseGated(mind).catch(
@@ -256,6 +266,10 @@ var DeliveryManager = class {
   setNotifier(fn) {
     this.notify = fn;
   }
+  /** Test seam: capture/override dead-letter failure notices. */
+  setFailureNotifier(fn) {
+    this.notifyFailure = fn;
+  }
   // --- Public API ---
   /**
    * Route and deliver a message to a mind. This is the main entry point.
@@ -268,7 +282,7 @@ var DeliveryManager = class {
     if (payload.session) {
       let sessionName2 = payload.session;
       if (sessionName2 === "$new") {
-        sessionName2 = `new-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+        sessionName2 = newEphemeralSession();
       }
       const sessionConfig2 = resolveDeliveryMode(config, sessionName2);
       if (sessionConfig2.delivery.mode === "batch") {
@@ -312,7 +326,7 @@ var DeliveryManager = class {
     }
     let sessionName = route.session;
     if (sessionName === "$new") {
-      sessionName = `new-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+      sessionName = newEphemeralSession();
     }
     const sessionConfig = resolveDeliveryMode(config, sessionName, route.rule);
     if (sessionConfig.delivery.mode === "batch") {
@@ -462,7 +476,7 @@ var DeliveryManager = class {
       }
       let session = route.session;
       if (session === "$new") {
-        session = `new-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+        session = newEphemeralSession();
       }
       const channel = row.channel ?? payload.channel ?? "unknown";
       const list = byChannel.get(channel) ?? [];
@@ -764,22 +778,102 @@ var DeliveryManager = class {
       dlog.warn("failed to delete delivered delivery queue rows", logger_default.errorData(err));
     }
   }
-  /** Bump attempt counters and set a backoff window so a down mind isn't hot-looped. */
-  async scheduleRetry(ids) {
+  /**
+   * Record the outcome of a failed delivery attempt: set a backoff window so the target
+   * isn't hot-looped, and — for a LIVE rejection — advance the dead-letter counter.
+   *
+   * Only a live rejection (`liveRejection: true`: the target was reachable and answered with
+   * a non-OK HTTP status) counts toward {@link MAX_DELIVERY_ATTEMPTS}. A transport failure
+   * (`liveRejection: false`: connection refused, reset, or timeout — the mind or a detached
+   * variant is simply down/unreachable) backs off WITHOUT advancing the counter, so a merely
+   * offline target is never dead-lettered and its message is preserved until it returns. The
+   * redrive guard only checks the base mind's up-ness, so a stopped variant reaches here on
+   * every sweep — this is what stops that from silently dropping its messages. #356
+   *
+   * A row that reaches the ceiling moves to the terminal `dead` status (excluded from
+   * redrive, which only reads `pending`) and the batch is surfaced as one failure notice.
+   *
+   * Rows here are still `inFlight` (the caller clears ownership in its own `finally`, after
+   * this resolves), so the concurrent redrive sweep skips them and can't race this update.
+   */
+  async scheduleRetry(ids, opts) {
     const valid = [...new Set(ids.filter((id) => typeof id === "number"))];
     if (valid.length === 0) return;
     try {
       const db = await getDb();
-      const rows = await db.select({ id: deliveryQueue.id, attempts: deliveryQueue.attempts }).from(deliveryQueue).where(inArray(deliveryQueue.id, valid));
+      const rows = await db.select({
+        id: deliveryQueue.id,
+        attempts: deliveryQueue.attempts,
+        mind: deliveryQueue.mind,
+        target_mind: deliveryQueue.target_mind,
+        thread: deliveryQueue.thread,
+        channel: deliveryQueue.channel,
+        sender: deliveryQueue.sender,
+        created_at: deliveryQueue.created_at
+      }).from(deliveryQueue).where(inArray(deliveryQueue.id, valid));
+      const dead = [];
       for (const row of rows) {
+        if (!opts.liveRejection) {
+          await db.update(deliveryQueue).set({ next_attempt_at: this.backoffExpr(row.attempts) }).where(eq2(deliveryQueue.id, row.id));
+          continue;
+        }
         const attempts = row.attempts + 1;
-        const backoffSec = Math.round(
-          Math.min(RETRY_MAX_MS, RETRY_BASE_MS * 2 ** Math.min(attempts, 20)) / 1e3
-        );
-        await db.update(deliveryQueue).set({ attempts, next_attempt_at: sql`datetime('now', ${`+${backoffSec} seconds`})` }).where(eq2(deliveryQueue.id, row.id));
+        if (attempts >= MAX_DELIVERY_ATTEMPTS) {
+          dlog.error(
+            `dead-lettering delivery queue row ${row.id} for ${row.mind} after ${attempts} live rejections (channel=${row.channel ?? "?"}, sender=${row.sender ?? "?"})`
+          );
+          const flipped = await db.update(deliveryQueue).set({ attempts, status: "dead", next_attempt_at: null }).where(and2(eq2(deliveryQueue.id, row.id), eq2(deliveryQueue.status, "pending"))).returning({ id: deliveryQueue.id });
+          if (flipped.length > 0) dead.push(row);
+          continue;
+        }
+        await db.update(deliveryQueue).set({ attempts, next_attempt_at: this.backoffExpr(attempts) }).where(eq2(deliveryQueue.id, row.id));
       }
+      if (dead.length > 0) await this.notifyDeadLettered(dead);
+    } catch (err) {
+      dlog.error("failed to record delivery retry / dead-letter", logger_default.errorData(err));
+    }
+  }
+  /** Exponential backoff window (capped at {@link RETRY_MAX_MS}) as a SQL datetime expr. */
+  backoffExpr(attempts) {
+    const backoffSec = Math.round(
+      Math.min(RETRY_MAX_MS, RETRY_BASE_MS * 2 ** Math.min(attempts, 20)) / 1e3
+    );
+    return sql`datetime('now', ${`+${backoffSec} seconds`})`;
+  }
+  /**
+   * Surface a batch of dead-lettered rows as ONE next-turn failure notice, so a whole failing
+   * batch can't emit dozens of notices and evict unrelated ones via the per-thread overflow
+   * cap. The notice names the channel(s) and send times and points the mind at the surviving
+   * channel history, and never throws back into the delivery path — the rows are terminal. #356
+   */
+  async notifyDeadLettered(rows) {
+    const mind = rows[0].mind;
+    const threads = new Set(rows.map((r) => r.thread));
+    const single = threads.size === 1 ? [...threads][0] : MIND_LEVEL_THREAD;
+    const thread = single.startsWith("new-") ? MIND_LEVEL_THREAD : single;
+    const lines = rows.map((r) => {
+      const from = r.sender ? ` from ${r.sender}` : "";
+      const on = r.channel ? ` on ${r.channel}` : "";
+      const to = r.target_mind && r.target_mind !== r.mind ? ` to your variant ${r.target_mind}` : "";
+      return `- a message${from}${on}${to} (sent ${r.created_at})`;
+    });
+    const channels = [...new Set(rows.map((r) => r.channel).filter((c) => !!c))];
+    const recovery = channels.length > 0 ? `The original message(s) remain in the channel history \u2014 read them with ${channels.map((c) => `\`volute chat read ${c}\``).join(" or ")}.` : `The original message(s) remain in the channel history.`;
+    const detail = [
+      `${rows.length} message(s) sent to you could not be delivered after ${MAX_DELIVERY_ATTEMPTS} attempts and were dropped:`,
+      ...lines,
+      recovery
+    ].join("\n");
+    try {
+      await this.notifyFailure({
+        mind,
+        thread,
+        kind: "delivery_failed",
+        reason: "delivery_failed",
+        detail
+      });
     } catch (err) {
-      dlog.warn("failed to schedule delivery retry", logger_default.errorData(err));
+      dlog.warn(`failed to send dead-letter notice for ${mind}`, logger_default.errorData(err));
     }
   }
   async deliverToMind(mindName, session, payload, sessionConfig, queueId) {
@@ -821,7 +915,7 @@ var DeliveryManager = class {
         if (!ok) {
           this.decrementActive(baseName, session);
           publishTypingForChannels(typingMap.deleteSender(baseName), typingMap);
-          await this.scheduleRetry([queueId]);
+          await this.scheduleRetry([queueId], { liveRejection: true });
         } else {
           await this.deleteQueueRows([queueId]);
         }
@@ -829,7 +923,7 @@ var DeliveryManager = class {
         dlog.warn(`failed to deliver to ${mindName}`, logger_default.errorData(err));
         this.decrementActive(baseName, session);
         publishTypingForChannels(typingMap.deleteSender(baseName), typingMap);
-        await this.scheduleRetry([queueId]);
+        await this.scheduleRetry([queueId], { liveRejection: false });
       } finally {
         if (queueId != null) this.inFlight.delete(queueId);
       }
@@ -908,7 +1002,7 @@ var DeliveryManager = class {
         if (!ok) {
           this.decrementActive(baseName, session);
           publishTypingForChannels(typingMap.deleteSender(baseName), typingMap);
-          await this.scheduleRetry(queueIds);
+          await this.scheduleRetry(queueIds, { liveRejection: true });
         } else {
           await this.deleteQueueRows(queueIds);
         }
@@ -916,7 +1010,7 @@ var DeliveryManager = class {
         dlog.warn(`failed to deliver batch to ${mindName}`, logger_default.errorData(err));
         this.decrementActive(baseName, session);
         publishTypingForChannels(typingMap.deleteSender(baseName), typingMap);
-        await this.scheduleRetry(queueIds);
+        await this.scheduleRetry(queueIds, { liveRejection: false });
       } finally {
         for (const id of queueIds) this.inFlight.delete(id);
       }
@@ -1036,7 +1130,7 @@ var DeliveryManager = class {
     const details = detailLines.length > 0 ? `${detailLines.join("\n")}
 
 ` : "\n";
-    const { getPrompt } = await import("./prompts-QKFPX6DQ.js");
+    const { getPrompt } = await import("./prompts-NBO3HRK3.js");
     const notification = await getPrompt("channel_invite", {
       channel,
       heldLine,
@@ -1215,6 +1309,7 @@ export {
   publishTypingForChannels,
   checkStaleSend,
   formatHoldNotice,
+  MAX_DELIVERY_ATTEMPTS,
   DeliveryManager,
   initDeliveryManager,
   getDeliveryManager,

package/dist/{chunk-7FDWPQCU.js → chunk-SW2U6HRB.js}

@@ -6,24 +6,24 @@ import {
   getMindToken,
   loadJsonMap,
   saveJsonMapAsync
-} from "./chunk-ALIVXDM4.js";
+} from "./chunk-724DVYHU.js";
 import {
   deliverEvent
-} from "./chunk-7OZWKHA3.js";
+} from "./chunk-AXFLY5GU.js";
 import {
   isSandboxEnabled,
   wrapForSandbox
-} from "./chunk-ZUG76D3P.js";
+} from "./chunk-5Y54AE3L.js";
 import {
   readVoluteConfig,
   writeVoluteConfig
 } from "./chunk-WCFSBH33.js";
 import {
   exec
-} from "./chunk-AJWFDIEY.js";
+} from "./chunk-M77B73VV.js";
 import {
   loadMergedEnv
-} from "./chunk-7UWXAJMK.js";
+} from "./chunk-GLM7TVWP.js";
 import {
   logger_default
 } from "./chunk-QUSMYGNQ.js";
@@ -34,7 +34,7 @@ import {
   mindTmpEnv,
   stateDir,
   voluteSystemDir
-} from "./chunk-CAIYV33P.js";
+} from "./chunk-H6X6CKDN.js";
 
 // packages/daemon/src/lib/daemon/scheduler.ts
 import { resolve } from "path";

package/dist/{chunk-574M6I7F.js → chunk-TPX6E6PL.js}

@@ -2,13 +2,13 @@
 import {
   bufferEvent,
   subscribe
-} from "./chunk-3BAFMGCJ.js";
+} from "./chunk-U54PJPTB.js";
 import {
   logger_default
 } from "./chunk-QUSMYGNQ.js";
 import {
   getDb
-} from "./chunk-CAIYV33P.js";
+} from "./chunk-H6X6CKDN.js";
 import {
   channels,
   conversationParticipants,
@@ -16,7 +16,7 @@ import {
   conversations,
   messages,
   users
-} from "./chunk-5IIVOWSP.js";
+} from "./chunk-2RNMBXD2.js";
 
 // packages/daemon/src/lib/events/conversations.ts
 import { randomUUID } from "crypto";

package/dist/{chunk-3BAFMGCJ.js → chunk-U54PJPTB.js}

@@ -4,10 +4,10 @@ import {
 } from "./chunk-QUSMYGNQ.js";
 import {
   getDb
-} from "./chunk-CAIYV33P.js";
+} from "./chunk-H6X6CKDN.js";
 import {
   activity
-} from "./chunk-5IIVOWSP.js";
+} from "./chunk-2RNMBXD2.js";
 
 // packages/daemon/src/lib/events/event-sequencer.ts
 var BUFFER_SIZE = 1e3;

package/dist/{chunk-6BM2I736.js → chunk-UDZLPR34.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-QUSMYGNQ.js";
 import {
   mindDir
-} from "./chunk-CAIYV33P.js";
+} from "./chunk-H6X6CKDN.js";
 
 // packages/daemon/src/lib/delivery/delivery-router.ts
 import { readFileSync, statSync } from "fs";

package/dist/{chunk-E5S3ILVA.js → chunk-UFTDRTCP.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   publish
-} from "./chunk-3BAFMGCJ.js";
+} from "./chunk-U54PJPTB.js";
 import {
   logger_default
 } from "./chunk-QUSMYGNQ.js";

package/dist/{chunk-YQOYZ6G7.js → chunk-VPOMJMV6.js}

@@ -8,12 +8,12 @@ import {
   modeLabel,
   pollHealth,
   startService
-} from "./chunk-5FVANDON.js";
+} from "./chunk-6NLW72HP.js";
 import {
   readGlobalConfig,
   voluteHome,
   voluteSystemDir
-} from "./chunk-CAIYV33P.js";
+} from "./chunk-H6X6CKDN.js";
 
 // src/commands/up.ts
 import { spawn } from "child_process";

package/dist/{chunk-RRZ4RQQU.js → chunk-X67BDDZR.js}

@@ -80,10 +80,8 @@ function copyTemplateToDir(composedDir, destDir, mindName, manifest) {
 }
 function renderComposedPackageJson(composedDir, mindName) {
   const dest = resolve(composedDir, "package.json");
-  if (existsSync(dest)) return dest;
-  const tmpl = resolve(composedDir, "package.json.tmpl");
-  if (!existsSync(tmpl)) return null;
-  const content = readFileSync(tmpl, "utf-8").replaceAll("{{name}}", mindName);
+  if (!existsSync(dest)) return null;
+  const content = readFileSync(dest, "utf-8").replaceAll("{{name}}", mindName);
   writeFileSync(dest, content);
   return dest;
 }
@@ -128,11 +126,11 @@ function applyTemplateHomeFiles(homeDir, template) {
   } else {
     rmSync(settingsDest, { force: true });
   }
-  const templateConfig = resolve(root, template, "home", ".config", "config.json.tmpl");
-  const configTmpl = existsSync(templateConfig) ? templateConfig : resolve(root, "_base", "home", ".config", "config.json.tmpl");
+  const templateConfig = resolve(root, template, "home", ".config", "config.json");
+  const configSrc = existsSync(templateConfig) ? templateConfig : resolve(root, "_base", "home", ".config", "config.json");
   const configDest = resolve(homeDir, ".config", "config.json");
   mkdirSync(dirname(configDest), { recursive: true });
-  writeFileSync(configDest, readFileSync(configTmpl, "utf-8"));
+  writeFileSync(configDest, readFileSync(configSrc, "utf-8"));
 }
 function listFiles(dir) {
   const results = [];

package/dist/{chunk-636GFQNE.js → chunk-XRWUQPCA.js}

@@ -2,14 +2,14 @@
 import {
   findBridgeForChannel,
   getBridgeConfig
-} from "./chunk-7XDOTN4R.js";
+} from "./chunk-L7BKTZ5U.js";
 import {
   recordOutbound
-} from "./chunk-EQKSRVDE.js";
+} from "./chunk-ZEZQNP2G.js";
 import {
   getOrCreateMindUser,
   getUserByUsername
-} from "./chunk-UC6BNMGT.js";
+} from "./chunk-7LT3YZUR.js";
 import {
   publish
 } from "./chunk-LNNI3MS4.js";
@@ -20,18 +20,18 @@ import {
   getChannelName,
   getConversation,
   getParticipants
-} from "./chunk-574M6I7F.js";
+} from "./chunk-TPX6E6PL.js";
 import {
   readVoluteConfig
 } from "./chunk-WCFSBH33.js";
 import {
   daemonConfigPath,
   readDaemonToken
-} from "./chunk-5FVANDON.js";
+} from "./chunk-6NLW72HP.js";
 import {
   readEnv,
   sharedEnvPath
-} from "./chunk-7UWXAJMK.js";
+} from "./chunk-GLM7TVWP.js";
 import {
   logger_default
 } from "./chunk-QUSMYGNQ.js";
@@ -40,7 +40,7 @@ import {
 } from "./chunk-LGNUFVMR.js";
 import {
   mindDir
-} from "./chunk-CAIYV33P.js";
+} from "./chunk-H6X6CKDN.js";
 import {
   __export
 } from "./chunk-K3NQKI34.js";
@@ -581,6 +581,7 @@ async function read4(env, channelSlug, limit) {
   }
   return data.items.slice(-limit).map((m) => {
     const text = Array.isArray(m.content) ? m.content.filter((b) => b.type === "text").map((b) => b.text).join("") : m.content;
+    if (m.role === "event") return `\xB7 ${text}`;
     return `${m.sender_name ?? m.role}: ${text}`;
   }).join("\n");
 }

package/dist/{chunk-7DXLIYPY.js → chunk-YVR6EHWL.js}

@@ -4,22 +4,22 @@ import {
 } from "./chunk-LNNI3MS4.js";
 import {
   getPrompt
-} from "./chunk-5TPC4KCV.js";
+} from "./chunk-FXWBFDQR.js";
 import {
   aiCompleteUtility
-} from "./chunk-632FJ23O.js";
+} from "./chunk-EGV6R6UF.js";
 import {
   logger_default
 } from "./chunk-QUSMYGNQ.js";
 import {
   getDb
-} from "./chunk-CAIYV33P.js";
+} from "./chunk-H6X6CKDN.js";
 import {
   messages,
   mindHistory,
   summaries,
   turns
-} from "./chunk-5IIVOWSP.js";
+} from "./chunk-2RNMBXD2.js";
 
 // packages/daemon/src/lib/daemon/turn-tracker.ts
 import { randomUUID } from "crypto";
@@ -1060,11 +1060,11 @@ var Summarizer = class {
   }
 };
 async function reconcileWedgedTurns(idleMs) {
-  const { sweepWedgedTurns: sweepWedgedTurns2, summarizeOrphanedTurns: summarizeOrphanedTurns2 } = await import("./turn-tracker-6EI2EL7G.js");
+  const { sweepWedgedTurns: sweepWedgedTurns2, summarizeOrphanedTurns: summarizeOrphanedTurns2 } = await import("./turn-tracker-C5PVIC3B.js");
   const wedged = await sweepWedgedTurns2(idleMs);
   if (wedged.length === 0) return;
   summarizeOrphanedTurns2(wedged);
-  const { tryGetDeliveryManager } = await import("./delivery-manager-B4OKWD2P.js");
+  const { tryGetDeliveryManager } = await import("./delivery-manager-VYXVKUMP.js");
   const dm = tryGetDeliveryManager();
   if (!dm) return;
   for (const t of wedged) {