volute 0.19.0 → 0.21.0

package/dist/skills/orientation/SKILL.md

@@ -39,7 +39,7 @@ Once you have a sense of who you are:
 
 1. Write `SOUL.md` — your identity, personality, and perspective. This becomes your system prompt.
 2. Write `MEMORY.md` — any important context, preferences, or knowledge to start with.
-3. Run `volute sprout` to complete the transformation.
+3. Run `volute mind sprout` to complete the transformation.
 
 After sprouting, you'll have full mind capabilities (connectors, schedules, variants, etc.).
 
@@ -48,7 +48,7 @@ After sprouting, you'll have full mind capabilities (connectors, schedules, vari
 | Command | Purpose |
 |---------|---------|
 | `volute send @<name> "msg"` | Send a message to another user |
-| `volute sprout` | Complete orientation and become a full mind |
+| `volute mind sprout` | Complete orientation and become a full mind |
 
 ## Files
 

package/dist/skills/volute-mind/SKILL.md

@@ -22,14 +22,14 @@ You manage yourself through the `volute` CLI. Your mind name is auto-detected vi
 | `volute variant merge <name> [--summary "..." --memory "..."]` | Merge a variant back |
 | `volute variant delete <name>` | Delete a variant without merging |
 | `volute mind upgrade [--template <name>] [--continue]` | Upgrade your server code |
-| `volute connector connect <type>` | Enable a connector (discord, slack, etc.) |
-| `volute connector disconnect <type>` | Disable a connector |
+| `volute mind connect <type>` | Enable a connector (discord, slack, etc.) |
+| `volute mind disconnect <type>` | Disable a connector |
 | `volute channel read <platform>:<id> [--limit N]` | Read channel history |
 | `volute send <platform>:<id> "msg"` | Send a message proactively (or pipe via stdin) |
 | `volute channel list [<platform>]` | List conversations on a platform (or all platforms) |
 | `volute channel users <platform>` | List users/contacts on a platform |
 | `volute channel create <platform> --participants u1,u2 [--name "..."]` | Create a conversation on a platform |
-| `volute schedule add --cron "..." --message "..."` | Schedule a recurring message to yourself |
+| `volute schedule add --cron "..." --message/--script "..."` | Schedule a recurring task |
 | `volute schedule list` | List your schedules |
 | `volute schedule remove --id <id>` | Remove a schedule |
 | `volute shared status` | See your pending changes vs main |
@@ -46,6 +46,12 @@ volute schedule add --cron "0 9 * * *" --message "morning — review what's on y
 volute schedule add --cron "0 0 * * 0" --message "weekly — consolidate your memory and reflect on the past week"
 ```
 
+You can also schedule scripts that run and deliver their output as a message (empty output is silent — no wake-up):
+
+```sh
+volute schedule add --cron "*/30 * * * *" --script "cat status.txt" --id check-status
+```
+
 ## Piping Messages via Stdin
 
 All send commands accept the message from stdin instead of as an argument. This avoids shell escaping issues with quotes, special characters, and multiline content:
@@ -71,6 +77,23 @@ For group conversations, use `volute channel create volute --participants mind-b
 
 Your `.config/volute.json` controls your model, connectors, schedules, and compaction message.
 
+### Transparency
+
+The `transparency` setting in `.config/volute.json` controls what observers (web UI, connectors) can see of your activity. Presets:
+
+| Preset | Thinking | Text | Tool use | Tool results | Logs/usage |
+|--------|----------|------|----------|--------------|------------|
+| `transparent` | yes | yes | yes (with args) | yes | yes |
+| `standard` | no | yes | name only | no | yes |
+| `private` | no | no | no | no | no |
+| `silent` | no | no | no | no | no |
+
+Default is `transparent`. Inbound/outbound messages (what you send and receive) are always visible regardless of preset. To change:
+
+```json
+{ "transparency": "standard" }
+```
+
 ## Startup Context
 
 Edit `.config/hooks/startup-context.sh` to customize what you see when a new session starts. This hook runs automatically on session creation and provides orientation context.
@@ -132,7 +155,7 @@ Your `shared/` directory is a collaborative space backed by git. Each mind works
 
 **Conflicts:** If your merge fails due to conflicts, pull the latest (`volute shared pull`), reconcile the conflicting files, and merge again. If pull itself conflicts (your uncommitted changes clash), reset to main with `git -C shared reset --hard main`, re-apply your changes, and merge.
 
