volute 0.15.0 → 0.16.0

package/README.md

@@ -161,6 +161,36 @@ volute schedule list --agent atlas
 volute schedule remove --agent atlas --id <schedule-id>
 ```
 
+## Pages
+
+Publish a mind's `home/pages/` directory to the web via [volute.systems](https://volute.systems).
+
+### Setup
+
+```sh
+# Register a system name (one-time)
+volute pages register --name my-system
+
+# Or log in with an existing key
+volute pages login --key vp_...
+```
+
+### Publishing
+
+```sh
+volute pages publish --mind atlas
+# Published 3 file(s) to https://my-system.volute.systems/~atlas/
+```
+
+The command uploads everything in the mind's `home/pages/` directory. Minds can publish their own pages since `VOLUTE_MIND` is set automatically.
+
+### Status & Logout
+
+```sh
+volute pages status --mind atlas   # show published URL, file count, last publish time
+volute pages logout                # remove stored credentials
+```
+
 ## Environment variables
 
 Manage secrets and config. Supports shared (all agents) and per-agent scoping.

package/dist/chunk-37X7ECMF.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+import {
+  voluteHome
+} from "./chunk-M77QBTEH.js";
+
+// src/lib/systems-config.ts
+import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "fs";
+import { resolve } from "path";
+var DEFAULT_API_URL = "https://volute.systems";
+function configPath() {
+  return resolve(voluteHome(), "systems.json");
+}
+function readSystemsConfig() {
+  const path = configPath();
+  if (!existsSync(path)) return null;
+  const raw = readFileSync(path, "utf-8");
+  let data;
+  try {
+    data = JSON.parse(raw);
+  } catch {
+    console.error(`Warning: ${path} contains invalid JSON. Run "volute logout" and re-login.`);
+    return null;
+  }
+  if (!data.apiKey || !data.system) return null;
+  return {
+    apiKey: data.apiKey,
+    system: data.system,
+    apiUrl: data.apiUrl || DEFAULT_API_URL
+  };
+}
+function writeSystemsConfig(config) {
+  mkdirSync(voluteHome(), { recursive: true });
+  writeFileSync(configPath(), `${JSON.stringify(config, null, 2)}
+`, { mode: 384 });
+}
+function deleteSystemsConfig() {
+  try {
+    unlinkSync(configPath());
+    return true;
+  } catch (err) {
+    if (err.code === "ENOENT") return false;
+    throw err;
+  }
+}
+
+export {
+  readSystemsConfig,
+  writeSystemsConfig,
+  deleteSystemsConfig
+};

package/dist/{chunk-PDLAZJGC.js → chunk-3FD4ZZUL.js}

@@ -548,6 +548,7 @@ var CHANNELS = {
     showToolCalls: false,
     driver: telegram_exports
   },
+  mail: { name: "mail", displayName: "Email", showToolCalls: false },
   system: { name: "system", displayName: "System", showToolCalls: false }
 };
 function getChannelDriver(platform) {

package/dist/chunk-RVKR2R7F.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+
+// src/lib/prompt.ts
+function promptLine(prompt) {
+  process.stderr.write(prompt);
+  return new Promise((resolve) => {
+    let value = "";
+    const onData = (buf) => {
+      for (const byte of buf) {
+        if (byte === 3) {
+          process.stderr.write("\n");
+          process.exit(1);
+        }
+        if (byte === 13 || byte === 10) {
+          process.stderr.write("\n");
+          if (process.stdin.isTTY) process.stdin.setRawMode(false);
+          process.stdin.removeListener("data", onData);
+          process.stdin.pause();
+          resolve(value);
+          return;
+        }
+        if (byte === 127 || byte === 8) {
+          value = value.slice(0, -1);
+        } else {
+          value += String.fromCharCode(byte);
+        }
+      }
+    };
+    if (process.stdin.isTTY) process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdin.on("data", onData);
+  });
+}
+
+export {
+  promptLine
+};

package/dist/chunk-RWKVSSLY.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+
+// src/lib/systems-fetch.ts
+async function systemsFetch(url, init) {
+  try {
+    return await fetch(url, init);
+  } catch (err) {
+    const cause = err.cause;
+    const code = cause?.code;
+    const host = new URL(url).host;
+    if (code === "ENOTFOUND") {
+      console.error(`Could not resolve ${host}. Check your internet connection.`);
+    } else if (code === "ECONNREFUSED") {
+      console.error(`Connection refused by ${host}. The service may be down.`);
+    } else {
+      console.error(
+        `Network error connecting to ${host}: ${cause?.message ?? err.message}`
+      );
+    }
+    process.exit(1);
+  }
+}
+
+export {
+  systemsFetch
+};

package/dist/cli.js

@@ -9,7 +9,7 @@ if (!process.env.VOLUTE_HOME) {
 var command = process.argv[2];
 var args = process.argv.slice(3);
 if (command === "--version" || command === "-v") {
-  const { default: pkg } = await import("./package-TDCEK6C2.js");
+  const { default: pkg } = await import("./package-3QGV3KX6.js");
   console.log(pkg.version);
   process.exit(0);
 }
@@ -18,7 +18,7 @@ switch (command) {
     await import("./mind-OJN6RBZW.js").then((m) => m.run(args));
     break;
   case "send":
-    await import("./send-SV4K2TDE.js").then((m) => m.run(args));
+    await import("./send-KBBZNYG6.js").then((m) => m.run(args));
     break;
   case "history":
     await import("./history-LKCJJMUV.js").then((m) => m.run(args));
@@ -27,7 +27,7 @@ switch (command) {
     await import("./variant-X5QFG6KK.js").then((m) => m.run(args));
     break;
   case "connector":
-    await import("./connector-JFAHYFQX.js").then((m) => m.run(args));
+    await import("./connector-3ELFMI2R.js").then((m) => m.run(args));
     break;
   case "channel":
     await import("./channel-SLURLIRV.js").then((m) => m.run(args));
@@ -36,16 +36,16 @@ switch (command) {
     await import("./schedule-AGYLDMNS.js").then((m) => m.run(args));
     break;
   case "env":
-    await import("./env-6LXDUZDA.js").then((m) => m.run(args));
+    await import("./env-6IDWGBUH.js").then((m) => m.run(args));
     break;
   case "up":
-    await import("./up-C4MV6EXV.js").then((m) => m.run(args));
+    await import("./up-GZLWZAQE.js").then((m) => m.run(args));
     break;
   case "down":
     await import("./down-A56B5JLK.js").then((m) => m.run(args));
     break;
   case "restart":
-    await import("./daemon-restart-IZGEF4NA.js").then((m) => m.run(args));
+    await import("./daemon-restart-MS5FI44G.js").then((m) => m.run(args));
     break;
   case "setup":
     await import("./setup-DJKIZKGW.js").then((m) => m.run(args));
@@ -65,6 +65,18 @@ switch (command) {
   case "sprout":
     await import("./sprout-TJ3BHVOG.js").then((m) => m.run(args));
     break;
+  case "pages":
+    await import("./pages-6IV4VQTU.js").then((m) => m.run(args));
+    break;
+  case "register":
+    await import("./register-LDE6LRXY.js").then((m) => m.run(args));
+    break;
+  case "login":
+    await import("./login-ORQDXLBM.js").then((m) => m.run(args));
+    break;
+  case "logout":
+    await import("./logout-XC5AUO5I.js").then((m) => m.run());
+    break;
   case "--help":
   case "-h":
   case void 0:
@@ -114,6 +126,13 @@ Commands:
   volute setup [--port N] [--host H]      Install system service with user isolation
   volute setup uninstall [--force]        Remove system service + isolation
 
+  volute register [--name <name>]         Register a system on volute.systems
+  volute login [--key <key>]              Log in with an existing API key
+  volute logout                           Remove stored credentials
+
+  volute pages publish [--mind <name>]    Publish mind's pages/ directory
+  volute pages status [--mind <name>]     Show publish status
+
   volute seed <name>                      Plant a seed mind (orientation mode)
   volute sprout                           Complete orientation, become a full mind
 
@@ -124,7 +143,7 @@ Options:
   --version, -v                           Show version number
   --help, -h                              Show this help message
 
-Mind-scoped commands (send, history, variant, connector, schedule, channel)
+Mind-scoped commands (send, history, variant, connector, schedule, channel, pages)
 use --mind <name> or VOLUTE_MIND env var to identify the mind.`);
     break;
   default:

