claudemesh-cli 0.1.15 → 0.2.0

package/dist/index.js

@@ -6514,7 +6514,7 @@ function loadConfig() {
     if (!parsed || !Array.isArray(parsed.meshes)) {
       return { version: 1, meshes: [] };
     }
-    return { version: 1, meshes: parsed.meshes, displayName: parsed.displayName };
+    return { version: 1, meshes: parsed.meshes, displayName: parsed.displayName, groups: parsed.groups };
   } catch (e) {
     throw new Error(`Failed to load ${CONFIG_PATH}: ${e instanceof Error ? e.message : String(e)}`);
   }
@@ -46245,13 +46245,13 @@ class StdioServerTransport {
 var TOOLS = [
   {
     name: "send_message",
-    description: "Send a message to a peer in one of your joined meshes. `to` can be a peer display name (resolved via list_peers), hex pubkey, `#channel`, or `*` for broadcast. `priority` controls delivery: `now` bypasses busy gates, `next` waits for idle (default), `low` is pull-only.",
+    description: "Send a message to a peer in one of your joined meshes. `to` can be a peer display name (resolved via list_peers), hex pubkey, @group, `#channel`, or `*` for broadcast. `priority` controls delivery: `now` bypasses busy gates, `next` waits for idle (default), `low` is pull-only.",
     inputSchema: {
       type: "object",
       properties: {
         to: {
           type: "string",
-          description: "Peer name, pubkey, or #channel"
+          description: "Peer name, pubkey, @group, or #channel"
         },
         message: { type: "string", description: "Message text" },
         priority: {
@@ -46306,6 +46306,32 @@ var TOOLS = [
       },
       required: ["status"]
     }
+  },
+  {
+    name: "join_group",
+    description: "Join a group with an optional role. Other peers see your group membership in list_peers.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        name: { type: "string", description: "Group name (without @)" },
+        role: {
+          type: "string",
+          description: "Your role in the group (e.g. lead, member, observer)"
+        }
+      },
+      required: ["name"]
+    }
+  },
+  {
+    name: "leave_group",
+    description: "Leave a group.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        name: { type: "string", description: "Group name (without @)" }
+      },
+      required: ["name"]
+    }
   }
 ];
 
@@ -46590,6 +46616,16 @@ class BrokerClient {
       return;
     this.ws.send(JSON.stringify({ type: "set_summary", summary }));
   }
+  async joinGroup(name, role) {
+    if (!this.ws || this.ws.readyState !== this.ws.OPEN)
+      return;
+    this.ws.send(JSON.stringify({ type: "join_group", name, role }));
+  }
+  async leaveGroup(name) {
+    if (!this.ws || this.ws.readyState !== this.ws.OPEN)
+      return;
+    this.ws.send(JSON.stringify({ type: "leave_group", name }));
+  }
   close() {
     this.closed = true;
     if (this.helloTimer)
@@ -46786,7 +46822,7 @@ async function resolveClient(to) {
       target = rest;
     }
   }
