volute 0.7.0 → 0.8.1

package/README.md

@@ -23,7 +23,7 @@ volute agent create atlas
 volute agent start atlas
 
 # Talk to it
-volute message send atlas "hey, what can you do?"
+volute send @atlas "hey, what can you do?"
 ```
 
 You now have a running AI agent with persistent memory, auto-committing file changes, and session resume across restarts. Open `http://localhost:4200` for the web dashboard.
@@ -58,10 +58,10 @@ volute agent delete atlas --force   # also delete files
 ### Sending messages
 
 ```sh
-volute message send atlas "what's on your mind?"
+volute send @atlas "what's on your mind?"
 ```
 
-Responses stream back to your terminal in real time. The agent knows which channel each message came from — CLI, web, Discord, or system — and routes its response back to the source.
+The agent knows which channel each message came from — CLI, web, Discord, or system — and routes its response back to the source.
 
 ### Anatomy of an agent
 
@@ -95,7 +95,7 @@ This is the interesting part. Agents can fork themselves into isolated branches,
 volute variant create experiment --agent atlas
 
 # Talk to the variant directly
-volute message send atlas@experiment "try a different approach"
+volute send @atlas@experiment "try a different approach"
 
 # List all variants
 volute variant list --agent atlas
@@ -144,7 +144,7 @@ Read from and write to connector channels directly:
 
 ```sh
 volute channel read discord:123456789 --agent atlas         # recent messages
-volute channel send discord:123456789 "hello" --agent atlas # send a message
+volute send discord:123456789 "hello" --agent atlas        # send a message
 ```
 
 ## Schedules
@@ -152,12 +152,12 @@ volute channel send discord:123456789 "hello" --agent atlas # send a message
 Cron-based scheduled messages — daily check-ins, periodic tasks, whatever you need.
 
 ```sh
-volute schedule add atlas \
+volute schedule add --agent atlas \
   --cron "0 9 * * *" \
   --message "good morning — write your daily log"
 
-volute schedule list atlas
-volute schedule remove atlas --id <schedule-id>
+volute schedule list --agent atlas
+volute schedule remove --agent atlas --id <schedule-id>
 ```
 
 ## Environment variables
@@ -191,7 +191,7 @@ volute agent upgrade atlas          # creates an "upgrade" variant
 # resolve conflicts if needed, then:
 volute agent upgrade atlas --continue
 # test:
-volute message send atlas@upgrade "are you working?"
+volute send @atlas@upgrade "are you working?"
 # merge:
 volute variant merge upgrade --agent atlas
 ```
@@ -219,7 +219,7 @@ Set the model via `home/.config/volute.json` in the agent directory, or the `VOL
 
 ```sh
 docker build -t volute .
-docker run -d -p 4200:4200 -v volute-data:/data volute
+docker run -d -p 4200:4200 -v volute-data:/data -v volute-agents:/agents volute
 ```
 
 Or with docker-compose:
@@ -242,9 +242,11 @@ Or manually:
 
 ```sh
 npm install -g volute
-sudo volute setup --host 0.0.0.0
+sudo $(which volute) setup --host 0.0.0.0
 ```
 
+> **Note:** If you installed Node via nvm, `sudo volute` won't find the binary. Use `sudo $(which volute)` or `sudo su` then run `volute setup` directly.
+
 This installs a system-level systemd service with data at `/var/lib/volute` and user isolation enabled. Check status with `systemctl status volute`. Uninstall with `sudo volute setup uninstall --force`.
 
 ### Auto-start (user-level)
@@ -252,9 +254,9 @@ This installs a system-level systemd service with data at `/var/lib/volute` and
 On macOS or Linux (without root), use the user-level service installer:
 
 ```sh
-volute service install            # auto-start on login
-volute service status             # check status
-volute service uninstall          # remove
+volute service install [--port N] [--host H]   # auto-start on login
+volute service status                          # check status
+volute service uninstall                       # remove
 ```
 
 ## Development

