@steipete/oracle 0.13.0 → 0.14.1

package/dist/src/mcp/utils.js

@@ -1,6 +1,80 @@
+import fs from "node:fs";
+import path from "node:path";
 import { resolveRunOptionsFromConfig } from "../cli/runOptions.js";
+import { getOracleHomeDir } from "../oracleHome.js";
 import { Launcher } from "chrome-launcher";
-export function mapConsultToRunOptions({ prompt, files, model, models, engine, search, browserAttachments, browserBundleFiles, browserBundleFormat, browserFollowUps, userConfig, env = process.env, }) {
+const ALLOW_EXTERNAL_OUTPUT_ENV = "ORACLE_MCP_ALLOW_EXTERNAL_OUTPUT";
+const MCP_OUTPUT_DIRNAME = "generated";
+/**
+ * Whether MCP callers may write generated images outside the dedicated Oracle
+ * output directory. Off by default: MCP clients are less trusted than CLI users.
+ */
+export function isExternalMcpOutputAllowed(env = process.env) {
+    const raw = env[ALLOW_EXTERNAL_OUTPUT_ENV]?.trim().toLowerCase();
+    return raw === "1" || raw === "true" || raw === "yes" || raw === "on";
+}
+/**
+ * Resolve `target` through symlinks for the portion that exists on disk, then
+ * re-append the not-yet-created remainder. A lexical `path.resolve` is not
+ * enough: a symlinked parent under the Oracle home (e.g. `~/.oracle/generated`
+ * -> `/tmp/evil`) would pass a string-prefix check while the actual write lands
+ * outside the boundary. realpath-ing the deepest existing ancestor closes that.
+ */
+function resolveThroughSymlinks(target) {
+    const resolved = path.resolve(target);
+    let current = resolved;
+    const tail = [];
+    // Bounded by the number of path segments; dirname() converges to the root.
+    for (;;) {
+        try {
+            const real = fs.realpathSync(current);
+            return tail.length ? path.join(real, ...tail) : real;
+        }
+        catch (error) {
+            if (error.code !== "ENOENT") {
+                throw error;
+            }
+            try {
+                if (fs.lstatSync(current).isSymbolicLink()) {
+                    throw new Error(`MCP output path contains an unresolved symlink: ${current}`);
+                }
+            }
+            catch (lstatError) {
+                if (lstatError.code !== "ENOENT") {
+                    throw lstatError;
+                }
+            }
+            const parent = path.dirname(current);
+            if (parent === current) {
+                return resolved;
+            }
+            tail.unshift(path.basename(current));
+            current = parent;
+        }
+    }
+}
+/**
+ * Constrain an MCP-supplied output path to ORACLE_HOME_DIR/generated and return
+ * its canonical absolute form. This keeps agent writes away from Oracle config,
+ * session metadata, and browser profile state. Existing symlinks are resolved
+ * before the boundary check. Set ORACLE_MCP_ALLOW_EXTERNAL_OUTPUT to opt into
+ * arbitrary output paths as an explicit operator decision.
+ */
+export function resolveMcpOutputPath(requestedPath, field, env = process.env) {
+    const resolved = path.resolve(requestedPath);
+    if (isExternalMcpOutputAllowed(env)) {
+        return resolved;
+    }
+    const oracleHome = resolveThroughSymlinks(getOracleHomeDir());
+    const root = path.join(oracleHome, MCP_OUTPUT_DIRNAME);
+    const realTarget = resolveThroughSymlinks(resolved);
+    if (realTarget.startsWith(`${root}${path.sep}`)) {
+        return realTarget;
+    }
+    throw new Error(`MCP "${field}" must resolve under the generated output directory (${root}); got "${realTarget}". ` +
+        `Use a path under that directory, or set ${ALLOW_EXTERNAL_OUTPUT_ENV}=1 to allow external output paths.`);
+}
+export function mapConsultToRunOptions({ prompt, files, model, models, engine, search, browserAttachments, browserBundleFiles, browserBundleFormat, browserFollowUps, generateImage, outputPath, userConfig, env = process.env, }) {
     // Normalize CLI-style inputs through the shared resolver so config/env defaults apply,
     // then overlay MCP-only overrides such as explicit search toggles.
     const mergedModels = Array.isArray(models) && models.length > 0
@@ -32,6 +106,18 @@ export function mapConsultToRunOptions({ prompt, files, model, models, engine, s
             .map((entry) => entry.trim())
             .filter(Boolean);
     }
+    const imageOutputPath = generateImage?.trim();
+    if (imageOutputPath) {
+        result.runOptions.generateImage = resolveMcpOutputPath(imageOutputPath, "generateImage", env);
+    }
+    const secondaryOutputPath = outputPath?.trim();
+    if (secondaryOutputPath) {
+        result.runOptions.outputPath = resolveMcpOutputPath(secondaryOutputPath, "outputPath", env);
+    }
+    if (result.resolvedEngine !== "browser" &&
+        (result.runOptions.generateImage || result.runOptions.outputPath)) {
+        throw new Error('MCP image output requires engine:"browser".');
+    }
     return result;
 }
 export function ensureBrowserAvailable(engine, options) {

package/dist/src/oracle/config.js

@@ -164,6 +164,32 @@ export const MODEL_CONFIGS = {
         supportsBackground: false,
         supportsSearch: true,
     },
+    "gemini-3.5-flash": {
+        model: "gemini-3.5-flash",
+        provider: "google",
+        tokenizer: countTokensGpt5Pro,
+        inputLimit: 1_048_576,
+        pricing: {
+            inputPerToken: 1.5 / 1_000_000,
+            outputPerToken: 9 / 1_000_000,
+        },
+        reasoning: null,
+        supportsBackground: false,
+        supportsSearch: true,
+    },
+    "gemini-3.1-flash-lite": {
+        model: "gemini-3.1-flash-lite",
+        provider: "google",
+        tokenizer: countTokensGpt5Pro,
+        inputLimit: 1_048_576,
+        pricing: {
+            inputPerToken: 0.25 / 1_000_000,
+            outputPerToken: 1.5 / 1_000_000,
+        },
+        reasoning: null,
+        supportsBackground: false,
+        supportsSearch: true,
+    },
     "gemini-3-pro": {
         model: "gemini-3-pro",
         provider: "google",
@@ -223,6 +249,6 @@ export const MODEL_CONFIGS = {
 };
 export const DEFAULT_SYSTEM_PROMPT = [
     "You are Oracle, a focused one-shot problem solver.",
-    "Emphasize direct answers and cite any files referenced.",
+    "Emphasize direct answers and cite referenced files as path:line or path:line-line when line numbers are available.",
 ].join(" ");
 export const TOKENIZER_OPTIONS = { allowedSpecial: "all" };

package/dist/src/oracle/files.js

@@ -382,15 +382,13 @@ function relativePath(targetPath, cwd) {
     const relative = path.relative(cwd, targetPath);
     return relative || targetPath;
 }
+function formatLegacyFileSection(index, displayPath, content) {
+    return [`### File ${index}: ${displayPath}`, "```", content.trimEnd(), "```"].join("\n");
+}
 export function createFileSections(files, cwd = process.cwd()) {
     return files.map((file, index) => {
         const relative = toPosix(path.relative(cwd, file.path) || file.path);
-        const sectionText = [
-            `### File ${index + 1}: ${relative}`,
-            "```",
-            file.content.trimEnd(),
-            "```",
-        ].join("\n");
+        const sectionText = formatLegacyFileSection(index + 1, relative, file.content);
         return {
             index: index + 1,
             absolutePath: file.path,

package/dist/src/oracle/geminiModels.js

@@ -1,5 +1,7 @@
 const MODEL_ID_MAP = {
+    "gemini-3.1-flash-lite": "gemini-3.1-flash-lite",
     "gemini-3.1-pro": "gemini-3.1-pro-preview",
+    "gemini-3.5-flash": "gemini-3.5-flash",
     "gemini-3-pro": "gemini-3-pro-preview",
     "gpt-5.5": "gpt-5.5",
     "gpt-5.5-pro": "gpt-5.5-pro",

package/dist/src/oracle/markdown.js

@@ -36,11 +36,44 @@ function pickFence(content) {
     const fenceLength = Math.max(3, maxTicks + 1);
     return "`".repeat(fenceLength);
 }
-export function formatFileSection(displayPath, content) {
+function formatLineRange(lineCount) {
+    return lineCount === 0 ? "Lines: 0" : `Lines: 1-${lineCount}`;
+}
+function addLineNumbers(content) {
+    if (content.length === 0) {
+        return { text: "", lineCount: 0 };
+    }
+    const lines = content.split("\n");
+    const width = String(lines.length).length;
+    const numbered = lines
+        .map((line, index) => `${String(index + 1).padStart(width, " ")} | ${line}`)
+        .join("\n");
+    return { text: numbered, lineCount: lines.length };
+}
+function renderFileSection(displayPath, content, options) {
     const fence = pickFence(content);
     const lang = detectFenceLanguage(displayPath);
     const normalized = content.replace(/\s+$/u, "");
-    const header = `### File: ${displayPath}`;
+    const header = options.index == null
+        ? `### File: ${displayPath}`
+        : `### File ${options.index}: ${displayPath}`;
     const fenceOpen = lang ? `${fence}${lang}` : fence;
-    return [header, fenceOpen, normalized, fence, ""].join("\n");
+    if (options.lineNumbers !== true) {
+        return [header, fenceOpen, normalized, fence, ""].join("\n");
+    }
+    const numbered = addLineNumbers(normalized);
+    return [header, formatLineRange(numbered.lineCount), fenceOpen, numbered.text, fence, ""].join("\n");
+}
+export function formatFileSection(displayPath, content, options = {}) {
+    return renderFileSection(displayPath, content, options);
+}
+export function formatFileSections(sections, options = {}) {
+    const lineNumbers = options.lineNumbers ?? true;
+    const rendered = sections
+        .map((section) => renderFileSection(section.displayPath, section.content, {
+        lineNumbers,
+        index: options.includeFileIndex ? section.index : undefined,
+    }).trimEnd())
+        .join("\n\n");
+    return options.trailingNewline && rendered ? `${rendered}\n` : rendered;
 }

package/dist/src/oracle/modelResolver.js

@@ -1,6 +1,6 @@
 import { createRequire } from "node:module";
 import { MODEL_CONFIGS, PRO_MODELS } from "./config.js";
-import { pricingFromUsdPerMillion } from "tokentally";
+import { pricingFromUsdPerToken } from "tokentally";
 const OPENROUTER_DEFAULT_BASE = "https://openrouter.ai/api/v1";
 const OPENROUTER_MODELS_ENDPOINT = "https://openrouter.ai/api/v1/models";
 const require = createRequire(import.meta.url);
@@ -42,6 +42,25 @@ export function normalizeOpenRouterBaseUrl(baseUrl) {
 export function safeModelSlug(model) {
     return model.replace(/[/\\]/g, "__").replace(/[:*?"<>|]/g, "_");
 }
+function openRouterPricing(pricing) {
+    const parsePrice = (value) => {
+        const parsed = typeof value === "number"
+            ? value
+            : typeof value === "string" && value.trim() !== ""
+                ? Number(value)
+                : NaN;
+        return Number.isFinite(parsed) && parsed >= 0 ? parsed : null;
+    };
+    const inputUsdPerToken = parsePrice(pricing?.prompt);
+    const outputUsdPerToken = parsePrice(pricing?.completion);
+    if (inputUsdPerToken === null || outputUsdPerToken === null)
+        return null;
+    const normalized = pricingFromUsdPerToken({ inputUsdPerToken, outputUsdPerToken });
+    return {
+        inputPerToken: normalized.inputUsdPerToken,
+        outputPerToken: normalized.outputUsdPerToken,
+    };
+}
 const catalogCache = new Map();
 const CACHE_TTL_MS = 5 * 60 * 1000;
 const MAX_CACHE_ENTRIES = 20;
@@ -125,18 +144,7 @@ export async function resolveModelConfig(model, options = {}) {
                     openRouterId: targetId,
                     provider: known?.provider ?? "other",
                     inputLimit: info.context_length ?? known?.inputLimit ?? 200_000,
-                    pricing: info.pricing && info.pricing.prompt != null && info.pricing.completion != null
-                        ? (() => {
-                            const pricing = pricingFromUsdPerMillion({
-                                inputUsdPerMillion: info.pricing.prompt,
-                                outputUsdPerMillion: info.pricing.completion,
-                            });
-                            return {
-                                inputPerToken: pricing.inputUsdPerToken,
-                                outputPerToken: pricing.outputUsdPerToken,
-                            };
-                        })()
-                        : (known?.pricing ?? null),
+                    pricing: openRouterPricing(info.pricing) ?? known?.pricing ?? null,
                     supportsBackground: known?.supportsBackground ?? true,
                     supportsSearch: known?.supportsSearch ?? true,
                 };

package/dist/src/oracle/promptAssembly.js

@@ -1,4 +1,4 @@
-import { formatFileSection } from "./markdown.js";
+import { formatFileSections } from "./markdown.js";
 /**
  * Build the shared markdown structure for system/user/file sections.
  * Collapses excessive blank lines and trims trailing whitespace to keep
@@ -6,9 +6,7 @@ import { formatFileSection } from "./markdown.js";
  */
 export function buildPromptMarkdown(systemPrompt, userPrompt, sections) {
     const lines = ["[SYSTEM]", systemPrompt, "", "[USER]", userPrompt, ""];
-    sections.forEach((section) => {
-        lines.push(formatFileSection(section.displayPath, section.content));
-    });
+    lines.push(formatFileSections(sections, { trailingNewline: true }));
     return lines
         .join("\n")
         .replace(/\n{3,}/g, "\n\n")

package/dist/src/oracle/request.js

@@ -1,14 +1,14 @@
 import fs from "node:fs/promises";
 import { DEFAULT_SYSTEM_PROMPT } from "./config.js";
 import { createFileSections, readFiles } from "./files.js";
-import { formatFileSection } from "./markdown.js";
+import { formatFileSections } from "./markdown.js";
 import { createFsAdapter } from "./fsAdapter.js";
 export function buildPrompt(basePrompt, files, cwd = process.cwd()) {
     if (!files.length) {
         return basePrompt;
     }
     const sections = createFileSections(files, cwd);
-    const sectionText = sections.map((section) => section.sectionText).join("\n\n");
+    const sectionText = formatFileSections(sections, { includeFileIndex: true });
     return `${basePrompt.trim()}\n\n${sectionText}`;
 }
 export function buildRequestBody({ modelConfig, systemPrompt, userPrompt, searchEnabled, maxOutputTokens, background, storeResponse, previousResponseId, }) {
@@ -48,9 +48,7 @@ export async function renderPromptMarkdown(options, deps = {}) {
     const userPrompt = (options.prompt ?? "").trim();
     const lines = ["[SYSTEM]", systemPrompt, ""];
     lines.push("[USER]", userPrompt, "");
-    sections.forEach((section) => {
-        lines.push(formatFileSection(section.displayPath, section.content));
-    });
+    lines.push(formatFileSections(sections));
     return lines
         .join("\n")
         .replace(/\n{3,}/g, "\n\n")

package/dist/src/oracle/thinkingTime.js

@@ -0,0 +1,40 @@
+export const THINKING_TIME_LEVELS = ["light", "standard", "extended", "heavy"];
+export const THINKING_TIME_ALIASES = [
+    "instant",
+    "low",
+    "medium",
+    "high",
+    "extra-high",
+    "extra high",
+    "extrahigh",
+    "xhigh",
+];
+export const THINKING_TIME_INPUT_VALUES = [
+    ...THINKING_TIME_LEVELS,
+    ...THINKING_TIME_ALIASES,
+];
+export function normalizeThinkingTimeLevel(value) {
+    const normalized = (value ?? "")
+        .trim()
+        .toLowerCase()
+        .replace(/[_\s]+/g, "-");
+    switch (normalized) {
+        case "light":
+        case "instant":
+        case "low":
+            return "light";
+        case "standard":
+        case "medium":
+            return "standard";
+        case "extended":
+        case "high":
+            return "extended";
+        case "heavy":
+        case "extra-high":
+        case "extrahigh":
+        case "xhigh":
+            return "heavy";
+        default:
+            return null;
+    }
+}

package/dist/src/oracle/tokenStats.js

@@ -1,5 +1,6 @@
 import chalk from "chalk";
 import { createFileSections } from "./files.js";
+import { formatFileSections } from "./markdown.js";
 export function getFileTokenStats(files, { cwd = process.cwd(), tokenizer, tokenizerOptions, inputTokenBudget, }) {
     if (!files.length) {
         return { stats: [], totalTokens: 0 };
@@ -7,7 +8,10 @@ export function getFileTokenStats(files, { cwd = process.cwd(), tokenizer, token
     const sections = createFileSections(files, cwd);
     const stats = sections
         .map((section) => {
-        const tokens = tokenizer(section.sectionText, tokenizerOptions);
+        const sectionText = formatFileSections([section], {
+            includeFileIndex: true,
+        }).trimEnd();
+        const tokens = tokenizer(sectionText, tokenizerOptions);
         const percent = inputTokenBudget ? (tokens / inputTokenBudget) * 100 : undefined;
         return {
             path: section.absolutePath,

package/dist/src/oracle.js

@@ -4,7 +4,7 @@ export { readFiles, createFileSections } from "./oracle/files.js";
 export { buildPrompt, buildRequestBody, renderPromptMarkdown } from "./oracle/request.js";
 export { estimateRequestTokens } from "./oracle/tokenEstimate.js";
 export { formatUSD, formatNumber, formatElapsed } from "./oracle/format.js";
-export { formatFileSection } from "./oracle/markdown.js";
+export { formatFileSection, formatFileSections } from "./oracle/markdown.js";
 export { getFileTokenStats, printFileTokenStats } from "./oracle/tokenStats.js";
 export { OracleResponseError, OracleTransportError, OracleUserError, FileValidationError, BrowserAutomationError, PromptValidationError, describeTransportError, extractResponseMetadata, asOracleUserError, toTransportError, } from "./oracle/errors.js";
 export { createDefaultClientFactory } from "./oracle/client.js";

package/dist/src/sessionManager.js

@@ -228,6 +228,7 @@ export async function initializeSession(options, cwd, notifications, baseSlugOve
             editImage: options.editImage,
             outputPath: options.outputPath,
             browserFollowUps: options.browserFollowUps,
+            browserResumeConversationUrl: options.browserResumeConversationUrl,
             aspectRatio: options.aspectRatio,
             geminiShowThoughts: options.geminiShowThoughts,
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steipete/oracle",
-  "version": "0.13.0",
+  "version": "0.14.1",
   "description": "CLI wrapper around OpenAI Responses API with GPT-5.5 Pro, GPT-5.5, GPT-5.4, GPT-5.2, GPT-5.1, and GPT-5.1 Codex high reasoning modes.",
   "keywords": [],
   "homepage": "https://askoracle.sh",
@@ -28,76 +28,48 @@
   ],
   "type": "module",
   "main": "dist/bin/oracle-cli.js",
-  "scripts": {
-    "docs:list": "tsx scripts/docs-list.ts",
-    "docs:check": "node --no-deprecation --import tsx bin/oracle-cli.ts docs check",
-    "docs:site": "node scripts/build-docs-site.mjs",
-    "build": "tsgo -p tsconfig.build.json && pnpm run build:vendor",
-    "build:vendor": "node -e \"const fs=require('fs'); const path=require('path'); const vendorRoot=path.join('dist','vendor'); fs.rmSync(vendorRoot,{recursive:true,force:true}); const vendors=[['oracle-notifier']]; vendors.forEach(([name])=>{const src=path.join('vendor',name); const dest=path.join(vendorRoot,name); fs.mkdirSync(dest,{recursive:true}); if(fs.existsSync(src)){fs.cpSync(src,dest,{recursive:true,force:true});}});\"",
-    "start": "pnpm run build && node ./dist/scripts/run-cli.js",
-    "oracle": "pnpm start",
-    "check": "pnpm run format:check && pnpm run lint",
-    "typecheck": "tsgo --noEmit",
-    "format": "oxfmt --write .",
-    "format:check": "oxfmt --check .",
-    "format:diff": "oxfmt --write . && git --no-pager diff",
-    "lint": "pnpm run typecheck && oxlint",
-    "lint:fix": "oxlint --fix && pnpm run format",
-    "test": "vitest run",
-    "test:mcp": "pnpm run build && pnpm run test:mcp:unit && pnpm run test:mcp:mcporter",
-    "test:mcp:unit": "vitest run tests/mcp*.test.ts tests/mcp/**/*.test.ts",
-    "test:mcp:mcporter": "CHROME_DEVTOOLS_URL=http://127.0.0.1:0 pnpm dlx mcporter list oracle-local --schema --config config/mcporter.json && CHROME_DEVTOOLS_URL=http://127.0.0.1:0 pnpm dlx mcporter call oracle-local.sessions limit:1 --config config/mcporter.json",
-    "test:browser": "pnpm run build && tsx scripts/test-browser.ts && ./scripts/browser-smoke.sh",
-    "test:packed-cli": "node scripts/packed-cli-smoke.mjs",
-    "test:live": "ORACLE_LIVE_TEST=1 vitest run tests/live --exclude tests/live/openai-live.test.ts",
-    "test:live:fast": "ORACLE_LIVE_TEST=1 ORACLE_LIVE_TEST_FAST=1 vitest run tests/live/browser-fast-live.test.ts",
-    "test:pro": "ORACLE_LIVE_TEST=1 vitest run tests/live/openai-live.test.ts",
-    "test:coverage": "vitest run --coverage",
-    "prepare": "pnpm run build",
-    "mcp": "pnpm run build && node ./dist/bin/oracle-mcp.js"
-  },
   "dependencies": {
     "@anthropic-ai/tokenizer": "^0.0.4",
-    "@google/genai": "^2.0.1",
+    "@google/genai": "^2.8.0",
     "@google/generative-ai": "^0.24.1",
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@steipete/sweet-cookie": "^0.3.0",
+    "@steipete/sweet-cookie": "^0.4.0",
     "chalk": "^5.6.2",
     "chrome-launcher": "^1.2.1",
     "chrome-remote-interface": "^0.34.0",
     "clipboardy": "^5.3.1",
-    "commander": "^14.0.3",
+    "commander": "^15.0.0",
     "dotenv": "^17.4.2",
     "fast-glob": "^3.3.3",
     "gpt-tokenizer": "^3.4.0",
-    "inquirer": "13.4.3",
+    "inquirer": "14.0.2",
     "json5": "^2.2.3",
     "kleur": "^4.1.5",
-    "markdansi": "0.2.1",
-    "openai": "^6.38.0",
+    "markdansi": "0.3.1",
+    "openai": "^6.42.0",
     "osc-progress": "^0.3.0",
-    "qs": "^6.15.1",
-    "shiki": "^4.0.2",
+    "qs": "^6.15.2",
+    "shiki": "^4.2.0",
     "toasted-notifier": "^10.1.0",
     "tokentally": "^0.1.1",
-    "zod": "^4.4.2"
+    "zod": "^4.4.3"
   },
   "devDependencies": {
     "@anthropic-ai/tokenizer": "^0.0.4",
     "@types/chrome-remote-interface": "^0.34.0",
     "@types/inquirer": "^9.0.9",
-    "@types/node": "^25.6.0",
-    "@typescript/native-preview": "7.0.0-dev.20260516.1",
-    "@vitest/coverage-v8": "4.1.6",
-    "devtools-protocol": "0.0.1629771",
-    "es-toolkit": "^1.46.1",
+    "@types/node": "^25.9.2",
+    "@typescript/native-preview": "7.0.0-dev.20260612.1",
+    "@vitest/coverage-v8": "4.1.8",
+    "devtools-protocol": "0.0.1643702",
+    "es-toolkit": "^1.47.0",
     "esbuild": "^0.28.0",
-    "oxfmt": "0.50.0",
-    "oxlint": "^1.62.0",
-    "puppeteer-core": "^25.0.2",
-    "tsx": "^4.21.0",
+    "oxfmt": "0.54.0",
+    "oxlint": "^1.69.0",
+    "puppeteer-core": "^25.1.0",
+    "tsx": "^4.22.4",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.5"
+    "vitest": "^4.1.8"
   },
   "devEngines": {
     "runtime": [
@@ -110,14 +82,31 @@
   "engines": {
     "node": ">=24"
   },
-  "packageManager": "pnpm@10.33.2",
-  "pnpm": {
-    "overrides": {
-      "devtools-protocol": "0.0.1629771",
-      "vite": "7.3.2"
-    },
-    "onlyBuiltDependencies": [
-      "esbuild"
-    ]
+  "scripts": {
+    "docs:list": "tsx scripts/docs-list.ts",
+    "docs:check": "node --no-deprecation --import tsx bin/oracle-cli.ts docs check",
+    "docs:site": "node scripts/build-docs-site.mjs",
+    "build": "tsgo -p tsconfig.build.json && pnpm run build:vendor",
+    "build:vendor": "node -e \"const fs=require('fs'); const path=require('path'); const vendorRoot=path.join('dist','vendor'); fs.rmSync(vendorRoot,{recursive:true,force:true}); const vendors=[['oracle-notifier']]; vendors.forEach(([name])=>{const src=path.join('vendor',name); const dest=path.join(vendorRoot,name); fs.mkdirSync(dest,{recursive:true}); if(fs.existsSync(src)){fs.cpSync(src,dest,{recursive:true,force:true});}});\"",
+    "start": "pnpm run build && node ./dist/scripts/run-cli.js",
+    "oracle": "pnpm start",
+    "check": "pnpm run format:check && pnpm run lint",
+    "typecheck": "tsgo --noEmit",
+    "format": "oxfmt --write .",
+    "format:check": "oxfmt --check .",
+    "format:diff": "oxfmt --write . && git --no-pager diff",
+    "lint": "pnpm run typecheck && oxlint",
+    "lint:fix": "oxlint --fix && pnpm run format",
+    "test": "vitest run",
+    "test:mcp": "pnpm run build && pnpm run test:mcp:unit && pnpm run test:mcp:mcporter",
+    "test:mcp:unit": "vitest run tests/mcp*.test.ts tests/mcp/**/*.test.ts",
+    "test:mcp:mcporter": "CHROME_DEVTOOLS_URL=http://127.0.0.1:0 pnpm dlx mcporter list oracle-local --schema --config config/mcporter.json && CHROME_DEVTOOLS_URL=http://127.0.0.1:0 pnpm dlx mcporter call oracle-local.sessions limit:1 --config config/mcporter.json",
+    "test:browser": "pnpm run build && tsx scripts/test-browser.ts && ./scripts/browser-smoke.sh",
+    "test:packed-cli": "node scripts/packed-cli-smoke.mjs",
+    "test:live": "ORACLE_LIVE_TEST=1 vitest run tests/live --exclude tests/live/openai-live.test.ts",
+    "test:live:fast": "ORACLE_LIVE_TEST=1 ORACLE_LIVE_TEST_FAST=1 vitest run tests/live/browser-fast-live.test.ts",
+    "test:pro": "ORACLE_LIVE_TEST=1 vitest run tests/live/openai-live.test.ts",
+    "test:coverage": "vitest run --coverage",
+    "mcp": "pnpm run build && node ./dist/bin/oracle-mcp.js"
   }
-}
+}