volute 0.4.0 → 0.6.0

package/dist/{delete-55MXCEY5.js → delete-2PH2CGDY.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-W76KWE23.js";
 import {
   agentDir,
   findAgent,
   removeAgent,
   removeAllVariants
-} from "./chunk-3C2XR4IY.js";
+} from "./chunk-UWHWAPGO.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-442IV43D.js");
     const res = await daemonFetch(`/api/agents/${encodeURIComponent(name)}/stop`, {
       method: "POST"
     });

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

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

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

@@ -5,13 +5,13 @@ import {
   readEnv,
   sharedEnvPath,
   writeEnv
-} from "./chunk-DNOXHLE5.js";
+} from "./chunk-H7AMDUIA.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
 import {
   resolveAgent
-} from "./chunk-3C2XR4IY.js";
+} from "./chunk-UWHWAPGO.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-H72ZUIBN.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-JR4UXCTO.js";
+import "./chunk-UWHWAPGO.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/history.ts

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

@@ -7,25 +7,25 @@ import {
   agentEnvPath,
   readEnv,
   writeEnv
-} from "./chunk-DNOXHLE5.js";
+} from "./chunk-H7AMDUIA.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-UWHWAPGO.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-EDGK26AK.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-UWHWAPGO.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/logs.ts

package/dist/message-SCOQDR3P.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-G7PE4DOJ.js").then((m) => m.run(args.slice(1)));
+      break;
+    case "history":
+      await import("./history-H72ZUIBN.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-4DP4Y4UO.js}

@@ -4,7 +4,7 @@ import "./chunk-K3NQKI34.js";
 // package.json
 var package_default = {
   name: "volute",
-  version: "0.4.0",
+  version: "0.6.0",
   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

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+import {
+  resolveAgentName
+} from "./chunk-AZEL2IEK.js";
+import {
+  daemonFetch
+} from "./chunk-JR4UXCTO.js";
+import {
+  resolveAgent
+} from "./chunk-UWHWAPGO.js";
+import "./chunk-K3NQKI34.js";
+
+// src/commands/restart.ts
+async function run(args) {
+  const name = resolveAgentName({ agent: args[0] });
+  const { entry } = resolveAgent(name);
+  const res = await daemonFetch(`/api/agents/${encodeURIComponent(name)}/restart`, {
+    method: "POST"
+  });
+  const data = await res.json();
+  if (!res.ok) {
+    console.error(data.error || "Failed to restart agent");
+    process.exit(1);
+  }
+  console.log(`${name} restarted on port ${entry.port}`);
+}
+export {
+  run
+};

package/dist/{schedule-A35SH4HT.js → schedule-S6QVC5ON.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-JR4UXCTO.js";
+import "./chunk-UWHWAPGO.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-G7PE4DOJ.js

@@ -0,0 +1,72 @@
+#!/usr/bin/env node
+import {
+  readStdin
+} from "./chunk-ZYGKG6VC.js";
+import {
+  summarizeTool
+} from "./chunk-B3R6L2GW.js";
+import {
+  getChannelDriver
+} from "./chunk-ZZOOTYXK.js";
+import "./chunk-BX7KI4S3.js";
+import {
+  daemonFetch
+} from "./chunk-JR4UXCTO.js";
+import "./chunk-UWHWAPGO.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 driver = getChannelDriver("volute");
+  if (!driver?.sendAndStream || !driver.createConversation) {
+    console.error("Volute driver not available");
+    process.exit(1);
+  }
+  const env = { VOLUTE_AGENT: name, VOLUTE_SENDER: sender };
+  let conversationId;
+  try {
+    conversationId = await driver.createConversation(env, [sender]);
+  } catch (err) {
+    console.error(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+  }
+  try {
+    for await (const event of driver.sendAndStream(env, conversationId, message)) {
+      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") break;
+    }
+    process.stdout.write("\n");
+  } 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: conversationId, content: message })
+      });
+    } catch (err) {
+      console.error(`Failed to persist to history: ${err instanceof Error ? err.message : err}`);
+    }
+  }
+}
+export {
+  run
+};

package/dist/{setup-2FDVN7OF.js → setup-F4TCWVSP.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-W76KWE23.js";
+import {
+  resolveVoluteBin
+} from "./chunk-5SKQ6J7T.js";
+import "./chunk-UWHWAPGO.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/setup.ts

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

@@ -1,17 +1,17 @@
 #!/usr/bin/env node
 import {
   daemonFetch
-} from "./chunk-YGFIWIOF.js";
+} from "./chunk-JR4UXCTO.js";
 import {
   resolveAgent
-} from "./chunk-3C2XR4IY.js";
+} from "./chunk-UWHWAPGO.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-QAJWXKMZ.js}

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
   daemonFetch
-} from "./chunk-YGFIWIOF.js";
-import "./chunk-3C2XR4IY.js";
+} from "./chunk-JR4UXCTO.js";
+import "./chunk-UWHWAPGO.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-CAGCT5NI.js}

@@ -1,19 +1,18 @@
 #!/usr/bin/env node
+import {
+  resolveAgentName
+} from "./chunk-AZEL2IEK.js";
 import {
   daemonFetch
-} from "./chunk-YGFIWIOF.js";
+} from "./chunk-JR4UXCTO.js";
 import {
   resolveAgent
-} from "./chunk-3C2XR4IY.js";
+} from "./chunk-UWHWAPGO.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-CSX3ZUIU.js}

@@ -4,21 +4,32 @@ import {
 } from "./chunk-D424ZQGI.js";
 import {
   voluteHome
-} from "./chunk-3C2XR4IY.js";
+} from "./chunk-UWHWAPGO.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/up.ts
 import { spawn } from "child_process";
 import { existsSync, mkdirSync, openSync, readFileSync } from "fs";
 import { dirname, resolve } from "path";
+function readGlobalConfig() {
+  const configPath = resolve(voluteHome(), "config.json");
+  if (!existsSync(configPath)) return {};
+  try {
+    return JSON.parse(readFileSync(configPath, "utf-8"));
+  } catch (err) {
+    console.error(`Invalid config file ${configPath}: ${err instanceof Error ? err.message : err}`);
+    process.exit(1);
+  }
+}
 async function run(args) {
   const { flags } = parseArgs(args, {
     port: { type: "number" },
     host: { type: "string" },
     foreground: { type: "boolean" }
   });
-  const port = flags.port ?? 4200;
-  const hostname = flags.host ?? "127.0.0.1";
+  const config = readGlobalConfig();
+  const port = flags.port ?? config.port ?? 4200;
+  const hostname = flags.host ?? config.hostname ?? "127.0.0.1";
   const home = voluteHome();
   const pidPath = resolve(home, "daemon.pid");
   if (existsSync(pidPath)) {
@@ -58,7 +69,7 @@ async function run(args) {
     process.execPath,
     [daemonModule, "--port", String(port), "--host", hostname],
     {
-      stdio: ["ignore", logFd, logFd],
+      stdio: ["ignore", "ignore", logFd],
       detached: true
     }
   );
@@ -93,5 +104,6 @@ async function run(args) {
   process.exit(1);
 }
 export {
+  readGlobalConfig,
   run
 };

package/dist/update-XSIX3GGP.js

@@ -0,0 +1,140 @@
+#!/usr/bin/env node
+import {
+  checkForUpdate
+} from "./chunk-AOKAQGO4.js";
+import {
+  execInherit,
+  resolveVoluteBin
+} from "./chunk-5SKQ6J7T.js";
+import {
+  voluteHome
+} from "./chunk-UWHWAPGO.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-5ZADDHCK.js

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