clawborrator-cli 0.0.42 → 0.0.44

package/dist-bundled/claw.cjs

@@ -68714,9 +68714,122 @@ var webhookRm = new Command("rm").alias("delete").description("remove a webhook
 });
 var webhookCmd = new Command("webhook").description("manage webhook subscriptions").addCommand(webhookAdd).addCommand(webhookList).addCommand(webhookTest).addCommand(webhookRm);
 
+// src/commands/agents.ts
+var agentsList = new Command("list").alias("ls").description("list published agents (default) or your own agents (--mine)").option("--mine", "list every agent you own, including drafts").option("--owner <login>", "list a specific creator's published agents").option("--q <text>", "substring match on handle / name / tagline").action(async (opts) => {
+  const params = new URLSearchParams();
+  if (opts.mine) params.set("mine", "true");
+  if (opts.owner) params.set("owner", opts.owner);
+  if (opts.q) params.set("q", opts.q);
+  const qs = params.toString() ? "?" + params.toString() : "";
+  const data = await api.get(`/api/v1/agents${qs}`);
+  if (data.items.length === 0) {
+    console.log("no agents");
+    return;
+  }
+  for (const a of data.items) {
+    const dot = a.online ? "\u25CF" : "\u25CB";
+    const tag2 = a.status === "draft" ? " [draft]" : "";
+    const iso = a.isolated ? " [isolated]" : " [composable]";
+    const stats = `${a.queriesAllTime} queries`;
+    const tagln = a.tagline ? ` \u2014 ${a.tagline}` : "";
+    console.log(`${dot} @${a.handle}${tag2}${iso}  ${a.name}  ${stats}${tagln}`);
+  }
+});
+var agentsPublish = new Command("publish").description("publish a session as a public agent").requiredOption("--session <id>", "the session UUID to back the agent").requiredOption("--name <name>", 'display name (e.g. "viper-rust-expert")').option("--tagline <text>", "one-line description (160 chars max)").option("--description <text>", "long-form description, markdown allowed (4 KB max)").option("--slug <slug>", "explicit slug (default: derived from session routingName)").option("--draft", "publish as draft (status=draft); use --published to go live immediately").option("--published", "publish as live (status=published)").option("--budget <n>", "daily budget in queries (default 1000, max 100000)", (v) => parseInt(v, 10)).option("--concurrency <n>", "concurrent in-flight queries cap (default 5, max 20)", (v) => parseInt(v, 10)).option("--isolated", "isolated mode: agent CC cannot use cross-session routing tools while answering (default true; safer)").option("--composable", "composable mode: agent CC may use cross-session routing tools (gated against the requester's own access)").action(async (opts) => {
+  const status = opts.published ? "published" : "draft";
+  const body = {
+    sessionId: opts.session,
+    name: opts.name,
+    status
+  };
+  if (opts.tagline) body.tagline = opts.tagline;
+  if (opts.description) body.description = opts.description;
+  if (opts.slug) body.slug = opts.slug;
+  if (typeof opts.budget === "number") body.dailyBudgetQueries = opts.budget;
+  if (typeof opts.concurrency === "number") body.concurrencyCap = opts.concurrency;
+  if (opts.composable) body.isolated = false;
+  else if (opts.isolated) body.isolated = true;
+  const r = await api.post("/api/v1/agents", body);
+  console.log(`\u2713 ${r.restored ? "restored" : "published"} agent: @${r.handle}`);
+  console.log(`  name:    ${r.name}`);
+  console.log(`  status:  ${r.status}`);
+  console.log(`  mode:    ${r.isolated ? "isolated (cross-session routing disabled while answering)" : "composable (CC may route to peers)"}`);
+  console.log(`  budget:  ${r.dailyBudgetQueries}/day, concurrency ${r.concurrencyCap}`);
+  console.log(`  session: ${r.sessionId}`);
+  if (r.status === "draft") {
+    console.log(`  next:    'claw agents update --status published @${r.handle}' to make it live`);
+  } else {
+    console.log(`  call as: '@${r.handle} <question>' from any session prompt`);
+  }
+});
+var agentsUpdate = new Command("update").description("update an agent").argument("<handle>", "@owner/slug").option("--status <s>", "draft | published").option("--name <name>").option("--tagline <text>").option("--description <text>").option("--budget <n>", "daily budget in queries", (v) => parseInt(v, 10)).option("--concurrency <n>", "concurrency cap", (v) => parseInt(v, 10)).option("--isolated", "switch to isolated mode (block cross-session routing while answering)").option("--composable", "switch to composable mode (allow cross-session routing tools)").action(async (handleArg, opts) => {
+  const handle = handleArg.replace(/^@/, "");
+  const agent = await api.get(`/api/v1/agents/by-handle/${encodeURIComponent(handle.split("/")[0])}/${encodeURIComponent(handle.split("/")[1] ?? "")}`);
+  const body = {};
+  if (opts.status) body.status = opts.status;
+  if (opts.name) body.name = opts.name;
+  if (opts.tagline) body.tagline = opts.tagline;
+  if (opts.description) body.description = opts.description;
+  if (typeof opts.budget === "number") body.dailyBudgetQueries = opts.budget;
+  if (typeof opts.concurrency === "number") body.concurrencyCap = opts.concurrency;
+  if (opts.composable) body.isolated = false;
+  else if (opts.isolated) body.isolated = true;
+  if (Object.keys(body).length === 0) {
+    console.error("no fields to update");
+    process.exit(2);
+  }
+  const r = await api.patch(`/api/v1/agents/${agent.id}`, body);
+  console.log(`\u2713 updated @${r.handle}`);
+  console.log(`  status:  ${r.status}`);
+  console.log(`  mode:    ${r.isolated ? "isolated" : "composable"}`);
+  console.log(`  budget:  ${r.dailyBudgetQueries}/day, concurrency ${r.concurrencyCap}`);
+});
+var agentsUnpublish = new Command("unpublish").description("soft-delete an agent (drops its handle)").argument("<handle>", "@owner/slug").action(async (handleArg) => {
+  const handle = handleArg.replace(/^@/, "");
+  const [owner, slug] = handle.split("/");
+  if (!owner || !slug) {
+    console.error("expected handle in @owner/slug form");
+    process.exit(2);
+  }
+  const agent = await api.get(`/api/v1/agents/by-handle/${encodeURIComponent(owner)}/${encodeURIComponent(slug)}`);
+  await api.delete(`/api/v1/agents/${agent.id}`);
+  console.log(`\u2713 unpublished @${handle}`);
+});
+var agentsInbound = new Command("inbound").description("audit view: who has been calling your agent").argument("<handle>", "@owner/slug").option("--days <n>", "1-30 (default 7)", (v) => parseInt(v, 10), 7).action(async (handleArg, opts) => {
+  const handle = handleArg.replace(/^@/, "");
+  const [owner, slug] = handle.split("/");
+  if (!owner || !slug) {
+    console.error("expected handle in @owner/slug form");
+    process.exit(2);
+  }
+  const agent = await api.get(`/api/v1/agents/by-handle/${encodeURIComponent(owner)}/${encodeURIComponent(slug)}`);
+  const data = await api.get(`/api/v1/agents/${agent.id}/inbound?days=${opts.days}`);
+  console.log(`@${data.agent.handle}  (${data.window.days}-day window)`);
+  console.log(`  total: ${data.summary.total}  ok: ${data.summary.ok}  denied: ${data.summary.denied}  avg-latency: ${data.summary.avgLatencyMs ?? "\u2014"}ms  askers: ${data.summary.distinctAskers}`);
+  if (data.topAskers.length) {
+    console.log("");
+    console.log("top askers:");
+    for (const t of data.topAskers) {
+      console.log(`  @${t.login.padEnd(20)} ${String(t.count).padStart(4)} queries  last: ${t.lastAt}`);
+    }
+  }
+  if (data.recent.length) {
+    console.log("");
+    console.log("recent:");
+    for (const r of data.recent.slice(0, 20)) {
+      const flag = r.ok ? "\u2713" : "\u2717";
+      const lat = r.latencyMs != null ? ` ${r.latencyMs}ms` : "";
+      const why = r.deniedReason ? ` [${r.deniedReason}]` : "";
+      const q = r.question.length > 70 ? r.question.slice(0, 67) + "\u2026" : r.question;
+      console.log(`  ${flag} ${r.ts}  @${r.askerLogin}${lat}${why}  ${q}`);
+    }
+  }
+});
+var agentsCmd = new Command("agents").description("public expert agents \u2014 list, publish, update, audit").addCommand(agentsList).addCommand(agentsPublish).addCommand(agentsUpdate).addCommand(agentsUnpublish).addCommand(agentsInbound);
+
 // 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.42");
+program2.name("claw").description("clawborrator CLI \u2014 control your Claude Code sessions from the terminal").version("0.0.43");
 program2.addCommand(loginCmd);
 program2.addCommand(logoutCmd);
 program2.addCommand(whoamiCmd);
@@ -68726,6 +68839,7 @@ program2.addCommand(peersCmd);
 program2.addCommand(routeCmd);
 program2.addCommand(probeCmd);
 program2.addCommand(webhookCmd);
+program2.addCommand(agentsCmd);
 program2.parseAsync(process.argv).catch((err) => {
   console.error(err.message ?? err);
   process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawborrator-cli",
-  "version": "0.0.42",
+  "version": "0.0.44",
   "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",