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

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+# [@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)
+
+
+### Bug Fixes
+
+* **cli:** depend on the agent version the CLI was released with ([4931439](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/4931439d106063b81e24367d6aa9c3f285f4ad15))
+
+
+### Features
+
+* **cli:** offer npm updates at start-up, remind until installed, /update ([18defca](https://github.com/Datalab-Rotterdam/nova-ai-cli/commit/18defcaea988698f9d0909419bb2aa1fdedfa5a9))
+
 # [@datalabrotterdam/nova-ai-cli-v1.2.0-alpha.3](https://github.com/Datalab-Rotterdam/nova-ai-cli/compare/@datalabrotterdam/nova-ai-cli@1.2.0-alpha.2...@datalabrotterdam/nova-ai-cli@1.2.0-alpha.3) (2026-10-04)
 
 

package/README.md

@@ -44,10 +44,17 @@ nova-ai                # start the terminal UI in your project
 Or without installing: `npx @datalabrotterdam/nova-ai-cli login`, then
 `npx @datalabrotterdam/nova-ai-cli`.
 
-When a newer version is on npm, the terminal UI says so, and so do `-p` and
-`--version` (on stderr, only in a terminal). npm is asked at most once a day;
-an alpha install also follows the `alpha` channel. `NOVA_NO_UPDATE_CHECK=1`
-turns it off (it is off in CI).
+When a newer version is on npm, `nova-ai` asks before the terminal UI opens:
+Enter installs it (`npm install -g`) and restarts, `n` asks again tomorrow, `s`
+skips that version. Until it is installed, the status line keeps reminding you,
+and `/update` installs it and restarts in the same session. `-p` and
+`--version` print a notice (on stderr, only in a terminal). npm is asked at
+most once a day; an alpha install also follows the `alpha` channel.
+`NOVA_NO_UPDATE_CHECK=1` turns it off (it is off in CI).
+
+nova-ai installs updates itself only when it was installed with
+`npm install -g`; with npx, another package manager or a project dependency it
+shows the command to run instead.
 
 ```
 nova-ai [options]                 Interactive terminal UI

package/dist/{chunk-37PMUZ34.js → chunk-L77KQRGZ.js}

@@ -41,6 +41,7 @@ function chooseUpdate(currentVersion, distTags) {
   return {
     currentVersion,
     latestVersion: best.version,
+    tag: best.tag,
     command: `npm install -g ${CLI_PACKAGE_NAME}@${best.tag}`
   };
 }
@@ -61,7 +62,7 @@ async function readDistTags(options) {
   if (!response.ok) return null;
   const payload = await response.json();
   if (!isDistTags(payload)) return null;
-  if (cachePath) writeCache(cachePath, { checkedAt: now, distTags: payload });
+  if (cachePath) writeCache(cachePath, { ...cached, checkedAt: now, distTags: payload });
   return payload;
 }
 function readCache(path) {
@@ -74,6 +75,26 @@ function readCache(path) {
   }
   return null;
 }
+var SNOOZE_MS = 24 * 60 * 60 * 1e3;
+function shouldAskAboutUpdate(update, options = {}) {
+  const cachePath = options.cachePath === void 0 ? updateCachePath() : options.cachePath;
+  const cached = cachePath ? readCache(cachePath) : null;
+  if (!cached) return true;
+  if (cached.skippedVersion === update.latestVersion) return false;
+  const now = (options.now ?? Date.now)();
+  return !(typeof cached.snoozedUntil === "number" && now < cached.snoozedUntil);
+}
+function rememberUpdateAnswer(answer, update, options = {}) {
+  const cachePath = options.cachePath === void 0 ? updateCachePath() : options.cachePath;
+  if (!cachePath) return;
+  const cached = readCache(cachePath);
+  const base = cached ?? { checkedAt: 0, distTags: {} };
+  const now = (options.now ?? Date.now)();
+  writeCache(
+    cachePath,
+    answer === "skip" ? { ...base, skippedVersion: update.latestVersion, snoozedUntil: void 0 } : { ...base, snoozedUntil: now + SNOOZE_MS }
+  );
+}
 function writeCache(path, value) {
   try {
     mkdirSync(dirname(path), { recursive: true, mode: 448 });
@@ -141,6 +162,8 @@ export {
   updateChecksDisabled,
   checkForUpdate,
   chooseUpdate,
+  shouldAskAboutUpdate,
+  rememberUpdateAnswer,
   readInstalledVersion,
   isNewerVersion,
   formatUpdateNotice

package/dist/index.js

@@ -89,7 +89,7 @@ function parseTuiArgs(args) {
 function startUpdateCheck() {
   if (!process.stderr.isTTY) return null;
   const abort = new AbortController();
-  const result = import("./update-check-OX6WAPNN.js").then(({ checkForUpdate }) => checkForUpdate({ signal: abort.signal })).catch(() => null);
+  const result = import("./update-check-G3PYCRWM.js").then(({ checkForUpdate }) => checkForUpdate({ signal: abort.signal })).catch(() => null);
   return { result, cancel: () => abort.abort() };
 }
 async function noticeUpdate(check, waitMs) {
@@ -103,7 +103,7 @@ async function noticeUpdate(check, waitMs) {
   clearTimeout(timer);
   check.cancel();
   if (!update) return;
-  const { formatUpdateNotice } = await import("./update-check-OX6WAPNN.js");
+  const { formatUpdateNotice } = await import("./update-check-G3PYCRWM.js");
   process.stderr.write(`
 ${formatUpdateNotice(update)}
 `);
@@ -175,7 +175,7 @@ ${MAIN_HELP}
         );
         return 2;
       }
-      const { default: runChat } = await import("./tui-LNFSHL4Y.js");
+      const { default: runChat } = await import("./tui-OWU4YGTT.js");
       return runChat(options);
     }
   }

package/dist/{tui-LNFSHL4Y.js → tui-OWU4YGTT.js}

@@ -1,7 +1,12 @@
 import {
-  checkForUpdate
-} from "./chunk-37PMUZ34.js";
-import "./chunk-FMHWW3E6.js";
+  checkForUpdate,
+  rememberUpdateAnswer,
+  shouldAskAboutUpdate
+} from "./chunk-L77KQRGZ.js";
+import {
+  CLI_PACKAGE_NAME,
+  cliVersion
+} from "./chunk-FMHWW3E6.js";
 import {
   TuiAcpClient,
   createStore,
@@ -10,11 +15,105 @@ import {
 } from "./chunk-NHGIUEIR.js";
 
 // src/tui/index.ts
-import { createInterface } from "readline/promises";
+import { createInterface as createInterface2 } from "readline/promises";
 import { readCredentials } from "@datalabrotterdam/nova-ai-agent/core/credentials.js";
-import { listStoredSessions as listStoredSessions2 } from "@datalabrotterdam/nova-ai-agent/core/sessions.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";
 
+// src/update-install.ts
+import { spawnSync } from "child_process";
+import { existsSync, realpathSync } from "fs";
+import { dirname, join, sep } from "path";
+import { createInterface } from "readline/promises";
+var START_WAIT_MS = 1500;
+var UPDATED_FROM_ENV = "NOVA_UPDATED_FROM";
+function globalNpmPrefix(options = {}) {
+  const script = options.scriptPath ?? process.argv[1];
+  if (!script) return null;
+  const windows = (options.platform ?? process.platform) === "win32";
+  const marker = `${sep}node_modules${sep}${CLI_PACKAGE_NAME.split("/").join(sep)}${sep}`;
+  const resolved = realPath(script);
+  const at = resolved.lastIndexOf(marker);
+  if (at < 0) return null;
+  const nodeModulesParent = resolved.slice(0, at);
+  const prefix = windows ? nodeModulesParent : dirname(nodeModulesParent);
+  if (!windows && nodeModulesParent !== join(prefix, "lib")) return null;
+  return existsSync(join(prefix, windows ? "nova-ai.cmd" : join("bin", "nova-ai"))) ? prefix : null;
+}
+async function withInstallability(update, options = {}) {
+  if (!update) return null;
+  return { ...update, installable: globalNpmPrefix(options) !== null };
+}
+function npmInvocation(args) {
+  return process.platform === "win32" ? [`npm ${args.map((arg) => /\s/.test(arg) ? `"${arg}"` : arg).join(" ")}`, [], true] : ["npm", args, false];
+}
+function realPath(path) {
+  try {
+    return realpathSync(path);
+  } catch {
+    return path;
+  }
+}
+function parseUpdateAnswer(answer) {
+  const value = answer.trim().toLowerCase();
+  if (value === "" || value === "y" || value === "yes") return "update";
+  if (value === "s" || value === "skip") return "skip";
+  return "later";
+}
+async function askToUpdate(update) {
+  const prompt = createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    console.log(`
+Update available: nova-ai ${update.currentVersion} \u2192 ${update.latestVersion}`);
+    return parseUpdateAnswer(
+      await prompt.question("Update now? [Y/n/s] (n: not today, s: skip this version) ")
+    );
+  } finally {
+    prompt.close();
+  }
+}
+async function offerUpdateAtStart(check, restartArgs) {
+  let timer;
+  const update = await Promise.race([
+    check,
+    new Promise((resolve2) => {
+      timer = setTimeout(() => resolve2(null), START_WAIT_MS);
+    })
+  ]);
+  clearTimeout(timer);
+  if (!update?.installable || !shouldAskAboutUpdate(update)) return null;
+  const answer = await askToUpdate(update);
+  if (answer !== "update") {
+    rememberUpdateAnswer(answer, update);
+    console.log(
+      answer === "skip" ? `Skipping ${update.latestVersion}; you'll be asked again for a newer version.` : "Not now. /update installs it any time."
+    );
+    return null;
+  }
+  return installAndRestart(update, restartArgs);
+}
+function installAndRestart(update, restartArgs) {
+  const prefix = globalNpmPrefix();
+  if (!prefix) return null;
+  console.log(`
+Installing nova-ai ${update.latestVersion}\u2026`);
+  const [file, args, shell] = npmInvocation(["install", "-g", "--prefix", prefix, `${CLI_PACKAGE_NAME}@${update.tag}`]);
+  const install = spawnSync(file, args, { stdio: "inherit", shell });
+  if (install.status !== 0) {
+    console.error(`
+The update did not install. Run it yourself: ${update.command}
+`);
+    return null;
+  }
+  const script = process.argv[1];
+  if (!script) return null;
+  const restarted = spawnSync(process.execPath, [...process.execArgv, script, ...restartArgs], {
+    stdio: "inherit",
+    env: { ...process.env, [UPDATED_FROM_ENV]: update.currentVersion }
+  });
+  return restarted.status ?? 1;
+}
+
 // 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";
