aether-code 0.32.2 → 0.33.1

package/bin/aether-code.js

@@ -28,7 +28,7 @@ import {
 import readline from "node:readline";
 import { c, errorLine, divider, setTerminalTitle } from "../src/render.js";
 
-const VERSION = "0.32.0";
+const VERSION = "0.33.1";
 
 /**
  * Try to start MCP servers from ~/.aether/mcp.json. Returns a started

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aether-code",
-  "version": "0.32.2",
+  "version": "0.33.1",
   "description": "Uncensored AI coding agent for your terminal — Claude Code alternative with MCP support. Reads code, writes files, runs commands. Drives IDA Pro, Roblox Studio, Wireshark, Blender, and any MCP server. No refusal layer.",
   "homepage": "https://trynoguard.com",
   "repository": {
@@ -25,7 +25,7 @@
   },
   "scripts": {
     "postinstall": "node scripts/postinstall.js",
-    "lint": "node --check bin/aether-code.js src/agent.js src/api.js src/config.js src/render.js src/tools.js src/diff.js src/repl.js src/mcp.js src/mcp-cli.js src/mcp-registry.js src/skills.js src/update-check.js src/ink-input.js scripts/postinstall.js",
+    "lint": "node --check bin/aether-code.js src/agent.js src/api.js src/config.js src/render.js src/tools.js src/diff.js src/repl.js src/mcp.js src/mcp-cli.js src/mcp-registry.js src/skills.js src/update-check.js src/box-input.js src/ink-input.js scripts/postinstall.js",
     "test": "node --test \"test/**/*.test.js\"",
     "prepublishOnly": "npm run lint && npm test"
   },

package/src/agent.js

@@ -3,12 +3,78 @@
 // tool calls (task done) or max-turns is reached.
 
 import os from "node:os";
+import fs from "node:fs";
 import path from "node:path";
 import { agentTurnStream, AetherError } from "./api.js";
 import { TOOL_DEFINITIONS, executeTool } from "./tools.js";
 import { unnamespaceToolName } from "./mcp.js";
 import { loadAllSkills, selectSkills, renderSkillsBlock } from "./skills.js";
-import { c, divider, turn, toolLabel, toolSummary, makeTokenStripper, errorLine, startSpinner } from "./render.js";
+import { c, divider, turn, toolLabel, toolSummary, makeTokenStripper, errorLine, startSpinner, turnStats, fmtTokens } from "./render.js";
+
+/* ─────────────────────── Image attachment parsing ─────────────────────── */
+
+const IMAGE_EXTS = new Set([".png", ".jpg", ".jpeg", ".gif", ".webp", ".bmp"]);
+const MIME_MAP = {
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".gif": "image/gif",
+  ".webp": "image/webp",
+  ".bmp": "image/bmp",
+};
+
+// Parse @path/to/image references from user input. Supports quoted paths for
+// spaces: @"C:\Users\me\my screenshot.png". Returns { text, images }.
+function parseImages(prompt, cwd) {
+  const re = /@("(?:[^"\\]|\\.)*"|[^\s]+)/g;
+  const images = [];
+  let cleaned = prompt;
+
+  for (const m of [...prompt.matchAll(re)]) {
+    const raw = m[1].replace(/^"|"$/g, "");
+    const ext = path.extname(raw).toLowerCase();
+    if (!IMAGE_EXTS.has(ext)) continue;
+
+    const abs = path.isAbsolute(raw) ? raw : path.resolve(cwd, raw);
+    try {
+      const buf = fs.readFileSync(abs);
+      if (buf.length > 20 * 1024 * 1024) {
+        console.log(c.yellow(`  ⚠ Image too large (>20MB), skipping: ${raw}`));
+        continue;
+      }
+      const mime = MIME_MAP[ext] || "image/png";
+      images.push({
+        url: `data:${mime};base64,${buf.toString("base64")}`,
+        name: path.basename(raw),
+        size: buf.length,
+      });
+      cleaned = cleaned.replace(m[0], "");
+    } catch (e) {
+      console.log(c.yellow(`  ⚠ Could not read image: ${raw} — ${e.code === "ENOENT" ? "file not found" : e.message}`));
+    }
+  }
+
+  return { text: cleaned.replace(/\s{2,}/g, " ").trim() || prompt.trim(), images };
+}
+
+// Build OpenAI-compatible content array with text + images, or plain string
+// when no images are attached.
+function buildContent(text, images) {
+  if (images.length === 0) return text;
+  const parts = [];
+  for (const img of images) {
+    parts.push({ type: "image_url", image_url: { url: img.url } });
+  }
+  parts.push({ type: "text", text });
+  return parts;
+}
+
+// Friendly file size: 1.2MB, 450KB, 128B
+function fmtSize(bytes) {
+  if (bytes >= 1_048_576) return (bytes / 1_048_576).toFixed(1) + "MB";
+  if (bytes >= 1024) return (bytes / 1024).toFixed(0) + "KB";
+  return bytes + "B";
+}
 
 const DEFAULT_MAX_TURNS = 25;
 
