@steipete/oracle 0.5.2 → 0.5.3

package/README.md

@@ -38,7 +38,7 @@ npx @steipete/oracle status --hours 72
 npx @steipete/oracle session <id> --render
 
 # TUI (interactive, only for humans)
-npx @steipete/oracle
+npx @steipete/oracle tui
 ```
 
 Engine auto-picks API when `OPENAI_API_KEY` is set, otherwise browser; browser is stable on macOS and works on Linux and Windows. On Linux pass `--browser-chrome-path/--browser-cookie-path` if detection fails; on Windows prefer `--browser-manual-login` or inline cookies if decryption is blocked.

package/dist/bin/oracle-cli.js

@@ -49,7 +49,6 @@ const CLI_ENTRYPOINT = fileURLToPath(import.meta.url);
 const rawCliArgs = process.argv.slice(2);
 const userCliArgs = rawCliArgs[0] === CLI_ENTRYPOINT ? rawCliArgs.slice(1) : rawCliArgs;
 const isTty = process.stdout.isTTY;
-const tuiEnabled = () => isTty && process.env.ORACLE_NO_TUI !== '1';
 const program = new Command();
 let introPrinted = false;
 program.hook('preAction', () => {
@@ -66,8 +65,8 @@ program.hook('preAction', (thisCommand) => {
     if (userCliArgs.some((arg) => arg === '--help' || arg === '-h')) {
         return;
     }
-    if (userCliArgs.length === 0 && tuiEnabled()) {
-        // Skip prompt enforcement; runRootCommand will launch the TUI.
+    if (userCliArgs.length === 0) {
+        // Let the root action handle zero-arg entry (help + hint to `oracle tui`).
         return;
     }
     const opts = thisCommand.optsWithGlobals();
@@ -212,6 +211,13 @@ program
         token: commandOptions.token,
     });
 });
+program
+    .command('tui')
+    .description('Launch the interactive terminal UI for humans (no automation).')
+    .action(async () => {
+    await sessionStore.ensureStorage();
+    await launchTui({ version: VERSION, printIntro: false });
+});
 const sessionCommand = program
     .command('session [id]')
     .description('Attach to a stored session or list recent sessions when no ID is provided.')
@@ -422,12 +428,8 @@ async function runRootCommand(options) {
         console.log(chalk.dim(`Remote browser host detected: ${remoteHost}`));
     }
     if (userCliArgs.length === 0) {
-        if (tuiEnabled()) {
-            await launchTui({ version: VERSION, printIntro: false });
-            return;
-        }
-        console.log(chalk.yellow('No prompt or subcommand supplied. See `oracle --help` for usage.'));
-        program.help({ error: false });
+        console.log(chalk.yellow('No prompt or subcommand supplied. Run `oracle --help` or `oracle tui` for the TUI.'));
+        program.outputHelp();
         return;
     }
     const retentionHours = typeof options.retainHours === 'number' ? options.retainHours : undefined;

package/dist/src/cli/tui/index.js

@@ -21,6 +21,8 @@ const PAGE_SIZE = 10;
 export async function launchTui({ version, printIntro = true }) {
     const userConfig = (await loadUserConfig()).config;
     const rich = isTty();
+    let pagingFailures = 0;
+    let exitMessageShown = false;
     if (printIntro) {
         if (rich) {
             console.log(chalk.bold('🧿 oracle'), `${version}`, dim('— Whispering your tokens to the silicon sage'));
@@ -76,15 +78,31 @@ export async function launchTui({ version, printIntro = true }) {
             prompt
                 .then(({ selection: answer }) => resolve(answer))
                 .catch((error) => {
-                console.error(chalk.red('Paging failed; returning to recent list.'), error instanceof Error ? error.message : error);
+                pagingFailures += 1;
+                const message = error instanceof Error ? error.message : String(error);
+                if (message.includes('SIGINT') || message.includes('force closed the prompt')) {
+                    console.log(chalk.green('🧿 Closing the book. See you next prompt.'));
+                    exitMessageShown = true;
+                    resolve('__exit__');
+                    return;
+                }
+                console.error(chalk.red('Paging failed; returning to recent list.'), message);
+                if (message.includes('setRawMode') || message.includes('EIO') || pagingFailures >= 3) {
+                    console.error(chalk.red('Terminal input unavailable; exiting TUI.'), dim('Try `stty sane` then rerun oracle, or use `oracle recent`.'));
+                    resolve('__exit__');
+                    return;
+                }
                 resolve('__reset__');
             });
         });
         if (process.env.ORACLE_DEBUG_TUI === '1') {
             console.error(`[tui] selection=${JSON.stringify(selection)}`);
         }
+        pagingFailures = 0;
         if (selection === '__exit__') {
-            console.log(chalk.green('🧿 Closing the book. See you next prompt.'));
+            if (!exitMessageShown) {
+                console.log(chalk.green('🧿 Closing the book. See you next prompt.'));
+            }
             return;
         }
         if (selection === '__ask__') {
@@ -156,14 +174,26 @@ async function showSessionDetail(sessionId) {
             ...(isRunning ? [{ name: 'Refresh', value: 'refresh' }] : []),
             { name: 'Back', value: 'back' },
         ];
-        const { next } = await inquirer.prompt([
-            {
-                name: 'next',
-                type: 'select',
-                message: 'Actions',
-                choices: actions,
-            },
-        ]);
+        let next;
+        try {
+            ({ next } = await inquirer.prompt([
+                {
+                    name: 'next',
+                    type: 'select',
+                    message: 'Actions',
+                    choices: actions,
+                },
+            ]));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (message.includes('SIGINT') || message.includes('force closed the prompt')) {
+                console.log(chalk.green('🧿 Closing the book. See you next prompt.'));
+                return;
+            }
+            console.error(chalk.red('Paging failed; returning to session list.'), message);
+            return;
+        }
         if (next === 'back') {
             return;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steipete/oracle",
-  "version": "0.5.2",
+  "version": "0.5.3",
   "description": "CLI wrapper around OpenAI Responses API with GPT-5.1 Pro, GPT-5.1, and GPT-5.1 Codex high reasoning modes.",
   "type": "module",
   "main": "dist/bin/oracle-cli.js",