volute 0.4.0 → 0.6.0

package/dist/cli.js

@@ -1,70 +1,54 @@
 #!/usr/bin/env node
 
 // src/cli.ts
+import { homedir } from "os";
+import { resolve } from "path";
+if (!process.env.VOLUTE_HOME) {
+  process.env.VOLUTE_HOME = resolve(homedir(), ".volute");
+}
 var command = process.argv[2];
 var args = process.argv.slice(3);
 if (command === "--version" || command === "-v") {
-  const { default: pkg } = await import("./package-Z2SFO2SV.js");
+  const { default: pkg } = await import("./package-4DP4Y4UO.js");
   console.log(pkg.version);
   process.exit(0);
 }
 switch (command) {
-  case "create":
-    await import("./create-ILVOG75A.js").then((m) => m.run(args));
-    break;
-  case "start":
-    await import("./start-LDPMCMYT.js").then((m) => m.run(args));
-    break;
-  case "stop":
-    await import("./stop-5PZTZCLL.js").then((m) => m.run(args));
-    break;
-  case "logs":
-    await import("./logs-NXFFGUKY.js").then((m) => m.run(args));
+  case "agent":
+    await import("./agent-X7GJLBLW.js").then((m) => m.run(args));
     break;
-  case "status":
-    await import("./status-MVSQG54T.js").then((m) => m.run(args));
+  case "message":
+    await import("./message-SCOQDR3P.js").then((m) => m.run(args));
     break;
   case "variant":
-    await import("./variant-T64BKARF.js").then((m) => m.run(args));
-    break;
-  case "send":
-    await import("./send-3U6OTKG7.js").then((m) => m.run(args));
-    break;
-  case "import":
-    await import("./import-4CI2ZUTJ.js").then((m) => m.run(args));
-    break;
-  case "delete":
-    await import("./delete-55MXCEY5.js").then((m) => m.run(args));
-    break;
-  case "env":
-    await import("./env-JB27UAC3.js").then((m) => m.run(args));
+    await import("./variant-4Z6W3PP6.js").then((m) => m.run(args));
     break;
   case "connector":
-    await import("./connector-DKDJTLYZ.js").then((m) => m.run(args));
+    await import("./connector-Y7JPNROO.js").then((m) => m.run(args));
     break;
   case "channel":
-    await import("./channel-DQ6UY7QB.js").then((m) => m.run(args));
+    await import("./channel-SMCNOIVQ.js").then((m) => m.run(args));
+    break;
+  case "schedule":
+    await import("./schedule-S6QVC5ON.js").then((m) => m.run(args));
     break;
-  case "upgrade":
-    await import("./upgrade-6ZW2RD64.js").then((m) => m.run(args));
+  case "env":
+    await import("./env-7GLUJCWS.js").then((m) => m.run(args));
     break;
   case "up":
-    await import("./up-F7TMTLRE.js").then((m) => m.run(args));
+    await import("./up-CSX3ZUIU.js").then((m) => m.run(args));
     break;
   case "down":
-    await import("./down-3OB6UVAJ.js").then((m) => m.run(args));
-    break;
-  case "schedule":
-    await import("./schedule-A35SH4HT.js").then((m) => m.run(args));
+    await import("./down-FXWAN66A.js").then((m) => m.run(args));
     break;
-  case "history":
-    await import("./history-BKG74I43.js").then((m) => m.run(args));
+  case "setup":
+    await import("./setup-F4TCWVSP.js").then((m) => m.run(args));
     break;
   case "service":
-    await import("./service-SA4TTMDU.js").then((m) => m.run(args));
+    await import("./service-HZNIDNJF.js").then((m) => m.run(args));
     break;
-  case "setup":
-    await import("./setup-2FDVN7OF.js").then((m) => m.run(args));
+  case "update":
+    await import("./update-XSIX3GGP.js").then((m) => m.run(args));
     break;
   case "--help":
   case "-h":
@@ -72,45 +56,70 @@ switch (command) {
     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 [--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
+  volute agent create <name>              Create a new agent
+  volute agent start <name>               Start an agent (daemonized)
+  volute agent stop <name>                Stop an agent
+  volute agent restart <name>             Restart an agent
+  volute agent delete <name> [--force]    Delete an agent (--force removes files)
+  volute agent list                       List all agents
+  volute agent status <name>              Check agent status
+  volute agent logs <name> [--follow]     Tail agent logs
+  volute agent upgrade <name>             Upgrade agent to latest template
+  volute agent import <path>              Import an OpenClaw workspace
+
+  volute message send <name> "<msg>"      Send a message to an agent
+  volute message history [--agent <name>] View message history
+
+  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 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 channel list [<platform>]        List conversations on a platform
+  volute channel users <platform>         List users on a platform
+  volute channel create <platform> ...    Create a conversation on a platform
+
+  volute schedule list                    List schedules for an agent
+  volute schedule add ...                 Add a cron schedule
+  volute schedule remove ...              Remove a schedule
+
+  volute env <set|get|list|remove>        Manage environment variables
+
+  volute up [--port N]                    Start the daemon (default: 4200)
+  volute down                             Stop the daemon
+
+  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
+
+  volute update                           Update to latest version
 
 Options:
-  --version, -v                         Show version number
-  --help, -h                            Show this help message
+  --version, -v                           Show version number
+  --help, -h                              Show this help message
 
-Agent commands (variant, connector, schedule, logs, history, channel) use
---agent <name> or VOLUTE_AGENT env var to identify the agent.`);
+Agent-scoped commands (variant, connector, schedule, channel, message history)
+use --agent <name> or VOLUTE_AGENT env var to identify the agent.`);
     break;
   default:
     console.error(`Unknown command: ${command}
 Run 'volute --help' for usage.`);
     process.exit(1);
 }
+if (command !== "update") {
+  import("./update-check-5ZADDHCK.js").then((m) => m.checkForUpdate()).then((result) => {
+    if (result.updateAvailable) {
+      console.error(`
+  Update available: ${result.current} \u2192 ${result.latest}`);
+      console.error("  Run `volute update` to update\n");
+    }
+  }).catch(() => {
+  });
+}

package/dist/{connector-DKDJTLYZ.js → connector-Y7JPNROO.js}

@@ -1,21 +1,21 @@
 #!/usr/bin/env node
 import {
   resolveAgentName
-} from "./chunk-VRVVQIYY.js";
+} from "./chunk-AZEL2IEK.js";
 import {
   agentEnvPath,
   readEnv,
   writeEnv
-} from "./chunk-DNOXHLE5.js";
+} from "./chunk-H7AMDUIA.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
 import {
   daemonFetch
-} from "./chunk-YGFIWIOF.js";
+} from "./chunk-JR4UXCTO.js";
 import {
   agentDir
-} from "./chunk-3C2XR4IY.js";
+} from "./chunk-UWHWAPGO.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/connector.ts
@@ -28,13 +28,18 @@ async function run(args) {
     case "disconnect":
       await disconnectConnector(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 connector connect <type> [--agent <name>]
   volute connector disconnect <type> [--agent <name>]`);
 }

package/dist/connectors/discord.js

@@ -1,11 +1,15 @@
 #!/usr/bin/env node
 import {
+  buildChannelSlug,
   fireAndForget,
   handleAgentMessage,
   loadEnv,
   loadFollowedChannels,
-  splitMessage
-} from "../chunk-MXUCNIBG.js";
+  reportTyping,
+  slugify,
+  splitMessage,
+  writeChannelEntry
+} from "../chunk-BX7KI4S3.js";
 import "../chunk-K3NQKI34.js";
 
 // src/connectors/discord.ts
@@ -32,7 +36,9 @@ var client = new Client({
     GatewayIntentBits.Guilds,
     GatewayIntentBits.GuildMessages,
     GatewayIntentBits.MessageContent,
-    GatewayIntentBits.DirectMessages
+    GatewayIntentBits.DirectMessages,
+    GatewayIntentBits.GuildMessageTyping,
+    GatewayIntentBits.DirectMessageTyping
   ],
   partials: [Partials.Channel]
 });
@@ -88,8 +94,24 @@ client.on(Events.MessageCreate, async (message) => {
   }
   if (content.length === 0) return;
   const senderName = message.author.displayName || message.author.username;
-  const channelKey = `discord:${message.channelId}`;
   const channelName = !isDM && "name" in message.channel ? message.channel.name : void 0;
+  const channelKey = isDM ? buildChannelSlug("discord", {
+    isDM: true,
+    recipients: [message.author.username]
+  }) : buildChannelSlug("discord", {
+    channelName: channelName ?? message.channelId,
+    serverName: message.guild?.name
+  });
+  if (env.agentDir) {
+    writeChannelEntry(env.agentDir, channelKey, {
+      platformId: message.channelId,
+      platform: "discord",
+      name: channelName ? `#${channelName}` : void 0,
+      server: message.guild?.name,
+      type: isDM ? "dm" : "channel"
+    });
+  }
+  const participantCount = isDM ? 2 : message.guild?.memberCount;
   const payload = {
     content,
     channel: channelKey,
@@ -97,7 +119,8 @@ client.on(Events.MessageCreate, async (message) => {
     platform: "Discord",
     ...isDM ? { isDM: true } : {},
     ...channelName ? { channelName } : {},
-    ...message.guild?.name ? { guildName: message.guild.name } : {}
+    ...message.guild?.name ? { serverName: message.guild.name } : {},
+    ...participantCount ? { participantCount } : {}
   };
   if (isFollowedChannel && !isMentioned) {
     await fireAndForget(env, payload);
@@ -105,6 +128,12 @@ client.on(Events.MessageCreate, async (message) => {
   }
   await handleDiscordMessage(message, payload);
 });
+client.on(Events.TypingStart, (typing) => {
+  if (typing.user.bot) return;
+  const sender = typing.member?.displayName ?? typing.user.username ?? typing.user.id ?? "unknown";
+  const typingChannel = typing.guild ? `discord:${slugify(typing.guild.name)}/${slugify("name" in typing.channel ? String(typing.channel.name) : typing.channel.id)}` : `discord:@${slugify(typing.user.username ?? typing.user.id)}`;
+  reportTyping(env, typingChannel, sender, true);
+});
 async function handleDiscordMessage(message, payload) {
   const channel = message.channel;
   if (!("sendTyping" in channel)) return;

package/dist/connectors/slack.js

@@ -1,12 +1,14 @@
 #!/usr/bin/env node
 import {
+  buildChannelSlug,
   fireAndForget,
   handleAgentMessage,
   loadEnv,
   loadFollowedChannels,
   onShutdown,
-  splitMessage
-} from "../chunk-MXUCNIBG.js";
+  splitMessage,
+  writeChannelEntry
+} from "../chunk-BX7KI4S3.js";
 import "../chunk-K3NQKI34.js";
 
 // src/connectors/slack.ts
@@ -27,11 +29,12 @@ var app = new App({
   appToken
 });
 var botUserId;
+var serverName;
 app.message(async ({ message, say }) => {
   if (message.subtype) return;
   if (!("user" in message) || !("text" in message)) return;
   if ("bot_id" in message && message.bot_id) return;
-  const isDM = message.channel_type === "im";
+  const isDM = message.channel_type === "im" || message.channel_type === "mpim";
   const isMentioned = !isDM && botUserId && message.text?.includes(`<@${botUserId}>`);
   const isFollowedChannel = !isDM && followedChannelIds.has(message.channel);
   if (!isDM && !isMentioned && !isFollowedChannel) return;
@@ -65,33 +68,55 @@ app.message(async ({ message, say }) => {
   }
   if (content.length === 0) return;
   let channelName;
-  if (!isDM) {
+  let numMembers;
+  if (message.channel_type !== "im") {
     try {
       const info = await app.client.conversations.info({
         channel: message.channel
       });
       channelName = info.channel?.name;
+      numMembers = info.channel?.num_members;
     } catch (err) {
-      console.warn(`Failed to get channel name: ${err}`);
+      console.warn(`Failed to get channel info: ${err}`);
     }
   }
   let senderName = message.user;
+  let senderUsername = message.user;
   try {
     const userInfo = await app.client.users.info({
       user: message.user
     });
     senderName = userInfo.user?.profile?.display_name || userInfo.user?.profile?.real_name || message.user;
+    senderUsername = userInfo.user?.name ?? message.user;
   } catch (err) {
     console.warn(`Failed to get user info: ${err}`);
   }
-  const channelKey = `slack:${message.channel}`;
+  const channelKey = isDM ? buildChannelSlug("slack", {
+    isDM: true,
+    senderName: senderUsername
+  }) : buildChannelSlug("slack", {
+    channelName: channelName ?? message.channel,
+    serverName
+  });
+  if (env.agentDir) {
+    writeChannelEntry(env.agentDir, channelKey, {
+      platformId: message.channel,
+      platform: "slack",
+      name: channelName ? `#${channelName}` : void 0,
+      server: serverName,
+      type: isDM ? "dm" : "channel"
+    });
+  }
+  const participantCount = message.channel_type === "im" ? 2 : numMembers;
   const payload = {
     content,
     channel: channelKey,
     sender: senderName,
     platform: "Slack",
     ...isDM ? { isDM: true } : {},
-    ...channelName ? { channelName } : {}
+    ...channelName ? { channelName } : {},
+    ...serverName ? { serverName } : {},
+    ...participantCount ? { participantCount } : {}
   };
   if (isFollowedChannel && !isMentioned) {
     await fireAndForget(env, payload);
@@ -134,7 +159,10 @@ async function start() {
     throw new Error("auth.test succeeded but returned no user_id");
   }
   botUserId = auth.user_id;
-  console.log(`Connected to Slack as bot user ${botUserId}`);
+  serverName = auth.team;
+  console.log(
+    `Connected to Slack as bot user ${botUserId}${serverName ? ` in ${serverName}` : ""}`
+  );
   console.log(`Bridging to agent: ${env.agentName} via ${env.baseUrl}/message`);
   if (followedChannelNames.length > 0) {
     try {

package/dist/connectors/telegram.js

@@ -1,11 +1,13 @@
 #!/usr/bin/env node
 import {
+  buildChannelSlug,
   fireAndForget,
   handleAgentMessage,
   loadEnv,
   loadFollowedChannels,
-  splitMessage
-} from "../chunk-MXUCNIBG.js";
+  splitMessage,
+  writeChannelEntry
+} from "../chunk-BX7KI4S3.js";
 import "../chunk-K3NQKI34.js";
 
 // src/connectors/telegram.ts
@@ -40,13 +42,36 @@ bot.on(message("text"), async (ctx) => {
   if (content.length === 0) return;
   const senderName = ctx.message.from.first_name + (ctx.message.from.last_name ? ` ${ctx.message.from.last_name}` : "");
   const chatTitle = "title" in ctx.chat ? ctx.chat.title : void 0;
+  let participantCount = isDM ? 2 : void 0;
+  if (!isDM) {
+    try {
+      participantCount = await ctx.telegram.getChatMembersCount(ctx.chat.id);
+    } catch (err) {
+      console.warn(`Failed to get member count for chat ${ctx.chat.id}: ${err}`);
+    }
+  }
+  const channelSlug = isDM ? buildChannelSlug("telegram", {
+    isDM: true,
+    senderName: ctx.message.from.username ?? ctx.message.from.first_name
+  }) : buildChannelSlug("telegram", {
+    channelName: chatTitle ?? String(ctx.chat.id)
+  });
+  if (env.agentDir) {
+    writeChannelEntry(env.agentDir, channelSlug, {
+      platformId: String(ctx.chat.id),
+      platform: "telegram",
+      name: chatTitle,
+      type: isDM ? "dm" : "channel"
+    });
+  }
   const payload = {
     content,
-    channel: `telegram:${ctx.chat.id}`,
+    channel: channelSlug,
     sender: senderName,
     platform: "Telegram",
     ...isDM ? { isDM: true } : {},
-    ...chatTitle ? { channelName: chatTitle } : {}
+    ...chatTitle ? { channelName: chatTitle } : {},
+    ...participantCount ? { participantCount } : {}
   };
   if (isFollowedChat && !isMentioned) {
     await fireAndForget(env, payload);
@@ -88,12 +113,36 @@ bot.on(message("photo"), async (ctx) => {
   if (content.length === 0) return;
   const senderName = ctx.message.from.first_name + (ctx.message.from.last_name ? ` ${ctx.message.from.last_name}` : "");
   const chatTitle = "title" in ctx.chat ? ctx.chat.title : void 0;
+  let participantCount = isDM ? 2 : void 0;
+  if (!isDM) {
+    try {
+      participantCount = await ctx.telegram.getChatMembersCount(ctx.chat.id);
+    } catch (err) {
+      console.warn(`Failed to get member count for chat ${ctx.chat.id}: ${err}`);
+    }
+  }
+  const channelSlug = isDM ? buildChannelSlug("telegram", {
+    isDM: true,
+    senderName: ctx.message.from.username ?? ctx.message.from.first_name
+  }) : buildChannelSlug("telegram", {
+    channelName: chatTitle ?? String(ctx.chat.id)
+  });
+  if (env.agentDir) {
+    writeChannelEntry(env.agentDir, channelSlug, {
+      platformId: String(ctx.chat.id),
+      platform: "telegram",
+      name: chatTitle,
+      type: isDM ? "dm" : "channel"
+    });
+  }
   const payload = {
     content,
-    channel: `telegram:${ctx.chat.id}`,
+    channel: channelSlug,
     sender: senderName,
     platform: "Telegram",
-    ...chatTitle ? { channelName: chatTitle } : {}
+    ...isDM ? { isDM: true } : {},
+    ...chatTitle ? { channelName: chatTitle } : {},
+    ...participantCount ? { participantCount } : {}
   };
   if (isFollowedChat) {
     await fireAndForget(env, payload);

package/dist/create-G525LWEA.js

@@ -0,0 +1,91 @@
+#!/usr/bin/env node
+import {
+  applyInitFiles,
+  composeTemplate,
+  copyTemplateToDir,
+  findTemplatesRoot,
+  listFiles
+} from "./chunk-XUA3JUFK.js";
+import {
+  parseArgs
+} from "./chunk-D424ZQGI.js";
+import {
+  chownAgentDir,
+  createAgentUser,
+  ensureVoluteGroup
+} from "./chunk-W76KWE23.js";
+import {
+  exec,
+  execInherit
+} from "./chunk-5SKQ6J7T.js";
+import {
+  addAgent,
+  agentDir,
+  ensureVoluteHome,
+  nextPort
+} from "./chunk-UWHWAPGO.js";
+import "./chunk-K3NQKI34.js";
+
+// src/commands/create.ts
+import { existsSync, rmSync } from "fs";
+import { resolve } from "path";
+var TEMPLATE_BRANCH = "volute/template";
+async function run(args) {
+  const { positional, flags } = parseArgs(args, {
+    template: { type: "string" }
+  });
+  const name = positional[0];
+  const template = flags.template ?? "agent-sdk";
+  if (!name) {
+    console.error("Usage: volute agent create <name> [--template <name>]");
+    process.exit(1);
+  }
+  ensureVoluteHome();
+  const dest = agentDir(name);
+  if (existsSync(dest)) {
+    console.error(`Agent already exists: ${name}`);
+    process.exit(1);
+  }
+  const templatesRoot = findTemplatesRoot();
+  const { composedDir, manifest } = composeTemplate(templatesRoot, template);
+  try {
+    copyTemplateToDir(composedDir, dest, name, manifest);
+    applyInitFiles(dest);
+    const port = nextPort();
+    addAgent(name, port);
+    console.log("Installing dependencies...");
+    await execInherit("npm", ["install"], { cwd: dest });
+    try {
+      await exec("git", ["init"], { cwd: dest });
+      await initTemplateBranch(dest, composedDir, manifest);
+    } catch (err) {
+      rmSync(resolve(dest, ".git"), { recursive: true, force: true });
+      console.warn(
+        "\nWarning: git setup failed \u2014 variants and upgrades won't be available.",
+        "\nTo fix: ensure git is installed with user.name/user.email configured."
+      );
+      console.warn("Details:", err.message ?? err);
+    }
+    ensureVoluteGroup();
+    createAgentUser(name);
+    chownAgentDir(dest, name);
+    console.log(`
+Created agent: ${name} (port ${port})`);
+    console.log(`
+  volute agent start ${name}`);
+  } finally {
+    rmSync(composedDir, { recursive: true, force: true });
+  }
+}
+async function initTemplateBranch(projectRoot, composedDir, manifest) {
+  const templateFiles = listFiles(composedDir).filter((f) => !f.startsWith(".init/") && !f.startsWith(".init\\")).map((f) => manifest.rename[f] ?? f);
+  await exec("git", ["checkout", "--orphan", TEMPLATE_BRANCH], { cwd: projectRoot });
+  await exec("git", ["add", "--", ...templateFiles], { cwd: projectRoot });
+  await exec("git", ["commit", "-m", "template update"], { cwd: projectRoot });
+  await exec("git", ["checkout", "-b", "main"], { cwd: projectRoot });
+  await exec("git", ["add", "-A"], { cwd: projectRoot });
+  await exec("git", ["commit", "-m", "initial commit"], { cwd: projectRoot });
+}
+export {
+  run
+};

package/dist/{daemon-client-XR24PUJF.js → daemon-client-442IV43D.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";
 export {
   daemonFetch