@@ -76,6 +142,15 @@ export async function runAgent({
     process.stderr.write(c.yellow(`(skill load failed: ${e.message})\n`));
   }
   const referencedPaths = [];
+
+  // Parse image attachments (@path/to/image.png) from the user's prompt.
+  const { text: cleanPrompt, images: attachedImages } = parseImages(initialPrompt, cwd);
+  if (attachedImages.length > 0) {
+    for (const img of attachedImages) {
+      console.log(`\n${c.cyan("●")} ${c.cyan(c.bold("image"))} ${c.gray(img.name)} ${c.gray(`(${fmtSize(img.size)})`)}`);
+    }
+  }
+
   // Two callers: one-shot (initialPrompt only, fresh conversation) and REPL
   // (priorMessages + initialPrompt to continue an ongoing chat).
   // On the FIRST message of a session, prepend an environment block so the
@@ -83,9 +158,11 @@ export async function runAgent({
   // X on my desktop" became `mkdir X` in whatever dir aether was launched from
   // (e.g. C:\WINDOWS\system32). Only prepended once — later turns carry it in
   // history.
+  const firstText = priorMessages ? cleanPrompt : envContext(cwd) + cleanPrompt;
+  const firstContent = buildContent(firstText, attachedImages);
   const messages = priorMessages
-    ? [...priorMessages, { role: "user", content: initialPrompt }]
-    : [{ role: "user", content: envContext(cwd) + initialPrompt }];
+    ? [...priorMessages, { role: "user", content: firstContent }]
+    : [{ role: "user", content: firstContent }];
   let totalCredits = 0;
   let totalIn = 0;
   let totalOut = 0;
@@ -108,15 +185,14 @@ export async function runAgent({
   let appliedNothingNudges = 0;
 
   for (let i = 0; i < maxTurns; i++) {
-    // No turn header and no leading blank here — each step (assistant text and
-    // each tool label) begins with its own "\n● ", so spacing stays exactly one
-    // blank line per step instead of stacking up.
+    const turnStart = Date.now();
 
     // Stream the assistant's response. Print text deltas as they arrive,
     // along with tool-call announcements as soon as the model commits to
     // calling a particular tool (i.e. the `name` arrives in the stream).
     const announced = new Set();
     let lastWasText = false;
+    let streamedChars = 0;
     const stripper = makeTokenStripper();
 
     // Select skills for this turn against the current user prompt + any
@@ -138,6 +214,8 @@ export async function runAgent({
         tools,
         model,
         onDelta: (text) => {
+          streamedChars += text.length;
+          spinner.update({ tokens: Math.ceil(streamedChars / 3.5) });
           // Buffered strip of leaked model channel/control tokens (which can
           // be split across stream chunks) before display.
           const clean = stripper.push(text);
@@ -180,13 +258,13 @@ export async function runAgent({
       process.stdout.write(tail);
     }
     if (lastWasText) process.stdout.write("\n");
+    const turnIn = res.usage?.prompt_tokens ?? 0;
+    const turnOut = res.usage?.completion_tokens ?? 0;
     totalCredits += res.creditsCharged ?? 0;
-    totalIn += res.usage?.prompt_tokens ?? 0;
-    totalOut += res.usage?.completion_tokens ?? 0;
+    totalIn += turnIn;
+    totalOut += turnOut;
     if (typeof res.balanceAfter === "number") lastBalance = res.balanceAfter;
     onTokens({ totalCredits, totalIn, totalOut, balance: lastBalance });
-    // Per-turn cost line removed for a cleaner look — the session summary at the
-    // end carries the totals.
 
     // Push assistant message into history
     messages.push({
@@ -289,6 +367,16 @@ export async function runAgent({
         content: result.output ?? (result.ok ? "(no output)" : "Failed."),
       });
     }
+
+    // Per-turn stats line — shows elapsed time, token flow, and tool count.
+    const stats = turnStats({
+      elapsed: Date.now() - turnStart,
+      tokensIn: turnIn,
+      tokensOut: turnOut,
+      tools: toolCalls.length,
+      credits: res.creditsCharged ?? 0,
+    });
+    if (stats) console.log(stats);
   }
 
   console.log(c.yellow(`\nReached max turns (${maxTurns}). Stopping.`));
@@ -317,16 +405,30 @@ function buildTurnMessages(messages, allSkills, referencedPaths) {
     if (messages[i].role === "user") { lastUserIdx = i; break; }
   }
   if (lastUserIdx === -1) return messages;
-  const prompt = typeof messages[lastUserIdx].content === "string"
-    ? messages[lastUserIdx].content
-    : "";
+  // Content can be a string or a multimodal array (when images are attached).
+  // Extract the text portion for skill selection; prepend skills to text only.
+  const rawContent = messages[lastUserIdx].content;
+  let prompt;
+  if (typeof rawContent === "string") {
+    prompt = rawContent;
+  } else if (Array.isArray(rawContent)) {
+    const textPart = rawContent.find((p) => p.type === "text");
+    prompt = textPart?.text ?? "";
+  } else {
+    prompt = "";
+  }
   const active = selectSkills({ skills: allSkills, prompt, referencedPaths });
   if (active.length === 0) return messages;
   const block = renderSkillsBlock(active);
   const cloned = [...messages];
-  cloned[lastUserIdx] = {
-    ...cloned[lastUserIdx],
-    content: `${block}\n\n---\n\n${prompt}`,
-  };
+  // Inject skill block into the text portion of the content.
+  if (typeof rawContent === "string") {
+    cloned[lastUserIdx] = { ...cloned[lastUserIdx], content: `${block}\n\n---\n\n${prompt}` };
+  } else if (Array.isArray(rawContent)) {
+    const newParts = rawContent.map((p) =>
+      p.type === "text" ? { ...p, text: `${block}\n\n---\n\n${p.text}` } : p,
+    );
+    cloned[lastUserIdx] = { ...cloned[lastUserIdx], content: newParts };
+  }
   return cloned;
 }

package/src/box-input.js

@@ -1,132 +1,209 @@
-// Bordered single-line text input — raw-mode, cmd.exe-safe.
-//
-// Like the ask_user menu, this is NOT Ink (which ghosts in the legacy Windows
-// console). It draws a 3-line box + hint, and on every keystroke moves the
-// cursor back up (ESC[nA), clears (ESC[J), and reprints. The caret is a FAKE
-// cursor (inverse-video cell) and the real terminal cursor is hidden, so there
-// is no cursor-column math to get wrong. Long input scrolls horizontally under
-// a fixed right border.
-//
-// Returns the typed string, or EXIT_SIGNAL on Ctrl+C / Ctrl+D.
-
-import readline from "node:readline";
-import { c } from "./render.js";
-
-export const EXIT_SIGNAL = "<<aether-exit>>";
-
-const HIDE = "\x1b[?25l";
-const SHOW = "\x1b[?25h";
-const INV = (s) => `\x1b[7m${s}\x1b[27m`;
-
-export function promptBox({ history = [], placeholder = "type a message…  /help for commands" } = {}) {
-  return new Promise((resolve) => {
-    // Non-interactive (piped / tests): plain readline, no box.
-    if (!process.stdin.isTTY) {
-      const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-      rl.question(c.magenta("› "), (a) => { rl.close(); resolve(a); });
-      return;
-    }
-
-    let buf = "";
-    let pos = 0;                 // caret index within buf
-    const hist = history.slice();
-    let histIdx = hist.length;   // points one past the end (current draft)
-    let draft = "";
-    let drawn = 0;
-    let lastSigint = 0;
-
-    const innerW = () => Math.max(24, Math.min(process.stdout.columns || 80, 100) - 6);
-
-    const draw = (first) => {
-      const W = innerW();
-      if (!first) process.stdout.write(`\x1b[${drawn}A`);
-      process.stdout.write("\x1b[J");
-
-      // Horizontal scroll: keep the caret within the visible window.
-      const maxVisible = W - 1;
-      const start = pos > maxVisible ? pos - maxVisible : 0;
-      const view = buf.slice(start, start + W);
-      const rel = pos - start;
-
-      let content;
-      if (buf.length === 0) {
-        const ph = placeholder.slice(0, W - 1);
-        content = INV(" ") + c.dim(ph) + " ".repeat(Math.max(0, W - 1 - ph.length));
-      } else {
-        let s = "";
-        for (let i = 0; i < W; i++) {
-          const ch = view[i] ?? " ";
-          s += i === rel ? INV(ch) : ch;
-        }
-        content = s;
-      }
-
-      const top = c.magenta("╭" + "─".repeat(W + 4) + "╮");
-      const mid = c.magenta("│") + " " + c.magenta("›") + " " + content + " " + c.magenta("│");
-      const bot = c.magenta("╰" + "─".repeat(W + 4) + "╯");
-      const hint = c.dim("  Enter send · ↑↓ history · /help · /exit");
-
-      process.stdout.write(top + "\n" + mid + "\n" + bot + "\n" + hint + "\n");
-      drawn = 4;
-    };
-
-    const finish = (result) => {
-      process.stdin.removeListener("keypress", onKey);
-      if (process.stdin.isTTY) process.stdin.setRawMode(false);
-      process.stdin.pause();
-      process.stdout.write(`\x1b[${drawn}A\x1b[J` + SHOW);
-      // Echo the submitted line so it persists in scrollback.
-      if (result && result !== EXIT_SIGNAL && result.trim()) {
-        process.stdout.write(c.magenta("› ") + result + "\n");
-      }
-      resolve(result);
-    };
-
-    const onKey = (str, key) => {
-      if (!key) return;
-      const k = key.name;
-
-      if (k === "return" || k === "enter") return finish(buf);
-      if (key.ctrl && k === "c") {
-        const now = Date.now();
-        if (now - lastSigint < 1500 || buf.length === 0) return finish(EXIT_SIGNAL);
-        lastSigint = now;
-        buf = ""; pos = 0; draw(false);
-        return;
-      }
-      if (key.ctrl && k === "d") return finish(buf.length === 0 ? EXIT_SIGNAL : buf);
-
-      if (k === "backspace") { if (pos > 0) { buf = buf.slice(0, pos - 1) + buf.slice(pos); pos--; } }
-      else if (k === "delete") { buf = buf.slice(0, pos) + buf.slice(pos + 1); }
-      else if (k === "left") { if (pos > 0) pos--; }
-      else if (k === "right") { if (pos < buf.length) pos++; }
-      else if (k === "home" || (key.ctrl && k === "a")) pos = 0;
-      else if (k === "end" || (key.ctrl && k === "e")) pos = buf.length;
-      else if (key.ctrl && k === "u") { buf = ""; pos = 0; }
-      else if (k === "up") {
-        if (histIdx === hist.length) draft = buf;
-        if (histIdx > 0) { histIdx--; buf = hist[histIdx] ?? ""; pos = buf.length; }
-      }
-      else if (k === "down") {
-        if (histIdx < hist.length) {
-          histIdx++;
-          buf = histIdx === hist.length ? draft : (hist[histIdx] ?? "");
-          pos = buf.length;
-        }
-      }
-      else if (str && !key.ctrl && !key.meta && str >= " " && str !== "\x7f") {
-        buf = buf.slice(0, pos) + str + buf.slice(pos);
-        pos += str.length;
-      }
-      else return; // ignore unhandled keys without a redraw
-      draw(false);
-    };
-
-    process.stdout.write(HIDE);
-    readline.emitKeypressEvents(process.stdin);
-    if (process.stdin.isTTY) process.stdin.setRawMode(true);
-    process.stdin.resume();
-    process.stdin.on("keypress", onKey);
-    draw(true);
-  });
-}
+// Bordered single-line text input — raw-mode, cmd.exe-safe.
+//
+// Features:
+//   - Ctrl+V / Alt+V: paste image from clipboard (saves to temp, attaches)
+//   - @file.png: reference images by path (parsed by agent.js)
+//   - Arrow keys, Home/End, Ctrl+A/E, Ctrl+U, history navigation
+//   - Horizontal scroll for long input
+//
+// Returns the typed string (with @temppath appended for clipboard images),
+// or EXIT_SIGNAL on Ctrl+C / Ctrl+D.
+
+import readline from "node:readline";
+import { execFileSync } from "node:child_process";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { c } from "./render.js";
+
+export const EXIT_SIGNAL = "<<aether-exit>>";
+
+const HIDE = "\x1b[?25l";
+const SHOW = "\x1b[?25h";
+const INV = (s) => `\x1b[7m${s}\x1b[27m`;
+
+// Save clipboard image to a temp file. Returns the file path or null.
+// Platform-specific: PowerShell on Windows, pngpaste on macOS, xclip on Linux.
+function grabClipboardImage() {
+  const tmpFile = path.join(os.tmpdir(), `aether-paste-${Date.now()}.png`);
+
+  try {
+    if (process.platform === "win32") {
+      const script =
+        "Add-Type -AssemblyName System.Windows.Forms;" +
+        "$img=[System.Windows.Forms.Clipboard]::GetImage();" +
+        "if($img){$img.Save('" + tmpFile.replace(/'/g, "''") + "'," +
+        "[System.Drawing.Imaging.ImageFormat]::Png);'OK'}else{'NO_IMAGE'}";
+      const out = execFileSync("powershell.exe", [
+        "-NoProfile", "-NonInteractive", "-Command", script,
+      ], { timeout: 5000, encoding: "utf8", stdio: ["pipe", "pipe", "pipe"] }).trim();
+      if (out.endsWith("OK") && fs.existsSync(tmpFile)) return tmpFile;
+    } else if (process.platform === "darwin") {
+      try {
+        execFileSync("pngpaste", [tmpFile], { timeout: 3000, stdio: "pipe" });
+        if (fs.existsSync(tmpFile) && fs.statSync(tmpFile).size > 0) return tmpFile;
+      } catch { /* pngpaste not installed — hint below */ }
+    } else {
+      // Linux: xclip
+      try {
+        const fd = fs.openSync(tmpFile, "w");
+        try {
+          execFileSync("xclip", ["-selection", "clipboard", "-t", "image/png", "-o"], {
+            timeout: 3000, stdio: ["pipe", fd, "pipe"],
+          });
+        } finally {
+          fs.closeSync(fd);
+        }
+        if (fs.existsSync(tmpFile) && fs.statSync(tmpFile).size > 0) return tmpFile;
+      } catch { /* xclip not installed */ }
+    }
+  } catch { /* any failure — fall through */ }
+
+  // Clean up empty/failed temp file
+  try { if (fs.existsSync(tmpFile)) fs.unlinkSync(tmpFile); } catch { /* ignore */ }
+  return null;
+}
+
+export function promptBox({ history = [], placeholder = "Message Aether…" } = {}) {
+  return new Promise((resolve) => {
+    // Non-interactive (piped / tests): plain readline, no box.
+    if (!process.stdin.isTTY) {
+      const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+      rl.question(c.cyan("> "), (a) => { rl.close(); resolve(a); });
+      return;
+    }
+
+    let buf = "";
+    let pos = 0;
+    const hist = history.slice();
+    let histIdx = hist.length;
+    let draft = "";
+    let drawn = 0;
+    let lastSigint = 0;
+    const clipImages = []; // temp file paths from clipboard pastes
+
+    const innerW = () => Math.max(24, Math.min(process.stdout.columns || 80, 100) - 6);
+
+    const draw = (first) => {
+      const W = innerW();
+      if (!first) process.stdout.write(`\x1b[${drawn}A`);
+      process.stdout.write("\x1b[J");
+
+      // Horizontal scroll: keep the caret within the visible window.
+      const maxVisible = W - 1;
+      const start = pos > maxVisible ? pos - maxVisible : 0;
+      const view = buf.slice(start, start + W);
+      const rel = pos - start;
+
+      let content;
+      if (buf.length === 0) {
+        const ph = placeholder.slice(0, W - 1);
+        content = INV(" ") + c.dim(ph) + " ".repeat(Math.max(0, W - 1 - ph.length));
+      } else {
+        let s = "";
+        for (let i = 0; i < W; i++) {
+          const ch = view[i] ?? " ";
+          s += i === rel ? INV(ch) : ch;
+        }
+        content = s;
+      }
+
+      const top = c.cyan("╭" + "─".repeat(W + 4) + "╮");
+      const mid = c.cyan("│") + " " + c.cyan(">") + " " + content + " " + c.cyan("│");
+      const bot = c.cyan("╰" + "─".repeat(W + 4) + "╯");
+
+      // Hint line — show paste indicator when images are queued
+      const imgTag = clipImages.length > 0
+        ? "  " + c.cyan(`[${clipImages.length} image${clipImages.length > 1 ? "s" : ""} pasted]`)
+        : "";
+      const hint = c.dim("  Enter send · Alt+V paste image · @file · /help") + imgTag;
+
+      process.stdout.write(top + "\n" + mid + "\n" + bot + "\n" + hint + "\n");
+      drawn = 4;
+    };
+
+    const finish = (result) => {
+      process.stdin.removeListener("keypress", onKey);
+      if (process.stdin.isTTY) process.stdin.setRawMode(false);
+      process.stdin.pause();
+      process.stdout.write(`\x1b[${drawn}A\x1b[J` + SHOW);
+
+      // Append clipboard image temp paths so agent.js's @-parser picks them up.
+      let finalResult = result;
+      if (result !== null && result !== EXIT_SIGNAL && clipImages.length > 0) {
+        const userText = (result || "").trim();
+        const imgRefs = clipImages.map((p) => `@"${p}"`).join(" ");
+        finalResult = userText ? `${userText} ${imgRefs}` : `What is in this image? ${imgRefs}`;
+      }
+
+      // Echo the submitted line so it persists in scrollback.
+      if (finalResult && finalResult !== EXIT_SIGNAL) {
+        const echoText = (result || "").trim();
+        const suffix = clipImages.length > 0
+          ? c.cyan(` [+${clipImages.length} image${clipImages.length > 1 ? "s" : ""}]`)
+          : "";
+        if (echoText || clipImages.length > 0) {
+          process.stdout.write(c.cyan("> ") + (echoText || c.dim("(image)")) + suffix + "\n");
+        }
+      }
+      resolve(finalResult);
+    };
+
+    const onKey = (str, key) => {
+      if (!key) return;
+      const k = key.name;
+
+      if (k === "return" || k === "enter") return finish(buf);
+      if (key.ctrl && k === "c") {
+        const now = Date.now();
+        if (now - lastSigint < 1500 || (buf.length === 0 && clipImages.length === 0)) return finish(EXIT_SIGNAL);
+        lastSigint = now;
+        buf = ""; pos = 0; clipImages.length = 0; draw(false);
+        return;
+      }
+      if (key.ctrl && k === "d") return finish(buf.length === 0 ? EXIT_SIGNAL : buf);
+
+      // Alt+V or Ctrl+V: paste image from clipboard
+      if ((key.meta && k === "v") || (key.ctrl && k === "v")) {
+        const imgPath = grabClipboardImage();
+        if (imgPath) {
+          clipImages.push(imgPath);
+        }
+        draw(false);
+        return;
+      }
+
+      if (k === "backspace") { if (pos > 0) { buf = buf.slice(0, pos - 1) + buf.slice(pos); pos--; } }
+      else if (k === "delete") { buf = buf.slice(0, pos) + buf.slice(pos + 1); }
+      else if (k === "left") { if (pos > 0) pos--; }
+      else if (k === "right") { if (pos < buf.length) pos++; }
+      else if (k === "home" || (key.ctrl && k === "a")) pos = 0;
+      else if (k === "end" || (key.ctrl && k === "e")) pos = buf.length;
+      else if (key.ctrl && k === "u") { buf = ""; pos = 0; }
+      else if (k === "up") {
+        if (histIdx === hist.length) draft = buf;
+        if (histIdx > 0) { histIdx--; buf = hist[histIdx] ?? ""; pos = buf.length; }
+      }
+      else if (k === "down") {
+        if (histIdx < hist.length) {
+          histIdx++;
+          buf = histIdx === hist.length ? draft : (hist[histIdx] ?? "");
+          pos = buf.length;
+        }
+      }
+      else if (str && !key.ctrl && !key.meta && str >= " " && str !== "\x7f") {
+        buf = buf.slice(0, pos) + str + buf.slice(pos);
+        pos += str.length;
+      }
+      else return; // ignore unhandled keys without a redraw
+      draw(false);
+    };
+
+    process.stdout.write(HIDE);
+    readline.emitKeypressEvents(process.stdin);
+    if (process.stdin.isTTY) process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdin.on("keypress", onKey);
+    draw(true);
+  });
+}