@steipete/oracle 0.9.0 → 0.10.0

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

@@ -1,32 +1,32 @@
-import path from 'node:path';
-import { getCookies } from '@steipete/sweet-cookie';
-import { runProviderDomFlow } from '../browser/providerDomFlow.js';
-import { delay } from '../browser/utils.js';
-import { runGeminiWebWithFallback, saveFirstGeminiImageFromOutput } from './client.js';
-import { geminiDeepThinkDomProvider } from '../browser/providers/index.js';
-import { openGeminiBrowserSession } from './browserSessionManager.js';
-import { selectGeminiExecutionMode } from './executionMode.js';
+import path from "node:path";
+import { getCookies } from "@steipete/sweet-cookie";
+import { runProviderDomFlow } from "../browser/providerDomFlow.js";
+import { delay } from "../browser/utils.js";
+import { runGeminiWebWithFallback, saveFirstGeminiImageFromOutput } from "./client.js";
+import { geminiDeepThinkDomProvider } from "../browser/providers/index.js";
+import { openGeminiBrowserSession } from "./browserSessionManager.js";
+import { selectGeminiExecutionMode } from "./executionMode.js";
 const GEMINI_COOKIE_NAMES = [
-    '__Secure-1PSID',
-    '__Secure-1PSIDTS',
-    '__Secure-1PSIDCC',
-    '__Secure-1PAPISID',
-    'NID',
-    'AEC',
-    'SOCS',
-    '__Secure-BUCKET',
-    '__Secure-ENID',
-    'SID',
-    'HSID',
-    'SSID',
-    'APISID',
-    'SAPISID',
-    '__Secure-3PSID',
-    '__Secure-3PSIDTS',
-    '__Secure-3PAPISID',
-    'SIDCC',
+    "__Secure-1PSID",
+    "__Secure-1PSIDTS",
+    "__Secure-1PSIDCC",
+    "__Secure-1PAPISID",
+    "NID",
+    "AEC",
+    "SOCS",
+    "__Secure-BUCKET",
+    "__Secure-ENID",
+    "SID",
+    "HSID",
+    "SSID",
+    "APISID",
+    "SAPISID",
+    "__Secure-3PSID",
+    "__Secure-3PSIDTS",
+    "__Secure-3PAPISID",
+    "SIDCC",
 ];
-const GEMINI_REQUIRED_COOKIES = ['__Secure-1PSID', '__Secure-1PSIDTS'];
+const GEMINI_REQUIRED_COOKIES = ["__Secure-1PSID", "__Secure-1PSIDTS"];
 function estimateTokenCount(text) {
     return Math.ceil(text.length / 4);
 }
