tines 0.0.142 → 0.0.144

package/dist/index.js

@@ -3506,6 +3506,17 @@ function isStaleTierOverride(builtinModel, overrideModel) {
   if (!builtinModel || !overrideModel || builtinModel === overrideModel) return false;
   return (MODEL_PREDECESSORS[builtinModel] ?? []).includes(overrideModel);
 }
+function ageLabel(at, now = Date.now()) {
+  if (!Number.isFinite(at)) return "\u2014";
+  const seconds = Math.max(0, Math.round((now - at) / 1e3));
+  if (seconds < 60) return `${seconds}s`;
+  if (seconds < 3600) return `${Math.floor(seconds / 60)}m`;
+  if (seconds < 86400) return `${Math.floor(seconds / 3600)}h`;
+  return `${Math.floor(seconds / 86400)}d`;
+}
+function prUrlOf(v) {
+  return v.pr_repo_url && v.pr_number !== null ? `${v.pr_repo_url}/pull/${v.pr_number}` : null;
+}
 function runDurationLabel(run, now = Date.now()) {
   if (!run.started_at) return "\u2014";
   const seconds = Math.max(0, Math.round(((run.ended_at ?? now) - run.started_at) / 1e3));
@@ -4029,6 +4040,7 @@ function createApiClient(options) {
     deleteRoutingRule: (id) => request("DELETE", `/api/v1/routing-rules/${id}`),
     // Supervisor settings
     getSupervisorSettings: () => get("/api/v1/supervisor/settings"),
+    getSupervisorQueue: () => get("/api/v1/supervisor/queue"),
     updateSupervisorSettings: (body) => request("PUT", "/api/v1/supervisor/settings", body),
     // API keys (create/revoke require a browser session, not a key)
     listApiKeys: (filters = {}) => get(`/api/v1/api-keys${query(filters)}`),
@@ -4184,7 +4196,7 @@ function artifactSummary(a) {
     case "link":
       return cv.title ? `${cv.title} \u2014 ${cv.url}` : cv.url ?? "";
     case "pr":
-      return `${prRefLabel(cv)} \u2014 ${cv.pr_repo_url}/pull/${cv.pr_number}`;
+      return `${prRefLabel(cv)} \u2014 ${prUrlOf(cv)}`;
   }
 }
 function artifactTypeLabel(a) {
@@ -4234,6 +4246,84 @@ function commentLines(comment) {
   const header = `  [${timestamp(comment.created_at)}] ${actorLabel(comment.actor)} (${comment.id})${comment.updated_at ? " (edited)" : ""}:`;
   return ["", header, ...comment.body.split("\n").map((line) => `  ${line}`)];
 }
+function sinceLastRunLines(since, now = Date.now()) {
+  const prev = since.previous_run;
+  const ended = prev.ended_at === null ? "not ended" : `ended ${ageLabel(prev.ended_at, now)} ago`;
+  const lines = [
+    `since the last run (${prev.state_at_start_name ?? "unknown state"}, ${prev.run_id} ${ended}):`
+  ];
+  const t = since.transition;
+  if (t) {
+    const via = t.action ? `via "${t.action}"` : "moved directly";
+    const stale = since.stale_artifacts.length > 0 ? ` \u2014 now stale: ${since.stale_artifacts.join(", ")}` : "";
+    lines.push(
+      `  moved from ${t.from_state.name} ${via} by ${actorLabel(t.actor)} ${ageLabel(t.at, now)} ago${stale}`
+    );
+  }
+  for (const c of since.comments) lines.push(...commentLines(c));
+  if (since.comment_count > since.comments.length) {
+    const hidden = since.comment_count - since.comments.length;
+    lines.push(`  \u2026 and ${hidden} earlier comment${hidden === 1 ? "" : "s"}`);
+  }
+  return lines;
+}
+function roundLines(round, now = Date.now()) {
+  const b = round.boundary;
+  const from = b ? `since ${actorLabel(b.actor)} ${b.action ? `moved "${b.action}"` : "moved it directly"} ${timestamp(b.at)}` : `since created ${timestamp(round.boundary_at)}`;
+  const lines = [`round (${round.run_count} run${round.run_count === 1 ? "" : "s"} ${from}):`];
+  for (const stage of round.stages) {
+    const [latest, ...earlier] = stage.runs;
+    if (!latest) continue;
+    lines.push(`  ${stage.state.name ?? stage.state.id} \u2014 ${runHeadline(latest, now)}`);
+    if (latest.artifacts.length > 0) {
+      lines.push(`    ${latest.artifacts.map(artifactChangeLabel).join(" \xB7 ")}`);
+    }
+    for (const run of earlier) lines.push(`    ${earlierAttemptLine(run, now)}`);
+    if (latest.summary_comment) {
+      lines.push(`    summary (${latest.summary_comment.id}):`);
+      for (const line of latest.summary_comment.body.split("\n")) lines.push(`      ${line}`);
+    }
+    const earlierComments = latest.earlier_comment_ids;
+    if (earlierComments.length > 0) {
+      lines.push(
+        `    ${earlierComments.length} earlier comment${earlierComments.length === 1 ? "" : "s"}: ${earlierComments.join(", ")}`
+      );
+    }
+  }
+  return lines;
+}
+function runHeadline(run, now) {
+  const cost = runCostLabel(run);
+  return [
+    `${run.run_id} on ${run.runner_name}`,
+    runDurationLabel(run, now),
+    run.outcome ?? run.status,
+    ...cost ? [cost] : [],
+    run.transition ? `"${run.transition.action ?? "moved directly"}" \u2192 ${run.transition.to_state.name}` : "no transition"
+  ].join(" \xB7 ");
+}
+function earlierAttemptLine(run, now) {
+  const back = run.returned_via;
+  const how = back ? back.action ? `sent back by ${back.from_state.name} ("${back.action}")` : "moved directly back" : "never came back";
+  return `${run.run_id} \xB7 ${runDurationLabel(run, now)} \xB7 ${run.outcome ?? run.status} \xB7 ${how}`;
+}
+function artifactChangeLabel(a) {
+  const versions = a.from_version === null ? `v${a.to_version}` : `v${a.from_version} \u2192 v${a.to_version}`;
+  const extra = a.pr_url ? ` (${a.pr_url})` : a.files ? ` (${a.files.length} file${a.files.length === 1 ? "" : "s"})` : "";
+  return `${a.name} ${versions}${extra}`;
+}
+function arrivedViaLabel(via) {
+  if (!via) return "\u2014";
+  return via.action ?? "moved directly";
+}
+function roundSummaryLabel(summary) {
+  if (!summary) return "\u2014";
+  const parts = [
+    ...summary.pr_url ? [`PR ${summary.pr_url.split("/").pop()}`] : [],
+    ...summary.artifacts.map((a) => `${a.name} v${a.version}`)
+  ];
+  return parts.length > 0 ? parts.join(" \xB7 ") : "\u2014";
+}
 function runRow(run) {
   return [
     run.id,
@@ -4257,21 +4347,20 @@ function byteSize(bytes) {
   const rounded = unit <= 1 ? Math.round(value) : Math.round(value * 10) / 10;
   return `${unit <= 1 ? rounded : rounded.toFixed(1)} ${units[unit]}`;
 }
-function ageLabel(isoTimestamp, now = Date.now()) {
-  const then = Date.parse(isoTimestamp);
-  if (!Number.isFinite(then)) return "\u2014";
-  const seconds = Math.max(0, Math.round((now - then) / 1e3));
-  if (seconds < 60) return `${seconds}s`;
-  if (seconds < 3600) return `${Math.floor(seconds / 60)}m`;
-  if (seconds < 86400) return `${Math.floor(seconds / 3600)}h`;
-  return `${Math.floor(seconds / 86400)}d`;
+function ageLabel2(isoTimestamp, now = Date.now()) {
+  return ageLabel(Date.parse(isoTimestamp), now);
+}
+function hoursLabel(ms, now = Date.now()) {
+  const hours = Math.max(0, now - ms) / 36e5;
+  if (hours < 48) return `${hours < 10 ? hours.toFixed(1) : Math.round(hours)}h`;
+  return `${Math.round(hours / 24)}d`;
 }
 function keptWorkspaceRow(kept, sizeBytes, now = Date.now()) {
   return [
     kept.run_id,
     kept.issue_ref ?? "\u2014",
     kept.status,
-    ageLabel(kept.kept_at, now),
+    ageLabel2(kept.kept_at, now),
     byteSize(sizeBytes),
     kept.path
   ];
@@ -5270,6 +5359,14 @@ allowed actions: ${allowed.length ? allowed.join(", ") : "none (terminal state)"
       for (const line of rest) console.log(`  ${line}`);
     }
   }
+  if (issue.since_last_run && issue.effective_state.category === "active") {
+    console.log("");
+    for (const line of sinceLastRunLines(issue.since_last_run)) console.log(line);
+  }
+  if (issue.round && issue.effective_state.category === "awaiting_human") {
+    console.log("");
+    for (const line of roundLines(issue.round)) console.log(line);
+  }
   if (issue.comments.length > 0) {
     console.log(`
 comments (${issue.comments.length}):`);
@@ -5390,6 +5487,25 @@ function register2(program3) {
       );
       printList(res, opts, (items) => {
         if (items.length === 0) return console.log(opts.ready ? "no ready issues" : "no issues");
+        if (opts.category === "awaiting_human") {
+          table([
+            ["REF", "TITLE", "STATE", "WAITING", "VIA", "ROUND", ""],
+            ...items.map((i) => [
+              `${i.project_name}/${i.number}`,
+              i.title,
+              i.effective_state.name,
+              ageLabel2(new Date(i.state_entered_at).toISOString()),
+              arrivedViaLabel(i.arrived_via),
+              roundSummaryLabel(i.round_summary ?? null),
+              [
+                i.open_blockers.length > 0 ? "blocked" : "",
+                i.duplicate_of ? "dup" : "",
+                ...i.labels.map((l) => `[${l.name}]`)
+              ].filter(Boolean).join(" ")
+            ])
+          ]);
+          return;
+        }
         table([
           ["REF", "TITLE", "STATE", "CATEGORY", "LAST ACTIVITY", ""],
           ...items.map((i) => [
@@ -8258,20 +8374,108 @@ recent instances:`);
 }
 
 // src/commands/supervisor.ts
+function queueBlocks(groups) {
+  const byKey = /* @__PURE__ */ new Map();
+  for (const g of groups) {
+    const key = `${g.verdict}|${g.runner_id ?? ""}`;
+    const seen = byKey.get(key);
+    if (seen) {
+      seen.count += g.count;
+      seen.groups.push(g);
+      seen.binding ??= g.binding;
+    } else {
+      byKey.set(key, {
+        verdict: g.verdict,
+        runnerName: g.runner_name,
+        binding: g.binding,
+        count: g.count,
+        groups: [g]
+      });
+    }
+  }
+  return [...byKey.values()].sort((a, b) => b.count - a.count);
+}
+function queueHeadline(block) {
+  const runner = block.runnerName ?? "the routed runner";
+  switch (block.verdict) {
+    case "ok":
+      return "dispatching next pass";
+    case "at_capacity":
+      return block.binding?.kind === "max_concurrent" ? `at capacity on ${runner} (${block.binding.current}/${block.binding.limit})` : `at capacity on ${runner}`;
+    case "quota_exhausted":
+      if (block.binding?.kind === "global_cap")
+        return `global cap reached (${block.binding.current}/${block.binding.limit})`;
+      if (block.binding?.kind === "state_roster")
+        return `roster limit reached (${block.binding.current}/${block.binding.limit})`;
+      return "quota exhausted";
+    case "offline":
+      return `${runner} offline`;
+    case "paused":
+      return `${runner} paused`;
+    case "draining":
+      return `${runner} draining`;
+    case "backing_off":
+      return `${runner} backing off`;
+    case "no_rule":
+      return "no matching routing rule";
+    case "no_targets":
+      return "the matching rule has no targets";
+    case "ambiguous_rule":
+      return "two routing rules tie";
+    case "pin_missing":
+      return "pinned to a runner that is gone";
+    case "automation_off":
+      return "automation is off";
+    case "parked":
+      return "parked";
+  }
+}
+function queueFix(block) {
+  const runner = block.runnerName ?? "the routed runner";
+  switch (block.verdict) {
+    case "at_capacity":
+      return `raise the cap on ${runner} \u2014 restart its daemon with tines runner daemon --max-concurrent N, or edit the runner on the Agents page`;
+    case "quota_exhausted":
+      return block.binding?.kind === "state_roster" ? "raise the roster limit \u2014 tines supervisor quota roster --default <n> --state <workflow>/<state>=<n> (this replaces the whole roster, so restate every override you keep)" : "raise the cap \u2014 tines supervisor quota global <n> \u2014 or switch to a per-state roster with tines supervisor quota roster";
+    case "offline":
+      return `start the daemon on that machine \u2014 tines runner daemon`;
+    case "paused":
+      return `tines runners resume ${runner}`;
+    case "no_rule":
+      return "add a routing rule for that state \u2014 tines routing set <runner> --state <workflow>/<state>";
+    case "no_targets":
+    case "ambiguous_rule":
+      return "tines routing list, then edit the rule";
+    case "pin_missing":
+      return "clear the pin on those issues";
+    case "automation_off":
+      return "tines supervisor enable";
+    case "backing_off":
+      return "retries automatically; check the daemon log if it keeps failing";
+    default:
+      return null;
+  }
+}
 function register10(program3) {
   const supervisor = program3.command("supervisor").description("The automation kill switch, quota policy, and attempt limit");
   withCommon(
     supervisor.command("status").description("One-screen overview: kill switch, quota, utilization, runners")
   ).action(async (opts) => {
     const api = client(opts);
-    const [settings, runnersRes, workflows, activeRunItems] = await Promise.all([
+    const [settings, runnersRes, workflows, activeRunItems, queue] = await Promise.all([
       api.getSupervisorSettings(),
       api.listRunners(),
       api.listWorkflows(),
-      listAll((page) => api.listRuns({ active: true, ...page }))
+      listAll((page) => api.listRuns({ active: true, ...page })),
+      api.getSupervisorQueue()
     ]);
     if (opts.json) {
-      return printJson({ settings, runners: runnersRes.items, active_runs: activeRunItems });
+      return printJson({
+        settings,
+        runners: runnersRes.items,
+        active_runs: activeRunItems,
+        queue
+      });
     }
     const stateNames = /* @__PURE__ */ new Map();
     for (const wf of workflows.items) {
@@ -8285,6 +8489,27 @@ function register10(program3) {
       `utilization: ${utilizationLabel(settings.quota, activeRunItems, (id) => stateNames.get(id) ?? id)}`
     );
     console.log(`attempt limit: ${settings.attempt_limit} strikes, then the issue parks`);
+    if (queue.waiting === 0) {
+      console.log("waiting: nothing");
+    } else {
+      console.log(`waiting: ${queue.waiting} ${queue.waiting === 1 ? "issue" : "issues"}`);
+      for (const block of queueBlocks(queue.groups)) {
+        const states = block.groups.map(
+          (g) => `${stateNames.get(g.state_id) ?? g.state_name} ${g.count} (oldest ${hoursLabel(g.oldest_entered_at)})`
+        ).join(" \xB7 ");
+        console.log(`  ${queueHeadline(block)}: ${states}`);
+        const fix = queueFix(block);
+        if (fix) console.log(`    fix: ${fix}`);
+      }
+    }
+    console.log(
+      queue.parked.count === 0 ? "parked: none" : `parked: ${queue.parked.count}, oldest ${hoursLabel(queue.parked.oldest_entered_at ?? Date.now())}`
+    );
+    if (queue.awaiting_human.count > 0) {
+      console.log(
+        `awaiting you: ${queue.awaiting_human.count} issues, oldest ${hoursLabel(queue.awaiting_human.oldest_entered_at ?? Date.now())}`
+      );
+    }
     if (runnersRes.items.length === 0) {
       console.log("runners: none");
     } else {

package/package.json

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