@steipete/oracle 1.0.5 → 1.0.7

package/README.md

@@ -1,4 +1,4 @@
-# oracle — Whispering your tokens to the silicon sage
+# oracle 🧿 — Whispering your tokens to the silicon sage
 
 <p align="center">
   <img src="./README-header.png" alt="Oracle CLI header banner" width="1100">
@@ -85,4 +85,5 @@ pnpm test:coverage
 ---
 
 If you’re looking for an even more powerful context-management tool, check out https://repoprompt.com
+
 Name inspired by: https://ampcode.com/news/oracle

package/dist/bin/oracle-cli.js

@@ -39,7 +39,10 @@ program.hook('preAction', (thisCommand) => {
         thisCommand.setOptionValue('prompt', positional);
     }
     if (shouldRequirePrompt(rawCliArgs, opts)) {
-        throw new Error('Prompt is required. Provide it via --prompt "<text>".');
+        console.log(chalk.yellow('Prompt is required. Provide it via --prompt "<text>" or positional [prompt].'));
+        thisCommand.help({ error: false });
+        process.exitCode = 1;
+        return;
     }
 });
 program

package/dist/src/browser/index.js

@@ -200,6 +200,19 @@ function isWebSocketClosureError(error) {
         message.includes('websocket error') ||
         message.includes('target closed'));
 }
+export function formatThinkingLog(startedAt, now, message, locatorSuffix) {
+    const elapsedMs = now - startedAt;
+    const elapsedText = formatElapsed(elapsedMs);
+    const progress = Math.min(1, elapsedMs / 600_000); // soft target: 10 minutes
+    const barSegments = 10;
+    const filled = Math.round(progress * barSegments);
+    const bar = `${'█'.repeat(filled).padEnd(barSegments, '░')}`;
+    const pct = Math.round(progress * 100)
+        .toString()
+        .padStart(3, ' ');
+    const statusLabel = message ? ` — ${message}` : '';
+    return `[${elapsedText} / ~10m] ${bar} ${pct}%${statusLabel}${locatorSuffix}`;
+}
 function startThinkingStatusMonitor(Runtime, logger, includeDiagnostics = false) {
     let stopped = false;
     let pending = false;
@@ -215,7 +228,6 @@ function startThinkingStatusMonitor(Runtime, logger, includeDiagnostics = false)
             const nextMessage = await readThinkingStatus(Runtime);
             if (nextMessage && nextMessage !== lastMessage) {
                 lastMessage = nextMessage;
-                const elapsedText = formatElapsed(Date.now() - startedAt);
                 let locatorSuffix = '';
                 if (includeDiagnostics) {
                     try {
@@ -226,7 +238,7 @@ function startThinkingStatusMonitor(Runtime, logger, includeDiagnostics = false)
                         locatorSuffix = ' | assistant-turn=error';
                     }
                 }
-                logger(`[${elapsedText} / ~10m] Pro thinking: ${nextMessage}${locatorSuffix}`);
+                logger(formatThinkingLog(startedAt, Date.now(), nextMessage, locatorSuffix));
             }
         }
         catch {

package/dist/src/browser/prompt.js

@@ -1,3 +1,6 @@
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
 import { readFiles, createFileSections, DEFAULT_SYSTEM_PROMPT, MODEL_CONFIGS, TOKENIZER_OPTIONS } from '../oracle.js';
 export async function assembleBrowserPrompt(runOptions, deps = {}) {
     const cwd = deps.cwd ?? process.cwd();
@@ -39,6 +42,25 @@ export async function assembleBrowserPrompt(runOptions, deps = {}) {
             displayPath: section.displayPath,
             sizeBytes: Buffer.byteLength(section.content, 'utf8'),
         }));