@@ -39,33 +39,33 @@ function resolveInvocationPath(value) {
     return path.isAbsolute(trimmed) ? trimmed : path.resolve(process.cwd(), trimmed);
 }
 function resolveGeminiWebModel(desiredModel, log) {
-    const desired = typeof desiredModel === 'string' ? desiredModel.trim() : '';
+    const desired = typeof desiredModel === "string" ? desiredModel.trim() : "";
     if (!desired)
-        return 'gemini-3-pro';
-    const normalized = desired.toLowerCase().replace(/[_\s]+/g, '-');
+        return "gemini-3-pro";
+    const normalized = desired.toLowerCase().replace(/[_\s]+/g, "-");
     switch (normalized) {
-        case 'gemini-3-pro':
-        case 'gemini-3.0-pro':
-            return 'gemini-3-pro';
-        case 'gemini-3-deep-think':
-        case 'gemini-3-pro-deep-think':
-        case 'gemini-3-pro-deepthink':
-            return 'gemini-3-pro-deep-think';
-        case 'gemini-2.5-pro':
-            return 'gemini-2.5-pro';
-        case 'gemini-2.5-flash':
-            return 'gemini-2.5-flash';
+        case "gemini-3-pro":
+        case "gemini-3.0-pro":
+            return "gemini-3-pro";
+        case "gemini-3-deep-think":
+        case "gemini-3-pro-deep-think":
+        case "gemini-3-pro-deepthink":
+            return "gemini-3-pro-deep-think";
+        case "gemini-2.5-pro":
+            return "gemini-2.5-pro";
+        case "gemini-2.5-flash":
+            return "gemini-2.5-flash";
         default:
-            if (normalized.startsWith('gemini-') || normalized.includes('gemini')) {
+            if (normalized.startsWith("gemini-") || normalized.includes("gemini")) {
                 log?.(`[gemini-web] Unsupported Gemini web model "${desired}". Falling back to gemini-3-pro.`);
             }
-            return 'gemini-3-pro';
+            return "gemini-3-pro";
     }
 }
 function resolveCookieDomain(cookie) {
     const rawDomain = cookie.domain?.trim();
     if (rawDomain) {
-        return rawDomain.startsWith('.') ? rawDomain.slice(1) : rawDomain;
+        return rawDomain.startsWith(".") ? rawDomain.slice(1) : rawDomain;
     }
     const rawUrl = cookie.url?.trim();
     if (rawUrl) {
@@ -79,14 +79,14 @@ function resolveCookieDomain(cookie) {
     return null;
 }
 function pickCookieValue(cookies, name) {
-    const matches = cookies.filter((cookie) => cookie.name === name && typeof cookie.value === 'string');
+    const matches = cookies.filter((cookie) => cookie.name === name && typeof cookie.value === "string");
     if (matches.length === 0)
         return undefined;
     const preferredDomain = matches.find((cookie) => {
         const domain = resolveCookieDomain(cookie);
-        return domain === 'google.com' && (cookie.path ?? '/') === '/';
+        return domain === "google.com" && (cookie.path ?? "/") === "/";
     });
-    const googleDomain = matches.find((cookie) => (resolveCookieDomain(cookie) ?? '').endsWith('google.com'));
+    const googleDomain = matches.find((cookie) => (resolveCookieDomain(cookie) ?? "").endsWith("google.com"));
     return (preferredDomain ?? googleDomain ?? matches[0])?.value;
 }
 function buildGeminiCookieMap(cookies) {
@@ -102,15 +102,15 @@ function hasRequiredGeminiCookies(cookieMap) {
     return GEMINI_REQUIRED_COOKIES.every((name) => Boolean(cookieMap[name]));
 }
 const GEMINI_CDP_COOKIE_URLS = [
-    'https://gemini.google.com',
-    'https://accounts.google.com',
-    'https://www.google.com',
+    "https://gemini.google.com",
+    "https://accounts.google.com",
+    "https://www.google.com",
 ];
 async function loadGeminiCookiesFromCDP(browserConfig, log) {
     const session = await openGeminiBrowserSession({
         browserConfig,
         keepBrowserDefault: false,
-        purpose: 'Gemini manual-login cookie extraction (no keychain)',
+        purpose: "Gemini manual-login cookie extraction (no keychain)",
         log,
     });
     try {
@@ -118,8 +118,8 @@ async function loadGeminiCookiesFromCDP(browserConfig, log) {
         const { Network, Page } = client;
         await Network.enable({});
         await Page.enable();
-        log?.('[gemini-web] Navigating to gemini.google.com for sign-in/cookie capture...');
-        await Page.navigate({ url: 'https://gemini.google.com' });
+        log?.("[gemini-web] Navigating to gemini.google.com for sign-in/cookie capture...");
+        await Page.navigate({ url: "https://gemini.google.com" });
         await delay(2_000);
         const pollTimeoutMs = 5 * 60_000;
         const pollIntervalMs = 2_000;
@@ -135,12 +135,12 @@ async function loadGeminiCookiesFromCDP(browserConfig, log) {
             }
             const now = Date.now();
             if (now - lastNotice > 10_000) {
-                log?.('[gemini-web] Waiting for Google sign-in... please sign in in the opened Chrome window.');
+                log?.("[gemini-web] Waiting for Google sign-in... please sign in in the opened Chrome window.");
                 lastNotice = now;
             }
             await delay(pollIntervalMs);
         }
-        throw new Error('Timed out waiting for Google sign-in (5 minutes). Please sign in and retry.');
+        throw new Error("Timed out waiting for Google sign-in (5 minutes). Please sign in and retry.");
     }
     finally {
         await session.close();
@@ -150,17 +150,19 @@ async function runGeminiDeepThinkViaBrowser(prompt, browserConfig, log) {
     const session = await openGeminiBrowserSession({
         browserConfig,
         keepBrowserDefault: true,
-        purpose: 'Gemini Deep Think',
+        purpose: "Gemini Deep Think",
         log,
     });
     try {
         const client = session.client;
         const { Runtime, Page } = client;
-        if (!Runtime || typeof Runtime.enable !== 'function' || typeof Runtime.evaluate !== 'function') {
-            throw new Error('Chrome Runtime domain unavailable for Gemini Deep Think DOM automation.');
+        if (!Runtime ||
+            typeof Runtime.enable !== "function" ||
+            typeof Runtime.evaluate !== "function") {
+            throw new Error("Chrome Runtime domain unavailable for Gemini Deep Think DOM automation.");
         }
-        if (!Page || typeof Page.enable !== 'function' || typeof Page.navigate !== 'function') {
-            throw new Error('Chrome Page domain unavailable for Gemini Deep Think DOM automation.');
+        if (!Page || typeof Page.enable !== "function" || typeof Page.navigate !== "function") {
+            throw new Error("Chrome Page domain unavailable for Gemini Deep Think DOM automation.");
         }
         await Runtime.enable();
         await Page.enable();
@@ -168,8 +170,8 @@ async function runGeminiDeepThinkViaBrowser(prompt, browserConfig, log) {
             const { result } = await Runtime.evaluate({ expression, returnByValue: true });
             return result?.value;
         };
-        log?.('[gemini-web] Navigating to gemini.google.com...');
-        await Page.navigate({ url: 'https://gemini.google.com/app' });
+        log?.("[gemini-web] Navigating to gemini.google.com...");
+        await Page.navigate({ url: "https://gemini.google.com/app" });
         await delay(3_000);
         const domResult = await runProviderDomFlow(geminiDeepThinkDomProvider, {
             prompt,
@@ -192,13 +194,13 @@ async function loadGeminiCookiesFromInline(browserConfig, log) {
     const inline = browserConfig?.inlineCookies;
     if (!inline || inline.length === 0)
         return { cookieMap: {}, warnings: [] };
-    const cookieMap = buildGeminiCookieMap(inline.filter((cookie) => Boolean(cookie?.name && typeof cookie.value === 'string')));
+    const cookieMap = buildGeminiCookieMap(inline.filter((cookie) => Boolean(cookie?.name && typeof cookie.value === "string")));
     if (Object.keys(cookieMap).length > 0) {
-        const source = browserConfig?.inlineCookiesSource ?? 'inline';
+        const source = browserConfig?.inlineCookiesSource ?? "inline";
         log?.(`[gemini-web] Loaded Gemini cookies from inline payload (${source}): ${Object.keys(cookieMap).length} cookie(s).`);
     }
     else {
-        log?.('[gemini-web] Inline cookie payload provided but no Gemini cookies matched.');
+        log?.("[gemini-web] Inline cookie payload provided but no Gemini cookies matched.");
     }
     return { cookieMap, warnings: [] };
 }
@@ -206,42 +208,42 @@ async function loadGeminiCookiesFromChrome(browserConfig, log) {
     try {
         // Learned: Gemini web relies on Google auth cookies in the *browser* profile, not API keys.
         const profileCandidate = browserConfig?.chromeCookiePath ?? browserConfig?.chromeProfile ?? undefined;
-        const profile = typeof profileCandidate === 'string' && profileCandidate.trim().length > 0
+        const profile = typeof profileCandidate === "string" && profileCandidate.trim().length > 0
             ? profileCandidate.trim()
             : undefined;
         const sources = [
-            'https://gemini.google.com',
-            'https://accounts.google.com',
-            'https://www.google.com',
+            "https://gemini.google.com",
+            "https://accounts.google.com",
+            "https://www.google.com",
         ];
         const { cookies, warnings } = await getCookies({
             url: sources[0],
             origins: sources,
             names: [...GEMINI_COOKIE_NAMES],
-            browsers: ['chrome'],
-            mode: 'merge',
+            browsers: ["chrome"],
+            mode: "merge",
             chromeProfile: profile,
             timeoutMs: 5_000,
         });
         if (warnings.length && log?.verbose) {
-            log(`[gemini-web] Cookie warnings:\n- ${warnings.join('\n- ')}`);
+            log(`[gemini-web] Cookie warnings:\n- ${warnings.join("\n- ")}`);
         }
         const cookieMap = buildGeminiCookieMap(cookies);
         log?.(`[gemini-web] Loaded Gemini cookies from Chrome (node): ${Object.keys(cookieMap).length} cookie(s).`);
         return { cookieMap, warnings };
     }
     catch (error) {
-        log?.(`[gemini-web] Failed to load Chrome cookies via node: ${error instanceof Error ? error.message : String(error ?? '')}`);
+        log?.(`[gemini-web] Failed to load Chrome cookies via node: ${error instanceof Error ? error.message : String(error ?? "")}`);
         return { cookieMap: {}, warnings: [] };
     }
 }
 function formatGeminiCookieError(warnings) {
-    const base = 'Gemini browser mode requires Chrome cookies for google.com (missing __Secure-1PSID/__Secure-1PSIDTS).';
-    const guidance = 'Try --browser-manual-login or --browser-inline-cookies-file if local cookie extraction is unavailable.';
+    const base = "Gemini browser mode requires Chrome cookies for google.com (missing __Secure-1PSID/__Secure-1PSIDTS).";
+    const guidance = "Try --browser-manual-login or --browser-inline-cookies-file if local cookie extraction is unavailable.";
     if (warnings.length === 0) {
         return `${base} ${guidance}`;
     }
-    return `${base}\nCookie read warnings:\n- ${warnings.join('\n- ')}\n${guidance}`;
+    return `${base}\nCookie read warnings:\n- ${warnings.join("\n- ")}\n${guidance}`;
 }
 async function loadGeminiCookies(browserConfig, log, options) {
     const inlineResult = await loadGeminiCookiesFromInline(browserConfig, log);
@@ -251,7 +253,7 @@ async function loadGeminiCookies(browserConfig, log, options) {
     }
     const manualNoKeychain = Boolean(browserConfig?.manualLogin) || Boolean(options?.preferManualNoKeychain);
     if (manualNoKeychain) {
-        log?.('[gemini-web] Using manual-login cookie extraction path (no keychain cookie read).');
+        log?.("[gemini-web] Using manual-login cookie extraction path (no keychain cookie read).");
         const cdpResult = await loadGeminiCookiesFromCDP(browserConfig, log);
         return {
             cookieMap: { ...cdpResult.cookieMap, ...inlineResult.cookieMap },
@@ -259,7 +261,7 @@ async function loadGeminiCookies(browserConfig, log, options) {
         };
     }
     if (browserConfig?.cookieSync === false && !hasInlineRequired) {
-        log?.('[gemini-web] Cookie sync disabled and inline cookies missing Gemini auth tokens.');
+        log?.("[gemini-web] Cookie sync disabled and inline cookies missing Gemini auth tokens.");
         return inlineResult;
     }
     const chromeResult = await loadGeminiCookiesFromChrome(browserConfig, log);
@@ -272,7 +274,7 @@ export function createGeminiWebExecutor(geminiOptions) {
     return async (runOptions) => {
         const startTime = Date.now();
         const log = runOptions.log;
-        log?.('[gemini-web] Starting Gemini web executor (TypeScript)');
+        log?.("[gemini-web] Starting Gemini web executor (TypeScript)");
         const model = resolveGeminiWebModel(runOptions.config?.desiredModel, log);
         const generateImagePath = resolveInvocationPath(geminiOptions.generateImage);
         const editImagePath = resolveInvocationPath(geminiOptions.editImage);
@@ -295,9 +297,9 @@ export function createGeminiWebExecutor(geminiOptions) {
             editImagePath,
         });
         const domClient = {
-            mode: 'dom',
+            mode: "dom",
             execute: async () => {
-                log?.('[gemini-web] Using browser DOM automation for Deep Think.');
+                log?.("[gemini-web] Using browser DOM automation for Deep Think.");
                 const browserResult = await runGeminiDeepThinkViaBrowser(prompt, runOptions.config, log);
                 const tookMs = Date.now() - startTime;
                 let answerMarkdown = browserResult.text;
@@ -315,14 +317,17 @@ export function createGeminiWebExecutor(geminiOptions) {
             },
         };
         const httpClient = {
-            mode: 'http',
+            mode: "http",
             execute: async () => {
                 const useNoKeychainPath = Boolean(runOptions.config?.manualLogin);
-                const cookieResult = await loadGeminiCookies(runOptions.config, log, { preferManualNoKeychain: useNoKeychainPath });
+                const cookieResult = await loadGeminiCookies(runOptions.config, log, {
+                    preferManualNoKeychain: useNoKeychainPath,
+                });
                 if (!hasRequiredGeminiCookies(cookieResult.cookieMap)) {
                     throw new Error(formatGeminiCookieError(cookieResult.warnings));
                 }
-                const configTimeout = typeof runOptions.config?.timeoutMs === 'number' && Number.isFinite(runOptions.config.timeoutMs)
+                const configTimeout = typeof runOptions.config?.timeoutMs === "number" &&
+                    Number.isFinite(runOptions.config.timeoutMs)
                     ? Math.max(1_000, runOptions.config.timeoutMs)
                     : null;
                 const defaultTimeoutMs = geminiOptions.youtube
@@ -337,7 +342,7 @@ export function createGeminiWebExecutor(geminiOptions) {
                 try {
                     if (editImagePath) {
                         const intro = await runGeminiWebWithFallback({
-                            prompt: 'Here is an image to edit',
+                            prompt: "Here is an image to edit",
                             files: [editImagePath],
                             model,
                             cookieMap: cookieResult.cookieMap,
@@ -359,12 +364,12 @@ export function createGeminiWebExecutor(geminiOptions) {
                             has_images: false,
                             image_count: 0,
                         };
-                        const resolvedOutputPath = outputPath ?? generateImagePath ?? 'generated.png';
+                        const resolvedOutputPath = outputPath ?? generateImagePath ?? "generated.png";
                         const imageSave = await saveFirstGeminiImageFromOutput(out, cookieResult.cookieMap, resolvedOutputPath, controller.signal);
                         response.has_images = imageSave.saved;
                         response.image_count = imageSave.imageCount;
                         if (!imageSave.saved) {
-                            throw new Error(`No images generated. Response text:\n${out.text || '(empty response)'}`);
+                            throw new Error(`No images generated. Response text:\n${out.text || "(empty response)"}`);
                         }
                     }
                     else if (generateImagePath) {
@@ -386,7 +391,7 @@ export function createGeminiWebExecutor(geminiOptions) {
                         response.has_images = imageSave.saved;
                         response.image_count = imageSave.imageCount;
                         if (!imageSave.saved) {
-                            throw new Error(`No images generated. Response text:\n${out.text || '(empty response)'}`);
+                            throw new Error(`No images generated. Response text:\n${out.text || "(empty response)"}`);
                         }
                     }
                     else {
@@ -409,13 +414,13 @@ export function createGeminiWebExecutor(geminiOptions) {
                 finally {
                     clearTimeout(timeout);
                 }
-                const answerText = response.text ?? '';
+                const answerText = response.text ?? "";
                 let answerMarkdown = answerText;
                 if (geminiOptions.showThoughts && response.thoughts) {
                     answerMarkdown = `## Thinking\n\n${response.thoughts}\n\n## Response\n\n${answerText}`;
                 }
                 if (response.has_images && response.image_count > 0) {
-                    const imagePath = generateImagePath || outputPath || 'generated.png';
+                    const imagePath = generateImagePath || outputPath || "generated.png";
                     answerMarkdown += `\n\n*Generated ${response.image_count} image(s). Saved to: ${imagePath}*`;
                 }
                 const tookMs = Date.now() - startTime;
@@ -429,10 +434,10 @@ export function createGeminiWebExecutor(geminiOptions) {
                 };
             },
         };
-        if (model === 'gemini-3-pro-deep-think' && modeSelection.mode === 'http') {
-            log?.(`[gemini-web] Deep Think DOM path skipped (${modeSelection.reasons.join(', ')} requested); using HTTP/header fallback path.`);
+        if (model === "gemini-3-pro-deep-think" && modeSelection.mode === "http") {
+            log?.(`[gemini-web] Deep Think DOM path skipped (${modeSelection.reasons.join(", ")} requested); using HTTP/header fallback path.`);
         }
-        const executionClient = modeSelection.mode === 'dom' ? domClient : httpClient;
+        const executionClient = modeSelection.mode === "dom" ? domClient : httpClient;
         return executionClient.execute();
     };
 }

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

@@ -1 +1 @@
-export { createGeminiWebExecutor } from './executor.js';
+export { createGeminiWebExecutor } from "./executor.js";

package/dist/src/mcp/server.js

@@ -1,15 +1,16 @@
 #!/usr/bin/env node
-import 'dotenv/config';
-import process from 'node:process';
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { getCliVersion } from '../version.js';
-import { registerConsultTool } from './tools/consult.js';
-import { registerSessionsTool } from './tools/sessions.js';
-import { registerSessionResources } from './tools/sessionResources.js';
+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 { getCliVersion } from "../version.js";
+import { registerConsultTool } from "./tools/consult.js";
+import { registerSessionsTool } from "./tools/sessions.js";
+import { registerSessionResources } from "./tools/sessionResources.js";
 export async function startMcpServer() {
     const server = new McpServer({
-        name: 'oracle-mcp',
+        name: "oracle-mcp",
         version: getCliVersion(),
     }, {
         capabilities: {
@@ -21,7 +22,7 @@ export async function startMcpServer() {
     registerSessionResources(server);
     const transport = new StdioServerTransport();
     transport.onerror = (error) => {
-        console.error('MCP transport error:', error);
+        console.error("MCP transport error:", error);
     };
     const closed = new Promise((resolve) => {
         transport.onclose = () => {
@@ -32,9 +33,12 @@ export async function startMcpServer() {
     await server.connect(transport);
     await closed;
 }
-if (import.meta.url === `file://${process.argv[1]}` || process.argv[1]?.endsWith('oracle-mcp')) {
+export function shouldStartMcpServerFromModule(moduleUrl = import.meta.url, argv1 = process.argv[1]) {
+    return argv1 ? moduleUrl === pathToFileURL(argv1).href : false;
+}
+if (shouldStartMcpServerFromModule()) {
     startMcpServer().catch((error) => {
-        console.error('Failed to start oracle-mcp:', error);
+        console.error("Failed to start oracle-mcp:", error);
         process.exitCode = 1;
     });
 }