volute 0.4.0 → 0.5.0

package/dist/{delete-55MXCEY5.js → delete-3QH7VYIN.js}

@@ -1,16 +1,19 @@
 #!/usr/bin/env node
+import {
+  resolveAgentName
+} from "./chunk-AZEL2IEK.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
 import {
   deleteAgentUser
-} from "./chunk-SOZA2TLP.js";
+} from "./chunk-UAVD2AHX.js";
 import {
   agentDir,
   findAgent,
   removeAgent,
   removeAllVariants
-} from "./chunk-3C2XR4IY.js";
+} from "./chunk-UX25Z2ND.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/delete.ts
@@ -19,18 +22,14 @@ async function run(args) {
   const { positional, flags } = parseArgs(args, {
     force: { type: "boolean" }
   });
-  const name = positional[0];
-  if (!name) {
-    console.error("Usage: volute delete <name> [--force]");
-    process.exit(1);
-  }
+  const name = resolveAgentName({ agent: positional[0] });
   const entry = findAgent(name);
   if (!entry) {
     console.error(`Unknown agent: ${name}`);
     process.exit(1);
   }
   try {
-    const { daemonFetch } = await import("./daemon-client-XR24PUJF.js");
+    const { daemonFetch } = await import("./daemon-client-ZY6UUN2M.js");
     const res = await daemonFetch(`/api/agents/${encodeURIComponent(name)}/stop`, {
       method: "POST"
     });

package/dist/{down-3OB6UVAJ.js → down-O7IFZLVJ.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   voluteHome
-} from "./chunk-3C2XR4IY.js";
+} from "./chunk-UX25Z2ND.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/down.ts

package/dist/{env-JB27UAC3.js → env-4D4REPJF.js}

@@ -5,13 +5,13 @@ import {
   readEnv,
   sharedEnvPath,
   writeEnv
-} from "./chunk-DNOXHLE5.js";
+} from "./chunk-HE67X4T6.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
 import {
   resolveAgent
-} from "./chunk-3C2XR4IY.js";
+} from "./chunk-UX25Z2ND.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/env.ts
@@ -153,12 +153,15 @@ async function run(args) {
       console.log(`Removed ${key} [${scope}]`);
       break;
     }
+    case "--help":
+    case "-h":
+    case void 0:
+      console.log(`Usage: volute env <set|get|list|remove> [--agent <name>]`);
+      break;
     default:
       console.error(`Usage: volute env <set|get|list|remove> [--agent <name>]`);
-      if (subcommand) {
-        console.error(`
+      console.error(`
 Unknown subcommand: ${subcommand}`);
-      }
       process.exit(1);
   }
 }

package/dist/{history-BKG74I43.js → history-OEONB53Z.js}

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import {
   resolveAgentName
-} from "./chunk-VRVVQIYY.js";
+} from "./chunk-AZEL2IEK.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
 import {
   daemonFetch
-} from "./chunk-YGFIWIOF.js";
-import "./chunk-3C2XR4IY.js";
+} from "./chunk-7L4AN5D4.js";
+import "./chunk-UX25Z2ND.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/history.ts

package/dist/{import-4CI2ZUTJ.js → import-MXJB2EII.js}

@@ -7,25 +7,25 @@ import {
   agentEnvPath,
   readEnv,
   writeEnv
-} from "./chunk-DNOXHLE5.js";
+} from "./chunk-HE67X4T6.js";
 import {
   composeTemplate,
   copyTemplateToDir,
   findTemplatesRoot
-} from "./chunk-GSPKUPKU.js";
+} from "./chunk-XUA3JUFK.js";
+import {
+  parseArgs
+} from "./chunk-D424ZQGI.js";
 import {
   exec,
   execInherit
 } from "./chunk-5SKQ6J7T.js";
-import {
-  parseArgs
-} from "./chunk-D424ZQGI.js";
 import {
   addAgent,
   agentDir,
   ensureVoluteHome,
   nextPort
-} from "./chunk-3C2XR4IY.js";
+} from "./chunk-UX25Z2ND.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/import.ts
@@ -394,7 +394,7 @@ ${user.trimEnd()}
   console.log(`
 Imported agent: ${name} (port ${port})`);
   console.log(`
-  volute start ${name}`);
+  volute agent start ${name}`);
 }
 function resolveWorkspace(explicitPath) {
   if (explicitPath) {
@@ -416,7 +416,7 @@ function resolveWorkspace(explicitPath) {
     return openclawWs;
   }
   console.error(
-    "Usage: volute import [<workspace-path>] [--name <name>] [--session <path>] [--template <name>]\n\nNo OpenClaw workspace found. Provide a path, run from a workspace, or ensure ~/.openclaw/workspace exists."
+    "Usage: volute agent import [<workspace-path>] [--name <name>] [--session <path>] [--template <name>]\n\nNo OpenClaw workspace found. Provide a path, run from a workspace, or ensure ~/.openclaw/workspace exists."
   );
   process.exit(1);
 }

package/dist/{logs-NXFFGUKY.js → logs-DF342W4M.js}

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 import {
   resolveAgentName
-} from "./chunk-VRVVQIYY.js";
+} from "./chunk-AZEL2IEK.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
 import {
   resolveAgent
-} from "./chunk-3C2XR4IY.js";
+} from "./chunk-UX25Z2ND.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/logs.ts

