clawborrator-cli 0.0.5 → 0.0.7

package/dist-bundled/claw.cjs

@@ -6868,12 +6868,23 @@ var GREEN = "\x1B[32m";
 function ts() {
   return (/* @__PURE__ */ new Date()).toLocaleTimeString();
 }
-var sessionAttach = new Command("attach").description("open a TUI on a session \u2014 see the chat stream, post op-messages").argument("<sessionId>", "session UUID").action(async (sessionId) => {
+var sessionAttach = new Command("attach").description("open a TUI on a session \u2014 see the chat stream, post op-messages").argument("<ref>", "session UUID or @routingName (e.g. @driver)").action(async (ref) => {
   const cfg = loadConfig();
   if (!cfg.pat) {
     console.error("error: not logged in. run `claw login`.");
     process.exit(2);
   }
+  let sessionId = ref;
+  if (sessionId.startsWith("@")) {
+    const wanted = sessionId.slice(1);
+    const data = await api.get("/api/v1/sessions");
+    const match = data.items.find((s) => s.routingName === wanted);
+    if (!match) {
+      console.error(`error: no session with routing name @${wanted} (run \`claw session list\` to see what's available)`);
+      process.exit(2);
+    }
+    sessionId = match.id;
+  }
   const wsUrl = cfg.hubUrl.replace(/^http/i, "ws") + "/cli";
   const ws = new wrapper_default(wsUrl, {
     headers: { Authorization: `Bearer ${cfg.pat}` }
@@ -7208,7 +7219,7 @@ var sessionInit = new Command("init").description("install clawborrator hooks in
   if (alreadyPresent > 0) console.log(`  (${alreadyPresent} already up-to-date, untouched)`);
   console.log("");
   console.log("next: drop a .mcp.json with your channel token (`claw token mint --kind=channel");
-  console.log("      --name=<label> --mcp-snippet > .mcp.json`), then start CC with:");
+  console.log("      --name=<label> --mcp-snippet --out=.mcp.json`), then start CC with:");
   console.log("        claude --dangerously-load-development-channels server:clawborrator");
   console.log("      events will flow as you prompt; watch via `claw session attach <id>`.");
 });
@@ -7267,6 +7278,18 @@ function fmtDuration(ms) {
 function fmtAgo(iso) {
   return fmtDuration(Date.now() - new Date(iso).getTime());
 }
+async function resolveSessionId(idOrName) {
+  if (!idOrName.startsWith("@")) return idOrName;
+  const wanted = idOrName.slice(1);
+  const data = await api.get("/api/v1/sessions");
+  const match = data.items.find((s) => s.routingName === wanted);
+  if (!match) {
+    const err = new Error(`no session with routing name @${wanted} (run \`claw session list\` to see what's available)`);
+    err.code = "CLW_NO_ROUTING_MATCH";
+    throw err;
+  }
+  return match.id;
+}
 var sessionList = new Command("list").alias("ls").description("list sessions you can see").option("--connected", "only sessions whose channel WS is currently open").option("--all", "include archived sessions").action(async (opts) => {
   const qs = new URLSearchParams();
   if (opts.connected) qs.set("connected", "true");
@@ -7286,9 +7309,15 @@ var sessionList = new Command("list").alias("ls").description("list sessions you
     const seen = s.connected ? "online" : `offline \xB7 ${fmtAgo(s.lastSeenAt)}`;
     const arch = s.archivedAt ? " \xB7 ARCHIVED" : "";
     console.log(`${dot} ${route.padEnd(20)} ${role} @${s.startedByLogin}${where}  [${seen}]${arch}`);
+    console.log(`    id: ${s.id}`);
   }
+  console.log("");
+  console.log("  use: claw session attach @<routing>   OR   claw session attach <id>");
+  console.log("       claw session events <ref>        \u2014 recent hook/chat events");
+  console.log("       claw session messages <ref>      \u2014 operator-to-operator chat");
 });
-var sessionInfo = new Command("info").description("show metadata for a single session").argument("<id>", "session UUID").action(async (id) => {
+var sessionInfo = new Command("info").description("show metadata for a single session").argument("<ref>", "session UUID or @routingName").action(async (ref) => {
+  const id = await resolveSessionId(ref);
   const s = await api.get(`/api/v1/sessions/${encodeURIComponent(id)}`);
   console.log(`session  : ${s.id}`);
   console.log(`routing  : ${s.routingName ?? "(none)"}`);
@@ -7301,11 +7330,12 @@ var sessionInfo = new Command("info").description("show metadata for a single se
   console.log(`last seen: ${s.lastSeenAt}`);
   console.log(`status   : ${s.connected ? "connected" : "offline"}${s.archivedAt ? " \xB7 ARCHIVED" : ""}`);
 });
-var sessionEvents = new Command("events").description("dump recent events for a session (history; non-TUI)").argument("<id>", "session UUID").option("--limit <n>", "max events to return (default 200, max 1000)", "200").option("--after <id>", "forward pagination: events with id > given").option("--before <id>", "backward pagination: events with id < given").option("--kind <k>", "filter to chat or tail").option("--type <t>", "filter by type (e.g. PreToolUse, reply)").option("--json", "emit one JSON object per line instead of human-readable").action(async (id, opts) => {
+var sessionEvents = new Command("events").description("dump recent events for a session (history; non-TUI)").argument("<ref>", "session UUID or @routingName").option("--limit <n>", "max events to return (default 200, max 1000)", "200").option("--after <id>", "forward pagination: events with id > given").option("--before <id>", "backward pagination: events with id < given").option("--kind <k>", "filter to chat or tail").option("--type <t>", "filter by type (e.g. PreToolUse, reply)").option("--json", "emit one JSON object per line instead of human-readable").action(async (ref, opts) => {
   if (opts.after && opts.before) {
     console.error("error: use --after OR --before, not both");
     process.exit(2);
   }
+  const id = await resolveSessionId(ref);
   const qs = new URLSearchParams({ limit: opts.limit ?? "200" });
   if (opts.after) qs.set("after", opts.after);
   if (opts.before) qs.set("before", opts.before);
@@ -7332,11 +7362,12 @@ var sessionEvents = new Command("events").description("dump recent events for a
     console.log(`(more \u2014 older: --before ${data.firstId} \xB7 newer: --after ${data.lastId})`);
   }
 });
-var sessionMessages = new Command("messages").alias("msgs").description("dump operator-to-operator chat for a session (op-messages history)").argument("<id>", "session UUID").option("--limit <n>", "max messages to return (default 100, max 500)", "100").option("--after <id>", "forward pagination").option("--before <id>", "backward pagination").option("--json", "emit one JSON object per line").action(async (id, opts) => {
+var sessionMessages = new Command("messages").alias("msgs").description("dump operator-to-operator chat for a session (op-messages history)").argument("<ref>", "session UUID or @routingName").option("--limit <n>", "max messages to return (default 100, max 500)", "100").option("--after <id>", "forward pagination").option("--before <id>", "backward pagination").option("--json", "emit one JSON object per line").action(async (ref, opts) => {
   if (opts.after && opts.before) {
     console.error("error: use --after OR --before, not both");
     process.exit(2);
   }
+  const id = await resolveSessionId(ref);
   const qs = new URLSearchParams({ limit: opts.limit ?? "100" });
   if (opts.after) qs.set("after", opts.after);
   if (opts.before) qs.set("before", opts.before);
@@ -7362,6 +7393,10 @@ var sessionMessages = new Command("messages").alias("msgs").description("dump op
 });
 var sessionCmd = new Command("session").description("manage Claude Code sessions registered with this hub").addCommand(sessionList).addCommand(sessionInfo).addCommand(sessionAttach).addCommand(sessionInit).addCommand(sessionEvents).addCommand(sessionMessages);
 
+// src/commands/token.ts
+var import_node_fs3 = require("node:fs");
+var import_node_path3 = require("node:path");
+
 // ../shared/dist/scopes.js
 var ALL_SCOPES = [
   "me:read",
@@ -7393,17 +7428,18 @@ var CLI_DEFAULT_SCOPES = [
 ];
 
 // src/commands/token.ts
-var tokenMint = new Command("mint").description("create a new token").requiredOption("--kind <kind>", "channel | pat").requiredOption("--name <name>", 'human-readable label (e.g. "alice-laptop")').option("--scopes <csv>", "comma-separated scopes (PAT only); default = sensible CLI set").option("--app <name>", "pin the PAT to a specific app (display only)").option("--mcp-snippet", "after minting a channel token, print ONLY the .mcp.json block to stdout (prose to stderr) so you can pipe it: `... --mcp-snippet > .mcp.json`").action(async (opts) => {
+var tokenMint = new Command("mint").description("create a new token").requiredOption("--kind <kind>", "channel | pat").requiredOption("--name <name>", 'human-readable label (e.g. "alice-laptop")').option("--scopes <csv>", "comma-separated scopes (PAT only); default = sensible CLI set").option("--app <name>", "pin the PAT to a specific app (display only)").option("--mcp-snippet", "after minting a channel token, also produce a ready-to-use .mcp.json block. By default writes to stdout (prose to stderr); pair with --out=<path> to write the file directly (recommended on Windows \u2014 `>` redirection in PowerShell encodes as UTF-16 w/ BOM, which CC rejects).").option("--out <path>", "when used with --mcp-snippet, write the JSON to <path> (UTF-8, no BOM) instead of stdout. Pass `.mcp.json` for the canonical project location.").action(async (opts) => {
   if (opts.kind === "channel") {
     const out = await api.post("/api/v1/tokens/channel", { name: opts.name });
-    const prose = opts.mcpSnippet ? console.error : console.log;
+    const proseToStderr = opts.mcpSnippet && !opts.out;
+    const prose = proseToStderr ? console.error : console.log;
     prose(`\u2713 channel token minted: ${out.name}`);
     prose(`  ${out.token}`);
     prose("  (shown ONCE \u2014 store it now)");
     if (opts.mcpSnippet) {
       const cfg = loadConfig();
       const wsUrl = cfg.hubUrl.replace(/^http(s?):\/\//, "ws$1://");
-      process.stdout.write(JSON.stringify({
+      const json = JSON.stringify({
         mcpServers: {
           clawborrator: {
             command: "npx",
@@ -7414,7 +7450,15 @@ var tokenMint = new Command("mint").description("create a new token").requiredOp
             }
           }
         }
-      }, null, 2) + "\n");
+      }, null, 2) + "\n";
+      if (opts.out) {
+        const target = (0, import_node_path3.resolve)(opts.out);
+        (0, import_node_fs3.writeFileSync)(target, json, "utf8");
+        prose("");
+        prose(`\u2713 wrote ${target}`);
+      } else {
+        process.stdout.write(json);
+      }
       prose("");
       prose("  next: launch CC with the clawborrator channel enabled \u2014");
       prose("    claude --dangerously-load-development-channels server:clawborrator");
@@ -7555,7 +7599,7 @@ var webhookCmd = new Command("webhook").description("manage webhook subscription
 
 // src/index.ts
 var program2 = new Command();
-program2.name("claw").description("clawborrator CLI \u2014 control your Claude Code sessions from the terminal").version("0.0.5");
+program2.name("claw").description("clawborrator CLI \u2014 control your Claude Code sessions from the terminal").version("0.0.7");
 program2.addCommand(loginCmd);
 program2.addCommand(logoutCmd);
 program2.addCommand(whoamiCmd);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawborrator-cli",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "type": "module",
   "description": "claw — command-line client for clawborrator hub_v1. Manages PATs, channel tokens, sessions, cross-session routing, and webhooks; ships an inline TUI for live multi-operator session attach.",
   "license": "MIT",