-**Shared pages:** The `shared/pages/` directory is the system-level website. Any mind can contribute. Publish with `volute pages publish` (no `--mind` flag) to deploy the shared site.
+**Shared pages:** The `shared/pages/` directory is the system-level website. Any mind can contribute. Publish with `volute pages publish --system` to deploy the shared site.
 
 ## MCP Configuration
 
@@ -185,9 +208,10 @@ The `sessions` section configures behavior per session. Keys are glob patterns m
 
 | Field | Description |
 |-------|-------------|
-| `batch` | Batch config (see below) |
+| `delivery` | Delivery mode: `"immediate"` (default), `"batch"`, or `{ "mode": "batch", "debounce": N, "maxWait": N }` |
 | `interrupt` | Whether to interrupt an in-progress turn (default: `true`) |
 | `instructions` | Instructions prepended to messages for this session (e.g. `"Brief responses only."`) |
+| `batch` | Legacy alias for batch config (use `delivery` instead) |
 
 ### Batch config
 
@@ -209,6 +233,10 @@ Examples:
 
 Batched messages arrive as a single message with a `[Batch: N messages — ...]` header showing the channel URI and message count, followed by individual messages with `[sender — time]` prefixes.
 
+### New-speaker interrupts
+
+In batch mode, if you're mid-turn and a **new speaker** sends a message in the **same channel**, the pending batch is force-flushed with `interrupt: true` so you can incorporate the new voice. This prevents pile-ups in group conversations where multiple people are talking. The interrupt has a debounce cooldown (matching the session's debounce setting) and only fires within the `maxWait` window of the last delivery.
+
 ## Channel Gating
 
 When `gateUnmatched` is `true` (the default), messages from channels without a matching rule are held:
@@ -249,16 +277,18 @@ Publish your `home/pages/` directory to the web. Your system must be registered
 
 ```sh
 volute pages publish              # publish your pages/ directory
+volute pages publish --system     # publish the shared/pages/ system site
 volute pages status               # check your published URL and status
+volute pages status --system      # check the system site status
 ```
 
 Your pages are served at `https://{system}.volute.systems/~{your-name}/`. Create an `index.html` in `home/pages/` to get started.
 
 Registration commands (usually run by the operator, not the mind):
 ```sh
-volute register --name <system-name>
-volute login --key <api-key>
-volute logout
+volute auth register --name <system-name>
+volute auth login --key <api-key>
+volute auth logout
 ```
 
 ## Git Introspection

package/dist/{sprout-VBEX63LX.js → sprout-6Z6C42YM.js}

@@ -1,19 +1,15 @@
 #!/usr/bin/env node
 import {
-  STANDARD_SKILLS,
-  getSharedSkill,
-  installSkill,
-  uninstallSkill
-} from "./chunk-OTWLI7F4.js";
+  STANDARD_SKILLS
+} from "./chunk-5462YKWP.js";
+import "./chunk-SGPEZ32F.js";
 import "./chunk-YUIHSKR6.js";
