aether-code 0.36.7 → 0.37.0

package/src/render.js

@@ -26,6 +26,8 @@ export function divider() {
 
 const stripAnsi = (s) => s.replace(/\x1b\[[0-9;]*m/g, "");
 
+// Draw a bordered box around content lines, returning the rows as an array (so
+// boxes can be composed side by side). Rounded box-drawing chars.
 export function boxLines(lines, { color = c.gray, padX = 2, minInner = 0 } = {}) {
   const inner = Math.max(minInner, 0, ...lines.map((l) => stripAnsi(l).length));
   const w = inner + padX * 2;
@@ -41,6 +43,8 @@ export function box(lines, opts) {
   return boxLines(lines, opts).join("\n");
 }
 
+// Join two blocks of lines horizontally with a gap, padding the left block to a
+// uniform width so the right block aligns. Shorter block is padded with blanks.
 export function sideBySide(a, b, gap = 3) {
   const wa = Math.max(0, ...a.map((l) => stripAnsi(l).length));
   const h = Math.max(a.length, b.length);
@@ -58,6 +62,7 @@ export function turn(n) {
 }
 
 export function toolHeader(name, args) {
+  // Format args compactly. If any value is huge, truncate it.
   const compact = JSON.stringify(args);
   const trimmed = compact.length > 120 ? compact.slice(0, 117) + "..." : compact;
   return `${c.cyan(c.bold(name))}${c.gray("(")}${c.gray(trimmed)}${c.gray(")")}`;
@@ -65,10 +70,12 @@ export function toolHeader(name, args) {
 
 const ellip = (s, n) => (s && s.length > n ? s.slice(0, n - 1) + "…" : s || "");
 
+// Clean one-line label for a tool call — a verb + its key argument, instead of
+// dumping raw JSON (which buried file contents / queries in noise).
 export function toolLabel(name, args) {
   const a = args || {};
   const verb = (v) => c.cyan(c.bold(v));
-  const arg = (s) => c.gray(ellip(s == null ? "" : String(s), 72));
+  const arg = (s) => c.gray(ellip(String(s), 72));
   switch (name) {
     case "read_file":    return `${verb("read")}   ${arg(a.path)}`;
     case "write_file":   return `${verb("write")}  ${arg(a.path)}`;
@@ -77,174 +84,68 @@ export function toolLabel(name, args) {
     case "glob_files":   return `${verb("find")}   ${arg(a.pattern)}`;
     case "search_files": return `${verb("search")} ${arg(`/${a.pattern}/ in ${a.path ?? "."}`)}`;
     case "run_shell":    return `${verb("run")}    ${arg(a.command)}`;
-    case "web_search":   return `${verb("search web")} ${arg(a.query ?? "")}`;
+    case "web_search":   return `${verb("search web")} ${arg(JSON.stringify(a.query ?? ""))}`;
     case "web_fetch":    return `${verb("fetch")}  ${arg(a.url)}`;
-    case "todo_write":   return "";
-    case "ask_user":     return "";
+    case "todo_write":   return ""; // its Plan box is the label
+    case "ask_user":     return ""; // the interactive menu is its display
     default:             return `${verb(name)} ${arg(JSON.stringify(a))}`;
   }
 }
 
+// Set the terminal window/tab title (so cmd.exe shows "Aether", not the node
+// path). OSC 0 — supported by cmd.exe, Windows Terminal, and POSIX terminals.
 export function setTerminalTitle(title) {
   if (process.stdout.isTTY) process.stdout.write(`\x1b]0;${title}\x07`);
 }
 
-// Fun thinking words — like Claude Code's "Hullaballooing...", "Cogitating..."
-const THINKING_WORDS = [
-  "Thinking",
-  "Pondering",
-  "Mulling",
-  "Cogitating",
-  "Ruminating",
-  "Deliberating",
-  "Contemplating",
-  "Noodling",
-  "Musing",
-  "Brainstorming",
-  "Percolating",
-  "Brainwaving",
-  "Daydreaming",
-  "Hullaballooing",
-  "Churning",
-  "Brewing",
-  "Conjuring",
-  "Scheming",
-  "Hatching",
-  "Concocting",
-  "Simmering",
-  "Marinating",
-  "Fermenting",
-  "Stewing",
-  "Whittling",
-  "Tinkering",
-  "Puzzling",
-  "Deciphering",
-  "Unraveling",
-  "Distilling",
-];
-
-// Pick a random thinking word (seeded by current second so it varies per call)
-function pickThinkingWord() {
-  const idx = (Date.now() % (THINKING_WORDS.length * 1000)) / 1000 | 0;
-  return THINKING_WORDS[idx % THINKING_WORDS.length];
-}
-
+// Live "working…" spinner. Rewrites a single line in place (\r) with a rotating
+// half-circle (Geometric Shapes — same block as ●, so cmd.exe-safe) + elapsed
+// seconds, so the user sees the agent is alive while the model thinks or a slow
+// tool runs. stop() clears the line and restores the cursor. No-op in non-TTY.
 export function startSpinner(label) {
-  if (!process.stdout.isTTY) return { stop: () => {}, update: () => {} };
-  // Ping-pong animation — cmd.exe-safe chars inspired by Claude Code's sparkle cycle
-  const frames = ["\xB7", "*", "+", "*", "\xB7", ".", "\xB7", "*", "+", "*", "\xB7", "."];
+  if (!process.stdout.isTTY) return { stop: () => {} };
+  const frames = ["◐", "◓", "◑", "◒"];
   const t0 = Date.now();
   let i = 0;
-  let tokenCount = 0;
-  let statusText = "";
-  const isThinking = label === "thinking";
-  const thinkWord = isThinking ? pickThinkingWord() : null;
-  process.stdout.write("\x1b[?25l");
+  process.stdout.write("\x1b[?25l"); // hide cursor
   const render = () => {
-    const ms = Date.now() - t0;
-    const secs = Math.floor(ms / 1000);
-    const timeFmt = secs >= 60
-      ? `${Math.floor(secs / 60)}m ${String(secs % 60).padStart(2, "0")}s`
-      : `${secs}s`;
-    const parts = [];
-    if (secs > 0) parts.push(timeFmt);
-    if (tokenCount > 0) parts.push(`${fmtTokens(tokenCount)} tokens`);
-    if (statusText) parts.push(statusText);
-    const metrics = parts.length > 0 ? c.gray(` (${parts.join(" \xB7 ")})`) : "";
-    const displayLabel = isThinking ? thinkWord : label;
-    process.stdout.write(`\r\x1b[K${c.cyan(frames[i % frames.length])} ${c.dim(displayLabel + "...")}${metrics}`);
+    const s = Math.floor((Date.now() - t0) / 1000);
+    const tail = s > 0 ? c.gray(`  ${s}s`) : "";
+    process.stdout.write(`\r\x1b[K${c.cyan(frames[i % frames.length])} ${c.gray(label + "…")}${tail}`);
     i++;
   };
   render();
   const timer = setInterval(render, 120);
-  if (typeof timer.unref === "function") timer.unref();
+  if (typeof timer.unref === "function") timer.unref(); // don't keep the process alive
   return {
-    update(data) {
-      if (data.tokens != null) tokenCount = data.tokens;
-      if (data.status != null) statusText = data.status;
-    },
-    stop() {
+    stop: () => {
       clearInterval(timer);
-      process.stdout.write("\r\x1b[K\x1b[?25h");
+      process.stdout.write("\r\x1b[K\x1b[?25h"); // clear line + show cursor
     },
   };
 }
 
-export function fmtTokens(n) {
-  if (n >= 1_000_000) return (n / 1_000_000).toFixed(1) + "M";
-  if (n >= 1_000) return (n / 1_000).toFixed(1) + "k";
-  return String(n);
-}
-
-export function turnStats({ elapsed, tokensIn, tokensOut, tools, credits }) {
-  const parts = [];
-  if (elapsed > 0) {
-    const s = Math.floor(elapsed / 1000);
-    parts.push(s >= 60 ? `${Math.floor(s / 60)}m ${String(s % 60).padStart(2, "0")}s` : `${s}s`);
-  }
-  if (tokensIn > 0 || tokensOut > 0) {
-    parts.push(`${fmtTokens(tokensIn)}->${fmtTokens(tokensOut)} tokens`);
-  }
-  if (tools > 0) parts.push(`${tools} tool call${tools === 1 ? "" : "s"}`);
-  if (credits > 0) parts.push(`${credits} credit${credits === 1 ? "" : "s"}`);
-  return parts.length > 0 ? c.dim(`  Brewed for ${parts.join(" \xB7 ")}`) : "";
-}
-
-export function toolResult(text, ok = true) {
-  const prefix = ok ? c.green("  ● ") : c.red("  × ");
-  const lines = text.split("\n");
-  const head = lines[0].slice(0, 200);
-  const rest = lines.slice(1, 6).join("\n").slice(0, 600);
-  return `${prefix}${head}${rest ? "\n" + c.dim(rest) : ""}`;
-}
-
-export function assistant(text) {
-  return text.split("\n").map((l) => `  ${l}`).join("\n");
-}
-
-export function errorLine(msg) {
-  return `${c.red(c.bold("Error:"))} ${msg}`;
-}
-
-export function note(msg) {
-  return c.dim(msg);
-}
-
+// Terse one-line result summary instead of dumping raw JSON / file contents.
+// Tools whose handlers already render rich output (diffs, the shell stream, the
+// plan) just get a check — the detail was already printed.
 export function toolSummary(name, result) {
   const ok = result.ok;
+  // A tree branch links the result to the action above it (modern CLI style).
   const branch = ok ? c.green("└─") : c.red("└─");
   const out = result.output ?? "";
   const firstLine = out.split("\n").find((l) => l.trim()) ?? "";
 
   if (name === "run_shell") {
     let code = null;
-    let stderr = "";
-    try {
-      const j = JSON.parse(out);
-      code = j.exit_code;
-      stderr = (j.stderr || "").split("\n")[0] || "";
-    } catch { /* ignore */ }
-    const status = code === null ? (ok ? "done" : "failed") : code === 0 ? "done" : `exit ${code}`;
-    const detail = !ok && stderr ? ` ${ellip(stderr, 60)}` : "";
-    return `  ${branch} ${c.gray(status + detail)}`;
-  }
-  if (name === "todo_write") return "";
-  if (name === "ask_user") return "";
-  if (name === "write_file") {
-    return `  ${branch} ${c.gray("wrote file")}`;
+    try { code = JSON.parse(out).exit_code; } catch { /* ignore */ }
+    return `  ${branch} ${c.gray(code === null ? (ok ? "done" : "failed") : `exit ${code}`)}`;
   }
-  if (name === "edit_file") {
+  if (name === "todo_write") return ""; // the Plan is its own feedback
+  if (name === "ask_user") return ""; // the menu already showed the answer
+  if (name === "write_file" || name === "edit_file") {
+    // Handler already printed the diff; echo its short status line.
     return `  ${branch} ${c.gray(ellip(firstLine, 100))}`;
   }
-  if (name === "web_search") {
-    let count = 0;
-    try { const j = JSON.parse(out); if (Array.isArray(j)) count = j.length; } catch { /* ignore */ }
-    return `  ${branch} ${c.gray(count > 0 ? `${count} results` : "no results")}`;
-  }
-  if (name === "web_fetch") {
-    const lines = out.split("\n").length;
-    return `  ${branch} ${c.gray(`${lines} lines fetched`)}`;
-  }
   let summary = "";
   try {
     const j = JSON.parse(out);
@@ -258,18 +159,28 @@ export function toolSummary(name, result) {
   return `  ${branch} ${c.gray(summary)}`;
 }
 
+// Strip model "harmony"/channel control tokens (<|channel|>, <|message|>,
+// <|tool_response|>, <channel|>, …) that occasionally leak into the text
+// stream. Belt-and-suspenders alongside the server-side scrub.
+// Only strips tokens containing a PIPE — the harmony/channel control tokens
+// (<|channel|>, <|tool_response|>, <channel|>) always have one. Real code like
+// <div>, Vec<T>, a < b has no pipe and is left untouched.
 const MODEL_TOKEN_RE = /<\|[a-z_]*\|?>|<[a-z_]+\|>/gi;
 
 export function stripModelTokens(text) {
   return text.replace(MODEL_TOKEN_RE, "");
 }
 
+// Streaming-safe stripper: the leaked tokens (<|channel|>, <|tool_response|>, …)
+// can be split across stream chunks ("<chann" then "el|>"), which a per-delta
+// regex misses. This buffers any trailing "<…" that might be the start of a
+// token and only emits it once it's confirmed not-a-token (or on flush).
 export function makeTokenStripper() {
   let buf = "";
   return {
     push(text) {
       buf = (buf + text).replace(MODEL_TOKEN_RE, "");
-      const partial = buf.match(/<[|a-z_/]*$/i);
+      const partial = buf.match(/<[|a-z_/]*$/i); // possible token start at the tail
       if (partial) {
         const emit = buf.slice(0, partial.index);
         buf = buf.slice(partial.index);
@@ -286,3 +197,25 @@ export function makeTokenStripper() {
     },
   };
 }
+
+export function toolResult(text, ok = true) {
+  const prefix = ok ? c.green("  ● ") : c.red("  × ");
+  // First line bold-ish, then dim continuation
+  const lines = text.split("\n");
+  const head = lines[0].slice(0, 200);
+  const rest = lines.slice(1, 6).join("\n").slice(0, 600);
+  return `${prefix}${head}${rest ? "\n" + c.dim(rest) : ""}`;
+}
+
+export function assistant(text) {
+  // Indent each line for visual separation from tool calls
+  return text.split("\n").map((l) => `  ${l}`).join("\n");
+}
+
+export function errorLine(msg) {
+  return `${c.red(c.bold("Error:"))} ${msg}`;
+}
+
+export function note(msg) {
+  return c.dim(msg);
+}