@steipete/oracle 0.19.0 → 0.20.0

package/dist/src/oracle/run.js

@@ -36,6 +36,15 @@ const DEFAULT_TIMEOUT_PRO_MS = 60 * 60 * 1000;
 const GPT_5_6_API_MODELS = new Set(["gpt-5.6", "gpt-5.6-sol", "gpt-5.6-terra", "gpt-5.6-luna"]);
 const REASONING_EFFORTS = new Set(["none", "low", "medium", "high", "xhigh", "max"]);
 const REASONING_MODES = new Set(["standard", "pro"]);
+// Astra has a narrower effort range than the GPT-5.6 API family. Keep this
+// capability separate from GPT_5_6_API_MODELS so adding a model cannot
+// accidentally inherit a family's exact option set.
+const MODEL_REASONING_CAPABILITIES = new Map([
+    [
+        "gpt-6-astra",
+        { efforts: new Set(["low", "medium", "high", "xhigh", "max"]), modes: REASONING_MODES },
+    ],
+]);
 const defaultWait = (ms) => new Promise((resolve) => {
     setTimeout(resolve, ms);
 });
@@ -72,9 +81,13 @@ function runtimeKeySource({ route, providerMode, optionsApiKey, }) {
         return "XAI_API_KEY";
     return optionsApiKey ? "apiKey option" : route.keySource;
 }
-function validateReasoningOptions(options, route) {
+function validateReasoningOptions(options, route, modelConfig) {
     const { reasoningEffort, reasoningMode } = options;
-    if (!reasoningEffort && !reasoningMode)
+    const capabilities = GPT_5_6_API_MODELS.has(options.model)
+        ? { efforts: REASONING_EFFORTS, modes: REASONING_MODES }
+        : MODEL_REASONING_CAPABILITIES.get(options.model);
+    const effectiveEffort = reasoningEffort ?? modelConfig?.reasoning?.effort;
+    if (!reasoningEffort && !reasoningMode && !effectiveEffort)
         return;
     if (reasoningEffort && !REASONING_EFFORTS.has(reasoningEffort)) {
         throw new PromptValidationError(`Invalid reasoning effort "${reasoningEffort}". Expected none, low, medium, high, xhigh, or max.`, { model: options.model, reasoningEffort });
@@ -82,14 +95,20 @@ function validateReasoningOptions(options, route) {
     if (reasoningMode && !REASONING_MODES.has(reasoningMode)) {
         throw new PromptValidationError(`Invalid reasoning mode "${reasoningMode}". Expected standard or pro.`, { model: options.model, reasoningMode });
     }
-    if (!GPT_5_6_API_MODELS.has(options.model)) {
+    if ((reasoningEffort || reasoningMode) && !capabilities) {
         const option = reasoningMode
             ? `Reasoning mode "${reasoningMode}"`
             : `Reasoning effort "${reasoningEffort}"`;
         const guidance = reasoningMode
             ? `Use --model gpt-5.6-sol --reasoning-mode ${reasoningMode}.`
             : `Use --model gpt-5.6-sol --reasoning-effort ${reasoningEffort}.`;
-        throw new PromptValidationError(`${option} is available only for GPT-5.6 API models. ${guidance}`, { model: options.model, reasoningEffort, reasoningMode });
+        throw new PromptValidationError(`${option} is available only for GPT-5.6 or GPT-6 Astra API models. ${guidance}`, { model: options.model, reasoningEffort, reasoningMode });
+    }
+    if (effectiveEffort && capabilities && !capabilities.efforts.has(effectiveEffort)) {
+        throw new PromptValidationError(`Reasoning effort "${effectiveEffort}" is not supported for ${options.model}. Expected low, medium, high, xhigh, or max.`, { model: options.model, reasoningEffort: effectiveEffort, reasoningMode });
+    }
+    if (reasoningMode && capabilities && !capabilities.modes.has(reasoningMode)) {
+        throw new PromptValidationError(`Reasoning mode "${reasoningMode}" is not supported for ${options.model}. Expected standard or pro.`, { model: options.model, reasoningEffort, reasoningMode });
     }
     if (reasoningMode &&
         !route.isAzureOpenAI &&
@@ -166,6 +185,10 @@ export async function runOracle(options, deps = {}) {
         openRouterApiKey: resolverOpenRouterApiKey,
         modelOverrides: options.modelOverrides,
     });
+    // Validate the resolved default as well as explicit flags. This catches a
+    // model override such as Astra + reasoning.effort=none, while allowing an
+    // explicit supported effort to replace an invalid bundled/overridden default.
+    validateReasoningOptions(options, route, modelConfig);
     const isLongRunningModel = isProTierModel;
     const supportsBackground = modelConfig.supportsBackground !== false;
     const useBackground = supportsBackground ? (options.background ?? isLongRunningModel) : false;

package/dist/src/remote/client.js

@@ -13,6 +13,9 @@ import { BrowserRunCancelledError } from "../oracle/errors.js";
 export function createRemoteBrowserExecutor({ host, token }) {
     // Return a drop-in replacement for runBrowserMode so the browser session runner can stay unchanged.
     return async function remoteBrowserExecutor(options) {
+        if (options.config?.researchMode === "search") {
+            throw new Error("Web Search is a local browser pilot; --remote-host does not negotiate this capability yet. Use local Chrome or --browser-attach-running.");
+        }
         const callerSignal = options.signal;
         if (callerSignal?.aborted)
             throw new BrowserRunCancelledError("Browser run cancelled before the request was sent.");

package/dist/src/remote/server.js

@@ -814,6 +814,7 @@ function sanitizeResult(result, warnings = []) {
         answerChars: result.answerChars,
         modelSelection: result.modelSelection,
         thinkingSelection: result.thinkingSelection,
+        researchPlan: result.researchPlan,
         archive: result.archive,
         tabUrl: result.tabUrl,
         conversationId: result.conversationId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steipete/oracle",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description": "CLI wrapper around OpenAI Responses API with GPT-5.6 Sol, GPT-5.6, 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",
@@ -61,7 +61,7 @@
     "@google/genai": "^2.21.0",
     "@google/generative-ai": "^0.24.1",
     "@modelcontextprotocol/server": "^2.0.0",
-    "@steipete/sweet-cookie": "^0.4.2",
+    "@steipete/sweet-cookie": "^0.4.3",
     "chalk": "^6.0.0",
     "chrome-launcher": "^1.2.1",
     "chrome-remote-interface": "^0.34.0",
@@ -79,7 +79,7 @@
     "qs": "^6.16.0",
     "shiki": "^4.4.3",
     "toasted-notifier": "^10.1.0",
-    "tokentally": "^0.1.4",
+    "tokentally": "^0.1.5",
     "zod": "^4.5.4"
   },
   "devDependencies": {