claudemesh-cli 1.6.1 → 1.7.0

package/README.md

@@ -2,7 +2,9 @@
 
 Peer mesh for Claude Code sessions. Connect multiple Claude Code instances into a shared mesh with real-time messaging, shared state, memory, file sharing, vector store, scheduled jobs, and more — all driven from the `claudemesh` CLI. The MCP server is a tool-less push-pipe that delivers inbound peer messages to Claude as `<channel>` interrupts; everything else lives behind CLI verbs that Claude learns from the auto-installed `claudemesh` skill.
 
-> **What's new in 1.6.0:** topics (channel pub/sub), API keys for human/REST clients, and bridge peers that forward a topic between two meshes. New verbs: `claudemesh topic`, `claudemesh apikey`, `claudemesh bridge`. A REST surface at `https://claudemesh.com/api/v1/*` (messages, topics, peers, history) accepts `Authorization: Bearer cm_...` keys, so any HTTPS client can participate without WebSocket + ed25519 plumbing. **Note**: REST lives on the web host (`claudemesh.com`), not the broker host (`ic.claudemesh.com`) — the broker only speaks WebSocket.
+> **What's new in 1.7.0:** terminal parity for the v1.6.x server features. New verbs: `claudemesh topic tail` (live SSE message stream — Ctrl-C to exit), `claudemesh notification list` (recent `@you` mentions across topics), `claudemesh member list` (mesh roster with online dots, distinct from `peer list`'s live-session view). Each command auto-mints a 5-minute read-only apikey via the WebSocket and revokes it on exit, so no token plumbing is needed.
+>
+> **What was new in 1.6.0:** topics (channel pub/sub), API keys for human/REST clients, and bridge peers that forward a topic between two meshes. New verbs: `claudemesh topic`, `claudemesh apikey`, `claudemesh bridge`. A REST surface at `https://claudemesh.com/api/v1/*` (messages, topics, peers, history) accepts `Authorization: Bearer cm_...` keys, so any HTTPS client can participate without WebSocket + ed25519 plumbing. **Note**: REST lives on the web host (`claudemesh.com`), not the broker host (`ic.claudemesh.com`) — the broker only speaks WebSocket.
 >
 > **Migration note (1.5.0):** the previous 79 MCP tools (`send_message`, `list_peers`, `remember`, …) are removed. Use the matching CLI verbs (`claudemesh send`, `claudemesh peers`, `claudemesh remember`). Run `claudemesh install` and the bundled skill teaches Claude the full surface.
 
@@ -43,6 +45,9 @@ USAGE
   claudemesh profile         view or edit your profile
 
   claudemesh topic ...       create, list, join, send to topics
+  claudemesh topic tail <t>  live SSE tail of a topic
+  claudemesh member list     mesh roster with online state
+  claudemesh notification list  recent @-mentions of you
   claudemesh apikey ...      issue, list, revoke API keys (REST clients)
   claudemesh bridge ...      forward a topic between two meshes
 

package/dist/entrypoints/cli.js

@@ -88,7 +88,7 @@ __export(exports_urls, {
   VERSION: () => VERSION,
   URLS: () => URLS
 });
