tines 0.0.141 → 0.0.143

package/dist/index.js

@@ -4029,6 +4029,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)}`),
@@ -4266,6 +4267,11 @@ function ageLabel(isoTimestamp, now = Date.now()) {
   if (seconds < 86400) return `${Math.floor(seconds / 3600)}h`;
   return `${Math.floor(seconds / 86400)}d`;
 }
+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,
@@ -5314,7 +5320,16 @@ function printExplainer(issue, ex) {
   console.log(`
 ${ex.verdict}
 `);
-  table(ex.checks.map((c) => [`  ${c.ok ? "ok" : "FAIL"}`, c.name.replaceAll("_", " "), c.detail]));
+  table(
+    ex.checks.map((c) => [
+      `  ${c.ok ? "ok" : "FAIL"}`,
+      c.name.replaceAll("_", " "),
+      c.detail,
+      // The remedy, when the check has one and it is something to run
+      // here: a link is useless without an origin.
+      c.action?.cli ? `fix: ${c.action.cli}` : ""
+    ])
+  );
   if (ex.pin) {
     console.log(
       `
@@ -7277,6 +7292,9 @@ async function runDaemon(opts) {
     creds = { runner_id: registered.runner.id, token: registered.runner_token };
     saveRunnerCredentials(opts.configDir, opts.url, opts.name, creds);
     log(`registered runner "${opts.name}" (${creds.runner_id}); token stored in ${opts.configDir}`);
+    log(
+      `next: route work to "${opts.name}" and turn automation on \u2014 ${opts.url}/agents (or: tines routing set ${opts.name} && tines supervisor enable)`
+    );
   }
   const client2 = createApiClient({ baseUrl: opts.url, apiKey: creds.token });
   const statePath = daemonStatePath(opts.configDir, creds.runner_id);
@@ -7865,7 +7883,10 @@ function register8(program3) {
   withCommon(
     runnerCmd.command("daemon").description(
       "Run the local runner daemon: register/reconnect, poll for assigned runs, execute them"
-    ).option("--name <name>", "runner name, unique per user (default: this hostname)").option("--harness <harness>", "claude-code | codex | custom", "claude-code").option(
+    ).option(
+      "--name <name>",
+      "runner name, unique per user; name it machine-plus-harness, e.g. macbook-claude (default: this hostname)"
+    ).option("--harness <harness>", "claude-code | codex | custom", "claude-code").option(
       "--command <template>",
       "custom harness command template ({prompt_file}, {workspace}, {model})"
     ).option("--max-concurrent <n>", "maximum simultaneous runs", (v) => Number.parseInt(v, 10), 1).option(
@@ -8243,20 +8264,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) {
@@ -8270,6 +8379,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.141",
+  "version": "0.0.143",
   "description": "CLI for Tines, an orchestration layer for AI agents",
   "repository": {
     "type": "git",