tines 0.0.207 → 0.0.209

package/dist/index.js

@@ -4153,6 +4153,9 @@ function createApiClient(options) {
       `/api/v1/runs${query(filters)}`
     ),
     getUsage: (filters = {}) => get(`/api/v1/usage${query(filters)}`),
+    getIssueUsage: (issue) => get(`/api/v1/usage${query({ mode: "issue", issue })}`),
+    getUsageScope: (scope) => get(`/api/v1/usage${query({ scope })}`),
+    getUsageEvidence: (filters) => get(`/api/v1/usage/evidence${query(filters)}`),
     getRun: (id2) => get(`/api/v1/runs/${id2}`),
     /**
      * The run's complete log (not the 256 KB tail `getRun` returns) as a
@@ -11009,9 +11012,11 @@ function usageAggregateLines(label, aggregate) {
 function usageEvidenceLines(id2, dimensions, accounting) {
   const dims = ["project", "workflow", "state", "outcome", "runner", "tier"].map((name2) => `${name2}=${dimensions[name2].name} [${dimensions[name2].id ?? "unknown"}]`).join(" \xB7 ");
   const diagnostics = Object.entries(accounting.diagnostics).filter(([, count]) => count > 0).map(([name2, count]) => `${name2}=${count}`).join(" \xB7 ");
+  const tokens = ["input_tokens", "output_tokens", "cache_read_tokens", "cache_write_tokens"].map((name2) => `${name2}=${present(accounting.tokens[name2])}`).join(" \xB7 ");
   return [
     `Evidence ${id2}: ${dims}`,
     `Accounting ${id2}: ${accounting.status} \xB7 source ${accounting.source ?? "unavailable"} \xB7 exact cost ${accounting.cost_exact ?? "unavailable"}${accounting.pricing_reason ? ` \xB7 reason ${accounting.pricing_reason}` : ""}${diagnostics ? ` \xB7 diagnostics ${diagnostics}` : ""}`,
+    `Tokens ${id2}: ${tokens} \xB7 invalid_tokens=${accounting.invalid_tokens.length ? accounting.invalid_tokens.join(",") : "none"}`,
     ...accounting.source === "calculated" ? [`Rate ${id2}: ${basisLine(accounting.basis)}`] : []
   ];
 }
@@ -12740,6 +12745,62 @@ function normalizeUrl(value) {
 }
 
 // src/commands/usage.ts
+function printEvidence(page) {
+  console.log(
+    `Usage evidence \xB7 ${page.kind} \xB7 ${page.population} \xB7 ${page.total_count} total \xB7 ${page.sort} ${page.direction}`
+  );
+  if (page.kind === "issues")
+    table([
+      ["ISSUE", "SPEND", "COVERAGE", "RUNS"],
+      ...page.items.map((item) => [
+        item.issue_ref ? `${item.issue_ref.project_name}/${item.issue_ref.number} ${item.issue_ref.title}` : item.issue_id ? `Unavailable issue (${item.issue_id})` : "Unknown issue",
+        money(item.aggregate.cost_usd),
+        item.aggregate.coverage,
+        String(item.attempt_count)
+      ])
+    ]);
+  else
+    table([
+      ["RUN", "ISSUE", "SPEND", "AT"],
+      ...page.items.map((item) => {
+        const run2 = item;
+        return [
+          run2.id,
+          run2.issue_id,
+          page.population === "pending" ? "Pending" : money(run2.usage_accounting?.cost ?? null),
+          new Date(run2.ended_at ?? run2.created_at).toISOString()
+        ];
+      })
+    ]);
+  if (page.kind === "runs" && page.population === "finalized")
+    for (const item of page.items) {
+      if ("id" in item && "usage_accounting" in item && item.usage_dimensions)
+        for (const line of usageEvidenceLines(
+          item.id,
+          item.usage_dimensions,
+          item.usage_accounting
+        ))
+          console.log(line);
+    }
+  console.log(
+    `Matching total: ${money(page.matching_total.cost_usd)} \xB7 ${page.attempt_count} attempts \xB7 ${page.pending_count} pending`
+  );
+  if (page.next_cursor) console.log(`Next cursor: ${page.next_cursor}`);
+}
+function printIssueReport(report) {
+  const { issue } = report;
+  console.log(
+    `Usage \xB7 ${issue.issue_ref ? `${issue.issue_ref.project_name}/${issue.issue_ref.number}` : issue.issue_id} \xB7 Lifetime through now`
+  );
+  console.log(`as of ${new Date(report.cutoff).toISOString()} \xB7 direct retained attempts`);
+  if (issue.attempt_count === 0) console.log("No agent runs");
+  else {
+    console.log(
+      `${money(issue.aggregate.cost_usd)} \xB7 ${issue.aggregate.coverage} \xB7 ${issue.aggregate.finalized_run_count} finalized \xB7 ${issue.pending_count} pending at cutoff`
+    );
+    for (const line of usageAggregateLines("Lifetime", issue.aggregate)) console.log(line);
+  }
+}
 var money = (value) => usageCostLabel(value);
 function printReport(report) {
   console.log(`Usage \xB7 ${report.filters.project ?? "All projects"} \xB7 ${report.by}`);
@@ -12798,7 +12859,12 @@ function register12(program3) {
   withCommon(
     program3.command("usage").description("Compare finalized run spend for a period").addOption(
       new Option("--window <window>", "today, 7d, or 30d").choices(["today", "7d", "30d"])
-    ).option("--from <bound>", "custom inclusive start (date or offset timestamp)").option("--to <bound>", "custom exclusive end (date or offset timestamp)").option("--project <name-or-id>", "project scope (including archived), or unknown").option("--workflow <name-or-id>", "workflow filter, or unknown").option("--state <id>", "starting state id (requires --workflow)").option("--runner <name-or-id>", "runner filter, or unknown").option("--tier <tier>", "tier filter").addOption(
+    ).option("--from <bound>", "custom inclusive start (date or offset timestamp)").option("--to <bound>", "custom exclusive end (date or offset timestamp)").option("--issue <ref>", "direct issue lifetime through now").option("--scope <token>", "replay a frozen usage scope").addOption(new Option("--evidence <kind>", "list evidence").choices(["issues", "runs"])).option("--member <issue-id>", "narrow run evidence to one contributing issue").addOption(
+      new Option("--population <population>", "finalized or pending").choices([
+        "finalized",
+        "pending"
+      ])
+    ).addOption(new Option("--sort <sort>", "evidence sort").choices(["cost", "time"])).addOption(new Option("--direction <direction>", "sort direction").choices(["asc", "desc"])).option("--cursor <token>", "evidence page cursor").option("--limit <count>", "evidence page size (1-100)").option("--all-pages", "fetch every evidence page").option("--project <name-or-id>", "project scope (including archived), or unknown").option("--workflow <name-or-id>", "workflow filter, or unknown").option("--state <id>", "starting state id (requires --workflow)").option("--runner <name-or-id>", "runner filter, or unknown").option("--tier <tier>", "tier filter").addOption(
       new Option("--outcome <outcome>", "recorded outcome").choices([
         "advanced",
         "stalled",
@@ -12814,7 +12880,100 @@ function register12(program3) {
     ).addOption(
       new Option("--by <dimension>", "group dimension").choices(["project", "workflow", "state", "outcome", "runner", "tier"]).default("workflow")
     )
-  ).action(async (opts) => {
+  ).action(async (opts, command) => {
+    const evidenceOnly = [
+      opts.member,
+      opts.population,
+      opts.sort,
+      opts.direction,
+      opts.cursor,
+      opts.limit,
+      opts.allPages
+    ];
+    if (evidenceOnly.some((value) => value !== void 0) && !opts.evidence)
+      throw new Error(
+        "--member/--population/--sort/--direction/--cursor/--limit/--all-pages require --evidence"
+      );
+    if (opts.evidence && !opts.scope) throw new Error("--evidence requires --scope");
+    if (opts.scope) {
+      const reportFlags = [
+        opts.issue,
+        opts.window,
+        opts.from,
+        opts.to,
+        opts.project,
+        opts.workflow,
+        opts.state,
+        opts.runner,
+        opts.tier,
+        opts.outcome,
+        opts.accountingStatus
+      ];
+      if (command.getOptionValueSource("by") === "cli") reportFlags.push(opts.by);
+      if (reportFlags.some((value) => value !== void 0))
+        throw new Error("--scope cannot be combined with report options");
+      const api2 = client(opts);
+      if (!opts.evidence) {
+        const report2 = await api2.getUsageScope(opts.scope);
+        if (opts.json) return printJson(report2);
+        if (report2.mode === "issue") printIssueReport(report2);
+        else printReport(report2);
+        return;
+      }
+      let cursor = opts.cursor;
+      const seenCursors = /* @__PURE__ */ new Set();
+      const seenIds = /* @__PURE__ */ new Set();
+      let combined = null;
+      do {
+        if (cursor && seenCursors.has(cursor))
+          throw new Error("Evidence pagination repeated a cursor");
+        if (cursor) seenCursors.add(cursor);
+        const page = await api2.getUsageEvidence({
+          scope: opts.scope,
+          kind: opts.evidence,
+          population: opts.population,
+          member: opts.member,
+          sort: opts.sort,
+          direction: opts.direction,
+          limit: opts.limit ? Number(opts.limit) : void 0,
+          cursor
+        });
+        for (const item of page.items) {
+          const id2 = "id" in item ? item.id : item.issue_id ?? "unknown";
+          if (seenIds.has(id2)) throw new Error(`Evidence pagination repeated ${id2}`);
+          seenIds.add(id2);
+        }
+        combined = combined ? { ...page, items: [...combined.items, ...page.items], previous_cursor: null } : page;
+        cursor = page.next_cursor ?? void 0;
+      } while (opts.allPages && cursor);
+      if (!combined) throw new Error("Evidence response was empty");
+      if (opts.json) return printJson(combined);
+      printEvidence(combined);
+      return;
+    }
+    if (opts.issue) {
+      const contradictions = [
+        opts.window,
+        opts.from,
+        opts.to,
+        opts.project,
+        opts.workflow,
+        opts.state,
+        opts.runner,
+        opts.tier,
+        opts.outcome,
+        opts.accountingStatus
+      ];
+      if (command.getOptionValueSource("by") === "cli") contradictions.push(opts.by);
+      if (contradictions.some((value) => value !== void 0))
+        throw new Error("--issue cannot be combined with period or filter options");
+      const api2 = client(opts);
+      const issueId = isUsageIdentity(opts.issue, "iss") ? opts.issue : (await resolveIssue(api2, opts.issue)).id;
+      const report2 = await api2.getIssueUsage(issueId);
+      if (opts.json) return printJson(report2);
+      printIssueReport(report2);
+      return;
+    }
     if (opts.from === void 0 !== (opts.to === void 0))
       throw new Error("--from and --to are required together");
     if (opts.window && opts.from) throw new Error("--window cannot be combined with --from/--to");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tines",
-  "version": "0.0.207",
+  "version": "0.0.209",
   "description": "CLI for Tines, an orchestration layer for AI agents",
   "repository": {
     "type": "git",