@browser_use/pi 0.1.0

package/dist/worker.js

@@ -0,0 +1,329 @@
+import { Writable } from 'node:stream';
+import { Session } from 'node:inspector';
+import { createRequire } from 'node:module';
+import { createContext, constants } from 'node:vm';
+import { inspect } from 'node:util';
+import { writeFile, rename } from 'node:fs/promises';
+import { appendFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { CDP } from './cdp.js';
+import { Page, Tabs } from './page.js';
+import { installDomainPolicy, fillSecret } from './policy.js';
+import { redact } from './history.js';
+import { actionHighlighter } from './highlight.js';
+import { prepareModelImages } from './images.js';
+// IPC initialization keeps connection details out of argv and environment.
+process.on('disconnect', () => process.exit(0));
+const config = await new Promise((resolve) => process.once('message', resolve));
+const clean = (value) => redact(value, config.redact ?? []);
+const send = (message) => process.send(clean(message));
+process.chdir(config.workspace);
+let browser = CDP.lazy(config.endpoint, config.operationTimeoutMs, config.approveConnection);
+installDomainPolicy(browser, config, (id) => send({ type: 'owned', targetId: id }));
+let highlight = config.highlightActions ? actionHighlighter(browser) : undefined;
+let tabs = new Tabs(browser, (id) => send({ type: 'owned', targetId: id }));
+function deferredPage(targetId) {
+    return Page.deferred(browser, async () => {
+        if (targetId) {
+            // Only create a replacement when the target is actually absent, not on an attach timeout.
+            const existing = await tabs.list();
+            if (existing.some((t) => t.targetId === targetId))
+                return tabs.get(targetId);
+        }
+        return tabs.open();
+    }, targetId);
+}
+const page = deferredPage(config.targetId);
+let outputFile;
+let runId;
+let output = '';
+let images = [];
+let captureResponse;
+let overflow = false;
+// Bound memory even when generated code writes an unbounded amount of output.
+const hardLimit = 1_000_000;
+let pendingText = '';
+const tailLength = Math.max(0, ...(config.redact ?? []).map((value) => value.length));
+function captureText(text) {
+    if (output.length + text.length > hardLimit)
+        overflow = true;
+    const captured = text.slice(0, Math.max(0, hardLimit - output.length));
+    output += captured;
+    if (outputFile && captured)
+        appendFileSync(outputFile, captured);
+}
+const sink = new Writable({
+    write(chunk, _encoding, callback) {
+        pendingText += chunk.toString();
+        // Redact before splitting, and retain the raw suffix across chunk boundaries.
+        const cut = Math.max(0, pendingText.length - tailLength);
+        let safeCut = cut;
+        for (const secret of config.redact ?? []) {
+            if (!secret)
+                continue;
+            let at = pendingText.indexOf(secret);
+            while (at >= 0 && at < cut) {
+                if (at + secret.length > cut)
+                    safeCut = Math.min(safeCut, at);
+                at = pendingText.indexOf(secret, at + 1);
+            }
+        }
+        captureText(clean(pendingText.slice(0, safeCut)));
+        pendingText = pendingText.slice(safeCut);
+        callback();
+    },
+});
+const evaluator = new Session();
+evaluator.connect();
+let executionContextId;
+evaluator.on('Runtime.executionContextCreated', ({ params }) => {
+    if (params.context.name === 'browser-use')
+        executionContextId = params.context.id;
+});
+evaluator.post('Runtime.enable');
+const realm = createContext({}, {
+    name: 'browser-use',
+    importModuleDynamically: constants.USE_MAIN_CONTEXT_DEFAULT_LOADER,
+});
+if (executionContextId === undefined)
+    throw new Error('Could not initialize the JavaScript context.');
+Object.assign(realm, {
+    global: realm, // Node's global alias refers to this REPL realm, not the worker host.
+    // Reject values JSON would silently drop or change. Dates/toJSON use normal JSON semantics.
+    __serializeResult(value) {
+        const json = JSON.stringify(value, (_key, item) => {
+            if (['undefined', 'function', 'symbol', 'bigint'].includes(typeof item) ||
+                (typeof item === 'number' && !Number.isFinite(item)))
+                throw new Error('Result must contain JSON values: no undefined, functions, symbols, bigint, or non-finite numbers.');
+            return item;
+        });
+        if (json === undefined)
+            throw new Error('Result must be JSON serializable.');
+        if (Buffer.byteLength(json) > 16_000_000)
+            throw new Error('Result exceeds 16 MB; save an artifact and return its path.');
+        return json;
+    },
+    process,
+    Buffer,
+    URL,
+    URLSearchParams,
+    fetch,
+    AbortController,
+    AbortSignal,
+    setTimeout,
+    clearTimeout,
+    setInterval,
+    clearInterval,
+    queueMicrotask,
+    structuredClone,
+    TextEncoder,
+    TextDecoder,
+    browser,
+    tabs,
+    page,
+    workspace: config.workspace,
+    async reconnect() {
+        const targetId = Reflect.get(realm, 'page')?.targetId;
+        browser.close();
+        browser = CDP.lazy(config.endpoint, config.operationTimeoutMs, config.approveConnection);
+        installDomainPolicy(browser, config, (id) => send({ type: 'owned', targetId: id }));
+        highlight = config.highlightActions ? actionHighlighter(browser) : undefined;
+        browser.observeResponse = captureResponse;
+        tabs = new Tabs(browser, (id) => send({ type: 'owned', targetId: id }));
+        Object.assign(realm, { browser, tabs, page: deferredPage(targetId) });
+        observe();
+        return 'Connection reset. Inspect the page; no browser action was replayed. Reacquire other page/frame handles.';
+    },
+    async fillSecret(name, backendNodeId, target = Reflect.get(realm, 'page')) {
+        await target.info();
+        const result = await fillSecret(browser, target.sessionId, name, backendNodeId, config.sensitiveData ?? {});
+        void highlight?.('DOM.focus', { backendNodeId }, target.sessionId);
+        return result;
+    },
+    async checkpoint(name, value, options = {}) {
+        if (!/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,119}$/.test(name))
+            throw new Error('Use a plain checkpoint filename.');
+        const checkpointRun = runId;
+        const valueJson = JSON.stringify(clean(value));
+        if (typeof valueJson !== 'string')
+            throw new Error('Checkpoint must be JSON serializable.');
+        if (options.partial && Buffer.byteLength(valueJson) > 16_000_000)
+            throw new Error('Partial result exceeds 16 MB; checkpoint smaller batches or return file paths.');
+        const path = join(config.workspace, name);
+        const temporary = `${path}.${randomUUID()}.tmp`;
+        await writeFile(temporary, valueJson, { flag: 'wx', mode: 0o600 });
+        await rename(temporary, path);
+        if (options.partial)
+            await new Promise((resolve, reject) => process.send({
+                type: 'partial',
+                ...(checkpointRun ? { runId: checkpointRun } : {}),
+                path,
+                valueJson,
+            }, (error) => (error ? reject(error) : resolve())));
+        return path;
+    },
+    require: createRequire(join(config.workspace, 'package.json')),
+    async screenshot() {
+        const current = Reflect.get(realm, 'page');
+        if (images.length >= 4)
+            throw new Error('At most four screenshots per cell.');
+        const count = images.length;
+        await current.screenshot({ quality: 70 });
+        return images.length > count ? 'Screenshot captured.' : 'Screenshot omitted; see warning.';
+    },
+    async snapshot() {
+        const current = Reflect.get(realm, 'page');
+        return current.snapshot();
+    },
+    async artifact(name, data) {
+        if (!/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,119}$/.test(name))
+            throw new Error('Use a plain filename, max 120 characters.');
+        const path = join(config.workspace, name);
+        await writeFile(path, data, { flag: 'wx' });
+        return path;
+    },
+});
+function observe() {
+    if (config.recording)
+        browser.observeCommand = (method, raw, sessionId) => {
+            const params = raw;
+            const protocolTarget = sessionId ? browser.targetForSession(sessionId) : undefined;
+            const targetId = protocolTarget ? browser.observationTargetId : undefined;
+            if (!targetId)
+                return;
+            if (method === 'Input.dispatchMouseEvent' &&
+                ['mouseReleased', 'mouseWheel'].includes(params.type ?? ''))
+                send({
+                    type: 'action',
+                    action: {
+                        kind: params.type === 'mouseReleased' ? 'Click' : 'Scroll',
+                        targetId,
+                        ...(protocolTarget === targetId && params.x !== undefined ? { x: params.x } : {}),
+                        ...(protocolTarget === targetId && params.y !== undefined ? { y: params.y } : {}),
+                    },
+                });
+            else if (method === 'Input.insertText' || method === 'Page.navigate')
+                send({
+                    type: 'action',
+                    action: { kind: method === 'Page.navigate' ? 'Navigate' : 'Type', targetId },
+                });
+        };
+}
+observe();
+realm.console = new (await import('node:console')).Console(sink, sink);
+async function evaluate(code, captureJson = false) {
+    try {
+        // V8 supports replMode; Node 22's generated protocol types omit this field.
+        const parameters = {
+            expression: captureJson ? `__serializeResult(await (${code}\n))` : code,
+            contextId: executionContextId,
+            awaitPromise: true,
+            replMode: true,
+            objectGroup: 'cell',
+        };
+        const { result, exceptionDetails } = await new Promise((resolve, reject) => {
+            evaluator.post('Runtime.evaluate', parameters, (error, response) => {
+                if (error)
+                    reject(error);
+                else
+                    resolve(response);
+            });
+        });
+        if (exceptionDetails)
+            throw new Error(exceptionDetails.exception?.description ?? exceptionDetails.text);
+        if (captureJson) {
+            if (typeof result.value !== 'string')
+                throw new Error('Result serialization returned no JSON.');
+            return JSON.stringify(clean(JSON.parse(result.value)));
+        }
+        if (result.objectId) {
+            await new Promise((resolve, reject) => evaluator.post('Runtime.callFunctionOn', {
+                objectId: result.objectId,
+                functionDeclaration: 'function() { console.log(this); }',
+                returnByValue: true,
+            }, (error) => {
+                if (error)
+                    reject(error);
+                else
+                    resolve();
+            }));
+        }
+        else if (result.type !== 'undefined') {
+            sink.write(result.unserializableValue ?? inspect(result.value, { maxStringLength: 20_000 }));
+        }
+    }
+    finally {
+        evaluator.post('Runtime.releaseObjectGroup', { objectGroup: 'cell' });
+    }
+}
+process.on('message', async (message) => {
+    if (message.type === 'close') {
+        browser.close();
+        evaluator.disconnect();
+        send({ type: 'closed' });
+        return;
+    }
+    runId = message.runId;
+    output = '';
+    pendingText = '';
+    images = [];
+    const cellImages = images;
+    let active = true;
+    let warned = false;
+    captureResponse = (method, params, result, sessionId) => {
+        if (active)
+            void highlight?.(method, params, sessionId);
+        if (!active || method !== 'Page.captureScreenshot')
+            return;
+        const data = result?.data;
+        if (typeof data !== 'string')
+            return;
+        if (cellImages.length >= 4 || Buffer.byteLength(data, 'base64') > 8_000_000) {
+            if (!warned)
+                sink.write('[Screenshot omitted from model vision: four-image/8 MB limit.]\n');
+            warned = true;
+            return;
+        }
+        const format = params?.format ?? 'png';
+        const mimeType = format === 'jpeg' ? 'image/jpeg' : format === 'webp' ? 'image/webp' : 'image/png';
+        cellImages.push({ type: 'image', data, mimeType });
+    };
+    browser.observeResponse = captureResponse;
+    overflow = false;
+    outputFile = message.outputFile;
+    let valueJson;
+    let failure;
+    try {
+        valueJson = await evaluate(message.code, message.captureJson);
+    }
+    catch (error) {
+        failure = error instanceof Error ? error.message : String(error);
+    }
+    finally {
+        active = false;
+        browser.observeResponse = undefined;
+        captureResponse = undefined;
+    }
+    captureText(clean(pendingText));
+    pendingText = '';
+    if (overflow)
+        output += '\n[Output exceeded the 1 MB capture limit.]';
+    if (output.length > config.maxOutputChars)
+        output = `${output.slice(0, config.maxOutputChars)}\n[Truncated. Full captured output: ${outputFile}]`;
+    const previews = await prepareModelImages(images);
+    const result = {
+        text: [output, ...previews.notes].filter(Boolean).join('\n') || '(no output)',
+        images: previews.images,
+        targetId: Reflect.get(realm, 'page')?.targetId,
+        ...(browser.observationTargetId ? { observationTargetId: browser.observationTargetId } : {}),
+        ...(valueJson !== undefined ? { valueJson } : {}),
+        ...(outputFile ? { outputFile } : {}),
+    };
+    if (failure)
+        send({ type: 'error', message: failure, result });
+    else
+        send({ type: 'result', result });
+});
+send({ type: 'ready', targetId: page.targetId });
+//# sourceMappingURL=worker.js.map

