@datalabrotterdam/nova-ai-cli 1.2.0-alpha.4 → 1.2.0-alpha.5

package/CHANGELOG.md

@@ -1,3 +1,16 @@
+# [@datalabrotterdam/nova-ai-cli-v1.2.0-alpha.5](https://github.com/Datalab-Rotterdam/nova-ai-cli/compare/@datalabrotterdam/nova-ai-cli@1.2.0-alpha.4...@datalabrotterdam/nova-ai-cli@1.2.0-alpha.5) (2026-10-23)
+
+
+### Bug Fixes
+
+* **cli:** keep the full-screen frame one row short of the terminal ([37355f4](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/37355f4efb8a237f204c061ad7008faf54a0dd9e))
+* **cli:** pick the account's default model when none is set ([fb0f34c](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/fb0f34c7bac26f1b59c4b6b2245e6fb8365f99f1))
+
+
+### Features
+
+* **cli:** full-screen TUI with a pinned prompt and mouse-wheel scrolling ([a68d693](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/a68d6930945bd6440de22c709fc14ae32a9c9f65))
+
 # [@datalabrotterdam/nova-ai-cli-v1.2.0-alpha.4](https://github.com/Datalab-Rotterdam/nova-ai-cli/compare/@datalabrotterdam/nova-ai-cli@1.2.0-alpha.3...@datalabrotterdam/nova-ai-cli@1.2.0-alpha.4) (2026-10-05)
 
 

package/README.md

@@ -71,9 +71,11 @@ Interactive options:
 
 ## Terminal UI
 
-The UI renders inline below your shell prompt. Finished messages go to the
-terminal's own scrollback (scroll, search and copy as usual); only the
-streaming answer, running tools, the prompt and the status rows are redrawn.
+The UI runs full screen (the terminal's alternate screen, like `less` or
+`vim`) and gives your shell its screen back on exit. The mouse wheel or
+PgUp/PgDn scroll the transcript, Esc jumps back to the newest output, and
+while you read an answer the prompt that asked for it stays pinned on the top
+row. To select text, hold Shift (Option in some macOS terminals) while dragging.
 
 - **Modes** (Shift+Tab): `agent` does the work; `plan` reads the code, asks
   questions and builds a task list but changes nothing; `ask` only answers.

package/dist/index.js

@@ -175,7 +175,7 @@ ${MAIN_HELP}
         );
         return 2;
       }
-      const { default: runChat } = await import("./tui-OWU4YGTT.js");
+      const { default: runChat } = await import("./tui-4XTC6VJP.js");
       return runChat(options);
     }
   }

package/dist/{tui-OWU4YGTT.js → tui-4XTC6VJP.js}

@@ -16,7 +16,12 @@ import {
 
 // src/tui/index.ts
 import { createInterface as createInterface2 } from "readline/promises";
-import { readCredentials } from "@datalabrotterdam/nova-ai-agent/core/credentials.js";
+import {
+  readCredentials,
+  saveDefaultModel as saveDefaultModel2
+} from "@datalabrotterdam/nova-ai-agent/core/credentials.js";
+import { resolveDefaultModel as resolveDefaultModel2 } from "@datalabrotterdam/nova-ai-agent/core/model-capabilities.js";
+import { createNovaClient as createNovaClient2 } from "@datalabrotterdam/nova-ai-agent/core/nova-client.js";
 import { listStoredSessions as listStoredSessions2, loadStoredSession as loadStoredSession2 } from "@datalabrotterdam/nova-ai-agent/core/sessions.js";
 import { setWorkspaceTrusted as setWorkspaceTrusted2 } from "@datalabrotterdam/nova-ai-agent/core/nova-home.js";
 
@@ -115,8 +120,8 @@ The update did not install. Run it yourself: ${update.command}
 }
 
 // src/tui/ink/app.tsx
