@standardagents/code 0.1.3 → 0.2.0

package/dist/index.js

@@ -10,6 +10,69 @@ import crypto from 'crypto';
 import readline from 'readline';
 
 // src/api.ts
+function classifyConnectError(err, endpoint) {
+  const host = endpoint.replace(/^https?:\/\//, "").replace(/\/.*$/, "");
+  const codes = /* @__PURE__ */ new Set();
+  const messages = [];
+  for (let e = err; e; e = e.cause) {
+    if (typeof e.code === "string") codes.add(e.code);
+    if (typeof e.message === "string") messages.push(e.message);
+    if (Array.isArray(e.errors)) {
+      for (const sub of e.errors) {
+        if (typeof sub?.code === "string") codes.add(sub.code);
+        if (typeof sub?.message === "string") messages.push(sub.message);
+      }
+    }
+  }
+  const text = messages.join(" | ");
+  const has = (...wanted) => wanted.some((w) => codes.has(w));
+  if (has("ENOTFOUND", "EAI_AGAIN")) {
+    return {
+      ok: false,
+      reason: `Can't resolve ${host} \u2014 no such hostname from this machine.`,
+      hint: "The endpoint URL is probably wrong (typo, or that server isn't running). Check the URL, your VPN, and local DNS."
+    };
+  }
+  if (has("ECONNREFUSED")) {
+    return {
+      ok: false,
+      reason: `${host} refused the connection \u2014 nothing is listening there.`,
+      hint: "The instance looks stopped. Start it (or check the port in the endpoint URL)."
+    };
+  }
+  if (has("EHOSTUNREACH", "ENETUNREACH", "ENETDOWN")) {
+    return {
+      ok: false,
+      reason: `No route to ${host} \u2014 the network looks down or unreachable.`,
+      hint: "Check your internet connection / VPN."
+    };
+  }
+  if (has("ETIMEDOUT", "UND_ERR_CONNECT_TIMEOUT", "UND_ERR_HEADERS_TIMEOUT") || err?.name === "TimeoutError") {
+    return {
+      ok: false,
+      reason: `${host} didn't answer in time.`,
+      hint: "The server may be overloaded or a firewall is eating the traffic. Try again."
+    };
+  }
+  if (has(
+    "UNABLE_TO_VERIFY_LEAF_SIGNATURE",
+    "DEPTH_ZERO_SELF_SIGNED_CERT",
+    "SELF_SIGNED_CERT_IN_CHAIN",
+    "CERT_HAS_EXPIRED",
+    "ERR_TLS_CERT_ALTNAME_INVALID"
+  ) || /certificate|TLS|SSL/i.test(text)) {
+    return {
+      ok: false,
+      reason: `TLS problem talking to ${host}: ${text.slice(0, 120)}`,
+      hint: "For local/self-signed endpoints, use the http:// URL or trust the local CA."
+    };
+  }
+  return {
+    ok: false,
+    reason: `Couldn't reach ${host}${text ? ` (${text.slice(0, 120)})` : ""}.`,
+    hint: "This is a connection problem, not a token problem \u2014 check the endpoint URL and your network."
+  };
+}
 var ApiClient = class {
   constructor(endpoint, token) {
     this.endpoint = endpoint;
@@ -47,12 +110,54 @@ var ApiClient = class {
     }
   }
   async verify() {
+    return (await this.verifyDetailed()).ok;
+  }
+  /**
+   * Check the endpoint + token and say PRECISELY what's wrong when they
+   * fail. "That token didn't work" is a lie when the real problem is a typo'd
+   * hostname, a stopped server, or a dead network — sign-in errors must let
+   * the user tell those apart from an actually-rejected key.
+   */
+  async verifyDetailed() {
+    let res;
     try {
-      await this.json("/api/auth/me");
-      return true;
-    } catch {
-      return false;
+      res = await fetch(`${this.endpoint}/api/auth/me`, {
+        headers: { Authorization: `Bearer ${this.token}` },
+        signal: AbortSignal.timeout(15e3)
+      });
+    } catch (err) {
+      return classifyConnectError(err, this.endpoint);
+    }
+    if (res.ok) return { ok: true };
+    if (res.status === 401) {
+      return {
+        ok: false,
+        reason: "The instance rejected this token \u2014 it's invalid, expired, or was revoked.",
+        hint: "Create a fresh API key in the instance settings (or press Enter to sign in with your browser). Keys only work on the instance that minted them."
+      };
+    }
+    if (res.status === 403) {
+      return {
+        ok: false,
+        reason: "The token was recognized, but this account isn't allowed to use the API here.",
+        hint: "Ask an instance admin to grant access, or use a different account's key."
+      };
+    }
+    if (res.status === 404 || res.status === 405) {
+      return {
+        ok: false,
+        reason: `${this.endpoint} answered, but it doesn't look like a Standard Agents instance (no /api/auth/me).`,
+        hint: "Double-check the endpoint URL \u2014 this may be a different service."
+      };
     }
+    if (res.status >= 500) {
+      return {
+        ok: false,
+        reason: `The instance hit an error while checking the token (HTTP ${res.status}).`,
+        hint: "That's a server-side problem \u2014 check the instance's logs and try again."
+      };
+    }
+    return { ok: false, reason: `The instance answered HTTP ${res.status} while checking the token.` };
   }
   /** Agent name → display title map (best effort; for labeling subagents). */
   async listAgents() {
@@ -69,12 +174,22 @@ var ApiClient = class {
     if (!id) throw new Error("Thread create returned no id");
     return id;
   }
-  /** List threads for an agent, optionally filtering to those carrying all given tags. */
+  /**
+   * List threads for an agent (or several variants of it), optionally
+   * filtering to those carrying all given tags. Multiple ids exist because
+   * the instance's model gearbox hands a session between agent variants — a
+   * thread that last ran in another gear must still show up for resume.
+   */
   async listThreads(agentId, requireTags) {
-    const res = await this.json(
-      `/api/threads?agent_id=${encodeURIComponent(agentId)}&limit=100`
+    const ids = Array.isArray(agentId) ? agentId : [agentId];
+    const pages = await Promise.all(
+      ids.map(
+        (id) => this.json(
+          `/api/threads?agent_id=${encodeURIComponent(id)}&limit=100`
+        ).catch(() => [])
+      )
     );
-    const arr = Array.isArray(res) ? res : res.threads || [];
+    const arr = pages.flatMap((res) => Array.isArray(res) ? res : res.threads || []);
     return arr.map((t) => ({
       id: t.id,
       tags: Array.isArray(t.tags) ? t.tags : [],
@@ -384,9 +499,6 @@ function newFileLines(content) {
   return out;
 }
 function highlightBash(cmd) {
-  const CYAN2 = "\x1B[36m";
-  const GREEN = "\x1B[32m";
-  const MAGENTA = "\x1B[35m";
   let out = "";
   let i = 0;
   let expectProgram = true;
@@ -398,7 +510,7 @@ function highlightBash(cmd) {
         if (ch === '"' && cmd[j] === "\\") j++;
         j++;
       }
-      out += `${GREEN}${cmd.slice(i, Math.min(j + 1, cmd.length))}${RESET}`;
+      out += `${DIM}${cmd.slice(i, Math.min(j + 1, cmd.length))}${RESET}`;
       i = j + 1;
       continue;
     }
@@ -408,7 +520,7 @@ function highlightBash(cmd) {
     }
     const op = cmd.slice(i).match(/^(\|\||&&|\||;|>>|>|<)/);
     if (op) {
-      out += `${MAGENTA}${op[1]}${RESET}`;
+      out += `${DIM}${op[1]}${RESET}`;
       i += op[1].length;
       expectProgram = true;
       continue;
@@ -416,19 +528,24 @@ function highlightBash(cmd) {
     const word = cmd.slice(i).match(/^[^\s'"#|;&<>]+/);
     if (word) {
       const w = word[0];
-      if (w.startsWith("-")) out += `${DIM}${w}${RESET}`;
-      else if (expectProgram) {
-        out += `${CYAN2}${w}${RESET}`;
+      if (expectProgram && !w.startsWith("-")) {
+        out += w;
         expectProgram = false;
-      } else out += w;
+      } else {
+        out += `${DIM}${w}${RESET}`;
+      }
       i += w.length;
       continue;
     }
-    out += ch;
+    out += `${DIM}${ch}${RESET}`;
     i++;
   }
   return out;
 }
+function oneLineCommand(cmd, max) {
+  const collapsed = cmd.replace(/\s*\n+\s*/g, " \u23CE ").replace(/[ \t]{2,}/g, " ").trim();
+  return clamp(collapsed, max);
+}
 var GRAD_STOPS = [
   [255, 179, 92],
   // amber
@@ -664,7 +781,7 @@ var Bridge = class {
       this.hooks.onStatus?.(callKey, null);
     }
     if (result.ok) {
-      const display = req.tool === "bash" ? `bash: ${highlightBash(String(req.args.command ?? "").slice(0, 200))}` : summary;
+      const display = req.tool === "bash" ? `bash: ${highlightBash(oneLineCommand(String(req.args.command ?? ""), Math.max(40, (process.stdout.columns || 80) - 20)))}` : summary;
       let detail;
       if (req.tool === "edit_file") {
         detail = diffLines(String(req.args.old_string ?? ""), String(req.args.new_string ?? ""));
@@ -713,7 +830,7 @@ function describe(req) {
     case "run_skill_script":
       return `skill ${a.skill}: run ${a.entry}`;
     case "bash":
-      return `bash: ${String(a.command).slice(0, 80)}`;
+      return `bash: ${oneLineCommand(String(a.command ?? ""), 80)}`;
     default:
       return `${req.tool} ${JSON.stringify(a).slice(0, 80)}`;
   }
@@ -1195,6 +1312,9 @@ ${truncated}`
     const command = String(args.command || "");
     if (!command.trim()) return { ok: false, error: "command is required" };
     const cwd = args.cwd ? this.resolve(String(args.cwd)) : this.projectDir;
+    if (!fs4.existsSync(cwd)) {
+      return { ok: false, error: `cwd does not exist: ${cwd}` };
+    }
     const id = crypto.randomUUID().slice(0, 8);
     const logPath = path3.join(LOG_DIR, `${id}.log`);
     let out;
@@ -1211,15 +1331,22 @@ ${truncated}`
       fs4.closeSync(out);
       return { ok: false, error: `Failed to start: ${err instanceof Error ? err.message : String(err)}` };
     }
+    let spawnError = null;
+    child.on("error", (err) => {
+      spawnError = err;
+    });
     fs4.closeSync(out);
     const pid = child.pid;
-    if (!pid) return { ok: false, error: "Process failed to start (no pid)." };
     let earlyExit;
     const onEarlyExit = (code) => {
       earlyExit = code;
     };
     child.on("exit", onEarlyExit);
     await new Promise((r) => setTimeout(r, STARTUP_GRACE_MS));
+    if (spawnError) {
+      return { ok: false, error: `Failed to start: ${spawnError.message}` };
+    }
+    if (!pid) return { ok: false, error: "Process failed to start (no pid)." };
     if (earlyExit !== void 0 || !isAlive2(pid)) {
       const tail = await readLogTail(logPath, 15);
       const code = earlyExit ?? "unknown";
@@ -2346,24 +2473,22 @@ var Tui = class _Tui {
   spinnerFrame() {
     return `${C.bold}${C.cyan}${FRAMES[Math.floor(Date.now() / 100) % FRAMES.length]}${C.reset}`;
   }
-  /**
-   * "↑X ↓Y" cumulative token totals (greyed — low-priority), plus a context
-   * window gauge "ctx N%" when known. The gauge colour ramps with fill (green →
-   * yellow → red) so the user can see compaction approaching at a glance.
-   */
+  /** "↑X ↓Y" cumulative token totals (greyed — low-priority). */
   tokensText() {
     const parts = [];
     if (this.tokensIn > 0) parts.push(`\u2191${this.fmtTokens(this.tokensIn)}`);
     if (this.tokensOut > 0) parts.push(`\u2193${this.fmtTokens(this.tokensOut)}`);
-    let out = parts.length ? `${C.gray}${parts.join(" ")}${C.reset}` : "";
-    if (this.contextPct != null) {
-      const pct = this.contextPct;
-      const calmGreen = "\x1B[38;5;65m";
-      const col = pct >= 85 ? C.red : pct >= 70 ? C.yellow : calmGreen;
-      const gauge = `${col}ctx ${pct}%${C.reset}`;
-      out = out ? `${out} ${gauge}` : gauge;
-    }
-    return out;
+    return parts.length ? `${C.gray}${parts.join(" ")}${C.reset}` : "";
+  }
+  /**
+   * Understated context gauge, right-aligned on the summary line: just "N%",
+   * dim, and INVISIBLE until the conversation is more than 85% of the way to
+   * the compaction point (the percentage is scaled so 100% = where background
+   * compaction triggers, not the raw model window). Most sessions never see it.
+   */
+  contextGaugeText() {
+    if (this.contextPct == null || this.contextPct <= 85) return "";
+    return `${C.dim}${C.gray}${this.contextPct}%${C.reset}`;
   }
   /**
    * Set the context-window fill percentage (0–100), or null to hide it.
@@ -2376,9 +2501,9 @@ var Tui = class _Tui {
     this.contextPct = next;
     this.renderBottom();
   }
-  /** Plain "ctx N%" label (no ANSI) for menu hints, or "" when unknown. */
+  /** Plain context label (no ANSI) for menu hints, or "" when unknown. */
   contextPctLabel() {
-    return this.contextPct == null ? "" : `ctx ${this.contextPct}%`;
+    return this.contextPct == null ? "" : `context ${this.contextPct}%`;
   }
   /** Register the slash commands shown in the inline `/` palette. */
   setCommands(commands) {
@@ -2413,24 +2538,34 @@ var Tui = class _Tui {
    */
   statusLineText(cols2) {
     const tk = this.tokensText();
+    const gauge = this.contextGaugeText();
+    const gaugeReserve = gauge ? this.visibleWidth(gauge) + 1 : 0;
+    let line;
     if (this.working) {
       const el = this.formatElapsed(Date.now() - this.workingStart);
       const right = `${C.dim}${el}${C.reset}${tk ? " " + tk : ""}`;
       const head = `${this.spinnerFrame()} ${C.bold}Working${C.reset}`;
-      const avail = Math.max(0, cols2 - this.visibleWidth(head) - this.visibleWidth(right) - 2);
+      const avail = Math.max(
+        0,
+        cols2 - this.visibleWidth(head) - this.visibleWidth(right) - 2 - gaugeReserve
+      );
       let stepPart = "";
       if (this.step && avail > 1) {
         let s = this.step;
         if (s.length > avail) s = s.slice(0, avail - 1) + "\u2026";
         stepPart = ` ${C.dim}${s}${C.reset}`;
       }
-      return `${head}${stepPart} ${right}`;
-    }
-    if (this.goalComplete) {
+      line = `${head}${stepPart} ${right}`;
+    } else if (this.goalComplete) {
       const done = `${C.bold}${gradientText("\u2713 Goal complete.")}${C.reset}`;
-      return tk ? `${done} ${tk}` : done;
+      line = tk ? `${done} ${tk}` : done;
+    } else {
+      line = tk ? tk : null;
     }
-    return tk ? tk : null;
+    if (!gauge) return line;
+    const base = line ?? "";
+    const pad = Math.max(1, cols2 - 1 - this.visibleWidth(base) - this.visibleWidth(gauge));
+    return `${base}${" ".repeat(pad)}${gauge}`;
   }
   /** The prompt line prefix (with ANSI colour) that precedes the typed text. */
   promptPrefix() {
@@ -3720,6 +3855,7 @@ function saveDefaultEndpoint(endpoint) {
 
 // src/index.ts
 var AGENT_ID = "standard_code_agent";
+var AGENT_ID_VARIANTS = [AGENT_ID, "standard_code_high_agent"];
 var c = {
   reset: "\x1B[0m",
   dim: "\x1B[2m",
@@ -3982,8 +4118,22 @@ ${c.dim}Press Control-C again to exit${c.reset}
   }
   const stored = getCredential(endpoint);
   let api = stored ? new ApiClient(endpoint, stored.access_token) : null;
-  if (!api || !await api.verify()) {
+  const storedCheck = api ? await api.verifyDetailed() : null;
+  if (!api || !storedCheck?.ok) {
     const host = endpoint.replace(/^https?:\/\//, "").replace(/\/$/, "");
+    if (storedCheck && !storedCheck.ok) {
+      stdout.write(`${c.red}\u2717${c.reset} ${c.dim}Saved sign-in for this endpoint failed:${c.reset} ${storedCheck.reason}
+`);
+      if (storedCheck.hint) stdout.write(`  ${c.dim}${storedCheck.hint}${c.reset}
+`);
+      stdout.write("\n");
+    }
+    const explainFailure = (result, prefix) => {
+      stdout.write(`${c.red}\u2717${c.reset} ${prefix}${result.reason}
+`);
+      if (result.hint) stdout.write(`  ${c.dim}${result.hint}${c.reset}
+`);
+    };
     stdout.write(
       `${c.bold}${c.white}Sign in${c.reset} ${c.dim}\u2014 connect to${c.reset} ${c.teal}${host}${c.reset}
 `
@@ -4003,7 +4153,8 @@ ${c.dim}Press Control-C again to exit${c.reset}
         });
         if (!got) continue;
         api = new ApiClient(endpoint, got);
-        if (await api.verify()) {
+        const check2 = await api.verifyDetailed();
+        if (check2.ok) {
           saveCredential(
             { endpoint, access_token: got, token_type: "Bearer", saved_at: Date.now() },
             { updateDefault: !endpointOverride }
@@ -4012,12 +4163,12 @@ ${c.dim}Press Control-C again to exit${c.reset}
 `);
           break;
         }
-        stdout.write(`${c.red}\u2717${c.reset} ${c.dim}Browser sign-in didn't verify. Try again.${c.reset}
-`);
+        explainFailure(check2, "Browser sign-in didn't verify: ");
         continue;
       }
       api = new ApiClient(endpoint, token);
-      if (await api.verify()) {
+      const check = await api.verifyDetailed();
+      if (check.ok) {
         saveCredential(
           { endpoint, access_token: token, token_type: "Bearer", saved_at: Date.now() },
           { updateDefault: !endpointOverride }
@@ -4026,8 +4177,7 @@ ${c.dim}Press Control-C again to exit${c.reset}
 `);
         break;
       }
-      stdout.write(`${c.red}\u2717${c.reset} ${c.dim}That token didn't work. Try again.${c.reset}
-`);
+      explainFailure(check, "");
     }
   } else if (endpointPrompted) {
     saveDefaultEndpoint(endpoint);
@@ -4038,7 +4188,7 @@ ${c.dim}Press Control-C again to exit${c.reset}
   const tags = [`path:${projectDir}`, `machine:${machine}`];
   let existing = [];
   try {
-    existing = await api.listThreads(AGENT_ID, tags);
+    existing = await api.listThreads(AGENT_ID_VARIANTS, tags);
   } catch {
     existing = [];
   }
@@ -4293,9 +4443,11 @@ ${c.bold}why: ${req.requestPermission}${c.reset}` : ""}`,
       const subs = await api.listSubagents(threadId);
       activeSubagents.clear();
       for (const s of subs) {
-        if (s.status !== "running") continue;
+        const status = (s.status || "").trim();
+        if (status === "idle" || status === "terminated") continue;
+        const detail = status && status !== "running" ? ` \u2014 ${status.slice(0, 80)}` : "";
         activeSubagents.set(s.id, {
-          label: subagentLabel(s, agentTitles),
+          label: `${subagentLabel(s, agentTitles)}${detail}`,
           agentName: s.agent_name ?? void 0
         });
       }
@@ -4331,6 +4483,10 @@ ${c.bold}why: ${req.requestPermission}${c.reset}` : ""}`,
       if (activeSubagents.has(id)) scheduleReconcile();
     }
   });
+  const heartbeatPoll = setInterval(() => {
+    if (activeSubagents.size > 0) scheduleReconcile();
+  }, 5e3);
+  heartbeatPoll.unref();
   const quit = async () => {
     tui.end();
     const stopped = api.stop(threadId).catch(() => {
@@ -4611,10 +4767,11 @@ ${c.bold}why: ${req.requestPermission}${c.reset}` : ""}`,
       refreshStatus();
     } catch {
     }
+    const COMPACTION_TRIGGER_FRACTION = 0.5;
     try {
       const cu = await api.kvGet(threadId, "context_usage");
       const used = Number(cu?.inputTokens) || 0;
-      const max = Number(cu?.maxContextTokens) || 0;
+      const max = (Number(cu?.maxContextTokens) || 0) * COMPACTION_TRIGGER_FRACTION;
       tui.setContextPct(max > 0 && used > 0 ? used / max * 100 : null);
     } catch {
     }