-  if (/^[0-9a-f]{64}$/.test(target) || target.startsWith("#") || target === "*") {
+  if (/^[0-9a-f]{64}$/.test(target) || target.startsWith("#") || target.startsWith("@") || target === "*") {
     if (targetClients.length === 1) {
       return { client: targetClients[0], targetSpec: target };
     }
@@ -46852,14 +46888,16 @@ async function startMcpServer() {
 
 IMPORTANT: When you receive a <channel source="claudemesh" ...> message, RESPOND IMMEDIATELY. Do not wait until your current task is finished. Pause what you are doing, reply to the message using send_message, then resume your work. Treat incoming peer messages like a coworker tapping you on the shoulder — answer right away, even if you're in the middle of something.
 
-Read the from_id, from_name, mesh_slug, and priority attributes to understand context. Reply by calling send_message with to set to the from_name (display name) of the sender.
+Read the from_id, from_name, mesh_slug, and priority attributes to understand context. Reply by calling send_message with to set to the from_name (display name) of the sender. The \`to\` field can be a peer name, pubkey, @group, or * for broadcast.
 
 Available tools:
 - list_peers: see joined meshes + their connection status
-- send_message: send to a peer by display name, pubkey, #channel, or * broadcast (priority: now/next/low)
+- send_message: send to a peer by display name, pubkey, @group, #channel, or * broadcast (priority: now/next/low)
 - check_messages: drain buffered inbound messages (usually auto-pushed)
 - set_summary: 1-2 sentence summary of what you're working on
 - set_status: manually override your status (idle/working/dnd)
+- join_group: join a @group with optional role
+- leave_group: leave a @group
 
 Message priority:
 - "now": delivered immediately regardless of recipient status (use sparingly)
@@ -46904,7 +46942,8 @@ No peers connected.`);
           } else {
             const peerLines = peers.map((p) => {
               const summary = p.summary ? ` — "${p.summary}"` : "";
-              return `- **${p.displayName}** [${p.status}] (${p.pubkey.slice(0, 12)}…)${summary}`;
+              const groupsStr = p.groups?.length ? ` [${p.groups.map((g) => `@${g.name}${g.role ? ":" + g.role : ""}`).join(", ")}]` : "";
+              return `- **${p.displayName}** [${p.status}]${groupsStr} (${p.pubkey.slice(0, 12)}…)${summary}`;
             });
             sections.push(`${header}
 ${peerLines.join(`
@@ -46949,6 +46988,22 @@ ${drained.join(`
           await c.setStatus(s);
         return text(`Status set to ${s} across ${allClients().length} mesh(es).`);
       }
+      case "join_group": {
+        const { name: groupName, role } = args ?? {};
+        if (!groupName)
+          return text("join_group: `name` required", true);
+        for (const c of allClients())
+          await c.joinGroup(groupName, role);
+        return text(`Joined @${groupName}${role ? ` as ${role}` : ""}`);
+      }
+      case "leave_group": {
+        const { name: groupName } = args ?? {};
+        if (!groupName)
+          return text("leave_group: `name` required", true);
+        for (const c of allClients())
+          await c.leaveGroup(groupName);
+        return text(`Left @${groupName}`);
+      }
       default:
         return text(`Unknown tool: ${name}`, true);
     }
@@ -47582,6 +47637,8 @@ import { createInterface } from "node:readline";
 function parseArgs(argv) {
   const result = {
     name: null,
+    role: null,
+    groups: null,
     joinLink: null,
     meshSlug: null,
     quiet: false,
@@ -47595,6 +47652,14 @@ function parseArgs(argv) {
       result.name = argv[++i];
     } else if (arg.startsWith("--name=")) {
       result.name = arg.slice("--name=".length);
+    } else if (arg === "--role" && i + 1 < argv.length) {
+      result.role = argv[++i];
+    } else if (arg.startsWith("--role=")) {
+      result.role = arg.slice("--role=".length);
+    } else if (arg === "--groups" && i + 1 < argv.length) {
+      result.groups = argv[++i];
+    } else if (arg.startsWith("--groups=")) {
+      result.groups = arg.slice("--groups=".length);
     } else if (arg === "--join" && i + 1 < argv.length) {
       result.joinLink = argv[++i];
     } else if (arg.startsWith("--join=")) {
@@ -47640,6 +47705,23 @@ async function pickMesh(meshes) {
     });
   });
 }
+function parseGroupsString(raw) {
+  return raw.split(",").map((s) => s.trim()).filter(Boolean).map((token) => {
+    const idx = token.indexOf(":");
+    if (idx === -1)
+      return { name: token };
+    return { name: token.slice(0, idx), role: token.slice(idx + 1) };
+  });
+}
+function askLine(prompt) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve2) => {
+    rl.question(prompt, (answer) => {
+      rl.close();
+      resolve2(answer.trim());
+    });
+  });
+}
 async function confirmPermissions() {
   const useColor = !process.env.NO_COLOR && process.env.TERM !== "dumb" && process.stdout.isTTY;
   const bold = (s) => useColor ? `\x1B[1m${s}\x1B[22m` : s;
@@ -47671,12 +47753,14 @@ async function confirmPermissions() {
     });
   });
 }
-function printBanner(name, meshSlug) {
+function printBanner(name, meshSlug, role, groups) {
   const useColor = !process.env.NO_COLOR && process.env.TERM !== "dumb" && process.stdout.isTTY;
   const dim = (s) => useColor ? `\x1B[2m${s}\x1B[22m` : s;
   const bold = (s) => useColor ? `\x1B[1m${s}\x1B[22m` : s;
+  const roleSuffix = role ? ` (${role})` : "";
+  const groupTags = groups.length ? " [" + groups.map((g) => `@${g.name}${g.role ? `:${g.role}` : ""}`).join(", ") + "]" : "";
   const rule = "─".repeat(60);
-  console.log(bold(`claudemesh launch`) + dim(` — as ${name} on ${meshSlug}`));
+  console.log(bold(`claudemesh launch`) + dim(` — as ${name}${roleSuffix} on ${meshSlug}${groupTags}`));
   console.log(rule);
   console.log("Peer messages arrive as <channel> reminders in real-time.");
   console.log("Peers send text only — they cannot call tools or read files.");
@@ -47731,6 +47815,22 @@ async function runLaunch(extraArgs) {
     mesh = await pickMesh(config2.meshes);
   }
   const displayName = args.name ?? `${hostname2()}-${process.pid}`;
+  let role = args.role;
+  let parsedGroups = args.groups ? parseGroupsString(args.groups) : [];
+  if (!args.quiet) {
+    if (role === null) {
+      const answer = await askLine("  Role (optional): ");
+      if (answer)
+        role = answer;
+    }
+    if (parsedGroups.length === 0 && args.groups === null) {
+      const answer = await askLine("  Groups (comma-separated, optional): ");
+      if (answer)
+        parsedGroups = parseGroupsString(answer);
+    }
+    if (role || parsedGroups.length)
+      console.log("");
+  }
   const tmpBase = tmpdir();
   try {
     for (const entry of readdirSync(tmpBase)) {
@@ -47746,12 +47846,13 @@ async function runLaunch(extraArgs) {
   const sessionConfig = {
     version: 1,
     meshes: [mesh],
-    displayName
+    displayName,
+    ...parsedGroups.length > 0 ? { groups: parsedGroups } : {}
   };
   writeFileSync4(join4(tmpDir, "config.json"), JSON.stringify(sessionConfig, null, 2) + `
 `, "utf-8");
   if (!args.quiet) {
-    printBanner(displayName, mesh.slug);
+    printBanner(displayName, mesh.slug, role, parsedGroups);
     if (!args.skipPermConfirm) {
       await confirmPermissions();
     }
@@ -47819,7 +47920,7 @@ init_config();
 // package.json
 var package_default = {
   name: "claudemesh-cli",
-  version: "0.1.15",
+  version: "0.2.0",
   description: "Claude Code MCP client for claudemesh — peer mesh messaging between Claude sessions.",
   keywords: [
     "claude-code",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claudemesh-cli",
-  "version": "0.1.15",
+  "version": "0.2.0",
   "description": "Claude Code MCP client for claudemesh — peer mesh messaging between Claude sessions.",
   "keywords": [
     "claude-code",