llm-tuner 0.3.0 → 0.4.0

package/src/cli/commands/settings.js

@@ -0,0 +1,65 @@
+import { select } from '@inquirer/prompts';
+import { writeSettings } from '../../core/index.js';
+import { t as translate } from '../../i18n/index.js';
+import { getColors } from '../colors.js';
+import { withNav, NAV_BACK, backChoice } from '../nav.js';
+
+export async function settingsCommand(args, { lang, theme }) {
+  const c = getColors(theme);
+  const t = (key, params) => translate(lang, key, params);
+
+  while (true) {
+    const action = await withNav(() => select({
+      message: t('cli.settingsMenu'),
+      choices: [
+        { name: `${t('cli.settingsLanguage')}: ${lang === 'es' ? 'Español' : 'English'} (${lang})`, value: 'lang' },
+        { name: `${t('cli.settingsTheme')}: ${theme.charAt(0).toUpperCase() + theme.slice(1)}`, value: 'theme' },
+        { name: t('cli.settingsExit'), value: 'exit' },
+      ],
+    }));
+
+    if (action === NAV_BACK || action === 'exit') {
+      console.log(c.g(t('cli.settingsSaved')));
+      break;
+    }
+
+    if (action === 'lang') {
+      const res = await withNav(() => select({
+        message: t('cli.settingsLanguage'),
+        default: lang,
+        choices: [
+          { name: 'English', value: 'en' },
+          { name: 'Español', value: 'es' },
+          backChoice(t, c),
+        ],
+      }));
+      if (res !== NAV_BACK) {
+        lang = res;
+        try {
+          await writeSettings({ lang });
+        } catch (e) {
+          console.error(c.y(t('cli.langNotSaved', { error: e.message })));
+        }
+      }
+    } else if (action === 'theme') {
+      const res = await withNav(() => select({
+        message: t('cli.settingsTheme'),
+        default: theme,
+        choices: [
+          { name: 'System', value: 'system' },
+          { name: 'Light', value: 'light' },
+          { name: 'Dark', value: 'dark' },
+          backChoice(t, c),
+        ],
+      }));
+      if (res !== NAV_BACK) {
+        theme = res;
+        try {
+          await writeSettings({ theme });
+        } catch (e) {
+          console.error(c.y(t('cli.themeNotSaved', { error: e.message })));
+        }
+      }
+    }
+  }
+}

package/src/cli/index.js

@@ -1,372 +1,15 @@
 #!/usr/bin/env node
-import { select, input, confirm, search } from '@inquirer/prompts';
-import { detectHardware, detectEngines, Tuner, installPlans, runInstall, listPresets, presetsDir, fmtBytes, readSettings, writeSettings, THEMES, PROFILES, DEFAULT_PROFILE, TunerError, checkUpdate, CURRENT_VERSION } from '../core/index.js';
-import { t as translate, LOCALES, errorText } from '../i18n/index.js';
-import { profileChoices, profileNotes, profileSwitchNote, profileEventLines, shouldAskProfile, parseContext } from './profile.js';
+import { routeCli } from './router.js';
 