-var URLS, VERSION = "1.6.1", env;
+var URLS, VERSION = "1.7.0", env;
 var init_urls = __esm(() => {
   URLS = {
     BROKER: process.env.CLAUDEMESH_BROKER_URL ?? "wss://ic.claudemesh.com/ws",
@@ -11648,6 +11648,304 @@ var init_topic = __esm(() => {
   init_exit_codes();
 });
 
+// src/services/api/with-rest-key.ts
+async function withRestKey(opts, fn) {
+  return withMesh({ meshSlug: opts.meshSlug ?? null }, async (client, mesh) => {
+    const result = await client.apiKeyCreate({
+      label: `cli-${opts.purpose ?? "rest"}-${process.pid}`,
+      capabilities: opts.capabilities ?? ["read"],
+      topicScopes: opts.topicScopes ?? undefined,
+      expiresAt: new Date(Date.now() + 5 * 60 * 1000).toISOString()
+    });
+    if (!result || !result.secret) {
+      throw new Error("apikey mint failed — broker did not return a secret");
+    }
+    try {
+      return await fn({
+        secret: result.secret,
+        meshId: mesh.meshId,
+        meshSlug: mesh.slug,
+        client,
+        mesh
+      });
+    } finally {
+      try {
+        await client.apiKeyRevoke(result.id);
+      } catch {}
+    }
+  });
+}
+var init_with_rest_key = __esm(() => {
+  init_connect();
+});
+
+// src/commands/topic-tail.ts
+var exports_topic_tail = {};
+__export(exports_topic_tail, {
+  runTopicTail: () => runTopicTail
+});
+function decodeCiphertext(b64) {
+  try {
+    return Buffer.from(b64, "base64").toString("utf-8");
+  } catch {
+    return "[decode failed]";
+  }
+}
+function fmtTime(iso) {
+  try {
+    return new Date(iso).toLocaleTimeString([], {
+      hour: "2-digit",
+      minute: "2-digit",
+      second: "2-digit"
+    });
+  } catch {
+    return iso;
+  }
+}
+function printMessage(m, json) {
+  const text = decodeCiphertext(m.ciphertext);
+  if (json) {
+    console.log(JSON.stringify({ ...m, message: text }));
+    return;
+  }
+  process.stdout.write(`  ${dim(fmtTime(m.createdAt))}  ${bold(m.senderName || m.senderPubkey.slice(0, 8))}  ${text}
+`);
+}
+async function* readSseStream(reader) {
+  const decoder = new TextDecoder;
+  let buffer = "";
+  while (true) {
+    const { value, done } = await reader.read();
+    if (done)
+      break;
+    buffer += decoder.decode(value, { stream: true });
+    let idx;
+    while ((idx = buffer.indexOf(`
+
+`)) !== -1) {
+      const block = buffer.slice(0, idx);
+      buffer = buffer.slice(idx + 2);
+      const ev = { event: "message", data: "" };
+      const dataLines = [];
+      for (const line of block.split(`
+`)) {
+        if (!line || line.startsWith(":"))
+          continue;
+        const colon = line.indexOf(":");
+        if (colon < 0)
+          continue;
+        const field = line.slice(0, colon);
+        const val = line.slice(colon + 1).replace(/^ /, "");
+        if (field === "event")
+          ev.event = val;
+        else if (field === "id")
+          ev.id = val;
+        else if (field === "data")
+          dataLines.push(val);
+      }
+      ev.data = dataLines.join(`
+`);
+      yield ev;
+    }
+  }
+}
+async function runTopicTail(name, flags) {
+  if (!name) {
+    render.err("Usage: claudemesh topic tail <topic> [--limit N]");
+    return EXIT.INVALID_ARGS;
+  }
+  const cleanName = name.replace(/^#/, "");
+  const limit = flags.limit ? Number(flags.limit) : 20;
+  return withRestKey({
+    meshSlug: flags.mesh ?? null,
+    purpose: `tail-${cleanName}`,
+    capabilities: ["read"],
+    topicScopes: [cleanName]
+  }, async ({ secret, meshSlug }) => {
+    if (!flags.forwardOnly && limit > 0) {
+      try {
+        const history = await request({
+          path: `/api/v1/topics/${encodeURIComponent(cleanName)}/messages?limit=${limit}`,
+          token: secret
+        });
+        if (!flags.json) {
+          render.section(`${clay("#" + cleanName)} on ${dim(meshSlug)} — backfill ${history.messages.length}, then live`);
+        }
+        for (const m of history.messages.slice().reverse()) {
+          printMessage(m, flags.json ?? false);
+        }
+      } catch (err) {
+        render.warn(`backfill failed: ${err.message}`);
+      }
+    }
+    const url = `${URLS.API_BASE}/api/v1/topics/${encodeURIComponent(cleanName)}/stream`;
+    const ctl = new AbortController;
+    const onSig = () => ctl.abort();
+    process.once("SIGINT", onSig);
+    process.once("SIGTERM", onSig);
+    try {
+      const res = await fetch(url, {
+        headers: { Authorization: `Bearer ${secret}` },
+        signal: ctl.signal
+      });
+      if (!res.ok || !res.body) {
+        render.err(`stream open failed: ${res.status}`);
+        return EXIT.INTERNAL_ERROR;
+      }
+      if (!flags.json) {
+        render.info(dim("tailing — Ctrl-C to exit"));
+      }
+      const reader = res.body.getReader();
+      for await (const ev of readSseStream(reader)) {
+        if (ev.event === "ready" || ev.event === "heartbeat")
+          continue;
+        if (ev.event === "error") {
+          try {
+            const parsed = JSON.parse(ev.data);
+            render.err(`stream error: ${parsed.error ?? "unknown"}`);
+          } catch {
+            render.err("stream error");
+          }
+          continue;
+        }
+        if (ev.event === "message") {
+          try {
+            const m = JSON.parse(ev.data);
+            printMessage(m, flags.json ?? false);
+          } catch {}
+        }
+      }
+      return EXIT.SUCCESS;
+    } catch (err) {
+      if (ctl.signal.aborted)
+        return EXIT.SUCCESS;
+      render.err(`tail aborted: ${err.message}`);
+      return EXIT.INTERNAL_ERROR;
+    } finally {
+      process.removeListener("SIGINT", onSig);
+      process.removeListener("SIGTERM", onSig);
+    }
+  });
+}
+var init_topic_tail = __esm(() => {
+  init_urls();
+  init_with_rest_key();
+  init_client();
+  init_render();
+  init_styles();
+  init_exit_codes();
+});
+
+// src/commands/notification.ts
+var exports_notification = {};
+__export(exports_notification, {
+  runNotificationList: () => runNotificationList
+});
+function decodeCiphertext2(b64) {
+  try {
+    return Buffer.from(b64, "base64").toString("utf-8");
+  } catch {
+    return "[decode failed]";
+  }
+}
+function fmtRelative(iso) {
+  const ms = Date.now() - new Date(iso).getTime();
+  if (ms < 60000)
+    return "now";
+  if (ms < 3600000)
+    return `${Math.floor(ms / 60000)}m`;
+  if (ms < 86400000)
+    return `${Math.floor(ms / 3600000)}h`;
+  return `${Math.floor(ms / 86400000)}d`;
+}
+async function runNotificationList(flags) {
+  return withRestKey({ meshSlug: flags.mesh ?? null, purpose: "notifications" }, async ({ secret }) => {
+    const qs = flags.since ? `?since=${encodeURIComponent(flags.since)}` : "";
+    const result = await request({
+      path: `/api/v1/notifications${qs}`,
+      token: secret
+    });
+    if (flags.json) {
+      const decoded = result.notifications.map((n) => ({
+        ...n,
+        message: decodeCiphertext2(n.ciphertext)
+      }));
+      console.log(JSON.stringify({ ...result, notifications: decoded }, null, 2));
+      return EXIT.SUCCESS;
+    }
+    if (result.notifications.length === 0) {
+      render.info(dim(`no mentions of @${result.mentionedAs} since ${result.since}.`));
+      return EXIT.SUCCESS;
+    }
+    render.section(`mentions of @${bold(result.mentionedAs)} (${result.notifications.length})`);
+    for (const n of result.notifications) {
+      const when = fmtRelative(n.createdAt);
+      const msg = decodeCiphertext2(n.ciphertext).replace(/\s+/g, " ").trim();
+      const snippet = msg.length > 100 ? msg.slice(0, 97) + "…" : msg;
+      process.stdout.write(`  ${clay("#" + n.topicName)}  ${dim(when)}  ${bold(n.senderName)}
+`);
+      process.stdout.write(`    ${snippet}
+`);
+    }
+    return EXIT.SUCCESS;
+  });
+}
+var init_notification = __esm(() => {
+  init_with_rest_key();
+  init_client();
+  init_render();
+  init_styles();
+  init_exit_codes();
+});
+
+// src/commands/member.ts
+var exports_member = {};
+__export(exports_member, {
+  runMemberList: () => runMemberList
+});
+function statusGlyph(m) {
+  if (!m.online)
+    return dim("○");
+  if (m.status === "dnd")
+    return red("●");
+  if (m.status === "working")
+    return yellow("●");
+  return green("●");
+}
+async function runMemberList(flags) {
+  return withRestKey({ meshSlug: flags.mesh ?? null, purpose: "members" }, async ({ secret, meshSlug }) => {
+    const result = await request({
+      path: "/api/v1/members",
+      token: secret
+    });
+    const filtered = flags.online ? result.members.filter((m) => m.online) : result.members;
+    if (flags.json) {
+      console.log(JSON.stringify({ members: filtered }, null, 2));
+      return EXIT.SUCCESS;
+    }
+    if (filtered.length === 0) {
+      render.info(dim(flags.online ? `no online members in ${meshSlug}.` : `no members in ${meshSlug}.`));
+      return EXIT.SUCCESS;
+    }
+    const onlineCount = result.members.filter((m) => m.online).length;
+    render.section(`${clay(meshSlug)} members (${onlineCount}/${result.members.length} online)`);
+    for (const m of filtered) {
+      const tag = m.isHuman ? dim("human") : dim("bot");
+      const summary = m.summary ? ` — ${dim(m.summary)}` : "";
+      process.stdout.write(`  ${statusGlyph(m)} ${bold(m.displayName)}  ${tag}  ${dim(m.role)}  ${dim(m.pubkey.slice(0, 8))}${summary}
+`);
+    }
+    return EXIT.SUCCESS;
+  });
+}
+var init_member = __esm(() => {
+  init_with_rest_key();
+  init_client();
+  init_render();
+  init_styles();
+  init_exit_codes();
+});
+
 // src/mcp/tools/definitions.ts
 var TOOLS;
 var init_definitions = __esm(() => {
@@ -13219,7 +13517,10 @@ Topic  (conversation scope, v0.2.0)
   claudemesh topic members <t>     list topic subscribers
   claudemesh topic history <t>     fetch message history [--limit --before]
   claudemesh topic read <topic>    mark all as read
+  claudemesh topic tail <topic>    live SSE tail [--limit --forward-only]
   claudemesh send "#topic" "msg"   send to a topic
+  claudemesh member list           mesh roster with online state [--online]
+  claudemesh notification list     recent @-mentions of you [--since <ISO>]
 
 Schedule  (resource form)
   claudemesh schedule msg <m>      one-shot or recurring     (alias: remind)
@@ -13998,8 +14299,51 @@ async function main() {
       } else if (sub === "read") {
         const { runTopicMarkRead: runTopicMarkRead2 } = await Promise.resolve().then(() => (init_topic(), exports_topic));
         process.exit(await runTopicMarkRead2(arg, f));
+      } else if (sub === "tail") {
+        const tailFlags = {
+          mesh: flags.mesh,
+          json: !!flags.json,
+          limit: flags.limit,
+          forwardOnly: !!flags["forward-only"]
+        };
+        const { runTopicTail: runTopicTail2 } = await Promise.resolve().then(() => (init_topic_tail(), exports_topic_tail));
+        process.exit(await runTopicTail2(arg, tailFlags));
+      } else {
+        console.error("Usage: claudemesh topic <create|list|join|leave|members|history|read|tail>");
+        process.exit(EXIT.INVALID_ARGS);
+      }
+      break;
+    }
+    case "notification":
+    case "notifications": {
+      const sub = positionals[0] ?? "list";
+      const f = {
+        mesh: flags.mesh,
+        json: !!flags.json,
+        since: flags.since
+      };
+      if (sub === "list") {
+        const { runNotificationList: runNotificationList2 } = await Promise.resolve().then(() => (init_notification(), exports_notification));
+        process.exit(await runNotificationList2(f));
+      } else {
+        console.error("Usage: claudemesh notification list [--since <ISO>]");
+        process.exit(EXIT.INVALID_ARGS);
+      }
+      break;
+    }
+    case "member":
+    case "members": {
+      const sub = positionals[0] ?? "list";
+      const f = {
+        mesh: flags.mesh,
+        json: !!flags.json,
+        online: !!flags.online
+      };
+      if (sub === "list") {
+        const { runMemberList: runMemberList2 } = await Promise.resolve().then(() => (init_member(), exports_member));
+        process.exit(await runMemberList2(f));
       } else {
-        console.error("Usage: claudemesh topic <create|list|join|leave|members|history|read>");
+        console.error("Usage: claudemesh member list [--online]");
         process.exit(EXIT.INVALID_ARGS);
       }
       break;
@@ -14052,4 +14396,4 @@ main().catch((err) => {
   process.exit(EXIT.INTERNAL_ERROR);
 });
 
-//# debugId=131DC57DB8537D5464756E2164756E21
+//# debugId=81FA5977F36B50C364756E2164756E21