npm - volute - Versions diffs - 0.46.0 → 0.47.0 - Mend

volute 0.46.0 → 0.47.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (136) hide show

package/dist/web-assets/index.html CHANGED Viewed

@@ -8,8 +8,8 @@
     <link rel="preconnect" href="https://fonts.googleapis.com" />
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
     <link href="https://fonts.googleapis.com/css2?family=Averia+Serif+Libre:wght@300;400;700&family=Fira+Code:wght@300;400;500;600&family=Averia+Sans+Libre:ital,wght@0,300;0,400;0,500;0,600;1,400&display=swap" rel="stylesheet" />
-    <script type="module" crossorigin src="/assets/index-CU6XWICM.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-B1JBQv2m.css">
+    <script type="module" crossorigin src="/assets/index-Wpyb2CML.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-DtctoDXY.css">
   </head>
   <body>
     <div id="root"></div>

package/drizzle/0011_drop_turn_summary_event_id.sql ADDED Viewed

@@ -0,0 +1,3 @@
+-- Drop the dead turns.summary_event_id column (superseded by summary_id, never written).
+ALTER TABLE `turns` DROP COLUMN `summary_event_id`;

package/drizzle/0012_channel_gates.sql ADDED Viewed

@@ -0,0 +1,17 @@
+-- Per-(mind, channel) gate state so a mind can explicitly decline an unrouted
+-- channel. Absence of a row means "pending" (undecided); the only stored state
+-- is "declined". Declined channels are never released and never re-notify.
+CREATE TABLE `channel_gates` (
+	`mind` text NOT NULL,
+	`channel` text NOT NULL,
+	`state` text NOT NULL,
+	`updated_at` text DEFAULT (datetime('now')) NOT NULL,
+	PRIMARY KEY(`mind`, `channel`)
+);
+--> statement-breakpoint
+-- Backfill: archive stale gated rows so the first routes.json edit on an existing
+-- mind with a months-old backlog can't release hundreds of messages at once. The
+-- bounded release only ever promotes the newest N per channel anyway; anything
+-- older than a week is treated as history and made inert here.
+UPDATE `delivery_queue` SET `status` = 'archived'
+	WHERE `status` = 'gated' AND `created_at` < datetime('now', '-7 days');

package/drizzle/meta/_journal.json CHANGED Viewed

@@ -78,6 +78,20 @@
       "when": 1775500000000,
       "tag": "0010_delivery_queue_redrive",
       "breakpoints": true
+    },
+    {
+      "idx": 11,
+      "version": "6",
+      "when": 1775600000000,
+      "tag": "0011_drop_turn_summary_event_id",
+      "breakpoints": true
+    },
+    {
+      "idx": 12,
+      "version": "6",
+      "when": 1775700000000,
+      "tag": "0012_channel_gates",
+      "breakpoints": true
     }
   ]
 }

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "volute",
-  "version": "0.46.0",
+  "version": "0.47.0",
   "description": "CLI for creating and managing self-modifying AI minds powered by the Claude Agent SDK",
   "type": "module",
   "license": "MIT",
@@ -79,6 +79,7 @@
     "isomorphic-dompurify": "^2.36.0",
     "libsql": "^0.5.29",
     "replicate": "^1.4.0",
+    "sharp": "^0.35.2",
     "telegraf": "^4.16.3",
     "undici": "^6.24.1",
     "zod": "^4.4.3"
@@ -94,7 +95,6 @@
     "drizzle-kit": "^0.31.10",
     "lefthook": "^2.1.9",
     "marked": "^18.0.5",
-    "sharp": "^0.35.2",
     "svelte": "^5.56.3",
     "svelte-check": "4.7.1",
     "tsup": "^8.5.1",

package/templates/_base/src/lib/startup.ts CHANGED Viewed

@@ -179,9 +179,50 @@ export function loadPrompts(): MindPrompts {
   }
 }