package/dist/{connector-JFAHYFQX.js → connector-3ELFMI2R.js}

@@ -1,4 +1,7 @@
 #!/usr/bin/env node
+import {
+  promptLine
+} from "./chunk-RVKR2R7F.js";
 import {
   resolveMindName
 } from "./chunk-NAOW2CLO.js";
@@ -40,37 +43,6 @@ function printUsage() {
   volute connector connect <type> [--mind <name>]
   volute connector disconnect <type> [--mind <name>]`);
 }
-async function promptValue(key, description) {
-  process.stderr.write(`${description}
-Enter value for ${key}: `);
-  if (process.stdin.isTTY) process.stdin.setRawMode(true);
-  return new Promise((resolve) => {
-    let value = "";
-    const onData = (buf) => {
-      for (const byte of buf) {
-        if (byte === 3) {
-          process.stderr.write("\n");
-          process.exit(1);
-        }
-        if (byte === 13 || byte === 10) {
-          process.stderr.write("\n");
-          if (process.stdin.isTTY) process.stdin.setRawMode(false);
-          process.stdin.removeListener("data", onData);
-          process.stdin.pause();
-          resolve(value);
-          return;
-        }
-        if (byte === 127 || byte === 8) {
-          value = value.slice(0, -1);
-        } else {
-          value += String.fromCharCode(byte);
-        }
-      }
-    };
-    process.stdin.resume();
-    process.stdin.on("data", onData);
-  });
-}
 async function connectConnector(args) {
   const { positional, flags } = parseArgs(args, {
     mind: { type: "string" }
@@ -104,7 +76,8 @@ Set them with: volute env set <KEY> --mind ${mindName}`);
       console.error(`${connectorName} connector requires some environment variables.
 `);
       for (const v of missing) {
-        const value = await promptValue(v.name, v.description);
+        const value = await promptLine(`${v.description}
+Enter value for ${v.name}: `);
         if (!value) {
           console.error(`No value provided for ${v.name}. Aborting.`);
           process.exit(1);

package/dist/{daemon-restart-IZGEF4NA.js → daemon-restart-MS5FI44G.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   run
-} from "./chunk-BEFIBW5B.js";
+} from "./chunk-LLBBVTEY.js";
 import {
   stopDaemon
 } from "./chunk-QJIIHU32.js";

package/dist/daemon.js

@@ -6,6 +6,9 @@ import {
   findTemplatesRoot,
   listFiles
 } from "./chunk-PO5Q2AYN.js";
+import {
+  readSystemsConfig
+} from "./chunk-37X7ECMF.js";
 import {
   RotatingLog,
   clearJsonMap,
@@ -32,7 +35,7 @@ import {
 import {
   CHANNELS,
   getChannelDriver
-} from "./chunk-PDLAZJGC.js";
+} from "./chunk-3FD4ZZUL.js";
 import {
   exec,
   gitExec,
@@ -431,6 +434,159 @@ function getConnectorManager() {
   return instance;
 }
 
+// src/lib/mail-poller.ts
+function formatEmailContent(email) {
+  if (email.body) {
+    return email.subject ? `Subject: ${email.subject}
+
+${email.body}` : email.body;
+  }
+  if (email.html) {
+    return email.subject ? `Subject: ${email.subject}
+
+[HTML email \u2014 plain text not available]` : "[HTML email \u2014 plain text not available]";
+  }
+  return email.subject ? `Subject: ${email.subject}` : "[Empty email]";
+}
+var MailPoller = class {
+  interval = null;
+  daemonPort = null;
+  daemonToken = null;
+  lastPoll = null;
+  running = false;
+  start(daemonPort, daemonToken) {
+    if (this.running) {
+      console.error("[mail] already running \u2014 ignoring duplicate start");
+      return;
+    }
+    const config = readSystemsConfig();
+    if (!config) {
+      console.error("[mail] no systems config \u2014 mail polling disabled");
+      return;
+    }
+    this.daemonPort = daemonPort ?? null;
+    this.daemonToken = daemonToken ?? null;
+    this.lastPoll = (/* @__PURE__ */ new Date()).toISOString();
+    this.running = true;
+    this.interval = setInterval(() => this.poll(), 3e4);
+    console.error("[mail] polling started");
+  }
+  stop() {
+    if (this.interval) clearInterval(this.interval);
+    this.interval = null;
+    this.running = false;
+  }
+  isRunning() {
+    return this.running;
+  }
+  async poll() {
+    const config = readSystemsConfig();
+    if (!config) {
+      console.error("[mail] systems config removed \u2014 stopping mail polling");
+      this.stop();
+      return;
+    }
+    const since = this.lastPoll ?? (/* @__PURE__ */ new Date()).toISOString();
+    const url = `${config.apiUrl}/api/mail/system/poll?since=${encodeURIComponent(since)}`;
+    try {
+      const res = await fetch(url, {
+        headers: { Authorization: `Bearer ${config.apiKey}` }
+      });
+      if (!res.ok) {
+        console.error(`[mail] poll failed: HTTP ${res.status}`);
+        return;
+      }
+      const data = await res.json();
+      if (!Array.isArray(data.emails)) {
+        console.error("[mail] poll response missing emails array");
+        return;
+      }
+      for (const email of data.emails) {
+        await this.deliver(email.mind, email);
+      }
+      if (data.emails.length > 0) {
+        this.lastPoll = data.emails[data.emails.length - 1].receivedAt;
+      } else {
+        this.lastPoll = (/* @__PURE__ */ new Date()).toISOString();
+      }
+    } catch (err) {
+      console.error("[mail] poll error:", err);
+    }
+  }
+  async deliver(mind, email) {
+    const entry = findMind(mind);
+    if (!entry || !entry.running) {
+      console.error(`[mail] skipping delivery to ${mind}: ${!entry ? "not found" : "not running"}`);
+      return;
+    }
+    const channel = `mail:${email.from.address}`;
+    const sender = email.from.name || email.from.address;
+    const text2 = formatEmailContent(email);
+    const body = JSON.stringify({
+      content: [{ type: "text", text: text2 }],
+      channel,
+      sender,
+      platform: "Email",
+      isDM: true
+    });
+    if (!this.daemonPort || !this.daemonToken) {
+      console.error(`[mail] cannot deliver to ${mind}: daemon port/token not set`);
+      return;
+    }
+    const daemonUrl = `http://${daemonLoopback()}:${this.daemonPort}`;
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 12e4);
+    try {
+      const res = await fetch(`${daemonUrl}/api/minds/${encodeURIComponent(mind)}/message`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${this.daemonToken}`,
+          Origin: daemonUrl
+        },
+        body,
+        signal: controller.signal
+      });
+      if (!res.ok) {
+        console.error(`[mail] deliver to ${mind} got HTTP ${res.status}`);
+      } else {
+        console.error(`[mail] delivered email from ${email.from.address} to ${mind}`);
+      }
+      await res.text().catch(() => {
+      });
+    } catch (err) {
+      console.error(`[mail] failed to deliver to ${mind}:`, err);
+    } finally {
+      clearTimeout(timeout);
+    }
+  }
+};
+var instance2 = null;
+function getMailPoller() {
+  if (!instance2) instance2 = new MailPoller();
+  return instance2;
+}
+async function ensureMailAddress(mindName) {
+  const config = readSystemsConfig();
+  if (!config) return;
+  try {
+    const res = await fetch(`${config.apiUrl}/api/mail/addresses/${encodeURIComponent(mindName)}`, {
+      method: "PUT",
+      headers: {
+        Authorization: `Bearer ${config.apiKey}`,
+        "Content-Type": "application/json"
+      }
+    });
+    if (!res.ok) {
+      console.error(`[mail] failed to ensure address for ${mindName}: HTTP ${res.status}`);
+    }
+    await res.text().catch(() => {
+    });
+  } catch (err) {
+    console.error(`[mail] failed to ensure address for ${mindName}:`, err);
+  }
+}
+
 // src/lib/migrate-agents-to-minds.ts
 import { execFileSync } from "child_process";
 import { existsSync as existsSync3, readFileSync as readFileSync3, renameSync, writeFileSync as writeFileSync2 } from "fs";
@@ -718,10 +874,10 @@ var Scheduler = class {
     }
   }
 };
-var instance2 = null;
+var instance3 = null;
 function getScheduler() {
-  if (!instance2) instance2 = new Scheduler();
-  return instance2;
+  if (!instance3) instance3 = new Scheduler();
+  return instance3;
 }
 
 // src/lib/token-budget.ts
@@ -882,10 +1038,10 @@ ${summary}`
     }
   }
 };
-var instance3 = null;
+var instance4 = null;
 function getTokenBudget() {
-  if (!instance3) instance3 = new TokenBudget();
-  return instance3;
+  if (!instance4) instance4 = new TokenBudget();
+  return instance4;
 }
 
 // src/web/middleware/auth.ts
@@ -1427,10 +1583,16 @@ var app3 = new Hono3().get("/:name/connectors", (c) => {
   const configured = config.connectors ?? [];
   const manager = getConnectorManager();
   const runningStatus = manager.getConnectorStatus(name);
-  const connectors = configured.map((type) => {
-    const status = runningStatus.find((s) => s.type === type);
-    return { type, running: status?.running ?? false };
-  });
+  const connectors = configured.map(
+    (type) => {
+      const status = runningStatus.find((s) => s.type === type);
+      return { type, running: status?.running ?? false };
+    }
+  );
+  const systemsConfig = readSystemsConfig();
+  if (systemsConfig && getMailPoller().isRunning()) {
+    connectors.push({ type: "mail", running: true, auto: true });
+  }
   return c.json(connectors);
 }).post("/:name/connectors/:type", requireAdmin, async (c) => {
   const name = c.req.param("name");
@@ -2188,7 +2350,7 @@ var TypingMap = class {
   dispose() {
     clearInterval(this.sweepTimer);
     this.channels.clear();
-    if (instance4 === this) instance4 = void 0;
+    if (instance5 === this) instance5 = void 0;
   }
   sweep() {
     const now = Date.now();
@@ -2204,12 +2366,12 @@ var TypingMap = class {
     }
   }
 };
-var instance4;
+var instance5;
 function getTypingMap() {
-  if (!instance4) {
-    instance4 = new TypingMap();
+  if (!instance5) {
+    instance5 = new TypingMap();
   }
-  return instance4;
+  return instance5;
 }
 
 // src/web/routes/minds.ts
@@ -2221,6 +2383,9 @@ async function startMindFull(name, baseName, variantName) {
   const entry = findMind(baseName);
   await getConnectorManager().startConnectors(baseName, dir, entry.port, getDaemonPort());
   getScheduler().loadSchedules(baseName);
+  ensureMailAddress(baseName).catch(
+    (err) => console.error(`[mail] failed to ensure address for ${baseName}:`, err)
+  );
   const config = readVoluteConfig(dir);
   if (config?.tokenBudget) {
     getTokenBudget().setBudget(
@@ -3311,6 +3476,9 @@ var app10 = new Hono10().post("/restart", requireAdmin, (c) => {
       });
     });
   });
+}).get("/info", (c) => {
+  const config = readSystemsConfig();
+  return c.json({ system: config?.system ?? null });
 });
 var system_default = app10;
 
@@ -4200,6 +4368,8 @@ async function startDaemon(opts) {
   const connectors = initConnectorManager();
   const scheduler = getScheduler();
   scheduler.start(port, token);
+  const mailPoller = getMailPoller();
+  mailPoller.start(port, token);
   const tokenBudget = getTokenBudget();
   tokenBudget.start(port, token);
   const registry = readRegistry();
@@ -4218,6 +4388,9 @@ async function startDaemon(opts) {
       const dir = mindDir(entry.name);
       await connectors.startConnectors(entry.name, dir, entry.port, port);
       scheduler.loadSchedules(entry.name);
+      ensureMailAddress(entry.name).catch(
+        (err) => console.error(`[mail] failed to ensure address for ${entry.name}:`, err)
+      );
       const config = readVoluteConfig(dir);
       if (config?.tokenBudget) {
         tokenBudget.setBudget(
@@ -4266,6 +4439,7 @@ async function startDaemon(opts) {
     console.error("[daemon] shutting down...");
     scheduler.stop();
     scheduler.saveState();
+    mailPoller.stop();
     tokenBudget.stop();
     await connectors.stopAll();
     await manager.stopAll();

package/dist/{env-6LXDUZDA.js → env-6IDWGBUH.js}

@@ -1,4 +1,7 @@
 #!/usr/bin/env node
+import {
+  promptLine
+} from "./chunk-RVKR2R7F.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
@@ -13,36 +16,6 @@ import {
 import "./chunk-K3NQKI34.js";
 
 // src/commands/env.ts
-async function promptValue(key) {
-  process.stderr.write(`Enter value for ${key}: `);
-  if (process.stdin.isTTY) process.stdin.setRawMode(true);
-  return new Promise((resolve) => {
-    let value = "";
-    const onData = (buf) => {
-      for (const byte of buf) {
-        if (byte === 3) {
-          process.stderr.write("\n");
-          process.exit(1);
-        }
-        if (byte === 13 || byte === 10) {
-          process.stderr.write("\n");
-          if (process.stdin.isTTY) process.stdin.setRawMode(false);
-          process.stdin.removeListener("data", onData);
-          process.stdin.pause();
-          resolve(value);
-          return;
-        }
-        if (byte === 127 || byte === 8) {
-          value = value.slice(0, -1);
-        } else {
-          value += String.fromCharCode(byte);
-        }
-      }
-    };
-    process.stdin.resume();
-    process.stdin.on("data", onData);
-  });
-}
 function maskValue(value) {
   if (value.length <= 6) return "***";
   return `${value.slice(0, 3)}...${value.slice(-3)}`;
@@ -61,7 +34,7 @@ async function run(args) {
         console.error("Usage: volute env set <KEY> [<VALUE>] [--mind <name>]");
         process.exit(1);
       }
-      const value = positional[2] ?? await promptValue(key);
+      const value = positional[2] ?? await promptLine(`Enter value for ${key}: `);
       let res;
       if (flags.mind) {
         res = await daemonFetch(