pi-browser-use 0.1.0

package/dist/index.js

@@ -0,0 +1,133 @@
+import { Type } from 'typebox';
+import { DevToolsClient } from './client.js';
+import { resolveConfig } from './config.js';
+import { isProjectTrusted, loadConfig } from './settings.js';
+import { augmentToolDescription, extractTextContent, postProcessToolResult, } from './tool-augment.js';
+import { prepareBrowserProfile } from './profile.js';
+import { createRegistryVisionCaller, handleAnalyzeScreenshot, } from './vision.js';
+export { configToArgs, resolveConfig } from './config.js';
+// All upstream tools are re-exported with this prefix to avoid name collisions.
+const TOOL_PREFIX = 'browser_';
+// Noisy, slow, or privileged upstream tools; skipped during registration.
+const EXCLUDED_TOOLS = new Set([
+    'lighthouse_audit',
+    'performance_analyze_insight',
+    'performance_start_trace',
+    'performance_stop_trace',
+    'screencast_start',
+    'screencast_stop',
+    'install_extension',
+    'list_extensions',
+    'reload_extension',
+    'trigger_extension_action',
+    'uninstall_extension',
+]);
+function toToolContent(result, originalName) {
+    const textContent = extractTextContent(result.content);
+    const processed = postProcessToolResult(originalName, textContent);
+    const content = [];
+    if (processed !== textContent) {
+        content.push({ type: 'text', text: processed });
+    }
+    else if (result.content) {
+        for (const item of result.content) {
+            if (item.type === 'text' && item.text)
+                content.push({ type: 'text', text: item.text });
+        }
+    }
+    if (result.content) {
+        for (const item of result.content) {
+            if (item.type === 'image' && item.data) {
+                content.push({ type: 'image', data: item.data, mimeType: item.mimeType ?? 'image/png' });
+            }
+        }
+    }
+    if (content.length === 0)
+        content.push({ type: 'text', text: '' });
+    return result.isError ? { content, isError: true } : { content };
+}
+/**
+ * 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) {
+    let config;
+    let client;
+    async function ensureConnected(signal) {
+        if (!client)
+            throw new Error('browser-use: session not started');
+        await client.ensureReady(signal);
+    }
+    async function registerUpstreamTools() {
+        await ensureConnected();
+        const upstreamTools = await client.listAllTools();
+        for (const tool of upstreamTools) {
+            if (EXCLUDED_TOOLS.has(tool.name))
+                continue;
+            const prefixedName = `${TOOL_PREFIX}${tool.name}`;
+            const originalName = tool.name;
+            const description = augmentToolDescription(prefixedName, tool.description ?? '');
+            pi.registerTool({
+                name: prefixedName,
+                label: prefixedName,
+                description,
+                parameters: Type.Unsafe(tool.inputSchema),
+                async execute(_toolCallId, params, signal) {
+                    await ensureConnected(signal);
+                    const result = (await client.callTool(originalName, params, signal));
+                    return { ...toToolContent(result, originalName), details: undefined };
+                },
+            });
+        }
+    }
+    async function registerVisionTool(visionConfig) {
+        const properties = {
+            instruction: Type.Optional(Type.String({
+                description: 'What to identify or analyze visually (e.g. "Find the coordinates of the blue submit button").',
+            })),
+        };
+        if (config?.experimentalPageIdRouting === true) {
+            properties.pageId = Type.Number({
+                description: 'Numeric page ID returned by browser_list_pages.',
+            });
+        }
+        pi.registerTool({
+            name: `${TOOL_PREFIX}analyze_screenshot`,
+            label: `${TOOL_PREFIX}analyze_screenshot`,
+            description: 'Analyze the current page visually using a screenshot. Use when you need to identify elements by visual attributes (color, layout, position) not available in the accessibility tree, or when you need precise pixel coordinates for coordinate click tools.',
+            parameters: Type.Object(properties),
+            async execute(_toolCallId, params, signal, _onUpdate, ctx) {
+                await ensureConnected(signal);
+                if (!ctx?.modelRegistry)
+                    throw new Error('Vision model registry is unavailable in this session.');
+                const callVision = createRegistryVisionCaller(visionConfig, ctx.modelRegistry);
+                const pageId = typeof params.pageId === 'number' ? params.pageId : undefined;
+                const result = await handleAnalyzeScreenshot({
+                    callTool: (name, args, sig) => client.callTool(name, args, sig),
+                }, callVision, { instruction: typeof params.instruction === 'string' ? params.instruction : '', pageId }, signal);
+                return { ...result, details: undefined };
+            },
+        });
+    }
+    pi.on('session_start', async (_event, ctx) => {
+        config = resolveConfig(loadConfig({ cwd: ctx.cwd, projectTrusted: isProjectTrusted(ctx) }));
+        prepareBrowserProfile(config);
+        client = new DevToolsClient(config);
+        await registerUpstreamTools();
+        if (config.visionModel) {
+            await registerVisionTool(config.visionModel);
+        }
+    });
+    pi.on('session_shutdown', async () => {
+        if (client) {
+            await client.close();
+            client = undefined;
+        }
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/profile.d.ts

@@ -0,0 +1,11 @@
+import { type BrowserUseConfig } from './config.js';
+/**
+ * Guard the browser profile before launch. A default profile that exists but
+ * cannot be read/written (typically root-owned after running under sudo) is
+ * moved aside so Chrome starts fresh instead of showing a "can't read your
+ * preferences" dialog on every launch. An explicit custom userDataDir in the
+ * same state fails fast with a remediation hint instead of silently
+ * discarding the user's data.
+ */
+export declare function prepareBrowserProfile(config: BrowserUseConfig): void;
+//# sourceMappingURL=profile.d.ts.map

