aether-code 0.42.0 → 0.43.1

package/src/box-input.js

@@ -1,15 +1,20 @@
-// Bordered single-line text input — raw-mode, cmd.exe-safe.
+// Minimal prompt input — raw-mode, cmd.exe-safe.
+// Bare "> " prompt with bottom status bar, matching Claude Code's layout.
 //
-// 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.
+// Features:
+//   - Ctrl+V / Alt+V: paste image from clipboard
+//   - @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, or EXIT_SIGNAL on Ctrl+C / Ctrl+D.
+// 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>>";
@@ -18,68 +23,146 @@ 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" } = {}) {
+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 */ }
+    } else {
+      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 */ }
+
+  try { if (fs.existsSync(tmpFile)) fs.unlinkSync(tmpFile); } catch { /* ignore */ }
+  return null;
+}
+
+export function promptBox({ history = [], placeholder = "", mode = "review", suppressEcho = false, onResize = null } = {}) {
   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); });
+      rl.question(c.cyan("> "), (a) => { rl.close(); resolve(a); });
       return;
     }
 
     let buf = "";
-    let pos = 0;                 // caret index within buf
+    let pos = 0;
     const hist = history.slice();
-    let histIdx = hist.length;   // points one past the end (current draft)
+    let histIdx = hist.length;
     let draft = "";
     let drawn = 0;
     let lastSigint = 0;
+    const clipImages = [];
+    let resizeHandler = null;
+    let resizeTimer = null;
 
-    const innerW = () => Math.max(24, Math.min(process.stdout.columns || 80, 100) - 6);
+    const termW = () => Math.max(30, (process.stdout.columns || 80) - 2);
+
+    const stripAnsi = (s) => s.replace(/\x1b\[[0-9;]*m/g, "");
+    const rowsFor = (line, cols) => Math.max(1, Math.ceil((stripAnsi(line).length || 1) / cols));
 
     const draw = (first) => {
-      const W = innerW();
+      const W = termW();
+      const termCols = process.stdout.columns || 80;
       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 prefixStr = "> ";
+      const prefixLen = 2;
+      const imgSuffix = clipImages.length > 0 ? ` [+${clipImages.length} img]` : "";
+      const maxVisible = Math.max(8, W - prefixLen - imgSuffix.length);
       const start = pos > maxVisible ? pos - maxVisible : 0;
-      const view = buf.slice(start, start + W);
+      const view = buf.slice(start, start + maxVisible);
       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));
