volute 0.2.1 → 0.3.1

package/dist/cli.js

@@ -5,92 +5,98 @@ var command = process.argv[2];
 var args = process.argv.slice(3);
 switch (command) {
   case "create":
-    await import("./create-23AM7H5B.js").then((m) => m.run(args));
+    await import("./create-BRG2DBWI.js").then((m) => m.run(args));
     break;
   case "start":
-    await import("./start-AG7QLULK.js").then((m) => m.run(args));
+    await import("./start-LDPMCMYT.js").then((m) => m.run(args));
     break;
   case "stop":
-    await import("./stop-IL5Q6NER.js").then((m) => m.run(args));
+    await import("./stop-5PZTZCLL.js").then((m) => m.run(args));
     break;
   case "logs":
-    await import("./logs-SYRQOL6B.js").then((m) => m.run(args));
+    await import("./logs-NXFFGUKY.js").then((m) => m.run(args));
     break;
   case "status":
-    await import("./status-GCNU4M3K.js").then((m) => m.run(args));
+    await import("./status-MVSQG54T.js").then((m) => m.run(args));
     break;
-  case "fork":
-    await import("./fork-GRSVMBKI.js").then((m) => m.run(args));
-    break;
-  case "variants":
-    await import("./variants-QQIEKT6M.js").then((m) => m.run(args));
+  case "variant":
+    await import("./variant-CVYM3EQG.js").then((m) => m.run(args));
     break;
   case "send":
-    await import("./send-PLOYEYER.js").then((m) => m.run(args));
-    break;
-  case "merge":
-    await import("./merge-CSAVLSLY.js").then((m) => m.run(args));
+    await import("./send-UK3JBZIB.js").then((m) => m.run(args));
     break;
   case "import":
-    await import("./import-42DOLBDT.js").then((m) => m.run(args));
+    await import("./import-K4MP2GX7.js").then((m) => m.run(args));
     break;
   case "delete":
-    await import("./delete-GDMSOW3U.js").then((m) => m.run(args));
+    await import("./delete-GQ7JEK2S.js").then((m) => m.run(args));
     break;
   case "env":
-    await import("./env-YKUJOFHE.js").then((m) => m.run(args));
-    break;
-  case "connect":
-    await import("./connect-X5V5IMRW.js").then((m) => m.run(args));
+    await import("./env-JB27UAC3.js").then((m) => m.run(args));
     break;
-  case "disconnect":
-    await import("./disconnect-5JWFZ6RV.js").then((m) => m.run(args));
+  case "connector":
+    await import("./connector-TVJULIRT.js").then((m) => m.run(args));
     break;
   case "channel":
-    await import("./channel-2WJRM7PE.js").then((m) => m.run(args));
+    await import("./channel-7FZ6D25H.js").then((m) => m.run(args));
     break;
   case "upgrade":
-    await import("./upgrade-DD5TNJWU.js").then((m) => m.run(args));
+    await import("./upgrade-CDKECCGN.js").then((m) => m.run(args));
     break;
   case "up":
-    await import("./up-ZC6G6K4K.js").then((m) => m.run(args));
+    await import("./up-UT3IMKCA.js").then((m) => m.run(args));
     break;
   case "down":
-    await import("./down-WTF73FE7.js").then((m) => m.run(args));
+    await import("./down-3OB6UVAJ.js").then((m) => m.run(args));
     break;
   case "schedule":
-    await import("./schedule-J37XQM6E.js").then((m) => m.run(args));
+    await import("./schedule-4I5TYHFH.js").then((m) => m.run(args));
     break;
   case "history":
-    await import("./history-7WVVKMUY.js").then((m) => m.run(args));
+    await import("./history-3VRUBGGV.js").then((m) => m.run(args));
+    break;
+  case "service":
+    await import("./service-SA4TTMDU.js").then((m) => m.run(args));
+    break;
+  case "setup":
+    await import("./setup-SRS7AUAA.js").then((m) => m.run(args));
     break;
   default:
     console.log(`volute \u2014 create and manage AI agents
 
 Commands:
-  volute create <name>               Create a new agent
-  volute start <name>                Start an agent (daemonized)
-  volute stop <name>                 Stop an agent
-  volute status [<name>]             Check agent status (or list all)
-  volute logs <name>                 Tail agent logs
-  volute send <name> "<msg>"         Send a message to an agent
-  volute fork <name> <variant>       Create a variant (worktree + server)
-  volute variants <name>             List variants for an agent
-  volute merge <name> <variant>      Merge a variant back
-  volute import <path>               Import an OpenClaw workspace
-  volute env <set|get|list|remove>   Manage environment variables
-  volute connect <type> <name>        Enable a connector for an agent
-  volute disconnect <type> <name>    Disable a connector for an agent
-  volute channel read <uri>          Read recent messages from a channel
-  volute channel send <uri> "<msg>"  Send a message to a channel
-  volute schedule list <agent>       List schedules for an agent
-  volute schedule add <agent> ...    Add a cron schedule
-  volute schedule remove <agent> ... Remove a schedule
-  volute history [<agent>]            View message history
-  volute up [--port N]               Start the daemon (default: 4200)
-  volute down                        Stop the daemon
-  volute upgrade <name>              Upgrade agent to latest template
-  volute delete <name> [--force]     Delete an agent (--force removes files)`);
+  volute create <name>                  Create a new agent
+  volute start <name>                   Start an agent (daemonized)
+  volute stop <name>                    Stop an agent
+  volute status [<name>]                Check agent status (or list all)
+  volute logs [--agent <name>]          Tail agent logs
+  volute send <name> "<msg>"            Send a message to an agent
+  volute variant create <name>          Create a variant (worktree + server)
+  volute variant list                   List variants for an agent
+  volute variant merge <name>           Merge a variant back
+  volute variant delete <name>          Delete a variant
+  volute import <path>                  Import an OpenClaw workspace
+  volute env <set|get|list|remove>      Manage environment variables
+  volute connector connect <type>       Enable a connector for an agent
+  volute connector disconnect <type>    Disable a connector for an agent
+  volute channel read <uri>             Read recent messages from a channel
+  volute channel send <uri> "<msg>"     Send a message to a channel
+  volute schedule list                  List schedules for an agent
+  volute schedule add ...               Add a cron schedule
+  volute schedule remove ...            Remove a schedule
+  volute history                        View message history
+  volute up [--port N]                  Start the daemon (default: 4200)
+  volute down                           Stop the daemon
+  volute upgrade <name>                 Upgrade agent to latest template
+  volute delete <name> [--force]        Delete an agent (--force removes files)
+  volute service install [--port N]     Install as system service (auto-start)
+  volute service uninstall              Remove system service
+  volute service status                 Check service status
+  volute setup [--port N] [--host H]   Install system service with user isolation
+  volute setup uninstall [--force]     Remove system service + isolation
+
+Agent commands (variant, connector, schedule, logs, history, channel) use
+--agent <name> or VOLUTE_AGENT env var to identify the agent.`);
     if (command) {
       console.error(`
 Unknown command: ${command}`);

package/dist/connector-TVJULIRT.js

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+import {
+  loadMergedEnv
+} from "./chunk-DNOXHLE5.js";
+import {
+  daemonFetch
+} from "./chunk-YGFIWIOF.js";
+import {
+  resolveAgentName
+} from "./chunk-VRVVQIYY.js";
+import {
+  parseArgs
+} from "./chunk-D424ZQGI.js";
+import {
+  resolveAgent
+} from "./chunk-3C2XR4IY.js";
+import "./chunk-K3NQKI34.js";
+
+// src/commands/connector.ts
+async function run(args) {
+  const subcommand = args[0];
+  switch (subcommand) {
+    case "connect":
+      await connectConnector(args.slice(1));
+      break;
+    case "disconnect":
+      await disconnectConnector(args.slice(1));
+      break;
+    default:
+      printUsage();
+      process.exit(subcommand ? 1 : 0);
+  }
+}
+function printUsage() {
+  console.error(`Usage:
+  volute connector connect <type> [--agent <name>]
+  volute connector disconnect <type> [--agent <name>]`);
+}
+async function connectConnector(args) {
+  const { positional, flags } = parseArgs(args, {
+    agent: { type: "string" }
+  });
+  const agentName = resolveAgentName(flags);
+  const type = positional[0];
+  if (!type) {
+    console.error("Usage: volute connector connect <type> [--agent <name>]");
+    process.exit(1);
+  }
+  const { dir } = resolveAgent(agentName);
+  if (type === "discord") {
+    const env = loadMergedEnv(dir);
+    if (!env.DISCORD_TOKEN) {
+      console.error("DISCORD_TOKEN not set. Run: volute env set DISCORD_TOKEN <token>");
+      process.exit(1);
+    }
+  } else {
+    console.error(`Unknown connector type: ${type}`);
+    process.exit(1);
+  }
+  const res = await daemonFetch(
+    `/api/agents/${encodeURIComponent(agentName)}/connectors/${encodeURIComponent(type)}`,
+    { method: "POST" }
+  );
+  if (!res.ok) {
+    const body = await res.json().catch(() => ({ error: "Unknown error" }));
+    console.error(`Failed to start ${type} connector: ${body.error}`);
+    process.exit(1);
+  }
+  console.log(`${type} connector for ${agentName} started.`);
+}
+async function disconnectConnector(args) {
+  const { positional, flags } = parseArgs(args, {
+    agent: { type: "string" }
+  });
+  const agentName = resolveAgentName(flags);
+  const type = positional[0];
+  if (!type) {
+    console.error("Usage: volute connector disconnect <type> [--agent <name>]");
+    process.exit(1);
+  }
+  const res = await daemonFetch(
+    `/api/agents/${encodeURIComponent(agentName)}/connectors/${encodeURIComponent(type)}`,
+    {
+      method: "DELETE"
+    }
+  );
+  if (!res.ok) {
+    const body = await res.json().catch(() => ({ error: "Unknown error" }));
+    console.error(`Failed to stop ${type} connector: ${body.error}`);
+    process.exit(1);
+  }
+  console.log(`${type} connector for ${agentName} stopped.`);
+}
+export {
+  run
+};

package/dist/connectors/discord.js

@@ -24,7 +24,7 @@ if (!token) {
 var guildId = process.env.DISCORD_GUILD_ID;
 var daemonUrl = process.env.VOLUTE_DAEMON_URL;
 var daemonToken = process.env.VOLUTE_DAEMON_TOKEN;
-var baseUrl = daemonUrl ? `${daemonUrl}/api/agents/${encodeURIComponent(agentName)}` : `http://localhost:${agentPort}`;
+var baseUrl = daemonUrl ? `${daemonUrl}/api/agents/${encodeURIComponent(agentName)}` : `http://127.0.0.1:${agentPort}`;
 var client = new Client({
   intents: [
     GatewayIntentBits.Guilds,
@@ -42,7 +42,7 @@ process.on("SIGINT", shutdown);
 process.on("SIGTERM", shutdown);
 client.once(Events.ClientReady, (c) => {
   console.log(`Connected to Discord as ${c.user.tag}`);
-  console.log(`Bridging to agent: ${agentName} (port ${agentPort})`);
+  console.log(`Bridging to agent: ${agentName} via ${baseUrl}/message`);
 });
 client.on(Events.MessageCreate, async (message) => {
   if (message.author.bot) return;
@@ -72,7 +72,28 @@ client.on(Events.MessageCreate, async (message) => {
   if (content.length === 0) return;
   await handleAgentRequest(message, content);
 });
-client.login(token);
+async function loginWithRetry() {
+  try {
+    await client.login(token);
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    const match = msg.match(/resets at (.+)/);
+    if (match) {
+      const resetAt = new Date(match[1]);
+      const waitMs = resetAt.getTime() - Date.now();
+      if (waitMs > 0) {
+        console.error(`Session limit hit, waiting until ${resetAt.toISOString()}...`);
+        await new Promise((r) => setTimeout(r, waitMs + 5e3));
+        return loginWithRetry();
+      }
+    }
+    throw err;
+  }
+}
+loginWithRetry().catch((err) => {
+  console.error("Failed to connect to Discord:", err);
+  process.exit(1);
+});
 function splitMessage(text) {
   const chunks = [];
   while (text.length > DISCORD_MAX_LENGTH) {
@@ -186,6 +207,8 @@ async function handleAgentRequest(message, content) {
       })
     });
     if (!res.ok) {
+      const body = await res.text().catch(() => "");
+      console.error(`Agent returned ${res.status}: ${body}`);
       await message.reply(`Error: agent returned ${res.status}`);
       clearInterval(typingInterval);
       return;
@@ -211,6 +234,7 @@ async function handleAgentRequest(message, content) {
     }
     await flush();
   } catch (err) {
+    console.error(`Failed to reach agent at ${baseUrl}/message:`, err);
     const errMsg = err instanceof TypeError && err.cause?.code === "ECONNREFUSED" ? "Agent is not running" : `Error: ${err}`;
     await message.reply(errMsg).catch(() => {
     });

package/dist/{create-23AM7H5B.js → create-BRG2DBWI.js}

@@ -8,7 +8,12 @@ import {
 import {
   exec,
   execInherit
-} from "./chunk-XZN4WPNC.js";
+} from "./chunk-5SKQ6J7T.js";
+import {
+  chownAgentDir,
+  createAgentUser,
+  ensureVoluteGroup
+} from "./chunk-SOZA2TLP.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
@@ -17,7 +22,8 @@ import {
   agentDir,
   ensureVoluteHome,
   nextPort
-} from "./chunk-6UCG6MIX.js";
+} from "./chunk-3C2XR4IY.js";
+import "./chunk-K3NQKI34.js";
 
 // src/commands/create.ts
 import { existsSync, rmSync } from "fs";
@@ -49,9 +55,20 @@ async function run(args) {
   addAgent(name, port);
   console.log("Installing dependencies...");
   await execInherit("npm", ["install"], { cwd: dest });
-  await exec("git", ["init"], { cwd: dest });
-  await exec("git", ["add", "-A"], { cwd: dest });
-  await exec("git", ["commit", "-m", "initial commit"], { cwd: dest });
+  try {
+    await exec("git", ["init"], { cwd: dest });
+    await exec("git", ["add", "-A"], { cwd: dest });
+    await exec("git", ["commit", "-m", "initial commit"], { cwd: dest });
+  } catch {
+    console.warn(
+      "\nWarning: git init failed (git may not be installed or configured).",
+      "\nThe agent will work, but forking/variants won't be available.",
+      "\nTo fix: install git and run `git config --global user.name` / `git config --global user.email`"
+    );
+  }
+  ensureVoluteGroup();
+  createAgentUser(name);
+  chownAgentDir(dest, name);
   console.log(`
 Created agent: ${name} (port ${port})`);
   console.log(`

package/dist/daemon-client-XR24PUJF.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import {
+  daemonFetch
+} from "./chunk-YGFIWIOF.js";
+import "./chunk-3C2XR4IY.js";
+import "./chunk-K3NQKI34.js";
+export {
+  daemonFetch
+};