package/dist/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"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","sourcesContent":["import { Writable } from 'node:stream';\nimport { Session, type Runtime } from 'node:inspector';\nimport { createRequire } from 'node:module';\nimport { createContext, constants } from 'node:vm';\nimport { inspect } from 'node:util';\nimport { writeFile, rename } from 'node:fs/promises';\nimport { appendFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { randomUUID } from 'node:crypto';\nimport { CDP } from './cdp.js';\nimport { Page, Tabs } from './page.js';\nimport type { Image, WorkerConfig, WorkerRequest, WorkerResponse } from './protocol.js';\nimport { installDomainPolicy, fillSecret } from './policy.js';\nimport { redact } from './history.js';\nimport { actionHighlighter } from './highlight.js';\nimport { prepareModelImages } from './images.js';\n\n// IPC initialization keeps connection details out of argv and environment.\nprocess.on('disconnect', () => process.exit(0));\nconst config = await new Promise<WorkerConfig>((resolve) => process.once('message', resolve));\nconst clean = <T>(value: T): T => redact(value, config.redact ?? []);\nconst send = (message: WorkerResponse) => process.send!(clean(message));\nprocess.chdir(config.workspace);\nlet browser = CDP.lazy(config.endpoint, config.operationTimeoutMs, config.approveConnection);\ninstallDomainPolicy(browser, config, (id) => send({ type: 'owned', targetId: id }));\nlet highlight = config.highlightActions ? actionHighlighter(browser) : undefined;\nlet tabs = new Tabs(browser, (id) => send({ type: 'owned', targetId: id }));\nfunction deferredPage(targetId?: string) {\n  return Page.deferred(\n    browser,\n    async () => {\n      if (targetId) {\n        // Only create a replacement when the target is actually absent, not on an attach timeout.\n        const existing = await tabs.list();\n        if (existing.some((t) => t.targetId === targetId)) return tabs.get(targetId);\n      }\n      return tabs.open();\n    },\n    targetId,\n  );\n}\nconst page = deferredPage(config.targetId);\nlet outputFile: string | undefined;\nlet runId: string | undefined;\nlet output = '';\nlet images: Image[] = [];\nlet captureResponse: CDP['observeResponse'];\nlet overflow = false;\n// Bound memory even when generated code writes an unbounded amount of output.\nconst hardLimit = 1_000_000;\nlet pendingText = '';\nconst tailLength = Math.max(0, ...(config.redact ?? []).map((value) => value.length));\nfunction captureText(text: string) {\n  if (output.length + text.length > hardLimit) overflow = true;\n  const captured = text.slice(0, Math.max(0, hardLimit - output.length));\n  output += captured;\n  if (outputFile && captured) appendFileSync(outputFile, captured);\n}\nconst sink = new Writable({\n  write(chunk: Buffer, _encoding, callback) {\n    pendingText += chunk.toString();\n    // Redact before splitting, and retain the raw suffix across chunk boundaries.\n    const cut = Math.max(0, pendingText.length - tailLength);\n    let safeCut = cut;\n    for (const secret of config.redact ?? []) {\n      if (!secret) continue;\n      let at = pendingText.indexOf(secret);\n      while (at >= 0 && at < cut) {\n        if (at + secret.length > cut) safeCut = Math.min(safeCut, at);\n        at = pendingText.indexOf(secret, at + 1);\n      }\n    }\n    captureText(clean(pendingText.slice(0, safeCut)));\n    pendingText = pendingText.slice(safeCut);\n    callback();\n  },\n});\nconst evaluator = new Session();\nevaluator.connect();\nlet executionContextId: number | undefined;\nevaluator.on('Runtime.executionContextCreated', ({ params }) => {\n  if (params.context.name === 'browser-use') executionContextId = params.context.id;\n});\nevaluator.post('Runtime.enable');\nconst realm = createContext(\n  {},\n  {\n    name: 'browser-use',\n    importModuleDynamically: constants.USE_MAIN_CONTEXT_DEFAULT_LOADER,\n  },\n);\nif (executionContextId === undefined)\n  throw new Error('Could not initialize the JavaScript context.');\nObject.assign(realm, {\n  global: realm, // Node's global alias refers to this REPL realm, not the worker host.\n  // Reject values JSON would silently drop or change. Dates/toJSON use normal JSON semantics.\n  __serializeResult(value: unknown) {\n    const json = JSON.stringify(value, (_key, item: unknown) => {\n      if (\n        ['undefined', 'function', 'symbol', 'bigint'].includes(typeof item) ||\n        (typeof item === 'number' && !Number.isFinite(item))\n      )\n        throw new Error(\n          'Result must contain JSON values: no undefined, functions, symbols, bigint, or non-finite numbers.',\n        );\n      return item;\n    });\n    if (json === undefined) throw new Error('Result must be JSON serializable.');\n    if (Buffer.byteLength(json) > 16_000_000)\n      throw new Error('Result exceeds 16 MB; save an artifact and return its path.');\n    return json;\n  },\n  process,\n  Buffer,\n  URL,\n  URLSearchParams,\n  fetch,\n  AbortController,\n  AbortSignal,\n  setTimeout,\n  clearTimeout,\n  setInterval,\n  clearInterval,\n  queueMicrotask,\n  structuredClone,\n  TextEncoder,\n  TextDecoder,\n  browser,\n  tabs,\n  page,\n  workspace: config.workspace,\n  async reconnect() {\n    const targetId = (Reflect.get(realm, 'page') as Page)?.targetId;\n    browser.close();\n    browser = CDP.lazy(config.endpoint, config.operationTimeoutMs, config.approveConnection);\n    installDomainPolicy(browser, config, (id) => send({ type: 'owned', targetId: id }));\n    highlight = config.highlightActions ? actionHighlighter(browser) : undefined;\n    browser.observeResponse = captureResponse;\n    tabs = new Tabs(browser, (id) => send({ type: 'owned', targetId: id }));\n    Object.assign(realm, { browser, tabs, page: deferredPage(targetId) });\n    observe();\n    return 'Connection reset. Inspect the page; no browser action was replayed. Reacquire other page/frame handles.';\n  },\n  async fillSecret(\n    name: string,\n    backendNodeId: number,\n    target: Page = Reflect.get(realm, 'page') as Page,\n  ) {\n    await target.info();\n    const result = await fillSecret(\n      browser,\n      target.sessionId,\n      name,\n      backendNodeId,\n      config.sensitiveData ?? {},\n    );\n    void highlight?.('DOM.focus', { backendNodeId }, target.sessionId);\n    return result;\n  },\n  async checkpoint(name: string, value: unknown, options: { partial?: boolean } = {}) {\n    if (!/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,119}$/.test(name))\n      throw new Error('Use a plain checkpoint filename.');\n    const checkpointRun = runId;\n    const valueJson = JSON.stringify(clean(value));\n    if (typeof valueJson !== 'string') throw new Error('Checkpoint must be JSON serializable.');\n    if (options.partial && Buffer.byteLength(valueJson) > 16_000_000)\n      throw new Error(\n        'Partial result exceeds 16 MB; checkpoint smaller batches or return file paths.',\n      );\n    const path = join(config.workspace, name);\n    const temporary = `${path}.${randomUUID()}.tmp`;\n    await writeFile(temporary, valueJson, { flag: 'wx', mode: 0o600 });\n    await rename(temporary, path);\n    if (options.partial)\n      await new Promise<void>((resolve, reject) =>\n        process.send!(\n          {\n            type: 'partial',\n            ...(checkpointRun ? { runId: checkpointRun } : {}),\n            path,\n            valueJson,\n          } satisfies WorkerResponse,\n          (error) => (error ? reject(error) : resolve()),\n        ),\n      );\n    return path;\n  },\n  require: createRequire(join(config.workspace, 'package.json')),\n  async screenshot() {\n    const current = Reflect.get(realm, 'page') as Page;\n    if (images.length >= 4) throw new Error('At most four screenshots per cell.');\n    const count = images.length;\n    await current.screenshot({ quality: 70 });\n    return images.length > count ? 'Screenshot captured.' : 'Screenshot omitted; see warning.';\n  },\n  async snapshot() {\n    const current = Reflect.get(realm, 'page') as Page;\n    return current.snapshot();\n  },\n  async artifact(name: string, data: string | Uint8Array) {\n    if (!/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,119}$/.test(name))\n      throw new Error('Use a plain filename, max 120 characters.');\n    const path = join(config.workspace, name);\n    await writeFile(path, data, { flag: 'wx' });\n    return path;\n  },\n});\nfunction observe() {\n  if (config.recording)\n    browser.observeCommand = (method, raw, sessionId) => {\n      const params = raw as { type?: string; x?: number; y?: number };\n      const protocolTarget = sessionId ? browser.targetForSession(sessionId) : undefined;\n      const targetId = protocolTarget ? browser.observationTargetId : undefined;\n      if (!targetId) return;\n      if (\n        method === 'Input.dispatchMouseEvent' &&\n        ['mouseReleased', 'mouseWheel'].includes(params.type ?? '')\n      )\n        send({\n          type: 'action',\n          action: {\n            kind: params.type === 'mouseReleased' ? 'Click' : 'Scroll',\n            targetId,\n            ...(protocolTarget === targetId && params.x !== undefined ? { x: params.x } : {}),\n            ...(protocolTarget === targetId && params.y !== undefined ? { y: params.y } : {}),\n          },\n        });\n      else if (method === 'Input.insertText' || method === 'Page.navigate')\n        send({\n          type: 'action',\n          action: { kind: method === 'Page.navigate' ? 'Navigate' : 'Type', targetId },\n        });\n    };\n}\nobserve();\nrealm.console = new (await import('node:console')).Console(sink, sink);\n\nasync function evaluate(code: string, captureJson = false): Promise<string | undefined> {\n  try {\n    // V8 supports replMode; Node 22's generated protocol types omit this field.\n    const parameters = {\n      expression: captureJson ? `__serializeResult(await (${code}\\n))` : code,\n      contextId: executionContextId,\n      awaitPromise: true,\n      replMode: true,\n      objectGroup: 'cell',\n    };\n    const { result, exceptionDetails } = await new Promise<Runtime.EvaluateReturnType>(\n      (resolve, reject) => {\n        evaluator.post(\n          'Runtime.evaluate',\n          parameters,\n          (error: Error | null, response: Runtime.EvaluateReturnType) => {\n            if (error) reject(error);\n            else resolve(response);\n          },\n        );\n      },\n    );\n    if (exceptionDetails)\n      throw new Error(exceptionDetails.exception?.description ?? exceptionDetails.text);\n    if (captureJson) {\n      if (typeof result.value !== 'string')\n        throw new Error('Result serialization returned no JSON.');\n      return JSON.stringify(clean(JSON.parse(result.value)));\n    }\n    if (result.objectId) {\n      await new Promise<void>((resolve, reject) =>\n        evaluator.post(\n          'Runtime.callFunctionOn',\n          {\n            objectId: result.objectId,\n            functionDeclaration: 'function() { console.log(this); }',\n            returnByValue: true,\n          },\n          (error) => {\n            if (error) reject(error);\n            else resolve();\n          },\n        ),\n      );\n    } else if (result.type !== 'undefined') {\n      sink.write(result.unserializableValue ?? inspect(result.value, { maxStringLength: 20_000 }));\n    }\n  } finally {\n    evaluator.post('Runtime.releaseObjectGroup', { objectGroup: 'cell' });\n  }\n}\n\nprocess.on('message', async (message: WorkerRequest) => {\n  if (message.type === 'close') {\n    browser.close();\n    evaluator.disconnect();\n    send({ type: 'closed' });\n    return;\n  }\n  runId = message.runId;\n  output = '';\n  pendingText = '';\n  images = [];\n  const cellImages = images;\n  let active = true;\n  let warned = false;\n  captureResponse = (method, params, result, sessionId) => {\n    if (active) void highlight?.(method, params, sessionId);\n    if (!active || method !== 'Page.captureScreenshot') return;\n    const data = (result as { data?: unknown })?.data;\n    if (typeof data !== 'string') return;\n    if (cellImages.length >= 4 || Buffer.byteLength(data, 'base64') > 8_000_000) {\n      if (!warned) sink.write('[Screenshot omitted from model vision: four-image/8 MB limit.]\\n');\n      warned = true;\n      return;\n    }\n    const format = (params as { format?: string })?.format ?? 'png';\n    const mimeType =\n      format === 'jpeg' ? 'image/jpeg' : format === 'webp' ? 'image/webp' : 'image/png';\n    cellImages.push({ type: 'image', data, mimeType });\n  };\n  browser.observeResponse = captureResponse;\n  overflow = false;\n  outputFile = message.outputFile;\n  let valueJson: string | undefined;\n  let failure: string | undefined;\n  try {\n    valueJson = await evaluate(message.code, message.captureJson);\n  } catch (error) {\n    failure = error instanceof Error ? error.message : String(error);\n  } finally {\n    active = false;\n    browser.observeResponse = undefined;\n    captureResponse = undefined;\n  }\n  captureText(clean(pendingText));\n  pendingText = '';\n  if (overflow) output += '\\n[Output exceeded the 1 MB capture limit.]';\n  if (output.length > config.maxOutputChars)\n    output = `${output.slice(0, config.maxOutputChars)}\\n[Truncated. Full captured output: ${outputFile}]`;\n  const previews = await prepareModelImages(images);\n  const result = {\n    text: [output, ...previews.notes].filter(Boolean).join('\\n') || '(no output)',\n    images: previews.images,\n    targetId: (Reflect.get(realm, 'page') as Page)?.targetId,\n    ...(browser.observationTargetId ? { observationTargetId: browser.observationTargetId } : {}),\n    ...(valueJson !== undefined ? { valueJson } : {}),\n    ...(outputFile ? { outputFile } : {}),\n  };\n  if (failure) send({ type: 'error', message: failure, result });\n  else send({ type: 'result', result });\n});\nsend({ type: 'ready', targetId: page.targetId });\n"]}

