volute 0.7.0 → 0.8.1

package/dist/{delete-UOU4AFQN.js → delete-45TGQC4N.js}

@@ -4,19 +4,20 @@ import {
 } from "./chunk-AZEL2IEK.js";
 import {
   deleteAgentUser as deleteAgentUser2
-} from "./chunk-7ACDT3P2.js";
+} from "./chunk-ECPQXRLB.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
 import {
   deleteAgentUser
-} from "./chunk-W76KWE23.js";
+} from "./chunk-IQXBMFZG.js";
 import {
   agentDir,
   findAgent,
   removeAgent,
-  removeAllVariants
-} from "./chunk-UWHWAPGO.js";
+  removeAllVariants,
+  stateDir
+} from "./chunk-DP2DX4WV.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/delete.ts
@@ -32,7 +33,7 @@ async function run(args) {
     process.exit(1);
   }
   try {
-    const { daemonFetch } = await import("./daemon-client-442IV43D.js");
+    const { daemonFetch } = await import("./daemon-client-54J3EIZD.js");
     const res = await daemonFetch(`/api/agents/${encodeURIComponent(name)}/stop`, {
       method: "POST"
     });
@@ -46,6 +47,10 @@ async function run(args) {
   removeAgent(name);
   await deleteAgentUser2(name);
   console.log(`Removed ${name} from registry.`);
+  const state = stateDir(name);
+  if (existsSync(state)) {
+    rmSync(state, { recursive: true, force: true });
+  }
   if (existsSync(dir)) {
     if (!flags.force) {
       console.log(`Directory: ${dir}`);

package/dist/{down-AZVH5TCD.js → down-O4EWZTVA.js}

@@ -2,8 +2,8 @@
 import {
   run,
   stopDaemon
-} from "./chunk-LLJNZPCU.js";
-import "./chunk-UWHWAPGO.js";
+} from "./chunk-HZ5LTOEJ.js";
+import "./chunk-DP2DX4WV.js";
 import "./chunk-K3NQKI34.js";
 export {
   run,

package/dist/{env-7GLUJCWS.js → env-KMNYGVZ2.js}

@@ -5,20 +5,20 @@ import {
   readEnv,
   sharedEnvPath,
   writeEnv
-} from "./chunk-H7AMDUIA.js";
+} from "./chunk-QF22MYDJ.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
 import {
-  resolveAgent
-} from "./chunk-UWHWAPGO.js";
+  findAgent
+} from "./chunk-DP2DX4WV.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/env.ts
 function getEnvPath(agentName) {
   if (agentName) {
-    const { dir } = resolveAgent(agentName);
-    return agentEnvPath(dir);
+    if (!findAgent(agentName)) throw new Error(`Unknown agent: ${agentName}`);
+    return agentEnvPath(agentName);
   }
   return sharedEnvPath();
 }
@@ -85,8 +85,7 @@ async function run(args) {
         process.exit(1);
       }
       if (flags.agent) {
-        const { dir } = resolveAgent(flags.agent);
-        const merged = loadMergedEnv(dir);
+        const merged = loadMergedEnv(flags.agent);
         if (key in merged) {
           console.log(merged[key]);
         } else {
@@ -106,9 +105,8 @@ async function run(args) {
     }
     case "list": {
       if (flags.agent) {
-        const { dir } = resolveAgent(flags.agent);
         const shared = readEnv(sharedEnvPath());
-        const agent = readEnv(agentEnvPath(dir));
+        const agent = readEnv(agentEnvPath(flags.agent));
         const allKeys = /* @__PURE__ */ new Set([...Object.keys(shared), ...Object.keys(agent)]);
         if (allKeys.size === 0) {
           console.log("No environment variables set.");

package/dist/{history-H72ZUIBN.js → history-PXJVYLVY.js}

@@ -7,8 +7,8 @@ import {
 } from "./chunk-D424ZQGI.js";
 import {
   daemonFetch
-} from "./chunk-JR4UXCTO.js";
-import "./chunk-UWHWAPGO.js";
+} from "./chunk-23L3MKEV.js";
+import "./chunk-DP2DX4WV.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/history.ts

package/dist/{import-AVKQJDYC.js → import-CNEDF3TD.js}

@@ -7,7 +7,7 @@ import {
   agentEnvPath,
   readEnv,
   writeEnv
-} from "./chunk-H7AMDUIA.js";
+} from "./chunk-QF22MYDJ.js";
 import {
   composeTemplate,
   copyTemplateToDir,
@@ -19,13 +19,13 @@ import {
 import {
   exec,
   execInherit
-} from "./chunk-5SKQ6J7T.js";
+} from "./chunk-5C5JWR2L.js";
 import {
   addAgent,
   agentDir,
   ensureVoluteHome,
   nextPort
-} from "./chunk-UWHWAPGO.js";
+} from "./chunk-DP2DX4WV.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/import.ts
@@ -390,7 +390,7 @@ ${user.trimEnd()}
       console.warn(`Session import not supported for template: ${template}`);
     }
   }
-  importOpenClawConnectors(dest);
+  importOpenClawConnectors(name, dest);
   console.log(`
 Imported agent: ${name} (port ${port})`);
   console.log(`
@@ -475,7 +475,7 @@ function importPiSession(sessionFile, agentDirPath) {
 `);
   console.log(`Imported session (${lines.length} entries)`);
 }
-function importOpenClawConnectors(agentDirPath) {
+function importOpenClawConnectors(agentName, agentDirPath) {
   const configPath = resolve3(homedir2(), ".openclaw/openclaw.json");
   if (!existsSync(configPath)) return;
   let config;
@@ -487,7 +487,7 @@ function importOpenClawConnectors(agentDirPath) {
   }
   const discord = config.channels?.discord;
   if (!discord?.enabled || !discord.token) return;
-  const envPath = agentEnvPath(agentDirPath);
+  const envPath = agentEnvPath(agentName);
   const env = readEnv(envPath);
   env.DISCORD_TOKEN = discord.token;
   writeEnv(envPath, env);

package/dist/{logs-EDGK26AK.js → logs-TZB3MTLZ.js}

@@ -6,8 +6,9 @@ import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
 import {
-  resolveAgent
-} from "./chunk-UWHWAPGO.js";
+  resolveAgent,
+  stateDir
+} from "./chunk-DP2DX4WV.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/logs.ts
@@ -21,8 +22,8 @@ async function run(args) {
     n: { type: "number" }
   });
   const name = resolveAgentName(flags);
-  const { dir } = resolveAgent(name);
-  const logFile = resolve(dir, ".volute", "logs", "agent.log");
+  resolveAgent(name);
+  const logFile = resolve(stateDir(name), "logs", "agent.log");
   if (!existsSync(logFile)) {
     console.error(`No log file found. Has ${name} been started?`);
     process.exit(1);

package/dist/{package-T2WAVJOU.js → package-RJSONENE.js}

@@ -4,7 +4,7 @@ import "./chunk-K3NQKI34.js";
 // package.json
 var package_default = {
   name: "volute",
-  version: "0.7.0",
+  version: "0.8.1",
   description: "CLI for creating and managing self-modifying AI agents powered by the Claude Agent SDK",
   type: "module",
   license: "MIT",

package/dist/{restart-O4ETYLJF.js → restart-KVH3TK5N.js}

@@ -4,10 +4,10 @@ import {
 } from "./chunk-AZEL2IEK.js";
 import {
   daemonFetch
-} from "./chunk-JR4UXCTO.js";
+} from "./chunk-23L3MKEV.js";
 import {
   resolveAgent
-} from "./chunk-UWHWAPGO.js";
+} from "./chunk-DP2DX4WV.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/restart.ts

package/dist/{schedule-S6QVC5ON.js → schedule-HCUCBNQI.js}

@@ -7,8 +7,8 @@ import {
 } from "./chunk-D424ZQGI.js";
 import {
   daemonFetch
-} from "./chunk-JR4UXCTO.js";
-import "./chunk-UWHWAPGO.js";
+} from "./chunk-23L3MKEV.js";
+import "./chunk-DP2DX4WV.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/schedule.ts

package/dist/send-BNC2S5BY.js

@@ -0,0 +1,162 @@
+#!/usr/bin/env node
+import {
+  resolveAgentName
+} from "./chunk-AZEL2IEK.js";
+import {
+  getChannelDriver
+} from "./chunk-LIPPXNIE.js";
+import {
+  loadMergedEnv
+} from "./chunk-QF22MYDJ.js";
+import "./chunk-N6MLQ26B.js";
+import {
+  parseArgs
+} from "./chunk-D424ZQGI.js";
+import {
+  daemonFetch
+} from "./chunk-23L3MKEV.js";
+import {
+  resolveAgent
+} from "./chunk-DP2DX4WV.js";
+import "./chunk-K3NQKI34.js";
+
+// src/commands/send.ts
+import { userInfo } from "os";
+
+// src/lib/parse-target.ts
+function parseTarget(target) {
+  const colonIdx = target.indexOf(":");
+  if (colonIdx !== -1) {
+    const platform = target.slice(0, colonIdx);
+    const identifier = target.slice(colonIdx + 1);
+    return {
+      platform,
+      identifier,
+      uri: target,
+      isDM: identifier.startsWith("@")
+    };
+  }
+  if (target.startsWith("@")) {
+    return {
+      platform: "volute",
+      identifier: target,
+      uri: `volute:${target}`,
+      isDM: true
+    };
+  }
+  return {
+    platform: "volute",
+    identifier: target,
+    uri: `volute:${target}`,
+    isDM: false
+  };
+}
+
+// src/lib/read-stdin.ts
+import { isatty } from "tty";
+async function readStdin() {
+  if (isatty(0)) return void 0;
+  const chunks = [];
+  try {
+    for await (const chunk of process.stdin) {
+      chunks.push(chunk);
+    }
+  } catch (err) {
+    console.error(`Failed to read from stdin: ${err instanceof Error ? err.message : String(err)}`);
+    process.exit(1);
+  }
+  const text = Buffer.concat(chunks).toString().replace(/\r?\n$/, "");
+  return text || void 0;
+}
+
+// src/commands/send.ts
+async function run(args) {
+  const { positional, flags } = parseArgs(args, {
+    agent: { type: "string" }
+  });
+  const target = positional[0];
+  const message = positional[1] ?? await readStdin();
+  if (!target || !message) {
+    console.error('Usage: volute send <target> "<message>" [--agent <name>]');
+    console.error('       echo "message" | volute send <target> [--agent <name>]');
+    console.error("");
+    console.error("Examples:");
+    console.error('  volute send @other-agent "hello"');
+    console.error('  volute send animal-chat "hello everyone"');
+    console.error('  volute send discord:server/channel "hello"');
+    process.exit(1);
+  }
+  const parsed = parseTarget(target);
+  const driver = getChannelDriver(parsed.platform);
+  if (!driver) {
+    console.error(`No driver for platform: ${parsed.platform}`);
+    process.exit(1);
+  }
+  let channelUri = parsed.uri;
+  if (parsed.isDM && parsed.platform === "volute") {
+    const targetName = parsed.identifier.slice(1);
+    const agentSelf = process.env.VOLUTE_AGENT;
+    const sender = agentSelf || userInfo().username;
+    if (!driver.createConversation) {
+      console.error("Volute driver does not support creating conversations");
+      process.exit(1);
+    }
+    const env = {
+      VOLUTE_AGENT: targetName,
+      VOLUTE_SENDER: sender
+    };
+    try {
+      channelUri = await driver.createConversation(env, [sender]);
+    } catch (err) {
+      console.error(err instanceof Error ? err.message : String(err));
+      process.exit(1);
+    }
+    try {
+      await driver.send(env, channelUri, message);
+      console.log("Message sent.");
+    } catch (err) {
+      console.error(err instanceof Error ? err.message : String(err));
+      process.exit(1);
+    }
+    if (agentSelf) {
+      try {
+        await daemonFetch(`/api/agents/${encodeURIComponent(agentSelf)}/history`, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ channel: channelUri, content: message })
+        });
+      } catch (err) {
+        console.error(`Failed to persist to history: ${err instanceof Error ? err.message : err}`);
+      }
+    }
+  } else {
+    const agentName = resolveAgentName(flags);
+    const { dir } = resolveAgent(agentName);
+    const env = {
+      ...loadMergedEnv(agentName),
+      VOLUTE_AGENT: agentName,
+      VOLUTE_AGENT_DIR: dir
+    };
+    try {
+      await driver.send(env, channelUri, message);
+      console.log("Message sent.");
+    } catch (err) {
+      console.error(err instanceof Error ? err.message : String(err));
+      process.exit(1);
+    }
+    if (process.env.VOLUTE_AGENT) {
+      try {
+        await daemonFetch(`/api/agents/${encodeURIComponent(agentName)}/history`, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ channel: channelUri, content: message })
+        });
+      } catch (err) {
+        console.error(`Failed to persist to history: ${err instanceof Error ? err.message : err}`);
+      }
+    }
+  }
+}
+export {
+  run
+};