+      if (buf.length === 0 && clipImages.length === 0) {
+        content = INV(" ") + c.dim(placeholder.slice(0, maxVisible - 1));
+      } else if (buf.length === 0 && clipImages.length > 0) {
+        const tag = `[${clipImages.length} image${clipImages.length > 1 ? "s" : ""} pasted]`;
+        content = INV(" ") + c.cyan(tag);
       } else {
         let s = "";
-        for (let i = 0; i < W; i++) {
+        for (let i = 0; i < maxVisible; i++) {
           const ch = view[i] ?? " ";
           s += i === rel ? INV(ch) : ch;
         }
+        if (imgSuffix) s += c.cyan(imgSuffix);
         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 promptLine = c.dim(prefixStr) + content;
+
+      const blk = (code) => `\x1b[${code}m \x1b[0m`;
+      const barPrefix = blk("48;2;209;107;52") + blk("48;2;0;178;169");
+      const imgNote = clipImages.length > 0 ? c.cyan(" images queued") + c.dim(" \xB7 ") : "";
+      const modeLabel = mode === "auto-yes" ? "auto-accept" : "confirm writes";
+      const baseStatus = " " + modeLabel + " \xB7 /help for shortcuts \xB7 @file to include";
+      const barPrefixLen = 2;
+      const imgNoteLen = clipImages.length > 0 ? 17 : 0;
+      const maxStatusLen = Math.max(10, termCols - barPrefixLen - imgNoteLen - 1);
+      const truncStatus = baseStatus.length > maxStatusLen ? baseStatus.slice(0, maxStatusLen) : baseStatus;
+      const statusText = c.dim(truncStatus) + imgNote;
+
+      const rule = c.cyan("─".repeat(Math.max(0, termCols)));
+      const lines = [rule, promptLine, rule, barPrefix + statusText];
+      drawn = lines.reduce((sum, l) => sum + rowsFor(l, termCols), 0);
+      process.stdout.write(lines.join("\n") + "\n");
     };
 
     const finish = (result) => {
+      if (resizeTimer) { clearTimeout(resizeTimer); resizeTimer = null; }
+      if (resizeHandler) process.stdout.removeListener("resize", resizeHandler);
       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");
+
+      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}`;
       }
-      resolve(result);
+
+      if (!suppressEcho && finalResult && finalResult !== EXIT_SIGNAL) {
+        const echoText = (result || "").trim();
+        const imgTag = clipImages.length > 0
+          ? ` [+${clipImages.length} image${clipImages.length > 1 ? "s" : ""}]`
+          : "";
+        if (echoText || clipImages.length > 0) {
+          const displayText = echoText || "(image)";
+          const cols = process.stdout.columns || 80;
+          const textLen = displayText.length + imgTag.length + 2;
+          const pad = Math.max(0, cols - textLen);
+          process.stdout.write(`\x1b[48;5;236m  ${displayText}${imgTag}${" ".repeat(pad)}\x1b[0m\n`);
+        }
+      }
+      resolve(finalResult);
     };
 
     const onKey = (str, key) => {
@@ -89,13 +172,22 @@ export function promptBox({ history = [], placeholder = "type a message…  /hel
       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);
+        if (now - lastSigint < 1500 || (buf.length === 0 && clipImages.length === 0)) return finish(EXIT_SIGNAL);
         lastSigint = now;
-        buf = ""; pos = 0; draw(false);
+        buf = ""; pos = 0; clipImages.length = 0; draw(false);
         return;
       }
       if (key.ctrl && k === "d") return finish(buf.length === 0 ? EXIT_SIGNAL : buf);
 
+      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--; }
@@ -118,7 +210,7 @@ export function promptBox({ history = [], placeholder = "type a message…  /hel
         buf = buf.slice(0, pos) + str + buf.slice(pos);
         pos += str.length;
       }
-      else return; // ignore unhandled keys without a redraw
+      else return;
       draw(false);
     };
 
@@ -128,5 +220,18 @@ export function promptBox({ history = [], placeholder = "type a message…  /hel
     process.stdin.resume();
     process.stdin.on("keypress", onKey);
     draw(true);
+    resizeHandler = () => {
+      if (resizeTimer) clearTimeout(resizeTimer);
+      resizeTimer = setTimeout(() => {
+        resizeTimer = null;
+        if (onResize) {
+          onResize();
+        } else {
+          process.stdout.write(`\x1b[${drawn}A\x1b[J`);
+        }
+        draw(true);
+      }, 120);
+    };
+    process.stdout.on("resize", resizeHandler);
   });
 }

package/src/config.js

@@ -1,38 +1,38 @@
-// Config — reads ~/.aetherrc (shared format with aether-cli) and env vars.
-// Same precedence: env wins over file.
-
-import fs from "node:fs";
-import path from "node:path";
-import os from "node:os";
-
-const FILE = path.join(os.homedir(), ".aetherrc");
-const DEFAULT_BASE = "https://trynoguard.com";
-
-export function readConfigFile() {
-  try {
-    const raw = fs.readFileSync(FILE, "utf8");
-    return JSON.parse(raw);
-  } catch {
-    return {};
-  }
-}
-
-export function writeConfigFile(patch) {
-  const current = readConfigFile();
-  const next = { ...current, ...patch };
-  // 0600 — readable only by the user. Mirrors what ssh, gnupg, etc. enforce
-  // on credential files. Treat the API key like an SSH key.
-  fs.writeFileSync(FILE, JSON.stringify(next, null, 2), { mode: 0o600 });
-  try { fs.chmodSync(FILE, 0o600); } catch { /* windows ignores */ }
-}
-
-export function getConfig() {
-  const file = readConfigFile();
-  return {
-    apiKey: process.env.AETHER_API_KEY || file.apiKey || "",
-    baseUrl: (process.env.AETHER_BASE_URL || file.baseUrl || DEFAULT_BASE).replace(/\/+$/, ""),
-    configPath: FILE,
-  };
-}
-
-export const CONFIG_PATH = FILE;
+// Config — reads ~/.aetherrc (shared format with aether-cli) and env vars.
+// Same precedence: env wins over file.
+
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+
+const FILE = path.join(os.homedir(), ".aetherrc");
+const DEFAULT_BASE = "https://trynoguard.com";
+
+export function readConfigFile() {
+  try {
+    const raw = fs.readFileSync(FILE, "utf8");
+    return JSON.parse(raw);
+  } catch {
+    return {};
+  }
+}
+
+export function writeConfigFile(patch) {
+  const current = readConfigFile();
+  const next = { ...current, ...patch };
+  // 0600 — readable only by the user. Mirrors what ssh, gnupg, etc. enforce
+  // on credential files. Treat the API key like an SSH key.
+  fs.writeFileSync(FILE, JSON.stringify(next, null, 2), { mode: 0o600 });
+  try { fs.chmodSync(FILE, 0o600); } catch { /* windows ignores */ }
+}
+
+export function getConfig() {
+  const file = readConfigFile();
+  return {
+    apiKey: process.env.AETHER_API_KEY || file.apiKey || "",
+    baseUrl: (process.env.AETHER_BASE_URL || file.baseUrl || DEFAULT_BASE).replace(/\/+$/, ""),
+    configPath: FILE,
+  };
+}
+
+export const CONFIG_PATH = FILE;

package/src/diff.js

@@ -1,49 +1,49 @@
-// Tiny line-by-line diff for write_file confirmation prompts.
-// Not a "real" diff — just a side-by-side highlight of what's changing.
-// Good enough for confirmation prompts, deliberately not pretending to be `git diff`.
-
-import { c } from "./render.js";
-
-export function unifiedDiff(oldText, newText, filename) {
-  const oldLines = (oldText || "").split("\n");
-  const newLines = (newText || "").split("\n");
-  const max = Math.max(oldLines.length, newLines.length);
-
-  // Find common prefix and suffix to keep the diff focused
-  let prefix = 0;
-  while (prefix < max && oldLines[prefix] === newLines[prefix]) prefix++;
-  let suffix = 0;
-  while (
-    suffix < max - prefix &&
-    oldLines[oldLines.length - 1 - suffix] === newLines[newLines.length - 1 - suffix]
-  ) {
-    suffix++;
-  }
-
-  const changedOld = oldLines.slice(prefix, oldLines.length - suffix);
-  const changedNew = newLines.slice(prefix, newLines.length - suffix);
-
-  const lines = [];
-  // No "@@ file @@" header — the "● write <file>" label already names the file.
-  if (prefix > 0) lines.push(c.gray(`  …${prefix} unchanged line${prefix === 1 ? "" : "s"} above…`));
-  for (const l of changedOld) lines.push(c.red(`- ${l}`));
-  for (const l of changedNew) lines.push(c.green(`+ ${l}`));
-  if (suffix > 0) lines.push(c.gray(`  …${suffix} unchanged line${suffix === 1 ? "" : "s"} below…`));
-
-  // Cap output so writes don't flood the terminal — a short preview is enough
-  // (skip-permissions auto-applies; the full file is on disk to inspect).
-  const MAX = 14;
-  if (lines.length > MAX) {
-    const shown = lines.slice(0, MAX - 1);
-    return [...shown, c.gray(`  …${lines.length - shown.length} more lines (see the file)…`)].join("\n");
-  }
-  return lines.join("\n");
-}
-
-export function summarizeWrite(oldText, newText, filename) {
-  const oldLines = (oldText || "").split("\n").length;
-  const newLines = (newText || "").split("\n").length;
-  const isCreate = oldText === null || oldText === undefined;
-  const verb = isCreate ? "create" : "rewrite";
-  return c.dim(`${verb} ${filename} (${oldLines} → ${newLines} lines, ${(newText || "").length} bytes)`);
-}
+// Tiny line-by-line diff for write_file confirmation prompts.
+// Not a "real" diff — just a side-by-side highlight of what's changing.
+// Good enough for confirmation prompts, deliberately not pretending to be `git diff`.
+
+import { c } from "./render.js";
+
+export function unifiedDiff(oldText, newText, filename) {
+  const oldLines = (oldText || "").split("\n");
+  const newLines = (newText || "").split("\n");
+  const max = Math.max(oldLines.length, newLines.length);
+
+  // Find common prefix and suffix to keep the diff focused
+  let prefix = 0;
+  while (prefix < max && oldLines[prefix] === newLines[prefix]) prefix++;
+  let suffix = 0;
+  while (
+    suffix < max - prefix &&
+    oldLines[oldLines.length - 1 - suffix] === newLines[newLines.length - 1 - suffix]
+  ) {
+    suffix++;
+  }
+
+  const changedOld = oldLines.slice(prefix, oldLines.length - suffix);
+  const changedNew = newLines.slice(prefix, newLines.length - suffix);
+
+  const lines = [];
+  // No "@@ file @@" header — the "● write <file>" label already names the file.
+  if (prefix > 0) lines.push(c.gray(`  …${prefix} unchanged line${prefix === 1 ? "" : "s"} above…`));
+  for (const l of changedOld) lines.push(c.red(`- ${l}`));
+  for (const l of changedNew) lines.push(c.green(`+ ${l}`));
+  if (suffix > 0) lines.push(c.gray(`  …${suffix} unchanged line${suffix === 1 ? "" : "s"} below…`));
+
+  // Cap output so writes don't flood the terminal — a short preview is enough
+  // (skip-permissions auto-applies; the full file is on disk to inspect).
+  const MAX = 14;
+  if (lines.length > MAX) {
+    const shown = lines.slice(0, MAX - 1);
+    return [...shown, c.gray(`  …${lines.length - shown.length} more lines (see the file)…`)].join("\n");
+  }
+  return lines.join("\n");
+}
+
+export function summarizeWrite(oldText, newText, filename) {
+  const oldLines = (oldText || "").split("\n").length;
+  const newLines = (newText || "").split("\n").length;
+  const isCreate = oldText === null || oldText === undefined;
+  const verb = isCreate ? "create" : "rewrite";
+  return c.dim(`${verb} ${filename} (${oldLines} → ${newLines} lines, ${(newText || "").length} bytes)`);
+}

package/src/ink-input.js

@@ -1,91 +1,91 @@
-// Ink-based boxed input for the REPL — the bordered live input box (Claude
-// Code-style). Rendered fresh for each prompt, then unmounted so the agent's
-// plain console.log streaming during a turn never fights Ink for the terminal.
-//
-// Uses a `single`-line border (broadly supported in cmd.exe Consolas) rather
-// than rounded corners, which render as tofu on some Windows fonts.
-//
-// No JSX / no build step: components are built with React.createElement so the
-// package ships as-is. `InputApp` is exported (pure UI + callbacks) so it can be
-// unit-tested with ink-testing-library without a real TTY.
-
-import React, { useState, useRef } from "react";
-import { render, Box, Text, useApp, useInput } from "ink";
-import TextInput from "ink-text-input";
-
-const h = React.createElement;
-
-// Sentinel promptBoxed() resolves with on a double Ctrl+C, so the caller can
-// distinguish "user wants to quit" from an empty submitted line. Plain ASCII so
-// it can never be confused with a real keystroke or hide invisible chars.
-export const EXIT_SIGNAL = "<<aether-exit>>";
-
-/**
- * Pure input UI. Calls onSubmit(value) on Enter and onExit() on a double Ctrl+C.
- * Up/Down arrows walk `history` (newest last). No process/terminal side effects
- * of its own, so it's testable in isolation with ink-testing-library.
- */
-export function InputApp({ onSubmit, onExit, statusLeft = "", statusRight = "", history = [] }) {
-  const [value, setValue] = useState("");
-  const lastCtrlC = useRef(0);
-  const histIdx = useRef(history.length);
-
-  useInput((input, key) => {
-    if (key.ctrl && input === "c") {
-      const now = Date.now();
-      if (now - lastCtrlC.current < 1500) onExit();
-      else { lastCtrlC.current = now; setValue(""); }
-      return;
-    }
-    if (key.upArrow) {
-      if (histIdx.current > 0) { histIdx.current -= 1; setValue(history[histIdx.current] ?? ""); }
-    } else if (key.downArrow) {
-      if (histIdx.current < history.length - 1) { histIdx.current += 1; setValue(history[histIdx.current] ?? ""); }
-      else { histIdx.current = history.length; setValue(""); }
-    }
-  });
-
-  return h(
-    Box,
-    { flexDirection: "column", width: "100%" },
-    h(
-      Box,
-      { borderStyle: "single", borderColor: "magenta", paddingX: 1 },
-      h(Text, { color: "magenta", bold: true }, "> "),
-      h(TextInput, { value, onChange: setValue, onSubmit, placeholder: "" }),
-    ),
-    h(
-      Box,
-      { paddingX: 1, width: "100%", justifyContent: "space-between" },
-      h(Text, { dimColor: true }, statusLeft),
-      h(Text, { dimColor: true }, statusRight),
-    ),
-  );
-}
-
-/**
- * Render a one-shot boxed input and resolve with the submitted line. Resolves
- * EXIT_SIGNAL on a double Ctrl+C; resolves "" if the app exits without a submit.
- */
-export function promptBoxed(opts = {}) {
-  return new Promise((resolve) => {
-    let done = false;
-    let appApi = null;
-    const fin = (val) => {
-      if (done) return;
-      done = true;
-      try { if (appApi) appApi.exit(); } catch { /* already exiting */ }
-      resolve(val);
-    };
-    const Wrapper = () => {
-      appApi = useApp();
-      return h(InputApp, {
-        ...opts,
-        onSubmit: (v) => fin(v),
-        onExit: () => fin(EXIT_SIGNAL),
-      });
-    };
-    const instance = render(h(Wrapper), { exitOnCtrlC: false });
-    instance.waitUntilExit().then(() => { if (!done) { done = true; resolve(""); } });
-  });
-}
+// Ink-based boxed input for the REPL — the bordered live input box (Claude
+// Code-style). Rendered fresh for each prompt, then unmounted so the agent's
+// plain console.log streaming during a turn never fights Ink for the terminal.
+//
+// Uses a `single`-line border (broadly supported in cmd.exe Consolas) rather
+// than rounded corners, which render as tofu on some Windows fonts.
+//
+// No JSX / no build step: components are built with React.createElement so the
+// package ships as-is. `InputApp` is exported (pure UI + callbacks) so it can be
+// unit-tested with ink-testing-library without a real TTY.
+
+import React, { useState, useRef } from "react";
+import { render, Box, Text, useApp, useInput } from "ink";
+import TextInput from "ink-text-input";
+
+const h = React.createElement;
+
+// Sentinel promptBoxed() resolves with on a double Ctrl+C, so the caller can
+// distinguish "user wants to quit" from an empty submitted line. Plain ASCII so
+// it can never be confused with a real keystroke or hide invisible chars.
+export const EXIT_SIGNAL = "<<aether-exit>>";
+
+/**
+ * Pure input UI. Calls onSubmit(value) on Enter and onExit() on a double Ctrl+C.
+ * Up/Down arrows walk `history` (newest last). No process/terminal side effects
+ * of its own, so it's testable in isolation with ink-testing-library.
+ */
+export function InputApp({ onSubmit, onExit, statusLeft = "", statusRight = "", history = [] }) {
+  const [value, setValue] = useState("");
+  const lastCtrlC = useRef(0);
+  const histIdx = useRef(history.length);
+
+  useInput((input, key) => {
+    if (key.ctrl && input === "c") {
+      const now = Date.now();
+      if (now - lastCtrlC.current < 1500) onExit();
+      else { lastCtrlC.current = now; setValue(""); }
+      return;
+    }
+    if (key.upArrow) {
+      if (histIdx.current > 0) { histIdx.current -= 1; setValue(history[histIdx.current] ?? ""); }
+    } else if (key.downArrow) {
+      if (histIdx.current < history.length - 1) { histIdx.current += 1; setValue(history[histIdx.current] ?? ""); }
+      else { histIdx.current = history.length; setValue(""); }
+    }
+  });
+
+  return h(
+    Box,
+    { flexDirection: "column", width: "100%" },
+    h(
+      Box,
+      { borderStyle: "single", borderColor: "magenta", paddingX: 1 },
+      h(Text, { color: "magenta", bold: true }, "> "),
+      h(TextInput, { value, onChange: setValue, onSubmit, placeholder: "" }),
+    ),
+    h(
+      Box,
+      { paddingX: 1, width: "100%", justifyContent: "space-between" },
+      h(Text, { dimColor: true }, statusLeft),
+      h(Text, { dimColor: true }, statusRight),
+    ),
+  );
+}
+
+/**
+ * Render a one-shot boxed input and resolve with the submitted line. Resolves
+ * EXIT_SIGNAL on a double Ctrl+C; resolves "" if the app exits without a submit.
+ */
+export function promptBoxed(opts = {}) {
+  return new Promise((resolve) => {
+    let done = false;
+    let appApi = null;
+    const fin = (val) => {
+      if (done) return;
+      done = true;
+      try { if (appApi) appApi.exit(); } catch { /* already exiting */ }
+      resolve(val);
+    };
+    const Wrapper = () => {
+      appApi = useApp();
+      return h(InputApp, {
+        ...opts,
+        onSubmit: (v) => fin(v),
+        onExit: () => fin(EXIT_SIGNAL),
+      });
+    };
+    const instance = render(h(Wrapper), { exitOnCtrlC: false });
+    instance.waitUntilExit().then(() => { if (!done) { done = true; resolve(""); } });
+  });
+}