@oxecli/oxe 1.0.15 → 1.0.17

package/dist/cli.js

@@ -3,7 +3,7 @@ import { fileURLToPath } from "node:url";
 import { loadOrPrompt, default_reasoning_effort, max_action_chars, max_resume_history_items, } from "./config.js";
 import { InferenceEngine, estimateTokens } from "./engine.js";
 import { saveSession, loadSession, listSessions, nextSessionId, conversationLabel, COMMAND_HELP, toolOutputFailed, } from "./sessions.js";
-import { clearScreen, enableAnsi, askBottomPrompt, userDisplayText, aiMarkdown, mutedMarkdown, messageText, formatToolAction, truncateEllipsis, renderPanel, } from "./ui.js";
+import { clearScreen, enableAnsi, askBottomPrompt, userDisplayText, aiMarkdown, mutedMarkdown, messageText, formatToolAction, truncateEllipsis, renderPanel, renderTableString, enableRawStdin, disableRawStdin, waitRawKey, } from "./ui.js";
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 function truncateLabel(s) {
     const t = String(s || "(conversation)").trim();
@@ -43,19 +43,49 @@ export class CLI {
         const style = status === "failed" ? "\x1b[31m" : "\x1b[32m";
         process.stdout.write(`${style}${truncateEllipsis(String(text), max_action_chars, "text")}\x1b[0m\n`);
     }
-    showHelp() {
-        process.stdout.write("\n");
-        for (const [cmd, desc] of COMMAND_HELP) {
-            // The whole command column is bold; any `<arg>` placeholder (e.g. <n>,
-            // <level>) is additionally cyan — matching the original's
-            // `[bold cyan]<n>[/bold cyan]`. Pad based on the plain text length so the
-            // ANSI codes don't skew the column alignment.
+    async showHelp() {
+        // Mirror Python's `_show_help`: a bordered table panel with the command
+        // column bold (with `<arg>` placeholders cyan) and descriptions dim, inside
+        // a panel titled "Commands · Enter / Ctrl+C closes". In a TTY it stays on
+        // screen until Enter/Ctrl+C/arrows/q closes it.
+        const rows = COMMAND_HELP.map(([cmd, desc]) => {
             const styled = cmd.replace(/(<[^>]+>)/g, "\x1b[36m$1\x1b[0m");
-            const pad = Math.max(18 - cmd.length, 0);
-            process.stdout.write(`\x1b[1m${styled}${" ".repeat(pad)}\x1b[0m\x1b[2m${desc}\x1b[0m\n`);
+            return { cells: [`\x1b[1m${styled}\x1b[0m`, `\x1b[2m${desc}\x1b[0m`] };
+        });
+        const panel = renderTableString(rows, {
+            title: "Commands  ·  Enter / Ctrl+C closes",
+            borderStyle: "90",
+            expand: false,
+            titleAlign: "left",
+            colGap: 2,
+        });
+        process.stdout.write("\n" + panel + "\n");
+        if (process.stdin.isTTY) {
+            // Wait for a close key, then erase the panel (mirrors Python's Live).
+            enableRawStdin();
+            try {
+                for (;;) {
+                    if (await this.awaitRawCloseKey())
+                        break;
+                }
+            }
+            finally {
+                disableRawStdin();
+            }
+            const rowsShown = panel.split("\n").length;
+            process.stdout.write(`\x1b[${rowsShown}A\r\x1b[J`);
         }
         process.stdout.write("\n");
     }
+    async awaitRawCloseKey() {
+        const k = await waitRawKey();
+        const closeNames = ["escape", "return", "enter", "up", "down", "left", "right"];
+        if (k.ctrl && (k.name === "c" || k.name === "z"))
+            return true;
+        if (k.str === "q" || k.str === "Q" || k.str === "\x1b" || closeNames.includes(k.name))
+            return true;
+        return false;
+    }
     renderHistory(items, maxItems = max_resume_history_items) {
         const outputsByCallId = new Map();
         for (const it of items) {
@@ -173,25 +203,110 @@ export class CLI {
         }
         process.stdout.write("\n");
     }
-    pickConversation() {
+    /** Build the interactive picker panel (mirrors Python `_render_picker`). */
+    renderPickerPanel(recs, selected, visible = 8) {
+        const total = recs.length;
+        const half = Math.floor(visible / 2);
+        const lo = Math.min(Math.max(selected - half, 0), Math.max(total - visible, 0));
+        const hi = Math.min(lo + visible, total);
+        const rows = [];
+        for (let idx = lo; idx < hi; idx++) {
+            const rec = recs[idx];
+            const sid = String(rec["id"] ?? "?");
+            const updated = String(rec["updated_at"] ?? "").slice(0, 16).replace("T", " ");
+            const label = truncateLabel(rec["label"]);
+            const items = rec["input_items"] ?? [];
+            const toks = estimateTokens(items).toLocaleString();
+            const content = `\x1b[1m${sid.padStart(4)}\x1b[0m` +
+                `\x1b[2m  ${updated}\x1b[0m  ${label}` +
+                `\x1b[2m  ${items.length} items · ${toks} tok\x1b[0m`;
+            rows.push({
+                cells: [idx === selected ? "\x1b[1m\x1b[36m❯\x1b[0m" : "", content],
+                style: idx === selected ? "\x1b[1m" : undefined,
+            });
+        }
+        const below = total - hi;
+        let footer = "";
+        if (lo > 0 && below > 0)
+            footer = `\x1b[2m▲ ${lo} earlier · ▼ ${below} more\x1b[0m`;
+        else if (lo > 0)
+            footer = `\x1b[2m▲ ${lo} earlier\x1b[0m`;
+        else if (below > 0)
+            footer = `\x1b[2m▼ ${below} more\x1b[0m`;
+        if (footer)
+            rows.push({ cells: ["", footer] });
+        const title = `Conversations  \x1b[1m\x1b[36m${lo + 1}-${hi}/${total}\x1b[0m  (↑/↓ · Quit (q) · Enter)`;
+        return renderTableString(rows, {
+            title,
+            borderStyle: "90",
+            expand: true,
+            titleAlign: "left",
+            colGap: 0,
+            colWidths: [3, undefined],
+        });
+    }
+    /** Interactive arrow up/down project picker (mirrors Python `_pick_conversation`). */
+    async pickConversation() {
         const recs = listSessions();
         if (!recs.length) {
             process.stdout.write("\n");
             renderPanel("No saved conversations yet. Type a prompt to start one.", "Conversations");
             return null;
         }
-        this.showConversationsPlain(recs);
-        return null;
+        if (!process.stdin.isTTY) {
+            this.showConversationsPlain(recs);
+            return null;
+        }
+        enableRawStdin();
+        let selected = 0;
+        let lastRows = 0;
+        const draw = () => {
+            const frame = "\n" + this.renderPickerPanel(recs, selected);
+            const n = frame.split("\n").length;
+            if (lastRows > 0)
+                process.stdout.write(`\x1b[${lastRows - 1}A\r\x1b[J`);
+            process.stdout.write(frame);
+            lastRows = n;
+        };
+        draw();
+        try {
+            for (;;) {
+                const k = await waitRawKey();
+                if (k.name === "up") {
+                    selected = (selected - 1 + recs.length) % recs.length;
+                    draw();
+                }
+                else if (k.name === "down") {
+                    selected = (selected + 1) % recs.length;
+                    draw();
+                }
+                else if (k.name === "return" || k.name === "enter") {
+                    return Number(recs[selected]["id"] ?? null);
+                }
+                else if (k.str === "q" ||
+                    k.str === "Q" ||
+                    k.name === "escape" ||
+                    (k.ctrl && (k.name === "c" || k.name === "z"))) {
+                    return null;
+                }
+            }
+        }
+        finally {
+            process.stdout.write(`\x1b[${lastRows - 1}A\r\x1b[J`);
+            disableRawStdin();
+        }
     }
     async resumeConversation(engine, num) {
         const sid = parseInt(num, 10);
         if (Number.isNaN(sid)) {
-            renderPanel(`Invalid conversation number: ${num}`, "Error");
+            process.stdout.write("\n");
+            renderPanel(`Invalid conversation number: ${num}`, "Error", "", true, "31");
             return;
         }
         const rec = loadSession(sid);
         if (!rec) {
-            renderPanel(`Conversation ${sid} not found.`, "Error");
+            process.stdout.write("\n");
+            renderPanel(`Conversation ${sid} not found.`, "Error", "", true, "31");
             return;
         }
         this.saveSession(engine);
@@ -232,7 +347,7 @@ export class CLI {
                     break;
                 }
                 if (lower === "/help") {
-                    this.showHelp();
+                    await this.showHelp();
                     continue;
                 }
                 if (lower === "/clear") {
@@ -249,7 +364,10 @@ export class CLI {
                 if (lower.startsWith("/resume")) {
                     const parts = input.trim().split(/\s+/);
                     if (parts.length === 1) {
-                        this.pickConversation();
+                        const picked = await this.pickConversation();
+                        if (picked != null && !Number.isNaN(picked)) {
+                            await this.resumeConversation(engine, String(picked));
+                        }
                     }
                     else {
                         await this.resumeConversation(engine, parts[1]);
@@ -264,7 +382,9 @@ export class CLI {
                         process.stdout.write(`\n\x1b[2mReasoning effort set to ${effort}.\x1b[0m\n`);
                     }
                     else {
-                        renderPanel("Usage: /effort none|low|high", "Error");
+                        process.stdout.write("\n");
+                        renderPanel("Usage: /effort none|low|high", "Error", "", true, "31");
+                        process.stdout.write("\n");
                     }
                     continue;
                 }

package/dist/config.js

@@ -145,7 +145,7 @@ export const SYSTEM_PROMPT_BODY = "You are a terminal-based coding agent named O
     "consequence in your response.\n";
 export const API_KEY_MAX = 64;
 import { validateOxeApiKey } from "./api.js";
-import { renderPanel, markupToAnsi } from "./ui.js";
+import { renderPanel, markupToAnsi, hideCursor, showCursor } from "./ui.js";
 export async function loadOrPrompt() {
     let api_key = "";
     let key_data = {};
@@ -164,9 +164,13 @@ export async function loadOrPrompt() {
         }
         process.stdout.write("\n");
         const authSpinner = new Spinner();
+        // promptApiKey echoes input with the cursor visible; hide it while the
+        // validating-key label runs so no stray block cursor sits beside it.
+        hideCursor();
         authSpinner.start("Authenticating key with Oxe Cloud…");
         const validation = await validateOxeApiKey(api_key);
         authSpinner.stop();
+        showCursor();
         if (validation.valid) {
             key_data = validation.key_data || {};
             process.stdout.write(markupToAnsi(`[green]✓ Oxe API Key verified[/green] [dim](${String(key_data["name"] ?? "Desktop")})[/dim]`) + "\n");

package/dist/ui.js

@@ -1,5 +1,44 @@
 import * as readline from "node:readline";
 // ---------------------------------------------------------------------------
+// Raw stdin key reading (for interactive help / resume picker)
+// ---------------------------------------------------------------------------
+let rawKeyListeners = 0;
+/** Enter raw mode and emit keypress events on stdin. */
+export function enableRawStdin() {
+    if (rawKeyListeners === 0) {
+        readline.emitKeypressEvents(process.stdin);
+        if (process.stdin.isTTY)
+            process.stdin.setRawMode(true);
+        process.stdin.resume();
+        hideCursor();
+    }
+    rawKeyListeners++;
+}
+/** Exit raw mode. */
+export function disableRawStdin() {
+    rawKeyListeners = Math.max(0, rawKeyListeners - 1);
+    if (rawKeyListeners === 0) {
+        try {
+            process.stdin.setRawMode(false);
+        }
+        catch {
+            /* ignore */
+        }
+        process.stdin.pause();
+        showCursor();
+    }
+}
+/** Wait for a single raw keypress. */
+export function waitRawKey() {
+    return new Promise((resolve) => {
+        const onKeypress = (str, key) => {
+            process.stdin.removeListener("keypress", onKeypress);
+            resolve({ name: key?.name ?? "", str: str ?? "", ctrl: !!(key?.ctrl) });
+        };
+        process.stdin.on("keypress", onKeypress);
+    });
+}
+// ---------------------------------------------------------------------------
 // Terminal helpers
 // ---------------------------------------------------------------------------
 export function isWindows() {
@@ -142,7 +181,7 @@ export function mutedMarkdown(text) {
  *  - title/subtitle are embedded in the top/bottom borders, centered by
  *    default (rich default) or left-aligned.
  */
-export function renderPanel(content, title = "", subtitle = "", expand = true, borderStyle = "90", // 90 = bright black (grey50)
+function panelString(content, title = "", subtitle = "", expand = true, borderStyle = "90", // 90 = bright black (grey50)
 titleAlign = "center") {
     const styled = markupToAnsi(content);
     const styledLines = styled.split("\n");
@@ -172,17 +211,59 @@ titleAlign = "center") {
         const right = fill - left;
         return `${"─".repeat(left)}${inner}${"─".repeat(right)}`;
     };
+    const out = [];
     const top = `╭${embed(title, titleAlign)}╮`;
-    process.stdout.write(`\x1b[${borderStyle}m${top}\x1b[0m\n`);
+    out.push(`\x1b[${borderStyle}m${top}\x1b[0m`);
     for (let i = 0; i < styledLines.length; i++) {
         const line = styledLines[i];
         const plain = plainLines[i] ?? "";
         // Keep exactly one space padding each side; only pad the right to fill.
         const pad = Math.max(innerW - plain.length - 2, 0);
-        process.stdout.write(`\x1b[${borderStyle}m│\x1b[0m ${line}${" ".repeat(pad)} \x1b[${borderStyle}m│\x1b[0m\n`);
+        out.push(`\x1b[${borderStyle}m│\x1b[0m ${line}${" ".repeat(pad)} \x1b[${borderStyle}m│\x1b[0m`);
     }
     const bottom = `╰${embed(subtitle, "center")}╯`;
-    process.stdout.write(`\x1b[${borderStyle}m${bottom}\x1b[0m\n`);
+    out.push(`\x1b[${borderStyle}m${bottom}\x1b[0m`);
+    return out.join("\n");
+}
+export function renderPanel(content, title = "", subtitle = "", expand = true, borderStyle = "90", // 90 = bright black (grey50)
+titleAlign = "center") {
+    process.stdout.write(panelString(content, title, subtitle, expand, borderStyle, titleAlign) + "\n");
+}
+function plainLen(s) {
+    return s.replace(/\x1b\[[0-9;]*m/g, "").length;
+}
+/**
+ * Render a rich-style bordered table panel (mirrors rich's Table + Panel).
+ *
+ * `rows` is a list of {cells, style?} where `style` (ANSI prefix) is applied to
+ * the whole row. Columns are left-aligned and padded; `colWidths` can fix a
+ * column's width (used for the selection gutter).
+ */
+export function renderTableString(rows, opts = {}) {
+    const ncols = Math.max(0, ...rows.map((r) => r.cells.length));
+    if (ncols === 0)
+        return panelString("", opts.title ?? "", opts.subtitle ?? "", opts.expand, opts.borderStyle, opts.titleAlign);
+    const colGap = opts.colGap ?? 2;
+    const widths = [];
+    for (let c = 0; c < ncols; c++) {
+        let mw = 0;
+        for (const r of rows)
+            if (r.cells[c])
+                mw = Math.max(mw, plainLen(r.cells[c]));
+        widths.push(Math.max(mw, opts.colWidths?.[c] ?? 0));
+    }
+    const contentLines = [];
+    for (const r of rows) {
+        const parts = [];
+        for (let c = 0; c < ncols; c++) {
+            const cell = r.cells[c] ?? "";
+            const pad = c < ncols - 1 ? widths[c] - plainLen(cell) + colGap : 0;
+            parts.push(cell + " ".repeat(Math.max(pad, 0)));
+        }
+        const line = parts.join("");
+        contentLines.push(r.style ? `${r.style}${line}\x1b[0m` : line);
+    }
+    return panelString(contentLines.join("\n"), opts.title ?? "", opts.subtitle ?? "", opts.expand, opts.borderStyle, opts.titleAlign);
 }
 // ---------------------------------------------------------------------------
 // Durations
@@ -456,15 +537,76 @@ export function splitBlocks(buffer, pasteSpans) {
     }
     return segs;
 }
+const PROMPT_CARET = "\u0000"; // sentinel marking the caret position
+/**
+ * Wrap styled runs into physical rows of `width` visible columns, wrapping long
+ * lines so the panel box stays rectangular (mirrors rich's Panel auto-wrap).
+ * Returns the styled rows (no borders) and the caret's (row, col) in content
+ * coordinates, or (-1,-1) if no caret sentinel is present.
+ */
+function wrapRuns(runs, width) {
+    const rows = [];
+    let cur = "";
+    let curLen = 0;
+    let caretRow = -1;
+    let caretCol = -1;
+    const flush = () => {
+        rows.push(cur);
+        cur = "";
+        curLen = 0;
+    };
+    for (const run of runs) {
+        if (run.text === PROMPT_CARET) {
+            // Caret occupies one visible column; if the current row is full, move it
+            // to the start of the next row so it stays inside the box.
+            if (curLen >= width)
+                flush();
+            caretRow = rows.length;
+            caretCol = curLen;
+            cur += run.style + "▏" + "\x1b[0m";
+            curLen += 1;
+            continue;
+        }
+        let text = run.text;
+        while (text) {
+            // Split off the leading run up to the next newline (if any).
+            const nl = text.indexOf("\n");
+            const seg = nl === -1 ? text : text.slice(0, nl);
+            let rest = seg;
+            while (rest.length > 0) {
+                if (curLen >= width)
+                    flush();
+                const take = Math.min(rest.length, width - curLen);
+                const chunk = rest.slice(0, take);
+                cur += run.style ? run.style + chunk + "\x1b[0m" : chunk;
+                curLen += take;
+                rest = rest.slice(take);
+            }
+            if (nl !== -1) {
+                flush();
+                text = text.slice(nl + 1);
+            }
+            else {
+                break;
+            }
+        }
+    }
+    flush();
+    return { rows, caretRow, caretCol };
+}
 export function renderBufferWithCursor(buffer, pasteSpans, prefix, label, cursor) {
     const w = terminalWidth();
     const borderW = Math.max(w - 4, 10);
-    const [row, col] = cursorLineCol(buffer, cursor);
-    // Build the inner content: prefix, then the text with the `▏` block cursor
-    // always drawn at the cursor position (mirrors the original rich frame).
-    let display;
+    // Content width inside the box (between `│ ` and ` │`).
+    const innerW = borderW - 2;
+    // Build styled runs: prefix, then the text with the `▏` block caret always
+    // drawn at the cursor position (mirrors the original rich frame).
+    const runs = [];
+    runs.push({ text: prefix, style: "\x1b[1m" });
+    runs.push({ text: " ", style: "" });
     if (!buffer) {
-        display = `\x1b[1m▏\x1b[0m\x1b[2m${PROMPT_PLACEHOLDER}\x1b[0m`;
+        runs.push({ text: PROMPT_CARET, style: "\x1b[1m" });
+        runs.push({ text: PROMPT_PLACEHOLDER, style: "\x1b[2m" });
     }
     else {
         const segs = splitBlocks(buffer, pasteSpans);
@@ -513,50 +655,49 @@ export function renderBufferWithCursor(buffer, pasteSpans, prefix, label, cursor
                 inside = ranges.length ? ranges[ranges.length - 1][1] - ranges[ranges.length - 1][0] : 0;
             }
         }
-        display = "";
         for (let i = 0; i < segs.length; i++) {
             const [, kind, disp] = segs[i];
             if (i && !endsWithWs(segs[i - 1][2]))
-                display += " ";
+                runs.push({ text: " ", style: "" });
             if (i === target) {
                 if (kind === "collapsed") {
-                    display += `\x1b[1m\x1b[36m${disp}\x1b[0m`;
+                    runs.push({ text: disp, style: "\x1b[1m\x1b[36m" });
                     if (!endsWithWs(disp))
-                        display += " ";
-                    display += `\x1b[1m▏\x1b[0m`;
+                        runs.push({ text: " ", style: "" });
+                    runs.push({ text: PROMPT_CARET, style: "\x1b[1m" });
                 }
                 else {
-                    const bold = i === target;
-                    display += disp.slice(0, inside);
-                    display += `\x1b[1m▏\x1b[0m`;
-                    display += disp.slice(inside);
+                    const before = disp.slice(0, inside);
+                    const after = disp.slice(inside);
+                    if (before)
+                        runs.push({ text: before, style: "" });
+                    runs.push({ text: PROMPT_CARET, style: "\x1b[1m" });
+                    if (after)
+                        runs.push({ text: after, style: "" });
                 }
             }
             else {
-                display += kind === "collapsed" ? `\x1b[1m\x1b[36m${disp}\x1b[0m` : disp;
+                runs.push({ text: disp, style: kind === "collapsed" ? "\x1b[1m\x1b[36m" : "" });
             }
         }
     }
-    const content = `\x1b[1m${prefix}\x1b[0m ${display}`;
-    const lines = content.split("\n");
+    const { rows, caretRow, caretCol } = wrapRuns(runs, innerW);
     // Top border with the label embedded on the left.
     const topPad = Math.max(borderW - label.length - 2, 0);
     const top = `\x1b[90m╭─ ${label} ${"─".repeat(topPad)}╮\x1b[0m`;
     // Body rows.
     const body = [];
-    for (const l of lines) {
+    for (const l of rows) {
         const plain = l.replace(/\x1b\[[0-9;]*m/g, "");
         const pad = Math.max(borderW - 2 - plain.length, 0);
         body.push(`\x1b[90m│\x1b[0m ${l}${" ".repeat(pad)} \x1b[90m│\x1b[0m`);
     }
     const bottom = `\x1b[90m╰${"─".repeat(borderW)}╯\x1b[0m`;
     const frame = [top, ...body, bottom].join("\n");
-    // Cursor placement: one row below the top border. Preceding columns are
-    // `│ ` (2) + prefix (prefix.length) + ` ` (1) = prefix.length+3, so the first
-    // display char (the `▏` block cursor) sits at column prefix.length+4 relative
-    // to line column `col`.
-    const cursorRow = row + 1;
-    const cursorCol = col + prefix.length + 4;
+    // Cursor placement: one row below the top border. The body prefix (`│ `)
+    // shifts the content right by 2 columns, so add 2 to the wrapped caret col.
+    const cursorRow = (caretRow === -1 ? 0 : caretRow) + 1;
+    const cursorCol = (caretCol === -1 ? 0 : caretCol) + 2;
     const totalRows = body.length + 2;
     return { frame, cursorRow, cursorCol, totalRows };
 }
@@ -735,15 +876,32 @@ export function askBottomPrompt(label = "You", prefix = "❯", history = []) {
             pasteSpans = adjusted.filter(([s, e]) => s < e);
         };
         const moveLeft = () => {
-            if (cursor > 0)
-                cursor -= 1;
+            if (cursor <= 0)
+                return;
+            // Jump the caret to the start of a paste span it sits just past (mirrors
+            // Python), so a collapsed block is treated as one unit.
+            for (const [s, e] of pasteSpans) {
+                if (s < cursor && cursor <= e) {
+                    cursor = s;
+                    return;
+                }
+            }
+            cursor -= 1;
         };
         const moveRight = () => {
-            if (cursor < buffer.length)
-                cursor += 1;
+            if (cursor >= buffer.length)
+                return;
+            for (const [s, e] of pasteSpans) {
+                if (s <= cursor && cursor < e) {
+                    cursor = e;
+                    return;
+                }
+            }
+            cursor += 1;
         };
         const moveUp = () => {
             if (!buffer.includes("\n")) {
+                // Single row: navigate command history.
                 if (!hist.length)
                     return;
                 if (histIdx === hist.length) {
@@ -755,10 +913,21 @@ export function askBottomPrompt(label = "You", prefix = "❯", history = []) {
                     cursor = buffer.length;
                     pasteSpans = [];
                 }
+                return;
+            }
+            // Multi row: move the caret up to the previous line, preserving column.
+            if (cursor > 0) {
+                let lineStart = buffer.lastIndexOf("\n", cursor - 1);
+                lineStart = lineStart !== -1 ? lineStart : 0;
+                let prevStart = buffer.lastIndexOf("\n", lineStart - 1);
+                prevStart = prevStart !== -1 ? prevStart : 0;
+                const [, col] = cursorLineCol(buffer, cursor);
+                cursor = prevStart + Math.min(col, lineStart - prevStart);
             }
         };
         const moveDown = () => {
             if (!buffer.includes("\n")) {
+                // Single row: navigate command history.
                 if (histIdx === hist.length || !draft)
                     return;
                 histIdx += 1;
@@ -772,6 +941,21 @@ export function askBottomPrompt(label = "You", prefix = "❯", history = []) {
                     cursor = buffer.length;
                     pasteSpans = [];
                 }
+                return;
+            }
+            // Multi row: move the caret down to the next line, preserving column.
+            if (cursor < buffer.length) {
+                const [, col] = cursorLineCol(buffer, cursor);
+                let nextStart = buffer.indexOf("\n", cursor);
+                if (nextStart === -1) {
+                    cursor = buffer.length;
+                }
+                else {
+                    nextStart += 1;
+                    let nxtEnd = buffer.indexOf("\n", nextStart);
+                    nxtEnd = nxtEnd !== -1 ? nxtEnd : buffer.length;
+                    cursor = Math.min(nextStart + col, nxtEnd);
+                }
             }
         };
         const onKeypress = (str, key) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxecli/oxe",
-  "version": "1.0.15",
+  "version": "1.0.17",
   "publishConfig": {
     "access": "public"
   },