package/dist/{service-HZNIDNJF.js → service-XCADRKIS.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-D424ZQGI.js";
 import {
   resolveVoluteBin
-} from "./chunk-5SKQ6J7T.js";
+} from "./chunk-5C5JWR2L.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/service.ts
@@ -82,6 +82,13 @@ async function install(port, host) {
     await execFileAsync("launchctl", ["load", path]);
     console.log("Service installed and loaded. Volute daemon will start on login.");
   } else if (platform === "linux") {
+    if (process.getuid?.() === 0) {
+      console.error(
+        "Error: `volute service install` uses systemd user services, which don't work as root."
+      );
+      console.error("Use `volute setup` instead to install a system-level service.");
+      process.exit(1);
+    }
     const path = unitPath();
     mkdirSync(resolve(homedir(), ".config", "systemd", "user"), { recursive: true });
     writeFileSync(path, generateUnit(voluteBin, port, host));

package/dist/{setup-F4TCWVSP.js → setup-32KH5KLN.js}

@@ -4,44 +4,73 @@ import {
 } from "./chunk-D424ZQGI.js";
 import {
   ensureVoluteGroup
-} from "./chunk-W76KWE23.js";
+} from "./chunk-IQXBMFZG.js";
 import {
   resolveVoluteBin
-} from "./chunk-5SKQ6J7T.js";
-import "./chunk-UWHWAPGO.js";
+} from "./chunk-5C5JWR2L.js";
+import "./chunk-DP2DX4WV.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/setup.ts
 import { execFileSync } from "child_process";
 import { existsSync, mkdirSync, rmSync, unlinkSync, writeFileSync } from "fs";
