@arcadeai/hypotenuse 0.20.0 → 0.21.0

package/dist/hypotenuse.js

@@ -343,7 +343,7 @@ import { Command } from "commander";
 // package.json
 var package_default = {
   name: "@arcadeai/hypotenuse",
-  version: "0.20.0",
+  version: "0.21.0",
   description: "Hypotenuse \u2014 run coding agents on your machine for Linear agent sessions",
   type: "module",
   license: "Apache-2.0",
@@ -1097,172 +1097,55 @@ var RunnerLimits = z2.strictObject({
   agents: z2.record(identifier, cap).optional()
 });
 // ../protocol/src/complete.ts
-import { z as z3 } from "zod";
-var COMPLETE_OUTCOMES = ["completed", "failed", "cancelled"];
-var CompleteRequest = z3.strictObject({
-  workItemId: z3.number().int().positive(),
-  outcome: z3.enum(COMPLETE_OUTCOMES),
-  error: z3.string().max(4096).nullable().optional(),
-  acpSessionId: z3.string().max(255).nullable().optional(),
-  branch: z3.string().max(255).nullable().optional(),
-  answersConsumed: z3.array(z3.number().int().positive()).max(100).optional().describe("The activity ids of delivered answers the turn took as answers; any other answer becomes the session's next prompt")
-});
-var CompleteResponse = z3.looseObject({
-  alreadyTerminal: z3.boolean()
-});
-// ../protocol/src/connect.ts
-import { z as z5 } from "zod";
-
-// ../protocol/src/heartbeat.ts
 import { z as z4 } from "zod";
-var ACTIVE_STATES = ["starting", "running", "cancelling"];
-var ActiveItem = z4.strictObject({
-  workItemId: z4.number().int().positive(),
-  agentSessionId: z4.number().int().positive(),
-  role: RunnerRole,
-  agentId: z4.string().min(1).max(64),
-  state: z4.enum(ACTIVE_STATES)
-});
-var MachineId = z4.string().regex(/^sha256:[0-9a-f]{1,64}$/, "sha256:<hex>").describe("A stable hash of the OS machine id, `sha256:<hex>`");
-var HeartbeatRequest = z4.strictObject({
-  protocolVersion: z4.number().int().positive(),
-  daemonVersion: z4.string().trim().min(1).max(64),
-  platform: z4.string().trim().min(1).max(64),
-  hostname: z4.string().trim().min(1).max(256),
-  draining: z4.boolean(),
-  machineId: MachineId,
-  limits: RunnerLimits,
-  active: z4.array(ActiveItem).max(1000),
-  capabilities: RunnerCapabilities,
-  dryRun: z4.boolean().optional().describe("Validate and answer without recording anything: no presence, no capabilities, no leases, no offers")
-});
-var DryRunRunner = z4.looseObject({
-  id: z4.number().int().positive(),
-  name: z4.string(),
-  projectId: z4.number().int().positive(),
-  projectSlug: z4.string()
-});
-var OFFER_KINDS = [
-  "session_created",
-  "prompt",
-  "dispatch",
-  "review"
-];
-var Offer = z4.looseObject({
-  workItemId: z4.number().int().positive(),
-  agentSessionId: z4.number().int().positive(),
-  kind: z4.enum(OFFER_KINDS),
-  role: RunnerRole,
-  offerExpiresAt: z4.number().int()
-});
-var CANCEL_REASONS = [
-  "stop",
-  "dashboard",
-  "delegate_removed",
-  "issue_closed",
-  "unassigned",
-  "integration_revoked",
-  "superseded"
-];
-var Cancel = z4.looseObject({
-  workItemId: z4.number().int().positive(),
-  reason: z4.union([z4.enum(CANCEL_REASONS), z4.string().min(1).max(64)]),
-  by: z4.string().min(1).max(200).optional(),
-  said: z4.string().min(1).max(2000).optional()
-});
-var STOP_QUOTE_MAX = 500;
-function stopQuote(said) {
-  const text = said?.trim();
-  if (!text || /^stop[.!]*$/i.test(text))
-    return "";
-  const cut = text.length > STOP_QUOTE_MAX ? `${text.slice(0, STOP_QUOTE_MAX)}\u2026` : text;
-  return `
-
-> You said: ${cut.split(`
-`).join(`
-> `)}`;
-}
-var Answer = z4.looseObject({
-  workItemId: z4.number().int().positive(),
-  activityId: z4.number().int().positive(),
-  body: z4.string()
-});
-var HeartbeatResponse = z4.looseObject({
-  serverTime: z4.number().int(),
-  heartbeatIntervalMs: z4.number().int().positive(),
-  leaseMs: z4.number().int().positive(),
-  offers: z4.array(Offer),
-  cancels: z4.array(Cancel),
-  unknownActive: z4.array(z4.number().int().positive()),
-  answers: z4.array(Answer).default([]).describe("Replies to questions held turns are waiting on, oldest first"),
-  runner: DryRunRunner.optional().describe("A dry run only: the runner the token is"),
-  unknownSubscriptions: z4.looseObject({ teams: z4.array(z4.string()) }).nullable().optional().describe("A dry run only: subscribed team keys the project's Linear connection cannot see; null when it could not be asked")
-});
 
-// ../protocol/src/connect.ts
-var ConnectRequest = z5.strictObject({
-  machineId: MachineId
-});
-var ConnectResponse = z5.looseObject({
-  runnerId: z5.number().int().positive(),
-  channel: z5.string().regex(/^runner:\d+$/),
-  heartbeatIntervalMs: z5.number().int().positive(),
-  leaseMs: z5.number().int().positive(),
-  serverTime: z5.number().int()
-});
-var MACHINE_IN_USE = "MACHINE_IN_USE";
-var RUNNER_FRAME_EVENTS = ["work", "cancel", "revoked"];
-var RunnerFrame = z5.object({ event: z5.enum(RUNNER_FRAME_EVENTS) });
-function runnerChannel(runnerId) {
-  return `runner:${runnerId}`;
-}
 // ../protocol/src/events.ts
-import { z as z6 } from "zod";
+import { z as z3 } from "zod";
 var MAX_EVENTS_PER_BATCH = 100;
 var MAX_EVENTS_BATCH_BYTES = 256 * 1024;
 var NOT_YOUR_WORK = "NOT_YOUR_WORK";
 var SEQ_REGRESSION = "SEQ_REGRESSION";
-var body = z6.string().trim().min(1).max(64 * 1024);
+var body = z3.string().trim().min(1).max(64 * 1024);
 var envelope = {
-  eventId: z6.uuid({ version: "v4" }).describe("Generated by the daemon; the idempotency key end to end (the Linear activity's client id)"),
-  seq: z6.number().int().positive().describe("Per work item, from 1, never going backwards"),
-  at: z6.number().int().describe("When the daemon saw it, epoch ms")
+  eventId: z3.uuid({ version: "v4" }).describe("Generated by the daemon; the idempotency key end to end (the Linear activity's client id)"),
+  seq: z3.number().int().positive().describe("Per work item, from 1, never going backwards"),
+  at: z3.number().int().describe("When the daemon saw it, epoch ms")
 };
-var SelectMetadata = z6.strictObject({
-  options: z6.array(z6.strictObject({
-    label: z6.string().trim().min(1).max(255).optional(),
-    value: z6.string().trim().min(1).max(1024)
+var SelectMetadata = z3.strictObject({
+  options: z3.array(z3.strictObject({
+    label: z3.string().trim().min(1).max(255).optional(),
+    value: z3.string().trim().min(1).max(1024)
   })).min(1).max(25)
 });
-var AuthProvider = z6.string().regex(/^[a-z0-9][a-z0-9._-]{0,63}$/).describe("An agent id, `github`, or a git host");
-var AuthMetadata = z6.strictObject({
-  url: z6.url().optional(),
+var AuthProvider = z3.string().regex(/^[a-z0-9][a-z0-9._-]{0,63}$/).describe("An agent id, `github`, or a git host");
+var AuthMetadata = z3.strictObject({
+  url: z3.url().optional(),
   provider: AuthProvider.optional(),
-  userId: z6.string().max(255).optional(),
-  providerName: z6.string().max(255).optional()
+  userId: z3.string().max(255).optional(),
+  providerName: z3.string().max(255).optional()
 }).refine((m) => m.url !== undefined || m.provider !== undefined, {
   message: "an auth elicitation needs a url or a provider"
 });
-var ThoughtEvent = z6.strictObject({
+var ThoughtEvent = z3.strictObject({
   ...envelope,
-  type: z6.literal("thought"),
+  type: z3.literal("thought"),
   body,
-  ephemeral: z6.boolean().default(false)
+  ephemeral: z3.boolean().default(false)
 });
-var ActionEvent = z6.strictObject({
+var ActionEvent = z3.strictObject({
   ...envelope,
-  type: z6.literal("action"),
-  action: z6.string().trim().min(1).max(255),
-  parameter: z6.string().trim().min(1).max(4096),
-  result: z6.string().max(64 * 1024).optional(),
-  ephemeral: z6.boolean().default(false)
+  type: z3.literal("action"),
+  action: z3.string().trim().min(1).max(255),
+  parameter: z3.string().trim().min(1).max(4096),
+  result: z3.string().max(64 * 1024).optional(),
+  ephemeral: z3.boolean().default(false)
 });
-var ElicitationEvent = z6.strictObject({
+var ElicitationEvent = z3.strictObject({
   ...envelope,
-  type: z6.literal("elicitation"),
+  type: z3.literal("elicitation"),
   body,
-  signal: z6.enum(["select", "auth"]).optional(),
-  signalMetadata: z6.record(z6.string(), z6.unknown()).optional()
+  signal: z3.enum(["select", "auth"]).optional(),
+  signalMetadata: z3.record(z3.string(), z3.unknown()).optional()
 }).superRefine((event, ctx) => {
   if (!event.signal) {
     if (event.signalMetadata) {
@@ -1284,14 +1167,14 @@ var ElicitationEvent = z6.strictObject({
     });
   }
 });
-var ResponseEvent = z6.strictObject({
+var ResponseEvent = z3.strictObject({
   ...envelope,
-  type: z6.literal("response"),
+  type: z3.literal("response"),
   body
 });
-var ErrorEvent = z6.strictObject({
+var ErrorEvent = z3.strictObject({
   ...envelope,
-  type: z6.literal("error"),
+  type: z3.literal("error"),
   body
 });
 var PLAN_ENTRY_STATUSES = [
@@ -1300,33 +1183,36 @@ var PLAN_ENTRY_STATUSES = [
   "completed",
   "canceled"
 ];
-var PlanEvent = z6.strictObject({
+var PlanEvent = z3.strictObject({
   ...envelope,
-  type: z6.literal("plan"),
-  entries: z6.array(z6.strictObject({
-    content: z6.string().trim().min(1).max(1024),
-    status: z6.enum(PLAN_ENTRY_STATUSES)
+  type: z3.literal("plan"),
+  entries: z3.array(z3.strictObject({
+    content: z3.string().trim().min(1).max(1024),
+    status: z3.enum(PLAN_ENTRY_STATUSES)
   })).max(100)
 });
-var SummaryEvent = z6.strictObject({
+var SummaryEvent = z3.strictObject({
   ...envelope,
-  type: z6.literal("summary"),
-  title: z6.string().min(1).max(255).regex(/^[^\r\n\0]*$/, "one line").refine((t) => t.trim().length > 0, "not blank")
+  type: z3.literal("summary"),
+  title: z3.string().min(1).max(255).regex(/^[^\r\n\0]*$/, "one line").refine((t) => t.trim().length > 0, "not blank")
 });
-var ExternalUrlEvent = z6.strictObject({
+var ExternalUrlEvent = z3.strictObject({
   ...envelope,
-  type: z6.literal("external_url"),
-  label: z6.string().trim().min(1).max(255),
-  url: z6.url()
+  type: z3.literal("external_url"),
+  label: z3.string().trim().min(1).max(255),
+  url: z3.url()
 });
-var UsageEvent = z6.strictObject({
+var TurnUsage = z3.strictObject({
+  inputTokens: z3.number().int().min(0).optional(),
+  outputTokens: z3.number().int().min(0).optional(),
+  costUsd: z3.number().min(0).optional().describe("This turn's cost in US dollars, as the agent reported it")
+});
+var UsageEvent = z3.strictObject({
   ...envelope,
-  type: z6.literal("usage"),
-  inputTokens: z6.number().int().min(0).optional(),
-  outputTokens: z6.number().int().min(0).optional(),
-  costUsd: z6.number().min(0).optional(),
-  contextUsed: z6.number().int().min(0).optional(),
-  contextSize: z6.number().int().min(0).optional()
+  type: z3.literal("usage"),
+  ...TurnUsage.shape,
+  contextUsed: z3.number().int().min(0).optional(),
+  contextSize: z3.number().int().min(0).optional()
 });
 var STATUS_EVENT_STATES = [
   "starting",
@@ -1334,12 +1220,12 @@ var STATUS_EVENT_STATES = [
   "waiting_permission",
   "finishing"
 ];
-var StatusEvent = z6.strictObject({
+var StatusEvent = z3.strictObject({
   ...envelope,
-  type: z6.literal("status"),
-  state: z6.enum(STATUS_EVENT_STATES)
+  type: z3.literal("status"),
+  state: z3.enum(STATUS_EVENT_STATES)
 });
-var SessionEvent = z6.discriminatedUnion("type", [
+var SessionEvent = z3.discriminatedUnion("type", [
   ThoughtEvent,
   ActionEvent,
   ElicitationEvent,
@@ -1351,16 +1237,137 @@ var SessionEvent = z6.discriminatedUnion("type", [
   UsageEvent,
   StatusEvent
 ]);
-var EventsRequest = z6.strictObject({
-  workItemId: z6.number().int().positive(),
-  events: z6.array(SessionEvent).min(1).max(MAX_EVENTS_PER_BATCH)
+var EventsRequest = z3.strictObject({
+  workItemId: z3.number().int().positive(),
+  events: z3.array(SessionEvent).min(1).max(MAX_EVENTS_PER_BATCH)
+});
+var EventsResponse = z3.looseObject({
+  accepted: z3.number().int().min(0),
+  duplicates: z3.number().int().min(0),
+  dropped: z3.number().int().min(0),
+  cancelRequested: z3.boolean()
+});
+
+// ../protocol/src/complete.ts
+var COMPLETE_OUTCOMES = ["completed", "failed", "cancelled"];
+var CompleteRequest = z4.strictObject({
+  workItemId: z4.number().int().positive(),
+  outcome: z4.enum(COMPLETE_OUTCOMES),
+  error: z4.string().max(4096).nullable().optional(),
+  acpSessionId: z4.string().max(255).nullable().optional(),
+  branch: z4.string().max(255).nullable().optional(),
+  answersConsumed: z4.array(z4.number().int().positive()).max(100).optional().describe("The activity ids of delivered answers the turn took as answers; any other answer becomes the session's next prompt"),
+  usage: TurnUsage.optional().describe("What the turn spent, in full; recorded even when the turn was stopped and its events were dropped")
+});
+var CompleteResponse = z4.looseObject({
+  alreadyTerminal: z4.boolean()
+});
+// ../protocol/src/connect.ts
+import { z as z6 } from "zod";
+
+// ../protocol/src/heartbeat.ts
+import { z as z5 } from "zod";
+var ACTIVE_STATES = ["starting", "running", "cancelling"];
+var ActiveItem = z5.strictObject({
+  workItemId: z5.number().int().positive(),
+  agentSessionId: z5.number().int().positive(),
+  role: RunnerRole,
+  agentId: z5.string().min(1).max(64),
+  state: z5.enum(ACTIVE_STATES)
+});
+var MachineId = z5.string().regex(/^sha256:[0-9a-f]{1,64}$/, "sha256:<hex>").describe("A stable hash of the OS machine id, `sha256:<hex>`");
+var HeartbeatRequest = z5.strictObject({
+  protocolVersion: z5.number().int().positive(),
+  daemonVersion: z5.string().trim().min(1).max(64),
+  platform: z5.string().trim().min(1).max(64),
+  hostname: z5.string().trim().min(1).max(256),
+  draining: z5.boolean(),
+  machineId: MachineId,
+  limits: RunnerLimits,
+  active: z5.array(ActiveItem).max(1000),
+  capabilities: RunnerCapabilities,
+  dryRun: z5.boolean().optional().describe("Validate and answer without recording anything: no presence, no capabilities, no leases, no offers")
+});
+var DryRunRunner = z5.looseObject({
+  id: z5.number().int().positive(),
+  name: z5.string(),
+  projectId: z5.number().int().positive(),
+  projectSlug: z5.string()
+});
+var OFFER_KINDS = [
+  "session_created",
+  "prompt",
+  "dispatch",
+  "review"
+];
+var Offer = z5.looseObject({
+  workItemId: z5.number().int().positive(),
+  agentSessionId: z5.number().int().positive(),
+  kind: z5.enum(OFFER_KINDS),
+  role: RunnerRole,
+  offerExpiresAt: z5.number().int()
+});
+var CANCEL_REASONS = [
+  "stop",
+  "dashboard",
+  "delegate_removed",
+  "issue_closed",
+  "unassigned",
+  "integration_revoked",
+  "superseded"
+];
+var Cancel = z5.looseObject({
+  workItemId: z5.number().int().positive(),
+  reason: z5.union([z5.enum(CANCEL_REASONS), z5.string().min(1).max(64)]),
+  by: z5.string().min(1).max(200).optional(),
+  said: z5.string().min(1).max(2000).optional()
+});
+var STOP_QUOTE_MAX = 500;
+function stopQuote(said) {
+  const text = said?.trim();
+  if (!text || /^stop[.!]*$/i.test(text))
+    return "";
+  const cut = text.length > STOP_QUOTE_MAX ? `${text.slice(0, STOP_QUOTE_MAX)}\u2026` : text;
+  return `
+
+> You said: ${cut.split(`
+`).join(`
+> `)}`;
+}
+var Answer = z5.looseObject({
+  workItemId: z5.number().int().positive(),
+  activityId: z5.number().int().positive(),
+  body: z5.string()
+});
+var HeartbeatResponse = z5.looseObject({
+  serverTime: z5.number().int(),
+  heartbeatIntervalMs: z5.number().int().positive(),
+  leaseMs: z5.number().int().positive(),
+  offers: z5.array(Offer),
+  cancels: z5.array(Cancel),
+  unknownActive: z5.array(z5.number().int().positive()),
+  answers: z5.array(Answer).default([]).describe("Replies to questions held turns are waiting on, oldest first"),
+  runner: DryRunRunner.optional().describe("A dry run only: the runner the token is"),
+  unknownSubscriptions: z5.looseObject({ teams: z5.array(z5.string()) }).nullable().optional().describe("A dry run only: subscribed team keys the project's Linear connection cannot see; null when it could not be asked")
 });
-var EventsResponse = z6.looseObject({
-  accepted: z6.number().int().min(0),
-  duplicates: z6.number().int().min(0),
-  dropped: z6.number().int().min(0),
-  cancelRequested: z6.boolean()
+
+// ../protocol/src/connect.ts
+var ConnectRequest = z6.strictObject({
+  machineId: MachineId
 });
+var ConnectResponse = z6.looseObject({
+  runnerId: z6.number().int().positive(),
+  channel: z6.string().regex(/^runner:\d+$/),
+  heartbeatIntervalMs: z6.number().int().positive(),
+  leaseMs: z6.number().int().positive(),
+  serverTime: z6.number().int()
+});
+var MACHINE_IN_USE = "MACHINE_IN_USE";
+var RUNNER_FRAME_EVENTS = ["work", "cancel", "revoked"];
+var RunnerFrame = z6.object({ event: z6.enum(RUNNER_FRAME_EVENTS) });
+function runnerChannel(runnerId) {
+  return `runner:${runnerId}`;
+}
 // ../protocol/src/otlp.ts
 import protobuf from "protobufjs/light.js";
 var SPAN_KIND = {
@@ -5740,6 +5747,11 @@ class TurnMapper {
   lastPlan = "";
   unknown = new Set;
   lastActionSummary = null;
+  costBaseline = null;
+  replayedCost = null;
+  costChecked = false;
+  sessionCost = null;
+  usage = {};
   recorded = {};
   constructor(options) {
     this.options = options;
@@ -5751,8 +5763,14 @@ class TurnMapper {
     return [...this.messages.values()].some((m) => m.trim());
   }
   update(update) {
-    if (this.replaying)
+    if (this.replaying) {
+      if (update.sessionUpdate === "usage_update") {
+        const cost = usdCost(update.cost);
+        if (cost !== null)
+          this.replayedCost = cost;
+      }
       return [];
+    }
     const kind = update.sessionUpdate;
     switch (update.sessionUpdate) {
       case "agent_thought_chunk": {
@@ -5838,14 +5856,10 @@ class TurnMapper {
         return [{ type: "summary", title: truncate(title, 255) }];
       }
       case "usage_update": {
-        return [
-          {
-            type: "usage",
-            contextUsed: Math.max(0, Math.round(update.used)),
-            contextSize: Math.max(0, Math.round(update.size)),
-            ...update.cost && update.cost.currency.toUpperCase() === "USD" ? { costUsd: Math.max(0, update.cost.amount) } : {}
-          }
-        ];
+        this.usage.contextUsed = Math.max(0, Math.round(update.used));
+        this.usage.contextSize = Math.max(0, Math.round(update.size));
+        this.recordCost(usdCost(update.cost));
+        return [{ type: "usage", ...this.usage }];
       }
       case "current_mode_update":
         this.recorded.mode = update.currentModeId;
@@ -5861,6 +5875,47 @@ class TurnMapper {
         return [];
     }
   }
+  acceptReplay() {
+    if (this.replayedCost !== null)
+      this.costBaseline = this.replayedCost;
+    this.replayedCost = null;
+  }
+  recordCost(cumulative) {
+    if (cumulative === null)
+      return;
+    if (!this.costChecked) {
+      this.costChecked = true;
+      if (this.costBaseline !== null && cumulative < this.costBaseline)
+        this.costBaseline = 0;
+    }
+    this.sessionCost = cumulative;
+    if (this.costBaseline !== null)
+      this.usage.costUsd = roundUsd(Math.max(0, cumulative - this.costBaseline));
+  }
+  tokens(tokens) {
+    const count = (n) => typeof n === "number" && Number.isFinite(n) ? Math.max(0, Math.round(n)) : undefined;
+    const input = count(tokens?.inputTokens);
+    const output = count(tokens?.outputTokens);
+    if (input === undefined && output === undefined)
+      return [];
+    if (input !== undefined)
+      this.usage.inputTokens = input;
+    if (output !== undefined)
+      this.usage.outputTokens = output;
+    return [{ type: "usage", ...this.usage }];
+  }
+  turnUsage() {
+    const { inputTokens, outputTokens, costUsd } = this.usage;
+    const usage = {
+      ...inputTokens !== undefined ? { inputTokens } : {},
+      ...outputTokens !== undefined ? { outputTokens } : {},
+      ...costUsd !== undefined ? { costUsd } : {}
+    };
+    return Object.keys(usage).length ? usage : undefined;
+  }
+  sessionCostUsd() {
+    return this.sessionCost ?? this.costBaseline;
+  }
   tick() {
     if (!this.thought)
       return [];
@@ -5963,6 +6018,14 @@ function callText(call) {
   return parts.join(`
 `);
 }
+function usdCost(cost) {
+  if (!cost || cost.currency.toUpperCase() !== "USD")
+    return null;
+  return Number.isFinite(cost.amount) ? Math.max(0, cost.amount) : null;
+}
+function roundUsd(usd) {
+  return Math.round(usd * 1e6) / 1e6;
+}
 
 // src/acp/mcp-servers.ts
 import { isAbsolute as isAbsolute7 } from "path";
@@ -6706,7 +6769,9 @@ class Turn {
       outcome,
       error: error ? error.slice(0, 4000) : null,
       acpSessionId: this.acpSessionId,
-      branch: this.branch
+      branch: this.branch,
+      usage: this.mapper.turnUsage(),
+      acpCostUsd: this.acpSessionId ? this.mapper.sessionCostUsd() : null
     };
   }
   async start() {
@@ -6881,6 +6946,7 @@ class Turn {
     const directories = extra.length && caps.sessionCapabilities?.additionalDirectories ? { additionalDirectories: extra } : {};
     const mcpServers = this.mcpServers(caps);
     this.resumed = false;
+    this.mapper.costBaseline = this.ctx.previousAcpCostUsd ?? null;
     if (previousAcpSessionId && !assignment.fresh && assignment.kind === "prompt") {
       try {
         if (caps.sessionCapabilities?.resume) {
@@ -6905,6 +6971,7 @@ class Turn {
               mcpServers,
               ...directories
             }), 0, ""));
+            this.mapper.acceptReplay();
             this.resumed = true;
             await this.applyMode(answer);
             return;
@@ -6922,6 +6989,7 @@ class Turn {
     }
     const created = await this.otel.around("acp.session.new", { "hypotenuse.mcp.servers": mcpServers.length }, () => this.guard(conn.newSession({ cwd: this.cwd, mcpServers, ...directories }), 0, ""));
     this.acpSessionId = created.sessionId;
+    this.mapper.costBaseline = 0;
     await this.applyMode(created);
   }
   resumed = false;
@@ -7038,6 +7106,7 @@ class Turn {
       throw new TurnFailure(`${this.agentId} failed the turn: ${errorMessage(error)}${quoteTail(this.log.tail())}`);
     });
     const usage = answer.usage;
+    this.emitAll(this.mapper.tokens(usage));
     this.otel.promptEnded({
       "gen_ai.response.finish_reasons": answer.stopReason,
       "gen_ai.usage.input_tokens": usage?.inputTokens,
@@ -7836,7 +7905,8 @@ var MIGRATIONS = [
    ALTER TABLE worktrees ADD COLUMN removed_at INTEGER;
    ALTER TABLE local_sessions ADD COLUMN last_answer TEXT;
    ALTER TABLE local_sessions ADD COLUMN ended_at INTEGER;
-   ALTER TABLE local_sessions ADD COLUMN pull_requests TEXT NOT NULL DEFAULT '[]';`
+   ALTER TABLE local_sessions ADD COLUMN pull_requests TEXT NOT NULL DEFAULT '[]';`,
+  `ALTER TABLE local_sessions ADD COLUMN acp_cost_usd REAL;`
 ];
 function toSession(row) {
   return {
@@ -7850,6 +7920,7 @@ function toSession(row) {
     nextSeq: row.next_seq,
     acpAgentId: row.acp_agent_id ?? null,
     acpSessionId: row.acp_session_id ?? null,
+    acpCostUsd: row.acp_cost_usd ?? null,
     pid: row.pid ?? null,
     worktreeId: row.worktree_id ?? null,
     createdAt: row.created_at,
@@ -7959,7 +8030,8 @@ class StateDb {
   setSessionState(agentSessionId, state, extra = {}) {
     this.db.query(`UPDATE local_sessions SET state = $state, updated_at = $now,
            pid = CASE WHEN $setPid THEN $pid ELSE pid END,
-           acp_session_id = CASE WHEN $setAcp THEN $acp ELSE acp_session_id END
+           acp_session_id = CASE WHEN $setAcp THEN $acp ELSE acp_session_id END,
+           acp_cost_usd = CASE WHEN $setCost THEN $cost ELSE acp_cost_usd END
          WHERE agent_session_id = $id`).run({
       state,
       now: this.now(),
@@ -7967,7 +8039,9 @@ class StateDb {
       setPid: extra.pid !== undefined ? 1 : 0,
       pid: extra.pid ?? null,
       setAcp: extra.acpSessionId !== undefined ? 1 : 0,
-      acp: extra.acpSessionId ?? null
+      acp: extra.acpSessionId ?? null,
+      setCost: extra.acpCostUsd !== undefined ? 1 : 0,
+      cost: extra.acpCostUsd ?? null
     });
   }
   session(agentSessionId) {
@@ -10226,7 +10300,9 @@ class Supervisor {
       ...assignment,
       agentId: assignment.agentId ?? this.agentFor(assignment.role)
     }, this.config).agentId;
-    const previousAcpSessionId = state.session(assignment.agentSessionId)?.acpSessionId ?? null;
+    const local = state.session(assignment.agentSessionId);
+    const previousAcpSessionId = local?.acpSessionId ?? null;
+    const previousAcpCostUsd = local?.acpCostUsd ?? null;
     state.claimSession({
       agentSessionId: assignment.agentSessionId,
       linearSessionId: assignment.externalSessionId,
@@ -10322,6 +10398,7 @@ class Supervisor {
       stateDir: this.options.stateDir,
       env: this.options.env,
       previousAcpSessionId,
+      previousAcpCostUsd,
       onReply: (handler) => {
         slot.onReply = handler;
       },
@@ -10382,9 +10459,11 @@ class Supervisor {
     this.slots.delete(slot.workItemId);
     if (slot.nonce)
       this.broker.end(slot.nonce);
+    const acp = acpSessionAfterTurn(result, slot.silent, this.options.state.session(slot.agentSessionId)?.acpSessionId ?? null);
     if (slot.silent) {
       this.options.state.setSessionState(slot.agentSessionId, "interrupted", {
-        pid: null
+        pid: null,
+        ...acp
       });
     } else {
       this.sink.complete({
@@ -10394,6 +10473,7 @@ class Supervisor {
           error: result.error ?? null,
           acpSessionId: result.acpSessionId ?? null,
           branch: result.branch ?? null,
+          ...result.usage ? { usage: result.usage } : {},
           ...slot.consumed.length ? { answersConsumed: slot.consumed.slice(0, 100) } : {}
         },
         active: {
@@ -10405,10 +10485,7 @@ class Supervisor {
         }
       });
       this.options.state.recordTurnEnd(slot.agentSessionId, slot.lastAnswer);
-      this.options.state.setSessionState(slot.agentSessionId, result.outcome === "completed" ? "idle" : result.outcome === "cancelled" ? "cancelled" : "failed", {
-        pid: null,
-        ...result.acpSessionId ? { acpSessionId: result.acpSessionId } : {}
-      });
+      this.options.state.setSessionState(slot.agentSessionId, result.outcome === "completed" ? "idle" : result.outcome === "cancelled" ? "cancelled" : "failed", { pid: null, ...acp });
     }
     this.options.log.info(`turn ended: ${slot.silent ? "taken away" : result.outcome}`, {
       session: slot.agentSessionId,
@@ -10655,6 +10732,17 @@ class Supervisor {
     this.telemetryQueue.stop();
   }
 }
+function acpSessionAfterTurn(result, silent, recordedAcpSessionId) {
+  if (!result.acpSessionId)
+    return {};
+  if (!silent) {
+    return {
+      acpSessionId: result.acpSessionId,
+      acpCostUsd: result.acpCostUsd ?? null
+    };
+  }
+  return result.acpSessionId === recordedAcpSessionId ? { acpCostUsd: result.acpCostUsd ?? null } : {};
+}
 function changedKeys(a, b, prefix = "") {
   const isObject = (v) => v !== null && typeof v === "object" && !Array.isArray(v);
   if (isObject(a) && isObject(b)) {
@@ -11942,6 +12030,109 @@ function registerConfigCommands(program) {
   });
 }
 
+// src/commands/cost.ts
+var COST_DIMENSIONS = [
+  "session",
+  "root-session",
+  "issue",
+  "runner",
+  "owner",
+  "issuer",
+  "role",
+  "agent",
+  "repository",
+  "day"
+];
+function usd(usd) {
+  if (usd === null)
+    return "-";
+  if (usd !== 0 && Math.abs(usd) < 0.01)
+    return `$${usd.toPrecision(2)}`;
+  return `$${usd.toFixed(2)}`;
+}
+function describeTotals(totals) {
+  const turns = `${totals.turns} turn${totals.turns === 1 ? "" : "s"}`;
+  const unpriced = totals.unpricedTurns ? ` (${totals.unpricedTurns} unpriced)` : "";
+  const tokens = `${totals.inputTokens.toLocaleString("en-US")} in / ${totals.outputTokens.toLocaleString("en-US")} out`;
+  return `${usd(totals.costUsd)} over ${turns}${unpriced}, ${tokens}`;
+}
+function withFilters(command) {
+  return command.option("--session <id>", "only this agent session's turns").option("--root-session <id>", "only this manager session's turns and its dispatched workers'").option("--runner <id>", "only turns this runner ran").option("--owner <userId>", "only turns on runners this user owns").option("--issuer <userId>", "only turns this user asked for").option("--role <role>", "only turns in this role: manager or worker").option("--since <time>", "only turns that ended since: ISO-8601, epoch ms, or 7d / 12h / 30m").option("--until <time>", "only turns that ended before: ISO-8601, epoch ms, or 7d / 12h / 30m");
+}
+function filterQuery(command) {
+  const opts = command.opts();
+  return {
+    agentSessionId: opts.session,
+    rootAgentSessionId: opts.rootSession,
+    runnerId: opts.runner,
+    runnerUserId: opts.owner,
+    issuerUserId: opts.issuer,
+    role: opts.role,
+    since: opts.since ? String(parseTime(opts.since)) : undefined,
+    until: opts.until ? String(parseTime(opts.until)) : undefined
+  };
+}
+function registerCostCommands(program) {
+  const cost = program.command("cost").description("What the selected project's agent sessions cost, and whom it is attributed to");
+  withPaging(withFilters(cost.command("list").description("List each turn's cost, newest first, with its session, runner, and role"))).action(async function() {
+    await runCommand(this, async (ctx) => {
+      const projectId = await ctx.projectId();
+      const result = await ctx.signedInClient().request("GET", "/costs", {
+        query: { projectId, ...filterQuery(this), ...pageQuery(this) }
+      });
+      emit(ctx, result, () => `${table(result.costRecords.map((r) => ({
+        ended: when(r.endedAt),
+        issue: r.issueIdentifier ?? "-",
+        session: r.agentSessionId,
+        role: r.role ?? "-",
+        kind: r.kind,
+        runner: r.runnerName,
+        agent: r.agentId ?? "-",
+        ending: r.ending,
+        tokens: `${r.inputTokens ?? "-"} / ${r.outputTokens ?? "-"}`,
+        cost: usd(r.costUsd)
+      })), [
+        { key: "ended" },
+        { key: "issue" },
+        { key: "session" },
+        { key: "role" },
+        { key: "kind" },
+        { key: "runner" },
+        { key: "agent" },
+        { key: "ending" },
+        { key: "tokens" },
+        { key: "cost" }
+      ])}
+total ${describeTotals(result.total)}${pageFooter(result.pagination)}`);
+    });
+  });
+  withPaging(withFilters(cost.command("summary").description("Total the turns' cost by one dimension, most expensive first").option("--by <dimension>", `what to group by: ${COST_DIMENSIONS.join(", ")}`, "session"))).action(async function() {
+    await runCommand(this, async (ctx) => {
+      const projectId = await ctx.projectId();
+      const { by } = this.opts();
+      const result = await ctx.signedInClient().request("GET", "/costs/summary", {
+        query: { projectId, by, ...filterQuery(this), ...pageQuery(this) }
+      });
+      emit(ctx, result, () => `${table(result.groups.map((g) => ({
+        [result.by]: g.label ?? g.key ?? "(none)",
+        turns: g.turns,
+        unpriced: g.unpricedTurns,
+        "input tokens": g.inputTokens,
+        "output tokens": g.outputTokens,
+        cost: usd(g.costUsd)
+      })), [
+        { key: result.by, maxWidth: 50 },
+        { key: "turns" },
+        { key: "unpriced" },
+        { key: "input tokens" },
+        { key: "output tokens" },
+        { key: "cost" }
+      ])}
+total ${describeTotals(result.total)}${pageFooter(result.pagination)}`);
+    });
+  });
+}
+
 // src/commands/doctor.ts
 import { existsSync as existsSync21, statfsSync as statfsSync2, statSync as statSync6 } from "fs";
 import { hostname as hostname6 } from "os";
@@ -13709,6 +13900,11 @@ function describeSession(session, activities, tree = {}) {
   if (tree.issuer?.user) {
     lines.push(`issuer     ${tree.issuer.user.name}`);
   }
+  if (tree.cost?.turns)
+    lines.push(`cost       ${describeTotals(tree.cost)}`);
+  if (tree.treeCost && tree.treeCost.turns > (tree.cost?.turns ?? 0)) {
+    lines.push(`tree cost  ${describeTotals(tree.treeCost)} with its workers`);
+  }
   if (session.summary)
     lines.push(`summary    ${session.summary}`);
   if (session.externalUrl)
@@ -14443,6 +14639,7 @@ function buildProgram() {
   registerIntegrationCommands(program);
   registerSessionCommands(program);
   registerEventCommands(program);
+  registerCostCommands(program);
   registerRunnerCommands(program);
   registerRoutingCommands(program);
   registerTelemetryCommands(program);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcadeai/hypotenuse",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "Hypotenuse — run coding agents on your machine for Linear agent sessions",
   "type": "module",
   "license": "Apache-2.0",

package/skills/hypotenuse.md

@@ -1,6 +1,6 @@
 ---
 name: hypotenuse
-description: Operate a Hypotenuse server from the terminal with the `hypotenuse` CLI — sign in, pick a project, manage members, invites, tags, connect trigger integrations (Linear), register and manage runners, run this machine as a runner (config file, daemon, user service, doctor), edit routing rules and settings, point the project's telemetry at OpenTelemetry collectors, link Linear users to members, read and stop agent sessions, and read the audit log. Use when asked to administer Hypotenuse projects, check what @hypotenuse did on an issue, or check who changed what.
+description: Operate a Hypotenuse server from the terminal with the `hypotenuse` CLI — sign in, pick a project, manage members, invites, tags, connect trigger integrations (Linear), register and manage runners, run this machine as a runner (config file, daemon, user service, doctor), edit routing rules and settings, point the project's telemetry at OpenTelemetry collectors, link Linear users to members, read and stop agent sessions, see what they cost, and read the audit log. Use when asked to administer Hypotenuse projects, check what @hypotenuse did on an issue, or check who changed what.
 ---
 
 # hypotenuse
@@ -38,6 +38,7 @@ server. It calls the same HTTP actions the dashboard does, as the person who sig
 | `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 cost list\|summary` | What the selected project's turns cost and whom it is attributed to, as the coding agents reported it (US dollars and tokens; Hypotenuse never prices tokens itself). `list`, newest first, prints one record per runner's claim of a turn — issue, session, role, kind, runner, agent, how it ended, tokens, cost — and the total; `summary --by session\|root-session\|issue\|runner\|owner\|issuer\|role\|agent\|repository\|day` totals them per group, most expensive first, counting turns with no reported cost as `unpriced`. Both take `--session <id>`, `--root-session <id>` (a manager and its workers), `--runner <id>`, `--owner <userId>`, `--issuer <userId>`, `--role manager\|worker`, `--since 30d`, `--until <time>`, and paging. Any member. |
 | `hypotenuse telemetry exporter list\|view\|add\|edit\|remove\|test` | Where the selected project's OpenTelemetry goes: each exporter is an OTLP/HTTP collector that receives every turn as one trace, at a content level (`metadata`, `content`, or `full` — full sends prompts and source code). `list` and `view <id>` show endpoint, level, signals, sample share, header names (never values), and the last export or error (any member); `add --name <name> --endpoint <https-url> [--header KEY=VALUE...] [--content <level>] [--signals traces,metrics,logs] [--sample 0.5] [--attribute KEY=VALUE...] [--no-agent-native] [--disabled]`; `edit <id>` with the same flags plus `--clear-headers` and `--enable\|--disable` (headers are kept unless given); `remove <id>`; `test <id>` sends a probe and prints each signal's answer, exiting 1 on a failure. Changes and tests are admin-only; header values are never printed. |
 | `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. |
 | `hypotenuse config init\|validate\|schema\|path` | The daemon's TOML config (`-c <path>`, else `HYPOTENUSE_CONFIG`, else `~/.config/hypotenuse/config.toml`). `init [--repo <path>...] [--force]` writes a commented starter filled in from this machine; `validate [--online] [--offline]` checks shape, references, and this machine (git clones, prompt files, agent commands), and with `--online` the server, runner token, project, and team keys — exit 0 valid (warnings allowed), 1 errors, 2 unreadable; `--json` prints `{ valid, errors: [{ path, message, hint? }], warnings }`. `schema` prints the JSON Schema; `path` prints the config, state directory, and credentials file in use. |
@@ -63,6 +64,7 @@ hypotenuse --json integration view linear | jq '.integration | {type, status, wo
 hypotenuse --json session list --issue ENG-123 | jq '.agentSessions[] | {id, status}'
 hypotenuse --json runner list | jq '.runners[] | {name, status, owner: .owner.name}'
 hypotenuse --json session view 42 | jq '.activities[] | {seq, direction, contentType, deliveryStatus}'
+hypotenuse --json cost summary --by owner --since 7d | jq '.groups[] | {owner: .label, costUsd, turns}'
 hypotenuse --json config validate | jq -r '.errors[] | "\(.path): \(.message)"'
 hypotenuse daemon start && hypotenuse --json daemon status | jq '{connected: .server.connected, slots}'
 ```