@steipete/oracle 0.4.2 → 0.4.3

package/README.md

@@ -55,7 +55,7 @@ Engine auto-picks API when `OPENAI_API_KEY` is set, otherwise browser; browser i
   - Oracle bundles a prompt plus the right files so another AI (GPT 5 Pro + more) can answer. Use when stuck/bugs/reviewing.
   - Run `npx -y @steipete/oracle --help` once per session before first use.
   ```
-- Tip: set `chatgptUrl` in config (or `--chatgpt-url`) to a dedicated ChatGPT project folder so work runs don’t clutter your main history.
+- Tip: set `browser.chatgptUrl` in config (or `--chatgpt-url`) to a dedicated ChatGPT project folder so browser runs don’t clutter your main history.
 
 **MCP**
 - Run the stdio server via `oracle-mcp`.
@@ -116,9 +116,12 @@ Put defaults in `~/.oracle/config.json` (JSON5). Example:
   model: "gpt-5.1-pro",
   engine: "api",
   filesReport: true,
-  chatgptUrl: "https://chatgpt.com/g/your-project-folder"
+  browser: {
+    chatgptUrl: "https://chatgpt.com/g/g-p-691edc9fec088191b553a35093da1ea8-oracle/project"
+  }
 }
 ```
+Use `browser.chatgptUrl` (or the legacy alias `browser.url`) to target a specific ChatGPT workspace/folder for browser automation.
 See [docs/configuration.md](docs/configuration.md) for precedence and full schema.
 
 Advanced flags

package/dist/bin/oracle-cli.js

