@steipete/oracle 0.9.0 → 0.10.0

package/dist/src/cli/dryRun.js

@@ -1,11 +1,11 @@
-import chalk from 'chalk';
-import { MODEL_CONFIGS, TOKENIZER_OPTIONS, DEFAULT_SYSTEM_PROMPT, buildPrompt, readFiles, getFileTokenStats, printFileTokenStats, } from '../oracle.js';
-import { isKnownModel } from '../oracle/modelResolver.js';
-import { assembleBrowserPrompt } from '../browser/prompt.js';
-import { buildTokenEstimateSuffix, formatAttachmentLabel } from '../browser/promptSummary.js';
-import { buildCookiePlan } from '../browser/policies.js';
+import chalk from "chalk";
+import { MODEL_CONFIGS, TOKENIZER_OPTIONS, DEFAULT_SYSTEM_PROMPT, buildPrompt, readFiles, getFileTokenStats, printFileTokenStats, } from "../oracle.js";
+import { isKnownModel } from "../oracle/modelResolver.js";
+import { assembleBrowserPrompt } from "../browser/prompt.js";
+import { buildTokenEstimateSuffix, formatAttachmentLabel } from "../browser/promptSummary.js";
+import { buildCookiePlan } from "../browser/policies.js";
 export async function runDryRunSummary({ engine, runOptions, cwd, version, log, browserConfig, }, deps = {}) {
-    if (engine === 'browser') {
+    if (engine === "browser") {
         await runBrowserDryRun({ runOptions, cwd, version, log, browserConfig }, deps);
         return;
     }
@@ -15,17 +15,19 @@ async function runApiDryRun({ runOptions, cwd, version, log, }, deps) {
     const readFilesImpl = deps.readFilesImpl ?? readFiles;
     const files = await readFilesImpl(runOptions.file ?? [], { cwd });
     const systemPrompt = runOptions.system?.trim() || DEFAULT_SYSTEM_PROMPT;
-    const combinedPrompt = buildPrompt(runOptions.prompt ?? '', files, cwd);
-    const modelConfig = isKnownModel(runOptions.model) ? MODEL_CONFIGS[runOptions.model] : MODEL_CONFIGS['gpt-5.1'];
+    const combinedPrompt = buildPrompt(runOptions.prompt ?? "", files, cwd);
+    const modelConfig = isKnownModel(runOptions.model)
+        ? MODEL_CONFIGS[runOptions.model]
+        : MODEL_CONFIGS["gpt-5.1"];
     const tokenizer = modelConfig.tokenizer;
     const estimatedInputTokens = tokenizer([
-        { role: 'system', content: systemPrompt },
-        { role: 'user', content: combinedPrompt },
+        { role: "system", content: systemPrompt },
+        { role: "user", content: combinedPrompt },
     ], TOKENIZER_OPTIONS);
     const headerLine = `[dry-run] Oracle (${version}) would call ${runOptions.model} with ~${estimatedInputTokens.toLocaleString()} tokens and ${files.length} files.`;
     log(chalk.cyan(headerLine));
     if (files.length === 0) {
-        log(chalk.dim('[dry-run] No files matched the provided --file patterns.'));
+        log(chalk.dim("[dry-run] No files matched the provided --file patterns."));
         return;
     }
     const inputBudget = runOptions.maxInput ?? modelConfig.inputLimit;
@@ -43,8 +45,8 @@ async function runBrowserDryRun({ runOptions, cwd, version, log, browserConfig,
     const suffix = buildTokenEstimateSuffix(artifacts);
     const headerLine = `[dry-run] Oracle (${version}) would launch browser mode (${runOptions.model}) with ~${artifacts.estimatedInputTokens.toLocaleString()} tokens${suffix}.`;
     log(chalk.cyan(headerLine));
-    logBrowserCookieStrategy(browserConfig, log, 'dry-run');
-    logBrowserFileSummary(artifacts, log, 'dry-run');
+    logBrowserCookieStrategy(browserConfig, log, "dry-run");
+    logBrowserFileSummary(artifacts, log, "dry-run");
 }
 function logBrowserCookieStrategy(browserConfig, log, label) {
     if (!browserConfig)
@@ -54,7 +56,9 @@ function logBrowserCookieStrategy(browserConfig, log, label) {
 }
 function logBrowserFileSummary(artifacts, log, label) {
     if (artifacts.attachments.length > 0) {
-        const prefix = artifacts.bundled ? `[${label}] Bundled upload:` : `[${label}] Attachments to upload:`;
+        const prefix = artifacts.bundled
+            ? `[${label}] Bundled upload:`
+            : `[${label}] Attachments to upload:`;
         log(chalk.bold(prefix));
         artifacts.attachments.forEach((attachment) => {
             log(`  • ${formatAttachmentLabel(attachment)}`);
@@ -66,7 +70,7 @@ function logBrowserFileSummary(artifacts, log, label) {
     }
     if (artifacts.inlineFileCount > 0) {
         log(chalk.bold(`[${label}] Inline file content:`));
-        log(`  • ${artifacts.inlineFileCount} file${artifacts.inlineFileCount === 1 ? '' : 's'} pasted directly into the composer.`);
+        log(`  • ${artifacts.inlineFileCount} file${artifacts.inlineFileCount === 1 ? "" : "s"} pasted directly into the composer.`);
         return;
     }
     log(chalk.dim(`[${label}] No files attached.`));
@@ -77,8 +81,8 @@ export async function runBrowserPreview({ runOptions, cwd, version, previewMode,
     const suffix = buildTokenEstimateSuffix(artifacts);
     const headerLine = `[preview] Oracle (${version}) browser mode (${runOptions.model}) with ~${artifacts.estimatedInputTokens.toLocaleString()} tokens${suffix}.`;
     log(chalk.cyan(headerLine));
-    logBrowserFileSummary(artifacts, log, 'preview');
-    if (previewMode === 'json' || previewMode === 'full') {
+    logBrowserFileSummary(artifacts, log, "preview");
+    if (previewMode === "json" || previewMode === "full") {
         const attachmentSummary = artifacts.attachments.map((attachment) => ({
             path: attachment.path,
             displayPath: attachment.displayPath,
@@ -86,20 +90,20 @@ export async function runBrowserPreview({ runOptions, cwd, version, previewMode,
         }));
         const previewPayload = {
             model: runOptions.model,
-            engine: 'browser',
+            engine: "browser",
             composerText: artifacts.composerText,
             attachments: attachmentSummary,
             inlineFileCount: artifacts.inlineFileCount,
             bundled: artifacts.bundled,
             tokenEstimate: artifacts.estimatedInputTokens,
         };
-        log('');
-        log(chalk.bold('Preview JSON'));
+        log("");
+        log(chalk.bold("Preview JSON"));
         log(JSON.stringify(previewPayload, null, 2));
     }
-    if (previewMode === 'full') {
-        log('');
-        log(chalk.bold('Composer Text'));
-        log(artifacts.composerText || chalk.dim('(empty prompt)'));
+    if (previewMode === "full") {
+        log("");
+        log(chalk.bold("Composer Text"));
+        log(artifacts.composerText || chalk.dim("(empty prompt)"));
     }
 }

package/dist/src/cli/duplicatePromptGuard.js

@@ -1,12 +1,12 @@
-import chalk from 'chalk';
+import chalk from "chalk";
 export async function shouldBlockDuplicatePrompt({ prompt, force, sessionStore, log = console.log, }) {
     if (force)
         return false;
     const normalized = prompt?.trim();
     if (!normalized)
         return false;
-    const running = (await sessionStore.listSessions()).filter((entry) => entry.status === 'running');
-    const duplicate = running.find((entry) => (entry.options?.prompt?.trim?.() ?? '') === normalized);
+    const running = (await sessionStore.listSessions()).filter((entry) => entry.status === "running");
+    const duplicate = running.find((entry) => (entry.options?.prompt?.trim?.() ?? "") === normalized);
     if (!duplicate)
         return false;
     log(chalk.yellow(`A session with the same prompt is already running (${duplicate.id}). Reattach with "oracle session ${duplicate.id}" or rerun with --force to start another run.`));

package/dist/src/cli/engine.js

@@ -1,7 +1,7 @@
-import { isProModel } from '../oracle/modelResolver.js';
+import { isProModel } from "../oracle/modelResolver.js";
 export function defaultWaitPreference(model, engine) {
     // Pro-class API runs can take a long time; prefer non-blocking unless explicitly overridden.
-    if (engine === 'api' && isProModel(model)) {
+    if (engine === "api" && isProModel(model)) {
         return false;
     }
     return true; // browser or non-pro models are fast enough to block by default
@@ -17,7 +17,7 @@ export function defaultWaitPreference(model, engine) {
  */
 export function resolveEngine({ engine, browserFlag, env, }) {
     if (browserFlag) {
-        return 'browser';
+        return "browser";
     }
     if (engine) {
         return engine;
@@ -26,16 +26,16 @@ export function resolveEngine({ engine, browserFlag, env, }) {
     if (envEngine) {
         return envEngine;
     }
-    return env.OPENAI_API_KEY ? 'api' : 'browser';
+    return env.OPENAI_API_KEY ? "api" : "browser";
 }
 function normalizeEngineMode(raw) {
-    if (typeof raw !== 'string') {
+    if (typeof raw !== "string") {
         return null;
     }
     const normalized = raw.trim().toLowerCase();
-    if (normalized === 'api')
-        return 'api';
-    if (normalized === 'browser')
-        return 'browser';
+    if (normalized === "api")
+        return "api";
+    if (normalized === "browser")
+        return "browser";
     return null;
 }

package/dist/src/cli/errorUtils.js

@@ -1,4 +1,4 @@
-const LOGGED_SYMBOL = Symbol('oracle.alreadyLogged');
+const LOGGED_SYMBOL = Symbol("oracle.alreadyLogged");
 export function markErrorLogged(error) {
     if (error instanceof Error) {
         error[LOGGED_SYMBOL] = true;

package/dist/src/cli/fileSize.js

@@ -1,11 +1,11 @@
-import { normalizeMaxFileSizeBytes } from '../oracle/files.js';
+import { normalizeMaxFileSizeBytes } from "../oracle/files.js";
 export function resolveConfiguredMaxFileSizeBytes(userConfig, env = process.env) {
     const envValue = env.ORACLE_MAX_FILE_SIZE_BYTES?.trim();
     if (envValue) {
-        return normalizeMaxFileSizeBytes(envValue, 'ORACLE_MAX_FILE_SIZE_BYTES');
+        return normalizeMaxFileSizeBytes(envValue, "ORACLE_MAX_FILE_SIZE_BYTES");
     }
     if (userConfig?.maxFileSizeBytes !== undefined) {
-        return normalizeMaxFileSizeBytes(userConfig.maxFileSizeBytes, 'config.maxFileSizeBytes');
+        return normalizeMaxFileSizeBytes(userConfig.maxFileSizeBytes, "config.maxFileSizeBytes");
     }
     return undefined;
 }

package/dist/src/cli/format.js

@@ -1,8 +1,8 @@
 export function formatCompactNumber(value) {
     if (Number.isNaN(value) || !Number.isFinite(value))
-        return '0';
+        return "0";
     const abs = Math.abs(value);
-    const stripTrailingZero = (text) => text.replace(/\.0$/, '');
+    const stripTrailingZero = (text) => text.replace(/\.0$/, "");
     if (abs >= 1_000_000) {
         return `${stripTrailingZero((value / 1_000_000).toFixed(1))}m`;
     }

package/dist/src/cli/help.js

@@ -1,4 +1,4 @@
-import kleur from 'kleur';
+import kleur from "kleur";
 const createColorWrapper = (isTty) => (styler) => (text) => isTty ? styler(text) : text;
 export function applyHelpStyling(program, version, isTty) {
     const wrap = createColorWrapper(isTty);
@@ -34,44 +34,44 @@ export function applyHelpStyling(program, version, isTty) {
             return colors.argument(text);
         },
     });
-    program.addHelpText('beforeAll', () => renderHelpBanner(version, colors));
-    program.addHelpText('after', () => renderHelpFooter(program, colors));
+    program.addHelpText("beforeAll", () => renderHelpBanner(version, colors));
+    program.addHelpText("after", () => renderHelpFooter(program, colors));
 }
 function renderHelpBanner(version, colors) {
-    const subtitle = 'Prompt + files required — GPT-5.4 Pro/GPT-5.4 for tough questions with code/file context.';
+    const subtitle = "Prompt + files required — GPT-5.5 Pro/GPT-5.5 for tough questions with code/file context.";
     return `${colors.banner(`Oracle CLI v${version}`)} ${colors.subtitle(`— ${subtitle}`)}\n`;
 }
 function renderHelpFooter(program, colors) {
     const tips = [
-        `${colors.bullet('•')} Required: always pass a prompt AND ${colors.accent('--file …')} (directories/globs are fine); Oracle cannot see your project otherwise.`,
-        `${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('•')} Spell out the project + platform + version requirements (repo name, target OS/toolchain versions, API dependencies) so Oracle doesn’t guess defaults.`,
-        `${colors.bullet('•')} When comparing multiple repos/files, spell out each repo + path + role (e.g., “Project A SettingsView → apps/project-a/Sources/SettingsView.swift; Project B SettingsView → ../project-b/mac/...”) so the model knows exactly which file is which.`,
-        `${colors.bullet('•')} Best results: 6–30 sentences plus key source files; very short prompts often yield generic answers.`,
-        `${colors.bullet('•')} Oracle is one-shot by default. For OpenAI/Azure API runs, you can chain follow-ups by passing ${colors.accent('--followup <sessionId|responseId>')} (continues via Responses API previous_response_id).`,
-        `${colors.bullet('•')} Run ${colors.accent('--files-report')} to inspect token spend before hitting the API.`,
-        `${colors.bullet('•')} Non-preview runs spawn detached sessions (especially gpt-5.4-pro API). If the CLI times out, do not re-run — reattach with ${colors.accent('oracle session <slug>')} to resume/inspect the existing run.`,
-        `${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.`,
-        `${colors.bullet('•')} If any Oracle session is already running, do not start new API runs. Attach to the existing browser session instead; only trigger API calls when you explicitly mean to.`,
-        `${colors.bullet('•')} Duplicate prompt guard: if the same prompt is already running, new runs are blocked unless you pass ${colors.accent('--force')}—prefer reattaching instead of spawning duplicates.`,
-    ].join('\n');
+        `${colors.bullet("•")} Required: always pass a prompt AND ${colors.accent("--file …")} (directories/globs are fine); Oracle cannot see your project otherwise.`,
+        `${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("•")} Spell out the project + platform + version requirements (repo name, target OS/toolchain versions, API dependencies) so Oracle doesn’t guess defaults.`,
+        `${colors.bullet("•")} When comparing multiple repos/files, spell out each repo + path + role (e.g., “Project A SettingsView → apps/project-a/Sources/SettingsView.swift; Project B SettingsView → ../project-b/mac/...”) so the model knows exactly which file is which.`,
+        `${colors.bullet("•")} Best results: 6–30 sentences plus key source files; very short prompts often yield generic answers.`,
+        `${colors.bullet("•")} Oracle is one-shot by default. For OpenAI/Azure API runs, you can chain follow-ups by passing ${colors.accent("--followup <sessionId|responseId>")} (continues via Responses API previous_response_id).`,
+        `${colors.bullet("•")} Run ${colors.accent("--files-report")} to inspect token spend before hitting the API.`,
+        `${colors.bullet("•")} Non-preview runs spawn detached sessions (especially gpt-5.5-pro API). If the CLI times out, do not re-run — reattach with ${colors.accent("oracle session <slug>")} to resume/inspect the existing run.`,
+        `${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.`,
+        `${colors.bullet("•")} If any Oracle session is already running, do not start new API runs. Attach to the existing browser session instead; only trigger API calls when you explicitly mean to.`,
+        `${colors.bullet("•")} Duplicate prompt guard: if the same prompt is already running, new runs are blocked unless you pass ${colors.accent("--force")}—prefer reattaching instead of spawning duplicates.`,
+    ].join("\n");
     const formatExample = (command, description) => `${colors.command(`  ${command}`)}\n${colors.muted(`    ${description}`)}`;
     const examples = [
-        formatExample(`${program.name()} --render --copy --prompt "Review the TS data layer for schema drift" --file "src/**/*.ts,*/*.test.ts"`, 'Build the bundle, print it, and copy it for manual paste into ChatGPT.'),
-        formatExample(`${program.name()} --prompt "Cross-check the data layer assumptions" --models gpt-5.2-pro,gemini-3-pro --file "src/**/*.ts"`, 'Run multiple API models in one go and aggregate cost/usage.'),
-        formatExample(`${program.name()} status --hours 72 --limit 50`, 'Show sessions from the last 72h (capped at 50 entries).'),
-        formatExample(`${program.name()} session <sessionId>`, 'Attach to a running/completed session and stream the saved transcript.'),
-        formatExample(`${program.name()} --prompt "Ship review" --slug "release-readiness-audit"`, 'Encourage the model to hand you a 3–5 word slug and pass it along with --slug.'),
-        formatExample(`${program.name()} --prompt "Tabs frozen: compare Project A SettingsView (apps/project-a/Sources/SettingsView.swift) vs Project B SettingsView (../project-b/mac/App/Presentation/Views/SettingsView.swift)" --file apps/project-a/Sources/SettingsView.swift --file ../project-b/mac/App/Presentation/Views/SettingsView.swift`, 'Spell out what each attached file is (repo + path + role) before asking for comparisons so the model knows exactly what it is reading.'),
-    ].join('\n\n');
+        formatExample(`${program.name()} --render --copy --prompt "Review the TS data layer for schema drift" --file "src/**/*.ts,*/*.test.ts"`, "Build the bundle, print it, and copy it for manual paste into ChatGPT."),
+        formatExample(`${program.name()} --prompt "Cross-check the data layer assumptions" --models gpt-5.2-pro,gemini-3-pro --file "src/**/*.ts"`, "Run multiple API models in one go and aggregate cost/usage."),
+        formatExample(`${program.name()} status --hours 72 --limit 50`, "Show sessions from the last 72h (capped at 50 entries)."),
+        formatExample(`${program.name()} session <sessionId>`, "Attach to a running/completed session and stream the saved transcript."),
+        formatExample(`${program.name()} --prompt "Ship review" --slug "release-readiness-audit"`, "Encourage the model to hand you a 3–5 word slug and pass it along with --slug."),
+        formatExample(`${program.name()} --prompt "Tabs frozen: compare Project A SettingsView (apps/project-a/Sources/SettingsView.swift) vs Project B SettingsView (../project-b/mac/App/Presentation/Views/SettingsView.swift)" --file apps/project-a/Sources/SettingsView.swift --file ../project-b/mac/App/Presentation/Views/SettingsView.swift`, "Spell out what each attached file is (repo + path + role) before asking for comparisons so the model knows exactly what it is reading."),
+    ].join("\n\n");
     return `
-${colors.section('Tips')}
+${colors.section("Tips")}
 ${tips}
 
-${colors.section('Examples')}
+${colors.section("Examples")}
 ${examples}
 `;
 }

package/dist/src/cli/hiddenAliases.js

@@ -9,14 +9,14 @@ export function applyHiddenAliases(options, setOptionValue) {
     if (options.include && options.include.length > 0) {
         const mergedFiles = [...(options.file ?? []), ...options.include];
         options.file = mergedFiles;
-        setOptionValue?.('file', mergedFiles);
+        setOptionValue?.("file", mergedFiles);
     }
     if (!options.prompt && options.message) {
         options.prompt = options.message;
-        setOptionValue?.('prompt', options.message);
+        setOptionValue?.("prompt", options.message);
     }
     if (!options.engine && options.mode) {
         options.engine = options.mode;
-        setOptionValue?.('engine', options.mode);
+        setOptionValue?.("engine", options.mode);
     }
 }

package/dist/src/cli/markdownBundle.js

@@ -1,9 +1,9 @@
-import fs from 'node:fs/promises';
-import { DEFAULT_SYSTEM_PROMPT } from '../oracle/config.js';
-import { buildPrompt } from '../oracle/request.js';
-import { createFileSections, readFiles } from '../oracle/files.js';
-import { createFsAdapter } from '../oracle/fsAdapter.js';
-import { buildPromptMarkdown } from '../oracle/promptAssembly.js';
+import fs from "node:fs/promises";
+import { DEFAULT_SYSTEM_PROMPT } from "../oracle/config.js";
+import { buildPrompt } from "../oracle/request.js";
+import { createFileSections, readFiles } from "../oracle/files.js";
+import { createFsAdapter } from "../oracle/fsAdapter.js";
+import { buildPromptMarkdown } from "../oracle/promptAssembly.js";
 export async function buildMarkdownBundle(options, deps = {}) {
     const cwd = deps.cwd ?? process.cwd();
     const fsModule = deps.fs ?? createFsAdapter(fs);
@@ -14,7 +14,7 @@ export async function buildMarkdownBundle(options, deps = {}) {
     });
     const sections = createFileSections(files, cwd);
     const systemPrompt = options.system?.trim() || DEFAULT_SYSTEM_PROMPT;
-    const userPrompt = (options.prompt ?? '').trim();
+    const userPrompt = (options.prompt ?? "").trim();
     const markdown = buildPromptMarkdown(systemPrompt, userPrompt, sections);
     const promptWithFiles = buildPrompt(userPrompt, files, cwd);
     return { markdown, promptWithFiles, systemPrompt, files };

package/dist/src/cli/markdownRenderer.js

@@ -1,17 +1,17 @@
-import chalk from 'chalk';
-import { render as renderMarkdown } from 'markdansi';
-import { bundledLanguages, bundledThemes, createHighlighter, } from 'shiki';
-const DEFAULT_THEME = 'github-dark';
-const HIGHLIGHT_LANGS = ['ts', 'tsx', 'js', 'jsx', 'json', 'swift'];
+import chalk from "chalk";
+import { render as renderMarkdown } from "markdansi";
+import { bundledLanguages, bundledThemes, createHighlighter } from "shiki";
+const DEFAULT_THEME = "github-dark";
+const HIGHLIGHT_LANGS = ["ts", "tsx", "js", "jsx", "json", "swift"];
 const SUPPORTED_LANG_ALIASES = {
-    ts: 'ts',
-    typescript: 'ts',
-    tsx: 'tsx',
-    js: 'js',
-    javascript: 'js',
-    jsx: 'jsx',
-    json: 'json',
-    swift: 'swift',
+    ts: "ts",
+    typescript: "ts",
+    tsx: "tsx",
+    js: "js",
+    javascript: "js",
+    jsx: "jsx",
+    json: "json",
+    swift: "swift",
 };
 const shikiPromise = createHighlighter({
     themes: [bundledThemes[DEFAULT_THEME]],
@@ -70,8 +70,8 @@ function shikiHighlighter(code, lang) {
             const colored = token.color ? chalk.hex(token.color)(token.content) : token.content;
             return styleToken(colored, token.fontStyle);
         })
-            .join(''))
-            .join('\n');
+            .join(""))
+            .join("\n");
     }
     catch {
         return code;