-const args = parseArgs(process.argv.slice(2));
-let { lang, theme } = await readSettings();
-const t = (key, params) => translate(lang, key, params);
-if ('lang' in args) {
-  if (!LOCALES.includes(args.lang)) {
-    console.error(translate('en', 'errors.unknownLocale', { lang: args.lang ?? '', list: LOCALES.join(', ') }));
-    process.exit(1);
+try {
+  const code = await routeCli(process.argv.slice(2));
+  if (typeof code === 'number' && code !== 0) {
+    process.exit(code);
   }
-  lang = args.lang;
-  try { await writeSettings({ lang }); } catch (e) { console.error(c.y(t('cli.langNotSaved', { error: e.message }))); }
-}
-if ('theme' in args) {
-  if (!THEMES.includes(args.theme)) {
-    console.error(translate(lang, 'errors.unknownTheme', { theme: args.theme ?? '', list: THEMES.join(', ') }));
-    process.exit(1);
-  }
-  theme = args.theme;
-  try { await writeSettings({ theme }); } catch (e) { console.error(c.y(t('cli.themeNotSaved', { error: e.message }))); }
-}
-if ('profile' in args) {
-  if (!PROFILES.includes(args.profile)) {
-    console.error(translate(lang, 'errors.unknownProfile', { profile: args.profile ?? '', list: PROFILES.join(', ') }));
-    process.exit(1);
-  }
-}
-
-const isLight = () => theme === 'light';
-const c = {
-  b: (s) => `\x1b[1m${s}\x1b[0m`,
-  dim: (s) => isLight() ? `\x1b[90m${s}\x1b[0m` : `\x1b[2m${s}\x1b[0m`,
-  g: (s) => isLight() ? `\x1b[38;2;40;138;0m${s}\x1b[0m` : `\x1b[38;2;101;255;0m${s}\x1b[0m`,
-  y: (s) => isLight() ? `\x1b[33m${s}\x1b[0m` : `\x1b[93m${s}\x1b[0m`,
-  r: (s) => isLight() ? `\x1b[38;2;214;21;0m${s}\x1b[0m` : `\x1b[38;2;255;26;0m${s}\x1b[0m`,
-  cyan: (s) => isLight() ? `\x1b[38;2;0;124;153m${s}\x1b[0m` : `\x1b[38;2;0;229;255m${s}\x1b[0m`,
-  purple: (s) => isLight() ? `\x1b[38;2;120;0;199m${s}\x1b[0m` : `\x1b[38;2;154;0;255m${s}\x1b[0m`,
-};
-
-if (args.version) {
-  console.log(CURRENT_VERSION);
-  process.exit(0);
-}
-
-if (args.help) {
-  console.log(t('cli.help', { presetsDir: presetsDir() }));
-  process.exit(0);
-}
-
-if (args.settings) {
-  try {
-    await settingsFlow();
-    process.exit(0);
-  } catch (e) {
-    if (e?.name === 'ExitPromptError') process.exit(130);
-    console.error(c.r(`\n${t('common.error', { message: errorText(lang, e) })}`));
-    process.exit(1);
-  }
-} else if (args.presets) {
-  const list = await listPresets({ engine: args.engine, modelKey: args.model });
-  if (!list.length) console.log(t('cli.noPresets'));
-  for (const p of list) console.log(`${p.engine.padEnd(9)} ${p.model}  ${p.ctx / 1024}K${p.profile ? `  ${p.profile}${p.variant && p.variant !== p.model ? ` (${p.variant})` : ''}` : ''}  KV ${p.kvType}  ${p.fullOffload ? t('candidate.allGpu') : t('cli.partial')}  ${p.shortTps} t/s  ${c.dim(p.createdAt.slice(0, 16).replace('T', ' '))}`);
-} else {
-  main().catch((e) => {
-    if (e?.name === 'ExitPromptError') process.exit(130);
-    console.error(c.r(`\n${t('common.error', { message: errorText(lang, e) })}`));
-    process.exit(1);
-  });
-}
-
-async function settingsFlow() {
-  while (true) {
-    const action = await select({
-      message: t('cli.settingsMenu'),
-      choices: [
-        { name: `${t('cli.settingsLanguage')}: ${lang === 'es' ? 'Español' : 'English'} (${lang})`, value: 'lang' },
-        { name: `${t('cli.settingsTheme')}: ${theme.charAt(0).toUpperCase() + theme.slice(1)}`, value: 'theme' },
-        { name: t('cli.settingsExit'), value: 'exit' },
-      ],
-    });
-
-    if (action === 'lang') {
-      lang = await select({
-        message: t('cli.settingsLanguage'),
-        default: lang,
-        choices: [
-          { name: 'English', value: 'en' },
-          { name: 'Español', value: 'es' },
-        ],
-      });
-      try {
-        await writeSettings({ lang });
-      } catch (e) {
-        console.error(c.y(t('cli.langNotSaved', { error: e.message })));
-      }
-    } else if (action === 'theme') {
-      theme = await select({
-        message: t('cli.settingsTheme'),
-        default: theme,
-        choices: [
-          { name: 'System', value: 'system' },
-          { name: 'Light', value: 'light' },
-          { name: 'Dark', value: 'dark' },
-        ],
-      });
-      try {
-        await writeSettings({ theme });
-      } catch (e) {
-        console.error(c.y(t('cli.themeNotSaved', { error: e.message })));
-      }
-    } else if (action === 'exit') {
-      console.log(c.g(t('cli.settingsSaved')));
-      break;
-    }
-  }
-}
-
-async function main() {
-  const updatePromise = checkUpdate().catch(() => null);
-  const isTTY = Boolean(process.stdout.isTTY && !args.json);
-  let lastProgress = null;
-  let lastTelemetry = null;
-  let liveActive = false;
-
-  const clearLive = () => {
-    if (isTTY && liveActive) {
-      process.stdout.write('\r\x1b[K');
-      liveActive = false;
-    }
-  };
-
-  const renderLive = () => {
-    if (!isTTY || !lastProgress) return;
-    const pct = Math.min(100, Math.max(0, lastProgress.pct ?? 0));
-    const barLen = 16;
-    const filled = Math.round((pct / 100) * barLen);
-    const bar = c.cyan('━'.repeat(filled)) + c.dim('─'.repeat(barLen - filled));
-
-    let telem = '';
-    if (lastTelemetry) {
-      if (lastTelemetry.cpu) telem += ` · CPU ${lastTelemetry.cpu.percent}%`;
-      if (lastTelemetry.ram) {
-        telem += ` · RAM ${(lastTelemetry.ram.usedBytes / 1024 ** 3).toFixed(1)}/${(lastTelemetry.ram.totalBytes / 1024 ** 3).toFixed(1)} GB`;
-      }
-      if (lastTelemetry.gpus?.length) {
-        telem += ' · ' + lastTelemetry.gpus.map((g) => `GPU${g.index} ${(g.usedBytes / 1024 ** 3).toFixed(1)}/${(g.totalBytes / 1024 ** 3).toFixed(1)} GB`).join(' ');
-      }
-    }
-
-    process.stdout.write(`\r\x1b[K  [${bar}] ${String(pct).padStart(3)}%${telem}`);
-    liveActive = true;
-  };
-
-  const out = (...a) => {
-    if (args.json) return;
-    clearLive();
-    console.log(...a);
-  };
-  out([
-    '',
-    `  ${c.cyan('  ╭───')}${c.dim('╷ ╷ ╷')}${c.cyan('───╮')}`,
-    `  ${c.cyan('╭─┤  ')}${c.cyan('┌───┐')}${c.cyan('  ├─╮  ')}${c.b('LLM Tuner')}`,
-    `  ${c.cyan('│ ')}${c.dim('╶┤')}${c.b(' │ █ │ ')}${c.dim('├╴')}${c.cyan('▲ │  ')}${c.dim(t('web.tagline'))}`,
-    `  ${c.cyan('╰─┤  ')}${c.cyan('└───┘')}${c.cyan('  ├──╯')}`,
-    `  ${c.cyan('  ╰───')}${c.dim('╵ ╵ ╵')}${c.cyan('───╯')}`,
-    '',
-  ].join('\n'));
-
-  const updateInfo = await updatePromise;
-  if (updateInfo?.updateAvailable) {
-    out(c.y(`  ▲ ${t('cli.updateAvailable', { current: updateInfo.currentVersion, latest: updateInfo.latestVersion })}`));
-    out(c.dim(`    ${t('cli.updateCommand', { cmd: 'npm install -g llm-tuner' })}\n`));
-  }
-
-  const hw = await detectHardware();
-  out(c.dim(`  ${hw.cpu.brand} · ${fmtBytes(hw.ram.totalBytes)} RAM`));
-  for (const g of hw.gpus) out(c.dim(`  GPU${g.index} ${g.name} · ${fmtBytes(g.totalBytes)}${g.pcieGen ? ` · PCIe ${g.pcieGen}.0 x${g.pcieWidth}` : ''}${g.displayAttached ? t('cli.display') : ''}`));
-  if (!hw.gpus.length) out(c.y(`  ${t('cli.noGpu')}`));
-
-  // 1. Engine
-  let det = await detectEngines(hw);
-  let engineId = args.engine;
-  if (!engineId) {
-    engineId = await select({
-      message: t('cli.whichEngine'),
-      default: det.recommended,
-      choices: det.engines.map((e) => ({
-        name: `${e.name}  ${e.detection.installed ? c.g(t('cli.installed')) + (e.detection.version ? c.dim(' v' + e.detection.version) : '') : c.dim(t('cli.notInstalled'))}${e.id === det.recommended ? c.y(`  ${t('cli.recommended')}`) : ''}`,
-        value: e.id,
-      })),
-    });
-  }
-  if (!det.engines.find((e) => e.id === engineId)?.detection.installed) {
-    await installFlow(engineId);
-    det = await detectEngines(hw);
-    if (!det.engines.find((e) => e.id === engineId).detection.installed) throw new TunerError('errors.installNotFinished');
-  }
-  const tuner = await Tuner.create(engineId);
-
-  // 2. Model
-  let models = await tuner.listModels();
-  if (!models.length) {
-    out(c.y(`\n${t('cli.noModels', { engine: tuner.engine.name })}`));
-    const name = await input({ message: engineId === 'ollama' ? t('cli.downloadOllama') : t('cli.downloadLms') });
-    const bin = tuner.ctx.detection.bin;
-    const r = await runInstall(engineId === 'ollama' ? { cmd: bin, args: ['pull', name] } : { cmd: bin, args: ['get', name, '-y'] }, (l) => out(c.dim('  ' + l)));
-    if (r.code !== 0) throw new TunerError('errors.modelDownloadFailed');
-    models = await tuner.listModels();
-  }
-  const modelKey = args.model || await search({
-    message: t('cli.model'),
-    source: (term) => models
-      .filter((m) => !term || `${m.key} ${m.name}`.toLowerCase().includes(term.toLowerCase()))
-      .map((m) => ({ name: `${m.name}  ${c.dim(`${fmtBytes(m.sizeBytes)}${m.quant ? ' · ' + m.quant : ''}`)}`, value: m.key })),
-  });
-
-  // 3. Context
-  let ctx = parseContext(args.ctx);
-  if (!ctx) {
-    const presets = await listPresets({ engine: engineId, modelKey });
-    const preview = await tuner.plan(modelKey, 8192);
-    const limit = preview.model.meta.trainContext || 131072;
-    const list = Object.entries(preview.maxContext).map(([k, v]) => `KV ${k} ${v ? Math.floor(v / 1024) + 'K' : '—'}`).join(' · ');
-    out(c.dim(`  ${t('cli.maxFullGpu', { list, train: Math.floor(limit / 1024) })}`));
-    if (presets.length) out(c.dim(`  ${t('cli.tunedContexts', { list: presets.map((p) => `${p.ctx / 1024}K (${p.shortTps} t/s)`).join(', ') })}`));
-    const answer = await input({
-      message: t('cli.context'),
-      default: String(presets.at(-1)?.ctx || Math.min(16384, limit)),
-      validate: (v) => parseContext(v, limit) !== null || t('cli.contextRange', { limit }),
-    });
-    ctx = parseContext(answer, limit);
-  }
-
-  // 4. Profile
-  let profile = args.profile;
-  if (!profile && !shouldAskProfile(args)) {
-    profile = DEFAULT_PROFILE; // Non-interactive and fully flagged runs keep the behaviour scripts already rely on.
-  }
-  // The wizard gives the switch advice with its prompt; a profile that comes from a flag gets it with the load events.
-  const advisedByWizard = !profile;
-  if (!profile) {
-    const plan = await tuner.profilePlan(modelKey, ctx);
-    const { profile: stored } = await readSettings();
-    for (const line of profileNotes(plan, t)) {
-      out((line.level === 'warn' ? c.y : c.dim)(`  ${line.text}`));
-    }
-    profile = await select({
-      message: t('cli.profile'),
-      ...profileChoices(plan, t, { stored, mark: c.y, dim: c.dim }),
-    });
-    try {
-      await writeSettings({ profile });
-    } catch (e) {
-      console.error(c.y(t('cli.profileNotSaved', { error: e.message })));
-    }
-    const switchNote = profileSwitchNote(plan, profile, t, tuner.engine.name);
-    if (switchNote) out(c.dim(`  ${switchNote}`));
-  }
-
-  // 5. Load (preset or benchmark)
-  // Progress event before the current one: a fallback that repeats its reason is not printed twice.
-  let previous = null;
-  tuner.on('progress', (e) => {
-    if (args.json) return;
-    if (e.type === 'telemetry') {
-      lastTelemetry = e;
-      renderLive();
-      return;
-    }
-    if (e.progress) {
-      lastProgress = e.progress;
-    }
-    if (e.type === 'variant-picked' || e.type === 'profile-fallback') {
-      for (const line of profileEventLines(e, previous, t, advisedByWizard ? null : tuner.engine.name)) {
-        out((line.level === 'warn' ? c.y : c.dim)(`  ${line.text}`));
-      }
-    }
-    previous = e;
-    if (e.type === 'status') out(c.dim(`\n${t(e.code, e.params)}`));
-    if (e.type === 'preset-hit') out(c.g(`\n✓ ${t('cli.presetHit', { date: e.preset.createdAt.slice(0, 10), config: describe(e.preset.candidate), tps: e.preset.bench.short.genTps })}`));
-    if (e.type === 'candidate-start') out(`  [${e.index + 1}/${e.total}] ${describe(e.candidate)}`);
-    if (e.type === 'bench-progress' && e.phase === 'deep') out(c.dim(`      ${t('common.longPrompt', { tokens: e.promptTokens })}`));
-    if (e.type === 'candidate-done') {
-      const b = e.bench;
-      out(b.ok ? `      ${c.g('✓')} ${t('cli.benchShort', { tps: c.b(b.short.genTps + ' t/s') })}${b.deep ? t('cli.benchDeep', { tps: c.b(b.deep.genTps + ' t/s'), tokens: b.deep.promptTokens }) : ''} · CPU ${b.cpu.avg}% · VRAM ${vramStr(b.vramPeakBytes)}` : c.r(`      ✗ ${benchErrorText(b)}`));
-    }
-    if (e.type === 'preset-saved') out(c.g(`\n✓ ${t('common.presetSaved', { file: e.file })}`));
-
-    renderLive();
-  });
-
-  let result;
-  try {
-    result = await tuner.load(modelKey, ctx, {
-      profile,
-      force: !!args.force,
-      dryRun: !!args['dry-run'],
-      maxCandidates: Number(args.candidates) || 3,
-      confirmApply: async (preview) => {
-        clearLive();
-        out(c.b(`\n${t('cli.changes')}`));
-        if (engineId === 'lmstudio') {
-          preview.files.forEach((f) => out(`  ${f}`));
-          if (preview.restartsApp) out(c.y(`  ${t('cli.lmsRestart')}`));
-        } else {
-          out(`  ${t('cli.ollamaNewModel', { name: c.b(preview.tunedModel) })}`);
-          out(`  ${t('cli.ollamaServer', { env: Object.entries(preview.env).map(([k, v]) => `${k}=${v}`).join(' ') })}`);
-        }
-        return args.yes || confirm({ message: t('cli.confirmApply'), default: true });
-      },
-    });
-  } finally {
-    clearLive();
-  }
-
-  if (args['dry-run']) out(c.y(`\n${t('cli.dryRun')}`));
-  if (result.applied?.backups?.length) out(c.dim(`  ${t('common.backups', { list: result.applied.backups.join(', ') })}`));
-  if (result.applied?.pendingCommands?.length) {
-    out(c.y(`\n${t('cli.pending')}`));
-    result.applied.pendingCommands.forEach((cmd) => out(`  ${cmd}`));
-  }
-  const l = result.loaded;
-  if (l) out(l.ok
-    ? c.g(`\n✓ ${t('cli.loaded', { engine: tuner.engine.name, tps: c.b(l.short.genTps + ' t/s') })}${l.model ? t('cli.usesModel', { model: l.model }) : ''}`)
-    : c.r(`\n✗ ${t('cli.loadFailed', { error: benchErrorText(l) })}`));
-  if (args.json) console.log(JSON.stringify(result, null, 2));
-}
-
-async function installFlow(engineId) {
-  const plans = await installPlans(engineId);
-  if (!plans.length) throw new TunerError('errors.noInstaller');
-  const plan = plans.length === 1 ? plans[0] : await select({ message: t('cli.installMethod'), choices: plans.map((p) => ({ name: t(p.labelCode), value: p })) });
-  console.log(c.dim(`  ${plan.shell || (plan.cmd ? [plan.cmd, ...plan.args].join(' ') : plan.url)}`));
-  if (!args.yes && !(await confirm({ message: t('cli.installNow'), default: true }))) process.exit(0);
-  const r = await runInstall(plan, (l) => console.log(c.dim('  ' + l)));
-  if (r.manual) await input({ message: t('cli.installManual') });
-  else if (r.code !== 0) throw new TunerError('errors.installerExit', { code: r.code });
-}
-
-function describe(cand) {
-  const where = cand.fullOffload ? t('candidate.allGpu') : t('candidate.layersGpu', { gpu: cand.gpuLayers, total: cand.totalLayers });
-  return `KV ${cand.kvType} · ${where}${cand.cpuMoeLayers ? t('candidate.expertsRam', { layers: cand.cpuMoeLayers }) : ''}${t('candidate.threads', { n: cand.threads })}${cand.probe ? t('candidate.probe') : ''}`;
-}
-
-function benchErrorText(b) {
-  return b.errorCode ? t(b.errorCode, b.errorParams) : b.error;
-}
-
-function vramStr(peaks = {}) {
-  const e = Object.entries(peaks || {});
-  return e.length ? e.map(([i, b]) => `GPU${i} ${(b / 1024 ** 3).toFixed(1)} GB`).join(' / ') : t('common.na');
-}
-
-function parseArgs(argv) {
-  const flags = new Set(['help', 'version', 'yes', 'dry-run', 'json', 'force', 'presets', 'settings']);
-  const o = {};
-  for (let i = 0; i < argv.length; i++) {
-    const a = argv[i];
-    if (a === '-h') o.help = true;
-    if (a === '-v') o.version = true;
-    if (a === '/settings' || a === '/setting' || a === 'settings') o.settings = true;
-    if (!a.startsWith('--')) continue;
-    const k = a.slice(2);
-    if (k === 'setting') { o.settings = true; continue; }
-    o[k] = flags.has(k) ? true : argv[++i];
+} catch (e) {
+  if (e?.name === 'ExitPromptError') {
+    process.exit(130);
   }
-  return o;
+  console.error(`\nError: ${e.message || e}`);
+  process.exit(1);
 }

package/src/cli/nav.js

@@ -0,0 +1,82 @@
+import { CancelPromptError } from '@inquirer/core';
+
+export const NAV_BACK = Symbol('NAV_BACK');
+
+export function isNavBack(val) {
+  return val === NAV_BACK;
+}
+
+export function backChoice(t, c) {
+  const label = t ? t('common.back') : 'Back';
+  const text = `← ${label} (Backspace)`;
+  return {
+    name: c ? c.dim(text) : text,
+    value: NAV_BACK,
+  };
+}
+
+/**
+ * Runs an Inquirer prompt with keyboard navigation support (Backspace / Escape to go back).
+ * If the user presses Backspace or Escape, or if the prompt is cancelled, returns NAV_BACK.
+ *
+ * @param {Function} promptFactory - Function that creates and returns an Inquirer prompt promise.
+ * @param {Object} [options]
+ * @param {boolean} [options.allowBack=true] - Whether Backspace/Escape triggers NAV_BACK.
+ * @param {boolean} [options.isTextInput=false] - For text inputs, only empty input triggers back on Backspace.
+ * @param {Function} [options.getInputValue] - Getter returning current input text buffer.
+ */
+export async function withNav(promptFactory, options = {}) {
+  const { allowBack = true, isTextInput = false, getInputValue } = options;
+
+  if (!allowBack || !process.stdin.isTTY) {
+    try {
+      const res = await promptFactory();
+      return res;
+    } catch (e) {
+      if (e?.name === 'CancelPromptError') return NAV_BACK;
+      throw e;
+    }
+  }
+
+  let promptPromise = null;
+  let triggeredBack = false;
+
+  const onKeypress = (ch, key) => {
+    if (!key) return;
+    const isBackKey = key.name === 'backspace' || ch === '\x08' || ch === '\x7f';
+    const isEscKey = key.name === 'escape';
+
+    if (isEscKey) {
+      triggeredBack = true;
+      promptPromise?.cancel?.();
+      return;
+    }
+
+    if (isBackKey) {
+      if (isTextInput && typeof getInputValue === 'function') {
+        const currentVal = getInputValue();
+        if (currentVal && currentVal.length > 0) {
+          // User is deleting characters in text input
+          return;
+        }
+      }
+      triggeredBack = true;
+      promptPromise?.cancel?.();
+    }
+  };
+
+  process.stdin.on('keypress', onKeypress);
+
+  try {
+    promptPromise = promptFactory();
+    const result = await promptPromise;
+    return result;
+  } catch (err) {
+    if (triggeredBack || err?.name === 'CancelPromptError') {
+      return NAV_BACK;
+    }
+    throw err;
+  } finally {
+    process.stdin.removeListener('keypress', onKeypress);
+  }
+}