+    const MAX_BROWSER_ATTACHMENTS = 10;
+    if (!inlineFiles && attachments.length > MAX_BROWSER_ATTACHMENTS) {
+        const bundleDir = await fs.mkdtemp(path.join(os.tmpdir(), 'oracle-browser-bundle-'));
+        const bundlePath = path.join(bundleDir, 'attachments-bundle.txt');
+        const bundleLines = [];
+        sections.forEach((section) => {
+            bundleLines.push(`### File: ${section.displayPath}`);
+            bundleLines.push(section.content.trimEnd());
+            bundleLines.push('');
+        });
+        const bundleText = `${bundleLines.join('\n').trimEnd()}\n`;
+        await fs.writeFile(bundlePath, bundleText, 'utf8');
+        attachments.length = 0;
+        attachments.push({
+            path: bundlePath,
+            displayPath: 'attachments-bundle.txt',
+            sizeBytes: Buffer.byteLength(bundleText, 'utf8'),
+        });
+    }
     const inlineFileCount = inlineFiles ? sections.length : 0;
     const tokenizer = MODEL_CONFIGS[runOptions.model].tokenizer;
     const tokenizerUserContent = inlineFileCount > 0 && inlineBlock
@@ -52,5 +74,15 @@ export async function assembleBrowserPrompt(runOptions, deps = {}) {
         ? tokenizerMessages
         : [{ role: 'user', content: '' }], TOKENIZER_OPTIONS);
     const tokenEstimateIncludesInlineFiles = inlineFileCount > 0 && Boolean(inlineBlock);
-    return { markdown, composerText, estimatedInputTokens, attachments, inlineFileCount, tokenEstimateIncludesInlineFiles };
+    return {
+        markdown,
+        composerText,
+        estimatedInputTokens,
+        attachments,
+        inlineFileCount,
+        tokenEstimateIncludesInlineFiles,
+        bundled: !inlineFiles && attachments.length === 1 && sections.length > MAX_BROWSER_ATTACHMENTS && attachments[0]?.displayPath
+            ? { originalCount: sections.length, bundlePath: attachments[0].displayPath }
+            : null,
+    };
 }

package/dist/src/browser/sessionRunner.js

