pi-browser-use 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 0xPlayerOne
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,69 @@
+# pi-browser-use
+
+Opinionated browser-use for the [Pi coding agent](https://pi.dev), powered by [`chrome-devtools-mcp`](https://github.com/ChromeDevTools/chrome-devtools-mcp) — not Playwright.
+
+## Why this exists
+
+- **Fresh headless by default** — isolated ephemeral profile, no window, never steals focus.
+- **Authenticated profile opt-in** — `sessionMode: persistent` persists `~/.pi/browser-profile` (log in once).
+- **CLI-first policy bundled** — `skills/browser-policy` tells agents to prefer `gh` / `wrangler` / APIs and web fetching before driving the browser.
+- **Safer proxying** — `browser_`-prefixed tools, noisy/privileged tools excluded, sensitive network headers redacted.
+
+Not affiliated with `@amaster.ai/pi-browser-use` or `@narumitw/pi-chrome-devtools`.
+
+## Install
+
+```bash
+pi install npm:pi-browser-use
+```
+
+Requires Node.js `^20.19.0 || ^22.12.0 || >=23` and Chrome stable or newer.
+
+## Configure
+
+Settings key is `pi-browser-use` in `~/.pi/agent/settings.json` (user) or `.pi/settings.json` (trusted project, wins):
+
+```json
+{
+  "pi-browser-use": {
+    "sessionMode": "isolated",
+    "headless": true
+  }
+}
+```
+
+| Mode            | Config                                  | Behavior                                               |
+| --------------- | --------------------------------------- | ------------------------------------------------------ |
+| Fresh (default) | `isolated` + `headless: true`           | Ephemeral profile, no window                           |
+| Authenticated   | `sessionMode: persistent`               | Shared profile, log in once, headed windows pop        |
+| Existing        | `sessionMode: existing` + `autoConnect` | Drives your daily Chrome — intrusive, avoid by default |
+
+First-class `chromeArgs` (forwarded as `--chrome-arg=`) only apply when `chrome-devtools-mcp` launches Chrome itself — never with `autoConnect`/`browserUrl`. On macOS `--start-minimized` is ignored; only `headless: true` truly hides the window. Raw `extraArgs` are forwarded verbatim as an escape hatch.
+
+Hosts where `process.execPath` is not a directly executable Node runtime can set `PI_BROWSER_USE_NODE` to the Node command used for the MCP subprocess.
+
+## Page-scoped tools
+
+Call `browser_list_pages` first, then pass its numeric `pageId` to page-scoped tools. See `skills/browser-policy/SKILL.md` for the full agent policy.
+
+## Vision model (optional)
+
+Enable `browser_analyze_screenshot` by referencing a model already configured in Pi's model registry. The extension resolves credentials from the registry automatically:
+
+```json
+{
+  "pi-browser-use": {
+    "visionModel": { "provider": "openai", "model": "gpt-4o" }
+  }
+}
+```
+
+Use it for canvas/WebGL scenes or coordinate clicks the accessibility tree cannot describe. Without `visionModel` the tool is not registered.
+
+## Browser profile
+
+On startup the default persistent profile is checked for accessibility. A root-owned or unreadable default (typically from running under `sudo`) is moved aside to `~/.pi/browser-profile.inaccessible-<timestamp>` so Chrome starts fresh instead of showing a preferences dialog. An explicit custom `userDataDir` in the same state fails fast with an ownership remediation hint. Never run the agent (or anything launching this browser) via `sudo`.
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,29 @@
+import { type BrowserUseConfig } from './config.js';
+/**
+ * MCP client that spawns chrome-devtools-mcp as a per-session subprocess over
+ * stdio. Nothing runs persistently: connect() starts it, close() kills it.
+ */
+export declare class DevToolsClient {
+    private client;
+    private config;
+    private state;
+    private connectPromise;
+    private generation;
+    private hasConnected;
+    private explicitlyClosed;
+    private lastHealthCheckAt;
+    constructor(config: BrowserUseConfig);
+    connect(signal?: AbortSignal): Promise<void>;
+    private openConnection;
+    private markDisconnected;
+    private disconnectUnhealthyClient;
+    ensureReady(signal?: AbortSignal): Promise<void>;
+    listAllTools(signal?: AbortSignal): Promise<Array<{
+        name: string;
+        description?: string;
+        inputSchema: unknown;
+    }>>;
+    callTool(name: string, args: unknown, signal?: AbortSignal): Promise<unknown>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAIA,OAAO,EAA+B,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAA;AA6ChF;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,KAAK,CACG;IAChB,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,UAAU,CAAI;IACtB,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,gBAAgB,CAAQ;IAChC,OAAO,CAAC,iBAAiB,CAAI;gBAEjB,MAAM,EAAE,gBAAgB;IAI9B,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;YAYpC,cAAc;IAyD5B,OAAO,CAAC,gBAAgB;YAOV,yBAAyB;IAYjC,WAAW,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBhD,YAAY,CAChB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAsBzE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAqB7E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAa7B"}

package/dist/client.js

@@ -0,0 +1,222 @@
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { configToArgs, resolveConfig } from './config.js';
+const MCP_TIMEOUT_MS = 60_000;
+const MCP_HEALTH_TIMEOUT_MS = 5_000;
+const MCP_HEALTH_CHECK_INTERVAL_MS = 10_000;
+const MCP_STDERR_LIMIT = 4_096;
+const MCP_SYSTEM_ERROR_CODE_PATTERN = /^(?:EACCES|EADDRINUSE|ECONNREFUSED|ECONNRESET|EHOSTUNREACH|ENOENT|ENOTEMPTY|ENOTFOUND|EPERM|ETIMEDOUT)$/;
+const require = createRequire(import.meta.url);
+const chromeDevToolsMcpPackagePath = require.resolve('chrome-devtools-mcp/package.json');
+// oxlint-disable-next-line no-unsafe-read -- package.json of a pinned dependency
+const chromeDevToolsMcpPackage = require(chromeDevToolsMcpPackagePath);
+const chromeDevToolsMcpBin = chromeDevToolsMcpPackage.bin?.['chrome-devtools-mcp'];
+if (!chromeDevToolsMcpBin) {
+    throw new Error('chrome-devtools-mcp package does not declare its chrome-devtools-mcp binary');
+}
+const CHROME_DEVTOOLS_MCP_ENTRYPOINT = join(dirname(chromeDevToolsMcpPackagePath), chromeDevToolsMcpBin);
+function safeSystemErrorCode(value) {
+    return typeof value === 'string' && MCP_SYSTEM_ERROR_CODE_PATTERN.test(value) ? value : undefined;
+}
+function summarizeFailure(stderr, errorName, errorCode) {
+    const systemError = safeSystemErrorCode(errorCode) ??
+        stderr.match(/\b(EACCES|EADDRINUSE|ECONNREFUSED|ECONNRESET|EHOSTUNREACH|ENOENT|ENOTEMPTY|ENOTFOUND|EPERM|ETIMEDOUT)\b/)?.[1];
+    if (systemError)
+        return `MCP subprocess failed (${systemError}).`;
+    if (/could not find (?:chrome|browser)/i.test(stderr))
+        return 'Chrome executable was not found.';
+    if (/failed to launch (?:the )?(?:browser|chrome)/i.test(stderr))
+        return 'Chrome failed to launch.';
+    if (/(?:browser|chrome).+already running|profile.+in use/i.test(stderr)) {
+        return 'Chrome profile is already in use.';
+    }
+    const safeName = /^[A-Za-z][A-Za-z0-9]{0,63}$/.test(errorName) ? errorName : 'UnknownError';
+    return `MCP transport failed (${safeName}).`;
+}
+/**
+ * MCP client that spawns chrome-devtools-mcp as a per-session subprocess over
+ * stdio. Nothing runs persistently: connect() starts it, close() kills it.
+ */
+export class DevToolsClient {
+    client = null;
+    config;
+    state = 'disconnected';
+    connectPromise = null;
+    generation = 0;
+    hasConnected = false;
+    explicitlyClosed = false;
+    lastHealthCheckAt = 0;
+    constructor(config) {
+        this.config = resolveConfig(config);
+    }
+    async connect(signal) {
+        if (this.state === 'ready')
+            return;
+        if (this.connectPromise)
+            return this.connectPromise;
+        this.explicitlyClosed = false;
+        this.connectPromise = this.openConnection(signal);
+        try {
+            await this.connectPromise;
+        }
+        finally {
+            this.connectPromise = null;
+        }
+    }
+    async openConnection(signal) {
+        this.state = this.hasConnected ? 'reconnecting' : 'connecting';
+        const args = configToArgs(this.config);
+        const generation = ++this.generation;
+        const transport = new StdioClientTransport({
+            command: process.env.PI_BROWSER_USE_NODE?.trim() || process.execPath,
+            args: [CHROME_DEVTOOLS_MCP_ENTRYPOINT, ...args],
+            stderr: 'pipe',
+        });
+        let stderr = '';
+        let transportErrorCode;
+        transport.stderr?.on('data', (chunk) => {
+            stderr = `${stderr}${String(chunk)}`.slice(-MCP_STDERR_LIMIT);
+        });
+        const client = new Client({ name: 'pi-browser-use', version: '0.1.0' }, { capabilities: {} });
+        this.client = client;
+        transport.onerror = (error) => {
+            if (generation !== this.generation)
+                return;
+            transportErrorCode = safeSystemErrorCode(error.code);
+            console.error(`[pi-browser-use] chrome-devtools-mcp transport error (${transportErrorCode ?? error.name})`);
+            void this.disconnectUnhealthyClient(generation);
+        };
+        transport.onclose = () => this.markDisconnected(generation);
+        try {
+            await client.connect(transport, signal ? { signal, timeout: MCP_TIMEOUT_MS } : { timeout: MCP_TIMEOUT_MS });
+            if (generation !== this.generation)
+                return;
+            this.state = 'ready';
+            this.hasConnected = true;
+            this.lastHealthCheckAt = Date.now();
+        }
+        catch (error) {
+            if (generation === this.generation) {
+                ++this.generation;
+                this.client = null;
+                this.state = 'failed';
+            }
+            try {
+                await client.close();
+            }
+            catch {
+                // The failed transport may already be closed.
+            }
+            if (signal?.aborted)
+                throw error;
+            const errorName = error instanceof Error ? error.name : 'UnknownError';
+            const errorCode = error instanceof Error
+                ? safeSystemErrorCode(error.code)
+                : undefined;
+            const diagnostic = summarizeFailure(stderr, errorName, transportErrorCode ?? errorCode);
+            console.error(`[pi-browser-use] browser connection failed: ${diagnostic}`);
+            throw new Error(`Browser connection failed. ${diagnostic}`);
+        }
+    }
+    markDisconnected(generation) {
+        if (generation !== this.generation || this.state === 'closing')
+            return;
+        ++this.generation;
+        this.client = null;
+        this.state = 'disconnected';
+    }
+    async disconnectUnhealthyClient(generation) {
+        if (generation !== this.generation || this.state === 'closing')
+            return;
+        const failedClient = this.client;
+        this.markDisconnected(generation);
+        if (!failedClient)
+            return;
+        try {
+            await failedClient.close();
+        }
+        catch {
+            console.error('[pi-browser-use] failed to close unhealthy MCP client');
+        }
+    }
+    async ensureReady(signal) {
+        if (this.explicitlyClosed)
+            throw new Error('Client not connected');
+        if (this.state === 'ready') {
+            if (Date.now() - this.lastHealthCheckAt < MCP_HEALTH_CHECK_INTERVAL_MS)
+                return;
+            const generation = this.generation;
+            try {
+                await this.client?.ping({ timeout: MCP_HEALTH_TIMEOUT_MS });
+                if (generation !== this.generation)
+                    return;
+                this.lastHealthCheckAt = Date.now();
+                return;
+            }
+            catch (error) {
+                if (signal?.aborted)
+                    throw error;
+                await this.disconnectUnhealthyClient(generation);
+            }
+        }
+        await this.connect(signal);
+    }
+    async listAllTools(signal) {
+        await this.ensureReady(signal);
+        const client = this.client;
+        if (!client)
+            throw new Error('Client not connected');
+        const allTools = [];
+        let cursor;
+        do {
+            const result = await client.listTools(cursor ? { cursor } : undefined, {
+                timeout: MCP_TIMEOUT_MS,
+            });
+            allTools.push(...result.tools.map((t) => ({
+                name: t.name,
+                description: t.description,
+                inputSchema: t.inputSchema,
+            })));
+            cursor = result.nextCursor;
+        } while (cursor);
+        return allTools;
+    }
+    async callTool(name, args, signal) {
+        await this.ensureReady(signal);
+        const client = this.client;
+        if (!client)
+            throw new Error('Client not connected');
+        try {
+            return await client.callTool({ name, arguments: args }, undefined, { timeout: MCP_TIMEOUT_MS });
+        }
+        catch (error) {
+            if (signal?.aborted)
+                throw error;
+            if (this.state !== 'ready' || this.client !== client) {
+                throw new Error('Browser connection lost; retry the tool.');
+            }
+            const errorName = error instanceof Error ? error.name : 'UnknownError';
+            console.error(`[pi-browser-use] upstream tool call failed (${errorName})`);
+            throw new Error('Browser tool call failed.');
+        }
+    }
+    async close() {
+        if (this.explicitlyClosed)
+            return;
+        this.explicitlyClosed = true;
+        this.state = 'closing';
+        const client = this.client;
+        ++this.generation;
+        this.client = null;
+        try {
+            if (client)
+                await client.close();
+        }
+        finally {
+            this.state = 'disconnected';
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,46 @@
+export declare const DEFAULT_PROFILE_DIR: string;
+export type BrowserSessionMode = 'persistent' | 'isolated' | 'existing';
+/** Vision model used by the optional analyze_screenshot tool. Must already exist in Pi's model registry. */
+export interface VisionModelConfig {
+    provider: string;
+    model: string;
+}
+/** Configuration for the chrome-devtools-mcp subprocess. Same settings key as before: "pi-browser-use". */
+export interface BrowserUseConfig {
+    sessionMode?: BrowserSessionMode;
+    headless?: boolean;
+    channel?: 'canary' | 'dev' | 'beta' | 'stable';
+    browserUrl?: string;
+    wsEndpoint?: string;
+    wsHeaders?: string;
+    executablePath?: string;
+    viewport?: string;
+    isolated?: boolean;
+    userDataDir?: string;
+    autoConnect?: boolean;
+    categoryPerformance?: boolean;
+    categoryNetwork?: boolean;
+    categoryEmulation?: boolean;
+    categoryExtensions?: boolean;
+    experimentalVision?: boolean;
+    experimentalScreencast?: boolean;
+    experimentalMemory?: boolean;
+    experimentalPageIdRouting?: boolean;
+    visionModel?: VisionModelConfig;
+    usageStatistics?: boolean;
+    performanceCrux?: boolean;
+    redactNetworkHeaders?: boolean;
+    acceptInsecureCerts?: boolean;
+    allowedUrlPattern?: string[];
+    blockedUrlPattern?: string[];
+    slim?: boolean;
+    /** First-class Chrome flags, forwarded as --chrome-arg=<flag>. Only applies when Chrome is launched by chrome-devtools-mcp (not with autoConnect/browserUrl). */
+    chromeArgs?: string[];
+    /** Raw escape hatch: extra CLI flags forwarded verbatim to chrome-devtools-mcp. */
+    extraArgs?: string[];
+}
+/** Merge user config over fresh-headless defaults. */
+export declare function resolveConfig(config?: BrowserUseConfig): BrowserUseConfig;
+/** Convert config into CLI flags for the chrome-devtools-mcp subprocess. */
+export declare function configToArgs(config: BrowserUseConfig): string[];
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,mBAAmB,QAA4C,CAAA;AAE5E,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,UAAU,GAAG,UAAU,CAAA;AAEvE,4GAA4G;AAC5G,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,2GAA2G;AAC3G,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,kBAAkB,CAAA;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAA;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAChC,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,yBAAyB,CAAC,EAAE,OAAO,CAAA;IACnC,WAAW,CAAC,EAAE,iBAAiB,CAAA;IAC/B,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC5B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,iKAAiK;IACjK,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB;AAyBD,sDAAsD;AACtD,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,gBAAgB,CA6BzE;AAED,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAqC/D"}

package/dist/config.js

@@ -0,0 +1,120 @@
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+export const DEFAULT_PROFILE_DIR = join(homedir(), '.pi', 'browser-profile');
+/**
+ * Fresh headless by default: isolated ephemeral profile, no window, never
+ * steals focus. Set sessionMode "persistent" for the authenticated profile
+ * (log in once, cookies persist), or "existing" + autoConnect to drive your
+ * daily Chrome (intrusive: windows pop and steal focus).
+ */
+const DEFAULTS = {
+    sessionMode: 'isolated',
+    headless: true,
+    categoryPerformance: false,
+    categoryNetwork: true,
+    categoryEmulation: true,
+    categoryExtensions: false,
+    experimentalVision: true,
+    experimentalScreencast: false,
+    experimentalMemory: false,
+    experimentalPageIdRouting: true,
+    usageStatistics: false,
+    performanceCrux: false,
+    redactNetworkHeaders: true,
+    acceptInsecureCerts: false,
+};
+/** Merge user config over fresh-headless defaults. */
+export function resolveConfig(config) {
+    const resolved = { ...DEFAULTS, ...config };
+    if (resolved.allowedUrlPattern?.length && resolved.blockedUrlPattern?.length) {
+        throw new Error('allowedUrlPattern and blockedUrlPattern cannot be used together');
+    }
+    if (resolved.slim) {
+        if (config?.experimentalPageIdRouting === true) {
+            throw new Error('experimentalPageIdRouting cannot be used with slim mode');
+        }
+        resolved.experimentalPageIdRouting = false;
+    }
+    switch (resolved.sessionMode) {
+        case 'existing':
+            if (!resolved.autoConnect && !resolved.browserUrl && !resolved.wsEndpoint) {
+                resolved.autoConnect = true;
+            }
+            break;
+        case 'isolated':
+            if (!resolved.isolated) {
+                resolved.isolated = true;
+            }
+            break;
+        default:
+            if (!resolved.userDataDir && !resolved.browserUrl && !resolved.wsEndpoint) {
+                resolved.userDataDir = DEFAULT_PROFILE_DIR;
+            }
+            break;
+    }
+    return resolved;
+}
+/** Convert config into CLI flags for the chrome-devtools-mcp subprocess. */
+export function configToArgs(config) {
+    const args = [];
+    const resolved = resolveConfig(config);
+    if (resolved.headless)
+        args.push('--headless');
+    if (resolved.channel)
+        args.push(`--channel=${resolved.channel}`);
+    if (resolved.browserUrl)
+        args.push(`--browser-url=${resolved.browserUrl}`);
+    if (resolved.wsEndpoint)
+        args.push(`--ws-endpoint=${resolved.wsEndpoint}`);
+    if (resolved.wsHeaders)
+        args.push(`--ws-headers=${resolved.wsHeaders}`);
+    if (resolved.executablePath)
+        args.push(`--executable-path=${resolved.executablePath}`);
+    if (resolved.viewport)
+        args.push(`--viewport=${resolved.viewport}`);
+    if (resolved.isolated)
+        args.push('--isolated');
+    if (resolved.userDataDir)
+        args.push(`--user-data-dir=${resolved.userDataDir}`);
+    if (resolved.autoConnect)
+        args.push('--auto-connect');
+    if (resolved.slim)
+        args.push('--slim');
+    if (resolved.categoryPerformance === false)
+        args.push('--category-performance=false');
+    if (resolved.categoryNetwork === false)
+        args.push('--category-network=false');
+    if (resolved.categoryEmulation === false)
+        args.push('--category-emulation=false');
+    if (resolved.categoryExtensions === true)
+        args.push('--category-extensions=true');
+    if (resolved.experimentalVision)
+        args.push('--experimental-vision');
+    if (resolved.experimentalScreencast)
+        args.push('--experimental-screencast');
+    if (resolved.experimentalMemory)
+        args.push('--experimental-memory');
+    if (resolved.experimentalPageIdRouting)
+        args.push('--experimental-page-id-routing');
+    if (resolved.usageStatistics === false)
+        args.push('--no-usage-statistics');
+    if (resolved.performanceCrux === false)
+        args.push('--no-performance-crux');
+    if (resolved.redactNetworkHeaders)
+        args.push('--redact-network-headers');
+    if (resolved.acceptInsecureCerts)
+        args.push('--accept-insecure-certs');
+    for (const pattern of resolved.allowedUrlPattern ?? []) {
+        args.push(`--allowed-url-pattern=${pattern}`);
+    }
+    for (const pattern of resolved.blockedUrlPattern ?? []) {
+        args.push(`--blocked-url-pattern=${pattern}`);
+    }
+    for (const flag of resolved.chromeArgs ?? []) {
+        args.push(`--chrome-arg=${flag}`);
+    }
+    if (resolved.extraArgs)
+        args.push(...resolved.extraArgs);
+    return args;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,47 @@
+export { configToArgs, resolveConfig } from './config.js';
+interface ModelRegistry {
+    find(provider: string, modelId: string): unknown;
+    getApiKeyAndHeaders(model: unknown): Promise<{
+        ok: true;
+        apiKey?: string;
+        headers?: Record<string, string>;
+    } | {
+        ok: false;
+        error: string;
+    }>;
+}
+interface PiToolContext {
+    modelRegistry?: ModelRegistry;
+}
+interface Pi {
+    registerTool(def: {
+        name: string;
+        label: string;
+        description: string;
+        parameters: unknown;
+        execute: (toolCallId: string, params: Record<string, unknown>, signal?: AbortSignal, onUpdate?: unknown, ctx?: PiToolContext) => Promise<{
+            content: Array<{
+                type: string;
+                text?: string;
+                data?: string;
+                mimeType?: string;
+            }>;
+            isError?: boolean;
+            details?: undefined;
+        }>;
+    }): void;
+    on(event: string, handler: (event: unknown, ctx: {
+        cwd: string;
+    } & Record<string, unknown>) => Promise<void>): void;
+}
+/**
+ * Pi extension entry point. On session_start spawns chrome-devtools-mcp,
+ * discovers upstream tools, and registers each as browser_*. On
+ * session_shutdown tears the subprocess down. Nothing runs persistently.
+ *
+ * Defaults are fresh headless (isolated ephemeral profile, no window). Set
+ * sessionMode "persistent" for the authenticated profile, or "existing" with
+ * autoConnect/browserUrl to drive an already-running Chrome.
+ */
+export default function browserUseExtension(pi: Pi): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAoBzD,UAAU,aAAa;IACrB,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAA;IAChD,mBAAmB,CACjB,KAAK,EAAE,OAAO,GACb,OAAO,CACR;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAC/F,CAAA;CACF;AAED,UAAU,aAAa;IACrB,aAAa,CAAC,EAAE,aAAa,CAAA;CAC9B;AAED,UAAU,EAAE;IACV,YAAY,CAAC,GAAG,EAAE;QAChB,IAAI,EAAE,MAAM,CAAA;QACZ,KAAK,EAAE,MAAM,CAAA;QACb,WAAW,EAAE,MAAM,CAAA;QACnB,UAAU,EAAE,OAAO,CAAA;QACnB,OAAO,EAAE,CACP,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,OAAO,EAClB,GAAG,CAAC,EAAE,aAAa,KAChB,OAAO,CAAC;YACX,OAAO,EAAE,KAAK,CAAC;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,IAAI,CAAC,EAAE,MAAM,CAAC;gBAAC,IAAI,CAAC,EAAE,MAAM,CAAC;gBAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;YACjF,OAAO,CAAC,EAAE,OAAO,CAAA;YACjB,OAAO,CAAC,EAAE,SAAS,CAAA;SACpB,CAAC,CAAA;KACH,GAAG,IAAI,CAAA;IACR,EAAE,CACA,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GACzF,IAAI,CAAA;CACR;AA8BD;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,EAAE,EAAE,EAAE,QAyFjD"}