@@ -46,7 +145,7 @@ import {
 
 // src/tui/files/file-mentions.ts
 import { statSync } from "fs";
-import { isAbsolute, relative, resolve, sep } from "path";
+import { isAbsolute, relative, resolve, sep as sep2 } from "path";
 var MENTION_RE = /@(?:"([^"]+)"|'([^']+)'|([^\s]+))/g;
 var TRAILING_PUNCTUATION = /[.,;:!?\)\]\}]+$/;
 function findWorkspaceFileMentions(text, cwd) {
@@ -56,10 +155,10 @@ function findWorkspaceFileMentions(text, cwd) {
     const raw = match[1] ?? match[2] ?? match[3] ?? "";
     const candidates = [raw, raw.replace(TRAILING_PUNCTUATION, "")].filter((value, index, all) => value && all.indexOf(value) === index);
     for (const candidate of candidates) {
-      const normalized = candidate.replace(/[\\/]/g, sep);
+      const normalized = candidate.replace(/[\\/]/g, sep2);
       const absolutePath = resolve(workspaceRoot, normalized);
       const relativePath = relative(workspaceRoot, absolutePath);
-      if (relativePath.startsWith(`..${sep}`) || relativePath === ".." || isAbsolute(relativePath)) continue;
+      if (relativePath.startsWith(`..${sep2}`) || relativePath === ".." || isAbsolute(relativePath)) continue;
       try {
         if (!statSync(absolutePath).isFile()) continue;
       } catch {
@@ -67,7 +166,7 @@ function findWorkspaceFileMentions(text, cwd) {
       }
       mentions.set(absolutePath.toLowerCase(), {
         absolutePath,
-        relativePath: relativePath.split(sep).join("/")
+        relativePath: relativePath.split(sep2).join("/")
       });
       break;
     }
@@ -1389,7 +1488,7 @@ function StatusLine({
   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;
   return /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", children: [
-    ui.updateAvailable ? /* @__PURE__ */ jsx2(Text2, { color: palette.warning, children: `Update ${ui.updateAvailable.latestVersion} available (current ${ui.updateAvailable.currentVersion}). Run: ${ui.updateAvailable.command}` }) : null,
+    ui.updateAvailable ? /* @__PURE__ */ jsx2(Text2, { color: palette.warning, children: `Update ${ui.updateAvailable.latestVersion} available (current ${ui.updateAvailable.currentVersion}). ${ui.updateAvailable.installable ? "Type /update to install it." : `Run: ${ui.updateAvailable.command}`}` }) : null,
     ui.statusLine ? /* @__PURE__ */ jsx2(Text2, { color: palette.muted, children: ui.statusLine }) : null,
     /* @__PURE__ */ jsxs2(Text2, { wrap: "truncate-end", children: [
       /* @__PURE__ */ jsx2(Text2, { color: palette.muted, children: model }),
@@ -1819,6 +1918,14 @@ var builtinCommands = [
       ctx.exit();
     }
   },
+  {
+    name: "update",
+    description: "Install the newer nova-ai from npm and restart in this session",
+    run(ctx) {
+      const message = ctx.requestUpdate();
+      if (message) ctx.print(message);
+    }
+  },
   {
     name: "mode",
     description: "Switch interaction mode (/mode agent|ask|plan)",
@@ -2198,10 +2305,10 @@ console.log(ObjC.unwrap(png.base64EncodedStringWithOptions(0)));
 `;
 
 // src/tui/files/find-fd.ts
-import { spawnSync } from "child_process";
+import { spawnSync as spawnSync2 } from "child_process";
 var FD_CANDIDATES = ["fd", "fdfind"];
 var cachedPath;
-function resolveFdPath(run = (command, args) => spawnSync(command, args, { stdio: "ignore" })) {
+function resolveFdPath(run = (command, args) => spawnSync2(command, args, { stdio: "ignore" })) {
   if (cachedPath !== void 0) return cachedPath;
   for (const candidate of FD_CANDIDATES) {
     const result = run(candidate, ["--version"]);
@@ -2216,7 +2323,7 @@ function resolveFdPath(run = (command, args) => spawnSync(command, args, { stdio
 
 // src/tui/files/list-workspace-files.ts
 import { readdirSync } from "fs";
-import { join, relative as relative2, sep as sep2 } from "path";
+import { join as join2, relative as relative2, sep as sep3 } from "path";
 var SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", ".git", "dist", "build", ".nova-ai", "out", "coverage", ".next", ".turbo"]);
 function listWorkspaceFiles(cwd, max = 2e3) {
   const results = [];
@@ -2232,12 +2339,12 @@ function listWorkspaceFiles(cwd, max = 2e3) {
     for (const entry of entries) {
       if (results.length >= max) break;
       if (entry.isSymbolicLink()) continue;
-      const full = join(dir, entry.name);
+      const full = join2(dir, entry.name);
       if (entry.isDirectory()) {
         if (SKIP_DIRS.has(entry.name)) continue;
         stack.push(full);
       } else if (entry.isFile()) {
-        results.push(relative2(cwd, full).split(sep2).join("/"));
+        results.push(relative2(cwd, full).split(sep3).join("/"));
       }
     }
   }
@@ -2268,7 +2375,7 @@ var DraftImageAttachments = class {
 import { spawn } from "child_process";
 import { readdirSync as readdirSync2, statSync as statSync2 } from "fs";
 import { homedir } from "os";
-import { basename, dirname, join as join2 } from "path";
+import { basename, dirname as dirname2, join as join3 } from "path";
 var PATH_DELIMITERS = /* @__PURE__ */ new Set([" ", "	", '"', "'", "="]);
 var MAX_SUGGESTIONS2 = 20;
 var WorkspaceAutocompleteProvider = class {
@@ -2349,14 +2456,14 @@ var WorkspaceAutocompleteProvider = class {
   pathSuggestions(prefix) {
     const quoted = prefix.startsWith('"');
     const raw = quoted ? prefix.slice(1) : prefix;
-    const expanded = raw === "~" || raw.startsWith("~/") ? join2(homedir(), raw.slice(1)) : raw;
+    const expanded = raw === "~" || raw.startsWith("~/") ? join3(homedir(), raw.slice(1)) : raw;
     const absolute = expanded.startsWith("/") || /^[A-Za-z]:[\\/]/.test(expanded);
     const separator = Math.max(raw.lastIndexOf("/"), raw.lastIndexOf("\\"));
     const listsDirectory = raw === "" || raw === "~" || separator === raw.length - 1;
-    const directoryPart = listsDirectory ? expanded : dirname(expanded);
+    const directoryPart = listsDirectory ? expanded : dirname2(expanded);
     const namePrefix = listsDirectory ? "" : basename(expanded);
     const displayDirectory = raw === "~" ? "~/" : separator >= 0 ? raw.slice(0, separator + 1) : "";
-    const searchDirectory = absolute ? directoryPart : join2(this.cwd, directoryPart);
+    const searchDirectory = absolute ? directoryPart : join3(this.cwd, directoryPart);
     let entries;
     try {
       entries = readdirSync2(searchDirectory, { withFileTypes: true });
@@ -2370,7 +2477,7 @@ var WorkspaceAutocompleteProvider = class {
       if (!isDirectory && entry.isSymbolicLink()) {
         try {
           isDirectory = statSync2(
-            join2(searchDirectory, entry.name)
+            join3(searchDirectory, entry.name)
           ).isDirectory();
         } catch {
         }
@@ -3739,6 +3846,8 @@ var TuiController = class {
   unsubscribeStore;
   resolveExit = () => {
   };
+  /** Set by /update: the caller installs and restarts after the TUI exits. */
+  updateRequested = false;
   /** Settles once the user asked to quit; `run` then tears the view down. */
   exitRequested = new Promise((resolve2) => {
     this.resolveExit = resolve2;
@@ -4063,6 +4172,19 @@ ${skill.path}`
     clear: () => void this.runner.startNewSession(),
     newSession: () => this.runner.startNewSession(),
     exit: () => this.requestExit(),
+    requestUpdate: () => {
+      const update = this.store.getState().updateAvailable;
+      if (!update) return "No newer nova-ai found on npm.";
+      if (!update.installable) {
+        return `nova-ai ${update.latestVersion} is available, but this copy wasn't installed with npm -g, so it can't update itself. Run: ${update.command}`;
+      }
+      if (this.store.getState().busy) {
+        return "Wait for the current request to finish (or press Esc), then run /update again.";
+      }
+      this.updateRequested = true;
+      this.requestExit();
+      return null;
+    },
     resumeSession: (sessionId) => {
       const id = sessionId ?? listSessionsForCwd(this.runner.cwd)[0]?.sessionId;
       return id ? this.runner.resumeFrom(id) : false;
@@ -4639,6 +4761,7 @@ async function runInkTui(credentials, cwd, args, options = {}) {
   }
   stdout.write(`Resume this session with: nova-ai --resume ${runner.sessionId}
 `);
+  return { sessionId: runner.sessionId, updateRequested: controller.updateRequested };
 }
 function App({ controller }) {
   const view = useSyncExternalStore2(controller.subscribe, controller.getView);
@@ -4737,6 +4860,15 @@ async function runChat(options) {
     return 1;
   }
   const credentials = options.model ? { ...stored, defaultModel: options.model } : stored;
+  const updateCheck = checkForUpdate().then((update) => withInstallability(update));
+  const updatedFrom = process.env[UPDATED_FROM_ENV];
+  if (updatedFrom) {
+    delete process.env[UPDATED_FROM_ENV];
+    console.log(`Updated nova-ai ${updatedFrom} \u2192 ${cliVersion() ?? "?"}.`);
+  } else {
+    const restartedCode = await offerUpdateAtStart(updateCheck, process.argv.slice(2));
+    if (restartedCode !== null) return restartedCode;
+  }
   const cwd = process.cwd();
   let resume = options.resume;
   if (options.continueLast) {
@@ -4748,11 +4880,22 @@ async function runChat(options) {
   }
   if (workspaceNeedsTrust(cwd)) await askToTrust(cwd);
   const args = resume ? ["--resume", resume] : [];
-  await runInkTui(credentials, cwd, args);
+  const result = await runInkTui(credentials, cwd, args, { checkForUpdate: () => updateCheck });
+  if (result.updateRequested) {
+    const update = await updateCheck;
+    if (update) {
+      const restartArgs = [
+        ...loadStoredSession2(result.sessionId) ? ["--resume", result.sessionId] : [],
+        ...options.model ? ["--model", options.model] : []
+      ];
+      const restartedCode = installAndRestart(update, restartArgs);
+      if (restartedCode !== null) return restartedCode;
+    }
+  }
   return 0;
 }
 async function askToTrust(cwd) {
-  const prompt = createInterface({ input: process.stdin, output: process.stdout });
+  const prompt = createInterface2({ input: process.stdin, output: process.stdout });
   try {
     console.log(`
 ${cwd}`);

package/dist/{update-check-OX6WAPNN.js → update-check-G3PYCRWM.js}

@@ -4,9 +4,11 @@ import {
   formatUpdateNotice,
   isNewerVersion,
   readInstalledVersion,
+  rememberUpdateAnswer,
+  shouldAskAboutUpdate,
   updateCachePath,
   updateChecksDisabled
-} from "./chunk-37PMUZ34.js";
+} from "./chunk-L77KQRGZ.js";
 import "./chunk-FMHWW3E6.js";
 export {
   checkForUpdate,
@@ -14,6 +16,8 @@ export {
   formatUpdateNotice,
   isNewerVersion,
   readInstalledVersion,
+  rememberUpdateAnswer,
+  shouldAskAboutUpdate,
   updateCachePath,
   updateChecksDisabled
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datalabrotterdam/nova-ai-cli",
-  "version": "1.2.0-alpha.3",
+  "version": "1.2.0-alpha.4",
   "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",
@@ -39,7 +39,7 @@
   },
   "dependencies": {
     "@agentclientprotocol/sdk": "^0.29.0",
-    "@datalabrotterdam/nova-ai-agent": "^1.0.0-alpha.1",
+    "@datalabrotterdam/nova-ai-agent": "^1.0.0-alpha.2",
     "@datalabrotterdam/nova-sdk": "^1.3.2",
     "chalk": "^5.3.0",
     "cli-highlight": "^2.1.11",