package/dist/{agent-7JF7MT73.js → agent-YORVRB6I.js}

@@ -6,42 +6,42 @@ async function run(args) {
   const subcommand = args[0];
   switch (subcommand) {
     case "create":
-      await import("./create-G525LWEA.js").then((m) => m.run(args.slice(1)));
+      await import("./create-HGJHLABX.js").then((m) => m.run(args.slice(1)));
       break;
     case "start":
-      await import("./start-VHQ7LNWM.js").then((m) => m.run(args.slice(1)));
+      await import("./start-QU73YTJW.js").then((m) => m.run(args.slice(1)));
       break;
     case "stop":
-      await import("./stop-CAGCT5NI.js").then((m) => m.run(args.slice(1)));
+      await import("./stop-N7U5N6A7.js").then((m) => m.run(args.slice(1)));
       break;
     case "restart":
-      await import("./restart-O4ETYLJF.js").then((m) => m.run(args.slice(1)));
+      await import("./restart-KVH3TK5N.js").then((m) => m.run(args.slice(1)));
       break;
     case "delete":
-      await import("./delete-UOU4AFQN.js").then((m) => m.run(args.slice(1)));
+      await import("./delete-45TGQC4N.js").then((m) => m.run(args.slice(1)));
       break;
     case "list":
-      await import("./status-QAJWXKMZ.js").then((m) => m.run(args.slice(1)));
+      await import("./status-Q6ZQJXNI.js").then((m) => m.run(args.slice(1)));
       break;
     case "status": {
       const rest = args.slice(1);
       if (!rest[0] && process.env.VOLUTE_AGENT) {
         rest.unshift(process.env.VOLUTE_AGENT);
       }
-      await import("./status-QAJWXKMZ.js").then((m) => m.run(rest));
+      await import("./status-Q6ZQJXNI.js").then((m) => m.run(rest));
       break;
     }
     case "logs": {
       const rest = args.slice(1);
       const logsArgs = transformAgentFlag(rest);
-      await import("./logs-EDGK26AK.js").then((m) => m.run(logsArgs));
+      await import("./logs-TZB3MTLZ.js").then((m) => m.run(logsArgs));
       break;
     }
     case "upgrade":
-      await import("./upgrade-YXKPWDRU.js").then((m) => m.run(args.slice(1)));
+      await import("./upgrade-CZF6PN7Y.js").then((m) => m.run(args.slice(1)));
       break;
     case "import":
-      await import("./import-AVKQJDYC.js").then((m) => m.run(args.slice(1)));
+      await import("./import-CNEDF3TD.js").then((m) => m.run(args.slice(1)));
       break;
     case "--help":
     case "-h":

package/dist/{agent-manager-IMZ7ZMBF.js → agent-manager-CMMH5KQQ.js}

@@ -3,10 +3,10 @@ import {
   AgentManager,
   getAgentManager,
   initAgentManager
-} from "./chunk-62X577Y7.js";
-import "./chunk-H7AMDUIA.js";
-import "./chunk-W76KWE23.js";
-import "./chunk-UWHWAPGO.js";
+} from "./chunk-W6TMWYU3.js";
+import "./chunk-QF22MYDJ.js";
+import "./chunk-IQXBMFZG.js";
+import "./chunk-DP2DX4WV.js";
 import "./chunk-K3NQKI34.js";
 export {
   AgentManager,

package/dist/{channel-SMCNOIVQ.js → channel-RDGHBFSI.js}

@@ -1,29 +1,26 @@
 #!/usr/bin/env node
-import {
-  readStdin
-} from "./chunk-ZYGKG6VC.js";
 import {
   resolveAgentName
 } from "./chunk-AZEL2IEK.js";
 import {
   CHANNELS,
   getChannelDriver
-} from "./chunk-ZZOOTYXK.js";
+} from "./chunk-LIPPXNIE.js";
 import {
   loadMergedEnv
-} from "./chunk-H7AMDUIA.js";
+} from "./chunk-QF22MYDJ.js";
 import {
   writeChannelEntry
-} from "./chunk-BX7KI4S3.js";
+} from "./chunk-N6MLQ26B.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
 import {
   daemonFetch
-} from "./chunk-JR4UXCTO.js";
+} from "./chunk-23L3MKEV.js";
 import {
-  resolveAgent
-} from "./chunk-UWHWAPGO.js";
+  agentDir
+} from "./chunk-DP2DX4WV.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/channel.ts
@@ -33,9 +30,6 @@ async function run(args) {
     case "read":
       await readChannel(args.slice(1));
       break;
-    case "send":
-      await sendChannel(args.slice(1));
-      break;
     case "list":
       await listChannels(args.slice(1));
       break;
@@ -61,12 +55,10 @@ async function run(args) {
 function printUsage() {
   console.log(`Usage:
   volute channel read <channel-uri> [--limit N] [--agent <name>]
-  volute channel send <channel-uri> "<message>" [--agent <name>]
   volute channel list [<platform>] [--agent <name>]
   volute channel users <platform> [--agent <name>]
   volute channel create <platform> --participants user1,user2 [--name "..."] [--agent <name>]
-  volute channel typing <channel-uri> [--agent <name>]
-  echo "message" | volute channel send <channel-uri> [--agent <name>]`);
+  volute channel typing <channel-uri> [--agent <name>]`);
 }
 async function readChannel(args) {
   const { positional, flags } = parseArgs(args, {
@@ -81,8 +73,8 @@ async function readChannel(args) {
   const agentName = resolveAgentName(flags);
   const { platform } = parseUri(uri);
   const driver = requireDriver(platform);
-  const { dir } = resolveAgent(agentName);
-  const env = { ...loadMergedEnv(dir), VOLUTE_AGENT: agentName, VOLUTE_AGENT_DIR: dir };
+  const dir = agentDir(agentName);
+  const env = { ...loadMergedEnv(agentName), VOLUTE_AGENT: agentName, VOLUTE_AGENT_DIR: dir };
   try {
     const limit = flags.limit ?? 20;
     const output = await driver.read(env, uri, limit);
@@ -92,46 +84,14 @@ async function readChannel(args) {
     process.exit(1);
   }
 }
-async function sendChannel(args) {
-  const { positional, flags } = parseArgs(args, {
-    agent: { type: "string" }
-  });
-  const uri = positional[0];
-  const message = positional[1] ?? await readStdin();
-  if (!uri || !message) {
-    console.error('Usage: volute channel send <channel-uri> "<message>" [--agent <name>]');
-    console.error('       echo "message" | volute channel send <channel-uri> [--agent <name>]');
-    process.exit(1);
-  }
-  const agentName = resolveAgentName(flags);
-  const { platform } = parseUri(uri);
-  const driver = requireDriver(platform);
-  const { dir } = resolveAgent(agentName);
-  const env = { ...loadMergedEnv(dir), VOLUTE_AGENT: agentName, VOLUTE_AGENT_DIR: dir };
-  try {
-    await driver.send(env, uri, message);
-    try {
-      await daemonFetch(`/api/agents/${encodeURIComponent(agentName)}/history`, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ channel: uri, content: message })
-      });
-    } catch (err) {
-      console.error(`Failed to persist to history: ${err instanceof Error ? err.message : err}`);
-    }
-  } catch (err) {
-    console.error(err instanceof Error ? err.message : String(err));
-    process.exit(1);
-  }
-}
 async function listChannels(args) {
   const { positional, flags } = parseArgs(args, {
     agent: { type: "string" }
   });
   const platform = positional[0];
   const agentName = resolveAgentName(flags);
-  const { dir } = resolveAgent(agentName);
-  const env = { ...loadMergedEnv(dir), VOLUTE_AGENT: agentName, VOLUTE_AGENT_DIR: dir };
+  const dir = agentDir(agentName);
+  const env = { ...loadMergedEnv(agentName), VOLUTE_AGENT: agentName, VOLUTE_AGENT_DIR: dir };
   const platforms = platform ? [platform] : Object.keys(CHANNELS);
   for (const p of platforms) {
     const driver = getChannelDriver(p);
@@ -139,7 +99,7 @@ async function listChannels(args) {
     try {
       const convs = await driver.listConversations(env);
       for (const conv of convs) {
-        writeChannelEntry(dir, conv.id, {
+        writeChannelEntry(agentName, conv.id, {
           platformId: conv.platformId,
           platform: p,
           name: conv.name,
@@ -171,8 +131,8 @@ async function listUsers(args) {
     process.exit(1);
   }
   const agentName = resolveAgentName(flags);
-  const { dir } = resolveAgent(agentName);
-  const env = { ...loadMergedEnv(dir), VOLUTE_AGENT: agentName, VOLUTE_AGENT_DIR: dir };
+  const dir = agentDir(agentName);
+  const env = { ...loadMergedEnv(agentName), VOLUTE_AGENT: agentName, VOLUTE_AGENT_DIR: dir };
   try {
     const users = await driver.listUsers(env);
     for (const user of users) {
@@ -202,8 +162,8 @@ async function createChannel(args) {
     process.exit(1);
   }
   const agentName = resolveAgentName(flags);
-  const { dir } = resolveAgent(agentName);
-  const env = { ...loadMergedEnv(dir), VOLUTE_AGENT: agentName, VOLUTE_AGENT_DIR: dir };
+  const dir = agentDir(agentName);
+  const env = { ...loadMergedEnv(agentName), VOLUTE_AGENT: agentName, VOLUTE_AGENT_DIR: dir };
   const participants = flags.participants.split(",").map((s) => s.trim());
   try {
     const slug = await driver.createConversation(env, participants, flags.name);

package/dist/{chunk-JR4UXCTO.js → chunk-23L3MKEV.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   voluteHome
-} from "./chunk-UWHWAPGO.js";
+} from "./chunk-DP2DX4WV.js";
 
 // src/lib/daemon-client.ts
 import { existsSync, readFileSync } from "fs";

package/dist/{chunk-5SKQ6J7T.js → chunk-5C5JWR2L.js}

@@ -4,14 +4,19 @@
 import { execFile as execFileCb, execFileSync, spawn } from "child_process";
 function exec(cmd, args, options) {
   return new Promise((resolve, reject) => {
-    execFileCb(cmd, args, { cwd: options?.cwd }, (err, stdout, stderr) => {
-      if (err) {
-        err.stderr = stderr;
-        reject(err);
-      } else {
-        resolve(stdout);
+    execFileCb(
+      cmd,
+      args,
+      { cwd: options?.cwd, uid: options?.uid, gid: options?.gid, env: options?.env },
+      (err, stdout, stderr) => {
+        if (err) {
+          err.stderr = stderr;
+          reject(err);
+        } else {
+          resolve(stdout);
+        }
       }
-    });
+    );
   });
 }
 function resolveVoluteBin() {
@@ -25,6 +30,9 @@ function execInherit(cmd, args, options) {
   return new Promise((resolve, reject) => {
     const child = spawn(cmd, args, {
       cwd: options?.cwd,
+      uid: options?.uid,
+      gid: options?.gid,
+      env: options?.env,
       stdio: "inherit"
     });
     child.on("error", reject);

package/dist/{chunk-UWHWAPGO.js → chunk-DP2DX4WV.js}

@@ -20,7 +20,8 @@ function voluteHome() {
   return resolve(homedir(), ".volute");
 }
 function ensureVoluteHome() {
-  mkdirSync(resolve(voluteHome(), "agents"), { recursive: true });
+  const agentsBase = process.env.VOLUTE_AGENTS_DIR ?? resolve(voluteHome(), "agents");
+  mkdirSync(agentsBase, { recursive: true });
 }
 function readRegistry() {
   const registryPath = resolve(voluteHome(), "agents.json");
@@ -75,8 +76,14 @@ function findAgent(name) {
   return readRegistry().find((e) => e.name === name);
 }
 function agentDir(name) {
+  if (process.env.VOLUTE_AGENTS_DIR) {
+    return resolve(process.env.VOLUTE_AGENTS_DIR, name);
+  }
   return resolve(voluteHome(), "agents", name);
 }
+function stateDir(name) {
+  return resolve(voluteHome(), "state", name);
+}
 function nextPort() {
   const entries = readRegistry();
   const usedPorts = new Set(entries.map((e) => e.port));
@@ -232,6 +239,7 @@ export {
   setAgentRunning,
   findAgent,
   agentDir,
+  stateDir,
   nextPort,
   daemonLoopback,
   resolveAgent

package/dist/{chunk-7ACDT3P2.js → chunk-ECPQXRLB.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   voluteHome
-} from "./chunk-UWHWAPGO.js";
+} from "./chunk-DP2DX4WV.js";
 import {
   __export
 } from "./chunk-K3NQKI34.js";
@@ -60,7 +60,6 @@ var agentMessages = sqliteTable(
     id: integer("id").primaryKey({ autoIncrement: true }),
     agent: text("agent").notNull(),
     channel: text("channel").notNull(),
-    role: text("role").notNull(),
     sender: text("sender"),
     content: text("content").notNull(),
     created_at: text("created_at").notNull().default(sql`(datetime('now'))`)

package/dist/{chunk-LLJNZPCU.js → chunk-HZ5LTOEJ.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   voluteHome
-} from "./chunk-UWHWAPGO.js";
+} from "./chunk-DP2DX4WV.js";
 
 // src/commands/down.ts
 import { existsSync, readFileSync, unlinkSync } from "fs";

package/dist/{chunk-W76KWE23.js → chunk-IQXBMFZG.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   validateAgentName
-} from "./chunk-UWHWAPGO.js";
+} from "./chunk-DP2DX4WV.js";
 
 // src/lib/isolation.ts
 import { execFile, execFileSync } from "child_process";
@@ -13,7 +13,7 @@ function isIsolationEnabled() {
 function agentUserName(agentName) {
   const err = validateAgentName(agentName);
   if (err) throw new Error(`Invalid agent name for isolation: ${err}`);
-  const prefix = process.env.VOLUTE_USER_PREFIX ?? "volute-";
+  const prefix = process.env.VOLUTE_USER_PREFIX ?? "agent-";
   return `${prefix}${agentName}`;
 }
 function ensureVoluteGroup(opts) {
@@ -37,7 +37,7 @@ function createAgentUser(name) {
   } catch {
   }
   try {
-    execFileSync("useradd", ["-r", "-M", "-g", "volute", "-s", "/usr/sbin/nologin", user], {
+    execFileSync("useradd", ["-r", "-M", "-G", "volute", "-s", "/usr/sbin/nologin", user], {
       stdio: "ignore"
     });
   } catch (err) {
@@ -68,14 +68,16 @@ async function applyIsolation(spawnOpts, agentName) {
 function chownAgentDir(dir, name) {
   if (!isIsolationEnabled()) return;
   const user = agentUserName(name);
-  execFileSync("chown", ["-R", `${user}:volute`, dir]);
+  execFileSync("chown", ["-R", `${user}:${user}`, dir]);
   execFileSync("chmod", ["700", dir]);
 }
 
 export {
+  isIsolationEnabled,
   ensureVoluteGroup,
   createAgentUser,
   deleteAgentUser,
+  getAgentUserIds,
   applyIsolation,
   chownAgentDir
 };