@@ -15,6 +15,9 @@ export async function runBrowserSessionExecution({ runOptions, browserConfig, cw
         if (promptArtifacts.attachments.length > 0) {
             const attachmentList = promptArtifacts.attachments.map((attachment) => attachment.displayPath).join(', ');
             log(chalk.dim(`[verbose] Browser attachments: ${attachmentList}`));
+            if (promptArtifacts.bundled) {
+                log(chalk.yellow(`[browser] More than 10 files provided; bundled ${promptArtifacts.bundled.originalCount} files into ${promptArtifacts.bundled.bundlePath} to satisfy ChatGPT upload limits.`));
+            }
         }
         else if (runOptions.file && runOptions.file.length > 0 && runOptions.browserInlineFiles) {
             log(chalk.dim('[verbose] Browser inline file fallback enabled (pasting file contents).'));

package/dist/src/cli/help.js

@@ -43,11 +43,12 @@ function renderHelpBanner(version, colors) {
 }
 function renderHelpFooter(program, colors) {
     const tips = [
-        `${colors.bullet('•')} Attach source files for best results, but keep total input under ~196k tokens.`,
-        `${colors.bullet('•')} The model has no built-in knowledge of your project—open with the architecture, key components, and why you’re asking.`,
+        `${colors.bullet('•')} Attach lots of source (whole directories beat single files) and keep total input under ~196k tokens.`,
+        `${colors.bullet('•')} Oracle starts empty—open with a short project briefing (stack, services, build steps), spell out the question and prior attempts, and why it matters; the more explanation and context you provide, the better the response will be.`,
         `${colors.bullet('•')} Run ${colors.accent('--files-report')} to inspect token spend before hitting the API.`,
         `${colors.bullet('•')} Non-preview runs spawn detached sessions so they keep streaming even if your terminal closes — reattach anytime via ${colors.accent('pnpm oracle session <slug>')}.`,
-        `${colors.bullet('•')} Ask the model for a memorable 3–5 word slug and pass it via ${colors.accent('--slug "<words>"')} to keep session IDs tidy.`,
+        `${colors.bullet('•')} Set a memorable 3–5 word slug via ${colors.accent('--slug "<words>"')} to keep session IDs tidy.`,
+        `${colors.bullet('•')} Finished sessions auto-hide preamble logs when reattached; raw timestamps remain in the saved log file.`,
         `${colors.bullet('•')} Need hidden flags? Run ${colors.accent(`${program.name()} --help --verbose`)} to list search/token/browser overrides.`,
     ].join('\n');
     const formatExample = (command, description) => `${colors.command(`  ${command}`)}\n${colors.muted(`    ${description}`)}`;

package/dist/src/cli/sessionDisplay.js

@@ -51,7 +51,6 @@ export async function attachSession(sessionId, options) {
     }
     const initialStatus = metadata.status;
     if (!options?.suppressMetadata) {
-        console.log(chalk.bold(`Session: ${sessionId}`));
         const reattachLine = buildReattachLine(metadata);
         if (reattachLine) {
             console.log(chalk.blue(reattachLine));
@@ -72,6 +71,13 @@ export async function attachSession(sessionId, options) {
             console.log(dim(`User error: ${userErrorSummary}`));
         }
     }
+    const shouldTrimIntro = initialStatus === 'completed' || initialStatus === 'error';
+    if (shouldTrimIntro) {
+        const fullLog = await readSessionLog(sessionId);
+        const trimmed = trimBeforeFirstAnswer(fullLog);
+        process.stdout.write(trimmed);
+        return;
+    }
     let lastLength = 0;
     const printNew = async () => {
         const text = await readSessionLog(sessionId);
@@ -171,6 +177,14 @@ export function buildReattachLine(metadata) {
     }
     return null;
 }
+export function trimBeforeFirstAnswer(logText) {
+    const marker = 'Answer:';
+    const index = logText.indexOf(marker);
+    if (index === -1) {
+        return logText;
+    }
+    return logText.slice(index);
+}
 function formatRelativeDuration(referenceIso) {
     const timestamp = Date.parse(referenceIso);
     if (Number.isNaN(timestamp)) {

package/dist/src/oracle/run.js

@@ -92,7 +92,11 @@ export async function runOracle(options, deps = {}) {
     logVerbose(`Estimated tokens (prompt + files): ${estimatedInputTokens.toLocaleString()}`);
     const fileCount = files.length;
     const cliVersion = getCliVersion();
-    const headerLine = `Oracle (${cliVersion}) consulting ${modelConfig.model}'s crystal ball with ${estimatedInputTokens.toLocaleString()} tokens and ${fileCount} files...`;
+    const richTty = process.stdout.isTTY && chalk.level > 0;
+    const headerModelLabel = richTty ? chalk.cyan(modelConfig.model) : modelConfig.model;
+    const tokenLabel = richTty ? chalk.green(estimatedInputTokens.toLocaleString()) : estimatedInputTokens.toLocaleString();
+    const fileLabel = richTty ? chalk.magenta(fileCount.toString()) : fileCount.toString();
+    const headerLine = `Oracle (${cliVersion}) consulting ${headerModelLabel}'s crystal ball with ${tokenLabel} tokens and ${fileLabel} files...`;
     const shouldReportFiles = (options.filesReport || fileTokenInfo.totalTokens > inputTokenBudget) && fileTokenInfo.stats.length > 0;
     if (!isPreview) {
         log(headerLine);
@@ -145,6 +149,7 @@ export async function runOracle(options, deps = {}) {
     let answerHeaderPrinted = false;
     const ensureAnswerHeader = () => {
         if (!options.silent && !answerHeaderPrinted) {
+            log('');
             log(chalk.bold('Answer:'));
             answerHeaderPrinted = true;
         }
@@ -325,7 +330,7 @@ async function executeBackgroundResponse(params) {
             isActive: () => heartbeatActive,
             makeMessage: (elapsedMs) => {
                 const elapsedText = formatElapsed(elapsedMs);
-                return `OpenAI background run still in progress — ${elapsedText} elapsed (id=${responseId}).`;
+                return `OpenAI background run still in progress — ${elapsedText} elapsed.`;
             },
         });
     }

package/package.json

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