@steipete/oracle 0.9.0 → 0.11.0

package/dist/src/cli/sessionCommand.js

@@ -1,47 +1,77 @@
-import chalk from 'chalk';
-import { usesDefaultStatusFilters } from './options.js';
-import { attachSession, showStatus } from './sessionDisplay.js';
-import { sessionStore } from '../sessionStore.js';
+import chalk from "chalk";
+import { usesDefaultStatusFilters } from "./options.js";
+import { attachSession, showStatus, } from "./sessionDisplay.js";
+import { harvestSessionBrowserOutput, liveTailSessionBrowserOutput, } from "./browserTabs.js";
+import { sessionStore } from "../sessionStore.js";
 const defaultDependencies = {
     showStatus,
     attachSession,
+    harvestSessionBrowserOutput,
+    liveTailSessionBrowserOutput,
     usesDefaultStatusFilters,
     deleteSessionsOlderThan: (options) => sessionStore.deleteOlderThan(options),
     getSessionPaths: (sessionId) => sessionStore.getPaths(sessionId),
 };
-const SESSION_OPTION_KEYS = new Set(['hours', 'limit', 'all', 'clear', 'clean', 'render', 'renderMarkdown', 'path', 'model']);
+const SESSION_OPTION_KEYS = new Set([
+    "hours",
+    "limit",
+    "all",
+    "clear",
+    "clean",
+    "render",
+    "renderMarkdown",
+    "path",
+    "model",
+    "harvest",
+    "live",
+    "writeOutput",
+    "browserTab",
+]);
 export async function handleSessionCommand(sessionId, command, deps = defaultDependencies) {
     const sessionOptions = command.opts();
+    const allOptions = command.optsWithGlobals?.() ?? sessionOptions;
+    const writeOutputPath = sessionOptions.writeOutput ??
+        sessionOptions.writeOutputPath ??
+        allOptions.writeOutput ??
+        allOptions.writeOutputPath ??
+        command.getOptionValue?.("writeOutput") ??
+        command.getOptionValue?.("writeOutputPath");
+    const browserTabRef = sessionOptions.browserTab ??
+        sessionOptions.browserTabRef ??
+        allOptions.browserTab ??
+        allOptions.browserTabRef ??
+        command.getOptionValue?.("browserTab") ??
+        command.getOptionValue?.("browserTabRef");
     if (sessionOptions.verboseRender) {
-        process.env.ORACLE_VERBOSE_RENDER = '1';
+        process.env.ORACLE_VERBOSE_RENDER = "1";
     }
-    const renderSource = command.getOptionValueSource?.('render');
-    const renderMarkdownSource = command.getOptionValueSource?.('renderMarkdown');
-    const renderExplicit = renderSource === 'cli' || renderMarkdownSource === 'cli';
+    const renderSource = command.getOptionValueSource?.("render");
+    const renderMarkdownSource = command.getOptionValueSource?.("renderMarkdown");
+    const renderExplicit = renderSource === "cli" || renderMarkdownSource === "cli";
     const autoRender = !renderExplicit && process.stdout.isTTY;
     const pathRequested = Boolean(sessionOptions.path);
     const clearRequested = Boolean(sessionOptions.clear || sessionOptions.clean);
     if (clearRequested) {
         if (sessionId) {
-            console.error('Cannot combine a session ID with --clear. Remove the ID to delete cached sessions.');
+            console.error("Cannot combine a session ID with --clear. Remove the ID to delete cached sessions.");
             process.exitCode = 1;
             return;
         }
         const hours = sessionOptions.hours;
         const includeAll = sessionOptions.all;
         const result = await deps.deleteSessionsOlderThan({ hours, includeAll });
-        const scope = includeAll ? 'all stored sessions' : `sessions older than ${hours}h`;
+        const scope = includeAll ? "all stored sessions" : `sessions older than ${hours}h`;
         console.log(formatSessionCleanupMessage(result, scope));
         return;
     }
-    if (sessionId === 'clear' || sessionId === 'clean') {
+    if (sessionId === "clear" || sessionId === "clean") {
         console.error('Session cleanup now uses --clear. Run "oracle session --clear --hours <n>" instead.');
         process.exitCode = 1;
         return;
     }
     if (pathRequested) {
         if (!sessionId) {
-            console.error('The --path flag requires a session ID.');
+            console.error("The --path flag requires a session ID.");
             process.exitCode = 1;
             return;
         }
@@ -50,10 +80,10 @@ export async function handleSessionCommand(sessionId, command, deps = defaultDep
             const richTty = Boolean(process.stdout.isTTY && chalk.level > 0);
             const label = (text) => (richTty ? chalk.cyan(text) : text);
             const value = (text) => (richTty ? chalk.dim(text) : text);
-            console.log(`${label('Session dir:')} ${value(paths.dir)}`);
-            console.log(`${label('Metadata:')} ${value(paths.metadata)}`);
-            console.log(`${label('Request:')} ${value(paths.request)}`);
-            console.log(`${label('Log:')} ${value(paths.log)}`);
+            console.log(`${label("Session dir:")} ${value(paths.dir)}`);
+            console.log(`${label("Metadata:")} ${value(paths.metadata)}`);
+            console.log(`${label("Request:")} ${value(paths.request)}`);
+            console.log(`${label("Log:")} ${value(paths.log)}`);
         }
         catch (error) {
             console.error(error instanceof Error ? error.message : String(error));
@@ -61,6 +91,37 @@ export async function handleSessionCommand(sessionId, command, deps = defaultDep
         }
         return;
     }
+    const harvestRequested = Boolean(sessionOptions.harvest);
+    const liveRequested = Boolean(sessionOptions.live);
+    if (harvestRequested && liveRequested) {
+        console.error("Cannot combine --harvest and --live. Choose one.");
+        process.exitCode = 1;
+        return;
+    }
+    if (writeOutputPath && !harvestRequested && !liveRequested) {
+        console.error("The --write-output flag requires --harvest or --live.");
+        process.exitCode = 1;
+        return;
+    }
+    if (harvestRequested || liveRequested) {
+        if (!sessionId) {
+            console.error(`The ${harvestRequested ? "--harvest" : "--live"} flag requires a session ID.`);
+            process.exitCode = 1;
+            return;
+        }
+        if (harvestRequested) {
+            await deps.harvestSessionBrowserOutput(sessionId, {
+                writeOutputPath,
+                browserTabRef,
+            });
+            return;
+        }
+        await deps.liveTailSessionBrowserOutput(sessionId, {
+            writeOutputPath,
+            browserTabRef,
+        });
+        return;
+    }
     if (!sessionId) {
         const showExamples = deps.usesDefaultStatusFilters(command);
         await deps.showStatus({
@@ -75,7 +136,7 @@ export async function handleSessionCommand(sessionId, command, deps = defaultDep
     // Surface any root-level flags that were provided but are ignored when attaching to a session.
     const ignoredFlags = listIgnoredFlags(command);
     if (ignoredFlags.length > 0) {
-        console.log(`Ignoring flags on session attach: ${ignoredFlags.join(', ')}`);
+        console.log(`Ignoring flags on session attach: ${ignoredFlags.join(", ")}`);
     }
     const renderMarkdown = Boolean(sessionOptions.render || sessionOptions.renderMarkdown || autoRender);
     await deps.attachSession(sessionId, {
@@ -85,8 +146,8 @@ export async function handleSessionCommand(sessionId, command, deps = defaultDep
     });
 }
 export function formatSessionCleanupMessage(result, scope) {
-    const deletedLabel = `${result.deleted} ${result.deleted === 1 ? 'session' : 'sessions'}`;
-    const remainingLabel = `${result.remaining} ${result.remaining === 1 ? 'session' : 'sessions'} remain`;
+    const deletedLabel = `${result.deleted} ${result.deleted === 1 ? "session" : "sessions"}`;
+    const remainingLabel = `${result.remaining} ${result.remaining === 1 ? "session" : "sessions"} remain`;
     const hint = 'Run "oracle session --clear --all" to delete everything.';
     return `Deleted ${deletedLabel} (${scope}). ${remainingLabel}.\n${hint}`;
 }
@@ -98,7 +159,7 @@ function listIgnoredFlags(command) {
             continue;
         }
         const source = command.getOptionValueSource?.(key);
-        if (source !== 'cli' && source !== 'env') {
+        if (source !== "cli" && source !== "env") {
             continue;
         }
         const value = opts[key];