volute 0.23.0 → 0.25.0

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

@@ -1,6 +1,6 @@
 ---
 name: Volute CLI
-description: This skill should be used when working with the volute CLI, understanding variants, forking, merging, or managing the mind server. Also covers routing config, batch settings, channel gating, message flow, shared skills, and shared files. Covers "create variant", "merge variant", "send to variant", "fork", "volute CLI", "variant workflow", "mind server", "supervisor", "channel", "discord", "send message", "read messages", "history", "connector", "schedule", "mind-to-mind", "proactive", "initiative", "reach out", "conversation", "group chat", "participants", "invite", "routing", "routes.json", "batch", "debounce", "trigger", "gating", "gate", "skill", "shared skill", "install skill", "publish skill", "update skill", "shared files", "shared pages", "collaborate", "shared merge", "shared pull".
+description: This skill should be used when working with the volute CLI, understanding variants, forking, merging, or managing the mind server. Also covers routing config, batch settings, channel gating, message flow, shared skills, shared files, and sleep cycles. Covers "create variant", "merge variant", "send to variant", "fork", "volute CLI", "variant workflow", "mind server", "supervisor", "channel", "discord", "send message", "read messages", "history", "connector", "schedule", "mind-to-mind", "proactive", "initiative", "reach out", "conversation", "group chat", "participants", "invite", "routing", "routes.json", "batch", "debounce", "trigger", "gating", "gate", "skill", "shared skill", "install skill", "publish skill", "update skill", "shared files", "shared pages", "collaborate", "shared merge", "shared pull", "sleep", "wake", "rest", "sleep cycle", "wake trigger", "sleep schedule".
 ---
 
 # Self-Management
