@steipete/oracle 0.8.6 → 0.10.0

package/dist/src/cli/sessionRunner.js

@@ -1,28 +1,28 @@
-import kleur from 'kleur';
-import fs from 'node:fs/promises';
-import path from 'node:path';
-import { runOracle, OracleResponseError, OracleTransportError, extractResponseMetadata, asOracleUserError, extractTextOutput, } from '../oracle.js';
-import { runBrowserSessionExecution } from '../browser/sessionRunner.js';
-import { renderMarkdownAnsi } from './markdownRenderer.js';
-import { formatResponseMetadata, formatTransportMetadata } from './sessionDisplay.js';
-import { markErrorLogged } from './errorUtils.js';
-import { sendSessionNotification, deriveNotificationSettingsFromMetadata, } from './notifier.js';
-import { sessionStore } from '../sessionStore.js';
-import { wait } from '../sessionManager.js';
-import { runMultiModelApiSession } from '../oracle/multiModelRunner.js';
-import { MODEL_CONFIGS, DEFAULT_SYSTEM_PROMPT } from '../oracle/config.js';
-import { isKnownModel } from '../oracle/modelResolver.js';
-import { resolveModelConfig } from '../oracle/modelResolver.js';
-import { buildPrompt, buildRequestBody } from '../oracle/request.js';
-import { estimateRequestTokens } from '../oracle/tokenEstimate.js';
-import { formatTokenEstimate, formatTokenValue } from '../oracle/runUtils.js';
-import { formatFinishLine } from '../oracle/finishLine.js';
-import { sanitizeOscProgress } from './oscUtils.js';
-import { readFiles } from '../oracle/files.js';
-import { cwd as getCwd } from 'node:process';
-import { resumeBrowserSession } from '../browser/reattach.js';
-import { estimateTokenCount } from '../browser/utils.js';
-import { formatElapsed } from '../oracle/format.js';
+import kleur from "kleur";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { runOracle, OracleResponseError, OracleTransportError, extractResponseMetadata, asOracleUserError, extractTextOutput, } from "../oracle.js";
+import { runBrowserSessionExecution, } from "../browser/sessionRunner.js";
+import { renderMarkdownAnsi } from "./markdownRenderer.js";
+import { formatResponseMetadata, formatTransportMetadata } from "./sessionDisplay.js";
+import { markErrorLogged } from "./errorUtils.js";
+import { sendSessionNotification, deriveNotificationSettingsFromMetadata, } from "./notifier.js";
+import { sessionStore } from "../sessionStore.js";
+import { wait } from "../sessionManager.js";
+import { runMultiModelApiSession } from "../oracle/multiModelRunner.js";
+import { MODEL_CONFIGS, DEFAULT_SYSTEM_PROMPT } from "../oracle/config.js";
+import { isKnownModel } from "../oracle/modelResolver.js";
+import { resolveModelConfig } from "../oracle/modelResolver.js";
+import { buildPrompt, buildRequestBody } from "../oracle/request.js";
+import { estimateRequestTokens } from "../oracle/tokenEstimate.js";
+import { formatTokenEstimate, formatTokenValue } from "../oracle/runUtils.js";
+import { formatFinishLine } from "../oracle/finishLine.js";
+import { sanitizeOscProgress } from "./oscUtils.js";
+import { readFiles } from "../oracle/files.js";
+import { cwd as getCwd } from "node:process";
+import { resumeBrowserSession } from "../browser/reattach.js";
+import { estimateTokenCount } from "../browser/utils.js";
+import { formatElapsed } from "../oracle/format.js";
 const isTty = process.stdout.isTTY;
 const dim = (text) => (isTty ? kleur.dim(text) : text);
 export async function performSessionRun({ sessionMeta, runOptions, mode, browserConfig, cwd, log, write, version, notifications, browserDeps, muteStdout = false, }) {
@@ -32,7 +32,7 @@ export async function performSessionRun({ sessionMeta, runOptions, mode, browser
         return muteStdout ? true : process.stdout.write(chunk);
     };
     await sessionStore.updateSession(sessionMeta.id, {
-        status: 'running',
+        status: "running",
         startedAt: new Date().toISOString(),
         mode,
         ...(browserConfig ? { browser: { config: browserConfig } } : {}),
@@ -40,13 +40,13 @@ export async function performSessionRun({ sessionMeta, runOptions, mode, browser
     const notificationSettings = notifications ?? deriveNotificationSettingsFromMetadata(sessionMeta, process.env);
     const modelForStatus = runOptions.model ?? sessionMeta.model;
     try {
-        if (mode === 'browser') {
+        if (mode === "browser") {
             if (!browserConfig) {
-                throw new Error('Missing browser configuration for session.');
+                throw new Error("Missing browser configuration for session.");
             }
             if (modelForStatus) {
                 await sessionStore.updateModelRun(sessionMeta.id, modelForStatus, {
-                    status: 'running',
+                    status: "running",
                     startedAt: new Date().toISOString(),
                 });
             }
@@ -54,7 +54,7 @@ export async function performSessionRun({ sessionMeta, runOptions, mode, browser
                 ...browserDeps,
                 persistRuntimeHint: async (runtime) => {
                     await sessionStore.updateSession(sessionMeta.id, {
-                        status: 'running',
+                        status: "running",
                         browser: { config: browserConfig, runtime },
                     });
                 },
@@ -62,13 +62,13 @@ export async function performSessionRun({ sessionMeta, runOptions, mode, browser
             const result = await runBrowserSessionExecution({ runOptions, browserConfig, cwd, log }, runnerDeps);
             if (modelForStatus) {
                 await sessionStore.updateModelRun(sessionMeta.id, modelForStatus, {
-                    status: 'completed',
+                    status: "completed",
                     completedAt: new Date().toISOString(),
                     usage: result.usage,
                 });
             }
             await sessionStore.updateSession(sessionMeta.id, {
-                status: 'completed',
+                status: "completed",
                 completedAt: new Date().toISOString(),
                 usage: result.usage,
                 elapsedMs: result.elapsedMs,
@@ -80,7 +80,7 @@ export async function performSessionRun({ sessionMeta, runOptions, mode, browser
                 transport: undefined,
                 error: undefined,
             });
-            await writeAssistantOutput(runOptions.writeOutputPath, result.answerText ?? '', log);
+            await writeAssistantOutput(runOptions.writeOutputPath, result.answerText ?? "", log);
             await sendSessionNotification({
                 sessionId: sessionMeta.id,
                 sessionName: sessionMeta.options?.slug ?? sessionMeta.id,
@@ -95,13 +95,16 @@ export async function performSessionRun({ sessionMeta, runOptions, mode, browser
         if (multiModels.length > 1) {
             const [primaryModel] = multiModels;
             if (!primaryModel) {
-                throw new Error('Missing model name for multi-model run.');
+                throw new Error("Missing model name for multi-model run.");
             }
             const modelConfig = await resolveModelConfig(primaryModel, {
                 baseUrl: runOptions.baseUrl,
                 openRouterApiKey: process.env.OPENROUTER_API_KEY,
             });
-            const files = await readFiles(runOptions.file ?? [], { cwd });
+            const files = await readFiles(runOptions.file ?? [], {
+                cwd,
+                maxFileSizeBytes: runOptions.maxFileSizeBytes,
+            });
             const promptWithFiles = buildPrompt(runOptions.prompt, files, cwd);
             const requestBody = buildRequestBody({
                 modelConfig,
@@ -113,30 +116,30 @@ export async function performSessionRun({ sessionMeta, runOptions, mode, browser
                 storeResponse: runOptions.background,
             });
             const estimatedTokens = estimateRequestTokens(requestBody, modelConfig);
-            const tokenLabel = formatTokenEstimate(estimatedTokens, (text) => (isTty ? kleur.green(text) : text));
-            const filesPhrase = files.length === 0 ? 'no files' : `${files.length} files`;
-            const modelsLabel = multiModels.join(', ');
+            const tokenLabel = formatTokenEstimate(estimatedTokens, (text) => isTty ? kleur.green(text) : text);
+            const filesPhrase = files.length === 0 ? "no files" : `${files.length} files`;
+            const modelsLabel = multiModels.join(", ");
             log(`Calling ${isTty ? kleur.cyan(modelsLabel) : modelsLabel} — ${tokenLabel} tokens, ${filesPhrase}.`);
             const multiRunTips = [];
             if (files.length === 0) {
-                multiRunTips.push('Tip: no files attached — Oracle works best with project context. Add files via --file path/to/code or docs.');
+                multiRunTips.push("Tip: no files attached — Oracle works best with project context. Add files via --file path/to/code or docs.");
             }
             const shortPrompt = (runOptions.prompt?.trim().length ?? 0) < 80;
             if (shortPrompt) {
-                multiRunTips.push('Tip: brief prompts often yield generic answers — aim for 6–30 sentences and attach key files.');
+                multiRunTips.push("Tip: brief prompts often yield generic answers — aim for 6–30 sentences and attach key files.");
             }
             for (const tip of multiRunTips) {
                 log(dim(tip));
             }
             // Surface long-running model expectations up front so users know why a response might lag.
-            const longRunningModels = multiModels.filter((model) => isKnownModel(model) && MODEL_CONFIGS[model]?.reasoning?.effort === 'high');
+            const longRunningModels = multiModels.filter((model) => isKnownModel(model) && MODEL_CONFIGS[model]?.reasoning?.effort === "high");
             if (longRunningModels.length > 0) {
                 for (const model of longRunningModels) {
-                    log('');
+                    log("");
                     const headingLabel = `[${model}]`;
                     log(isTty ? kleur.bold(headingLabel) : headingLabel);
-                    log(dim('This model can take up to 60 minutes (usually replies much faster).'));
-                    log(dim('Press Ctrl+C to cancel.'));
+                    log(dim("This model can take up to 60 minutes (usually replies much faster)."));
+                    log(dim("Press Ctrl+C to cancel."));
                 }
             }
             const shouldStreamInline = !muteStdout && process.stdout.isTTY;
@@ -149,7 +152,7 @@ export async function performSessionRun({ sessionMeta, runOptions, mode, browser
                     return;
                 printedModels.add(model);
                 const body = stripOscProgress(await sessionStore.readModelLog(sessionMeta.id, model));
-                log('');
+                log("");
                 const fallback = answerFallbacks.get(model);
                 const hasBody = body.length > 0;
                 if (!hasBody && !fallback) {
@@ -159,11 +162,11 @@ export async function performSessionRun({ sessionMeta, runOptions, mode, browser
                 const headingLabel = `[${model}]`;
                 const heading = shouldStreamInline ? kleur.bold(headingLabel) : headingLabel;
                 log(heading);
-                const content = hasBody ? body : fallback ?? '';
+                const content = hasBody ? body : (fallback ?? "");
                 const printable = shouldRenderMarkdown ? renderMarkdownAnsi(content) : content;
                 writeInline(printable);
-                if (!printable.endsWith('\n')) {
-                    log('');
+                if (!printable.endsWith("\n")) {
+                    log("");
                 }
             };
             const summary = await runMultiModelApiSession({
@@ -189,7 +192,7 @@ export async function performSessionRun({ sessionMeta, runOptions, mode, browser
                 // If we couldn't stream inline (e.g., non-TTY), print all logs after completion.
                 for (const [index, result] of summary.fulfilled.entries()) {
                     if (index > 0) {
-                        log('');
+                        log("");
                     }
                     await printModelLog(result.model);
                 }
@@ -213,14 +216,18 @@ export async function performSessionRun({ sessionMeta, runOptions, mode, browser
                 reasoning_tokens: aggregateUsage.reasoningTokens,
                 total_tokens: aggregateUsage.totalTokens,
             }, idx))
-                .join('/');
+                .join("/");
             const tokensPart = (() => {
-                const parts = tokensDisplay.split('/');
+                const parts = tokensDisplay.split("/");
                 if (parts.length !== 4)
                     return tokensDisplay;
                 return `↑${parts[0]} ↓${parts[1]} ↻${parts[2]} Δ${parts[3]}`;
             })();
-            const statusColor = summary.rejected.length === 0 ? kleur.green : summary.fulfilled.length > 0 ? kleur.yellow : kleur.red;
+            const statusColor = summary.rejected.length === 0
+                ? kleur.green
+                : summary.fulfilled.length > 0
+                    ? kleur.yellow
+                    : kleur.red;
             const overallText = `${summary.fulfilled.length}/${multiModels.length} models`;
             const { line1 } = formatFinishLine({
                 elapsedMs: summary.elapsedMs,
@@ -231,7 +238,7 @@ export async function performSessionRun({ sessionMeta, runOptions, mode, browser
             log(statusColor(line1));
             const hasFailure = summary.rejected.length > 0;
             await sessionStore.updateSession(sessionMeta.id, {
-                status: hasFailure ? 'error' : 'completed',
+                status: hasFailure ? "error" : "completed",
                 completedAt: new Date().toISOString(),
                 usage: aggregateUsage,
                 elapsedMs: summary.elapsedMs,
@@ -258,7 +265,7 @@ export async function performSessionRun({ sessionMeta, runOptions, mode, browser
                     }
                 }
                 if (savedOutputs.length > 0) {
-                    log(dim('Saved outputs:'));
+                    log(dim("Saved outputs:"));
                     for (const item of savedOutputs) {
                         log(dim(`- ${item.model} -> ${item.path}`));
                     }
@@ -275,7 +282,7 @@ export async function performSessionRun({ sessionMeta, runOptions, mode, browser
             : runOptions;
         if (modelForStatus && singleModelOverride == null) {
             await sessionStore.updateModelRun(sessionMeta.id, modelForStatus, {
-                status: 'running',
+                status: "running",
                 startedAt: new Date().toISOString(),
             });
         }
@@ -285,11 +292,11 @@ export async function performSessionRun({ sessionMeta, runOptions, mode, browser
             write,
             allowStdout: !muteStdout,
         });
-        if (result.mode !== 'live') {
-            throw new Error('Unexpected preview result while running a session.');
+        if (result.mode !== "live") {
+            throw new Error("Unexpected preview result while running a session.");
         }
         await sessionStore.updateSession(sessionMeta.id, {
-            status: 'completed',
+            status: "completed",
             completedAt: new Date().toISOString(),
             usage: result.usage,
             elapsedMs: result.elapsedMs,
@@ -299,7 +306,7 @@ export async function performSessionRun({ sessionMeta, runOptions, mode, browser
         });
         if (modelForStatus && singleModelOverride == null) {
             await sessionStore.updateModelRun(sessionMeta.id, modelForStatus, {
-                status: 'completed',
+                status: "completed",
                 completedAt: new Date().toISOString(),
                 usage: result.usage,
             });
@@ -320,47 +327,53 @@ export async function performSessionRun({ sessionMeta, runOptions, mode, browser
         log(`ERROR: ${message}`);
         markErrorLogged(error);
         const userError = asOracleUserError(error);
-        const connectionLost = userError?.category === 'browser-automation' && userError.details?.stage === 'connection-lost';
-        const assistantTimeout = userError?.category === 'browser-automation' && userError.details?.stage === 'assistant-timeout';
-        if (connectionLost && mode === 'browser') {
-            const runtime = userError.details?.runtime;
-            log(dim('Chrome disconnected before completion; keeping session running for reattach.'));
+        const connectionLost = userError?.category === "browser-automation" &&
+            userError.details?.stage === "connection-lost";
+        const assistantTimeout = userError?.category === "browser-automation" &&
+            userError.details?.stage === "assistant-timeout";
+        const cloudflareChallenge = userError?.category === "browser-automation" &&
+            userError.details?.stage === "cloudflare-challenge";
+        if (connectionLost && mode === "browser") {
+            const runtime = userError.details
+                ?.runtime;
+            log(dim("Chrome disconnected before completion; keeping session running for reattach."));
             if (modelForStatus) {
                 await sessionStore.updateModelRun(sessionMeta.id, modelForStatus, {
-                    status: 'running',
+                    status: "running",
                     completedAt: undefined,
                 });
             }
             await sessionStore.updateSession(sessionMeta.id, {
-                status: 'running',
+                status: "running",
                 errorMessage: message,
                 mode,
                 browser: {
                     config: browserConfig,
                     runtime: runtime ?? sessionMeta.browser?.runtime,
                 },
-                response: { status: 'running', incompleteReason: 'chrome-disconnected' },
+                response: { status: "running", incompleteReason: "chrome-disconnected" },
             });
             return;
         }
-        if (assistantTimeout && mode === 'browser') {
-            const runtime = userError.details?.runtime;
-            log(dim('Assistant response timed out; keeping session running for reattach.'));
+        if (assistantTimeout && mode === "browser") {
+            const runtime = userError.details
+                ?.runtime;
+            log(dim("Assistant response timed out; keeping session running for reattach."));
             if (modelForStatus) {
                 await sessionStore.updateModelRun(sessionMeta.id, modelForStatus, {
-                    status: 'running',
+                    status: "running",
                     completedAt: undefined,
                 });
             }
             await sessionStore.updateSession(sessionMeta.id, {
-                status: 'running',
+                status: "running",
                 errorMessage: message,
                 mode,
                 browser: {
                     config: browserConfig,
                     runtime: runtime ?? sessionMeta.browser?.runtime,
                 },
-                response: { status: 'running', incompleteReason: 'assistant-timeout' },
+                response: { status: "running", incompleteReason: "assistant-timeout" },
             });
             const autoReattachIntervalMs = browserConfig?.autoReattachIntervalMs ?? 0;
             if (autoReattachIntervalMs > 0) {
@@ -381,6 +394,13 @@ export async function performSessionRun({ sessionMeta, runOptions, mode, browser
             log(dim(`Reattach later with: oracle session ${sessionMeta.id}`));
             return;
         }
+        if (cloudflareChallenge && mode === "browser") {
+            const details = userError.details;
+            log(dim("Cloudflare challenge detected; browser left running so you can complete the check."));
+            if (details?.reuseProfileHint) {
+                log(dim(`Reuse this browser profile with: ${details.reuseProfileHint}`));
+            }
+        }
         if (userError) {
             log(dim(`User error (${userError.category}): ${userError.message}`));
         }
@@ -394,12 +414,20 @@ export async function performSessionRun({ sessionMeta, runOptions, mode, browser
         if (transportLine) {
             log(dim(`Transport: ${transportLine}`));
         }
+        const browserRuntime = mode === "browser"
+            ? userError?.details?.runtime
+            : undefined;
         await sessionStore.updateSession(sessionMeta.id, {
-            status: 'error',
+            status: "error",
             completedAt: new Date().toISOString(),
             errorMessage: message,
             mode,
-            browser: browserConfig ? { config: browserConfig } : undefined,
+            browser: browserConfig
+                ? {
+                    config: browserConfig,
+                    runtime: browserRuntime ?? undefined,
+                }
+                : undefined,
             response: responseMetadata,
             transport: transportMetadata,
             error: userError
@@ -412,7 +440,7 @@ export async function performSessionRun({ sessionMeta, runOptions, mode, browser
         });
         if (modelForStatus) {
             await sessionStore.updateModelRun(sessionMeta.id, modelForStatus, {
-                status: 'error',
+                status: "error",
                 completedAt: new Date().toISOString(),
             });
         }
@@ -426,7 +454,7 @@ async function writeAssistantOutput(targetPath, content, log) {
     if (!targetPath)
         return;
     if (!content || content.trim().length === 0) {
-        log(dim('write-output skipped: no assistant content to save.'));
+        log(dim("write-output skipped: no assistant content to save."));
         return;
     }
     const normalizedTarget = path.resolve(targetPath);
@@ -438,8 +466,8 @@ async function writeAssistantOutput(targetPath, content, log) {
     }
     try {
         await fs.mkdir(path.dirname(normalizedTarget), { recursive: true });
-        const payload = content.endsWith('\n') ? content : `${content}\n`;
-        await fs.writeFile(normalizedTarget, payload, 'utf8');
+        const payload = content.endsWith("\n") ? content : `${content}\n`;
+        await fs.writeFile(normalizedTarget, payload, "utf8");
         log(dim(`Saved assistant output to ${normalizedTarget}`));
         return normalizedTarget;
     }
@@ -450,8 +478,8 @@ async function writeAssistantOutput(targetPath, content, log) {
             if (fallbackPath) {
                 try {
                     await fs.mkdir(path.dirname(fallbackPath), { recursive: true });
-                    const payload = content.endsWith('\n') ? content : `${content}\n`;
-                    await fs.writeFile(fallbackPath, payload, 'utf8');
+                    const payload = content.endsWith("\n") ? content : `${content}\n`;
+                    await fs.writeFile(fallbackPath, payload, "utf8");
                     log(dim(`write-output fallback to ${fallbackPath} (original failed: ${reason})`));
                     return fallbackPath;
                 }
@@ -467,7 +495,7 @@ async function writeAssistantOutput(targetPath, content, log) {
 }
 async function autoReattachUntilComplete({ sessionMeta, runtime, browserConfig, runOptions, modelForStatus, notificationSettings, log, }) {
     if (!runtime || !browserConfig) {
-        log(dim('Auto-reattach disabled: missing runtime or browser config.'));
+        log(dim("Auto-reattach disabled: missing runtime or browser config."));
         return false;
     }
     const delayMs = Math.max(0, browserConfig.autoReattachDelayMs ?? 0);
@@ -508,16 +536,16 @@ async function autoReattachUntilComplete({ sessionMeta, runtime, browserConfig,
             const result = await resumeBrowserSession(runtime, reattachConfig, logger, {
                 promptPreview: sessionMeta.promptPreview,
             });
-            const answerText = result.answerMarkdown || result.answerText || '';
+            const answerText = result.answerMarkdown || result.answerText || "";
             const outputTokens = estimateTokenCount(answerText);
             const logWriter = sessionStore.createLogWriter(sessionMeta.id);
             logWriter.logLine(`[auto-reattach] captured assistant response on attempt ${attempt}`);
-            logWriter.logLine('Answer:');
+            logWriter.logLine("Answer:");
             logWriter.logLine(answerText);
             logWriter.stream.end();
             if (modelForStatus) {
                 await sessionStore.updateModelRun(sessionMeta.id, modelForStatus, {
-                    status: 'completed',
+                    status: "completed",
                     completedAt: new Date().toISOString(),
                     usage: {
                         inputTokens: 0,
@@ -528,7 +556,7 @@ async function autoReattachUntilComplete({ sessionMeta, runtime, browserConfig,
                 });
             }
             await sessionStore.updateSession(sessionMeta.id, {
-                status: 'completed',
+                status: "completed",
                 completedAt: new Date().toISOString(),
                 usage: {
                     inputTokens: 0,
@@ -540,7 +568,7 @@ async function autoReattachUntilComplete({ sessionMeta, runtime, browserConfig,
                     config: browserConfig,
                     runtime,
                 },
-                response: { status: 'completed' },
+                response: { status: "completed" },
                 error: undefined,
                 transport: undefined,
             });
@@ -548,7 +576,7 @@ async function autoReattachUntilComplete({ sessionMeta, runtime, browserConfig,
             await sendSessionNotification({
                 sessionId: sessionMeta.id,
                 sessionName: sessionMeta.options?.slug ?? sessionMeta.id,
-                mode: sessionMeta.mode ?? 'browser',
+                mode: sessionMeta.mode ?? "browser",
                 model: sessionMeta.model ?? runOptions.model,
                 usage: {
                     inputTokens: 0,
@@ -556,7 +584,7 @@ async function autoReattachUntilComplete({ sessionMeta, runtime, browserConfig,
                 },
                 characters: answerText.length,
             }, notificationSettings, log, answerText.slice(0, 140));
-            log(kleur.green('Auto-reattach succeeded; session marked completed.'));
+            log(kleur.green("Auto-reattach succeeded; session marked completed."));
             return true;
         }
         catch (error) {
@@ -584,7 +612,7 @@ function isPermissionError(error) {
     if (!(error instanceof Error))
         return false;
     const code = error.code;
-    return code === 'EACCES' || code === 'EPERM';
+    return code === "EACCES" || code === "EPERM";
 }
 function buildFallbackPath(original) {
     const ext = path.extname(original);

package/dist/src/cli/sessionTable.js

@@ -1,7 +1,7 @@
-import chalk from 'chalk';
-import kleur from 'kleur';
-import { MODEL_CONFIGS } from '../oracle.js';
-import { estimateUsdCost } from 'tokentally';
+import chalk from "chalk";
+import kleur from "kleur";
+import { MODEL_CONFIGS } from "../oracle.js";
+import { estimateUsdCost } from "tokentally";
 const isRich = (rich) => rich ?? Boolean(process.stdout.isTTY && chalk.level > 0);
 const dim = (text, rich) => (rich ? kleur.dim(text) : text);
 export const STATUS_PAD = 9;
@@ -11,30 +11,31 @@ export const TIMESTAMP_PAD = 19;
 export const CHARS_PAD = 5;
 export const COST_PAD = 7;
 export function formatSessionTableHeader(rich) {
-    const header = `${'Status'.padEnd(STATUS_PAD)} ${'Model'.padEnd(MODEL_PAD)} ${'Mode'.padEnd(MODE_PAD)} ${'Timestamp'.padEnd(TIMESTAMP_PAD)} ${'Chars'.padStart(CHARS_PAD)} ${'Cost'.padStart(COST_PAD)}  Slug`;
+    const header = `${"Status".padEnd(STATUS_PAD)} ${"Model".padEnd(MODEL_PAD)} ${"Mode".padEnd(MODE_PAD)} ${"Timestamp".padEnd(TIMESTAMP_PAD)} ${"Chars".padStart(CHARS_PAD)} ${"Cost".padStart(COST_PAD)}  Slug`;
     return dim(header, isRich(rich));
 }
 export function formatSessionTableRow(meta, options) {
     const rich = isRich(options?.rich);
-    const status = colorStatus(meta.status ?? 'unknown', rich);
-    const modelLabel = (meta.model ?? 'n/a').padEnd(MODEL_PAD);
+    const status = colorStatus(meta.status ?? "unknown", rich);
+    const modelLabel = (meta.model ?? "n/a").padEnd(MODEL_PAD);
     const model = rich ? chalk.white(modelLabel) : modelLabel;
-    const modeLabel = (meta.mode ?? meta.options?.mode ?? 'api').padEnd(MODE_PAD);
+    const modeLabel = (meta.mode ?? meta.options?.mode ?? "api").padEnd(MODE_PAD);
     const mode = rich ? chalk.gray(modeLabel) : modeLabel;
     const timestampLabel = formatTimestampAligned(meta.createdAt).padEnd(TIMESTAMP_PAD);
     const timestamp = rich ? chalk.gray(timestampLabel) : timestampLabel;
     const charsValue = meta.options?.prompt?.length ?? meta.promptPreview?.length ?? 0;
-    const charsRaw = charsValue > 0 ? String(charsValue).padStart(CHARS_PAD) : `${''.padStart(CHARS_PAD - 1)}-`;
+    const charsRaw = charsValue > 0 ? String(charsValue).padStart(CHARS_PAD) : `${"".padStart(CHARS_PAD - 1)}-`;
     const chars = rich ? chalk.gray(charsRaw) : charsRaw;
     const costValue = resolveSessionCost(meta);
-    const costRaw = costValue != null ? formatCostTable(costValue) : `${''.padStart(COST_PAD - 1)}-`;
+    const costRaw = costValue != null ? formatCostTable(costValue) : `${"".padStart(COST_PAD - 1)}-`;
     const cost = rich ? chalk.gray(costRaw) : costRaw;
-    const slug = rich ? chalk.cyan(meta.id) : meta.id;
+    const slugValue = options?.displaySlug ?? meta.id;
+    const slug = rich ? chalk.cyan(slugValue) : slugValue;
     return `${status} ${model} ${mode} ${timestamp} ${chars} ${cost}  ${slug}`;
 }
 export function resolveSessionCost(meta) {
     const mode = meta.mode ?? meta.options?.mode;
-    if (mode === 'browser') {
+    if (mode === "browser") {
         return null;
     }
     if (meta.usage?.cost != null) {
@@ -51,25 +52,28 @@ export function resolveSessionCost(meta) {
     const output = meta.usage.outputTokens ?? 0;
     const cost = estimateUsdCost({
         usage: { inputTokens: input, outputTokens: output },
-        pricing: { inputUsdPerToken: pricing.inputPerToken, outputUsdPerToken: pricing.outputPerToken },
+        pricing: {
+            inputUsdPerToken: pricing.inputPerToken,
+            outputUsdPerToken: pricing.outputPerToken,
+        },
     })?.totalUsd ?? 0;
     return cost > 0 ? cost : null;
 }
 export function formatTimestampAligned(iso) {
     const date = new Date(iso);
-    const locale = 'en-US';
+    const locale = "en-US";
     const opts = {
-        year: 'numeric',
-        month: '2-digit',
-        day: '2-digit',
-        hour: 'numeric',
-        minute: '2-digit',
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+        hour: "numeric",
+        minute: "2-digit",
         second: undefined,
         hour12: true,
     };
     let formatted = date.toLocaleString(locale, opts);
-    formatted = formatted.replace(', ', '  ');
-    return formatted.replace(/(\s)(\d:)/, '$1 $2');
+    formatted = formatted.replace(", ", "  ");
+    return formatted.replace(/(\s)(\d:)/, "$1 $2");
 }
 function formatCostTable(cost) {
     return `$${cost.toFixed(3)}`.padStart(COST_PAD);
@@ -80,11 +84,11 @@ function colorStatus(status, rich) {
         return padded;
     }
     switch (status) {
-        case 'completed':
+        case "completed":
             return chalk.green(padded);
-        case 'error':
+        case "error":
             return chalk.red(padded);
-        case 'running':
+        case "running":
             return chalk.yellow(padded);
         default:
             return padded;

package/dist/src/cli/stdin.js

@@ -0,0 +1,22 @@
+export async function readStdin(stream = process.stdin) {
+    const chunks = [];
+    const maybeTextStream = stream;
+    maybeTextStream.setEncoding?.("utf8");
+    for await (const chunk of stream) {
+        chunks.push(typeof chunk === "string" ? chunk : String(chunk));
+    }
+    return chunks.join("");
+}
+export async function resolveDashPrompt(prompt, stream = process.stdin) {
+    if (prompt !== "-") {
+        return prompt;
+    }
+    if (stream.isTTY) {
+        throw new Error(`"-p -" requires piped input, for example: echo "prompt" | oracle -p -.`);
+    }
+    const stdinPrompt = (await readStdin(stream)).trim();
+    if (!stdinPrompt) {
+        throw new Error(`"-p -" received empty stdin.`);
+    }
+    return stdinPrompt;
+}