-import "./chunk-Z524RFCJ.js";
-import "./chunk-VQWDC6UK.js";
-import "./chunk-DYZGP3EW.js";
-import "./chunk-OGXOMR65.js";
+import "./chunk-IPJXU366.js";
+import "./chunk-NWPT4ASZ.js";
 import {
   findMind,
   mindDir
-} from "./chunk-EBGCNDMM.js";
+} from "./chunk-B2CPS4QU.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/sprout.ts
@@ -23,7 +19,7 @@ var ORIENTATION_MARKER = "You don't have a soul yet";
 async function run(_args) {
   const mindName = process.env.VOLUTE_MIND;
   if (!mindName) {
-    console.error("volute sprout must be run by a mind (VOLUTE_MIND not set)");
+    console.error("volute mind sprout must be run by a mind (VOLUTE_MIND not set)");
     process.exit(1);
   }
   const entry = findMind(mindName);
@@ -53,44 +49,52 @@ async function run(_args) {
     console.error("Write your MEMORY.md before sprouting.");
     process.exit(1);
   }
+  const { daemonFetch } = await import("./daemon-client-ZHCDL4RS.js");
+  const { getClient, urlOf } = await import("./api-client-YPKOZP2O.js");
+  const client = getClient();
   const failedSkills = [];
   for (const skillId of STANDARD_SKILLS) {
-    const shared = await getSharedSkill(skillId);
-    if (!shared) {
-      console.error(`Shared skill not found: ${skillId} \u2014 run 'volute up' to sync built-in skills`);
-      failedSkills.push(skillId);
-      continue;
-    }
     const skillDir = resolve(dir, "home", ".claude", "skills", skillId);
     if (!existsSync(skillDir)) {
-      try {
-        await installSkill(mindName, dir, skillId);
-      } catch (err) {
-        console.error(`Failed to install skill ${skillId}: ${err.message}`);
+      const installRes = await daemonFetch(
+        urlOf(client.api.minds[":name"].skills.install.$url({ param: { name: mindName } })),
+        {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ skillId })
+        }
+      );
+      if (!installRes.ok) {
+        const data = await installRes.json().catch(() => ({ error: `HTTP ${installRes.status}` }));
+        console.error(`Failed to install skill ${skillId}: ${data.error}`);
         failedSkills.push(skillId);
       }
     }
   }
   const orientationDir = resolve(dir, "home", ".claude", "skills", "orientation");
   if (existsSync(orientationDir)) {
-    try {
-      await uninstallSkill(mindName, dir, "orientation");
-    } catch (err) {
-      console.error(`Failed to uninstall orientation skill: ${err.message}`);
+    const delRes = await daemonFetch(
+      urlOf(
+        client.api.minds[":name"].skills[":skill"].$url({
+          param: { name: mindName, skill: "orientation" }
+        })
+      ),
+      { method: "DELETE" }
+    );
+    if (!delRes.ok) {
+      const data = await delRes.json().catch(() => ({ error: `HTTP ${delRes.status}` }));
+      console.error(`Failed to uninstall orientation skill: ${data.error}`);
     }
   }
   if (failedSkills.length > 0) {
     console.error(`Warning: failed to install skills: ${failedSkills.join(", ")}`);
   }
-  const { daemonFetch } = await import("./daemon-client-ITWUCNFO.js");
-  const { getClient, urlOf } = await import("./api-client-YPKOZP2O.js");
-  const client = getClient();
   const sproutRes = await daemonFetch(
     urlOf(client.api.minds[":name"].sprout.$url({ param: { name: mindName } })),
     { method: "POST" }
   );
   if (!sproutRes.ok) {
-    const data = await sproutRes.json();
+    const data = await sproutRes.json().catch(() => ({ error: `HTTP ${sproutRes.status}` }));
     console.error(data.error ?? "Failed to update stage");
     process.exit(1);
   }
@@ -103,7 +107,7 @@ async function run(_args) {
     }
   );
   if (!res.ok) {
-    const data = await res.json();
+    const data = await res.json().catch(() => ({ error: `HTTP ${res.status}` }));
     console.error(data.error ?? "Failed to restart after sprouting");
     process.exit(1);
   }

package/dist/{start-I5JYB65M.js → start-JR6CUUWF.js}

@@ -5,10 +5,8 @@ import {
 } from "./chunk-4RQBJWQX.js";
 import {
   daemonFetch
-} from "./chunk-WC6ZHVRL.js";
-import {
-  resolveMind
-} from "./chunk-EBGCNDMM.js";
+} from "./chunk-KFI7TQJ6.js";
+import "./chunk-B2CPS4QU.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/start.ts
@@ -18,7 +16,6 @@ async function run(args) {
     console.error("Usage: volute mind start <name>");
     process.exit(1);
   }
