@great-arrow/cli 0.1.55 → 0.1.57

package/README.md

@@ -227,6 +227,7 @@ and MCP reachability.
 ### Agents
 
 ```bash
+gad agents            # who is working right now, and where
 gad agent list
 gad agent invoke research-analyst --task "Summarize Q2 metrics"
 gad ask "What did we decide about the caching layer?"

package/dist/index.js

@@ -9402,7 +9402,7 @@ function isNodeError(value) {
 
 // src/lib/version.ts
 var CLI_PACKAGE_NAME = "@great-arrow/cli";
-var CLI_VERSION = "0.1.55";
+var CLI_VERSION = "0.1.57";
 var GAD_INSTALL_VERSION = "2026.08.08";
 var GAD_INSTALL_MIN_VERSION = "2026.06.22";
 var GAD_INSTALL_HEADER = "X-GAD-Install-Version";
@@ -10129,6 +10129,9 @@ async function confirm(message) {
     });
   });
 }
+function stripControlChars(s) {
+  return String(s).replace(/[\u0000-\u001f\u007f-\u009f]/g, "");
+}
 
 // src/lib/formatter.ts
 var Formatter = class {
@@ -11828,7 +11831,9 @@ var TODO_COLUMNS = [
       if (Number.isNaN(date.getTime())) return str;
       return date.toLocaleDateString();
     }
-  }
+  },
+  // Every card the CLI lists is clickable (owner rule 2026-10-06).
+  { key: "url", header: "Link" }
 ];
 var listCommand2 = new Command("list").description("List open todos sorted by priority").option(
   "--status <status>",
@@ -17221,6 +17226,68 @@ agentCommand.command("invoke <agent-id>").description("Execute an agent with a t
   }
 });
 
+// src/commands/agents.ts
+function groupTitle(where, rawMachine) {
+  const machine = rawMachine ? stripControlChars(String(rawMachine)) : "";
+  switch (where) {
+    case "this_computer":
+      return machine ? `On ${machine}` : "On your computers";
+    case "remote_machine":
+      return machine ? `On ${machine} (remote)` : "On a remote machine";
+    case "vendor_cloud":
+      return "In the cloud";
+    case "great_arrow":
+      return "Great Arrow agents";
+    default:
+      return "Location not reported";
+  }
+}
+function itemLine(item) {
+  const name = stripControlChars(String(item.who ?? ""));
+  const who = typeof item.sessions === "number" && item.sessions > 1 ? `${name} (${item.sessions} sessions)` : name;
+  const detail = item.detail ? stripControlChars(String(item.detail)) : "";
+  return detail ? `  ${who} \u2014 ${detail}` : `  ${who}`;
+}
+function count(n) {
+  return typeof n === "number" && Number.isFinite(n) ? n : 0;
+}
+function renderAgentsNow(payload) {
+  const safe = payload && typeof payload === "object" ? payload : {};
+  const groups = (Array.isArray(safe.working) ? safe.working : []).filter(
+    (g) => g && Array.isArray(g.items) && g.items.length > 0
+  );
+  const counts = safe.counts ?? {};
+  const lines = [];
+  if (groups.length === 0) {
+    lines.push("No agent is working right now.");
+  } else {
+    for (const g of groups) {
+      lines.push(groupTitle(g.where, g.machine));
+      for (const item of g.items) lines.push(itemLine(item));
+      lines.push("");
+    }
+    if (lines[lines.length - 1] === "") lines.pop();
+  }
+  lines.push("");
+  lines.push(
+    `${count(counts.connected)} connected, idle \xB7 ${count(count(counts.working) + count(counts.connected) + count(counts.recent))} seen in 24h`
+  );
+  return lines.join("\n");
+}
+var agentsCommand = new Command("agents").description(
+  "Agents working right now \u2014 this computer, the cloud and Great Arrow"
+).option("--json", "Output as JSON").action(async (_opts, command) => {
+  const g = globalOutputOpts(command);
+  const auth = await resolveAuth();
+  const client = new GadClient({ token: auth.token, apiUrl: auth.apiUrl });
+  const result = await client.mcpCall("agents_now", {});
+  if (g.json) {
+    process.stdout.write(JSON.stringify(result, null, 2) + "\n");
+    return;
+  }
+  process.stdout.write(renderAgentsNow(result) + "\n");
+});
+
 // src/commands/ask.ts
 var ORCHESTRATOR_TIMEOUT_MS = 9e4;
 var ANSWER_FIELDS = [
@@ -19266,7 +19333,9 @@ var NEXT_COLUMNS = [
   { key: "priority", header: "Priority", width: 8 },
   { key: "id", header: "ID", width: 36 },
   { key: "title", header: "Title", width: 40 },
-  { key: "context", header: "Next" }
+  { key: "context", header: "Next" },
+  // Every card the CLI lists is clickable (owner rule 2026-10-06).
+  { key: "url", header: "Link" }
 ];
 function dueRank(value) {
   if (typeof value !== "string" || !value) return Number.POSITIVE_INFINITY;
@@ -19400,6 +19469,94 @@ function discoverCommand() {
   });
 }
 
+// src/lib/call-args.ts
+var AUTH_ERROR_CODES = /* @__PURE__ */ new Set([
+  "unauthorized",
+  "forbidden",
+  "insufficient_scope",
+  "auth_required"
+]);
+function parseCallArgs(raw) {
+  if (raw === void 0 || raw.trim() === "") return {};
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    throw new CliError(
+      "--args is not valid JSON.",
+      3 /* VALIDATION_ERROR */,
+      `Pass an object, e.g. --args '{"query":"pricing"}'.`
+    );
+  }
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+    throw new CliError(
+      "--args must be a JSON object.",
+      3 /* VALIDATION_ERROR */,
+      `Pass an object, e.g. --args '{"query":"pricing"}'.`
+    );
+  }
+  return parsed;
+}
+function callFailure(result) {
+  if (typeof result !== "object" || result === null) return null;
+  const record = result;
+  const message = typeof record.message === "string" ? record.message : "";
+  if (typeof record.error === "string" && record.error.trim() !== "") {
+    return {
+      code: record.error,
+      message: message || `Request failed: ${record.error}`
+    };
+  }
+  if (typeof record.error === "object" && record.error !== null) {
+    const inner = record.error;
+    const code = typeof inner.code === "string" ? inner.code : "error";
+    const innerMessage = typeof inner.message === "string" ? inner.message : message;
+    return { code, message: innerMessage || `Request failed: ${code}` };
+  }
+  if (record.ok === false || record.isError === true) {
+    return {
+      code: "error",
+      message: message || "The tool reported a failure."
+    };
+  }
+  return null;
+}
+function gadCallArgs(tool, args) {
+  return { tool_name: tool, args };
+}
+
+// src/commands/call.ts
+function callCommand() {
+  return new Command("call").description("Call any Great Arrow tool by name (see 'gad discover')").argument("<tool>", "Tool name, e.g. memory_search").option("--args <json>", "Tool arguments as a JSON object").option("--json", "Output as JSON").action(async (tool, opts, command) => {
+    const g = globalOutputOpts(command);
+    const args = parseCallArgs(opts.args);
+    const auth = await resolveAuth();
+    const client = new GadClient({
+      token: auth.token,
+      getToken: auth.getToken,
+      apiUrl: auth.apiUrl
+    });
+    const result = await client.mcpCall("gad_call", gadCallArgs(tool, args));
+    const failure = callFailure(result);
+    if (failure) {
+      throw new CliError(
+        `${tool}: ${failure.message}`,
+        AUTH_ERROR_CODES.has(failure.code) ? 1 /* AUTH_ERROR */ : 3 /* VALIDATION_ERROR */,
+        failure.code === "unknown_tool" ? `Find the exact name with 'gad discover' or 'gad call tools_discover --args '{"query":"..."}''.` : void 0
+      );
+    }
+    if (typeof result === "string") {
+      process.stdout.write(result.endsWith("\n") ? result : `${result}
+`);
+      return;
+    }
+    process.stdout.write(
+      `${g.json ? JSON.stringify(result) : JSON.stringify(result, null, 2)}
+`
+    );
+  });
+}
+
 // src/lib/completions.ts
 var COMMANDS = [
   "login",
@@ -23042,6 +23199,7 @@ program2.addCommand(workspace_default);
 program2.addCommand(todo_default);
 program2.addCommand(nextCommand());
 program2.addCommand(discoverCommand());
+program2.addCommand(callCommand());
 program2.addCommand(claim_default);
 program2.addCommand(work_default());
 program2.addCommand(worktree_default);
@@ -23052,6 +23210,7 @@ program2.addCommand(doctorCommand());
 program2.addCommand(integrations_default);
 program2.addCommand(mcp_default);
 program2.addCommand(agentCommand);
+program2.addCommand(agentsCommand);
 program2.addCommand(askCommand());
 program2.addCommand(localCommand());
 program2.addCommand(smokeCommand());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@great-arrow/cli",
-  "version": "0.1.55",
+  "version": "0.1.57",
   "description": "GreatArrow.ai CLI tool",
   "type": "module",
   "bin": {