+import { homedir } from "os";
+import { dirname } from "path";
 var SERVICE_NAME = "volute.service";
 var SERVICE_PATH = `/etc/systemd/system/${SERVICE_NAME}`;
 var DATA_DIR = "/var/lib/volute";
+var AGENTS_DIR = "/agents";
 var HOST_RE = /^[a-zA-Z0-9.:_-]+$/;
 function validateHost(host) {
   if (!HOST_RE.test(host)) {
     throw new Error(`Invalid host: ${host}`);
   }
 }
+function buildServicePath(voluteBin) {
+  const binDir = dirname(voluteBin);
+  const standardPaths = [
+    "/usr/local/sbin",
+    "/usr/local/bin",
+    "/usr/sbin",
+    "/usr/bin",
+    "/sbin",
+    "/bin"
+  ];
+  const parts = standardPaths.includes(binDir) ? standardPaths : [binDir, ...standardPaths];
+  return parts.join(":");
+}
 function generateUnit(voluteBin, port, host) {
   const args = ["up", "--foreground"];
   if (port != null) args.push("--port", String(port));
   if (host) args.push("--host", host);
-  return `[Unit]
-Description=Volute Agent Manager
-After=network.target
-
-[Service]
-Type=exec
-ExecStart=${voluteBin} ${args.join(" ")}
-Environment=VOLUTE_HOME=${DATA_DIR}
-Environment=VOLUTE_ISOLATION=user
-Restart=on-failure
-RestartSec=5
-
-[Install]
-WantedBy=multi-user.target
-`;
+  const home = homedir();
+  const binUnderHome = voluteBin.startsWith(`${home}/`);
+  const lines = [
+    "[Unit]",
+    "Description=Volute Agent Manager",
+    "After=network.target",
+    "",
+    "[Service]",
+    "Type=exec",
+    `ExecStart=${voluteBin} ${args.join(" ")}`,
+    `Environment=PATH=${buildServicePath(voluteBin)}`,
+    `Environment=VOLUTE_HOME=${DATA_DIR}`,
+    `Environment=VOLUTE_AGENTS_DIR=${AGENTS_DIR}`,
+    "Environment=VOLUTE_ISOLATION=user",
+    "Restart=on-failure",
+    "RestartSec=5",
+    "ProtectSystem=strict",
+    `ReadWritePaths=${DATA_DIR} ${AGENTS_DIR}`,
+    "PrivateTmp=yes"
+  ];
+  if (!binUnderHome) {
+    lines.push("ProtectHome=yes");
+  } else {
+    console.warn(`Warning: ProtectHome=yes omitted because volute binary is under ${home}.`);
+    console.warn("Consider installing Node.js system-wide for stronger sandboxing.");
+  }
+  lines.push("RestrictSUIDSGID=yes", "", "[Install]", "WantedBy=multi-user.target", "");
+  return lines.join("\n");
 }
 function install(port, host) {
   if (host) validateHost(host);
@@ -57,18 +86,39 @@ function install(port, host) {
   const voluteBin = resolveVoluteBin();
   mkdirSync(DATA_DIR, { recursive: true });
   console.log(`Created ${DATA_DIR}`);
+  mkdirSync(AGENTS_DIR, { recursive: true });
+  console.log(`Created ${AGENTS_DIR}`);
   ensureVoluteGroup({ force: true });
   console.log("Ensured volute group exists");
   execFileSync("chmod", ["755", DATA_DIR]);
-  console.log("Set permissions on data directory");
+  execFileSync("chmod", ["755", AGENTS_DIR]);
+  console.log("Set permissions on directories");
   writeFileSync(SERVICE_PATH, generateUnit(voluteBin, port, host ?? "0.0.0.0"));
   console.log(`Wrote ${SERVICE_PATH}`);
-  execFileSync("systemctl", ["daemon-reload"]);
-  execFileSync("systemctl", ["enable", "--now", SERVICE_NAME]);
-  console.log("Service installed, enabled, and started.");
-  console.log(`
+  try {
+    execFileSync("systemctl", ["daemon-reload"]);
+  } catch (err) {
+    const e = err;
+    console.error(`Failed to reload systemd after writing ${SERVICE_PATH}.`);
+    if (e.stderr) console.error(e.stderr.toString().trim());
+    console.error(
+      "Try running `systemctl daemon-reload` manually, then `systemctl enable --now volute`."
+    );
+    process.exit(1);
+  }
+  try {
+    execFileSync("systemctl", ["enable", "--now", SERVICE_NAME]);
+    console.log("Service installed, enabled, and started.");
+    console.log(`
 Volute daemon is running. Data directory: ${DATA_DIR}`);
-  console.log("Use `systemctl status volute` to check status.");
+    console.log("Use `systemctl status volute` to check status.");
+  } catch (err) {
+    const e = err;
+    console.error("Service installed but failed to start.");
+    if (e.stderr) console.error(e.stderr.toString().trim());
+    console.error("Check `journalctl -xeu volute.service` for details.");
+    process.exit(1);
+  }
 }
 function uninstall(force) {
   if (process.getuid?.() !== 0) {
@@ -97,10 +147,15 @@ function uninstall(force) {
       const members = output.split(":")[3]?.trim();
       if (members) {
         for (const user of members.split(",")) {
+          const u = user.trim();
           try {
-            execFileSync("userdel", [user.trim()], { stdio: "ignore" });
+            execFileSync("userdel", [u], { stdio: "ignore" });
+          } catch {
+            console.warn(`Warning: failed to remove user ${u}`);
+          }
+          try {
+            execFileSync("groupdel", [u], { stdio: "ignore" });
           } catch {
-            console.warn(`Warning: failed to remove user ${user.trim()}`);
           }
         }
       }
@@ -110,6 +165,10 @@ function uninstall(force) {
       rmSync(DATA_DIR, { recursive: true, force: true });
       console.log(`Deleted ${DATA_DIR}`);
     }
+    if (existsSync(AGENTS_DIR)) {
+      rmSync(AGENTS_DIR, { recursive: true, force: true });
+      console.log(`Deleted ${AGENTS_DIR}`);
+    }
     try {
       execFileSync("groupdel", ["volute"], { stdio: "ignore" });
       console.log("Removed volute group");

package/dist/{start-VHQ7LNWM.js → start-QU73YTJW.js}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   daemonFetch
-} from "./chunk-JR4UXCTO.js";
+} from "./chunk-23L3MKEV.js";
 import {
   resolveAgent
-} from "./chunk-UWHWAPGO.js";
+} from "./chunk-DP2DX4WV.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/start.ts

package/dist/{status-QAJWXKMZ.js → status-Q6ZQJXNI.js}

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
   daemonFetch
-} from "./chunk-JR4UXCTO.js";
-import "./chunk-UWHWAPGO.js";
+} from "./chunk-23L3MKEV.js";
+import "./chunk-DP2DX4WV.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/status.ts

package/dist/{stop-CAGCT5NI.js → stop-N7U5N6A7.js}

@@ -4,10 +4,10 @@ import {
 } from "./chunk-AZEL2IEK.js";
 import {
   daemonFetch
-} from "./chunk-JR4UXCTO.js";
+} from "./chunk-23L3MKEV.js";
 import {
   resolveAgent
-} from "./chunk-UWHWAPGO.js";
+} from "./chunk-DP2DX4WV.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/stop.ts

package/dist/{up-RWZF6MLT.js → up-V6EAA7OZ.js}

@@ -2,9 +2,9 @@
 import {
   readGlobalConfig,
   run
-} from "./chunk-EG45HBSJ.js";
+} from "./chunk-XSJ27WEM.js";
 import "./chunk-D424ZQGI.js";
-import "./chunk-UWHWAPGO.js";
+import "./chunk-DP2DX4WV.js";
 import "./chunk-K3NQKI34.js";
 export {
   readGlobalConfig,

package/dist/{update-F7QWV2LB.js → update-EUCZ7XGG.js}

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import {
   checkForUpdate
-} from "./chunk-NKXULRSW.js";
+} from "./chunk-RT6Y7AR3.js";
 import {
   execInherit,
   resolveVoluteBin
-} from "./chunk-5SKQ6J7T.js";
+} from "./chunk-5C5JWR2L.js";
 import {
   voluteHome
-} from "./chunk-UWHWAPGO.js";
+} from "./chunk-DP2DX4WV.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/update.ts

package/dist/{update-check-B4J6IEQ4.js → update-check-SM4244SU.js}

@@ -5,8 +5,8 @@ import {
   fetchLatestVersion,
   getCurrentVersion,
   isNewer
-} from "./chunk-NKXULRSW.js";
-import "./chunk-UWHWAPGO.js";
+} from "./chunk-RT6Y7AR3.js";
+import "./chunk-DP2DX4WV.js";
 import "./chunk-K3NQKI34.js";
 export {
   checkForUpdate,