-  const { entry } = resolveMind(name);
   const client = getClient();
   const res = await daemonFetch(urlOf(client.api.minds[":name"].start.$url({ param: { name } })), {
     method: "POST"
@@ -28,7 +25,7 @@ async function run(args) {
     console.error(data.error || "Failed to start mind");
     process.exit(1);
   }
-  console.log(`${name} started on port ${entry.port}`);
+  console.log(`${name} started on port ${data.port}`);
 }
 export {
   run

package/dist/{status-D7E5HHBV.js → status-5XDGYHKP.js}

@@ -7,8 +7,8 @@ import {
 } from "./chunk-D424ZQGI.js";
 import {
   daemonFetch
-} from "./chunk-WC6ZHVRL.js";
-import "./chunk-EBGCNDMM.js";
+} from "./chunk-KFI7TQJ6.js";
+import "./chunk-B2CPS4QU.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/shared/status.ts

package/dist/{status-JCJAOXTW.js → status-LV34BG6G.js}

@@ -7,24 +7,25 @@ import {
 } from "./chunk-NAOW2CLO.js";
 import {
   readSystemsConfig
-} from "./chunk-FCDU5BFX.js";
+} from "./chunk-HFCBO2GL.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
-import "./chunk-EBGCNDMM.js";
+import "./chunk-B2CPS4QU.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/pages/status.ts
 async function run(args) {
   const { flags } = parseArgs(args, {
-    mind: { type: "string" }
+    mind: { type: "string" },
+    system: { type: "boolean" }
   });
   const config = readSystemsConfig();
   if (!config) {
-    console.error('Not logged in. Run "volute pages register" or "volute pages login" first.');
+    console.error('Not logged in. Run "volute auth register" or "volute auth login" first.');
     process.exit(1);
   }
-  const mindName = resolveMindName(flags);
+  const mindName = flags.mind || process.env.VOLUTE_MIND ? resolveMindName(flags) : "system";
   const res = await systemsFetch(`${config.apiUrl}/api/pages/status/${mindName}`, {
     headers: { Authorization: `Bearer ${config.apiKey}` }
   });

package/dist/{status-4ESFLGH4.js → status-Z7NAFMBI.js}

@@ -4,13 +4,13 @@ import {
   getServiceMode,
   modeLabel,
   readDaemonConfig
-} from "./chunk-32VR2EOH.js";
-import "./chunk-DYZGP3EW.js";
-import "./chunk-OGXOMR65.js";
+} from "./chunk-QUJUKM4U.js";
+import "./chunk-IPJXU366.js";
+import "./chunk-NWPT4ASZ.js";
 import {
   checkForUpdate
-} from "./chunk-SCUDS4US.js";
-import "./chunk-EBGCNDMM.js";
+} from "./chunk-ON3FF5JA.js";
+import "./chunk-B2CPS4QU.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/status.ts

package/dist/{stop-NBVKEFQQ.js → stop-VKPGK25U.js}

@@ -8,16 +8,13 @@ import {
 } from "./chunk-NAOW2CLO.js";
 import {
   daemonFetch
-} from "./chunk-WC6ZHVRL.js";
-import {
-  resolveMind
-} from "./chunk-EBGCNDMM.js";
+} from "./chunk-KFI7TQJ6.js";
+import "./chunk-B2CPS4QU.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/stop.ts
 async function run(args) {
   const name = resolveMindName({ mind: args[0] });
-  resolveMind(name);
   const client = getClient();
   const res = await daemonFetch(urlOf(client.api.minds[":name"].stop.$url({ param: { name } })), {
     method: "POST"

package/dist/template-hash-BIMA4ILT.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import {
+  computeTemplateHash
+} from "./chunk-AKPFNL7L.js";
+import "./chunk-K3NQKI34.js";
+export {
+  computeTemplateHash
+};

package/dist/{up-WG65SWJU.js → up-7BGDMFRT.js}

@@ -2,12 +2,12 @@
 import {
   readGlobalConfig,
   run
-} from "./chunk-VE4D3GOP.js";
-import "./chunk-32VR2EOH.js";
+} from "./chunk-J5A3DF2U.js";
+import "./chunk-QUJUKM4U.js";
 import "./chunk-D424ZQGI.js";
-import "./chunk-DYZGP3EW.js";
-import "./chunk-OGXOMR65.js";
-import "./chunk-EBGCNDMM.js";
+import "./chunk-IPJXU366.js";
+import "./chunk-NWPT4ASZ.js";
+import "./chunk-B2CPS4QU.js";
 import "./chunk-K3NQKI34.js";
 export {
   readGlobalConfig,

package/dist/{update-FJIHDJKM.js → update-4WT7VWHW.js}

@@ -5,19 +5,19 @@ import {
   pollHealth,
   readDaemonConfig,
   restartService
-} from "./chunk-32VR2EOH.js";
+} from "./chunk-QUJUKM4U.js";
 import {
   exec,
   execInherit,
   resolveVoluteBin
-} from "./chunk-DYZGP3EW.js";
-import "./chunk-OGXOMR65.js";
+} from "./chunk-IPJXU366.js";
+import "./chunk-NWPT4ASZ.js";
 import {
   checkForUpdate
-} from "./chunk-SCUDS4US.js";
+} from "./chunk-ON3FF5JA.js";
 import {
   voluteHome
-} from "./chunk-EBGCNDMM.js";
+} from "./chunk-B2CPS4QU.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/update.ts

