volute 0.4.0 → 0.5.0

package/dist/{chunk-3C2XR4IY.js → chunk-UX25Z2ND.js}

@@ -1,27 +1,131 @@
 #!/usr/bin/env node
 
 // src/lib/variants.ts
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
+import { resolve as resolve2 } from "path";
+
+// src/lib/registry.ts
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "fs";
 import { homedir } from "os";
-import { resolve } from "path";
+import { dirname, resolve } from "path";
+import { fileURLToPath } from "url";
 function voluteHome() {
-  return process.env.VOLUTE_HOME || resolve(homedir(), ".volute");
+  if (process.env.VOLUTE_HOME) return process.env.VOLUTE_HOME;
+  const dir = dirname(fileURLToPath(import.meta.url));
+  if (dir.endsWith("/src/lib")) {
+    throw new Error(
+      'VOLUTE_HOME must be set when running from source. For tests, run via "npm test" or add "--import ./test/setup.ts".'
+    );
+  }
+  return resolve(homedir(), ".volute");
+}
+function ensureVoluteHome() {
+  mkdirSync(resolve(voluteHome(), "agents"), { recursive: true });
+}
+function readRegistry() {
+  const registryPath = resolve(voluteHome(), "agents.json");
+  if (!existsSync(registryPath)) return [];
+  try {
+    const entries = JSON.parse(readFileSync(registryPath, "utf-8"));
+    return entries.map((e) => ({ ...e, running: e.running ?? false }));
+  } catch {
+    return [];
+  }
+}
+function writeRegistry(entries) {
+  ensureVoluteHome();
+  const registryPath = resolve(voluteHome(), "agents.json");
+  const tmpPath = `${registryPath}.tmp`;
+  writeFileSync(tmpPath, `${JSON.stringify(entries, null, 2)}
+`);
+  renameSync(tmpPath, registryPath);
+}
+var AGENT_NAME_RE = /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/;
+var AGENT_NAME_MAX = 64;
+function validateAgentName(name) {
+  if (!name) return "Agent name is required";
+  if (name.length > AGENT_NAME_MAX)
+    return `Agent name must be at most ${AGENT_NAME_MAX} characters`;
+  if (!AGENT_NAME_RE.test(name)) {
+    return "Agent name must start with alphanumeric and contain only alphanumeric, dots, dashes, or underscores";
+  }
+  return null;
+}
+function addAgent(name, port) {
+  const err = validateAgentName(name);
+  if (err) throw new Error(err);
+  const entries = readRegistry();
+  const filtered = entries.filter((e) => e.name !== name);
+  filtered.push({ name, port, created: (/* @__PURE__ */ new Date()).toISOString(), running: false });
+  writeRegistry(filtered);
 }