package/dist/profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../src/profile.ts"],"names":[],"mappings":"AAEA,OAAO,EAAuB,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAwBxE;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CA2BpE"}

package/dist/profile.js

@@ -0,0 +1,58 @@
+import { accessSync, constants, renameSync, statSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { DEFAULT_PROFILE_DIR } from './config.js';
+function isRootOwned(path) {
+    try {
+        const stat = statSync(path);
+        const getuid = process.getuid;
+        return stat.uid === 0 && typeof getuid === 'function' && getuid() !== 0;
+    }
+    catch {
+        return false;
+    }
+}
+function isUnusableDir(path) {
+    try {
+        if (isRootOwned(path))
+            return true;
+        accessSync(path, constants.R_OK | constants.W_OK);
+        return false;
+    }
+    catch (error) {
+        // A missing directory is fine (Chrome creates it); anything else means
+        // the profile cannot be used.
+        return error.code !== 'ENOENT';
+    }
+}
+/**
+ * Guard the browser profile before launch. A default profile that exists but
+ * cannot be read/written (typically root-owned after running under sudo) is
+ * moved aside so Chrome starts fresh instead of showing a "can't read your
+ * preferences" dialog on every launch. An explicit custom userDataDir in the
+ * same state fails fast with a remediation hint instead of silently
+ * discarding the user's data.
+ */
+export function prepareBrowserProfile(config) {
+    if (config.browserUrl || config.wsEndpoint)
+        return;
+    const dir = config.userDataDir ?? (config.sessionMode === 'persistent' ? DEFAULT_PROFILE_DIR : undefined);
+    if (!dir || dir !== DEFAULT_PROFILE_DIR) {
+        if (dir && isUnusableDir(dir)) {
+            throw new Error(`Browser profile at ${dir} is not accessible (likely root-owned from running under sudo). ` +
+                `chown it back with: sudo chown -R $(id -un):$(id -gn) ${JSON.stringify(dir)}`);
+        }
+        return;
+    }
+    if (isUnusableDir(dir)) {
+        const aside = join(dirname(DEFAULT_PROFILE_DIR), `browser-profile.inaccessible-${Date.now()}`);
+        console.error(`[pi-browser-use] default browser profile is inaccessible; moving it aside to ${aside} and starting fresh.`);
+        try {
+            renameSync(dir, aside);
+        }
+        catch (error) {
+            throw new Error(`Browser profile at ${dir} is not accessible and could not be moved aside. ` +
+                `Fix ownership with: sudo chown -R $(id -un):$(id -gn) ${JSON.stringify(dir)}`);
+        }
+    }
+}
+//# sourceMappingURL=profile.js.map

package/dist/profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../src/profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AACrE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,mBAAmB,EAAyB,MAAM,aAAa,CAAA;AAExE,SAAS,WAAW,CAAC,IAAY;IAC/B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;QAC3B,MAAM,MAAM,GAAI,OAAgD,CAAC,MAAM,CAAA;QACvE,OAAO,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,OAAO,MAAM,KAAK,UAAU,IAAI,MAAM,EAAE,KAAK,CAAC,CAAA;IACzE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,IAAI,CAAC;QACH,IAAI,WAAW,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAA;QAClC,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;QACjD,OAAO,KAAK,CAAA;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,uEAAuE;QACvE,8BAA8B;QAC9B,OAAQ,KAA+B,CAAC,IAAI,KAAK,QAAQ,CAAA;IAC3D,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAwB;IAC5D,IAAI,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU;QAAE,OAAM;IAClD,MAAM,GAAG,GACP,MAAM,CAAC,WAAW,IAAI,CAAC,MAAM,CAAC,WAAW,KAAK,YAAY,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IAC/F,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,mBAAmB,EAAE,CAAC;QACxC,IAAI,GAAG,IAAI,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CACb,sBAAsB,GAAG,kEAAkE;gBACzF,yDAAyD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CACjF,CAAA;QACH,CAAC;QACD,OAAM;IACR,CAAC;IACD,IAAI,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,gCAAgC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;QAC9F,OAAO,CAAC,KAAK,CACX,gFAAgF,KAAK,sBAAsB,CAC5G,CAAA;QACD,IAAI,CAAC;YACH,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,sBAAsB,GAAG,mDAAmD;gBAC1E,yDAAyD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CACjF,CAAA;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/settings.d.ts

@@ -0,0 +1,12 @@
+import type { BrowserUseConfig } from './config.js';
+/**
+ * Load the "pi-browser-use" section. Priority: user settings, then trusted
+ * project settings (<cwd>/.pi/settings.json, no env expansion). Project
+ * settings apply only when the session trusts the project.
+ */
+export declare function loadConfig(options?: {
+    cwd?: string;
+    projectTrusted?: boolean;
+}): BrowserUseConfig;
+export declare function isProjectTrusted(context: unknown): boolean;
+//# sourceMappingURL=settings.d.ts.map

package/dist/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AA4BnD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,gBAAgB,CAMjG;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAO1D"}

package/dist/settings.js

@@ -0,0 +1,52 @@
+import { readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+function expandEnv(value) {
+    if (typeof value === 'string') {
+        return value.replace(/\$\{([^}]+)\}/g, (_m, expr) => {
+            const [name, ...rest] = expr.split(':-');
+            return process.env[name] ?? rest.join(':-');
+        });
+    }
+    if (Array.isArray(value))
+        return value.map(expandEnv);
+    if (value && typeof value === 'object') {
+        return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, expandEnv(v)]));
+    }
+    return value;
+}
+function readSection(filePath, expand) {
+    try {
+        const parsed = JSON.parse(readFileSync(filePath, 'utf-8'));
+        const section = parsed['pi-browser-use'];
+        if (!section || typeof section !== 'object' || Array.isArray(section))
+            return {};
+        return (expand ? expandEnv(section) : section);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return {};
+        throw error;
+    }
+}
+/**
+ * Load the "pi-browser-use" section. Priority: user settings, then trusted
+ * project settings (<cwd>/.pi/settings.json, no env expansion). Project
+ * settings apply only when the session trusts the project.
+ */
+export function loadConfig(options) {
+    const user = readSection(join(homedir(), '.pi', 'agent', 'settings.json'), true);
+    const cwd = options?.cwd ?? process.cwd();
+    const project = options?.projectTrusted === true ? readSection(join(cwd, '.pi', 'settings.json'), false) : {};
+    return { ...user, ...project };
+}
+export function isProjectTrusted(context) {
+    const ctx = context;
+    try {
+        return ctx?.isProjectTrusted?.() === true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=settings.js.map

package/dist/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAGhC,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,EAAE,EAAE,IAAY,EAAE,EAAE;YAC1D,MAAM,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YACxC,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC7C,CAAC,CAAC,CAAA;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IACrD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACrF,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAS,WAAW,CAAC,QAAgB,EAAE,MAAe;IACpD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAA4B,CAAA;QACrF,MAAM,OAAO,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAA;QACxC,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,OAAO,EAAE,CAAA;QAChF,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAqB,CAAA;IACpE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAA;QACjE,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,OAAoD;IAC7E,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,CAAC,EAAE,IAAI,CAAC,CAAA;IAChF,MAAM,GAAG,GAAG,OAAO,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAA;IACzC,MAAM,OAAO,GACX,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,eAAe,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC/F,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,EAAE,CAAA;AAChC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,MAAM,GAAG,GAAG,OAAkE,CAAA;IAC9E,IAAI,CAAC;QACH,OAAO,GAAG,EAAE,gBAAgB,EAAE,EAAE,KAAK,IAAI,CAAA;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC"}

package/dist/tool-augment.d.ts

@@ -0,0 +1,4 @@
+export declare function augmentToolDescription(prefixedName: string, description: string): string;
+export declare function postProcessToolResult(originalName: string, text: string): string;
+export declare function extractTextContent(content: unknown): string;
+//# sourceMappingURL=tool-augment.d.ts.map

package/dist/tool-augment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-augment.d.ts","sourceRoot":"","sources":["../src/tool-augment.ts"],"names":[],"mappings":"AASA,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAGxF;AAED,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAQhF;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAS3D"}

package/dist/tool-augment.js

@@ -0,0 +1,30 @@
+const HINTS = {
+    browser_click: 'Use the element uid from the accessibility tree snapshot; UIDs are invalidated after this action.',
+    browser_fill: 'Fills standard HTML form fields only; does not work on canvas/custom widgets.',
+    browser_press_key: 'Accepts a single key name only (e.g. Enter, Tab, Escape).',
+    browser_take_snapshot: 'Call first to get uids, and after every state-changing action.',
+    browser_navigate_page: 'Call take_snapshot after navigation to see the new page.',
+};
+export function augmentToolDescription(prefixedName, description) {
+    const hint = HINTS[prefixedName];
+    return hint ? `${description}\n\nHint: ${hint}` : description;
+}
+export function postProcessToolResult(originalName, text) {
+    if (originalName === 'click' && /overlay|obscured|intercept/i.test(text)) {
+        return `${text}\n\nHint: the click was blocked by an overlay/popup — dismiss it first, then refresh the snapshot.`;
+    }
+    if (/stale|no longer attached|not found/i.test(text) && /uid|element/i.test(text)) {
+        return `${text}\n\nHint: element references are stale — take a fresh snapshot for current uids.`;
+    }
+    return text;
+}
+export function extractTextContent(content) {
+    if (!Array.isArray(content))
+        return '';
+    return content
+        .filter((item) => typeof item === 'object' && item !== null)
+        .filter((item) => item.type === 'text' && typeof item.text === 'string')
+        .map((item) => item.text)
+        .join('\n');
+}
+//# sourceMappingURL=tool-augment.js.map

package/dist/tool-augment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-augment.js","sourceRoot":"","sources":["../src/tool-augment.ts"],"names":[],"mappings":"AAAA,MAAM,KAAK,GAA2B;IACpC,aAAa,EACX,mGAAmG;IACrG,YAAY,EAAE,+EAA+E;IAC7F,iBAAiB,EAAE,2DAA2D;IAC9E,qBAAqB,EAAE,gEAAgE;IACvF,qBAAqB,EAAE,0DAA0D;CAClF,CAAA;AAED,MAAM,UAAU,sBAAsB,CAAC,YAAoB,EAAE,WAAmB;IAC9E,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,CAAC,CAAA;IAChC,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,WAAW,aAAa,IAAI,EAAE,CAAC,CAAC,CAAC,WAAW,CAAA;AAC/D,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,YAAoB,EAAE,IAAY;IACtE,IAAI,YAAY,KAAK,OAAO,IAAI,6BAA6B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACzE,OAAO,GAAG,IAAI,oGAAoG,CAAA;IACpH,CAAC;IACD,IAAI,qCAAqC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAClF,OAAO,GAAG,IAAI,kFAAkF,CAAA;IAClG,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAA;IACtC,OAAO,OAAO;SACX,MAAM,CACL,CAAC,IAAI,EAA2C,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,CAC7F;SACA,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC;SACvE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAc,CAAC;SAClC,IAAI,CAAC,IAAI,CAAC,CAAA;AACf,CAAC"}

package/dist/vision.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Optional vision-model integration.
+ *
+ * Captures a screenshot via the upstream take_screenshot tool and sends it
+ * to a vision model from Pi's model registry. This lets the agent identify
+ * elements by visual attributes (color, layout, coordinates) when the
+ * accessibility tree is insufficient, e.g. canvas/WebGL scenes.
+ *
+ * The pi-ai host module is loaded lazily so the extension runs on hosts
+ * without it; only the vision tool requires it.
+ */
+export interface VisionModelConfig {
+    provider: string;
+    model: string;
+}
+export declare const VISUAL_SYSTEM_PROMPT = "You are a visual analysis assistant for browser automation. You receive a screenshot of a web page and an instruction.\n\nCOORDINATES:\n- Pixel-based, relative to the visible viewport; (0, 0) is the top-left.\n- Estimate positions from the screenshot.\n\nRULES:\n- You only analyze; you never act.\n- Give exact (x, y) coordinates when the instruction asks for an element, so the caller can use coordinate click tools.\n- If the target is not visible, say so explicitly instead of guessing.\n- Be concise and actionable.";
+interface ModelRegistry {
+    find(provider: string, modelId: string): unknown;
+    getApiKeyAndHeaders(model: unknown): Promise<{
+        ok: true;
+        apiKey?: string;
+        headers?: Record<string, string>;
+    } | {
+        ok: false;
+        error: string;
+    }>;
+}
+export declare function createRegistryVisionCaller(visionConfig: VisionModelConfig, registry: ModelRegistry): (instruction: string, imageBase64: string, mimeType: string, signal?: AbortSignal) => Promise<string>;
+interface BrowserClient {
+    callTool(name: string, args: unknown, signal?: AbortSignal): Promise<unknown>;
+}
+/**
+ * Capture a screenshot through the browser client and analyze it with the
+ * provided vision caller. Returns MCP-style content, never throws except on
+ * abort: failures degrade to actionable error text pointing at the
+ * accessibility tree instead.
+ */
+export declare function handleAnalyzeScreenshot(client: BrowserClient, callVision: (instruction: string, imageBase64: string, mimeType: string, signal?: AbortSignal) => Promise<string>, args: {
+    instruction?: string;
+    pageId?: number;
+}, signal?: AbortSignal): Promise<{
+    content: Array<{
+        type: string;
+        text?: string;
+    }>;
+    isError?: boolean;
+}>;
+export {};
+//# sourceMappingURL=vision.d.ts.map

package/dist/vision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vision.d.ts","sourceRoot":"","sources":["../src/vision.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,eAAO,MAAM,oBAAoB,6gBAUJ,CAAA;AA4B7B,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;AAUD,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,iBAAiB,EAC/B,QAAQ,EAAE,aAAa,GACtB,CACD,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,MAAM,CAAC,CA6CnB;AAOD,UAAU,aAAa;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAC9E;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,CACV,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,MAAM,CAAC,EACpB,IAAI,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAC/C,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAqEjF"}

package/dist/vision.js

@@ -0,0 +1,144 @@
+/**
+ * Optional vision-model integration.
+ *
+ * Captures a screenshot via the upstream take_screenshot tool and sends it
+ * to a vision model from Pi's model registry. This lets the agent identify
+ * elements by visual attributes (color, layout, coordinates) when the
+ * accessibility tree is insufficient, e.g. canvas/WebGL scenes.
+ *
+ * The pi-ai host module is loaded lazily so the extension runs on hosts
+ * without it; only the vision tool requires it.
+ */
+export const VISUAL_SYSTEM_PROMPT = `You are a visual analysis assistant for browser automation. You receive a screenshot of a web page and an instruction.
+
+COORDINATES:
+- Pixel-based, relative to the visible viewport; (0, 0) is the top-left.
+- Estimate positions from the screenshot.
+
+RULES:
+- You only analyze; you never act.
+- Give exact (x, y) coordinates when the instruction asks for an element, so the caller can use coordinate click tools.
+- If the target is not visible, say so explicitly instead of guessing.
+- Be concise and actionable.`;
+async function loadComplete() {
+    const mod = (await import('@earendil-works/pi-ai/compat'));
+    if (typeof mod.complete !== 'function') {
+        throw new Error('Host pi-ai does not expose compat.complete; visual analysis is unavailable.');
+    }
+    return mod.complete;
+}
+export function createRegistryVisionCaller(visionConfig, registry) {
+    return async (instruction, imageBase64, mimeType, signal) => {
+        const model = registry.find(visionConfig.provider, visionConfig.model);
+        if (!model) {
+            throw new Error(`Vision model "${visionConfig.provider}/${visionConfig.model}" not found in the model registry.`);
+        }
+        const auth = await registry.getApiKeyAndHeaders(model);
+        if (!auth.ok) {
+            throw new Error(`Auth failed for vision model: ${auth.error}`);
+        }
+        const options = { maxTokens: 2048 };
+        if (auth.apiKey)
+            options.apiKey = auth.apiKey;
+        if (auth.headers)
+            options.headers = auth.headers;
+        if (signal)
+            options.signal = signal;
+        const complete = await loadComplete();
+        const result = await complete(model, {
+            systemPrompt: VISUAL_SYSTEM_PROMPT,
+            messages: [
+                {
+                    role: 'user',
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Analyze this screenshot and respond to the following instruction:\n\n${instruction}`,
+                        },
+                        { type: 'image', data: imageBase64, mimeType },
+                    ],
+                    timestamp: Date.now(),
+                },
+            ],
+        }, options);
+        if (result.stopReason === 'error') {
+            throw new Error(result.errorMessage || 'Vision model request failed');
+        }
+        return result.content
+            .filter((part) => part.type === 'text' && typeof part.text === 'string')
+            .map((part) => part.text)
+            .join('');
+    };
+}
+/**
+ * Capture a screenshot through the browser client and analyze it with the
+ * provided vision caller. Returns MCP-style content, never throws except on
+ * abort: failures degrade to actionable error text pointing at the
+ * accessibility tree instead.
+ */
+export async function handleAnalyzeScreenshot(client, callVision, args, signal) {
+    const instruction = String(args.instruction ?? '');
+    const screenshotArgs = typeof args.pageId === 'number' ? { pageId: args.pageId } : {};
+    try {
+        const screenshotResult = (await client.callTool('take_screenshot', screenshotArgs, signal));
+        let imageBase64 = '';
+        let mimeType = 'image/png';
+        if (Array.isArray(screenshotResult.content)) {
+            for (const item of screenshotResult.content) {
+                if (item.type === 'image' && item.data) {
+                    imageBase64 = item.data;
+                    mimeType = item.mimeType ?? 'image/png';
+                    break;
+                }
+            }
+        }
+        if (!imageBase64) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Failed to capture a screenshot for visual analysis. Use accessibility tree elements instead.',
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const analysis = await callVision(instruction, imageBase64, mimeType, signal);
+        if (!analysis) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'The visual model returned no analysis. Use accessibility tree elements instead.',
+                    },
+                ],
+                isError: true,
+            };
+        }
+        return { content: [{ type: 'text', text: `Visual analysis result:\n${analysis}` }] };
+    }
+    catch (error) {
+        if (signal?.aborted)
+            throw error;
+        const message = error instanceof Error ? error.message : String(error);
+        const unavailable = message.includes('404') ||
+            message.includes('403') ||
+            message.includes('not found') ||
+            message.includes('permission');
+        if (!unavailable) {
+            console.error(`[pi-browser-use] visual analysis failed (${error instanceof Error ? error.name : 'UnknownError'})`);
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: unavailable
+                        ? 'The visual analysis model is unavailable. Use accessibility tree elements (uids from take_snapshot) for all interactions instead.'
+                        : 'Visual analysis failed. Use accessibility tree elements instead.',
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=vision.js.map

package/dist/vision.js.map

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

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "pi-browser-use",
+  "version": "0.1.0",
+  "description": "Opinionated browser-use for the Pi coding agent, powered by chrome-devtools-mcp (not Playwright). Fresh headless by default, authenticated persistent profile opt-in, CLI-first policy bundled.",
+  "keywords": [
+    "pi-package",
+    "pi",
+    "extension",
+    "browser",
+    "automation",
+    "chrome-devtools",
+    "mcp"
+  ],
+  "license": "MIT",
+  "author": "0xPlayerOne",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/0xPlayerOne/pi-browser-use.git"
+  },
+  "homepage": "https://github.com/0xPlayerOne/pi-browser-use#readme",
+  "bugs": {
+    "url": "https://github.com/0xPlayerOne/pi-browser-use/issues"
+  },
+  "type": "module",
+  "engines": {
+    "node": "^20.19.0 || ^22.12.0 || >=23"
+  },
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": {
+      "default": "./package.json"
+    }
+  },
+  "files": [
+    "dist",
+    "skills",
+    "README.md"
+  ],
+  "pi": {
+    "extensions": [
+      "./dist/index.js"
+    ],
+    "skills": [
+      "./skills"
+    ]
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "format:check": "prettier --check .",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepublishOnly": "npm run build",
+    "test": "node --test test/*.test.mjs",
+    "pretest": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "chrome-devtools-mcp": "1.8.0",
+    "typebox": "*"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": ">=0.80.10",
+    "@earendil-works/pi-ai": ">=0.80.10"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-ai": "0.85.1",
+    "@types/node": "^22.0.0",
+    "prettier": "^3.9.6",
+    "typescript": "^5.9.0"
+  }
+}