@steipete/oracle 0.18.0 → 0.19.0

package/dist/src/gemini-web/client.js

@@ -1,7 +1,9 @@
+import { randomUUID } from "node:crypto";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import path from "node:path";
-import { buildGeminiWebModelHeader, FALLBACK_GEMINI_WEB_MODEL, } from "./models.js";
-const USER_AGENT = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36";
+import { fetchGeminiWebResource } from "./http.js";
+import { buildGeminiWebModelHeader, FALLBACK_GEMINI_WEB_MODEL, getGeminiWebModelSelection, } from "./models.js";
+const USER_AGENT = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/150.0.0.0 Safari/537.36";
 const MODEL_HEADER_NAME = "x-goog-ext-525001261-jspb";
 const GEMINI_APP_URL = "https://gemini.google.com/app";
 const GEMINI_STREAM_GENERATE_URL = "https://gemini.google.com/_/BardChatUi/data/assistant.lamda.BardFrontendService/StreamGenerate";
@@ -61,7 +63,7 @@ function buildCookieHeader(cookieMap) {
 }
 export async function fetchGeminiAccessToken(cookieMap, signal) {
     const cookieHeader = buildCookieHeader(cookieMap);
-    const res = await fetch(GEMINI_APP_URL, {
+    const res = await fetchGeminiWebResource(GEMINI_APP_URL, {
         redirect: "follow",
         signal,
         headers: {
@@ -112,7 +114,7 @@ function ensureFullSizeImageUrl(url) {
 async function fetchWithCookiePreservingRedirects(url, init, signal, maxRedirects = 10) {
     let current = url;
     for (let i = 0; i <= maxRedirects; i += 1) {
-        const res = await fetch(current, { ...init, redirect: "manual", signal });
+        const res = await fetchGeminiWebResource(current, { ...init, redirect: "manual", signal });
         if (res.status >= 300 && res.status < 400) {
             const location = res.headers.get("location");
             if (!location)
@@ -146,7 +148,7 @@ async function uploadGeminiFile(filePath, signal) {
     const mimeType = resolveGeminiUploadMimeType(absPath);
     const form = new FormData();
     form.append("file", new Blob([data], { type: mimeType }), fileName);
-    const res = await fetch(GEMINI_UPLOAD_URL, {
+    const res = await fetchGeminiWebResource(GEMINI_UPLOAD_URL, {
         method: "POST",
         redirect: "follow",
         signal,
@@ -162,18 +164,38 @@ async function uploadGeminiFile(filePath, signal) {
     }
     return { id: text, name: fileName, mimeType };
 }
-function buildGeminiFReqPayload(prompt, uploaded, chatMetadata) {
-    const promptPayload = uploaded.length > 0
-        ? [
-            prompt,
-            0,
-            null,
-            // Format: [[[fileId, 1, null, "mimeType"], "filename", ...]]
-            uploaded.map((file) => [[file.id, 1, null, file.mimeType], file.name]),
-        ]
-        : [prompt];
-    const innerList = [promptPayload, null, chatMetadata ?? null];
-    return JSON.stringify([null, JSON.stringify(innerList)]);
+function buildGeminiFReqPayload(prompt, uploaded, chatMetadata, model, requestId) {
+    const request = Array(97).fill(null);
+    request[0] = [
+        prompt,
+        0,
+        null,
+        uploaded.map((file) => [[file.id, 1, null, file.mimeType], file.name]),
+        null,
+        null,
+        0,
+    ];
+    request[1] = ["en"];
+    request[2] = chatMetadata ?? ["", "", "", null, null, null, null, null, null, ""];
+    request[6] = [1];
+    request[7] = 1;
+    request[10] = 1;
+    request[11] = 0;
+    request[17] = [[0]];
+    request[18] = 0;
+    request[27] = 1;
+    request[30] = [4];
+    request[41] = [1];
+    request[53] = 0;
+    request[59] = requestId;
+    request[61] = [];
+    request[68] = 2;
+    const selection = getGeminiWebModelSelection(model);
+    request[79] = selection.modelCode;
+    request[80] = selection.thinkingCode;
+    request[91] = 0;
+    request[96] = chatMetadata == null ? 1 : 0;
+    return JSON.stringify([null, JSON.stringify(request)]);
 }
 export function parseGeminiStreamGenerateResponse(rawText) {
     const responseJson = JSON.parse(trimGeminiJsonEnvelope(rawText));
@@ -274,11 +296,12 @@ export async function runGeminiWebOnce(input) {
         }
         uploaded.push(await uploadGeminiFile(file, input.signal));
     }
-    const fReq = buildGeminiFReqPayload(input.prompt, uploaded, input.chatMetadata ?? null);
+    const requestId = randomUUID().toUpperCase();
+    const fReq = buildGeminiFReqPayload(input.prompt, uploaded, input.chatMetadata ?? null, input.model, requestId);
     const params = new URLSearchParams();
     params.set("at", at);
     params.set("f.req", fReq);
-    const res = await fetch(GEMINI_STREAM_GENERATE_URL, {
+    const res = await fetchGeminiWebResource(GEMINI_STREAM_GENERATE_URL, {
         method: "POST",
         redirect: "follow",
         signal: input.signal,
@@ -290,6 +313,9 @@ export async function runGeminiWebOnce(input) {
             "user-agent": USER_AGENT,
             cookie: cookieHeader,
             [MODEL_HEADER_NAME]: buildGeminiWebModelHeader(input.model),
+            "x-goog-ext-73010989-jspb": "[0]",
+            "x-goog-ext-73010990-jspb": "[0]",
+            "x-goog-ext-525005358-jspb": JSON.stringify([requestId, 1]),
         },
         body: params.toString(),
     });
@@ -338,10 +364,30 @@ export async function runGeminiWebOnce(input) {
 export async function runGeminiWebWithFallback(input) {
     const attempt = await runGeminiWebOnce(input);
     if (isGeminiModelUnavailable(attempt.errorCode) && input.model !== FALLBACK_GEMINI_WEB_MODEL) {
+        if (input.allowModelFallback === false) {
+            throw new Error(`Requested Gemini web model ${input.model} is unavailable and model fallback is disabled.`);
+        }
         const fallback = await runGeminiWebOnce({ ...input, model: FALLBACK_GEMINI_WEB_MODEL });
-        return { ...fallback, effectiveModel: FALLBACK_GEMINI_WEB_MODEL };
+        return {
+            ...assertGeminiWebRunSucceeded(fallback),
+            effectiveModel: FALLBACK_GEMINI_WEB_MODEL,
+        };
+    }
+    return { ...assertGeminiWebRunSucceeded(attempt), effectiveModel: input.model };
+}
+function assertGeminiWebRunSucceeded(output) {
+    if (output.errorCode !== undefined) {
+        throw new Error(`Gemini web request failed with error code ${output.errorCode}.`);
+    }
+    if (output.errorMessage) {
+        throw new Error(`Gemini web request failed: ${output.errorMessage}`);
+    }
+    if (!output.text.trim() &&
+        output.images.length === 0 &&
+        extractGgdlUrls(output.rawResponseText).length === 0) {
+        throw new Error("Gemini web request ended without a response.");
     }
-    return { ...attempt, effectiveModel: input.model };
+    return output;
 }
 export async function saveFirstGeminiImageFromOutput(output, cookieMap, outputPath, signal) {
     const generatedOrWeb = output.images.find((img) => img.kind === "generated") ?? output.images[0];

package/dist/src/gemini-web/executor.js

@@ -325,6 +325,7 @@ export function createGeminiWebExecutor(geminiOptions) {
                             cookieMap: cookieResult.cookieMap,
                             chatMetadata: null,
                             signal: controller.signal,
+                            allowModelFallback: geminiOptions.allowModelFallback,
                         });
                         const editPrompt = `Use image generation tool to ${prompt}`;
                         const out = await runGeminiWebWithFallback({
@@ -334,6 +335,7 @@ export function createGeminiWebExecutor(geminiOptions) {
                             cookieMap: cookieResult.cookieMap,
                             chatMetadata: intro.metadata,
                             signal: controller.signal,
+                            allowModelFallback: geminiOptions.allowModelFallback,
                         });
                         response = {
                             text: out.text ?? null,
@@ -357,6 +359,7 @@ export function createGeminiWebExecutor(geminiOptions) {
                             cookieMap: cookieResult.cookieMap,
                             chatMetadata: null,
                             signal: controller.signal,
+                            allowModelFallback: geminiOptions.allowModelFallback,
                         });
                         response = {
                             text: out.text ?? null,
@@ -379,6 +382,7 @@ export function createGeminiWebExecutor(geminiOptions) {
                             cookieMap: cookieResult.cookieMap,
                             chatMetadata: null,
                             signal: controller.signal,
+                            allowModelFallback: geminiOptions.allowModelFallback,
                         });
                         response = {
                             text: out.text ?? null,

package/dist/src/gemini-web/http.js

@@ -0,0 +1,15 @@
+export async function fetchGeminiWebResource(url, init = {}) {
+    try {
+        return await fetch(url, init);
+    }
+    catch (error) {
+        const cause = error instanceof Error ? error.cause : undefined;
+        if (cause &&
+            typeof cause === "object" &&
+            "code" in cause &&
+            cause.code === "UND_ERR_HEADERS_OVERFLOW") {
+            throw new Error("Gemini response headers exceed Node's configured limit. Start Oracle with NODE_OPTIONS=--max-http-header-size=65536 (preserving any existing Node options) and retry.", { cause: error });
+        }
+        throw error;
+    }
+}

package/dist/src/gemini-web/models.js

@@ -6,29 +6,29 @@ const MODEL_SPECS = {
         hash: "1d44b34bcaa1c04d",
         modelCode: 6,
         thinkingCode: 1,
+        capacity: 2,
     },
     "gemini-3.5-flash": {
         hash: "56fdd199312815e2",
         modelCode: 1,
         thinkingCode: 1,
+        capacity: 2,
     },
     "gemini-3.1-pro": {
-        hash: "797f3d0293f288ad",
+        hash: "e6fa609c3fa255c0",
         modelCode: 3,
         thinkingCode: 1,
+        capacity: 2,
     },
     "gemini-3-pro-deep-think": {
-        hash: "797f3d0293f288ad",
-        modelCode: 3,
-        thinkingCode: 3,
+        hash: "e051ce1aa80aa576",
+        modelCode: 5,
+        thinkingCode: 2,
+        capacity: 2,
     },
 };
-let clientId;
-function getGeminiWebClientId() {
-    clientId ??= randomUUID().toUpperCase();
-    return clientId;
-}
-export function buildGeminiWebModelHeader(model, webClientId = getGeminiWebClientId()) {
+const clientId = randomUUID().toUpperCase();
+export function buildGeminiWebModelHeader(model, webClientId = clientId) {
     const spec = MODEL_SPECS[model];
     return JSON.stringify([
         1,
@@ -42,7 +42,7 @@ export function buildGeminiWebModelHeader(model, webClientId = getGeminiWebClien
         [4, 5, 6, 8],
         null,
         null,
-        3,
+        spec.capacity,
         null,
         null,
         spec.modelCode,
@@ -50,6 +50,10 @@ export function buildGeminiWebModelHeader(model, webClientId = getGeminiWebClien
         webClientId,
     ]);
 }
+export function getGeminiWebModelSelection(model) {
+    const { modelCode, thinkingCode } = MODEL_SPECS[model];
+    return { modelCode, thinkingCode };
+}
 export function resolveGeminiWebModel(desiredModel, log) {
     const desired = typeof desiredModel === "string" ? desiredModel.trim() : "";
     if (!desired)

package/dist/src/mcp/server.js

@@ -2,15 +2,16 @@
 import "dotenv/config";
 import process from "node:process";
 import { pathToFileURL } from "node:url";
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { McpServer } from "@modelcontextprotocol/server";
+import { serveStdio } from "@modelcontextprotocol/server/stdio";
 import { getCliVersion } from "../version.js";
 import { registerChatGptImageTool } from "./tools/chatgptImage.js";
 import { registerConsultTool } from "./tools/consult.js";
 import { registerProjectSourcesTool } from "./tools/projectSources.js";
 import { registerSessionsTool } from "./tools/sessions.js";
+import { registerWaitTool } from "./tools/wait.js";
 import { registerSessionResources } from "./tools/sessionResources.js";
-export async function startMcpServer() {
+export function createMcpServer() {
     const server = new McpServer({
         name: "oracle-mcp",
         version: getCliVersion(),
@@ -23,19 +24,15 @@ export async function startMcpServer() {
     registerChatGptImageTool(server);
     registerProjectSourcesTool(server);
     registerSessionsTool(server);
+    registerWaitTool(server);
     registerSessionResources(server);
-    const transport = new StdioServerTransport();
-    transport.onerror = (error) => {
-        console.error("MCP transport error:", error);
-    };
-    const closed = new Promise((resolve) => {
-        transport.onclose = () => {
-            resolve();
-        };
+    return server;
+}
+export async function startMcpServer() {
+    serveStdio(createMcpServer, {
+        legacy: "serve",
+        onerror: (error) => console.error("MCP transport error:", error),
     });
-    // Keep the process alive until the client closes the transport.
-    await server.connect(transport);
-    await closed;
 }
 export function shouldStartMcpServerFromModule(moduleUrl = import.meta.url, argv1 = process.argv[1]) {
     return argv1 ? moduleUrl === pathToFileURL(argv1).href : false;

package/dist/src/mcp/tools/chatgptImage.js

@@ -101,9 +101,9 @@ export function registerChatGptImageTool(server) {
     server.registerTool("chatgpt_image", {
         title: "Generate an image with ChatGPT",
         description: "Agent-friendly wrapper for ChatGPT browser image generation. It selects browser mode, enables the image-aware wait/download path, uploads reference files when provided, and returns saved image paths in structuredContent.images.",
-        inputSchema: chatGptImageInputShape,
-        outputSchema: chatGptImageOutputShape,
-    }, async (input) => {
+        inputSchema: z.object(chatGptImageInputShape),
+        outputSchema: z.object(chatGptImageOutputShape),
+    }, async (input, context) => {
         const textContent = (text) => [{ type: "text", text }];
         let parsed;
         try {
@@ -116,7 +116,7 @@ export function registerChatGptImageTool(server) {
             };
         }
         const consultInput = buildChatGptImageConsultInput(parsed);
-        const result = await runConsultTool(consultInput, { server: server.server });
+        const result = await runConsultTool(consultInput, { log: context.mcpReq.log });
         if (result.isError || !result.structuredContent) {
             return result;
         }

package/dist/src/mcp/tools/consult.js

@@ -1,11 +1,10 @@
 import { z } from "zod";
 import { getCliVersion } from "../../version.js";
-import { LoggingMessageNotificationParamsSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { ensureBrowserAvailable, mapConsultToRunOptions } from "../utils.js";
 import { sessionStore } from "../../sessionStore.js";
 import { resolveRemoteServiceConfig } from "../../remote/remoteServiceConfig.js";
 import { createRemoteBrowserExecutor } from "../../remote/client.js";
-async function readSessionLogTail(sessionId, maxBytes) {
+export async function readSessionLogTail(sessionId, maxBytes) {
     try {
         const log = await sessionStore.readLog(sessionId);
         if (log.length <= maxBytes) {
@@ -26,7 +25,9 @@ import { loadUserConfig } from "../../config.js";
 import { resolveNotificationSettings } from "../../cli/notifier.js";
 import { mapModelToBrowserLabel, resolveBrowserModelLabel, resolveDefaultBrowserThinkingTime, } from "../../cli/browserConfig.js";
 import { normalizeThinkingTimeLevel } from "../../oracle/thinkingTime.js";
-// Use raw shapes so the MCP SDK (with its bundled Zod) wraps them and emits valid JSON Schema.
+import { launchDetachedSession } from "../../cli/detachedSession.js";
+import { buildSessionLifecycle } from "../../cli/sessionLifecycle.js";
+// Shared fields are composed into explicit schemas when registering tools.
 const consultInputShape = {
     preset: z
         .enum(CONSULT_PRESETS)
@@ -60,11 +61,11 @@ const consultInputShape = {
     browserBundleFiles: z
         .boolean()
         .optional()
-        .describe("Browser-only: bundle many files into a single upload (helps with upload limits)."),
+        .describe("Browser-only: force one upload bundle; auto/zip includes all resolved files. Multiple text/source uploads already bundle by default (flattened text unless ZIP is selected)."),
     browserBundleFormat: z
         .enum(["auto", "text", "zip"])
         .optional()
-        .describe('Browser-only: bundle upload format when browserBundleFiles is true or auto-bundling is needed. Defaults to "auto"; "auto" uses ZIP when bundled inputs include raw/binary files.'),
+        .describe('Browser-only: bundle upload format. Defaults to "auto", which keeps flattened text for text-only uploads and uses ZIP when raw files are present; "zip" forces a byte-preserving archive.'),
     browserThinkingTime: browserThinkingTimeRawSchema
         .optional()
         .describe("Browser-only: set ChatGPT thinking time when supported by the chosen model."),
@@ -96,6 +97,10 @@ const consultInputShape = {
         .string()
         .optional()
         .describe("Browser-only image output fallback path, mirroring the CLI --output option for image operations."),
+    waitForCompletion: z
+        .boolean()
+        .optional()
+        .describe("When false, start the Oracle run in a detached worker and return its sessionId immediately. Use the wait tool to block for completion without agent-side polling. Defaults to true for compatibility."),
     dryRun: z
         .boolean()
         .optional()
@@ -109,7 +114,7 @@ const consultInputShape = {
         .optional()
         .describe("Optional human-friendly session id (used for later `oracle sessions` lookups)."),
 };
-const consultModelSummaryShape = z.object({
+export const consultModelSummaryShape = z.object({
     model: z.string(),
     status: z.string(),
     startedAt: z.string().optional(),
@@ -138,14 +143,14 @@ const consultModelSummaryShape = z.object({
         .optional(),
     logPath: z.string().optional(),
 });
-const consultArtifactSummaryShape = z.object({
+export const consultArtifactSummaryShape = z.object({
     kind: z.enum(["transcript", "deep-research-report", "image", "file"]),
     path: z.string(),
     label: z.string().optional(),
     mimeType: z.string().optional(),
     sizeBytes: z.number().optional(),
 });
-const consultImageSummaryShape = consultArtifactSummaryShape.extend({
+export const consultImageSummaryShape = consultArtifactSummaryShape.extend({
     kind: z.literal("image"),
     alt: z.string().optional(),
     width: z.number().optional(),
@@ -185,6 +190,7 @@ export const consultOutputShape = {
     models: z.array(consultModelSummaryShape).optional(),
     artifacts: z.array(consultArtifactSummaryShape).optional(),
     images: z.array(consultImageSummaryShape).optional(),
+    detached: z.boolean().optional(),
 };
 export function summarizeModelRunsForConsult(runs) {
     if (!runs || runs.length === 0) {
@@ -387,7 +393,7 @@ export function formatConsultDryRunResolved(details) {
     }
     return lines;
 }
-export async function runConsultTool(input, { server }) {
+export async function runConsultTool(input, { log: requestLog, launchDetached = launchDetachedSession, }) {
     const textContent = (text) => [{ type: "text", text }];
     let parsedInput;
     try {
@@ -399,7 +405,7 @@ export async function runConsultTool(input, { server }) {
             content: textContent(error instanceof Error ? error.message : String(error)),
         };
     }
-    const { prompt, files, model, models, engine, search, browserModelLabel, browserAttachments, browserBundleFiles, browserBundleFormat, browserThinkingTime, browserModelStrategy, browserResearchMode, browserArchive, browserFollowUps, browserKeepBrowser, generateImage, outputPath, dryRun, slug, } = parsedInput;
+    const { prompt, files, model, models, engine, search, browserModelLabel, browserAttachments, browserBundleFiles, browserBundleFormat, browserThinkingTime, browserModelStrategy, browserResearchMode, browserArchive, browserFollowUps, browserKeepBrowser, generateImage, outputPath, waitForCompletion = true, dryRun, slug, } = parsedInput;
     const { config: userConfig } = await loadUserConfig();
     let runOptions;
     let resolvedEngine;
@@ -428,12 +434,7 @@ export async function runConsultTool(input, { server }) {
         };
     }
     const cwd = process.cwd();
-    const sendLog = (text, level = "info") => server
-        .sendLoggingMessage(LoggingMessageNotificationParamsSchema.parse({
-        level,
-        data: { text, bytes: Buffer.byteLength(text, "utf8") },
-    }))
-        .catch(() => { });
+    const sendLog = (text, level = "info") => requestLog(level, { text, bytes: Buffer.byteLength(text, "utf8") }).catch(() => { });
     const resolvedRemote = resolveRemoteServiceConfig({ userConfig, env: process.env });
     const imageOutputPath = runOptions.generateImage ?? runOptions.outputPath;
     if (resolvedEngine === "browser" && resolvedRemote.host && imageOutputPath) {
@@ -490,6 +491,18 @@ export async function runConsultTool(input, { server }) {
             },
         };
     }
+    if (!waitForCompletion && resolvedEngine === "browser" && resolvedRemote.host) {
+        return {
+            isError: true,
+            content: textContent("Detached MCP consults are not supported with a remote browser service yet. Keep waitForCompletion:true for this run."),
+        };
+    }
+    if (!waitForCompletion && process.env.ORACLE_NO_DETACH === "1") {
+        return {
+            isError: true,
+            content: textContent("Detached MCP consults are disabled by ORACLE_NO_DETACH=1. Remove it or keep waitForCompletion:true."),
+        };
+    }
     const browserGuard = ensureBrowserAvailable(resolvedEngine, {
         remoteHost: resolvedRemote.host,
     });
@@ -525,8 +538,58 @@ export async function runConsultTool(input, { server }) {
         mode: resolvedEngine,
         slug,
         browserConfig,
-        waitPreference: true,
+        waitPreference: waitForCompletion,
     }, cwd, notifications);
+    if (!waitForCompletion) {
+        try {
+            await launchDetached({
+                sessionId: sessionMeta.id,
+                prepare: async (workerPid) => {
+                    const lifecycle = buildSessionLifecycle({
+                        engine: resolvedEngine,
+                        detached: true,
+                        workerPid,
+                        reattachCommand: `oracle session ${sessionMeta.id}`,
+                    });
+                    await sessionStore.updateSession(sessionMeta.id, {
+                        status: "running",
+                        startedAt: new Date().toISOString(),
+                        lifecycle,
+                    });
+                },
+            });
+            const started = (await sessionStore.readSession(sessionMeta.id)) ?? sessionMeta;
+            const summary = `Session ${sessionMeta.id} (${started.status}; detached)`;
+            return {
+                content: textContent(`${summary}\nUse the wait tool with id=${JSON.stringify(sessionMeta.id)} to wait without polling.`),
+                structuredContent: {
+                    sessionId: sessionMeta.id,
+                    status: started.status,
+                    output: "",
+                    models: summarizeModelRunsForConsult(started.models),
+                    artifacts: summarizeArtifactsForConsult(started.artifacts),
+                    images: summarizeImageArtifactsForConsult(started.artifacts),
+                    detached: true,
+                },
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            await sessionStore
+                .updateSession(sessionMeta.id, {
+                status: "error",
+                completedAt: new Date().toISOString(),
+                errorMessage: message,
+                response: { status: "error" },
+                error: { category: "internal", message },
+            })
+                .catch(() => undefined);
+            return {
+                isError: true,
+                content: textContent(`Unable to start detached session ${sessionMeta.id}: ${message}`),
+            };
+        }
+    }
     const logWriter = sessionStore.createLogWriter(sessionMeta.id);
     // Stream logs to both the session log and MCP logging notifications, but avoid buffering in memory
     const log = (line) => {
@@ -594,9 +657,8 @@ export async function runConsultTool(input, { server }) {
 export function registerConsultTool(server) {
     server.registerTool("consult", {
         title: "Run an oracle session",
-        description: 'Run an Oracle session (API or ChatGPT browser automation). Use `files` to attach project context. If `engine` is omitted, Oracle follows CLI defaults: config/ORACLE_ENGINE first, then API when OPENAI_API_KEY is set, otherwise browser. Browser GPT-5.5 Pro consults can take many minutes; use `dryRun:true` first when configuring an agent and inspect `sessions`/`oracle status` before retrying. Browser manual-login uses a private Oracle Chrome profile separate from the user\'s normal Chrome; dry-run output includes first-time setup guidance when that path is active. For browser-based image/file uploads, set `browserAttachments:"always"`. For ChatGPT image generation, set `generateImage` to enable the same image wait/download path as CLI --generate-image and read returned paths from `images`. Browser consults can include `browserFollowUps` for a multi-turn ChatGPT review in one conversation. Sessions are stored under `ORACLE_HOME_DIR` (shared with the CLI).',
-        // Cast to any to satisfy SDK typings across differing Zod versions.
-        inputSchema: consultInputShape,
-        outputSchema: consultOutputShape,
-    }, async (input) => runConsultTool(input, { server: server.server }));
+        description: 'Run an Oracle session (API or ChatGPT browser automation). Use `files` to attach project context. If `engine` is omitted, Oracle follows CLI defaults: config/ORACLE_ENGINE first, then API when OPENAI_API_KEY is set, otherwise browser. Browser GPT-5.5 Pro consults can take many minutes; set `waitForCompletion:false` to return a durable sessionId immediately, then use `wait` to block without agent-side polling. Use `dryRun:true` first when configuring an agent and inspect `sessions`/`oracle status` before retrying. Browser manual-login uses a private Oracle Chrome profile separate from the user\'s normal Chrome; dry-run output includes first-time setup guidance when that path is active. For browser-based image/file uploads, set `browserAttachments:"always"`. For ChatGPT image generation, set `generateImage` to enable the same image wait/download path as CLI --generate-image and read returned paths from `images`. Browser consults can include `browserFollowUps` for a multi-turn ChatGPT review in one conversation. Sessions are stored under `ORACLE_HOME_DIR` (shared with the CLI).',
+        inputSchema: z.object(consultInputShape),
+        outputSchema: z.object(consultOutputShape),
+    }, async (input, context) => runConsultTool(input, { log: context.mcpReq.log }));
 }

package/dist/src/mcp/tools/projectSources.js

@@ -56,9 +56,9 @@ export function registerProjectSourcesTool(server) {
     server.registerTool("project_sources", {
         title: "Manage ChatGPT Project Sources",
         description: "List or append files to a ChatGPT Project's persistent Sources tab. This is useful for Developer Mode workflows where chats do not share memory, but explicit project sources provide shared context. Destructive delete/replace/sync operations are intentionally not included in v1.",
-        inputSchema: projectSourcesInputShape,
-        outputSchema: projectSourcesOutputShape,
-    }, async (input) => {
+        inputSchema: z.object(projectSourcesInputShape),
+        outputSchema: z.object(projectSourcesOutputShape),
+    }, async (input, context) => {
         const textContent = (text) => [{ type: "text", text }];
         let parsed;
         try {
@@ -107,9 +107,7 @@ export function registerProjectSourcesTool(server) {
             dryRun: parsed.dryRun,
             config: browserConfig,
             log: (message) => {
-                server.server
-                    .sendLoggingMessage({ level: "info", data: { text: message } })
-                    .catch(() => undefined);
+                context.mcpReq.log("info", { text: message }).catch(() => undefined);
             },
         });
         const output = result.status === "dry-run"

package/dist/src/mcp/tools/sessionResources.js

@@ -1,4 +1,4 @@
-import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ResourceTemplate } from "@modelcontextprotocol/server";
 import fs from "node:fs/promises";
 import { sessionStore } from "../../sessionStore.js";
 // URIs:

package/dist/src/mcp/tools/sessions.js

@@ -44,8 +44,8 @@ export function registerSessionsTool(server) {
     server.registerTool("sessions", {
         title: "List or fetch oracle sessions",
         description: "Inspect Oracle session history stored under `ORACLE_HOME_DIR` (shared with the CLI). List recent sessions or fetch one by id/slug (optionally including metadata + request + log).",
-        inputSchema: sessionsInputShape,
-        outputSchema: sessionsOutputShape,
+        inputSchema: z.object(sessionsInputShape),
+        outputSchema: z.object(sessionsOutputShape),
     }, async (input) => {
         const textContent = (text) => [{ type: "text", text }];
         const { id, hours = 24, limit = 100, includeAll = false, detail = false, } = sessionsInputSchema.parse(input);