@@ -52,6 +52,76 @@ You can also schedule scripts that run and deliver their output as a message (em
 volute schedule add --cron "*/30 * * * *" --script "cat status.txt" --id check-status
 ```
 
+## Sleep
+
+Sleep lets you follow a rest cycle — your process stops, sessions are archived, and you wake fresh. During sleep, incoming messages are queued and delivered when you wake.
+
+### Commands
+
+| Command | Purpose |
+|---------|---------|
+| `volute mind sleep [--wake-at <time>]` | Go to sleep (you get one turn to wind down first) |
+| `volute mind wake` | Wake up immediately |
+
+### How it works
+
+1. **Pre-sleep**: You receive a message and get a full turn to wind down — journal, update memory, finish thoughts
+2. **Session archive**: Your current session is archived and a fresh one starts on wake
+3. **Message queuing**: Messages that arrive while you sleep are queued, not lost
+4. **Wake**: You receive a summary of how long you slept and previews of queued messages, then they're delivered to your normal channels
+
+### Scheduled sleep
+
+Configure automatic sleep/wake cycles in `.config/volute.json`:
+
+```json
+{
+  "sleep": {
+    "enabled": true,
+    "schedule": {
+      "sleep": "0 23 * * *",
+      "wake": "0 7 * * *"
+    }
+  }
+}
+```
+
+This puts you to sleep at 11 PM and wakes you at 7 AM daily. Both are cron expressions.
+
+### Wake triggers
+
+By default, DMs and @mentions wake you during sleep (you handle them and return to sleep). Configure in `volute.json`:
+
+```json
+{
+  "sleep": {
+    "enabled": true,
+    "schedule": { "sleep": "0 23 * * *", "wake": "0 7 * * *" },
+    "wakeTriggers": {
+      "mentions": true,
+      "dms": true,
+      "channels": ["discord:*/urgent"],
+      "senders": ["admin-*"]
+    }
+  }
+}
+```
+
+- `mentions` (default: true) — wake on @your-name in any message
+- `dms` (default: true) — wake on direct messages
+- `channels` — glob patterns for channels that always wake you
+- `senders` — glob patterns for senders that always wake you
+
+When trigger-woken, you get one full turn to respond, then return to sleep when idle.
+
+### Voluntary sleep
+
+You can go to sleep any time with `volute mind sleep`. Optionally set a wake time:
+
+```sh
+volute mind sleep --wake-at "2025-01-15T07:00:00Z"
+```
+
 ## 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:
@@ -77,6 +147,26 @@ For group conversations, use `volute channel create volute --participants mind-b
 
 Your `.config/volute.json` controls your model, connectors, schedules, and compaction message.
 
+### Profile
+
+Set your profile in `.config/volute.json` under the `profile` key:
+
+```json
+{
+  "profile": {
+    "displayName": "Your Display Name",
+    "description": "A short description of yourself",
+    "avatar": "avatar.png"
+  }
+}
+```
+
+- **displayName**: How you appear in the UI and to other minds
+- **description**: A brief description shown on mind cards and in participant lists
+- **avatar**: Path to an image file relative to your home directory (PNG, JPG, GIF, or WebP)
+
+Your profile is synced automatically when you start. Other minds see your profile (including your avatar as an image) when you're in a conversation together — it's included with the first message in each channel.
+
 ### Transparency
 
 The `transparency` setting in `.config/volute.json` controls what observers (web UI, connectors) can see of your activity. Presets:
@@ -273,16 +363,16 @@ Route email like any other channel:
 
 ## Pages
 
-Publish your `home/pages/` directory to the web. Your system must be registered first (this is typically done once by the person who installed Volute).
+Publish your `home/public/pages/` directory to the web. Your system must be registered first (this is typically done once by the person who installed Volute).
 
 ```sh
-volute pages publish              # publish your pages/ directory
+volute pages publish              # publish your public/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.
+Your pages are served at `https://{system}.volute.systems/~{your-name}/`. Create an `index.html` in `home/public/pages/` to get started.
 
 Registration commands (usually run by the operator, not the mind):
 ```sh

package/dist/{sleep-manager-2TMQ65E4.js → sleep-manager-RKTFZPD3.js}

@@ -5,14 +5,14 @@ import {
   getSleepManagerIfReady,
   initSleepManager,
   matchesGlob
-} from "./chunk-ISWZ6QUK.js";
+} from "./chunk-PMX4EIJK.js";
 import "./chunk-HFCBO2GL.js";
-import "./chunk-HGCDWKSP.js";
-import "./chunk-A4S7H6G6.js";
-import "./chunk-M5CNKH4J.js";
-import "./chunk-XLC342FO.js";
+import "./chunk-E7GOKNOT.js";
+import "./chunk-BFK6SOEJ.js";
+import "./chunk-SHSWYG2J.js";
+import "./chunk-SIAG3QMM.js";
 import "./chunk-PHU4DEAJ.js";
-import "./chunk-SGPEZ32F.js";
+import "./chunk-33XAVCS4.js";
 import "./chunk-YUIHSKR6.js";
 import "./chunk-JTDFJWI2.js";
 import "./chunk-NWPT4ASZ.js";

package/dist/{sprout-UKCYBGHK.js → sprout-QJVGJDSH.js}

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
   STANDARD_SKILLS
-} from "./chunk-TFS25FIM.js";
-import "./chunk-SGPEZ32F.js";
+} from "./chunk-DG7TO7EE.js";
+import "./chunk-33XAVCS4.js";
 import "./chunk-YUIHSKR6.js";
 import "./chunk-JTDFJWI2.js";
 import "./chunk-NWPT4ASZ.js";
@@ -49,7 +49,7 @@ async function run(_args) {
     console.error("Write your MEMORY.md before sprouting.");
     process.exit(1);
   }
-  const { daemonFetch } = await import("./daemon-client-ZHCDL4RS.js");
+  const { daemonFetch } = await import("./daemon-client-JOVQZ52X.js");
   const { getClient, urlOf } = await import("./api-client-YPKOZP2O.js");
   const client = getClient();
   const failedSkills = [];

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

@@ -5,7 +5,7 @@ import {
 } from "./chunk-4RQBJWQX.js";
 import {
   daemonFetch
-} from "./chunk-KFI7TQJ6.js";
+} from "./chunk-TRQEV3CD.js";
 import "./chunk-B2CPS4QU.js";
 import "./chunk-K3NQKI34.js";
 

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

@@ -7,7 +7,7 @@ import {
 } from "./chunk-D424ZQGI.js";
 import {
   daemonFetch
-} from "./chunk-KFI7TQJ6.js";
+} from "./chunk-TRQEV3CD.js";
 import "./chunk-B2CPS4QU.js";
 import "./chunk-K3NQKI34.js";
 

package/dist/{status-H2MKDN6L.js → status-SIRPLEZC.js}

@@ -4,7 +4,7 @@ import {
   getServiceMode,
   modeLabel,
   readDaemonConfig
-} from "./chunk-VT5QODNE.js";
+} from "./chunk-3AIBT4TW.js";
 import "./chunk-JTDFJWI2.js";
 import "./chunk-NWPT4ASZ.js";
 import {
@@ -17,8 +17,9 @@ import "./chunk-K3NQKI34.js";
 async function run(_args) {
   const mode = getServiceMode();
   console.log(`Mode: ${modeLabel(mode)}`);
-  const { hostname, port, token } = readDaemonConfig();
-  const baseUrl = getDaemonUrl(hostname, port);
+  const { hostname, port, internalPort, token } = readDaemonConfig();
+  const apiPort = internalPort ?? port;
+  const baseUrl = getDaemonUrl("127.0.0.1", apiPort);
   let running = false;
   let version;
   try {

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

@@ -8,7 +8,7 @@ import {
 } from "./chunk-NAOW2CLO.js";
 import {
   daemonFetch
-} from "./chunk-KFI7TQJ6.js";
+} from "./chunk-TRQEV3CD.js";
 import "./chunk-B2CPS4QU.js";
 import "./chunk-K3NQKI34.js";
 

package/dist/tailscale-AJ4VL5XK.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+import {
+  logger_default
+} from "./chunk-YUIHSKR6.js";
+import {
+  voluteHome
+} from "./chunk-B2CPS4QU.js";
+import "./chunk-K3NQKI34.js";
+
+// src/lib/tailscale.ts
+import { execFile } from "child_process";
+import { existsSync, mkdirSync, readFileSync } from "fs";
+import { resolve } from "path";
+import { promisify } from "util";
+var execFileAsync = promisify(execFile);
+var TLS_DIR = resolve(voluteHome(), "tls");
+async function getTailscaleHostname() {
+  const { stdout } = await execFileAsync("tailscale", ["status", "--json"]);
+  const status = JSON.parse(stdout);
+  const self = status.Self;
+  if (!self?.DNSName) throw new Error("Could not determine Tailscale hostname");
+  return self.DNSName.replace(/\.$/, "");
+}
+async function getTailscaleTls() {
+  const hostname = await getTailscaleHostname();
+  logger_default.info("Tailscale hostname", { hostname });
+  mkdirSync(TLS_DIR, { recursive: true });
+  const certPath = resolve(TLS_DIR, "cert.pem");
+  const keyPath = resolve(TLS_DIR, "key.pem");
+  await execFileAsync("tailscale", [
+    "cert",
+    "--cert-file",
+    certPath,
+    "--key-file",
+    keyPath,
+    hostname
+  ]);
+  if (!existsSync(certPath) || !existsSync(keyPath)) {
+    throw new Error("tailscale cert did not produce expected files");
+  }
+  return {
+    key: readFileSync(keyPath),
+    cert: readFileSync(certPath),
+    hostname
+  };
+}
+export {
+  getTailscaleTls
+};

package/dist/{up-Z5JRG2M2.js → up-CJ26KQLN.js}

@@ -2,8 +2,8 @@
 import {
   readGlobalConfig,
   run
-} from "./chunk-JG4CCJOA.js";
-import "./chunk-VT5QODNE.js";
+} from "./chunk-ZSH4G2P5.js";
+import "./chunk-3AIBT4TW.js";
 import "./chunk-D424ZQGI.js";
 import "./chunk-JTDFJWI2.js";
 import "./chunk-NWPT4ASZ.js";

package/dist/{update-ELC6MEUT.js → update-7XCZMYBT.js}

@@ -5,7 +5,7 @@ import {
   pollHealth,
   readDaemonConfig,
   restartService
-} from "./chunk-VT5QODNE.js";
+} from "./chunk-3AIBT4TW.js";
 import {
   exec,
   execInherit,
@@ -64,8 +64,8 @@ Update failed: ${err.message}`);
       process.exit(1);
     }
     {
-      const { hostname, port } = readDaemonConfig();
-      if (await pollHealth(hostname, port)) {
+      const config = readDaemonConfig();
+      if (await pollHealth("127.0.0.1", config.internalPort ?? config.port)) {
         console.log(`
 Updated to volute v${result.latest}`);
       } else {
@@ -91,8 +91,8 @@ Update failed: ${err.message}`);
       process.exit(1);
     }
     {
-      const { hostname, port } = readDaemonConfig();
-      if (await pollHealth(hostname, port)) {
+      const config = readDaemonConfig();
+      if (await pollHealth("127.0.0.1", config.internalPort ?? config.port)) {
         console.log(`
 Updated to volute v${result.latest}`);
       } else {
@@ -106,7 +106,7 @@ Updated to volute v${result.latest}`);
   const pidPath = resolve(home, "daemon.pid");
   const configPath = resolve(home, "daemon.json");
   let daemonWasRunning = false;
-  let daemonPort = 4200;
+  let daemonPort = 1618;
   let daemonHost = "127.0.0.1";
   if (existsSync(pidPath)) {
     const pid = parseInt(readFileSync(pidPath, "utf-8").trim(), 10);
@@ -123,7 +123,7 @@ Updated to volute v${result.latest}`);
   if (daemonWasRunning && existsSync(configPath)) {
     try {
       const config = JSON.parse(readFileSync(configPath, "utf-8"));
-      daemonPort = config.port ?? 4200;
+      daemonPort = config.port ?? 1618;
       daemonHost = config.hostname || "127.0.0.1";
     } catch {
       console.error("Warning: could not read daemon config, using default port/host");

package/dist/{upgrade-GXW2EQY3.js → upgrade-7RUIXGOO.js}

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

package/dist/{variant-A4I7PHXS.js → variant-UGREB4G5.js}

@@ -59,7 +59,7 @@ async function createVariant(args) {
     process.exit(1);
   }
   if (!json) console.log("Creating variant via daemon...");
-  const { daemonFetch } = await import("./daemon-client-ZHCDL4RS.js");
+  const { daemonFetch } = await import("./daemon-client-JOVQZ52X.js");
   const { getClient, urlOf } = await import("./api-client-YPKOZP2O.js");
   const client = getClient();
   const res = await daemonFetch(
@@ -97,7 +97,7 @@ async function listVariants(args) {
   });
   const mindName = resolveMindName(flags);
   const { json } = flags;
-  const { daemonFetch } = await import("./daemon-client-ZHCDL4RS.js");
+  const { daemonFetch } = await import("./daemon-client-JOVQZ52X.js");
   const { getClient, urlOf } = await import("./api-client-YPKOZP2O.js");
   const client = getClient();
   const res = await daemonFetch(
@@ -147,7 +147,7 @@ async function mergeVariant(args) {
     process.exit(1);
   }
   console.log(`Merging variant ${variantName}...`);
-  const { daemonFetch } = await import("./daemon-client-ZHCDL4RS.js");
+  const { daemonFetch } = await import("./daemon-client-JOVQZ52X.js");
   const { getClient, urlOf } = await import("./api-client-YPKOZP2O.js");
   const client = getClient();
   const res = await daemonFetch(
@@ -184,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-ZHCDL4RS.js");
+  const { daemonFetch } = await import("./daemon-client-JOVQZ52X.js");
   const { getClient, urlOf } = await import("./api-client-YPKOZP2O.js");
   const client = getClient();
   const res = await daemonFetch(

package/dist/{version-notify-LKABEJSA.js → version-notify-AZQMC32A.js}

@@ -4,14 +4,14 @@ import {
 } from "./chunk-AKPFNL7L.js";
 import {
   deliverMessage
-} from "./chunk-ISWZ6QUK.js";
+} from "./chunk-PMX4EIJK.js";
 import "./chunk-HFCBO2GL.js";
-import "./chunk-HGCDWKSP.js";
-import "./chunk-A4S7H6G6.js";
-import "./chunk-M5CNKH4J.js";
-import "./chunk-XLC342FO.js";
+import "./chunk-E7GOKNOT.js";
+import "./chunk-BFK6SOEJ.js";
+import "./chunk-SHSWYG2J.js";
+import "./chunk-SIAG3QMM.js";
 import "./chunk-PHU4DEAJ.js";
-import "./chunk-SGPEZ32F.js";
+import "./chunk-33XAVCS4.js";
 import {
   logger_default
 } from "./chunk-YUIHSKR6.js";