+function removeAgent(name) {
+  const entries = readRegistry();
+  writeRegistry(entries.filter((e) => e.name !== name));
+}
+function setAgentRunning(name, running) {
+  const entries = readRegistry();
+  const entry = entries.find((e) => e.name === name);
+  if (entry) {
+    entry.running = running;
+    writeRegistry(entries);
+  }
+}
+function findAgent(name) {
+  return readRegistry().find((e) => e.name === name);
+}
+function agentDir(name) {
+  return resolve(voluteHome(), "agents", name);
+}
+function nextPort() {
+  const entries = readRegistry();
+  const usedPorts = new Set(entries.map((e) => e.port));
+  for (const entry of entries) {
+    for (const v of readVariants(entry.name)) {
+      if (v.port) usedPorts.add(v.port);
+    }
+  }
+  let port = 4100;
+  while (usedPorts.has(port)) port++;
+  if (port > 65535) throw new Error("No available ports \u2014 all ports 4100-65535 are allocated");
+  return port;
+}
+function resolveAgent(name) {
+  const [baseName, variantName] = name.split("@", 2);
+  const entry = findAgent(baseName);
+  if (!entry) {
+    throw new Error(`Unknown agent: ${baseName}`);
+  }
+  const dir = agentDir(baseName);
+  if (!existsSync(dir)) {
+    throw new Error(`Agent directory missing: ${dir}`);
+  }
+  if (variantName) {
+    const variant = findVariant(baseName, variantName);
+    if (!variant) {
+      throw new Error(`Unknown variant: ${variantName} (agent: ${baseName})`);
+    }
+    return { entry: { ...entry, port: variant.port }, dir: variant.path };
+  }
+  return { entry, dir };
+}
+
+// src/lib/variants.ts
 function variantsPath() {
-  return resolve(voluteHome(), "variants.json");
+  return resolve2(voluteHome(), "variants.json");
 }
 function readAllVariants() {
   const path = variantsPath();
-  if (!existsSync(path)) return {};
+  if (!existsSync2(path)) return {};
   try {
-    return JSON.parse(readFileSync(path, "utf-8"));
+    return JSON.parse(readFileSync2(path, "utf-8"));
   } catch {
     return {};
   }
 }
 function writeAllVariants(all) {
-  mkdirSync(voluteHome(), { recursive: true });
-  writeFileSync(variantsPath(), `${JSON.stringify(all, null, 2)}
+  mkdirSync2(voluteHome(), { recursive: true });
+  writeFileSync2(variantsPath(), `${JSON.stringify(all, null, 2)}
 `);
 }
 function readVariants(agentName) {
@@ -102,104 +206,6 @@ function validateBranchName(branch) {
   return null;
 }
 
-// src/lib/registry.ts
-import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync2, renameSync, writeFileSync as writeFileSync2 } from "fs";
-import { homedir as homedir2 } from "os";
-import { resolve as resolve2 } from "path";
-function voluteHome2() {
-  return process.env.VOLUTE_HOME || resolve2(homedir2(), ".volute");
-}
-function ensureVoluteHome() {
-  mkdirSync2(resolve2(voluteHome2(), "agents"), { recursive: true });
-}
-function readRegistry() {
-  const registryPath = resolve2(voluteHome2(), "agents.json");
-  if (!existsSync2(registryPath)) return [];
-  try {
-    const entries = JSON.parse(readFileSync2(registryPath, "utf-8"));
-    return entries.map((e) => ({ ...e, running: e.running ?? false }));
-  } catch {
-    return [];
-  }
-}
-function writeRegistry(entries) {
-  ensureVoluteHome();
-  const registryPath = resolve2(voluteHome2(), "agents.json");
-  const tmpPath = `${registryPath}.tmp`;
-  writeFileSync2(tmpPath, `${JSON.stringify(entries, null, 2)}
-`);
-  renameSync(tmpPath, registryPath);
-}
-var AGENT_NAME_RE = /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/;
-var AGENT_NAME_MAX = 64;
-function validateAgentName(name) {
-  if (!name) return "Agent name is required";
-  if (name.length > AGENT_NAME_MAX)
-    return `Agent name must be at most ${AGENT_NAME_MAX} characters`;
-  if (!AGENT_NAME_RE.test(name)) {
-    return "Agent name must start with alphanumeric and contain only alphanumeric, dots, dashes, or underscores";
-  }
-  return null;
-}
-function addAgent(name, port) {
-  const err = validateAgentName(name);
-  if (err) throw new Error(err);
-  const entries = readRegistry();
-  const filtered = entries.filter((e) => e.name !== name);
-  filtered.push({ name, port, created: (/* @__PURE__ */ new Date()).toISOString(), running: false });
-  writeRegistry(filtered);
-}
-function removeAgent(name) {
-  const entries = readRegistry();
-  writeRegistry(entries.filter((e) => e.name !== name));
-}
-function setAgentRunning(name, running) {
-  const entries = readRegistry();
-  const entry = entries.find((e) => e.name === name);
-  if (entry) {
-    entry.running = running;
-    writeRegistry(entries);
-  }
-}
-function findAgent(name) {
-  return readRegistry().find((e) => e.name === name);
-}
-function agentDir(name) {
-  return resolve2(voluteHome2(), "agents", name);
-}
-function nextPort() {
-  const entries = readRegistry();
-  const usedPorts = new Set(entries.map((e) => e.port));
-  for (const entry of entries) {
-    for (const v of readVariants(entry.name)) {
-      if (v.port) usedPorts.add(v.port);
-    }
-  }
-  let port = 4100;
-  while (usedPorts.has(port)) port++;
-  if (port > 65535) throw new Error("No available ports \u2014 all ports 4100-65535 are allocated");
-  return port;
-}
-function resolveAgent(name) {
-  const [baseName, variantName] = name.split("@", 2);
-  const entry = findAgent(baseName);
-  if (!entry) {
-    throw new Error(`Unknown agent: ${baseName}`);
-  }
-  const dir = agentDir(baseName);
-  if (!existsSync2(dir)) {
-    throw new Error(`Agent directory missing: ${dir}`);
-  }
-  if (variantName) {
-    const variant = findVariant(baseName, variantName);
-    if (!variant) {
-      throw new Error(`Unknown variant: ${variantName} (agent: ${baseName})`);
-    }
-    return { entry: { ...entry, port: variant.port }, dir: variant.path };
-  }
-  return { entry, dir };
-}
-
 export {
   readVariants,
   writeVariants,
@@ -211,7 +217,7 @@ export {
   removeAllVariants,
   checkHealth,
   validateBranchName,
-  voluteHome2 as voluteHome,
+  voluteHome,
   ensureVoluteHome,
   readRegistry,
   validateAgentName,

package/dist/{chunk-GSPKUPKU.js → chunk-XUA3JUFK.js}

@@ -116,5 +116,6 @@ export {
   findTemplatesRoot,
   composeTemplate,
   copyTemplateToDir,
-  applyInitFiles
+  applyInitFiles,
+  listFiles
 };

package/dist/chunk-ZYGKG6VC.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+
+// src/lib/read-stdin.ts
+import { isatty } from "tty";
+async function readStdin() {
+  if (isatty(0)) return void 0;
+  const chunks = [];
+  try {
+    for await (const chunk of process.stdin) {
+      chunks.push(chunk);
+    }
+  } catch (err) {
+    console.error(`Failed to read from stdin: ${err instanceof Error ? err.message : String(err)}`);
+    process.exit(1);
+  }
+  const text = Buffer.concat(chunks).toString().replace(/\r?\n$/, "");
+  return text || void 0;
+}
+
+export {
+  readStdin
+};

package/dist/cli.js

@@ -1,70 +1,57 @@
 #!/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-VQOE7JNH.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-Z2B6EFEQ.js").then((m) => m.run(args));
     break;
-  case "status":
-    await import("./status-MVSQG54T.js").then((m) => m.run(args));
+  case "message":
+    await import("./message-ADHWFHSI.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-LAB67OC2.js").then((m) => m.run(args));
     break;
   case "connector":
-    await import("./connector-DKDJTLYZ.js").then((m) => m.run(args));
+    await import("./connector-LYEMXQEV.js").then((m) => m.run(args));
     break;
   case "channel":
-    await import("./channel-DQ6UY7QB.js").then((m) => m.run(args));
+    await import("./channel-MK5OK2SI.js").then((m) => m.run(args));
+    break;
+  case "schedule":
+    await import("./schedule-NAG6F463.js").then((m) => m.run(args));
     break;
-  case "upgrade":
-    await import("./upgrade-6ZW2RD64.js").then((m) => m.run(args));
+  case "conversation":
+    await import("./conversation-ERXEQZTY.js").then((m) => m.run(args));
+    break;
+  case "env":
+    await import("./env-4D4REPJF.js").then((m) => m.run(args));
     break;
   case "up":
-    await import("./up-F7TMTLRE.js").then((m) => m.run(args));
+    await import("./up-7ILD7GU7.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-O7IFZLVJ.js").then((m) => m.run(args));
     break;
-  case "history":
-    await import("./history-BKG74I43.js").then((m) => m.run(args));
+  case "setup":
+    await import("./setup-RPRRGG2F.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-LPSIAWQ2.js").then((m) => m.run(args));
     break;
   case "--help":
   case "-h":
@@ -72,45 +59,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 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 schedule list                    List schedules for an agent
+  volute schedule add ...                 Add a cron schedule
+  volute schedule remove ...              Remove a schedule
+
+  volute conversation create ...           Create a group conversation
+  volute conversation list                 List conversations
+  volute conversation send <id> "<msg>"    Send a message to a conversation
+
+  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, conversation, 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-Y33QDCFL.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-LYEMXQEV.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-HE67X4T6.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
 import {
   daemonFetch
-} from "./chunk-YGFIWIOF.js";
+} from "./chunk-7L4AN5D4.js";
 import {
   agentDir
-} from "./chunk-3C2XR4IY.js";
+} from "./chunk-UX25Z2ND.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

@@ -90,6 +90,7 @@ client.on(Events.MessageCreate, async (message) => {
   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 participantCount = isDM ? 2 : message.guild?.memberCount;
   const payload = {
     content,
     channel: channelKey,
@@ -97,7 +98,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);

package/dist/connectors/slack.js

@@ -27,11 +27,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,14 +66,16 @@ 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;
@@ -85,13 +88,16 @@ app.message(async ({ message, say }) => {
     console.warn(`Failed to get user info: ${err}`);
   }
   const channelKey = `slack:${message.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 +140,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

@@ -40,13 +40,22 @@ 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 payload = {
     content,
     channel: `telegram:${ctx.chat.id}`,
     sender: senderName,
     platform: "Telegram",
     ...isDM ? { isDM: true } : {},
-    ...chatTitle ? { channelName: chatTitle } : {}
+    ...chatTitle ? { channelName: chatTitle } : {},
+    ...participantCount ? { participantCount } : {}
   };
   if (isFollowedChat && !isMentioned) {
     await fireAndForget(env, payload);
@@ -88,12 +97,22 @@ 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 payload = {
     content,
     channel: `telegram:${ctx.chat.id}`,
     sender: senderName,
     platform: "Telegram",
-    ...chatTitle ? { channelName: chatTitle } : {}
+    ...isDM ? { isDM: true } : {},
+    ...chatTitle ? { channelName: chatTitle } : {},
+    ...participantCount ? { participantCount } : {}
   };
   if (isFollowedChat) {
     await fireAndForget(env, payload);