@arcadeai/hypotenuse 0.11.0 → 0.12.0

package/dist/hypotenuse.js

@@ -343,7 +343,7 @@ import { Command } from "commander";
 // package.json
 var package_default = {
   name: "@arcadeai/hypotenuse",
-  version: "0.11.0",
+  version: "0.12.0",
   description: "Hypotenuse \u2014 run coding agents on your machine for Linear agent sessions",
   type: "module",
   license: "Apache-2.0",
@@ -386,7 +386,7 @@ var package_default = {
     commander: "^14.0.3",
     nanospinner: "^1.2.2",
     "smol-toml": "^1.9.1",
-    upgradr: "^0.4.0",
+    upgradr: "^0.4.1",
     zod: "^4.3.6"
   },
   devDependencies: {
@@ -10201,6 +10201,98 @@ function registerDoctorCommand(program) {
   });
 }
 
+// src/commands/event.ts
+function routedAs(event) {
+  const s = event.session;
+  if (!s?.role)
+    return "-";
+  const why = s.routingRule ? `rule ${s.routingRule.name}` : s.dispatched ? "dispatched" : "default";
+  return `${s.role} (${why})`;
+}
+function turnPlace(event) {
+  const t = event.turn;
+  if (!t)
+    return "-";
+  if (t.status === "queued") {
+    return `queued: ${t.waitingCode ?? t.waitingReason ?? "waiting"}`;
+  }
+  if (t.status === "cancelled") {
+    return `cancelled${t.cancelReason ? `: ${t.cancelReason}` : ""}`;
+  }
+  return t.runner ? `${t.status} on ${t.runner.name}` : t.status;
+}
+function describeEvent(event, payload) {
+  const lines = [
+    `${event.eventType} ${event.action}${event.issueIdentifier ? `  ${event.issueIdentifier}` : ""}`,
+    `outcome    ${event.outcome}`,
+    `summary    ${event.summary ?? "-"}`,
+    `received   ${when(event.receivedAt)}`,
+    `processed  ${when(event.processedAt)}`,
+    `delivery   ${event.deliveryId}`
+  ];
+  if (event.error)
+    lines.push(`error      ${event.error}`);
+  if (event.session) {
+    lines.push(`session    ${event.session.id} (${event.session.status})`);
+    lines.push(`routed as  ${routedAs(event)}`);
+  }
+  if (event.turn) {
+    lines.push(`turn       ${event.turn.id} ${event.turn.kind}, ${turnPlace(event)}`);
+    if (event.turn.waitingReason && event.turn.status === "queued") {
+      lines.push(`waiting    ${event.turn.waitingReason}`);
+    }
+  }
+  lines.push("", payload ? JSON.stringify(payload, null, 2) : "payload    (project admins only)");
+  return lines.join(`
+`);
+}
+function registerEventCommands(program) {
+  const event = program.command("event").description("The selected project's event log: Linear's webhooks and how each was routed");
+  withPaging(event.command("list").description("List webhook events, newest first").option("--type <eventType>", "only this event type, e.g. AgentSessionEvent, Issue, PermissionChange").option("--outcome <outcome>", "only this outcome: handled, ignored, duplicate_of_dispatch, failed, pending").option("--hide-ignored", "leave out events Hypotenuse did not act on").option("--session <id>", "only events about this agent session").option("--since <time>", "only events since: ISO-8601, epoch ms, or 7d / 12h / 30m")).action(async function() {
+    await runCommand(this, async (ctx) => {
+      const opts = this.opts();
+      const projectId = await ctx.projectId();
+      const result = await ctx.signedInClient().request("GET", "/trigger-events", {
+        query: {
+          projectId,
+          eventType: opts.type,
+          outcome: opts.outcome,
+          hideIgnored: opts.hideIgnored ? true : undefined,
+          agentSessionId: opts.session,
+          since: opts.since ? parseTime(opts.since) : undefined,
+          ...pageQuery(this)
+        }
+      });
+      emit(ctx, result, () => table(result.triggerEvents.map((e) => ({
+        id: e.id,
+        received: when(e.receivedAt),
+        event: `${e.eventType} ${e.action}`,
+        issue: e.issueIdentifier ?? "-",
+        outcome: e.outcome,
+        "routed as": routedAs(e),
+        turn: turnPlace(e),
+        summary: e.summary ?? ""
+      })), [
+        { key: "id" },
+        { key: "received" },
+        { key: "event" },
+        { key: "issue" },
+        { key: "outcome" },
+        { key: "routed as" },
+        { key: "turn", maxWidth: 40 },
+        { key: "summary", maxWidth: 70 }
+      ]) + pageFooter(result.pagination));
+    });
+  });
+  event.command("view <id>").description("Show one event: what it did, how it was routed, and (admins) its payload").action(async function(id) {
+    await runCommand(this, async (ctx) => {
+      const projectId = await ctx.projectId();
+      const result = await ctx.signedInClient().request("GET", `/trigger-event/${id}`, { query: { projectId } });
+      emit(ctx, result, () => describeEvent(result.triggerEvent, result.payload));
+    });
+  });
+}
+
 // src/commands/identity.ts
 function linkedViaText(via) {
   return via === "email" ? "e-mail match" : via === "oauth" ? "Linear sign-in" : "admin";
@@ -11995,6 +12087,7 @@ function buildProgram() {
   registerAuditCommands(program);
   registerIntegrationCommands(program);
   registerSessionCommands(program);
+  registerEventCommands(program);
   registerRunnerCommands(program);
   registerRoutingCommands(program);
   registerIdentityCommands(program);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcadeai/hypotenuse",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "Hypotenuse — run coding agents on your machine for Linear agent sessions",
   "type": "module",
   "license": "Apache-2.0",
@@ -43,7 +43,7 @@
     "commander": "^14.0.3",
     "nanospinner": "^1.2.2",
     "smol-toml": "^1.9.1",
-    "upgradr": "^0.4.0",
+    "upgradr": "^0.4.1",
     "zod": "^4.3.6"
   },
   "devDependencies": {

package/skills/hypotenuse.md

@@ -35,6 +35,7 @@ server. It calls the same HTTP actions the dashboard does, as the person who sig
 | `hypotenuse audit list [--since 7d] [--until <time>] [--action tag:edit]` | Who changed what, newest first (admin). Times are ISO-8601, epoch ms, or `7d` / `12h` / `30m`. |
 | `hypotenuse integration list\|view\|connect\|disconnect` | The selected project's trigger integrations — today the only type is `linear`, its Linear workspace connection. `list` shows each type this server supports and whether the project is connected. `view <type>` shows the workspace, the `@hypotenuse` app user, scopes, and token health (never a token). `connect <type>` (admin) prints the consent URL — a **workspace admin** of that system (for `linear`, a Linear workspace admin) must approve it in a browser — and waits until the integration is active (`--no-browser`, `--timeout <seconds>`). `disconnect <type> --yes` (admin) revokes the tokens; the agent stops answering there at once. |
 | `hypotenuse session list\|view\|cancel` | The selected project's agent sessions — each time `@hypotenuse` was delegated an issue or mentioned, in any trigger type (Linear today). `list [--status <status>] [--role manager\|worker] [--type linear] [--issue ENG-123] [--runner <id>]`, newest first; `view <id\|ENG-123>` (an issue identifier names its newest session) shows the session (issue, status, origin, role, runner, issuer, links), its turns (kind, status, runner, and for a waiting turn its reason code such as `offline` or `no_capacity`), and every activity in order, both directions, with each write's delivery status (`pending`, `sent`, `failed`, `superseded`); `--transcript` prints only the activities; `--follow [--interval <seconds>]` keeps printing new ones until interrupted (one JSON object per line under `--json`); `cancel <id>` stops its work as Stop in Linear does (work not started is cancelled; a running turn is told to stop and report). |
+| `hypotenuse event list\|view` | The selected project's event log: every webhook its Linear workspace sent in the last 14 days and how each was routed. `list [--type AgentSessionEvent\|Issue\|…] [--outcome handled\|ignored\|duplicate_of_dispatch\|failed\|pending] [--hide-ignored] [--session <id>] [--since 12h]`, newest first, shows each event's issue, outcome, what it did, the role it was routed as and why (`worker (default)`, `manager (rule /manage)`, `worker (dispatched)`), and where its turn is now (`queued: no_capacity`, `running on <runner>`); `view <id>` shows one in full, with the payload Linear sent for project admins only. |
 | `hypotenuse runner register\|list\|view\|edit\|revoke` | The selected project's runners — machines that run coding agents. `register [--name <name>] [--replace] [--force]` registers **this** machine as the signed-in person, saves the runner token to `credentials.json` (never printed), and sends a first heartbeat; `--replace` revokes the runner of that name first. `list [--status online\|offline\|draining\|revoked] [--all]`; `view <id\|name>` shows capabilities, subscriptions, and whether its socket is attached; `edit <id\|name> [--name] [--enable\|--disable]` renames or pauses it; `revoke <id\|name> --yes` revokes it for good (its owner or an admin). |
 | `hypotenuse routing list\|add\|edit\|remove\|reorder\|preview\|settings` | The selected project's routing rules — the first enabled rule whose match holds decides whether a new session gets a **manager** or a **worker** (no match: worker). `list`; `add --name <name> --role manager\|worker [--label <l>] [--team <key>] [--linear-project <id>] [--prefix /manage] [--has-parent\|--no-parent] [--origin delegation\|mention] [--repository <repo>] [--disabled]` (labels and team keys are checked against the connected workspace); `edit <id>` with the same flags (any match flag replaces the whole match) plus `--enable\|--disable` and `--clear-repository`; `remove <id>`; `reorder <id...>` lists every rule id in the new order; `preview <ENG-123> [--prompt "/manage ..."] [--with-repository]` shows how the issue would route if delegated now — the matching rule, the role, every runner with whether it could take the work and its reason codes, and the repository (any member; `--with-repository` asks Linear to rank repositories, spending its API budget); `settings` shows the routing timers, `settings [--queue-timeout 30m] [--sticky-timeout 10m] [--offer-ttl 10s] [--stop-grace 30s] [--repository-confidence 0.7] [--max-review-rounds 3] [--reset <key>]` changes them. Changes are admin-only. |
 | `hypotenuse identity list\|link\|unlink` | Links between people in the project's Linear workspace and project members; routing prefers the runners of whoever started a session. `list [--user <id>]` shows each link and how it was made (e-mail match, Linear sign-in, admin); `link --user <id> --linear-user <id> [--name] [--email]` links one (admin); `unlink <id>` removes your own link, or anyone's as an admin. |