-import { Box as Box6, render, Static, Text as Text6, useBoxMetrics, useWindowSize } from "ink";
-import { useEffect, useRef, useState as useState2, useSyncExternalStore as useSyncExternalStore2 } from "react";
+import { Box as Box6, render, Text as Text6, useBoxMetrics, useInput as useInput3, useWindowSize } from "ink";
+import { memo, useEffect, useRef, useState as useState2, useSyncExternalStore as useSyncExternalStore2 } from "react";
 import { savedPermissionMode } from "@datalabrotterdam/nova-ai-agent/core/policy/settings.js";
 
 // src/tui/session/session-runner.ts
@@ -1153,6 +1158,17 @@ function kittyKeyboardOverride(env = process.env) {
 function isLateTerminalReply(input) {
   return /^\u001b?\[\?[\d;]*[uc]$/.test(input);
 }
+var MOUSE_REPORTING_ON = "\x1B[?1000h\x1B[?1006h";
+var MOUSE_REPORTING_OFF = "\x1B[?1000l\x1B[?1006l";
+var MOUSE_INPUT = /^\u001b?\[<(\d+);\d+;\d+[Mm]$/;
+function isMouseInput(input) {
+  return MOUSE_INPUT.test(input);
+}
+function wheelRows(input) {
+  const button = Number(MOUSE_INPUT.exec(input)?.[1] ?? -1);
+  if (button < 0 || (button & 64) === 0) return 0;
+  return button & 1 ? -3 : 3;
+}
 
 // src/tui/ink/components/prompt-input.tsx
 import { Box, Text, useInput, usePaste } from "ink";
@@ -1170,7 +1186,8 @@ var palette = {
   faint: "#64748b",
   code: "#fcd34d",
   diffAddBg: "#1b3a24",
-  diffRemoveBg: "#3d1f1f"
+  diffRemoveBg: "#3d1f1f",
+  stickyBackground: "#1e293b"
 };
 var colors = {
   primary: chalk.hex(palette.primary),
@@ -1197,7 +1214,7 @@ function PromptInput({
 }) {
   useSyncExternalStore(editor.subscribe, editor.getVersion);
   useInput((input, key) => {
-    if (onKey(input, key)) return;
+    if (isMouseInput(input) || onKey(input, key)) return;
     editor.handleKey(input, key);
   });
   usePaste((text) => editor.paste(text));
@@ -1483,7 +1500,8 @@ import { Fragment as Fragment2, jsx as jsx2, jsxs as jsxs2 } from "react/jsx-run
 function StatusLine({
   ui,
   model,
-  mcp
+  mcp,
+  scroll = 0
 }) {
   const separator = /* @__PURE__ */ jsx2(Text2, { color: palette.faint, children: " | " });
   const usage = ui.contextUsage ? `ctx:${formatTokenCount(ui.contextUsage.totalTokens)}${ui.contextUsage.contextWindow ? `/${formatTokenCount(ui.contextUsage.contextWindow)}` : ""}` : null;
@@ -1511,6 +1529,10 @@ function StatusLine({
         `mcp:${mcp.connected}/${mcp.configured}`,
         mcp.failed ? /* @__PURE__ */ jsx2(Text2, { color: palette.danger, children: ` !${mcp.failed}` }) : null
       ] }) : null,
+      scroll ? /* @__PURE__ */ jsxs2(Fragment2, { children: [
+        separator,
+        /* @__PURE__ */ jsx2(Text2, { color: palette.warning, children: `\u2191${scroll} lines \xB7 PgDn/Esc` })
+      ] }) : null,
       mcp.skills ? /* @__PURE__ */ jsxs2(Fragment2, { children: [
         separator,
         `skills:${mcp.skills}`
@@ -3601,17 +3623,11 @@ var TranscriptCommitter = class {
   planSignature = null;
   snapshot = null;
   lastState = null;
-  redrawRequested = false;
-  /** The next sync starts a new epoch, e.g. after the terminal width changed. */
-  requestRedraw() {
-    this.redrawRequested = true;
-    this.lastState = null;
-  }
   sync(state, expanded) {
     if (this.snapshot && state === this.lastState && expanded === this.expanded)
       return this.snapshot;
     this.lastState = state;
-    if (this.redrawRequested || state.sessionId !== this.sessionId || expanded !== this.expanded || !this.prefixIntact(state.messages)) {
+    if (state.sessionId !== this.sessionId || expanded !== this.expanded || !this.prefixIntact(state.messages)) {
       this.startEpoch(state, expanded);
     }
     const messages = state.messages;
@@ -3764,7 +3780,6 @@ var TranscriptCommitter = class {
     return true;
   }
   startEpoch(state, expanded) {
-    this.redrawRequested = false;
     this.epoch++;
     this.sessionId = state.sessionId;
     this.expanded = expanded;
@@ -3810,7 +3825,6 @@ function safeSplitOffset(text, from) {
 }
 
 // src/tui/ink/controller.ts
-var CLEAR_SCREEN_AND_SCROLLBACK = "\x1B[2J\x1B[3J\x1B[H";
 var EXIT_CONFIRM_MS = 2e3;
 var TuiController = class {
   constructor(store, runner, io) {
@@ -3835,6 +3849,8 @@ var TuiController = class {
   exiting = false;
   view;
   lastEpoch = 0;
+  scroll = 0;
+  viewport = { rows: 10, contentRows: 0 };
   exitArmed = false;
   exitTimer;
   animationTimer;
@@ -3893,8 +3909,17 @@ var TuiController = class {
         this.runner.cancel();
         return true;
       }
+      if (this.scroll > 0) {
+        this.scrollTo(0);
+        return true;
+      }
       return false;
     }
+    if (key.pageUp || key.pageDown) {
+      const page = Math.max(1, this.viewport.rows - 2);
+      this.scrollBy(key.pageUp ? page : -page);
+      return true;
+    }
     if (key.tab && key.shift) {
       this.cycleInteractionMode();
       return true;
@@ -4116,14 +4141,23 @@ ${skill.path}`
     }
   };
   /**
-   * Prints the whole transcript again. After the width changed, the terminal
-   * re-wrapped what is on screen on its own and the live area can't be
-   * erased exactly (Ink leaves stale prompt borders), and old scrollback keeps
-   * the old wrapping.
+   * The view reports its transcript size after each layout. While scrolled
+   * up, new output below grows the offset so the rows being read stay put.
    */
-  redrawAll() {
-    if (this.stopped || this.exiting) return;
-    this.committer.requestRedraw();
+  setViewport(rows, contentRows) {
+    const grown = contentRows - this.viewport.contentRows;
+    this.viewport = { rows, contentRows };
+    this.scrollTo(this.scroll > 0 && grown > 0 ? this.scroll + grown : this.scroll);
+  }
+  /** Positive scrolls toward older output. */
+  scrollBy(rows) {
+    this.scrollTo(this.scroll + rows);
+  }
+  scrollTo(offset) {
+    const max = Math.max(0, this.viewport.contentRows - this.viewport.rows);
+    const next = Math.max(0, Math.min(offset, max));
+    if (next === this.scroll) return;
+    this.scroll = next;
     this.refresh();
   }
   toggleToolDetails() {
@@ -4224,6 +4258,7 @@ ${skill.path}`
   submit = async (text, images = [], pastes = []) => {
     const value = text.trim();
     if (!value) return;
+    this.scroll = 0;
     this.editor.addToHistory(value);
     this.store.setState((state) => ({
       inputHistory: [...state.inputHistory, value],
@@ -4325,7 +4360,10 @@ ${skill.path}`
     this.view = this.buildView();
     if (this.view.transcript.epoch !== this.lastEpoch) {
       this.lastEpoch = this.view.transcript.epoch;
-      this.io.write(CLEAR_SCREEN_AND_SCROLLBACK);
+      if (this.scroll) {
+        this.scroll = 0;
+        this.view = this.buildView();
+      }
     }
     for (const listener of this.listeners) listener();
   }
@@ -4339,7 +4377,8 @@ ${skill.path}`
       model: this.runner.model,
       mcp: mcpCounts(this.runner),
       expandedTools: this.expandedTools,
-      exiting: this.exiting
+      exiting: this.exiting,
+      scroll: this.scroll
     };
   }
   questionState(pending) {
@@ -4409,7 +4448,7 @@ function useDialogInput(handle, isActive) {
   const [, setTick] = useState(0);
   useInput2(
     (input, key) => {
-      if (handle(input, key) === "changed") setTick((tick) => tick + 1);
+      if (!isMouseInput(input) && handle(input, key) === "changed") setTick((tick) => tick + 1);
     },
     { isActive }
   );
@@ -4551,7 +4590,7 @@ function QuestionDialog({
   const [, setTick] = useState(0);
   useInput2(
     (input, key) => {
-      if (state.handleKey(input, key) === "changed") setTick((tick) => tick + 1);
+      if (!isMouseInput(input) && state.handleKey(input, key) === "changed") setTick((tick) => tick + 1);
     },
     { isActive }
   );
@@ -4633,7 +4672,7 @@ function PermissionDialog({
 }) {
   useInput2(
     (input, key) => {
-      if (permissionKey(request, input, key) === "closed") onClose();
+      if (!isMouseInput(input) && permissionKey(request, input, key) === "closed") onClose();
     },
     { isActive }
   );
@@ -4684,9 +4723,8 @@ function wrapPlain(text, width) {
 }
 
 // src/tui/ink/app.tsx
-import { Fragment as Fragment4, jsx as jsx6, jsxs as jsxs6 } from "react/jsx-runtime";
+import { jsx as jsx6, jsxs as jsxs6 } from "react/jsx-runtime";
 var FRAME_MS = 120;
-var RESIZE_SETTLE_MS = 100;
 async function runInkTui(credentials, cwd, args, options = {}) {
   const store = createStore({
     messages: [],
@@ -4728,22 +4766,15 @@ async function runInkTui(credentials, cwd, args, options = {}) {
     // Ink otherwise turns non-interactive whenever CI is set in the
     // environment; the TUI only runs on a terminal anyway.
     interactive: Boolean(stdout.isTTY),
+    // Full screen: the transcript scrolls inside the app (PgUp/PgDn) and the
+    // terminal gets its own screen back on exit.
+    alternateScreen: Boolean(stdout.isTTY),
     kittyKeyboard: { mode: kittyKeyboard ? "enabled" : "disabled" }
   });
   controller.start();
+  if (stdout.isTTY) stdout.write(MOUSE_REPORTING_ON);
   const onSignal = () => controller.requestExit();
   process.once("SIGTERM", onSignal);
-  let printedColumns = stdout.columns;
-  let resizeTimer;
-  const onResize = () => {
-    if (resizeTimer) clearTimeout(resizeTimer);
-    resizeTimer = setTimeout(() => {
-      if (stdout.columns === printedColumns) return;
-      printedColumns = stdout.columns;
-      controller.redrawAll();
-    }, RESIZE_SETTLE_MS);
-  };
-  stdout.on("resize", onResize);
   void (options.checkForUpdate ?? checkForUpdate)().then((updateAvailable) => {
     if (updateAvailable) store.setState({ updateAvailable });
   });
@@ -4753,8 +4784,7 @@ async function runInkTui(credentials, cwd, args, options = {}) {
     await controller.stop();
   } finally {
     process.off("SIGTERM", onSignal);
-    stdout.off("resize", onResize);
-    if (resizeTimer) clearTimeout(resizeTimer);
+    if (stdout.isTTY) stdout.write(MOUSE_REPORTING_OFF);
     instance.unmount();
     await instance.waitUntilExit().catch(() => {
     });
@@ -4768,31 +4798,85 @@ function App({ controller }) {
   const { rows, columns } = useWindowSize();
   const bottomRef = useRef(null);
   const bottom = useBoxMetrics(bottomRef);
+  const contentRef = useRef(null);
+  const content = useBoxMetrics(contentRef);
   const working = useWorking(view);
+  const [userTops, setUserTops] = useState2(/* @__PURE__ */ new Map());
+  useInput3((input) => {
+    const rows2 = wheelRows(input);
+    if (rows2) controller.scrollBy(rows2);
+  });
+  const height = Math.max(4, rows - 1);
+  const viewportRows = Math.max(3, height - (bottom.hasMeasured ? bottom.height : 6));
+  useEffect(() => {
+    if (content.hasMeasured) controller.setViewport(viewportRows, content.height);
+  }, [controller, viewportRows, content.hasMeasured, content.height]);
+  if (view.exiting) return null;
   const { transcript } = view;
-  const scrollback = (
-    // <Static> is laid out as an absolute box; without a width its text
-    // wraps against its content and runs past the terminal edge.
-    /* @__PURE__ */ jsx6(Static, { items: [...transcript.committed], style: { width: columns }, children: (block) => /* @__PURE__ */ jsx6(Box6, { marginTop: 1, children: /* @__PURE__ */ jsx6(TranscriptBlockView, { block }) }, block.key) }, transcript.epoch)
-  );
-  if (view.exiting) return scrollback;
-  const liveRows = Math.max(3, rows - (bottom.hasMeasured ? bottom.height : 6) - 2);
-  const dialogRows = Math.max(6, rows - 4);
-  return /* @__PURE__ */ jsxs6(Fragment4, { children: [
-    scrollback,
-    /* @__PURE__ */ jsx6(Box6, { flexDirection: "column", maxHeight: liveRows, overflowY: "hidden", justifyContent: "flex-end", children: /* @__PURE__ */ jsxs6(Box6, { flexDirection: "column", flexShrink: 0, children: [
-      transcript.live.map((block) => /* @__PURE__ */ jsx6(Box6, { marginTop: 1, children: /* @__PURE__ */ jsx6(TranscriptBlockView, { block, frame: working.frame }) }, block.key)),
-      working.line ? /* @__PURE__ */ jsx6(Box6, { marginTop: 1, paddingLeft: 1, children: /* @__PURE__ */ jsxs6(Text6, { children: [
-        /* @__PURE__ */ jsx6(Text6, { color: palette.accent, children: WORKING_FRAMES[working.frame] }),
-        /* @__PURE__ */ jsx6(Text6, { color: palette.muted, children: ` ${working.line}` })
-      ] }) }) : null
-    ] }) }),
-    /* @__PURE__ */ jsxs6(Box6, { ref: bottomRef, flexDirection: "column", marginTop: 1, children: [
-      /* @__PURE__ */ jsx6(Surface, { controller, view, rows: dialogRows, columns }),
-      /* @__PURE__ */ jsx6(StatusLine, { ui: view.ui, model: view.model, mcp: view.mcp })
+  const blocks = [...transcript.committed, ...transcript.live];
+  const liveKeys = new Set(transcript.live.map((block) => block.key));
+  const onUserTop = (key, top) => setUserTops((tops) => tops.get(key) === top ? tops : new Map(tops).set(key, top));
+  const firstVisibleRow = content.height - viewportRows - view.scroll;
+  let sticky = null;
+  for (const block of blocks) {
+    if (block.kind !== "user") continue;
+    const top = userTops.get(block.key);
+    if (top !== void 0 && top < firstVisibleRow) sticky = block.text;
+  }
+  return /* @__PURE__ */ jsxs6(Box6, { flexDirection: "column", height, children: [
+    /* @__PURE__ */ jsxs6(
+      Box6,
+      {
+        flexDirection: "column",
+        height: viewportRows,
+        flexShrink: 0,
+        overflowY: "hidden",
+        justifyContent: "flex-end",
+        children: [
+          /* @__PURE__ */ jsxs6(Box6, { ref: contentRef, flexDirection: "column", flexShrink: 0, marginBottom: -view.scroll, children: [
+            blocks.map(
+              (block) => liveKeys.has(block.key) ? /* @__PURE__ */ jsx6(Box6, { marginTop: 1, children: /* @__PURE__ */ jsx6(TranscriptBlockView, { block, frame: working.frame }) }, block.key) : /* @__PURE__ */ jsx6(CommittedBlock, { block, onUserTop }, block.key)
+            ),
+            working.line ? /* @__PURE__ */ jsx6(Box6, { marginTop: 1, paddingLeft: 1, children: /* @__PURE__ */ jsxs6(Text6, { children: [
+              /* @__PURE__ */ jsx6(Text6, { color: palette.accent, children: WORKING_FRAMES[working.frame] }),
+              /* @__PURE__ */ jsx6(Text6, { color: palette.muted, children: ` ${working.line}` })
+            ] }) }) : null
+          ] }),
+          sticky !== null ? /* @__PURE__ */ jsx6(StickyPrompt, { text: sticky, columns }) : null
+        ]
+      }
+    ),
+    /* @__PURE__ */ jsxs6(Box6, { ref: bottomRef, flexDirection: "column", flexShrink: 0, children: [
+      /* @__PURE__ */ jsx6(Surface, { controller, view, rows: Math.max(6, rows - 4), columns }),
+      /* @__PURE__ */ jsx6(StatusLine, { ui: view.ui, model: view.model, mcp: view.mcp, scroll: view.scroll })
     ] })
   ] });
 }
+var CommittedBlock = memo(function CommittedBlock2({
+  block,
+  onUserTop
+}) {
+  if (block.kind !== "user") {
+    return /* @__PURE__ */ jsx6(Box6, { marginTop: 1, children: /* @__PURE__ */ jsx6(TranscriptBlockView, { block }) });
+  }
+  return /* @__PURE__ */ jsx6(UserAnchor, { block, onUserTop, children: /* @__PURE__ */ jsx6(TranscriptBlockView, { block }) });
+}, (before, after) => before.block === after.block);
+function UserAnchor({
+  block,
+  onUserTop,
+  children
+}) {
+  const ref = useRef(null);
+  const { top, hasMeasured } = useBoxMetrics(ref);
+  useEffect(() => {
+    if (hasMeasured) onUserTop(block.key, top);
+  }, [block.key, top, hasMeasured]);
+  return /* @__PURE__ */ jsx6(Box6, { ref, marginTop: 1, children });
+}
+function StickyPrompt({ text, columns }) {
+  const line = `> ${text.replace(/\s+/g, " ").trim()}`;
+  return /* @__PURE__ */ jsx6(Box6, { position: "absolute", top: 0, left: 0, width: columns, children: /* @__PURE__ */ jsx6(Text6, { color: palette.primary, backgroundColor: palette.stickyBackground, wrap: "truncate-end", children: line.padEnd(columns) }) });
+}
 function Surface({
   controller,
   view,
@@ -4859,7 +4943,14 @@ async function runChat(options) {
     console.error("nova-ai isn't connected to a Nova AI account yet. Run `nova-ai login` first.");
     return 1;
   }
-  const credentials = options.model ? { ...stored, defaultModel: options.model } : stored;
+  const model = options.model ?? stored.defaultModel ?? process.env.NOVA_MODEL ?? await pickDefaultModel(stored);
+  if (!model) {
+    console.error("nova-ai has no model to use yet. Start it with one, for example:");
+    console.error("  nova-ai --model <model-id>     (or set NOVA_MODEL)");
+    console.error("Then Ctrl+P in nova-ai switches and remembers the model.");
+    return 1;
+  }
+  const credentials = { ...stored, defaultModel: model };
   const updateCheck = checkForUpdate().then((update) => withInstallability(update));
   const updatedFrom = process.env[UPDATED_FROM_ENV];
   if (updatedFrom) {
@@ -4894,6 +4985,19 @@ async function runChat(options) {
   }
   return 0;
 }
+async function pickDefaultModel(credentials) {
+  try {
+    const { data } = await createNovaClient2(credentials.apiKey).models.list({ limit: 100 });
+    const model = resolveDefaultModel2(data, void 0);
+    if (model) {
+      saveDefaultModel2(model);
+      console.log(`Using model ${model} (Ctrl+P switches).`);
+    }
+    return model;
+  } catch {
+    return void 0;
+  }
+}
 async function askToTrust(cwd) {
   const prompt = createInterface2({ input: process.stdin, output: process.stdout });
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datalabrotterdam/nova-ai-cli",
-  "version": "1.2.0-alpha.4",
+  "version": "1.2.0-alpha.5",
   "description": "Agentic coding with DataLab Rotterdam's Nova AI in your terminal: interactive TUI, headless mode, and an ACP agent for editors",
   "license": "Apache-2.0",
   "author": "DataLab Rotterdam",