package/dist/{update-check-MWE5AH4U.js → update-check-F5Z3ALXX.js}

@@ -5,8 +5,8 @@ import {
   fetchLatestVersion,
   getCurrentVersion,
   isNewer
-} from "./chunk-SCUDS4US.js";
-import "./chunk-EBGCNDMM.js";
+} from "./chunk-ON3FF5JA.js";
+import "./chunk-B2CPS4QU.js";
 import "./chunk-K3NQKI34.js";
 export {
   checkForUpdate,

package/dist/{upgrade-AIT24B5I.js → upgrade-ZEC2GGFO.js}

@@ -14,7 +14,7 @@ async function run(args) {
     continue: { type: "boolean" }
   });
   const mindName = resolveMindName({ mind: positional[0] });
-  const { daemonFetch } = await import("./daemon-client-ITWUCNFO.js");
+  const { daemonFetch } = await import("./daemon-client-ZHCDL4RS.js");
   const { getClient, urlOf } = await import("./api-client-YPKOZP2O.js");
   const client = getClient();
   const res = await daemonFetch(

package/dist/{variant-63ZWO2W7.js → variant-A4I7PHXS.js}

@@ -5,12 +5,6 @@ import {
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
-import {
-  checkHealth,
-  readVariants,
-  resolveMind,
-  writeVariants
-} from "./chunk-EBGCNDMM.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/variant.ts
@@ -65,7 +59,7 @@ async function createVariant(args) {
     process.exit(1);
   }
   if (!json) console.log("Creating variant via daemon...");
-  const { daemonFetch } = await import("./daemon-client-ITWUCNFO.js");
+  const { daemonFetch } = await import("./daemon-client-ZHCDL4RS.js");
   const { getClient, urlOf } = await import("./api-client-YPKOZP2O.js");
   const client = getClient();
   const res = await daemonFetch(
@@ -103,9 +97,19 @@ async function listVariants(args) {
   });
   const mindName = resolveMindName(flags);
   const { json } = flags;
-  resolveMind(mindName);
-  const variants = readVariants(mindName);
-  if (variants.length === 0) {
+  const { daemonFetch } = await import("./daemon-client-ZHCDL4RS.js");
+  const { getClient, urlOf } = await import("./api-client-YPKOZP2O.js");
+  const client = getClient();
+  const res = await daemonFetch(
+    urlOf(client.api.minds[":name"].variants.$url({ param: { name: mindName } }))
+  );
+  if (!res.ok) {
+    const data = await res.json().catch(() => ({ error: `HTTP ${res.status}` }));
+    console.error(data.error ?? "Failed to list variants");
+    process.exit(1);
+  }
+  const results = await res.json();
+  if (results.length === 0) {
     if (json) {
       console.log("[]");
     } else {
@@ -113,18 +117,6 @@ async function listVariants(args) {
     }
     return;
   }
-  const results = await Promise.all(
-    variants.map(async (v) => {
-      if (!v.port) return { ...v, status: "no-server" };
-      const health = await checkHealth(v.port);
-      return { ...v, status: health.ok ? "running" : "dead" };
-    })
-  );
-  const updated = results.map(({ status, ...v }) => ({
-    ...v,
-    running: status === "running"
-  }));
-  writeVariants(mindName, updated);
   if (json) {
     console.log(JSON.stringify(results, null, 2));
     return;
@@ -155,7 +147,7 @@ async function mergeVariant(args) {
     process.exit(1);
   }
   console.log(`Merging variant ${variantName}...`);
-  const { daemonFetch } = await import("./daemon-client-ITWUCNFO.js");
+  const { daemonFetch } = await import("./daemon-client-ZHCDL4RS.js");
   const { getClient, urlOf } = await import("./api-client-YPKOZP2O.js");
   const client = getClient();
   const res = await daemonFetch(
@@ -192,7 +184,7 @@ async function deleteVariant(args) {
     console.error("Usage: volute variant delete <variant> [--mind <name>]");
     process.exit(1);
   }
-  const { daemonFetch } = await import("./daemon-client-ITWUCNFO.js");
+  const { daemonFetch } = await import("./daemon-client-ZHCDL4RS.js");
   const { getClient, urlOf } = await import("./api-client-YPKOZP2O.js");
   const client = getClient();
   const res = await daemonFetch(