-export function setupShutdown(): void {
-  function shutdown() {
+/**
+ * Run the optional teardown before exit, bounded by a timeout so a wedged child
+ * (e.g. an SDK subprocess that won't exit) can't block shutdown forever. Teardown
+ * errors are logged, never thrown, so a failing hook still lets the process exit.
+ */
+export async function runShutdown(
+  onShutdown: (() => Promise<void>) | undefined,
+  timeoutMs: number,
+): Promise<void> {
+  if (!onShutdown) return;
+  let timer: ReturnType<typeof setTimeout> | undefined;
+  const timeout = new Promise<void>((resolve) => {
+    timer = setTimeout(() => {
+      log("server", `shutdown teardown timed out after ${timeoutMs}ms — exiting anyway`);
+      resolve();
+    }, timeoutMs);
+  });
+  try {
+    await Promise.race([
+      // Normalize a synchronous throw into the logged/swallowed path so it can't
+      // escape runShutdown and prevent the caller's process.exit.
+      Promise.resolve()
+        .then(() => onShutdown())
+        .catch((err) => log("server", "shutdown teardown failed:", err)),
+      timeout,
+    ]);
+  } finally {
+    if (timer) clearTimeout(timer);
+  }
+}
+/**
+ * Wire SIGINT/SIGTERM to a graceful shutdown. Without `onShutdown` this exits
+ * immediately (as before); pass a teardown to reap live SDK subprocesses before
+ * exit so they aren't orphaned to PID 1 as `<defunct>` zombies. The handler is
+ * idempotent so a second signal during teardown doesn't double-run it.
+ */
+export function setupShutdown(onShutdown?: () => Promise<void>, timeoutMs = 10_000): void {
+  let shuttingDown = false;
+  async function shutdown() {
+    if (shuttingDown) return;
+    shuttingDown = true;
     log("server", "shutdown signal received");
+    await runShutdown(onShutdown, timeoutMs);
     process.exit(0);
   }
   process.on("SIGINT", shutdown);

package/templates/claude/src/agent.ts CHANGED Viewed

@@ -22,7 +22,11 @@ import { createPreCompactHook } from "./lib/hooks/pre-compact.js";
 import { createReplyInstructionsHook } from "./lib/hooks/reply-instructions.js";
 import { log } from "./lib/logger.js";
 import { createMessageChannel } from "./lib/message-channel.js";
-import { isSessionReapable, reapSessionQuery } from "./lib/session-reaper.js";
+import {
+  isSessionReapable,
+  reapSessionQuery,
+  reapSessionsForShutdown,
+} from "./lib/session-reaper.js";
 import { createSessionStore } from "./lib/session-store.js";
 import { loadPrompts, type SubagentConfig } from "./lib/startup.js";
 import { consumeStream } from "./lib/stream-consumer.js";
@@ -69,6 +73,7 @@ export function createMind(options: {
   waitForCommits: () => Promise<void>;
   getContextInfo: () => Promise<ContextInfo>;
   getContextMessages: () => Promise<ContextMessages>;
+  reapAllSessions: () => Promise<void>;
 } {
   const autoCommit = createAutoCommitHook(options.cwd);
   const identityReload = createIdentityReloadHook(options.cwd);
@@ -569,6 +574,21 @@ export function createMind(options: {
     }
   }
+  /**
+   * Reap every live session's SDK subprocess on shutdown so `mind stop`/restart
+   * don't orphan `<defunct>` claude children to PID 1. Delegates the teardown to
+   * reapSessionsForShutdown; bounded externally by setupShutdown's timeout.
+   */
+  async function reapAllSessions(): Promise<void> {
+    const live = [...sessions.values()];
+    if (live.length === 0) return;
+    log("mind", `shutdown: reaping ${live.length} live SDK subprocess(es)`);
+    for (const s of live) sessions.delete(s.name);
+    await reapSessionsForShutdown(live, (name, err) =>
+      log("mind", `session "${name}": shutdown reap failed:`, err),
+    );
+  }
   if (idleTimeoutMs > 0) {
     log("mind", `idle session reaper: ${idleTimeoutMs / 60_000} min timeout`);
     const checkMs = Math.min(60_000, idleTimeoutMs);
@@ -746,5 +766,11 @@ export function createMind(options: {
   // instead of waiting for the first message (which adds minutes of latency).
   getOrCreateSession("main");
-  return { resolve, waitForCommits: autoCommit.waitForCommits, getContextInfo, getContextMessages };
+  return {
+    resolve,
+    waitForCommits: autoCommit.waitForCommits,
+    getContextInfo,
+    getContextMessages,
+    reapAllSessions,
+  };
 }

package/templates/claude/src/lib/session-reaper.ts CHANGED Viewed

@@ -66,3 +66,35 @@ export async function reapSessionQuery(
     onError(err);
   }
 }
+/** Minimal view of a live session needed to tear it down on shutdown. */
+export interface ShutdownReapable {
+  name: string;
+  /** Input iterable — closing it unwinds the stream consumer. */
+  channel: { close(): void };
+  /** The session's live SDK query, if it has one. */
+  currentQuery?: ReapableQuery;
+}
+/**
+ * Reap every live session's SDK subprocess on shutdown (SIGTERM/SIGINT).
+ *
+ * Unlike the idle reaper this ignores idle/reapable state — on the way out we
+ * want *all* children gone. For each session it closes the input channel so the
+ * stream consumer unwinds, then awaits `query.return()` so the CLI subprocess
+ * exits and its status is reaped, rather than being orphaned to PID 1 (the
+ * daemon, which doesn't reap reparented children) as a `<defunct>` zombie.
+ * Reaps run in parallel; a per-session failure is reported via `onError` and
+ * never rejects the batch, so one wedged child can't block the others.
+ */
+export async function reapSessionsForShutdown(
+  sessions: Iterable<ShutdownReapable>,
+  onError: (name: string, err: unknown) => void,
+): Promise<void> {
+  await Promise.all(
+    [...sessions].map(async (s) => {
+      s.channel.close();
+      await reapSessionQuery(s.currentQuery, (err) => onError(s.name, err));
+    }),
+  );
+}

package/templates/claude/src/server.ts CHANGED Viewed

@@ -63,4 +63,13 @@ server.listen(port, () => {
   log("server", `listening on :${actualPort}`);
 });
-setupShutdown();
+// Reap live SDK subprocesses on SIGTERM/SIGINT so `mind stop`/restart don't
+// orphan `<defunct>` claude children to PID 1 (the daemon, which isn't a
+// reaping init). Bounded so a wedged child can't block shutdown forever.
+// Stop accepting new messages first so a late request can't spawn a fresh
+// subprocess after reapAllSessions has snapshotted the live set (which would
+// re-orphan the very child we're reaping).
+setupShutdown(async () => {
+  server.close();
+  await mind.reapAllSessions();
+});

package/dist/avatar-image-6KY6UU4D.js DELETED Viewed

@@ -1,16 +0,0 @@
-#!/usr/bin/env node
-import {
-  AVATAR_DIM,
-  migrateAvatarSizes,
-  normalizeAvatar
-} from "./chunk-DRJ24GXK.js";
-import "./chunk-PFZBNKUH.js";
-import "./chunk-T2TP6ZC6.js";
-import "./chunk-ALKYQULU.js";
-import "./chunk-ZV7MFISX.js";
-import "./chunk-K3NQKI34.js";
-export {
-  AVATAR_DIM,
-  migrateAvatarSizes,
-  normalizeAvatar
-};

package/dist/delivery-manager-JINZRG2W.js DELETED Viewed

@@ -1,33 +0,0 @@
-#!/usr/bin/env node
-import {
-  DeliveryManager,
-  getDeliveryManager,
-  initDeliveryManager,
-  tryGetDeliveryManager
-} from "./chunk-JO5IO4FH.js";
-import "./chunk-ZDZISKCL.js";
-import "./chunk-BJZ4PV7R.js";
-import "./chunk-QLWG3C2Z.js";
-import "./chunk-KGIXX4NM.js";
-import "./chunk-5ZQZDDIK.js";
-import "./chunk-PFZBNKUH.js";
-import "./chunk-JZ62SYWR.js";
-import "./chunk-KQSFTPIM.js";
-import "./chunk-4JOQZPCE.js";
-import "./chunk-YXSUMLTC.js";
-import "./chunk-4YU7HF4L.js";
-import "./chunk-H2X54EHC.js";
-import "./chunk-IHKGWTGT.js";
-import "./chunk-F7H6ATM4.js";
-import "./chunk-OV7ZQ2GH.js";
-import "./chunk-ZNMCCHCP.js";
-import "./chunk-T2TP6ZC6.js";
-import "./chunk-ALKYQULU.js";
-import "./chunk-ZV7MFISX.js";
-import "./chunk-K3NQKI34.js";
-export {
-  DeliveryManager,
-  getDeliveryManager,
-  initDeliveryManager,
-  tryGetDeliveryManager
-};

package/dist/echo-text-VQPB5L2X.js DELETED Viewed

@@ -1,33 +0,0 @@
-#!/usr/bin/env node
-import {
-  clearEchoTextCache,
-  echoTextToChannel
-} from "./chunk-E3DA4HYV.js";
-import "./chunk-RXEEYDIB.js";
-import "./chunk-JO5IO4FH.js";
-import "./chunk-ZDZISKCL.js";
-import "./chunk-BJZ4PV7R.js";
-import "./chunk-QLWG3C2Z.js";
-import "./chunk-KGIXX4NM.js";
-import "./chunk-5ZQZDDIK.js";
-import "./chunk-PFZBNKUH.js";
-import "./chunk-JZ62SYWR.js";
-import "./chunk-KQSFTPIM.js";
-import "./chunk-4JOQZPCE.js";
-import "./chunk-YXSUMLTC.js";
-import "./chunk-4YU7HF4L.js";
-import "./chunk-TQJ6ZYVY.js";
-import "./chunk-H2X54EHC.js";
-import "./chunk-IHKGWTGT.js";
-import "./chunk-F7H6ATM4.js";
-import "./chunk-OV7ZQ2GH.js";
-import "./chunk-ZNMCCHCP.js";
-import "./chunk-T2TP6ZC6.js";
-import "./chunk-LGNUFVMR.js";
-import "./chunk-ALKYQULU.js";
-import "./chunk-ZV7MFISX.js";
-import "./chunk-K3NQKI34.js";
-export {
-  clearEchoTextCache,
-  echoTextToChannel
-};

package/dist/message-delivery-R7JSQGYX.js DELETED Viewed

@@ -1,37 +0,0 @@
-#!/usr/bin/env node
-import {
-  deliverBatch,
-  deliverMessage,
-  linkToolResultToTurn,
-  recordInbound,
-  recordOutbound,
-  resolveSleepAction
-} from "./chunk-JO5IO4FH.js";
-import "./chunk-ZDZISKCL.js";
-import "./chunk-BJZ4PV7R.js";
-import "./chunk-QLWG3C2Z.js";
-import "./chunk-KGIXX4NM.js";
-import "./chunk-5ZQZDDIK.js";
-import "./chunk-PFZBNKUH.js";
-import "./chunk-JZ62SYWR.js";
-import "./chunk-KQSFTPIM.js";
-import "./chunk-4JOQZPCE.js";
-import "./chunk-YXSUMLTC.js";
-import "./chunk-4YU7HF4L.js";
-import "./chunk-H2X54EHC.js";
-import "./chunk-IHKGWTGT.js";
-import "./chunk-F7H6ATM4.js";
-import "./chunk-OV7ZQ2GH.js";
-import "./chunk-ZNMCCHCP.js";
-import "./chunk-T2TP6ZC6.js";
-import "./chunk-ALKYQULU.js";
-import "./chunk-ZV7MFISX.js";
-import "./chunk-K3NQKI34.js";
-export {
-  deliverBatch,
-  deliverMessage,
-  linkToolResultToTurn,
-  recordInbound,
-  recordOutbound,
-  resolveSleepAction
-};

package/dist/mind-service-NB2JMWQZ.js DELETED Viewed

@@ -1,39 +0,0 @@
-#!/usr/bin/env node
-import {
-  buildSeedOrientation,
-  sleepMind,
-  startMindFull,
-  startSpiritFull,
-  stopMindFull,
-  stopSpiritFull,
-  wakeMind
-} from "./chunk-JO5IO4FH.js";
-import "./chunk-ZDZISKCL.js";
-import "./chunk-BJZ4PV7R.js";
-import "./chunk-QLWG3C2Z.js";
-import "./chunk-KGIXX4NM.js";
-import "./chunk-5ZQZDDIK.js";
-import "./chunk-PFZBNKUH.js";
-import "./chunk-JZ62SYWR.js";
-import "./chunk-KQSFTPIM.js";
-import "./chunk-4JOQZPCE.js";
-import "./chunk-YXSUMLTC.js";
-import "./chunk-4YU7HF4L.js";
-import "./chunk-H2X54EHC.js";
-import "./chunk-IHKGWTGT.js";
-import "./chunk-F7H6ATM4.js";
-import "./chunk-OV7ZQ2GH.js";
-import "./chunk-ZNMCCHCP.js";
-import "./chunk-T2TP6ZC6.js";
-import "./chunk-ALKYQULU.js";
-import "./chunk-ZV7MFISX.js";
-import "./chunk-K3NQKI34.js";
-export {
-  buildSeedOrientation,
-  sleepMind,
-  startMindFull,
-  startSpiritFull,
-  stopMindFull,
-  stopSpiritFull,
-  wakeMind
-};

package/dist/scheduler-WVKII3LA.js DELETED Viewed

@@ -1,31 +0,0 @@
-#!/usr/bin/env node
-import {
-  Scheduler,
-  getScheduler,
-  initScheduler
-} from "./chunk-JO5IO4FH.js";
-import "./chunk-ZDZISKCL.js";
-import "./chunk-BJZ4PV7R.js";
-import "./chunk-QLWG3C2Z.js";
-import "./chunk-KGIXX4NM.js";
-import "./chunk-5ZQZDDIK.js";
-import "./chunk-PFZBNKUH.js";
-import "./chunk-JZ62SYWR.js";
-import "./chunk-KQSFTPIM.js";
-import "./chunk-4JOQZPCE.js";
-import "./chunk-YXSUMLTC.js";
-import "./chunk-4YU7HF4L.js";
-import "./chunk-H2X54EHC.js";
-import "./chunk-IHKGWTGT.js";
-import "./chunk-F7H6ATM4.js";
-import "./chunk-OV7ZQ2GH.js";
-import "./chunk-ZNMCCHCP.js";
-import "./chunk-T2TP6ZC6.js";
-import "./chunk-ALKYQULU.js";
-import "./chunk-ZV7MFISX.js";
-import "./chunk-K3NQKI34.js";
-export {
-  Scheduler,
-  getScheduler,
-  initScheduler
-};

package/dist/sleep-manager-G6TXSDP7.js DELETED Viewed

@@ -1,35 +0,0 @@
-#!/usr/bin/env node
-import {
-  SleepManager,
-  getSleepManager,
-  getSleepManagerIfReady,
-  initSleepManager,
-  matchesGlob
-} from "./chunk-JO5IO4FH.js";
-import "./chunk-ZDZISKCL.js";
-import "./chunk-BJZ4PV7R.js";
-import "./chunk-QLWG3C2Z.js";
-import "./chunk-KGIXX4NM.js";
-import "./chunk-5ZQZDDIK.js";
-import "./chunk-PFZBNKUH.js";
-import "./chunk-JZ62SYWR.js";
-import "./chunk-KQSFTPIM.js";
-import "./chunk-4JOQZPCE.js";
-import "./chunk-YXSUMLTC.js";
-import "./chunk-4YU7HF4L.js";
-import "./chunk-H2X54EHC.js";
-import "./chunk-IHKGWTGT.js";
-import "./chunk-F7H6ATM4.js";
-import "./chunk-OV7ZQ2GH.js";
-import "./chunk-ZNMCCHCP.js";
-import "./chunk-T2TP6ZC6.js";
-import "./chunk-ALKYQULU.js";
-import "./chunk-ZV7MFISX.js";
-import "./chunk-K3NQKI34.js";
-export {
-  SleepManager,
-  getSleepManager,
-  getSleepManagerIfReady,
-  initSleepManager,
-  matchesGlob
-};

package/dist/system-chat-NDAW6YP7.js DELETED Viewed

@@ -1,37 +0,0 @@
-#!/usr/bin/env node
-import {
-  ensureSystemDM,
-  generateSystemFallbackReply,
-  resetSystemDMCache,
-  sendSystemMessage,
-  sendSystemMessageDirect,
-  shouldGenerateSystemFallback
-} from "./chunk-JO5IO4FH.js";
-import "./chunk-ZDZISKCL.js";
-import "./chunk-BJZ4PV7R.js";
-import "./chunk-QLWG3C2Z.js";
-import "./chunk-KGIXX4NM.js";
-import "./chunk-5ZQZDDIK.js";
-import "./chunk-PFZBNKUH.js";
-import "./chunk-JZ62SYWR.js";
-import "./chunk-KQSFTPIM.js";
-import "./chunk-4JOQZPCE.js";
-import "./chunk-YXSUMLTC.js";
-import "./chunk-4YU7HF4L.js";
-import "./chunk-H2X54EHC.js";
-import "./chunk-IHKGWTGT.js";
-import "./chunk-F7H6ATM4.js";
-import "./chunk-OV7ZQ2GH.js";
-import "./chunk-ZNMCCHCP.js";
-import "./chunk-T2TP6ZC6.js";
-import "./chunk-ALKYQULU.js";
-import "./chunk-ZV7MFISX.js";
-import "./chunk-K3NQKI34.js";
-export {
-  ensureSystemDM,
-  generateSystemFallbackReply,
-  resetSystemDMCache,
-  sendSystemMessage,
-  sendSystemMessageDirect,
-  shouldGenerateSystemFallback
-};