@steipete/oracle 0.8.6 → 0.10.0

package/dist/src/cli/options.js

@@ -1,14 +1,17 @@
-import { InvalidArgumentError } from 'commander';
-import { parseDuration } from '../browserMode.js';
-import path from 'node:path';
-import fg from 'fast-glob';
-import { DEFAULT_MODEL, MODEL_CONFIGS } from '../oracle.js';
+import { InvalidArgumentError } from "commander";
+import { parseDuration } from "../browserMode.js";
+import path from "node:path";
+import fg from "fast-glob";
+import { DEFAULT_MODEL, MODEL_CONFIGS } from "../oracle.js";
 export function collectPaths(value, previous = []) {
     if (!value) {
         return previous;
     }
     const nextValues = Array.isArray(value) ? value : [value];
-    return previous.concat(nextValues.flatMap((entry) => entry.split(',')).map((entry) => entry.trim()).filter(Boolean));
+    return previous.concat(nextValues
+        .flatMap((entry) => entry.split(","))
+        .map((entry) => entry.trim())
+        .filter(Boolean));
 }
 /**
  * Merge all path-like CLI inputs (file/include aliases) into a single list, preserving order.
@@ -29,7 +32,7 @@ export function dedupePathInputs(inputs, { cwd = process.cwd() } = {}) {
         if (!raw)
             continue;
         let key = raw;
-        if (!raw.startsWith('!') && !fg.isDynamicPattern(raw)) {
+        if (!raw.startsWith("!") && !fg.isDynamicPattern(raw)) {
             const absolute = path.isAbsolute(raw) ? raw : path.resolve(cwd, raw);
             key = `path:${path.normalize(absolute)}`;
         }
@@ -50,7 +53,7 @@ export function collectModelList(value, previous = []) {
         return previous;
     }
     const entries = value
-        .split(',')
+        .split(",")
         .map((entry) => entry.trim())
         .filter((entry) => entry.length > 0);
     return previous.concat(entries);
@@ -58,7 +61,7 @@ export function collectModelList(value, previous = []) {
 export function parseFloatOption(value) {
     const parsed = Number.parseFloat(value);
     if (Number.isNaN(parsed)) {
-        throw new InvalidArgumentError('Value must be a number.');
+        throw new InvalidArgumentError("Value must be a number.");
     }
     return parsed;
 }
@@ -68,7 +71,7 @@ export function parseIntOption(value) {
     }
     const parsed = Number.parseInt(value, 10);
     if (Number.isNaN(parsed)) {
-        throw new InvalidArgumentError('Value must be an integer.');
+        throw new InvalidArgumentError("Value must be an integer.");
     }
     return parsed;
 }
@@ -76,9 +79,9 @@ export function parseHeartbeatOption(value) {
     if (value == null) {
         return 30;
     }
-    if (typeof value === 'number') {
+    if (typeof value === "number") {
         if (Number.isNaN(value) || value < 0) {
-            throw new InvalidArgumentError('Heartbeat interval must be zero or a positive number.');
+            throw new InvalidArgumentError("Heartbeat interval must be zero or a positive number.");
         }
         return value;
     }
@@ -86,42 +89,42 @@ export function parseHeartbeatOption(value) {
     if (normalized.length === 0) {
         return 30;
     }
-    if (normalized === 'false' || normalized === 'off') {
+    if (normalized === "false" || normalized === "off") {
         return 0;
     }
     const parsed = Number.parseFloat(normalized);
     if (Number.isNaN(parsed) || parsed < 0) {
-        throw new InvalidArgumentError('Heartbeat interval must be zero or a positive number.');
+        throw new InvalidArgumentError("Heartbeat interval must be zero or a positive number.");
     }
     return parsed;
 }
 export function usesDefaultStatusFilters(cmd) {
-    const hoursSource = cmd.getOptionValueSource?.('hours') ?? 'default';
-    const limitSource = cmd.getOptionValueSource?.('limit') ?? 'default';
-    const allSource = cmd.getOptionValueSource?.('all') ?? 'default';
-    return hoursSource === 'default' && limitSource === 'default' && allSource === 'default';
+    const hoursSource = cmd.getOptionValueSource?.("hours") ?? "default";
+    const limitSource = cmd.getOptionValueSource?.("limit") ?? "default";
+    const allSource = cmd.getOptionValueSource?.("all") ?? "default";
+    return hoursSource === "default" && limitSource === "default" && allSource === "default";
 }
 export function resolvePreviewMode(value) {
-    if (typeof value === 'string' && value.length > 0) {
+    if (typeof value === "string" && value.length > 0) {
         return value;
     }
     if (value === true) {
-        return 'summary';
+        return "summary";
     }
     return undefined;
 }
 export function parseSearchOption(value) {
     const normalized = value.trim().toLowerCase();
-    if (['on', 'true', '1', 'yes'].includes(normalized)) {
+    if (["on", "true", "1", "yes"].includes(normalized)) {
         return true;
     }
-    if (['off', 'false', '0', 'no'].includes(normalized)) {
+    if (["off", "false", "0", "no"].includes(normalized)) {
         return false;
     }
     throw new InvalidArgumentError('Search mode must be "on" or "off".');
 }
 export function normalizeModelOption(value) {
-    return (value ?? '').trim();
+    return (value ?? "").trim();
 }
 export function normalizeBaseUrl(value) {
     const trimmed = value?.trim();
@@ -131,8 +134,8 @@ export function parseTimeoutOption(value) {
     if (value == null)
         return undefined;
     const normalized = value.trim().toLowerCase();
-    if (normalized === 'auto')
-        return 'auto';
+    if (normalized === "auto")
+        return "auto";
     const parsed = Number.parseFloat(normalized);
     if (Number.isNaN(parsed) || parsed <= 0) {
         throw new InvalidArgumentError('Timeout must be a positive number of seconds or "auto".');
@@ -152,49 +155,76 @@ export function parseDurationOption(value, label) {
     }
     return parsed;
 }
+function isGeminiDeepThinkAlias(normalized) {
+    return ((normalized.includes("gemini") && normalized.includes("deep")) ||
+        normalized.includes("deep-think") ||
+        normalized.includes("deep_think") ||
+        normalized.includes("deepthink"));
+}
 export function resolveApiModel(modelValue) {
     const normalized = normalizeModelOption(modelValue).toLowerCase();
     if (normalized in MODEL_CONFIGS) {
         return normalized;
     }
-    if (normalized.includes('grok')) {
-        return 'grok-4.1';
+    if (normalized.includes("/")) {
+        return normalized;
+    }
+    if (normalized.includes("grok")) {
+        return "grok-4.1";
+    }
+    if (normalized.includes("claude") && normalized.includes("sonnet")) {
+        return "claude-4.6-sonnet";
+    }
+    if (normalized.includes("claude") && normalized.includes("opus")) {
+        return "claude-4.1-opus";
     }
-    if (normalized.includes('claude') && normalized.includes('sonnet')) {
-        return 'claude-4.5-sonnet';
+    if (normalized.includes("5.5") && normalized.includes("pro")) {
+        return "gpt-5.5-pro";
     }
-    if (normalized.includes('claude') && normalized.includes('opus')) {
-        return 'claude-4.1-opus';
+    if (normalized.includes("5.5")) {
+        return "gpt-5.5";
     }
-    if (normalized === 'claude' || normalized === 'sonnet' || /(^|\b)sonnet(\b|$)/.test(normalized)) {
-        return 'claude-4.5-sonnet';
+    if (normalized.includes("5.4") && normalized.includes("pro")) {
+        return "gpt-5.4-pro";
     }
-    if (normalized === 'opus' || normalized === 'claude-4.1') {
-        return 'claude-4.1-opus';
+    if (normalized.includes("5.4")) {
+        return "gpt-5.4";
     }
-    if (normalized.includes('5.0') || normalized === 'gpt-5-pro' || normalized === 'gpt-5') {
-        return 'gpt-5-pro';
+    if (normalized === "claude" || normalized === "sonnet" || /(^|\b)sonnet(\b|$)/.test(normalized)) {
+        return "claude-4.6-sonnet";
     }
-    if (normalized.includes('5-pro') && !normalized.includes('5.1')) {
-        return 'gpt-5-pro';
+    if (normalized === "opus" || normalized === "claude-4.1") {
+        return "claude-4.1-opus";
     }
-    if (normalized.includes('5.2') && normalized.includes('pro')) {
-        return 'gpt-5.2-pro';
+    if (normalized.includes("5.0") || normalized === "gpt-5-pro" || normalized === "gpt-5") {
+        return "gpt-5-pro";
     }
-    if (normalized.includes('5.1') && normalized.includes('pro')) {
-        return 'gpt-5.1-pro';
+    if (normalized.includes("5-pro") && !normalized.includes("5.1")) {
+        return "gpt-5-pro";
     }
-    if (normalized.includes('codex')) {
-        if (normalized.includes('max')) {
-            throw new InvalidArgumentError('gpt-5.1-codex-max is not available yet. OpenAI has not released the API.');
+    if (normalized.includes("5.2") && normalized.includes("pro")) {
+        return "gpt-5.2-pro";
+    }
+    if (normalized.includes("5.1") && normalized.includes("pro")) {
+        return "gpt-5.1-pro";
+    }
+    if (normalized.includes("codex")) {
+        if (normalized.includes("max")) {
+            throw new InvalidArgumentError("gpt-5.1-codex-max is not available yet. OpenAI has not released the API.");
         }
-        return 'gpt-5.1-codex';
+        return "gpt-5.1-codex";
     }
-    if (normalized.includes('gemini')) {
-        return 'gemini-3-pro';
+    if (isGeminiDeepThinkAlias(normalized)) {
+        throw new InvalidArgumentError("Gemini Deep Think is browser-only today. Use --engine browser --model gemini-3-deep-think.");
     }
-    if (normalized.includes('pro')) {
-        return 'gpt-5.2-pro';
+    if (normalized.includes("gemini")) {
+        if (normalized.includes("3.1") || normalized.includes("3_1")) {
+            return "gemini-3.1-pro";
+        }
+        return "gemini-3-pro";
+    }
+    if (normalized.includes("pro")) {
+        return DEFAULT_MODEL;
     }
     // Passthrough for custom/OpenRouter model IDs.
     return normalized;
@@ -207,57 +237,85 @@ export function inferModelFromLabel(modelValue) {
     if (normalized in MODEL_CONFIGS) {
         return normalized;
     }
-    if (normalized.includes('grok')) {
-        return 'grok-4.1';
+    if (normalized.includes("/")) {
+        return normalized;
+    }
+    if (normalized.includes("grok")) {
+        return "grok-4.1";
+    }
+    if (normalized.includes("claude") && normalized.includes("sonnet")) {
+        return "claude-4.6-sonnet";
+    }
+    if (normalized.includes("claude") && normalized.includes("opus")) {
+        return "claude-4.1-opus";
+    }
+    if (normalized.includes("codex")) {
+        return "gpt-5.1-codex";
     }
-    if (normalized.includes('claude') && normalized.includes('sonnet')) {
-        return 'claude-4.5-sonnet';
+    if (isGeminiDeepThinkAlias(normalized)) {
+        return "gemini-3-pro-deep-think";
     }
-    if (normalized.includes('claude') && normalized.includes('opus')) {
-        return 'claude-4.1-opus';
+    if (normalized.includes("gemini")) {
+        if (normalized.includes("3.1") || normalized.includes("3_1")) {
+            return "gemini-3.1-pro";
+        }
+        return "gemini-3-pro";
+    }
+    if (normalized.includes("classic")) {
+        return "gpt-5-pro";
+    }
+    if (normalized.includes("thinking") && normalized.includes("heavy")) {
+        return "gpt-5.5";
     }
-    if (normalized.includes('codex')) {
-        return 'gpt-5.1-codex';
+    if ((normalized.includes("5.5") || normalized.includes("5_5")) && normalized.includes("pro")) {
+        return "gpt-5.5-pro";
     }
-    if (normalized.includes('gemini')) {
-        return 'gemini-3-pro';
+    if (normalized.includes("5.5") || normalized.includes("5_5")) {
+        return "gpt-5.5";
     }
-    if (normalized.includes('classic')) {
-        return 'gpt-5-pro';
+    if ((normalized.includes("5.4") || normalized.includes("5_4")) && normalized.includes("pro")) {
+        return "gpt-5.4-pro";
     }
-    if ((normalized.includes('5.2') || normalized.includes('5_2')) && normalized.includes('pro')) {
-        return 'gpt-5.2-pro';
+    if (normalized.includes("5.4") || normalized.includes("5_4")) {
+        return "gpt-5.4";
+    }
+    if ((normalized.includes("5.2") || normalized.includes("5_2")) && normalized.includes("pro")) {
+        return "gpt-5.2-pro";
     }
     // Browser-only: pass through 5.2 thinking/instant variants for browser label mapping
-    if ((normalized.includes('5.2') || normalized.includes('5_2')) && normalized.includes('thinking')) {
-        return 'gpt-5.2-thinking';
+    if ((normalized.includes("5.2") || normalized.includes("5_2")) &&
+        normalized.includes("thinking")) {
+        return "gpt-5.2-thinking";
     }
-    if ((normalized.includes('5.2') || normalized.includes('5_2')) && normalized.includes('instant')) {
-        return 'gpt-5.2-instant';
+    if ((normalized.includes("5.2") || normalized.includes("5_2")) &&
+        normalized.includes("instant")) {
+        return "gpt-5.2-instant";
     }
-    if (normalized.includes('5.0') || normalized.includes('5-pro')) {
-        return 'gpt-5-pro';
+    if (normalized.includes("5.0") || normalized.includes("5-pro")) {
+        return "gpt-5-pro";
     }
-    if (normalized.includes('gpt-5') &&
-        normalized.includes('pro') &&
-        !normalized.includes('5.1') &&
-        !normalized.includes('5.2')) {
-        return 'gpt-5-pro';
+    if (normalized.includes("gpt-5") &&
+        normalized.includes("pro") &&
+        !normalized.includes("5.1") &&
+        !normalized.includes("5.2") &&
+        !normalized.includes("5.5") &&
+        !normalized.includes("5.4")) {
+        return "gpt-5-pro";
     }
-    if ((normalized.includes('5.1') || normalized.includes('5_1')) && normalized.includes('pro')) {
-        return 'gpt-5.1-pro';
+    if ((normalized.includes("5.1") || normalized.includes("5_1")) && normalized.includes("pro")) {
+        return "gpt-5.1-pro";
     }
-    if (normalized.includes('pro')) {
-        return 'gpt-5.2-pro';
+    if (normalized.includes("pro")) {
+        return DEFAULT_MODEL;
     }
-    if (normalized.includes('5.1') || normalized.includes('5_1')) {
-        return 'gpt-5.1';
+    if (normalized.includes("5.1") || normalized.includes("5_1")) {
+        return "gpt-5.1";
     }
-    if (normalized.includes('thinking')) {
-        return 'gpt-5.2-thinking';
+    if (normalized.includes("thinking")) {
+        return "gpt-5.2-thinking";
     }
-    if (normalized.includes('instant') || normalized.includes('fast')) {
-        return 'gpt-5.2-instant';
+    if (normalized.includes("instant") || normalized.includes("fast")) {
+        return "gpt-5.2-instant";
     }
-    return 'gpt-5.2';
+    return "gpt-5.2";
 }

package/dist/src/cli/oscUtils.js

@@ -1,2 +1,2 @@
 // Utilities for handling OSC progress codes embedded in stored logs.
-export { sanitizeOscProgress } from 'osc-progress';
+export { sanitizeOscProgress } from "osc-progress";

package/dist/src/cli/promptRequirement.js

@@ -10,8 +10,8 @@ export function shouldRequirePrompt(rawArgs, options) {
         options.execSession ||
         options.status ||
         options.debugHelp ||
-        firstArg === 'status' ||
-        firstArg === 'session');
+        firstArg === "status" ||
+        firstArg === "session");
     const requiresPrompt = options.renderMarkdown || Boolean(options.preview) || Boolean(options.dryRun) || !bypassPrompt;
     return requiresPrompt && !options.prompt;
 }

package/dist/src/cli/renderOutput.js

@@ -1,4 +1,4 @@
-import { ensureShikiReady, renderMarkdownAnsi } from './markdownRenderer.js';
+import { ensureShikiReady, renderMarkdownAnsi } from "./markdownRenderer.js";
 export function shouldRenderRich(options = {}) {
     return options.richTty ?? Boolean(process.stdout.isTTY);
 }

package/dist/src/cli/rootAlias.js

@@ -1,4 +1,4 @@
-import { attachSession, showStatus } from './sessionDisplay.js';
+import { attachSession, showStatus } from "./sessionDisplay.js";
 const defaultDeps = {
     attachSession,
     showStatus,

package/dist/src/cli/runOptions.js

@@ -1,44 +1,55 @@
-import { DEFAULT_MODEL, MODEL_CONFIGS } from '../oracle.js';
-import { resolveEngine } from './engine.js';
-import { normalizeModelOption, inferModelFromLabel, resolveApiModel, normalizeBaseUrl } from './options.js';
-import { resolveGeminiModelId } from '../oracle/gemini.js';
-import { PromptValidationError } from '../oracle/errors.js';
-import { normalizeChatGptModelForBrowser } from './browserConfig.js';
+import { DEFAULT_MODEL, MODEL_CONFIGS } from "../oracle.js";
+import { resolveEngine } from "./engine.js";
+import { normalizeModelOption, inferModelFromLabel, resolveApiModel, normalizeBaseUrl, } from "./options.js";
+import { resolveGeminiModelId } from "../oracle/gemini.js";
+import { PromptValidationError } from "../oracle/errors.js";
+import { normalizeChatGptModelForBrowser } from "./browserConfig.js";
+import { resolveConfiguredMaxFileSizeBytes } from "./fileSize.js";
 export function resolveRunOptionsFromConfig({ prompt, files = [], model, models, engine, userConfig, env = process.env, }) {
     const resolvedEngine = resolveEngineWithConfig({ engine, configEngine: userConfig?.engine, env });
-    const browserRequested = engine === 'browser';
-    const browserConfigured = userConfig?.engine === 'browser';
+    const browserRequested = engine === "browser";
+    const browserConfigured = userConfig?.engine === "browser";
     const requestedModelList = Array.isArray(models) ? models : [];
-    const normalizedRequestedModels = requestedModelList.map((entry) => normalizeModelOption(entry)).filter(Boolean);
+    const normalizedRequestedModels = requestedModelList
+        .map((entry) => normalizeModelOption(entry))
+        .filter(Boolean);
     const cliModelArg = normalizeModelOption(model ?? userConfig?.model) || DEFAULT_MODEL;
-    const inferredModel = resolvedEngine === 'browser' && normalizedRequestedModels.length === 0
+    const inferredModel = resolvedEngine === "browser" && normalizedRequestedModels.length === 0
         ? inferModelFromLabel(cliModelArg)
         : resolveApiModel(cliModelArg);
-    // Browser engine maps Pro/legacy aliases to the latest ChatGPT picker targets (GPT-5.2 / GPT-5.2 Pro).
-    const resolvedModel = resolvedEngine === 'browser' ? normalizeChatGptModelForBrowser(inferredModel) : inferredModel;
-    const isCodex = resolvedModel.startsWith('gpt-5.1-codex');
-    const isClaude = resolvedModel.startsWith('claude');
-    const isGrok = resolvedModel.startsWith('grok');
-    const engineWasBrowser = resolvedEngine === 'browser';
+    // Browser engine maps Pro/legacy aliases to the latest ChatGPT picker targets.
+    const resolvedModel = resolvedEngine === "browser" ? normalizeChatGptModelForBrowser(inferredModel) : inferredModel;
+    const isCodex = resolvedModel.startsWith("gpt-5.1-codex");
+    const isClaude = resolvedModel.startsWith("claude");
+    const isGrok = resolvedModel.startsWith("grok");
+    const isGeminiApiOnly = resolvedModel === "gemini-3.1-pro";
+    const engineWasBrowser = resolvedEngine === "browser";
     const allModels = normalizedRequestedModels.length > 0
         ? Array.from(new Set(normalizedRequestedModels.map((entry) => resolveApiModel(entry))))
         : [resolvedModel];
-    const isBrowserCompatible = (m) => m.startsWith('gpt-') || m.startsWith('gemini');
+    const includesGeminiApiOnly = allModels.some((m) => m === "gemini-3.1-pro");
+    if ((browserRequested || browserConfigured) && includesGeminiApiOnly) {
+        throw new PromptValidationError("gemini-3.1-pro is API-only today. Use --engine api or switch to gemini-3-pro for Gemini web.", { engine: "browser", models: allModels });
+    }
+    const isBrowserCompatible = (m) => m.startsWith("gpt-") || m.startsWith("gemini");
     const hasNonBrowserCompatibleTarget = (browserRequested || browserConfigured) && allModels.some((m) => !isBrowserCompatible(m));
     if (hasNonBrowserCompatibleTarget) {
-        throw new PromptValidationError('Browser engine only supports GPT and Gemini models. Re-run with --engine api for Grok, Claude, or other models.', { engine: 'browser', models: allModels });
+        throw new PromptValidationError("Browser engine only supports GPT and Gemini models. Re-run with --engine api for Grok, Claude, or other models.", { engine: "browser", models: allModels });
     }
-    const engineCoercedToApi = engineWasBrowser && (isCodex || isClaude || isGrok);
-    const fixedEngine = isCodex || isClaude || isGrok || normalizedRequestedModels.length > 0 ? 'api' : resolvedEngine;
+    const engineCoercedToApi = engineWasBrowser && (isCodex || isClaude || isGrok || isGeminiApiOnly);
+    const fixedEngine = isCodex || isClaude || isGrok || isGeminiApiOnly || normalizedRequestedModels.length > 0
+        ? "api"
+        : resolvedEngine;
     const promptWithSuffix = userConfig?.promptSuffix && userConfig.promptSuffix.trim().length > 0
         ? `${prompt.trim()}\n${userConfig.promptSuffix}`
         : prompt;
-    const search = userConfig?.search !== 'off';
+    const search = userConfig?.search !== "off";
     const heartbeatIntervalMs = userConfig?.heartbeatSeconds !== undefined ? userConfig.heartbeatSeconds * 1000 : 30_000;
+    const maxFileSizeBytes = resolveConfiguredMaxFileSizeBytes(userConfig, env);
     const baseUrl = normalizeBaseUrl(userConfig?.apiBaseUrl ??
         (isClaude ? env.ANTHROPIC_BASE_URL : isGrok ? env.XAI_BASE_URL : env.OPENAI_BASE_URL));
     const uniqueMultiModels = normalizedRequestedModels.length > 0 ? allModels : [];
-    const includesCodexMultiModel = uniqueMultiModels.some((entry) => entry.startsWith('gpt-5.1-codex'));
+    const includesCodexMultiModel = uniqueMultiModels.some((entry) => entry.startsWith("gpt-5.1-codex"));
     if (includesCodexMultiModel && browserRequested) {
         // Silent coerce; multi-model still forces API.
     }
@@ -49,6 +60,7 @@ export function resolveRunOptionsFromConfig({ prompt, files = [], model, models,
         model: chosenModel,
         models: uniqueMultiModels.length > 0 ? uniqueMultiModels : undefined,
         file: files ?? [],
+        maxFileSizeBytes,
         search,
         heartbeatIntervalMs,
         filesReport: userConfig?.filesReport,
@@ -61,8 +73,8 @@ export function resolveRunOptionsFromConfig({ prompt, files = [], model, models,
 function resolveEngineWithConfig({ engine, configEngine, env, }) {
     if (engine)
         return engine;
-    const envOverride = (env.ORACLE_ENGINE ?? '').trim().toLowerCase();
-    if (envOverride === 'api' || envOverride === 'browser') {
+    const envOverride = (env.ORACLE_ENGINE ?? "").trim().toLowerCase();
+    if (envOverride === "api" || envOverride === "browser") {
         return envOverride;
     }
     if (configEngine)
@@ -70,7 +82,7 @@ function resolveEngineWithConfig({ engine, configEngine, env, }) {
     return resolveEngine({ engine: undefined, env });
 }
 function resolveEffectiveModelId(model) {
-    if (typeof model === 'string' && model.startsWith('gemini')) {
+    if (typeof model === "string" && model.startsWith("gemini")) {
         return resolveGeminiModelId(model);
     }
     const config = MODEL_CONFIGS[model];

package/dist/src/cli/sessionCommand.js

@@ -1,7 +1,7 @@
-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 { sessionStore } from "../sessionStore.js";
 const defaultDependencies = {
     showStatus,
     attachSession,
@@ -9,39 +9,49 @@ const defaultDependencies = {
     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",
+]);
 export async function handleSessionCommand(sessionId, command, deps = defaultDependencies) {
     const sessionOptions = command.opts();
     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 +60,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));
@@ -75,7 +85,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 +95,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 +108,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];