package/examples/README.md

@@ -0,0 +1,58 @@
+# Examples
+
+Plain TypeScript. `.mjs` is JavaScript explicitly marked as an ES module; the examples use `.ts` so your editor checks the SDK calls.
+
+From this checkout:
+
+```sh
+npm ci && npm run build
+cp .env.example .env # fill the two API keys
+node --env-file=.env examples/extract.ts
+# or: bun --env-file=.env examples/extract.ts
+```
+
+Node 22.19+ runs these files directly. Bun 1.3.14+ also needs Node for the execution worker. npm and pnpm are package managers, not runtimes.
+
+Set `BROWSER=cloud` for Browser Use Cloud, or `BROWSER=local` for isolated local Chrome. Local Chrome must be installed. Each script closes its browser in `finally`. Use `WORKSPACE` to choose where files go.
+
+| Example                            | What you get                                       | Extra environment variables                                   |
+| ---------------------------------- | -------------------------------------------------- | ------------------------------------------------------------- |
+| [extract.ts](extract.ts)           | Ten verified books, typed records, CSV             | Optional `START_URL`                                          |
+| [qa.ts](qa.ts)                     | Bug report, screenshots, partial findings, GIF     | `START_URL` (staging); ffmpeg + local Chrome for GIF export   |
+| [ehr.ts](ehr.ts)                   | An unsigned note for a synthetic patient           | `EHR_URL`; optional cloud `BROWSER_PROFILE_ID`                |
+| [form.ts](form.ts)                 | A submitted demo pizza form, verified response     | Optional `START_URL`                                          |
+| [stripe-link.ts](stripe-link.ts)   | Link-approved test card prefilling                 | `CHECKOUT_URL`, `PURCHASE`; Link CLI login                    |
+| [onepassword.ts](onepassword.ts)   | Login using two selected vault secrets             | `LOGIN_URL`, `OP_USERNAME_REF`, `OP_PASSWORD_REF`; `op` login |
+| [apply-to-job.ts](apply-to-job.ts) | Filled application, attached PDF, review checklist | `JOB_URL`, `RESUME_PDF`, `APPLICANT_JSON`                     |
+| [research.ts](research.ts)         | A streamed answer to your own task                 | Task as command-line argument                                 |
+
+## Credentials and payments
+
+**1Password:** install the [official CLI](https://developer.1password.com/docs/cli/), sign in, and select references such as `op://Test/Login/username` and `op://Test/Login/password`. The host reads those two fields. The model receives names and uses `fillSecret`; it gets no vault-reading tool. MFA stops for a human.
+
+**Link:** install `@stripe/link-cli@0.18.0` and put its `link-cli` executable on PATH. Check `link-cli auth status --format json`. For a new session:
+
+```sh
+link-cli auth login --client-name "Browser Use Pi" --scope "userinfo:read payment_methods.agentic"
+```
+
+For an existing session missing payment access, use `auth upgrade` with the same scope. The example inspects a test checkout, creates a `--test` card request, prints its approval URL, waits up to eight minutes, then prefills and cancels the unused request. It never clicks Pay. It supports ordinary card forms, not Link Pay Tokens or HTTP 402 flows. Keep the checkout directly revisitable: preflight and filling use separate browsers.
+
+Credentials stay out of normal logs and recordings are disabled in these examples. Screenshots are **not pixel-redacted**, and agent-written code has filesystem/network access. Domain rules are navigation controls, not a sandbox. Use test accounts in an isolated environment.
+
+## EHR and job applications
+
+The EHR example requires a sandbox containing patient `TEST-1001`, Avery Example, born `1990-01-02`. It checks both identifiers and saves only an unsigned draft. Local login persists in `artifacts/ehr-profile`; cloud login needs your profile ID.
+
+The job example reads facts from your JSON file and attaches a real PDF by transferring bytes into the browser, so uploads also work remotely. It leaves unknown answers blank and stops before submission. For example:
+
+```json
+{
+  "name": "Avery Example",
+  "email": "avery@example.com",
+  "phone": "202-555-0142",
+  "experience": "Two years building TypeScript applications"
+}
+```
+
+Each script caps steps, time and cost. A stopped run can return partial progress; inspect its status before treating the task as complete.

package/examples/apply-to-job.ts

@@ -0,0 +1,57 @@
+import { Browser, BrowserUse, Type } from '@browser_use/pi';
+import { copyFile, mkdir, readFile } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+
+const url = process.env.JOB_URL;
+const resume = process.env.RESUME_PDF;
+const details = process.env.APPLICANT_JSON;
+if (!url || !resume || !details)
+  throw new Error('Set JOB_URL, RESUME_PDF and APPLICANT_JSON (path to your application details).');
+const pdf = await readFile(resume);
+if (pdf.subarray(0, 5).toString() !== '%PDF-') throw new Error('RESUME_PDF must be a PDF file.');
+const applicant: unknown = JSON.parse(await readFile(details, 'utf8'));
+const workspace = resolve(process.env.WORKSPACE || './artifacts/apply-to-job');
+await mkdir(workspace, { recursive: true });
+if (resolve(resume) !== join(workspace, 'resume.pdf'))
+  await copyFile(resume, join(workspace, 'resume.pdf'));
+const agent = await BrowserUse.create({
+  model: process.env.MODEL || 'openrouter/openai/gpt-5.6-luna',
+  browser:
+    process.env.BROWSER === 'cloud'
+      ? Browser.cloud({ apiKey: process.env.BROWSER_USE_API_KEY ?? '' })
+      : Browser.chromium(),
+  workspace,
+  researchTools: true,
+  telemetry: false,
+  log: false,
+});
+try {
+  const result = await agent.run(
+    `Prepare the application at ${url} using ONLY these facts:
+    ${JSON.stringify(applicant)}
+    The real PDF is resume.pdf in the workspace. Attach it and verify the filename in the form.
+    For uploads that work with local AND remote Chrome: read the PDF in Node, send its base64
+    to page.evaluate, construct a File with type application/pdf from the decoded bytes,
+    assign it through DataTransfer to the observed file input, then dispatch input/change events.
+    DOM.setFileInputFiles with a local path cannot upload a host file to a remote browser.
+    Leave unknown fields blank and report required ones. Do not guess eligibility or protected
+    characteristics. Stop at final review, BEFORE submitting or accepting legal declarations.
+    Save application-review.md listing filled fields, missing answers and the attached file.`,
+    {
+      schema: Type.Object({
+        resumeAttached: Type.Boolean(),
+        filled: Type.Array(Type.String()),
+        needsAnswers: Type.Array(Type.String()),
+        reviewUrl: Type.String(),
+        submitted: Type.Literal(false),
+      }),
+      maxSteps: 40,
+      timeoutMs: 300_000,
+      maxCostUsd: 2,
+    },
+  );
+  console.log(result.status, result.status === 'completed' ? result.output : result.text);
+  if (result.status !== 'completed') process.exitCode = 1;
+} finally {
+  await agent.close();
+}

package/examples/ehr.ts

@@ -0,0 +1,53 @@
+import { Browser, BrowserUse, Type } from '@browser_use/pi';
+
+const url = process.env.EHR_URL;
+if (!url) throw new Error('Set EHR_URL to an EHR sandbox containing synthetic patient TEST-1001.');
+const agent = await BrowserUse.create({
+  model: process.env.MODEL || 'openrouter/openai/gpt-5.6-luna',
+  browser:
+    process.env.BROWSER === 'cloud'
+      ? Browser.cloud({
+          apiKey: process.env.BROWSER_USE_API_KEY ?? '',
+          ...(process.env.BROWSER_PROFILE_ID ? { profileId: process.env.BROWSER_PROFILE_ID } : {}),
+        })
+      : Browser.chromium({ profileDir: `${process.env.WORKSPACE || './artifacts/ehr'}-profile` }),
+  workspace: process.env.WORKSPACE || './artifacts/ehr',
+  telemetry: false,
+  log: false,
+});
+try {
+  // Synthetic source note. Reuse a sandbox login through the browser profile.
+  const note = {
+    patientId: 'TEST-1001',
+    patientName: 'Avery Example',
+    dateOfBirth: '1990-01-02',
+    subjective: 'Demo visit: patient reports mild left ankle pain after a walk.',
+    objective: 'Demo measurements: pulse 72 bpm; blood pressure 118/76 mmHg.',
+    assessment: 'Assessment pending clinician review.',
+    plan: 'Plan pending clinician review.',
+  };
+  const result = await agent.run(
+    `Open the EHR sandbox at ${url}.
+    Find exactly this synthetic patient and verify BOTH identifier and date of birth.
+    If either does not match, stop. Create an UNSIGNED DRAFT visit note from this source:
+    ${JSON.stringify(note)}
+    Preserve the source wording. Do not infer diagnoses, add orders, change medications,
+    sign/finalize notes or contact anyone. Save the draft and verify it appears as unsigned.
+    If login is needed, stop and report it.`,
+    {
+      schema: Type.Object({
+        patientId: Type.String(),
+        draftSaved: Type.Boolean(),
+        evidence: Type.String(),
+        needsReview: Type.Array(Type.String()),
+      }),
+      maxSteps: 30,
+      timeoutMs: 300_000,
+      maxCostUsd: 2,
+    },
+  );
+  console.log(result.status, result.status === 'completed' ? result.output : result.text);
+  if (result.status !== 'completed') process.exitCode = 1;
+} finally {
+  await agent.close();
+}

package/examples/extract.ts

@@ -0,0 +1,50 @@
+import { Browser, BrowserUse, Type } from '@browser_use/pi';
+
+// A website becomes a typed dataset and a CSV, with source URLs for every row.
+const agent = await BrowserUse.create({
+  model: process.env.MODEL || 'openrouter/openai/gpt-5.6-luna',
+  browser:
+    process.env.BROWSER === 'cloud'
+      ? Browser.cloud({ apiKey: process.env.BROWSER_USE_API_KEY ?? '' })
+      : Browser.chromium(),
+  workspace: process.env.WORKSPACE || './artifacts/extract',
+  researchTools: true,
+  log: 'pretty',
+  highlightActions: true,
+});
+try {
+  const result = await agent.run(
+    `Visit ${process.env.START_URL || 'https://books.toscrape.com/'}.
+    Collect the first 10 books in displayed order. Open their detail pages to verify title,
+    price, currency and stock status. Keep missing values null; do not guess.
+    Save books.csv in the workspace and publish a checkpoint after each verified book.
+    Return the records and the CSV path.`,
+    {
+      schema: Type.Object({
+        books: Type.Array(
+          Type.Object({
+            title: Type.String(),
+            price: Type.Union([Type.Number(), Type.Null()]),
+            currency: Type.Union([Type.String(), Type.Null()]),
+            inStock: Type.Union([Type.Boolean(), Type.Null()]),
+            url: Type.String(),
+          }),
+        ),
+        csv: Type.String(),
+      }),
+      maxSteps: 40,
+      timeoutMs: 300_000,
+      maxCostUsd: 2,
+    },
+  );
+  console.log(
+    JSON.stringify(
+      result.status === 'completed' ? result.output : (result.partial?.value ?? result.text),
+      null,
+      2,
+    ),
+  );
+  if (result.status !== 'completed') process.exitCode = 1;
+} finally {
+  await agent.close();
+}

package/examples/form.ts

@@ -0,0 +1,36 @@
+import { Browser, BrowserUse, Type } from '@browser_use/pi';
+
+const agent = await BrowserUse.create({
+  model: process.env.MODEL || 'openrouter/openai/gpt-5.6-luna',
+  browser:
+    process.env.BROWSER === 'cloud'
+      ? Browser.cloud({ apiKey: process.env.BROWSER_USE_API_KEY ?? '' })
+      : Browser.chromium(),
+  workspace: process.env.WORKSPACE || './artifacts/form',
+  highlightActions: true,
+  log: 'pretty',
+});
+try {
+  const result = await agent.run(
+    `Open ${process.env.START_URL || 'https://httpbin.org/forms/post'}.
+    Fill the test pizza form: customer Avery Example, phone 202-555-0142,
+    email avery@example.com, medium pizza, cheese and mushroom toppings,
+    delivery time 18:30, comment "Synthetic Browser Use Pi demo".
+    Submit this demo form once. Inspect the response and verify the submitted fields.
+    If the submission result is ambiguous, report that instead of submitting again.`,
+    {
+      schema: Type.Object({
+        submitted: Type.Boolean(),
+        verifiedFields: Type.Record(Type.String(), Type.String()),
+        mismatches: Type.Array(Type.String()),
+      }),
+      maxSteps: 20,
+      timeoutMs: 180_000,
+      maxCostUsd: 1,
+    },
+  );
+  console.log(result.status, result.status === 'completed' ? result.output : result.text);
+  if (result.status !== 'completed') process.exitCode = 1;
+} finally {
+  await agent.close();
+}