@@ -498,6 +498,13 @@ async function runRootCommand(options) {
     const isCodex = primaryModelCandidate.startsWith('gpt-5.1-codex');
     const isClaude = primaryModelCandidate.startsWith('claude');
     const userForcedBrowser = options.browser || options.engine === 'browser';
+    const hasNonGptBrowserTarget = (engine === 'browser' || userForcedBrowser) &&
+        (normalizedMultiModels.length > 0
+            ? normalizedMultiModels.some((model) => !model.startsWith('gpt-'))
+            : !resolvedModelCandidate.startsWith('gpt-'));
+    if (hasNonGptBrowserTarget) {
+        throw new Error('Browser engine only supports GPT-series ChatGPT models. Re-run with --engine api for Grok, Claude, Gemini, or other non-GPT models.');
+    }
     if (isGemini && userForcedBrowser) {
         throw new Error('Gemini is only supported via API. Use --engine api.');
     }

package/dist/src/cli/options.js

@@ -116,6 +116,9 @@ export function resolveApiModel(modelValue) {
     if (normalized in MODEL_CONFIGS) {
         return normalized;
     }
+    if (normalized.includes('grok')) {
+        return 'grok-4.1';
+    }
     if (normalized.includes('claude') && normalized.includes('sonnet')) {
         return 'claude-4.5-sonnet';
     }
@@ -156,6 +159,9 @@ export function inferModelFromLabel(modelValue) {
     if (normalized in MODEL_CONFIGS) {
         return normalized;
     }
+    if (normalized.includes('grok')) {
+        return 'grok-4.1';
+    }
     if (normalized.includes('claude') && normalized.includes('sonnet')) {
         return 'claude-4.5-sonnet';
     }

package/dist/src/cli/runOptions.js

@@ -2,9 +2,11 @@ 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';
 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 requestedModelList = Array.isArray(models) ? models : [];
     const normalizedRequestedModels = requestedModelList.map((entry) => normalizeModelOption(entry)).filter(Boolean);
     const cliModelArg = normalizeModelOption(model ?? userConfig?.model) || DEFAULT_MODEL;
@@ -14,18 +16,26 @@ export function resolveRunOptionsFromConfig({ prompt, files = [], model, models,
     const isGemini = resolvedModel.startsWith('gemini');
     const isCodex = resolvedModel.startsWith('gpt-5.1-codex');
     const isClaude = resolvedModel.startsWith('claude');
-    const engineCoercedToApi = (isGemini || isCodex || isClaude) && browserRequested;
-    // When Gemini, Claude, or Codex is selected, always force API engine (overrides config/env auto browser).
-    const fixedEngine = isGemini || isCodex || isClaude || normalizedRequestedModels.length > 0 ? 'api' : resolvedEngine;
+    const isGrok = resolvedModel.startsWith('grok');
+    const engineWasBrowser = resolvedEngine === 'browser';
+    const allModels = normalizedRequestedModels.length > 0
+        ? Array.from(new Set(normalizedRequestedModels.map((entry) => resolveApiModel(entry))))
+        : [resolvedModel];
+    const hasNonGptBrowserTarget = (browserRequested || browserConfigured) && allModels.some((m) => !m.startsWith('gpt-'));
+    if (hasNonGptBrowserTarget) {
+        throw new PromptValidationError('Browser engine only supports GPT-series ChatGPT models. Re-run with --engine api for Grok, Claude, Gemini, or other non-GPT models.', { engine: 'browser', models: allModels });
+    }
+    const engineCoercedToApi = engineWasBrowser && (isGemini || isCodex || isClaude || isGrok);
+    // When Gemini, Claude, or Grok is selected, force API engine for auto-browser detection; codex also forces API.
+    const fixedEngine = isGemini || isCodex || isClaude || isGrok || 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 heartbeatIntervalMs = userConfig?.heartbeatSeconds !== undefined ? userConfig.heartbeatSeconds * 1000 : 30_000;
-    const baseUrl = normalizeBaseUrl(userConfig?.apiBaseUrl ?? (isClaude ? env.ANTHROPIC_BASE_URL : env.OPENAI_BASE_URL));
-    const uniqueMultiModels = normalizedRequestedModels.length > 0
-        ? Array.from(new Set(normalizedRequestedModels.map((entry) => resolveApiModel(entry))))
-        : [];
+    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'));
     if (includesCodexMultiModel && browserRequested) {
         // Silent coerce; multi-model still forces API.

package/dist/src/mcp/server.js

@@ -23,10 +23,14 @@ export async function startMcpServer() {
     transport.onerror = (error) => {
         console.error('MCP transport error:', error);
     };
-    transport.onclose = () => {
-        // Keep quiet on normal close; caller owns lifecycle.
-    };
+    const closed = new Promise((resolve) => {
+        transport.onclose = () => {
+            resolve();
+        };
+    });
+    // Keep the process alive until the client closes the transport.
     await server.connect(transport);
+    await closed;
 }
 if (import.meta.url === `file://${process.argv[1]}` || process.argv[1]?.endsWith('oracle-mcp')) {
     startMcpServer().catch((error) => {

package/dist/src/oracle/config.js

@@ -84,6 +84,20 @@ export const MODEL_CONFIGS = {
         supportsBackground: false,
         supportsSearch: false,
     },
+    'grok-4.1': {
+        model: 'grok-4.1',
+        apiModel: 'grok-4-1-fast-reasoning',
+        tokenizer: countTokensGpt5Pro,
+        inputLimit: 2_000_000,
+        pricing: {
+            inputPerToken: 0.2 / 1_000_000,
+            outputPerToken: 0.5 / 1_000_000,
+        },
+        reasoning: null,
+        supportsBackground: false,
+        supportsSearch: true,
+        searchToolType: 'web_search',
+    },
 };
 export const DEFAULT_SYSTEM_PROMPT = [
     'You are Oracle, a focused one-shot problem solver.',

package/dist/src/oracle/gemini.js

@@ -7,6 +7,7 @@ const MODEL_ID_MAP = {
     'gpt-5.1-codex': 'gpt-5.1-codex',
     'claude-4.5-sonnet': 'claude-4.5-sonnet',
     'claude-4.1-opus': 'claude-4.1-opus',
+    'grok-4.1': 'grok-4.1',
 };
 export function resolveGeminiModelId(modelName) {
     // Map our logical Gemini names to the exact model ids expected by the SDK.

package/dist/src/oracle/request.js

@@ -12,6 +12,7 @@ export function buildPrompt(basePrompt, files, cwd = process.cwd()) {
     return `${basePrompt.trim()}\n\n${sectionText}`;
 }
 export function buildRequestBody({ modelConfig, systemPrompt, userPrompt, searchEnabled, maxOutputTokens, background, storeResponse, }) {
+    const searchToolType = modelConfig.searchToolType ?? 'web_search_preview';
     return {
         model: modelConfig.apiModel ?? modelConfig.model,
         instructions: systemPrompt,
@@ -26,7 +27,7 @@ export function buildRequestBody({ modelConfig, systemPrompt, userPrompt, search
                 ],
             },
         ],
-        tools: searchEnabled ? [{ type: 'web_search_preview' }] : undefined,
+        tools: searchEnabled ? [{ type: searchToolType }] : undefined,
         reasoning: modelConfig.reasoning || undefined,
         max_output_tokens: maxOutputTokens,
         background: background ? true : undefined,

package/dist/src/oracle/run.js

@@ -35,7 +35,16 @@ export async function runOracle(options, deps = {}) {
         ? stdoutWriteDep ?? process.stdout.write.bind(process.stdout)
         : () => true;
     const isTty = allowStdout && isStdoutTty;
-    const baseUrl = options.baseUrl?.trim() || process.env.OPENAI_BASE_URL?.trim();
+    const resolvedXaiBaseUrl = process.env.XAI_BASE_URL?.trim() || 'https://api.x.ai/v1';
+    let baseUrl = options.baseUrl?.trim();
+    if (!baseUrl) {
+        if (options.model.startsWith('grok')) {
+            baseUrl = resolvedXaiBaseUrl;
+        }
+        else {
+            baseUrl = process.env.OPENAI_BASE_URL?.trim();
+        }
+    }
     const logVerbose = (message) => {
         if (options.verbose) {
             log(dim(`[verbose] ${message}`));
@@ -59,6 +68,9 @@ export async function runOracle(options, deps = {}) {
         if (model.startsWith('claude')) {
             return optionsApiKey ?? process.env.ANTHROPIC_API_KEY;
         }
+        if (model.startsWith('grok')) {
+            return optionsApiKey ?? process.env.XAI_API_KEY;
+        }
         return undefined;
     };
     const envVar = options.model.startsWith('gpt')
@@ -67,7 +79,9 @@ export async function runOracle(options, deps = {}) {
             : 'OPENAI_API_KEY'
         : options.model.startsWith('gemini')
             ? 'GEMINI_API_KEY'
-            : 'ANTHROPIC_API_KEY';
+            : options.model.startsWith('claude')
+                ? 'ANTHROPIC_API_KEY'
+                : 'XAI_API_KEY';
     const apiKey = getApiKeyForModel(options.model);
     if (!apiKey) {
         throw new PromptValidationError(`Missing ${envVar}. Set it via the environment or a .env file.`, {
@@ -86,7 +100,8 @@ export async function runOracle(options, deps = {}) {
         throw new PromptValidationError(`Unsupported model "${options.model}". Choose one of: ${Object.keys(MODEL_CONFIGS).join(', ')}`, { model: options.model });
     }
     const isLongRunningModel = isProTierModel;
-    const useBackground = options.background ?? isLongRunningModel;
+    const supportsBackground = modelConfig.supportsBackground !== false;
+    const useBackground = supportsBackground ? options.background ?? isLongRunningModel : false;
     const inputTokenBudget = options.maxInput ?? modelConfig.inputLimit;
     const files = await readFiles(options.file ?? [], { cwd, fsModule });
     const searchEnabled = options.search !== false;
@@ -165,6 +180,9 @@ export async function runOracle(options, deps = {}) {
         if (baseUrl) {
             log(dim(`Base URL: ${formatBaseUrlForLog(baseUrl)}`));
         }
+        if (options.background && !supportsBackground) {
+            log(dim('Background runs are not supported for this model; streaming in foreground instead.'));
+        }
         if (!options.suppressTips) {
             if (pendingNoFilesTip) {
                 log(dim(pendingNoFilesTip));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steipete/oracle",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "CLI wrapper around OpenAI Responses API with GPT-5.1 Pro, GPT-5.1, and GPT-5.1 Codex high reasoning modes.",
   "type": "module",
   "main": "dist/bin/oracle-cli.js",
@@ -18,6 +18,9 @@
     "typecheck": "tsc --noEmit",
     "lint": "pnpm run typecheck && biome lint .",
     "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": "npx -y mcporter list oracle-local --schema --config config/mcporter.json && npx -y mcporter call oracle-local.sessions limit:1 --config config/mcporter.json",
     "test:browser": "pnpm run build && ./scripts/browser-smoke.sh",
     "test:live": "ORACLE_LIVE_TEST=1 vitest run tests/live --exclude tests/live/openai-live.test.ts",
     "test:pro": "ORACLE_LIVE_TEST=1 vitest run tests/live/openai-live.test.ts",
@@ -73,6 +76,7 @@
   "devDependencies": {
     "@anthropic-ai/tokenizer": "^0.0.4",
     "@biomejs/biome": "^2.3.5",
+    "@cdktf/node-pty-prebuilt-multiarch": "0.10.2",
     "@types/chrome-remote-interface": "^0.31.14",
     "@types/inquirer": "^9.0.9",
     "@types/json5": "^0.0.30",
@@ -80,6 +84,7 @@
     "@vitest/coverage-v8": "4.0.9",
     "devtools-protocol": "^0.0.1545402",
     "es-toolkit": "^1.42.0",
+    "esbuild": "^0.27.0",
     "puppeteer-core": "^24.30.0",
     "tsx": "^4.20.6",
     "typescript": "^5.9.3",
@@ -94,6 +99,7 @@
       "win-dpapi": "npm:@primno/dpapi@2.0.1"
     },
     "onlyBuiltDependencies": [
+      "@cdktf/node-pty-prebuilt-multiarch",
       "keytar",
       "sqlite3",
       "win-dpapi"