@great-arrow/cli 0.1.54 → 0.1.56

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.54";
+var CLI_VERSION = "0.1.56";
 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 {
@@ -11180,6 +11183,68 @@ var GadClient = class {
     }
     return payload;
   }
+  /**
+   * Own one chat response through body consumption, with the normal workspace
+   * attribution. A received turn is never replayed. The consumer handles either
+   * the versioned local handoff or the actual frontier stream inside this scope.
+   */
+  async withChatResponse(body, consume, options = {}) {
+    const deadlineMs = options.deadlineMs ?? 3e5;
+    if (!Number.isInteger(deadlineMs) || deadlineMs < 1 || deadlineMs > 3e5) {
+      throw new CliError(
+        "Chat deadline must be between 1 and 300000 milliseconds.",
+        3 /* VALIDATION_ERROR */
+      );
+    }
+    const controller = new AbortController();
+    const signal = options.signal ? AbortSignal.any([controller.signal, options.signal]) : controller.signal;
+    const timer = setTimeout(
+      () => controller.abort(new Error("Chat response deadline exceeded.")),
+      deadlineMs
+    );
+    let rejectAbort;
+    let response;
+    const aborted = new Promise((_, reject) => {
+      rejectAbort = () => reject(signal.reason ?? new Error("Chat stopped."));
+      if (signal.aborted) rejectAbort();
+      else signal.addEventListener("abort", rejectAbort, { once: true });
+    });
+    try {
+      return await Promise.race([
+        (async () => {
+          signal.throwIfAborted();
+          response = await fetch(`${this.apiUrl}/api/chat`, {
+            method: "POST",
+            headers: {
+              ...this.buildHeaders(),
+              Accept: "text/event-stream, application/json"
+            },
+            body: JSON.stringify(body),
+            redirect: "error",
+            cache: "no-store",
+            signal
+          });
+          signal.throwIfAborted();
+          if (!response.ok) await this.handleResponse(response);
+          return consume(response, signal);
+        })(),
+        aborted
+      ]);
+    } finally {
+      clearTimeout(timer);
+      if (rejectAbort) signal.removeEventListener("abort", rejectAbort);
+      controller.abort();
+      const body2 = response?.body;
+      if (body2 && !body2.locked)
+        void (async () => {
+          try {
+            await body2.cancel();
+          } catch (error) {
+            debugSwallow("chat.response.cancel", error);
+          }
+        })();
+    }
+  }
   /**
    * Make a GET request to a REST API endpoint.
    *
@@ -11766,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>",
@@ -17159,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 = [
@@ -19204,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;
@@ -22990,6 +23121,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.54",
+  "version": "0.1.56",
   "description": "GreatArrow.ai CLI tool",
   "type": "module",
   "bin": {