opera-browser-cli 0.1.27

package/dist/src/bridge.js

@@ -0,0 +1,379 @@
+/**
+ * Persistent MCP bridge server for opera-browser-cli.
+ *
+ * Spawns opera-devtools-mcp as a child process and maintains a single
+ * persistent MCP session. Exposes a simple HTTP API:
+ *   POST /call  { name, args }  → { result }
+ *   GET  /tools                 → [{ name, description }]
+ *   GET  /health                → { status: "ok" }
+ *
+ * Writes a PID file to ~/.opera-browser-cli/bridge.pid on startup.
+ */
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+import { LoggingMessageNotificationSchema } from "@modelcontextprotocol/sdk/types.js";
+import { createServer, } from "node:http";
+import { existsSync, mkdirSync, unlinkSync, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { homedir } from "node:os";
+const DEFAULT_PORT = Number.parseInt(process.env.OPERA_CLI_PORT ?? "9224", 10);
+const STATE_DIR = join(homedir(), ".opera-browser-cli");
+const PID_FILE = join(STATE_DIR, "bridge.pid");
+const OPERA_AI_TIMEOUT = 300_000; // 5 minutes
+const OPERA_AI_TOOLS = new Set([
+    "opera_chat",
+    "opera_do",
+    "opera_research",
+    "opera_make",
+]);
+export async function isBridgeClientConnected(client) {
+    try {
+        await client.listTools();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function writePidFile(port) {
+    mkdirSync(STATE_DIR, { recursive: true });
+    writeFileSync(PID_FILE, JSON.stringify({ pid: process.pid, port }));
+}
+function removePidFile() {
+    try {
+        unlinkSync(PID_FILE);
+    }
+    catch {
+        // Already gone — fine
+    }
+}
+export function getErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+export function extractToolText(content) {
+    return content
+        .filter((block) => block.type === "text" && typeof block.text === "string")
+        .map((block) => block.text)
+        .join("\n");
+}
+function getToolContent(result) {
+    if (!result ||
+        typeof result !== "object" ||
+        !("content" in result) ||
+        !Array.isArray(result.content)) {
+        return [];
+    }
+    return result.content;
+}
+export function parseBridgeCallPayload(body) {
+    let payload;
+    try {
+        payload = JSON.parse(body);
+    }
+    catch {
+        throw new Error("Invalid bridge request payload");
+    }
+    if (typeof payload.name !== "string" || payload.name.length === 0) {
+        throw new Error("Invalid bridge request payload");
+    }
+    if (payload.args === undefined) {
+        return { name: payload.name, args: {} };
+    }
+    if (payload.args === null ||
+        typeof payload.args !== "object" ||
+        Array.isArray(payload.args)) {
+        throw new Error("Invalid bridge request payload");
+    }
+    return { name: payload.name, args: payload.args };
+}
+export function resolveBridgeScript(importMetaDir) {
+    const builtScript = resolve(importMetaDir, "../bin/opera-browser-cli-bridge.js");
+    const sourceScript = builtScript.replace(/\.js$/, ".ts");
+    return existsSync(sourceScript) ? sourceScript : builtScript;
+}
+async function readRequestBody(req) {
+    let body = "";
+    for await (const chunk of req) {
+        body += typeof chunk === "string" ? chunk : chunk.toString("utf-8");
+    }
+    return body;
+}
+function writeJson(res, statusCode, payload) {
+    res.statusCode = statusCode;
+    res.end(JSON.stringify(payload));
+}
+async function handleToolsRequest(client, res) {
+    const result = await client.listTools();
+    writeJson(res, 200, result.tools.map((tool) => ({
+        name: tool.name,
+        description: tool.description,
+    })));
+}
+async function handleCallRequest(client, req, res, captureNextId) {
+    const body = await readRequestBody(req);
+    const payload = parseBridgeCallPayload(body);
+    const isStreamable = OPERA_AI_TOOLS.has(payload.name);
+    let mcpRequestId;
+    if (isStreamable && captureNextId) {
+        const controller = new AbortController();
+        let timer = setTimeout(() => controller.abort(), OPERA_AI_TIMEOUT);
+        // Register the capture BEFORE calling callTool so the synchronous
+        // transport.send fires into our queue before we await the result.
+        const idCapture = captureNextId();
+        const callPromise = client.callTool({ name: payload.name, arguments: payload.args }, undefined, { signal: controller.signal, timeout: OPERA_AI_TIMEOUT * 2 });
+        // Suppress unhandled-rejection if idCapture rejects (e.g. transport closes
+        // before transport.send fires in a future SDK version). The rejection will
+        // propagate through the `await idCapture` below and close the response.
+        callPromise.catch(() => { });
+        try {
+            mcpRequestId = await idCapture; // resolves as soon as transport.send fires
+        }
+        catch (error) {
+            clearTimeout(timer);
+            throw error;
+        }
+        requestLoggers.set(mcpRequestId, (chunk) => {
+            clearTimeout(timer);
+            timer = setTimeout(() => controller.abort(), OPERA_AI_TIMEOUT);
+            res.write(JSON.stringify({ log: chunk }) + "\n");
+        });
+        try {
+            const result = await callPromise;
+            const text = extractToolText(getToolContent(result));
+            res.statusCode = 200;
+            res.end(JSON.stringify({ result: text }));
+        }
+        catch (error) {
+            res.statusCode = 500;
+            res.end(JSON.stringify({ error: getErrorMessage(error) }));
+        }
+        finally {
+            clearTimeout(timer);
+            requestLoggers.delete(mcpRequestId);
+        }
+        return;
+    }
+    // Non-streaming path (unchanged).
+    try {
+        const result = await client.callTool({ name: payload.name, arguments: payload.args }, undefined);
+        const text = extractToolText(getToolContent(result));
+        res.statusCode = 200;
+        res.end(JSON.stringify({ result: text }));
+    }
+    catch (error) {
+        res.statusCode = 500;
+        res.end(JSON.stringify({ error: getErrorMessage(error) }));
+    }
+}
+export async function handleBridgeRequest(client, req, res, captureNextId) {
+    res.setHeader("Content-Type", "application/json");
+    if (req.method === "GET" && req.url === "/health") {
+        if (await isBridgeClientConnected(client)) {
+            writeJson(res, 200, { status: "ok" });
+        }
+        else {
+            writeJson(res, 503, { error: "Not connected" });
+        }
+        return;
+    }
+    try {
+        if (req.method === "GET" && req.url === "/tools") {
+            await handleToolsRequest(client, res);
+            return;
+        }
+        if (req.method === "POST" && req.url === "/call") {
+            await handleCallRequest(client, req, res, captureNextId);
+            return;
+        }
+    }
+    catch (error) {
+        writeJson(res, 500, { error: getErrorMessage(error) });
+        return;
+    }
+    writeJson(res, 404, { error: "not found" });
+}
+export function createBridgeServer(client, captureNextId) {
+    return createServer((req, res) => {
+        void handleBridgeRequest(client, req, res, captureNextId);
+    });
+}
+function logBridgeMessage(message) {
+    process.stderr.write(`[opera-browser-cli] ${message}\n`);
+}
+function writeReadySignal() {
+    process.stdout.write("READY\n");
+}
+export function buildTransportArgs() {
+    const args = [];
+    const browserUrl = process.env.OPERA_CLI_BROWSER_URL;
+    const userDataDir = process.env.OPERA_CLI_USER_DATA_DIR;
+    const executablePath = process.env.OPERA_CLI_EXECUTABLE_PATH;
+    if (browserUrl) {
+        // Connect to an existing browser instance — skip --isolated and --headless
+        // since the user manages the browser lifecycle externally.
+        args.push(`--browserUrl=${browserUrl}`);
+    }
+    else {
+        if (executablePath) {
+            args.push(`--executablePath=${executablePath}`);
+        }
+        if (userDataDir) {
+            // Persistent profile — skip --isolated so the profile is preserved.
+            args.push(`--userDataDir=${userDataDir}`);
+            // Puppeteer adds --use-mock-keychain and --password-store=basic by default,
+            // which prevent the browser from decrypting cookies stored with the real
+            // macOS Keychain. Drop them so a persistent profile stays logged in.
+            args.push("--ignore-default-chrome-arg=--use-mock-keychain");
+            args.push("--ignore-default-chrome-arg=--password-store=basic");
+            args.push("--ignore-default-chrome-arg=--disable-extensions");
+            args.push("--ignore-default-chrome-arg=--disable-component-extensions-with-background-pages");
+            args.push("--show-component-extension-options");
+        }
+        else {
+            args.push("--isolated");
+        }
+        if (process.env.OPERA_CLI_HEADED !== "1") {
+            args.push("--headless");
+        }
+    }
+    const extraChromeArgs = process.env.OPERA_CLI_CHROME_ARGS;
+    if (extraChromeArgs) {
+        for (const arg of extraChromeArgs.trim().split(/\s+/)) {
+            args.push(`--chrome-arg=${arg}`);
+        }
+    }
+    return args;
+}
+function createTransport() {
+    const bin = process.env.OPERA_CLI_MCP_BIN ?? "opera-devtools-mcp";
+    const args = buildTransportArgs();
+    if (bin.endsWith(".js")) {
+        return new StdioClientTransport({
+            command: "node",
+            args: [bin, ...args],
+        });
+    }
+    return new StdioClientTransport({ command: bin, args });
+}
+const requestLoggers = new Map();
+/**
+ * Wraps transport.send to intercept outgoing JSON-RPC request IDs so each
+ * streaming callTool call can register its own log writer before the first
+ * notification arrives.
+ *
+ * INVARIANT: The MCP SDK's Client.request() calls transport.send() synchronously
+ * inside its Promise constructor (see @modelcontextprotocol/sdk shared/protocol.js).
+ * This means callTool() triggers transport.send before yielding, allowing us to
+ * capture the ID before any concurrent handler can interleave.
+ * Verify this invariant when upgrading @modelcontextprotocol/sdk.
+ */
+export function wrapTransportForIdCapture(transport) {
+    const queue = [];
+    // Cast origSend to the full Transport.send signature so we can forward the
+    // options argument even though StdioClientTransport currently ignores it.
+    const origSend = transport.send.bind(transport);
+    // Forward send — preserve the options parameter so future SDK versions that
+    // use TransportSendOptions over stdio are not silently broken.
+    transport.send = (async (msg, options) => {
+        if ("id" in msg && "method" in msg && queue.length > 0) {
+            queue.shift().resolve(String(msg.id));
+        }
+        return origSend(msg, options);
+    });
+    // Latent safety net: if a future SDK version makes transport.send async,
+    // reject any queued capture so callers do not hang. In the current SDK the
+    // queue is always empty by the time onclose can fire (transport.send is
+    // called synchronously before the first await in Client.request). The primary
+    // protection against a dead-transport hang is the runBridge onclose handler
+    // that calls shutdown(); this drain is a belt-and-suspenders fallback.
+    const origOnClose = transport.onclose;
+    transport.onclose = () => {
+        const err = new Error("MCP transport disconnected");
+        while (queue.length > 0)
+            queue.shift().reject(err);
+        origOnClose?.();
+    };
+    return () => new Promise((resolve, reject) => queue.push({ resolve, reject }));
+}
+function createBridgeClient() {
+    const client = new Client({ name: "opera-browser-cli-bridge", version: "1.0.0" });
+    client.setNotificationHandler(LoggingMessageNotificationSchema, (notification) => {
+        // opera-devtools-mcp sets `logger` to String(extra.requestId) so the bridge
+        // can route the chunk to the correct HTTP response. `data` stays a plain
+        // string so non-bridge MCP hosts (Claude Desktop, VS Code, etc.) render it
+        // as readable text without any change.
+        const { data, logger } = notification.params;
+        if (logger && requestLoggers.has(logger)) {
+            const chunk = typeof data === "string" ? data : JSON.stringify(data);
+            requestLoggers.get(logger)(chunk);
+        }
+        // No matching logger: notification is from a non-Opera tool or an older
+        // server version — silently ignore.
+    });
+    return client;
+}
+async function closeServer(server) {
+    await new Promise((resolve, reject) => {
+        server.close((error) => {
+            if (error) {
+                reject(error);
+            }
+            else {
+                resolve();
+            }
+        });
+    });
+}
+export async function runBridge(port = DEFAULT_PORT) {
+    const transport = createTransport();
+    const captureNextId = wrapTransportForIdCapture(transport);
+    const client = createBridgeClient();
+    await client.connect(transport);
+    logBridgeMessage("Connected to opera-devtools-mcp");
+    const server = createBridgeServer(client, captureNextId);
+    server.listen(port, "127.0.0.1", () => {
+        writePidFile(port);
+        logBridgeMessage(`Listening on http://127.0.0.1:${port}`);
+        writeReadySignal();
+    });
+    let shuttingDown = false;
+    const shutdown = async () => {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        removePidFile();
+        await closeServer(server);
+        await client.close();
+        await transport.close();
+        process.exit(0);
+    };
+    // If opera-devtools-mcp exits (transport closes), shut the bridge down too.
+    // Without this, the bridge would keep accepting HTTP requests and hang on any
+    // streaming call: captureNextId() queues a resolver, callTool() early-rejects
+    // without calling transport.send, and `await idCapture` never resolves.
+    // Chain after the drain handler already installed by wrapTransportForIdCapture.
+    const afterDrain = transport.onclose;
+    transport.onclose = () => {
+        afterDrain?.();
+        void shutdown();
+    };
+    // Kill our entire process group on exit so opera-devtools-mcp children
+    // don't survive as orphans. The bridge is spawned with detached:true,
+    // making it a process group leader — all children share our PGID.
+    process.on("exit", () => {
+        removePidFile();
+        try {
+            process.kill(-process.pid, "SIGTERM");
+        }
+        catch {
+            // Already dead or not a group leader
+        }
+    });
+    process.on("SIGTERM", () => {
+        void shutdown();
+    });
+    process.on("SIGINT", () => {
+        void shutdown();
+    });
+}
+//# sourceMappingURL=bridge.js.map

package/dist/src/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../../src/bridge.ts"],"names":[],"mappings":"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"}

package/dist/src/cli.d.ts

@@ -0,0 +1,74 @@
+type CliStdout = Pick<NodeJS.WriteStream, "write">;
+export type MainOptions = {
+    argv?: string[];
+    stdout?: CliStdout;
+};
+export declare const TOP_HELP = "usage: opera-browser-cli [command] [args] [flags]\ncommands[41]:\n  open <url>, snapshot, screenshot <path>, click @<uid>, fill @<uid> <text>,\n  type <text>, press <key>, scroll <dir>, back, wait <ms|text>, eval <js>,\n  run,\n  hover @<uid>, drag @<from> @<to>, fillform @<uid>=<val>..., dialog <action>,\n  upload @<uid> <path>, pages, newpage <url>, selectpage <id>, closepage <id>,\n  resize <w> <h>, emulate, console, console-get <id>, network,\n  network-get [id], lighthouse, perf-start, perf-stop,\n  perf-insight <set> <name>, heap <path>, start, stop,\n  chat <prompt>, invoke-do <prompt>, make <prompt>, research <prompt>,\n  setup, logs, doctor\n\nflags[2]:\n  --help, -v/-V/--version\n\nenvironment:\n  OPERA_CLI_HEADED        Set to 1 to run Chrome in headed (visible) mode\n  OPERA_CLI_CHROME_ARGS   Whitespace-separated Chrome flags forwarded to the browser\n                                    (no shell-style quoting; flags with spaces are not supported)\n                                    e.g. \"--enable-gpu --ignore-gpu-blocklist\"\n  OPERA_CLI_PORT          Bridge server port (default: 9224)\n  OPERA_CLI_BROWSER_URL   Connect to an existing Chrome instance instead of launching one\n                                    e.g. \"http://127.0.0.1:9222\"\n  OPERA_CLI_USER_DATA_DIR Persistent Chrome profile directory (skips --isolated mode)\n                                    e.g. \"/path/to/.chrome-profile\"\n  OPERA_CLI_EXECUTABLE_PATH  Path to a custom browser binary (e.g. Opera Neon)\n  OPERA_CLI_DISABLE_HOOKS Set to 1 to skip auto-installing session hooks\n\n  Environment variables can also be set in ~/.opera-browser-cli/config (KEY=VALUE, one per line).\n  Run `opera-browser-cli setup` to configure interactively.\n\nopera ai:\n  chat, invoke-do, make, and research require Opera Neon with an active sign-in.\n  Run `opera-browser-cli setup` to configure the Opera Neon executable path, or set\n  OPERA_CLI_EXECUTABLE_PATH=\"/Applications/Opera Neon Developer.app/Contents/MacOS/Opera\".\n\ngpu:\n  Headless Chrome cannot access hardware GPU on most Linux systems.\n  For GPU-accelerated WebGL, use headed mode with GPU flags:\n    OPERA_CLI_HEADED=1\n    OPERA_CLI_CHROME_ARGS=\"--enable-gpu --ignore-gpu-blocklist\"\n  For WebGPU, Vulkan must also be enabled (required for the Dawn backend):\n    OPERA_CLI_CHROME_ARGS=\"--enable-gpu --ignore-gpu-blocklist --enable-unsafe-webgpu --enable-features=Vulkan\"\n\ntips:\n  Pipe output through grep/head to extract specific data from large pages.\n";
+export declare function getCommandHelp(command: string): string | null;
+export interface ScreenshotArgs {
+    filePath: string | null;
+    uid: string | undefined;
+    fullPage: boolean;
+    format: string | undefined;
+}
+export declare function parseScreenshotArgs(args: string[]): ScreenshotArgs;
+export declare function formatScreenshotOutput(filePath: string): string;
+/** Parse MCP list_pages markdown into structured data. */
+export declare function parsePagesList(text: string): {
+    id: number;
+    url: string;
+    selected: boolean;
+}[];
+/** Format raw MCP text result as AXI output: labeled block + truncation + suggestions. */
+export declare function formatMcpResult(label: string, text: string, suggestions: string[]): string;
+export declare function parseFillFormArgs(args: string[]): {
+    entries: {
+        uid: string;
+        value: string;
+    }[];
+};
+export interface EmulateArgs extends Record<string, unknown> {
+    viewport?: string;
+    colorScheme?: string;
+    networkConditions?: string;
+    cpuThrottlingRate?: number;
+    geolocation?: string;
+    userAgent?: string;
+}
+export declare function parseEmulateArgs(args: string[]): EmulateArgs;
+export declare function parseConsoleArgs(args: string[]): {
+    types?: string[];
+    pageSize?: number;
+    pageIdx?: number;
+};
+export declare function parseNetworkArgs(args: string[]): {
+    resourceTypes?: string[];
+    pageSize?: number;
+    pageIdx?: number;
+};
+export declare function parseNetworkGetArgs(args: string[]): {
+    reqid?: number;
+    responseFilePath?: string;
+    requestFilePath?: string;
+};
+export declare function parseLighthouseArgs(args: string[]): {
+    device?: string;
+    mode?: string;
+    outputDirPath?: string;
+};
+export declare function parsePerfStartArgs(args: string[]): {
+    reload?: boolean;
+    autoStop?: boolean;
+    filePath?: string;
+};
+/** Wrap plain JS expressions for MCP evaluate_script, but pass functions through unchanged. */
+export declare function wrapJsExpression(js: string): string;
+export declare function formatStopOutput(wasStopped: boolean): string;
+declare const VALID_RESEARCH_TYPES: readonly ["local", "one-minute", "deep"];
+type ResearchType = (typeof VALID_RESEARCH_TYPES)[number];
+export declare function parseResearchArgs(args: string[]): {
+    prompt: string;
+    researchType?: ResearchType;
+};
+export declare function main(options?: MainOptions | string[]): Promise<void>;
+export {};