package/dist/message-ADHWFHSI.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+import "./chunk-K3NQKI34.js";
+
+// src/commands/message.ts
+async function run(args) {
+  const subcommand = args[0];
+  switch (subcommand) {
+    case "send":
+      await import("./send-66QMKRUH.js").then((m) => m.run(args.slice(1)));
+      break;
+    case "history":
+      await import("./history-OEONB53Z.js").then((m) => m.run(args.slice(1)));
+      break;
+    case "--help":
+    case "-h":
+    case void 0:
+      printUsage();
+      break;
+    default:
+      printUsage();
+      process.exit(1);
+  }
+}
+function printUsage() {
+  console.log(`Usage:
+  volute message send <name> "<msg>"
+  echo "msg" | volute message send <name>
+  volute message history [--agent <name>] [--channel <ch>] [--limit N]`);
+}
+export {
+  run
+};

package/dist/{package-Z2SFO2SV.js → package-VQOE7JNH.js}

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

package/dist/{schedule-A35SH4HT.js → schedule-NAG6F463.js}

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import {
   resolveAgentName
-} from "./chunk-VRVVQIYY.js";
+} from "./chunk-AZEL2IEK.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
 import {
   daemonFetch
-} from "./chunk-YGFIWIOF.js";
-import "./chunk-3C2XR4IY.js";
+} from "./chunk-7L4AN5D4.js";
+import "./chunk-UX25Z2ND.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/schedule.ts
@@ -24,13 +24,18 @@ async function run(args) {
     case "remove":
       await removeSchedule(args.slice(1));
       break;
+    case "--help":
+    case "-h":
+    case void 0:
+      printUsage();
+      break;
     default:
       printUsage();
-      process.exit(subcommand ? 1 : 0);
+      process.exit(1);
   }
 }
 function printUsage() {
-  console.error(`Usage:
+  console.log(`Usage:
   volute schedule list [--agent <name>]
   volute schedule add [--agent <name>] --cron "..." --message "..." [--id name]
   volute schedule remove [--agent <name>] --id <id>`);

package/dist/send-66QMKRUH.js

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+import {
+  readStdin
+} from "./chunk-ZYGKG6VC.js";
+import {
+  summarizeTool
+} from "./chunk-B3R6L2GW.js";
+import {
+  daemonFetch
+} from "./chunk-7L4AN5D4.js";
+import "./chunk-UX25Z2ND.js";
+import "./chunk-K3NQKI34.js";
+
+// src/commands/send.ts
+import { userInfo } from "os";
+async function run(args) {
+  const name = args[0];
+  const message = args[1] ?? await readStdin();
+  if (!name || !message) {
+    console.error('Usage: volute message send <name> "<message>"');
+    console.error('       echo "message" | volute message send <name>');
+    process.exit(1);
+  }
+  const agentSelf = process.env.VOLUTE_AGENT;
+  const sender = agentSelf || userInfo().username;
+  const res = await daemonFetch(`/api/agents/${encodeURIComponent(name)}/chat`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ message, sender })
+  });
+  if (!res.ok) {
+    const data = await res.json();
+    console.error(data.error ?? `Failed to send message: ${res.status}`);
+    process.exit(1);
+  }
+  if (!res.body) {
+    console.error("No response body");
+    process.exit(1);
+  }
+  const reader = res.body.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  while (true) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    buffer += decoder.decode(value, { stream: true });
+    const lines = buffer.split("\n");
+    buffer = lines.pop() ?? "";
+    for (const line of lines) {
+      if (!line.startsWith("data:")) continue;
+      const data = line.slice(5).trim();
+      if (!data) continue;
+      let event;
+      try {
+        event = JSON.parse(data);
+      } catch {
+        continue;
+      }
+      if (event.type === "text") {
+        process.stdout.write(event.content);
+      } else if (event.type === "tool_use") {
+        process.stderr.write(`${summarizeTool(event.name, event.input)}
+`);
+      }
+      if (event.type === "done") {
+        process.stdout.write("\n");
+        return;
+      }
+    }
+  }
+  process.stdout.write("\n");
+}
+export {
+  run
+};

package/dist/{setup-2FDVN7OF.js → setup-RPRRGG2F.js}

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
-import {
-  resolveVoluteBin
-} from "./chunk-5SKQ6J7T.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
 import {
   ensureVoluteGroup
-} from "./chunk-SOZA2TLP.js";
-import "./chunk-3C2XR4IY.js";
+} from "./chunk-UAVD2AHX.js";
+import {
+  resolveVoluteBin
+} from "./chunk-5SKQ6J7T.js";
+import "./chunk-UX25Z2ND.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/setup.ts

package/dist/{start-LDPMCMYT.js → start-TUOXDSFL.js}

@@ -1,17 +1,17 @@
 #!/usr/bin/env node
 import {
   daemonFetch
-} from "./chunk-YGFIWIOF.js";
+} from "./chunk-7L4AN5D4.js";
 import {
   resolveAgent
-} from "./chunk-3C2XR4IY.js";
+} from "./chunk-UX25Z2ND.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/start.ts
 async function run(args) {
   const name = args[0];
   if (!name) {
-    console.error("Usage: volute start <name>");
+    console.error("Usage: volute agent start <name>");
     process.exit(1);
   }
   const { entry } = resolveAgent(name);

package/dist/{status-MVSQG54T.js → status-A36EHRO4.js}

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
   daemonFetch
-} from "./chunk-YGFIWIOF.js";
-import "./chunk-3C2XR4IY.js";
+} from "./chunk-7L4AN5D4.js";
+import "./chunk-UX25Z2ND.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/status.ts
@@ -17,7 +17,7 @@ async function run(args) {
     }
     const agents = await res2.json();
     if (agents.length === 0) {
-      console.log("No agents registered. Create one with: volute create <name>");
+      console.log("No agents registered. Create one with: volute agent create <name>");
       return;
     }
     const nameW = Math.max(4, ...agents.map((a) => a.name.length));

package/dist/{stop-5PZTZCLL.js → stop-AOJZLQ5X.js}

@@ -1,19 +1,18 @@
 #!/usr/bin/env node
+import {
+  resolveAgentName
+} from "./chunk-AZEL2IEK.js";
 import {
   daemonFetch
-} from "./chunk-YGFIWIOF.js";
+} from "./chunk-7L4AN5D4.js";
 import {
   resolveAgent
-} from "./chunk-3C2XR4IY.js";
+} from "./chunk-UX25Z2ND.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/stop.ts
 async function run(args) {
-  const name = args[0];
-  if (!name) {
-    console.error("Usage: volute stop <name>");
-    process.exit(1);
-  }
+  const name = resolveAgentName({ agent: args[0] });
   resolveAgent(name);
   const res = await daemonFetch(`/api/agents/${encodeURIComponent(name)}/stop`, {
     method: "POST"

package/dist/{up-F7TMTLRE.js → up-7ILD7GU7.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-D424ZQGI.js";
 import {
   voluteHome
-} from "./chunk-3C2XR4IY.js";
+} from "./chunk-UX25Z2ND.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/up.ts
@@ -58,7 +58,7 @@ async function run(args) {
     process.execPath,
     [daemonModule, "--port", String(port), "--host", hostname],
     {
-      stdio: ["ignore", logFd, logFd],
+      stdio: ["ignore", "ignore", logFd],
       detached: true
     }
   );

package/dist/update-LPSIAWQ2.js

@@ -0,0 +1,140 @@
+#!/usr/bin/env node
+import {
+  checkForUpdate
+} from "./chunk-5X7HGB6L.js";
+import {
+  execInherit,
+  resolveVoluteBin
+} from "./chunk-5SKQ6J7T.js";
+import {
+  voluteHome
+} from "./chunk-UX25Z2ND.js";
+import "./chunk-K3NQKI34.js";
+
+// src/commands/update.ts
+import { existsSync, readFileSync, unlinkSync } from "fs";
+import { resolve } from "path";
+async function run(_args) {
+  const result = await checkForUpdate();
+  if (result.checkFailed) {
+    console.error("Could not reach npm registry. Check your network connection and try again.");
+    process.exit(1);
+  }
+  console.log(`Current version: ${result.current}`);
+  console.log(`Latest version:  ${result.latest}`);
+  if (!result.updateAvailable) {
+    console.log("\nAlready up to date.");
+    return;
+  }
+  console.log(`
+Updating volute ${result.current} \u2192 ${result.latest}...`);
+  const home = voluteHome();
+  const pidPath = resolve(home, "daemon.pid");
+  const configPath = resolve(home, "daemon.json");
+  let daemonWasRunning = false;
+  let daemonPort = 4200;
+  let daemonHost = "127.0.0.1";
+  if (existsSync(pidPath)) {
+    const pid = parseInt(readFileSync(pidPath, "utf-8").trim(), 10);
+    try {
+      process.kill(pid, 0);
+      daemonWasRunning = true;
+    } catch {
+      try {
+        unlinkSync(pidPath);
+      } catch {
+      }
+    }
+  }
+  if (daemonWasRunning && existsSync(configPath)) {
+    try {
+      const config = JSON.parse(readFileSync(configPath, "utf-8"));
+      daemonPort = config.port ?? 4200;
+      daemonHost = config.hostname || "127.0.0.1";
+    } catch {
+      console.error("Warning: could not read daemon config, using default port/host");
+    }
+  }
+  if (daemonWasRunning) {
+    console.log("Stopping daemon...");
+    const pid = parseInt(readFileSync(pidPath, "utf-8").trim(), 10);
+    try {
+      process.kill(-pid, "SIGTERM");
+    } catch {
+      try {
+        process.kill(pid, "SIGTERM");
+      } catch {
+      }
+    }
+    const maxWait = 1e4;
+    const start = Date.now();
+    while (Date.now() - start < maxWait) {
+      if (!existsSync(pidPath)) break;
+      await new Promise((r) => setTimeout(r, 200));
+    }
+    if (existsSync(pidPath)) {
+      try {
+        process.kill(-pid, "SIGKILL");
+      } catch {
+        try {
+          process.kill(pid, "SIGKILL");
+        } catch {
+        }
+      }
+    }
+    if (existsSync(pidPath)) {
+      try {
+        const stalePid = parseInt(readFileSync(pidPath, "utf-8").trim(), 10);
+        process.kill(stalePid, 0);
+        console.error("Warning: daemon process may still be running. Aborting update.");
+        process.exit(1);
+      } catch {
+        try {
+          unlinkSync(pidPath);
+        } catch {
+        }
+      }
+    }
+    console.log("Daemon stopped.");
+  }
+  try {
+    await execInherit("npm", ["install", "-g", "volute@latest"]);
+  } catch (err) {
+    console.error(`
+Update failed: ${err.message}`);
+    if (daemonWasRunning) {
+      console.log("Restarting daemon with current version...");
+      try {
+        await execInherit(resolveVoluteBin(), [
+          "up",
+          "--port",
+          String(daemonPort),
+          "--host",
+          daemonHost
+        ]);
+      } catch {
+        console.error("Failed to restart daemon. Run `volute up` manually.");
+      }
+    }
+    process.exit(1);
+  }
+  if (daemonWasRunning) {
+    console.log("Restarting daemon...");
+    try {
+      await execInherit(resolveVoluteBin(), [
+        "up",
+        "--port",
+        String(daemonPort),
+        "--host",
+        daemonHost
+      ]);
+    } catch {
+      console.error("Failed to restart daemon. Run `volute up` manually.");
+    }
+  }
+  console.log(`
+Updated to volute v${result.latest}`);
+}
+export {
+  run
+};

package/dist/update-check-Y33QDCFL.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+import {
+  checkForUpdate,
+  checkForUpdateCached,
+  fetchLatestVersion,
+  getCurrentVersion,
+  isNewer
+} from "./chunk-5X7HGB6L.js";
+import "./chunk-UX25Z2ND.js";
+import "./chunk-K3NQKI34.js";
+export {
+  checkForUpdate,
+  checkForUpdateCached,
+  fetchLatestVersion,
+  getCurrentVersion,
+  isNewer
+};

package/dist/{upgrade-6ZW2RD64.js → upgrade-FX2TKJ2S.js}

@@ -1,24 +1,27 @@
 #!/usr/bin/env node
+import {
+  resolveAgentName
+} from "./chunk-AZEL2IEK.js";
 import {
   composeTemplate,
   copyTemplateToDir,
   findTemplatesRoot
-} from "./chunk-GSPKUPKU.js";
+} from "./chunk-XUA3JUFK.js";
+import {
+  parseArgs
+} from "./chunk-D424ZQGI.js";
 import {
   exec,
   execInherit
 } from "./chunk-5SKQ6J7T.js";
-import {
-  parseArgs
-} from "./chunk-D424ZQGI.js";
 import {
   daemonFetch
-} from "./chunk-YGFIWIOF.js";
+} from "./chunk-7L4AN5D4.js";
 import {
   addVariant,
   nextPort,
   resolveAgent
-} from "./chunk-3C2XR4IY.js";
+} from "./chunk-UX25Z2ND.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/upgrade.ts
@@ -31,11 +34,7 @@ async function run(args) {
     template: { type: "string" },
     continue: { type: "boolean" }
   });
-  const agentName = positional[0];
-  if (!agentName) {
-    console.error("Usage: volute upgrade <name> [--template <name>] [--continue]");
-    process.exit(1);
-  }
+  const agentName = resolveAgentName({ agent: positional[0] });
   const { dir: projectRoot } = resolveAgent(agentName);
   const template = flags.template ?? "agent-sdk";
   if (flags.continue) {
@@ -73,7 +72,7 @@ Otherwise, remove it with: volute variant delete ${VARIANT_NAME} --agent ${agent
     console.log(`  ${worktreeDir}`);
     console.log(`
 Then run:`);
-    console.log(`  volute upgrade ${agentName} --continue`);
+    console.log(`  volute agent upgrade ${agentName} --continue`);
     return;
   }
   await installAndVerify(agentName, worktreeDir);
@@ -164,7 +163,7 @@ async function mergeTemplateBranch(worktreeDir) {
 async function continueUpgrade(agentName, projectRoot) {
   const worktreeDir = resolve(projectRoot, ".variants", VARIANT_NAME);
   if (!existsSync(worktreeDir)) {
-    console.error("No upgrade in progress. Run `volute upgrade` first.");
+    console.error("No upgrade in progress. Run `volute agent upgrade` first.");
     process.exit(1);
   }
   const status = await exec("git", ["status", "--porcelain"], {
@@ -207,7 +206,7 @@ async function installAndVerify(agentName, worktreeDir) {
   } catch {
     console.error("Failed to start variant. Is the daemon running? (volute up)");
     console.error(
-      `The variant was created but not started. Use: volute start ${agentName}@${VARIANT_NAME}`
+      `The variant was created but not started. Use: volute agent start ${agentName}@${VARIANT_NAME}`
     );
     process.exit(1);
   }
@@ -215,7 +214,9 @@ async function installAndVerify(agentName, worktreeDir) {
 Upgrade variant running on port ${variantPort}`);
   console.log(`
 Next steps:`);
-  console.log(`  volute send ${agentName}@${VARIANT_NAME} "hello"    # chat with upgraded variant`);
+  console.log(
+    `  volute message send ${agentName}@${VARIANT_NAME} "hello"    # chat with upgraded variant`
+  );
   console.log(`  volute variant merge ${VARIANT_NAME}                # merge back when satisfied`);
 }
 export {