@mirasim/computer-use 0.0.0-stage → 0.1.0-rc.3

package/dist/platform/browser/bridge/server-core.d.ts

@@ -0,0 +1,66 @@
+import http from "node:http";
+import type { Duplex } from "node:stream";
+import { type ExtensionChannel } from "./extension-channel.ts";
+import { BridgeModel } from "./model.ts";
+import { ExtensionUpdates } from "./extension-updates.ts";
+export interface BridgeServerOptions {
+    port?: number;
+    openUrl?: (url: string) => void | Promise<void>;
+    extensionId?: string;
+    socketPath?: string;
+    log?: (...args: unknown[]) => void;
+}
+export declare class ExtensionConnection {
+    private readonly channel;
+    protected readonly log: (...args: unknown[]) => void;
+    protected readonly warn: (...args: unknown[]) => void;
+    private readonly callbacks;
+    private lastId;
+    onEvent: ((method: string, params: unknown[]) => void) | null;
+    onClose: (() => void) | null;
+    constructor(channel: ExtensionChannel, log: (...args: unknown[]) => void, warn: (...args: unknown[]) => void);
+    get transport(): ExtensionChannel["kind"];
+    get pendingCount(): number;
+    get isOpen(): boolean;
+    send(method: string, params: unknown[]): Promise<unknown>;
+    close(reason: string): void;
+    private onMessage;
+    private dispose;
+}
+export declare abstract class BridgeServerCore {
+    protected abstract handleUpgrade(req: http.IncomingMessage, socket: Duplex, head: Buffer): void;
+    protected readonly uuid: `${string}-${string}-${string}-${string}-${string}`;
+    private readonly httpServer;
+    protected readonly wss: import("ws").Server<typeof import("ws").WebSocket, typeof http.IncomingMessage>;
+    protected readonly model: BridgeModel;
+    readonly extensionId: string;
+    readonly extensionIds: string[];
+    protected readonly updates: ExtensionUpdates;
+    protected activeOperations: number;
+    protected readonly log: (...args: unknown[]) => void;
+    protected readonly warn: (...args: unknown[]) => void;
+    private readonly openUrl;
+    protected port: number;
+    protected extension: ExtensionConnection | null;
+    protected extensionInitialized: boolean;
+    protected extensionSession: string | null;
+    protected readonly standby: Set<ExtensionConnection>;
+    protected readyWaiters: Array<() => void>;
+    private socketServer;
+    private readonly socketPath;
+    private connectInFlight;
+    protected keepalive: NodeJS.Timeout | null;
+    constructor(options?: BridgeServerOptions);
+    start(): Promise<void>;
+    private startNativeLeg;
+    protected abstract attachExtension(channel: ExtensionChannel): void;
+    cdpUrl(): string;
+    connectPageUrl(): string;
+    extensionConnected(): boolean;
+    ensureExtension(): Promise<void>;
+    private waitExtensionReady;
+    stop(): void;
+    protected runOperation<T>(operation: () => Promise<T>): Promise<T>;
+    private handleHttp;
+    private stripUuid;
+}

package/dist/platform/browser/bridge/server-core.js

@@ -0,0 +1 @@
+import{randomUUID as m}from"node:crypto";import w from"node:http";import h from"node:fs";import x from"node:net";import v from"node:path";import{WebSocketServer as y}from"ws";import{socketChannel as b}from"./extension-channel.js";import{BridgeModel as S}from"./model.js";import{MIRASIM_EXTENSION_ID as E,extensionManifest as I}from"./extension-id.js";import{ExtensionUpdates as k}from"./extension-updates.js";const T=15e3,f=3e4,u=3e3;class L{channel;log;warn;callbacks=new Map;lastId=0;onEvent=null;onClose=null;constructor(e,t,s){this.channel=e,this.log=t,this.warn=s,e.onMessage(r=>this.onMessage(r)),e.onClose(()=>this.dispose())}get transport(){return this.channel.kind}get pendingCount(){return this.callbacks.size}get isOpen(){return this.channel.isOpen}send(e,t){if(!this.channel.isOpen)return Promise.reject(new Error("Extension connection closed"));const s=++this.lastId,r=Date.now();return new Promise((i,n)=>{const o=e==="bridge.ping"?null:setTimeout(()=>{this.callbacks.has(s)&&this.warn(`slow: ${p(e,t)} pending ${u}ms`)},u);o?.unref?.();const c=setTimeout(()=>{if(!this.callbacks.delete(s))return;o&&clearTimeout(o);const a=`Extension did not answer ${p(e,t)} within ${f}ms`;n(new Error(a)),this.close("Extension command timed out")},f);c.unref?.();const d=()=>{clearTimeout(c),o&&clearTimeout(o)};this.callbacks.set(s,{resolve:a=>{d();const g=Date.now()-r;g>=u&&e!=="bridge.ping"&&this.warn(`${p(e,t)} answered after ${g}ms`),i(a)},reject:a=>{d(),n(a)}});try{this.channel.send(JSON.stringify({id:s,method:e,params:t}))}catch(a){this.callbacks.delete(s),d(),n(a),this.close("Extension transport failed")}})}close(e){try{this.channel.close(e)}finally{this.dispose()}}onMessage(e){let t;try{t=JSON.parse(e)}catch(s){this.log("malformed extension message:",s);return}if(t.id!==void 0&&this.callbacks.has(t.id)){const s=this.callbacks.get(t.id);this.callbacks.delete(t.id),t.error!==void 0?s.reject(new Error(t.error)):s.resolve(t.result);return}t.method&&this.onEvent?.(t.method,t.params??[])}dispose(){for(const e of this.callbacks.values())e.reject(new Error("Extension connection closed"));this.callbacks.clear(),this.onClose?.(),this.onClose=null}}function p(l,e){if(l!=="chrome.debugger.sendCommand")return l;const t=e[0],s=typeof e[1]=="string"?e[1]:l,r=[t?.tabId===void 0?null:`tab=${t.tabId}`,t?.sessionId?`session=${t.sessionId}`:null].filter(Boolean);return r.length?`${s} ${r.join(" ")}`:s}class R{uuid=m();httpServer;wss=new y({noServer:!0});model;extensionId;extensionIds;updates;activeOperations=0;log;warn;openUrl;port=0;extension=null;extensionInitialized=!1;extensionSession=null;standby=new Set;readyWaiters=[];socketServer=null;socketPath;connectInFlight=null;keepalive=null;constructor(e={}){this.log=e.log??(()=>{}),this.warn=e.log??((...t)=>console.error("[bridge]",...t)),this.extensionId=e.extensionId??E,this.extensionIds=[this.extensionId],this.openUrl=e.openUrl??null,this.model=new S((t,s)=>{if(this.updates.reloading)throw new Error("The Mirasim extension is reloading; reconnect before continuing.");if(!this.extension)throw new Error("Bridge extension not connected");return this.extension.send(t,s)},this.log),this.updates=new k(I(),()=>!this.extension||this.model.clientCount()>0||this.activeOperations>0||this.extension.pendingCount>0,async()=>{if(!this.extension)throw new Error("The Mirasim extension disconnected before reloading.");return await this.extension.send("bridge.reload",[])}),this.port=e.port??0,this.socketPath=e.socketPath??null,this.httpServer=w.createServer((t,s)=>this.handleHttp(t,s)),this.httpServer.on("upgrade",(t,s,r)=>{this.handleUpgrade(t,s,r)})}async start(){await new Promise((e,t)=>{this.httpServer.once("error",t),this.httpServer.listen(this.port,"127.0.0.1",()=>e())}),this.port=this.httpServer.address().port,await this.startNativeLeg()}async startNativeLeg(){const e=this.socketPath;if(!e)return;const t=e.startsWith("\\\\.\\pipe\\");if(!t)try{h.mkdirSync(v.dirname(e),{recursive:!0})}catch(i){this.warn("native leg unavailable:",i);return}const s=x.createServer(i=>{i.on("error",n=>this.log("native socket error:",n)),this.attachExtension(b(i,n=>this.warn("native leg:",n.message)))});s.on("error",i=>this.warn("native leg listener:",i));const r=()=>new Promise((i,n)=>{s.once("error",n),s.listen(e,()=>i())});try{await r()}catch(i){if(t||i.code!=="EADDRINUSE"){this.warn("native leg unavailable:",i);return}try{h.unlinkSync(e),await r()}catch(n){this.warn("native leg unavailable:",n);return}}if(!t)try{h.chmodSync(e,384)}catch{}this.socketServer=s,this.log("native leg listening on",e)}cdpUrl(){return`http://127.0.0.1:${this.port}/${this.uuid}`}connectPageUrl(){const e=`ws://127.0.0.1:${this.port}/extension/${this.uuid}`;return`chrome-extension://${this.extensionId}/connect.html?relay=${encodeURIComponent(e)}`}extensionConnected(){return this.extension!==null}async ensureExtension(){this.extension&&this.extensionInitialized&&!this.updates.reloading||(this.connectInFlight||(this.connectInFlight=(async()=>{const e=this.waitExtensionReady();this.openUrl&&await this.openUrl(this.connectPageUrl());let t;const s=new Promise((r,i)=>{t=setTimeout(()=>i(new Error("The mirasim bridge extension did not connect \u2014 is it installed and enabled in your browser?")),T),t.unref?.()});try{await Promise.race([e,s])}finally{clearTimeout(t)}})(),this.connectInFlight.catch(()=>{}).finally(()=>{this.connectInFlight=null})),await this.connectInFlight)}waitExtensionReady(){return this.extension&&this.extensionInitialized&&!this.updates.reloading?Promise.resolve():new Promise(e=>this.readyWaiters.push(e))}stop(){this.updates.reset(),this.keepalive&&clearInterval(this.keepalive),this.extension?.close("Bridge stopped");for(const e of this.wss.clients)e.close(1e3,"Bridge stopped");if(this.httpServer.close(),this.socketServer?.close(),this.socketServer=null,this.socketPath&&!this.socketPath.startsWith("\\\\.\\pipe\\"))try{h.unlinkSync(this.socketPath)}catch{}}async runOperation(e){if(this.updates.reloading)throw new Error("The Mirasim extension is reloading; reconnect before continuing.");this.activeOperations+=1;try{return await e()}finally{this.activeOperations-=1}}handleHttp(e,t){const s=new URL(e.url??"/",`http://127.0.0.1:${this.port}`),r=this.stripUuid(s.pathname);if(r===null){t.writeHead(404).end();return}const i=(n,o)=>{const c=JSON.stringify(o,null,2);t.writeHead(n,{"Content-Type":"application/json; charset=UTF-8","Content-Length":Buffer.byteLength(c)}),t.end(c)};if(r==="/status"&&e.method==="GET"){const n=this.extensionConnected()&&this.extensionInitialized;i(200,{extensionConnected:n,extension:this.updates.status(n),standbyBrowsers:this.standby.size});return}if(r==="/extension/reload"&&e.method==="POST"){if(e.headers.origin){i(403,{error:"Reload must be requested by the local host."});return}try{this.updates.request(),i(202,{scheduled:!0})}catch(n){i(409,{error:n instanceof Error?n.message:String(n)})}return}if(r==="/recycle"&&e.method==="POST"){this.runOperation(()=>this.model.recycleAgentTabs()).then(n=>i(200,n),n=>i(502,{error:n instanceof Error?n.message:String(n)}));return}if(r==="/json/version"&&e.method==="GET"){i(200,{Browser:"mirasim-bridge","Protocol-Version":"1.3",webSocketDebuggerUrl:`ws://127.0.0.1:${this.port}/cdp/${this.uuid}`});return}if((r==="/json"||r==="/json/list")&&e.method==="GET"){this.runOperation(()=>this.model.listTargets()).then(n=>i(200,n),n=>i(500,{error:n instanceof Error?n.message:String(n)}));return}if(r==="/json/new"&&(e.method==="PUT"||e.method==="GET")){const n=decodeURIComponent(s.search.slice(1));(async()=>{try{await this.ensureExtension();const{targetId:o}=await this.runOperation(()=>this.model.createTarget(n||void 0));i(200,{id:o,type:"page",url:n||"about:blank"})}catch(o){i(500,{error:o instanceof Error?o.message:String(o)})}})();return}t.writeHead(404).end()}stripUuid(e){const t=`/${this.uuid}`;if(!e.startsWith(t))return null;const s=e.slice(t.length).replace(/\/$/,"");return s.startsWith("/")?s:null}}export{R as BridgeServerCore,L as ExtensionConnection};

package/dist/platform/browser/bridge/server.d.ts

@@ -0,0 +1,13 @@
+import http from "node:http";
+import type { Duplex } from "node:stream";
+import { BridgeServerCore } from "./server-core.ts";
+import { type ExtensionChannel } from "./extension-channel.ts";
+export type { BridgeServerOptions } from "./server-core.ts";
+export declare class BridgeServer extends BridgeServerCore {
+    protected handleUpgrade(req: http.IncomingMessage, socket: Duplex, head: Buffer): Promise<void>;
+    protected attachExtension(channel: ExtensionChannel): void;
+    private admitExtension;
+    private activateExtension;
+    private onExtensionEvent;
+    private attachCdpClient;
+}

package/dist/platform/browser/bridge/server.js

@@ -0,0 +1 @@
+import"node:http";import{WebSocket as l}from"ws";import"./model.js";import{BridgeServerCore as c,ExtensionConnection as u}from"./server-core.js";import{webSocketChannel as m}from"./extension-channel.js";import{parseExtensionRuntime as f}from"./extension-updates.js";const x=2e4,p=5e3,g=5e3;class T extends c{async handleUpgrade(t,e,n){const i=new URL(t.url??"/",`http://127.0.0.1:${this.port}`),s=t.headers.origin;if(i.pathname===`/extension/${this.uuid}`){if(s&&!this.extensionIds.some(o=>s===`chrome-extension://${o}`)){e.destroy();return}this.wss.handleUpgrade(t,e,n,o=>this.attachExtension(m(o)));return}if(i.pathname===`/cdp/${this.uuid}`){if(s){e.destroy();return}try{await this.ensureExtension()}catch(o){this.log("rejecting CDP client:",o),e.destroy();return}this.wss.handleUpgrade(t,e,n,o=>this.attachCdpClient(o));return}e.destroy()}attachExtension(t){const e=new u(t,this.log,this.warn);if(!this.extension){this.activateExtension(e,[]);return}const n=[];let i=!1;e.onEvent=(s,o)=>{if(n.push([s,o]),!i&&s==="extension.connected"){i=!0;const a=typeof o[0]=="string"?o[0]:null;this.admitExtension(e,n,a)}},e.onClose=()=>{this.standby.delete(e)}}async admitExtension(t,e,n){const i=this.extension,s=!n||!this.extensionSession||n===this.extensionSession;if(i&&!s&&await v(i,p)){if(this.extension!==i)return this.admitExtension(t,e,n);if(!t.isOpen)return;t.onEvent=null,this.standby.add(t),this.warn("another browser's extension connected while one is active; it waits in standby until the active browser goes");return}t.isOpen&&this.activateExtension(t,e)}activateExtension(t,e){const n=this.extension;this.extension=null,n?.close("Replaced by a new extension connection"),n&&this.model.onExtensionDisconnected(),this.keepalive&&clearInterval(this.keepalive),this.updates.reset(),this.extension=t,this.extensionInitialized=!1,this.extensionSession=null,t.onEvent=(i,s)=>{this.extension===t&&this.onExtensionEvent(i,s)},t.onClose=()=>{this.extension===t&&(this.extension=null,this.extensionSession=null,this.updates.reset(),this.extensionInitialized=!1,this.keepalive&&clearInterval(this.keepalive),this.keepalive=null,this.model.onExtensionDisconnected(),setTimeout(()=>{if(!this.extension){for(const i of this.standby)i.close("The active browser left; reconnect to take over");this.standby.clear()}},g).unref?.())};for(const[i,s]of e)this.onExtensionEvent(i,s);this.keepalive=setInterval(()=>{t.send("bridge.ping",[]).catch(()=>{})},x),this.keepalive.unref?.()}onExtensionEvent(t,e){switch(t){case"chrome.tabs.onCreated":{const[n,i]=e;this.model.onTabCreated(n??{},i??{});break}case"chrome.tabs.onRemoved":this.model.onTabRemoved(e[0]);break;case"chrome.tabs.onReplaced":this.model.onTabReplaced(...e);break;case"chrome.debugger.onEvent":{const[n,i,s]=e;this.model.onDebuggerEvent(n??{},i,s);break}case"chrome.debugger.onDetach":this.model.onDebuggerDetach(e[0]??{});break;case"extension.connected":{this.extensionSession=typeof e[0]=="string"?e[0]:null,this.model.onExtensionConnected(e[0]);break}case"extension.initialized":{const n=f(e[0]);if(n&&!this.extensionIds.includes(n.id)){this.extension?.close("Unexpected extension identity");return}this.updates.runtime=n,this.extensionInitialized=!0;const i=this.readyWaiters;this.readyWaiters=[];for(const s of i)s();break}case"extension.updateAvailable":{const n=e[0];if(typeof n!="string"||!/^\d+(\.\d+){0,3}$/.test(n))break;this.updates.updateVersion=n;try{this.updates.request()}catch(i){this.log("extension update waits for manual reload:",i)}break}default:this.log("unknown extension event:",t)}}attachCdpClient(t){if(this.updates.reloading){t.close(1013,"The Mirasim extension is reloading");return}const e=this.model.addClient(n=>{t.readyState===l.OPEN&&t.send(JSON.stringify(n))});t.on("message",n=>{let i;try{i=JSON.parse(n.toString())}catch(s){this.log("malformed CDP message:",s);return}(async()=>{const{id:s,sessionId:o,method:a,params:h}=i;a==="Page.getFrameTree"&&s!==void 0&&o&&e.trackFrameTree(s,o);try{const r=await this.runOperation(()=>this.model.handleCommand(e,a??"",h,o));e.send({id:s,sessionId:o,result:r})}catch(r){e.send({id:s,sessionId:o,error:{message:r instanceof Error?r.message:String(r)}})}})()}),t.on("close",()=>this.model.removeClient(e)),t.on("error",()=>this.model.removeClient(e))}}async function v(d,t){if(!d.isOpen)return!1;let e;const n=new Promise(i=>{e=setTimeout(()=>i(!1),t)});try{return await Promise.race([d.send("bridge.ping",[]).then(()=>!0,()=>!1),n])}finally{clearTimeout(e)}}export{T as BridgeServer};

package/dist/platform/browser/bridge-tabs.d.ts

@@ -0,0 +1,22 @@
+import type { Browser, Page } from "playwright-core";
+interface BridgeTabInfo {
+    tabId: number;
+    title: string;
+    url: string;
+    unloaded: boolean;
+    browserSession: string;
+}
+export declare function bridgeRequest<T>(browser: Browser, method: string, params?: Record<string, unknown>): Promise<T>;
+export declare function bridgeTabs(browser: Browser): Promise<{
+    unloaded: BridgeTabInfo[];
+    browserSession: string | null;
+}>;
+export declare function bridgeBrowserSession(browser: Browser): Promise<string | null>;
+export declare function restoreBridgeTab(browser: Browser, tabId: number, targetId: string, browserSession: string): Promise<{
+    page: Page;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+}>;
+export {};

package/dist/platform/browser/bridge-tabs.js

@@ -0,0 +1 @@
+import{pageTargetInfo as w}from"./tabs.js";async function s(n,e,t={}){const o=await n.newBrowserCDPSession();try{return await o.send(e,t)}finally{await o.detach().catch(()=>{})}}async function c(n){if(n.version()!=="mirasim-bridge")return{unloaded:[],browserSession:null};try{const e=await s(n,"Mirasim.tabs");return{unloaded:e.tabs.filter(o=>o.unloaded).map(o=>({...o,browserSession:e.browserSession??""})),browserSession:e.browserSession||null}}catch(e){if(/wasn't found|not found|not allowed|unknown method/i.test(String(e)))return{unloaded:[],browserSession:null};throw e}}async function u(n){return(await c(n).catch(()=>null))?.browserSession??null}async function f(n,e,t,o){const a=await s(n,"Mirasim.restoreTab",{tabId:e,targetId:t,browserSession:o}),i=Date.now()+1e4;for(;Date.now()<i;){for(const r of n.contexts().flatMap(l=>l.pages()))if(!r.isClosed()&&(await w(r).catch(()=>null))?.targetId===t)return{page:r,viewport:a.viewport};await new Promise(r=>setTimeout(r,50))}throw new Error(`Restored tab ${e} did not become readable; no action was sent to a replacement page.`)}export{u as bridgeBrowserSession,s as bridgeRequest,c as bridgeTabs,f as restoreBridgeTab};

package/dist/platform/browser/cdp-connection.d.ts

@@ -0,0 +1,3 @@
+import { type Browser } from "playwright-core";
+export declare function browserArtifactsDir(): string;
+export declare function connectBrowserCdp(url: string, timeout?: number): Promise<Browser>;

package/dist/platform/browser/cdp-connection.js

@@ -0,0 +1 @@
+import{mkdir as n}from"node:fs/promises";import{join as e}from"node:path";import{chromium as i}from"playwright-core";import{sharedHome as c}from"../home.js";function m(){return e(c(),"downloads",".staging")}async function p(t,r){const o=m();return await n(o,{recursive:!0,mode:448}),i.connectOverCDP(t,{artifactsDir:o,...r===void 0?{}:{timeout:r}})}export{m as browserArtifactsDir,p as connectBrowserCdp};

package/dist/platform/browser/chrome-binary.d.ts

@@ -0,0 +1,6 @@
+import { type BrowserConfig } from "./config.ts";
+export declare function isAttachedProfile(cfg?: BrowserConfig): boolean;
+export declare function needsNoSandbox(platform?: NodeJS.Platform, uid?: number | undefined): boolean;
+export declare function needsShmFallback(platform?: NodeJS.Platform, bytes?: number | null): boolean;
+export declare function findChrome(cfg?: BrowserConfig): string | null;
+export declare function chromeMissingError(): Error;

package/dist/platform/browser/chrome-binary.js

@@ -0,0 +1 @@
+import{existsSync as i,statfsSync as p}from"node:fs";import{homedir as a}from"node:os";import{delimiter as u,join as s}from"node:path";import{browserConfigFromEnv as m}from"./config.js";import{msgChromeMissing as h}from"./messages.js";function P(o=m()){return o.attached}function v(o=process.platform,r=typeof process.getuid=="function"?process.getuid():void 0){return o==="linux"&&r===0}function G(o=process.platform,r=o==="linux"?f():null){return o==="linux"&&r!==null&&r<512*1024*1024}function f(){try{const o=p("/dev/shm");return o.blocks*o.bsize}catch{return null}}function S(o=m()){const r=o.chromePath;if(r)return i(r)?r:null;const n=process.platform==="darwin"?["/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",s(a(),"Applications/Google Chrome.app/Contents/MacOS/Google Chrome"),"/Applications/Chromium.app/Contents/MacOS/Chromium"]:process.platform==="win32"?g():["/opt/google/chrome/chrome","/usr/bin/google-chrome","/usr/bin/google-chrome-stable","/usr/bin/chromium","/usr/bin/chromium-browser"];for(const e of n)if(i(e))return e;const t=process.platform==="win32"?["chrome.exe","chromium.exe"]:["google-chrome","google-chrome-stable","chromium","chromium-browser"];for(const e of(process.env.PATH??"").split(u))for(const l of t){const c=s(e,l);if(e&&i(c))return c}return null}function g(){const o=[process.env.ProgramFiles,process.env["ProgramFiles(x86)"],process.env.LOCALAPPDATA],r=["Google/Chrome/Application/chrome.exe","Chromium/Application/chrome.exe"];return[...o.flatMap(n=>n?r.map(t=>s(n,t)):[]),"C:/Program Files/Google/Chrome/Application/chrome.exe","C:/Program Files (x86)/Google/Chrome/Application/chrome.exe"]}function d(){return process.platform==="darwin"?"brew install --cask google-chrome":process.platform==="win32"?"download it from https://www.google.com/chrome/":"e.g. apt install chromium, or the vendor .deb from google.com/chrome"}function F(){return new Error(h(d()))}export{F as chromeMissingError,S as findChrome,P as isAttachedProfile,v as needsNoSandbox,G as needsShmFallback};

package/dist/platform/browser/config.d.ts

@@ -0,0 +1,29 @@
+export interface TabClaim {
+    key: string;
+    isolated: boolean;
+}
+export interface BrowserConfig {
+    readonly profileDir: string;
+    readonly attached: boolean;
+    readonly chromePath?: string;
+    readonly tab: TabClaim | null;
+    readonly tabReuse: boolean;
+    readonly runSlug?: string;
+    readonly window: "offscreen" | "normal";
+    readonly cdpUrl?: string;
+    readonly cdpStrict: boolean;
+    readonly extension: boolean;
+    readonly home: string;
+}
+export interface BrowserConfigOptions {
+    profileDir?: string;
+    attached?: boolean;
+    chromePath?: string;
+    tab?: string;
+    runSlug?: string;
+    window?: "offscreen" | "normal";
+    cdpUrl?: string;
+    cdpStrict?: boolean;
+    extension?: boolean;
+}
+export declare function browserConfigFromEnv(opts?: BrowserConfigOptions, env?: NodeJS.ProcessEnv): BrowserConfig;

package/dist/platform/browser/config.js

@@ -0,0 +1 @@
+import{join as o}from"node:path";import{computerUseHome as n}from"../home.js";function c(e){const r=/^(name|ctx):(.+)$/.exec(e??"");if(!r)return null;const t=r[2].trim().toLowerCase();return/^[a-z0-9][a-z0-9-]{0,31}$/.test(t)?{key:t,isolated:r[1]==="ctx"}:null}function a(e={},r=process.env){const t=e.tab??r.COMPUTER_USE_TAB,i=e.cdpUrl??(r.COMPUTER_USE_CDP_URL?.trim()||void 0);return Object.freeze({profileDir:e.profileDir??U(r),attached:e.attached??r.COMPUTER_USE_ATTACHED==="1",chromePath:e.chromePath??(r.COMPUTER_USE_CHROME?.trim()||void 0),tab:c(t),tabReuse:t==="reuse",runSlug:e.runSlug??(r.COMPUTER_USE_RUN_SLUG?.trim()||void 0),window:e.window??(r.COMPUTER_USE_WINDOW==="offscreen"?"offscreen":"normal"),cdpUrl:i,cdpStrict:e.cdpStrict??(e.cdpUrl!==void 0||r.COMPUTER_USE_CDP_STRICT==="1"),extension:e.extension??r.COMPUTER_USE_BROWSER?.trim()==="extension",home:n(r)})}function U(e=process.env){return e.COMPUTER_USE_PROFILE_DIR||o(n(e),"chrome")}export{a as browserConfigFromEnv};

package/dist/platform/browser/devtools-port.d.ts

@@ -0,0 +1,3 @@
+export declare function readDevToolsPort(profileDir: string): number | null;
+export declare function pingDevTools(port: number, timeoutMs?: number): Promise<boolean>;
+export declare function waitForDevToolsPort(profileDir: string, timeoutMs: number, gaveUp: () => boolean): Promise<number | null>;

package/dist/platform/browser/devtools-port.js

@@ -0,0 +1,2 @@
+import{readFileSync as s}from"node:fs";import{join as l}from"node:path";const a=r=>new Promise(o=>setTimeout(o,r));function c(r){try{const o=s(l(r,"DevToolsActivePort"),"utf8").split(`
+`)[0]?.trim(),t=o?Number.parseInt(o,10):Number.NaN;return Number.isInteger(t)&&t>0&&t<65536?t:null}catch{return null}}async function f(r,o=700){const t=new AbortController,n=setTimeout(()=>t.abort(),o);try{return(await fetch(`http://127.0.0.1:${r}/json/version`,{signal:t.signal})).ok}catch{return!1}finally{clearTimeout(n)}}async function p(r,o,t){const n=Date.now()+o;let e=20;for(;;){const i=c(r);if(i!==null)return i;if(t()||Date.now()>=n)return null;await a(e),e=Math.min(150,Math.round(e*1.6))}}export{f as pingDevTools,c as readDevToolsPort,p as waitForDevToolsPort};

package/dist/platform/browser/downloads.d.ts

@@ -0,0 +1,22 @@
+import type { Browser, Page } from "playwright-core";
+import type { ActResult, VerbSpec } from "../types.ts";
+export declare const DOWNLOAD_VERB: VerbSpec;
+export declare class BrowserDownloads {
+    private watches;
+    private saving;
+    private root;
+    private source;
+    private bridge;
+    private connect;
+    private snapshot;
+    arm(browser: Browser, page: Page): Promise<ActResult>;
+    private markSource;
+    private stuckHint;
+    private inPlace;
+    private persist;
+    private refresh;
+    private applyNativeReceipt;
+    query(id: string, timeoutMs?: number, stop?: boolean, browser?: Browser): Promise<ActResult>;
+    private result;
+    close(): Promise<void>;
+}

package/dist/platform/browser/downloads.js

@@ -0,0 +1 @@
+import{randomUUID as D}from"node:crypto";import{copyFile as E,mkdir as F,stat as I,unlink as O}from"node:fs/promises";import{hostname as $}from"node:os";import{basename as p,dirname as A,join as b,resolve as T}from"node:path";import{Type as u}from"typebox";import{browserArtifactsDir as v}from"./cdp-connection.js";import{SAVE_PICKER_REGISTRY as B}from"./save-picker.js";import{readableFrames as C}from"../chromium/frames.js";import{computerUseHome as _}from"../home.js";const G={kind:"download",readOnly:!0,schema:u.Object({kind:u.Literal("download"),id:u.Optional(u.String({description:"Watch or download ID returned by an earlier download call; omit to arm a new watch BEFORE clicking or pressing the control that downloads."})),timeoutMs:u.Optional(u.Integer({minimum:0,maximum:15e3,description:"Query wait budget, 0\u201315000 ms (default 10000). Timeout keeps the ID and returns the current state; query again later."})),stop:u.Optional(u.Boolean({description:"Stop collecting new downloads for this watch; existing downloads keep progressing and remain queryable."}))},{description:`Return a structured browser download receipt. First call without id to watch THIS tab, then trigger the download through an interaction verb, then query with id. Results include state, downloads with IDs, final filename/path, host and failure reason; ambiguous candidates are never silently selected. Files completed on this machine remain usable after the session ends. A query that runs out of budget while a native save panel is likely waiting for a person says so in hint. On tabs this session opened, a page's own save dialog (showSaveFilePicker) never opens: the file arrives here as an ordinary download marked source "save-picker", in the browser's download folder rather than where the page would have asked.`})},R=(w,e,t)=>w.send(e,t),q=w=>new Promise(e=>setTimeout(e,w));class K{watches=new Map;saving=new Set;root=null;source=null;bridge=!1;async connect(e){if(this.root&&this.source===e)return;await this.root?.detach().catch(()=>{}),this.root=null;const t=await e.newBrowserCDPSession();try{const o=await t.send("Browser.getVersion");this.bridge=o.product==="Chrome/mirasim-bridge",this.root=t,this.source=e,e.once("disconnected",()=>{for(const r of this.watches.values())r.page.context().browser()===e&&r.stop()})}catch(o){throw await t.detach().catch(()=>{}),o}}async snapshot(e,t){if(!this.root)throw new Error("The original browser connection is unavailable");return await R(this.root,"Mirasim.downloads",{since:e,until:t})}async arm(e,t){if(this.watches.size>=100)return{ok:!1,note:"This session already has 100 download watches; start a new session before arming more."};await this.connect(e);const o=new Date(Date.now()-1e3).toISOString(),r=this.bridge?await this.snapshot(o):null;for(const s of this.watches.values())s.page===t&&s.stop();const a={id:`watch-${D()}`,page:t,since:o,before:new Set(r?.items.map(s=>s.id)),host:r?.host??$(),receipts:[],native:this.bridge,session:null,lastEvent:Date.now(),marks:new Set,stop:()=>{}};if(this.bridge){const s=await t.context().newCDPSession(t);a.session=s;const i=d=>{a.lastEvent=Date.now();const h={id:d.guid,state:"in_progress",url:d.url,filename:d.suggestedFilename,path:null,host:a.host};a.receipts.push(h),this.markSource(a,h)},l=d=>{const h=a.receipts.find(m=>m.id===d.guid);h&&d.state==="canceled"&&(h.state="failed",h.error="Browser canceled the download")};s.on("Page.downloadWillBegin",i),s.on("Page.downloadProgress",l),a.stop=()=>{a.until??=new Date().toISOString(),s.off("Page.downloadWillBegin",i),s.off("Page.downloadProgress",l),t.off("close",a.stop)};try{await s.send("Page.enable")}catch(d){throw a.stop(),await s.detach().catch(()=>{}),d}t.once("close",a.stop)}else{const s=await t.context().newCDPSession(t);a.session=s;const i=this.root,l=new Map,d=new Set,h=n=>{d.add(n.frame.id);for(const c of n.childFrames??[])h(c)},m=n=>{d.add(n.frameId)},y=n=>{d.add(n.frame.id)},P=n=>{d.delete(n.frameId)},k=n=>{if(!d.has(n.frameId))return;if(a.lastEvent=Date.now(),!/^[A-Za-z0-9_-]{1,128}$/.test(n.guid)){a.receipts.push({id:`download-${D()}`,state:"failed",url:n.url,filename:n.suggestedFilename,path:null,host:a.host,error:"The browser supplied an invalid download identifier"});return}const c={id:`download-${n.guid}`,state:"in_progress",url:n.url,filename:n.suggestedFilename,path:null,host:a.host};a.receipts.push(c),this.markSource(a,c);let f;const g=new Promise(x=>{f=x});l.set(n.guid,{receipt:c,finish:f}),this.saving.add(g),g.finally(()=>this.saving.delete(g))},S=n=>{const c=l.get(n.guid);if(!(!c||n.state==="inProgress"))if(l.delete(n.guid),n.state==="canceled")c.receipt.state="failed",c.receipt.error="Browser canceled the download",c.finish();else if(n.state==="completed"){const f=b(v(),n.guid);(!!n.filePath&&T(A(n.filePath))!==T(v())?this.inPlace(n.filePath,c.receipt):this.persist(n.filePath||f,c.receipt)).then(async()=>{c.receipt.state==="complete"&&(!n.filePath||n.filePath===f)&&await O(f).catch(()=>{})}).finally(c.finish)}else l.set(n.guid,c)};s.on("Page.frameAttached",m),s.on("Page.frameNavigated",y),s.on("Page.frameDetached",P),i.on("Browser.downloadWillBegin",k),i.on("Browser.downloadProgress",S),a.stop=()=>{a.until??=new Date().toISOString(),i.off("Browser.downloadWillBegin",k),s.off("Page.frameAttached",m),s.off("Page.frameNavigated",y),s.off("Page.frameDetached",P),t.off("close",a.stop)},a.dispose=()=>{i.off("Browser.downloadProgress",S);for(const{receipt:n,finish:c}of l.values())n.state="unavailable",n.error="The download connection closed before completion",c();l.clear()};try{await s.send("Page.enable"),h((await s.send("Page.getFrameTree")).frameTree);const{targetInfo:n}=await s.send("Target.getTargetInfo"),{browserContextIds:c}=await i.send("Target.getBrowserContexts"),f=n.browserContextId;await i.send("Browser.setDownloadBehavior",{behavior:"allowAndName",downloadPath:v(),eventsEnabled:!0,...f&&c.includes(f)?{browserContextId:f}:{}})}catch(n){throw a.stop(),a.dispose(),await s.detach().catch(()=>{}),n}t.once("close",a.stop)}return this.watches.set(a.id,a),this.result(a,"armed",!1)}markSource(e,t){if(!t.url.startsWith("blob:"))return;const o=s=>s.evaluate(([i,l])=>!!globalThis[Symbol.for(i)]?.has(l),[B,t.url]).catch(()=>!1);let r;const a=Promise.race([Promise.all(C(e.page).map(o)).then(s=>{s.includes(!0)&&(t.source="save-picker")}),new Promise(s=>{r=setTimeout(s,1e3)})]).finally(()=>{clearTimeout(r),e.marks.delete(a)});e.marks.add(a)}async stuckHint(e,t,o){if(t.some(i=>i.state==="in_progress"&&i.awaitingLocation))return`Chrome is asking where to save this file (its "Ask where to save each file" setting): a native save panel is open in the user's Chrome, out of the browser driver's reach. Bind Google Chrome with the macOS driver (for a background tab the panel is a window of its own titled Save) and press Save or Cancel in that panel, or ask the user to turn the setting off; then query this ID again.`;if(o!=="armed"||e.page.isClosed())return;const r=i=>i.evaluate(l=>typeof globalThis.showSaveFilePicker=="function"&&!globalThis[Symbol.for(l)],B).catch(()=>!1);let a;return await Promise.race([Promise.all(C(e.page).map(r)).then(i=>i.includes(!0)),new Promise(i=>{a=setTimeout(()=>i(!1),1e3)})]).finally(()=>clearTimeout(a))?"No download began. This tab keeps the browser's real save dialog (it is not one this session opened), so if the control saves through the page's own save dialog (showSaveFilePicker), a native save panel may be waiting for a person: bind the browser's app with the macOS driver and press Save or Cancel there. If the tab was not its window's active tab, the browser refused the panel and the page got AbortError instead: make the tab active and trigger the save again.":void 0}async inPlace(e,t){try{await I(e),t.filename=p(e.replace(/\\/g,"/"))||t.filename,t.path=e,t.state="complete"}catch(o){t.state="failed",t.error=o instanceof Error?o.message:String(o)}}async persist(e,t){try{const o=b(_(),"downloads",t.id),r=p(t.filename.replace(/\\/g,"/")).replace(/[\x00-\x1f:<>"|?*]/g,"_").slice(0,180);t.filename=r&&r!=="."&&r!==".."?r:"download",await F(o,{recursive:!0,mode:448});const a=b(o,t.filename);await E(e,a),await I(a),t.path=a,t.state="complete"}catch(o){t.state="failed",t.error=o instanceof Error?o.message:String(o)}}async refresh(e){if(!e.native||!e.receipts.length)return;if(!this.bridge)throw new Error("This watch belongs to the original extension browser");const{items:t}=await this.snapshot(e.since,e.until);for(const o of e.receipts){if(o.state==="ambiguous")continue;const r=t.filter(i=>!e.before.has(i.id)&&(i.finalUrl===o.url||i.url===o.url)),a=e.receipts.filter(i=>i.url===o.url);if(r.length>1||a.length>1){o.state="ambiguous",o.path=null,delete o.nativeId,o.error="Multiple downloads match this page's event; no file was selected",o.candidates=r.map(i=>({nativeId:i.id,path:i.filename,state:i.state}));continue}const s=r[0];if(o.nativeId!==void 0&&s?.id!==o.nativeId){o.state="unavailable",o.path=null,o.error="The identified download is no longer in Chrome's ledger";continue}s&&(this.applyNativeReceipt(o,s),s.state==="in_progress"&&!s.filename?o.awaitingLocation=!0:delete o.awaitingLocation)}}applyNativeReceipt(e,t){e.nativeId=t.id,e.filename=p(t.filename.replace(/\\/g,"/"))||e.filename,e.state=t.state==="interrupted"?"failed":t.state==="complete"?"complete":"in_progress",e.path=e.state==="complete"?t.filename:null,delete e.error,t.error&&(e.error=t.error),e.state==="complete"&&!t.exists&&(e.state="failed",e.path=null,e.error="The browser reports that the downloaded file no longer exists")}async query(e,t=1e4,o=!1,r){const a=this.watches.get(e)??[...this.watches.values()].find(i=>i.receipts.some(l=>l.id===e));if(!a)return{ok:!1,note:`Unknown download ID: ${e}. Use an ID returned by this session.`};o&&a.stop();const s=Date.now()+t;for(;;){try{a.native&&r?.isConnected()&&await this.connect(r),await this.refresh(a),await Promise.all(a.marks)}catch(d){return this.result(a,"unavailable",!1,e,`Download status unavailable: ${d instanceof Error?d.message:String(d)}`)}const i=e===a.id?a.receipts:a.receipts.filter(d=>d.id===e),l=i.length>1?"ambiguous":i[0]?.state??(a.page.isClosed()||a.until?"failed":"armed");if((l==="complete"||l==="failed"||l==="ambiguous"||l==="unavailable")&&Date.now()-a.lastEvent>=250)return this.result(a,l,!1,e);if(Date.now()>=s)return this.result(a,l,!0,e,void 0,await this.stuckHint(a,i,l));await q(Math.min(100,s-Date.now()))}}result(e,t,o,r=e.id,a,s){const i=r===e.id?e.receipts:e.receipts.filter(h=>h.id===r),l=a?i.map(h=>({...h,state:"unavailable",path:null,error:a})):i,d=i.filter(h=>h.source==="save-picker").length;return{ok:!0,value:{id:r,state:t,host:e.host,timedOut:o,downloads:structuredClone(l),...a?{error:a}:t==="failed"&&!i.length?{error:"The watch stopped or its tab closed before a download began"}:{},...s?{hint:s}:{}},note:`download ${r}: ${t}${o?"; wait budget ended \u2014 query this ID again":""}`+(d?`; ${d===1?"this file":`${d} of these files`} came from the page's own save dialog, saved as an ordinary download instead \u2014 it is at the path shown, not where the page would have asked`:"")+(s?`; ${s}`:"")}}async close(){for(const t of this.watches.values())t.stop();let e;await Promise.race([Promise.all([...this.saving]),new Promise(t=>{e=setTimeout(t,5e3)})]),e&&clearTimeout(e);for(const t of this.watches.values())t.dispose?.(),await t.session?.detach().catch(()=>{});await this.root?.detach().catch(()=>{}),this.root=null,this.source=null}}export{K as BrowserDownloads,G as DOWNLOAD_VERB};

package/dist/platform/browser/driver-connect.d.ts

@@ -0,0 +1,13 @@
+import { BrowserDriverTabs } from "./driver-tabs.ts";
+export declare abstract class BrowserDriverConnect extends BrowserDriverTabs {
+    private endpoints;
+    protected ensure(): Promise<void>;
+    private extensionGoneMessage;
+    private attachRefusal;
+    protected noteBridgeSession(session: string | null): boolean;
+    private ensureInner;
+    private publishClaim;
+    private wireContext;
+    private installKeepInTab;
+    private reclaimTab;
+}

package/dist/platform/browser/driver-connect.js

@@ -0,0 +1 @@
+import{connectBrowserCdp as o}from"./cdp-connection.js";import{acquireManagedBrowser as u,openBlankTab as b,publishTabIdentity as g}from"./acquire.js";import{acquireBridge as m,bridgeJustStarted as x,extensionHeldElsewhere as E,waitForExtension as I}from"./bridge/acquire-bridge.js";import{claimIsolatedTab as h,claimNamedTab as T,claimSessionTab as y,newBackgroundPage as v,pageTargetInfo as k}from"./tabs.js";import{bridgeBrowserSession as c}from"./bridge-tabs.js";import{BROWSER_SWITCHED_NOTE as S,isBridgeExtensionGone as D,msgBridgeExtensionElsewhere as C,msgBridgeExtensionGone as l,msgBridgeJustStarted as B,msgEndpointUnavailable as _,REOPENED_NOTE as d,SURFACE_REIDENTIFIED_NOTE as N,TAB_DETACHED_NOTE as O,TAB_REOPENED_AFTER_SELF_CLOSE_NOTE as P,TAB_REOPENED_NOTE as R,tabRefusedNote as U}from"./messages.js";import{SurfaceUnreadableError as f}from"../types.js";import{KEEP_IN_TAB_JS as w}from"./keep-in-tab.js";import{ActionJournal as A}from"./journal.js";import{captureEvidenceShot as $}from"../chromium/shot.js";import{ensureRefSelector as F}from"../chromium/page-refs.js";import{REIDENTIFIED_WHY as W}from"./driver-core.js";import{BrowserDriverTabs as G}from"./driver-tabs.js";class et extends G{endpoints(){return this.explicit?[this.cdpUrl]:[...new Set([this.cdpUrl,this.fallbackCdpUrl])]}async ensure(){try{await this.ensureInner()}catch(e){throw D(e)?new f(await this.extensionGoneMessage()):e}}async extensionGoneMessage(){if(!this.cfg.extension||this.cfg.cdpUrl)return l();const e=await E(this.cfg.home);return e?C(e):x(this.cfg.home,9e4)?B():l()}async attachRefusal(e){if(!e||e==="about:blank"||!this.browser)return null;for(let i=0;i<2;i++){i&&await new Promise(t=>setTimeout(t,500));try{const t=await this.browser.newBrowserCDPSession();try{const a=(await t.send("Mirasim.attachRefusals")).refusals?.find(r=>r.url===e);if(a)return a.reason}finally{await t.detach().catch(()=>{})}}catch{return null}}return null}noteBridgeSession(e){if(!e)return!1;const i=this.bridgeSession;return this.bridgeSession=e,!i||i===e?!1:(this.resetObservationState(),this.active=void 0,this.appendNote(S),!0)}async ensureInner(){if(this.browser?.isConnected()){if(!this.active)return;const t=await this.ownPages();if(!t.length&&this.active.isClosed()){if(this.closedItsLastTab||this.noteBridgeSession(await c(this.browser)))return;this.resetObservationState();const s=this.active?.url()??"";this.active=this.attached?await this.openOwnWindow():this.tab?await this.reclaimTab():await v(this.context),this.claim(this.active);const a=!this.active.url()||this.active.url()==="about:blank";this.pendingNote=a?this.wokeAfterSelfClose?P:this.managedProfileDir&&!this.tab?d:this.explicit&&!this.managedProfileDir&&!this.attached?(r=>r?U(r):O)(await this.attachRefusal(s)):R:N,this.wokeAfterSelfClose=!1,await this.publishClaim()}else if(this.active.isClosed()){const s=t.filter(n=>n.url()!=="about:blank"),a=s[s.length-1]??t[t.length-1],r=await this.recognise(a).catch(()=>null);this.makeActive(a,r==="same"?W:"the tab it was on was closed")}return}if(this.browser&&(this.browser=null,this.managedProfileDir&&(this.pendingNote=d),this.resetObservationState(),this.active=void 0),this.cfg.extension&&!this.cfg.cdpUrl){const t=await m(this.cfg.home);if(this.cdpUrl=t.cdpUrl,!await I(this.cdpUrl,t.fresh?0:15e3,this.cfg.home))throw new f(await this.extensionGoneMessage())}const e=this.endpoints();let i;for(const t of e){try{this.browser=await o(t)}catch(s){if(i=s,await b(t))try{this.browser=await o(t)}catch(a){i=a}}if(this.browser){await F(this.browser),this.cdpUrl=t;break}}if(!this.browser&&!this.explicit){const t=await u(this.cfg.profileDir,this.cfg);this.browser=t.browser,this.cdpUrl=t.cdpUrl,this.managedProfileDir=t.profileDir,this.journal=new A(t.profileDir,()=>$(()=>this.page()),()=>{try{return this.page().url()}catch{return""}},this.cfg),this.attached=this.cfg.attached}if(!this.browser){const t=i instanceof Error?i.message:String(i??"unknown error");throw new Error(_(this.cdpUrl,t))}if(this.context=this.browser.contexts()[0]??await this.browser.newContext(),this.noteBridgeSession(await c(this.browser)),this.attached)this.active=await this.openOwnWindow();else if(this.tab?.isolated){const t=await h(this.browser,this.tab.key);this.active=t.page,this.ctxId=t.ctxId,this.pageCtxIds.set(t.page,t.ctxId),this.context=this.active.context()}else this.active=await y(this.context,this.tab?.key??null,this.cfg)??void 0;this.active&&this.claim(this.active),this.wireContext(),await this.installKeepInTab(this.active),await this.publishClaim()}async publishClaim(){if(!(!this.tab||!this.managedProfileDir||!this.active))try{const{targetId:e,ctxId:i}=await k(this.active);g(this.managedProfileDir,{key:this.tab.key,isolated:this.tab.isolated,ctxId:i,targetId:e})}catch{}}wireContext(){this.context.on("page",e=>{this.windowAppeared=!0,this.adoptWhenReal(e)}),this.context.on("dialog",e=>{(async()=>{const i=e.page();if(this.attached&&(!i||!await this.ownsPage(i).catch(()=>!1)))return;const t=e.type(),s=this.armedDialog;this.armedDialog=null;const a=s?s.accept:t==="alert"||t==="beforeunload";let r=!0;try{await(a?e.accept(s?.text):e.dismiss())}catch{r=!1}if(t==="beforeunload")return;const n=`a JS dialog appeared: \xAB${e.message().slice(0,120)}\xBB`,p=r?s?`${n} \u2014 ${a?"accepted":"dismissed"} as you asked`+(s.text!==void 0?` with text \xAB${s.text.slice(0,60)}\xBB`:""):`${n} \u2014 it was auto-${a?"accepted":"dismissed"}; if the flow needs a confirm, it did not happen`:`${n} \u2014 it was already answered before your ${a?"accept":"dismiss"} could land (another client shares this browser), so the page took an answer you did not choose. Check what the page did before acting on it`;this.appendNote(p)})()})}async installKeepInTab(e){this.keepInTabInstalled||(this.attached||(this.keepInTabInstalled=!0,await this.context.addInitScript(w).catch(()=>{this.keepInTabInstalled=!1})),await e?.evaluate(w).catch(()=>{}))}async reclaimTab(){const e=this.tab;if(!e.isolated)return T(this.context,e.key);const{page:i,ctxId:t}=await h(this.browser,e.key);return this.ctxId=t,this.pageCtxIds.set(i,t),i.context()!==this.context&&(this.context=i.context(),this.keepInTabInstalled=!1,this.wireContext(),await this.installKeepInTab(i)),i}}export{et as BrowserDriverConnect};

package/dist/platform/browser/driver-core.d.ts

@@ -0,0 +1,50 @@
+import { type Browser, type BrowserContext, type Page } from "playwright-core";
+import { ChromiumPageDriver } from "../chromium/page-driver.ts";
+import { type BrowserConfig, type BrowserConfigOptions, type TabClaim } from "./config.ts";
+import { ActionJournal } from "./journal.ts";
+import { BrowserDownloads } from "./downloads.ts";
+export declare const ADOPTED_WHY = "a tab this session opened navigated to real content";
+export declare const APPEARED_WHY = "a tab this session did not open appeared in the browser and reached real content";
+export declare const REIDENTIFIED_WHY = "this session's own tab came back under a new id, because the connection to the browser dropped and returned";
+export declare abstract class BrowserDriverCore extends ChromiumPageDriver {
+    protected readonly downloads: BrowserDownloads;
+    protected browser: Browser | null;
+    protected context: BrowserContext;
+    protected active: Page | undefined;
+    protected tabIds: WeakMap<Page, string>;
+    protected nextTabId: number;
+    protected managedProfileDir: string | null;
+    protected pendingNote: string | null;
+    protected armedDialog: {
+        accept: boolean;
+        text?: string;
+    } | null;
+    protected armedChooser: ((fc: {
+        setFiles(p: string[]): Promise<void>;
+    }) => void) | null;
+    protected keepInTabInstalled: boolean;
+    protected attached: boolean;
+    protected windowAppeared: boolean;
+    protected readonly tab: TabClaim | null;
+    protected ctxId: string | null;
+    protected readonly pageCtxIds: WeakMap<Page, string>;
+    protected readonly mine: WeakSet<Page>;
+    protected readonly savePickerPages: WeakSet<Page>;
+    protected readonly ownedTargetIds: Set<string>;
+    protected activeTargetId: string | null;
+    protected journal: ActionJournal | null;
+    protected closedItsLastTab: boolean;
+    protected bridgeSession: string | null;
+    protected wokeAfterSelfClose: boolean;
+    protected ownWindowId: number | null;
+    protected windowIds: WeakMap<Page, number>;
+    protected readonly explicit: boolean;
+    protected readonly fallbackCdpUrl: string;
+    protected readonly cfg: BrowserConfig;
+    constructor(cdpUrl?: string, fallbackCdpUrl?: string, cfgOpts?: BrowserConfigOptions, env?: NodeJS.ProcessEnv);
+    protected cdpUrl: string;
+    protected takePendingNote(): string | null;
+    protected appendNote(note: string): void;
+    protected makeActive(p: Page, why: string): void;
+    protected abstract rememberIdentity(p: Page): void;
+}

package/dist/platform/browser/driver-core.js

@@ -0,0 +1 @@
+import"playwright-core";import{ChromiumPageDriver as i}from"../chromium/page-driver.js";import{browserConfigFromEnv as s}from"./config.js";import"./acquire.js";import"./messages.js";import"./journal.js";import{BrowserDownloads as r}from"./downloads.js";const a="http://127.0.0.1:9222",v="a tab this session opened navigated to real content",I="a tab this session did not open appeared in the browser and reached real content",N="this session's own tab came back under a new id, because the connection to the browser dropped and returned";class k extends i{downloads=new r;browser=null;context;active;tabIds=new WeakMap;nextTabId=1;managedProfileDir=null;pendingNote=null;armedDialog=null;armedChooser=null;keepInTabInstalled=!1;attached=!1;windowAppeared=!1;tab;ctxId=null;pageCtxIds=new WeakMap;mine=new WeakSet;savePickerPages=new WeakSet;ownedTargetIds=new Set;activeTargetId=null;journal=null;closedItsLastTab=!1;bridgeSession=null;wokeAfterSelfClose=!1;ownWindowId=null;windowIds=new WeakMap;explicit;fallbackCdpUrl;cfg;constructor(e,t=a,n={},o=process.env){super(),this.cfg=s({...n,...e!==void 0?{cdpUrl:e}:{}},o),this.explicit=this.cfg.cdpStrict||this.cfg.extension&&!this.cfg.cdpUrl,this.tab=this.cfg.attached?null:this.cfg.tab,this.fallbackCdpUrl=t,this.cdpUrl=this.cfg.cdpUrl??t}cdpUrl;takePendingNote(){const e=this.pendingNote;return this.pendingNote=null,e}appendNote(e){this.pendingNote?this.pendingNote.includes(e)||(this.pendingNote=`${this.pendingNote}; ${e}`):this.pendingNote=e}makeActive(e,t){if(this.active===e)return;this.active=e,this.rememberIdentity(e),this.resetObservationState();const n=`the active tab changed (${t}) \u2014 nothing was lost, but refs from earlier observations belong to the previous tab, so re-observe before acting on them`;this.appendNote(n),this.journal?.publishAction("focus",{auto:!0},null,{ok:!0})}}export{v as ADOPTED_WHY,I as APPEARED_WHY,k as BrowserDriverCore,N as REIDENTIFIED_WHY};

package/dist/platform/browser/driver-tabs.d.ts

@@ -0,0 +1,16 @@
+import { type Page } from "playwright-core";
+import { BrowserDriverCore } from "./driver-core.ts";
+export declare abstract class BrowserDriverTabs extends BrowserDriverCore {
+    protected claim(p: Page): void;
+    private armSavePicker;
+    protected rememberIdentity(p: Page): void;
+    protected recognise(p: Page): Promise<"same" | "ours" | null>;
+    private ownsIsolatedPage;
+    protected adoptWhenReal(p: Page): void;
+    protected page(): Page;
+    protected openOwnWindow(): Promise<Page>;
+    protected ownsPage(p: Page): Promise<boolean>;
+    protected ownPages(): Promise<Page[]>;
+    protected visiblePages(): Promise<Page[]>;
+    protected tabId(p: Page): string;
+}

package/dist/platform/browser/driver-tabs.js

@@ -0,0 +1 @@
+import"playwright-core";import{userWantsVisible as f}from"./acquire.js";import{pageContextId as l,pageTargetInfo as h}from"./tabs.js";import{msgOwnWindowFailed as m,NO_TAB_OPEN_NOTE as u,NO_TAB_YET_NOTE as g}from"./messages.js";import{SAVE_PICKER_JS as d}from"./save-picker.js";import{SurfaceUnreadableError as c}from"../types.js";import{ADOPTED_WHY as n,APPEARED_WHY as w,BrowserDriverCore as I,REIDENTIFIED_WHY as v}from"./driver-core.js";const b=r=>new Promise(t=>setTimeout(t,r));class D extends I{claim(t){this.mine.add(t),this.rememberIdentity(t),this.armSavePicker(t)}armSavePicker(t){this.savePickerPages.has(t)||(this.savePickerPages.add(t),t.addInitScript(d).catch(()=>{}),t.evaluate(d).catch(()=>{}))}rememberIdentity(t){h(t).then(({targetId:e})=>{e&&(this.ownedTargetIds.add(e),this.active===t&&(this.activeTargetId=e))}).catch(()=>{})}async recognise(t){const{targetId:e}=await h(t).catch(()=>({targetId:""}));return!e||!this.ownedTargetIds.has(e)?null:(this.mine.add(t),this.armSavePicker(t),e===this.activeTargetId?"same":"ours")}async ownsIsolatedPage(t){let e=this.pageCtxIds.get(t);return e===void 0&&(e=await l(t).catch(()=>""),this.pageCtxIds.set(t,e)),e!==""&&e===this.ctxId}adoptWhenReal(t){const e=()=>{if(this.tab?.isolated){this.ownsIsolatedPage(t).then(s=>{s&&(this.claim(t),this.makeActive(t,n))}).catch(()=>{});return}if(this.tab){t.opener().then(s=>{s&&this.mine.has(s)&&(this.claim(t),this.makeActive(t,n))}).catch(()=>{});return}if(!this.attached){if(this.mine.has(t)){this.makeActive(t,n);return}this.recognise(t).then(s=>this.makeActive(t,s==="same"?v:s==="ours"?n:w)).catch(()=>this.makeActive(t,w));return}this.ownsPage(t).then(s=>{s&&this.makeActive(t,n)}).catch(()=>{})};if(t.url()!=="about:blank"){e();return}const i=s=>{s!==t.mainFrame()||t.isClosed()||t.url()==="about:blank"||(clearTimeout(a),t.off("framenavigated",i),e())},a=setTimeout(()=>t.off("framenavigated",i),1500);a.unref?.(),t.on("framenavigated",i)}page(){if(this.closedItsLastTab)throw new c(u);if(!this.active)throw new c(g);if(this.active.isClosed()){const t=this.context.pages().filter(i=>!i.isClosed()&&(this.tab?this.tab.isolated?this.pageCtxIds.get(i)===this.ctxId:this.mine.has(i):!this.attached||this.ownWindowId===null||this.windowIds.get(i)===this.ownWindowId)),e=t.filter(i=>i.url()!=="about:blank");this.makeActive(e[e.length-1]??t[t.length-1]??this.active,"the tab it was on was closed")}return this.active}async openOwnWindow(){const t=new Set(this.context.pages()),e=await this.browser.newBrowserCDPSession();try{await e.send("Target.createTarget",{url:"about:blank",newWindow:!0,background:!0})}finally{await e.detach().catch(()=>{})}let i;for(let s=0;s<40&&(i=this.context.pages().find(o=>!t.has(o)&&!o.isClosed()),!i);s++)await b(25);if(!i)throw new Error(m());const a=await this.context.newCDPSession(i);try{const{windowId:s}=await a.send("Browser.getWindowForTarget");this.ownWindowId=s,this.windowIds.set(i,s),this.cfg.window==="offscreen"&&!(this.managedProfileDir&&f(this.managedProfileDir))&&await a.send("Browser.setWindowBounds",{windowId:s,bounds:{left:-4e3,top:200}})}catch{}finally{await a.detach().catch(()=>{})}return i}async ownsPage(t){if(!this.attached||this.ownWindowId===null)return!0;let e=this.windowIds.get(t);if(e===void 0)try{const i=await this.context.newCDPSession(t);try{e=(await i.send("Browser.getWindowForTarget")).windowId}finally{await i.detach().catch(()=>{})}this.windowIds.set(t,e)}catch{return!1}return e===this.ownWindowId}async ownPages(){const t=this.context.pages().filter(i=>!i.isClosed());if(this.tab?.isolated){const i=[];for(const a of t)await this.ownsIsolatedPage(a)&&i.push(a);return i}if(this.tab)return t.filter(i=>this.mine.has(i));if(!this.managedProfileDir)return t.filter(i=>this.mine.has(i));if(!this.attached||this.ownWindowId===null)return t;const e=[];for(const i of t)await this.ownsPage(i)&&e.push(i);return e}async visiblePages(){return this.managedProfileDir||this.attached||this.tab?this.ownPages():this.context.pages().filter(t=>!t.isClosed())}tabId(t){let e=this.tabIds.get(t);return e||(e=`t${this.nextTabId++}`,this.tabIds.set(t,e)),e}}export{D as BrowserDriverTabs};

package/dist/platform/browser/driver-verbs.d.ts

@@ -0,0 +1,13 @@
+import { type Page } from "playwright-core";
+import { type ActResult } from "../types.ts";
+import { BrowserDriverConnect } from "./driver-connect.ts";
+export declare abstract class BrowserDriverVerbs extends BrowserDriverConnect {
+    private pid;
+    private cdpSessions;
+    protected readonly overridden: Set<Page>;
+    perform(kind: string, a: Record<string, any>): Promise<ActResult>;
+    private browserPid;
+    protected cdpFor(page: Page): Promise<import("playwright-core").CDPSession>;
+    private ensureComposited;
+    private dispatch;
+}

package/dist/platform/browser/driver-verbs.js

@@ -0,0 +1,2 @@
+import{readFileSync as g}from"node:fs";import"playwright-core";import"../types.js";import{NO_TAB_OPEN_NOTE as m,NO_TAB_YET_NOTE as b}from"./messages.js";import{endpointFileFor as v,keepInBackground as y}from"./acquire.js";import{isFrontmost as k,returnFocusIfTaken as $}from"./focus-guard.js";import{BrowserDriverConnect as _}from"./driver-connect.js";import{landedNote as f,NAV_TIMEOUT_MS as c,navVerdict as d}from"./navigate.js";import{newBackgroundPage as w}from"./tabs.js";import{detectInterference as x,overlaySensitive as P}from"./overlay-guard.js";import{performUploadToRef as T,refuseMissingFiles as I}from"../chromium/actions.js";import{performRunJs as S}from"../chromium/run-js.js";import{withPageCapture as A}from"../chromium/shot.js";class z extends _{pid;cdpSessions=new WeakMap;overridden=new Set;async perform(i,t){if(i==="download"&&typeof t.id=="string")return await this.downloads.query(t.id,t.timeoutMs,t.stop,this.browser??void 0);if(i==="open_url"||i==="new_tab")this.wokeAfterSelfClose=this.closedItsLastTab,this.closedItsLastTab=!1;else if(this.closedItsLastTab)return{ok:!1,note:m};await this.ensure();let r=null;if(!this.active){if(i!=="open_url"&&i!=="new_tab")return{ok:!1,note:b};if(this.active=await w(this.context),this.claim(this.active),i==="new_tab"){if(r=this.tabId(this.active),!t.url)return{ok:!0,note:`new tab ${r} is now the target`};i="open_url"}}this.hookNavigation(),await this.ensureComposited();const s=await k(this.browserPid());if(this.lastPoint=null,this.cfg.extension&&P(i)){const o=await x(this.page());if(o){const h=`another extension or overlay is over the page right now \u2014 ${o}. Close it (dismiss the popup, click away from the autofill suggestion, switch off the interfering extension for this site), then re-observe and act. Acting now would land on the overlay, not the target.`;return this.journal?.publishAction(i,t,this.lastPoint,{ok:!1,note:h}),{ok:!1,note:h}}}let e;try{const o=this.page();e=await A(o,()=>this.page()!==o||o.isClosed()?Promise.resolve({ok:!1,note:"the target changed while waiting for capture \u2014 re-observe the intended tab before acting"}):this.dispatch(i,t))}catch(o){const h=o instanceof Error?o.message.split(`
+`)[0]??"dispatch failed":String(o);throw this.journal?.publishAction(i,t,this.lastPoint,{ok:!1,note:h}),o}r&&(e={...e,note:`new tab ${r} is now the target; ${e.note??""}`}),this.journal?.publishAction(i,t,this.lastPoint,e),this.managedProfileDir&&!this.closedItsLastTab&&i!=="activate"&&await y(this.context,this.page(),this.managedProfileDir,this.cfg),this.windowAppeared&&(this.windowAppeared=!1,!s&&i!=="activate"&&await $(this.browserPid()));const n=this.takePendingNote();return n&&(e.note=e.note?`${n}. ${e.note}`:n),e}browserPid(){if(this.pid===void 0){this.pid=null;try{const i=JSON.parse(g(v(this.managedProfileDir),"utf8"));typeof i.pid=="number"&&(this.pid=i.pid)}catch{}}return this.pid}async cdpFor(i){let t=this.cdpSessions.get(i);return t||(t=await this.context.newCDPSession(i),this.cdpSessions.set(i,t)),t}async ensureComposited(){if(this.managedProfileDir)try{const i=await this.cdpFor(this.page()),{windowId:t,bounds:r}=await i.send("Browser.getWindowForTarget");if(r.windowState!=="minimized")return;await i.send("Browser.setWindowBounds",{windowId:t,bounds:{windowState:"normal"}}),this.cfg.window==="offscreen"&&await i.send("Browser.setWindowBounds",{windowId:t,bounds:{left:-4e3,top:200}})}catch{}}async dispatch(i,t){const r=this.page();switch(i){case"download":return t.stop||t.timeoutMs!==void 0?{ok:!1,note:"download stop/timeoutMs require an existing id; omit them to arm a watch"}:await this.downloads.arm(this.browser,r);case"upload":{const s=Array.isArray(t.paths)?t.paths:[],e=I(s);if(e)return e;if(t.ref){const o=await T(s,t.ref,()=>this.locate(t.ref,t.name,!1),()=>this.missing(t.ref,t.name));return!o.ok&&o.note?.includes("did not take the files")?{...o,note:`${o.note}; for a button that opens a chooser, drop ref and click the button next`}:o}this.armedChooser&&r.off("filechooser",this.armedChooser);const n=o=>{o.setFiles(s)};return this.armedChooser=n,r.once("filechooser",n),{ok:!0,note:`the next file chooser will receive ${s.length} file${s.length===1?"":"s"} \u2014 nothing has changed yet; click the control that opens it`}}case"dialog":return this.armedDialog={accept:t.answer==="accept",...typeof t.text=="string"?{text:t.text}:{}},{ok:!0,note:`the next JS dialog will be ${t.answer}ed \u2014 nothing on the page has changed yet; the answer is used when the action that raises the dialog runs`};case"open_url":try{return await r.goto(t.url,{waitUntil:"domcontentloaded",timeout:c}),{ok:!0,note:f("opened",t.url,r.url())}}catch(s){return d(s)}case"activate":return await r.bringToFront(),{ok:!0,note:"activated this browser tab and its window \u2014 foreground focus was requested explicitly"};case"run_js":return await S(()=>r,t.code);case"back":{const s=r.url();try{return await r.goBack({waitUntil:"commit",timeout:c})===null&&r.url()===s?{ok:!0,note:"no earlier page in this tab's history"}:{ok:!0,note:`went back to ${r.url()}`}}catch(e){return d(e)}}case"reload":{const s=r.url();try{return await r.reload({waitUntil:"domcontentloaded",timeout:c}),{ok:!0,note:f("reloaded",s,r.url())}}catch(e){return d(e)}}case"new_tab":{const s=await w(this.context);this.claim(s),this.active=s,this.resetObservationState();const e=this.tabId(s);if(typeof t.url=="string"&&t.url){try{await s.goto(t.url,{waitUntil:"domcontentloaded",timeout:c})}catch(n){const o=d(n);return{...o,note:`new tab ${e} is now the target; ${o.note??"its navigation did not finish"}`}}return{ok:!0,note:`new tab ${e} is now the target; ${f("opened",t.url,s.url())}`}}return{ok:!0,note:`new tab ${e} is now the target`}}case"viewport":{const s=await this.cdpFor(r);if(t.reset)return await s.send("Emulation.clearDeviceMetricsOverride"),this.overridden.delete(r),{ok:!0,note:"viewport override cleared \u2014 this tab is back to the real window size"};const e=Math.round(Number(t.width)||1200),n=Math.round(Number(t.height)||1700);await s.send("Emulation.setDeviceMetricsOverride",{width:e,height:n,deviceScaleFactor:0,mobile:!1}),this.overridden.add(r);const o=await r.evaluate("({ width: innerWidth, height: innerHeight })");return o.width!==e||o.height!==n?{ok:!1,note:`viewport ${e}x${n} did not take effect \u2014 the page reports ${o.width}x${o.height}`}:{ok:!0,note:`viewport of this tab set to ${e}x${n} \u2014 navigate AFTER this, not before, or a list already mounted keeps the rows it has; the size is the user's own again on viewport({reset:true}) or when this session ends`}}case"close_tab":{const s=(await this.ownPages()).filter(a=>!a.isClosed());if(t.all){if(typeof t.id=="string"&&t.id)return{ok:!1,note:"close_tab takes id OR all, not both \u2014 all closes every tab this session owns"};for(const a of s)await a.close().catch(()=>{});return this.closedItsLastTab=!0,{ok:!0,note:`closed ${s.length} tab${s.length===1?"":"s"} \u2014 every one this session opened or claimed; the user's own tabs were not touched. open_url or new_tab starts a fresh one`}}const e=typeof t.id=="string"&&t.id?t.id.replace(`${this.platform}/`,""):this.tabId(r);let n=s.find(a=>this.tabId(a)===e),o=!1;if(!n){const a=(await this.visiblePages()).find(p=>this.tabId(p)===e);if(!a)return{ok:!1,note:`no tab with id ${e} \u2014 call computer.surfaces() for current ids`};if(!t.confirmed)return{ok:!1,note:`${e} is the user's own tab, not this session's. Ask them in the conversation whether to close it \u2014 say which page \u2014 and call close_tab again with confirmed: true if they agree. Reading it and acting in it needs no permission; only closing does`};n=a,o=!0}const h=n===this.active;await n.close().catch(()=>{});const l=o?" \u2014 the user's own, closed on the agreement you reported":"";if(!h)return{ok:!0,note:`closed tab ${e}${l}; the target is unchanged`};const u=s.find(a=>a!==n&&!a.isClosed());return u?(this.active=u,this.resetObservationState(),{ok:!0,note:`closed tab ${e}${l}; the target moved to ${this.tabId(u)} \u2014 re-observe before acting on any earlier ref`}):(this.closedItsLastTab=!0,{ok:!0,note:`closed tab ${e}${l} \u2014 this session has no tab left; open_url or new_tab starts a fresh one`})}}return await this.dispatchPage(i,t)??{ok:!1,note:`unknown action kind ${i}`}}}export{z as BrowserDriverVerbs};

package/dist/platform/browser/driver.d.ts

@@ -0,0 +1,38 @@
+import type { Page } from "playwright-core";
+import { type ActResult, type HeaderChanges, type OwnershipResource, type Snapshot, type TargetInfo, type ToolResult, type VerbSpec, type Verdict } from "../types.ts";
+import { BrowserDriverVerbs } from "./driver-verbs.ts";
+export declare class BrowserDriver extends BrowserDriverVerbs {
+    private unloadedSelection;
+    activeTarget(): Promise<string | null>;
+    ownershipResources(): Promise<OwnershipResource[]>;
+    prepareTarget(): Promise<void>;
+    protected page(): Page;
+    protected adoptWhenReal(page: Page): void;
+    protected previewTarget(): Promise<import("../types.ts").PreviewTarget | null>;
+    readonly platform = "browser";
+    turnEnded(info: {
+        sessionId: string;
+        turnId: string;
+        hookEventName: string;
+        keepBrowserTabs?: boolean;
+    }): Promise<void>;
+    extraVerbs(): VerbSpec[];
+    observeElements(opts?: {
+        prefix?: string;
+        forceImage?: boolean;
+        afterAction?: string;
+    }): Promise<ToolResult>;
+    observeImage(opts?: Parameters<BrowserDriverVerbs["observeImage"]>[0]): Promise<ToolResult>;
+    private noTabNote;
+    private noTabObservation;
+    protected staleRefCause(): string;
+    promptFragment(): string;
+    listTargets(): Promise<TargetInfo[]>;
+    protected noteBridgeSession(session: string | null): boolean;
+    actionResources(kind: string, args: Record<string, unknown>): Promise<OwnershipResource[]>;
+    focusTarget(id: string): Promise<ActResult>;
+    close(): Promise<void>;
+    protected journalVerdict(verdict: Verdict): void;
+    protected renderHeadLines(s: Snapshot, targets: TargetInfo[], targetsUnchanged?: boolean, changes?: HeaderChanges): string[];
+    protected blankSurfaceHint(): Promise<string>;
+}

package/dist/platform/browser/driver.js

@@ -0,0 +1,3 @@
+import{Type as i}from"typebox";import{SurfaceUnreadableError as d,text as h}from"../types.js";import{NO_TAB_OPEN_NOTE as c,NO_TAB_YET_NOTE as u}from"./messages.js";import{PASTE_VERB as b,SELECT_OPTION_VERB as p}from"../chromium/actions-value.js";import{SELECT_TEXT_VERB as w}from"../chromium/select-text.js";import{DIALOG_VERB as f,DRAG_VERB as g,UPLOAD_VERB as m}from"../chromium/actions.js";import{RUN_JS_CODE_DESC as v}from"../chromium/run-js.js";import{BrowserDriverVerbs as k}from"./driver-verbs.js";import{previewPage as y}from"../chromium/preview.js";import{withPageCapture as S}from"../chromium/shot.js";import{DOWNLOAD_VERB as T}from"./downloads.js";import{bridgeRequest as O,bridgeTabs as E,restoreBridgeTab as _}from"./bridge-tabs.js";const P=5e3,N=1500;async function R(l){if(!l.url())return"";let e;try{return await Promise.race([l.title().catch(()=>""),new Promise(t=>{e=setTimeout(()=>t(""),N),e.unref?.()})])}finally{e&&clearTimeout(e)}}class G extends k{unloadedSelection=null;async activeTarget(){return this.unloadedSelection?.id??super.activeTarget()}async ownershipResources(){return this.unloadedSelection?[{key:`chromium:${this.unloadedSelection.targetId}`,mode:"exclusive"}]:super.ownershipResources()}async prepareTarget(){const e=this.unloadedSelection;if(!e)return;const{page:t,viewport:s}=await _(this.browser,e.tabId,e.targetId,e.browserSession);this.tabIds.set(t,e.id),this.active=t,this.unloadedSelection=null,this.resetObservationState();const r=await t.evaluate("({ width: innerWidth, height: innerHeight })");if(r.width<=0||r.height<=0){const a=await this.perform("viewport",s??{});if(!a.ok)throw new d(`The restored tab has no usable viewport: ${a.note??"resize failed"}`);this.appendNote("Chrome restored this background tab with a zero-size viewport; applied a temporary viewport, cleared when this driver disconnects.")}this.appendNote("Chrome had unloaded this tab; restored the same tab in the background. Read its current state before continuing.")}page(){if(this.unloadedSelection)throw new d(`Tab ${this.unloadedSelection.id} has not been restored; no other page was observed or operated.`);return super.page()}adoptWhenReal(e){this.unloadedSelection||super.adoptWhenReal(e)}previewTarget(){return this.unloadedSelection||!this.browser?.isConnected()||!this.active||this.active.isClosed()?Promise.resolve(null):y(this.active,this.cdpUrl,"browser")}platform="browser";async turnEnded(e){if(this.attached||e.keepBrowserTabs===!0)return;const t=await this.ownPages().catch(()=>[]);for(const s of t)await s.close().catch(()=>{});t.length&&(this.closedItsLastTab=!0,this.resetObservationState())}extraVerbs(){return[{kind:"open_url",schema:i.Object({kind:i.Literal("open_url"),url:i.String({description:"Full URL to open. Only URLs that appeared on a page or were given in the task \u2014 never guess domains."})})},{kind:"activate",schema:i.Object({kind:i.Literal("activate")},{description:"Bring this browser tab and its window to the foreground. This changes the user's foreground window: explain the effect and obtain permission unless it is already authorized. focus() only selects the target. Embedded writes normally wait for the person to yield the window; activate() is an explicit foreground handoff, revoked by subsequent human input. Do not use it to bypass an input wait without the user handing over control."})},{kind:"back",schema:i.Object({kind:i.Literal("back")})},{kind:"reload",schema:i.Object({kind:i.Literal("reload")})},{kind:"new_tab",schema:i.Object({kind:i.Literal("new_tab"),url:i.Optional(i.String({description:"URL to open in it; omit for a blank tab"}))},{description:"Open a NEW tab of this session's own and make it the target \u2014 the current tab keeps its state, and both are listed as targets afterwards."})},{kind:"close_tab",schema:i.Object({kind:i.Literal("close_tab"),id:i.Optional(i.String({description:"Tab id from computer.surfaces(); omit to close the one you are on"})),all:i.Optional(i.Boolean({description:"Close every tab this session opened or claimed \u2014 the tidy-up at the end of a job. Never the user's own, whatever else is set. Refused together with id."})),confirmed:i.Optional(i.Boolean({description:"Only for a tab marked (user's): you ASKED the user in the conversation and they said yes. Never set it because closing would be convenient \u2014 the first refusal tells you to ask, and asking is the point."}))},{description:"Close a tab. This session's own always; one of the user's (marked (user's) in the listing) only after you asked them in the conversation and they agreed \u2014 then pass confirmed: true."})},{kind:"viewport",schema:i.Object({kind:i.Literal("viewport"),width:i.Optional(i.Number({description:"Viewport width in CSS pixels (default 1200)"})),height:i.Optional(i.Number({description:"Viewport height in CSS pixels \u2014 this is the one that decides how much of a long list exists (default 1700)"})),reset:i.Optional(i.Boolean({description:"Put the tab back to the real window size"}))},{description:"Give THIS tab a viewport of your own size, so a virtualized list (a feed, a search page, a long transcript) mounts more of itself per read. Set it BEFORE opening the page: rows mount against the viewport in effect at load."})},{kind:"run_js",readOnly:!0,schema:i.Object({kind:i.Literal("run_js"),code:i.String({description:v})},{description:"Ask the PAGE something no observation carries \u2014 read its data in bulk, its stored state, or an API it exposes. This is a stranger's site holding the user's logged-in session: read and compute here, act through the interaction verbs."})},g,f,m,T,p,w,b]}async observeElements(e={}){const t=await this.noTabNote();return t?this.noTabObservation(t,e.prefix):super.observeElements(e)}async observeImage(e={}){const t=await this.noTabNote();return t?this.noTabObservation(t,e.prefix):super.observeImage(e)}async noTabNote(){return this.closedItsLastTab?c:this.unloadedSelection?null:(await this.ensure(),this.active?null:u)}noTabObservation(e,t){const s=this.takePendingNote();return h(`${t?`${t}
+`:""}${s?`NOTE: ${s}.
+`:""}${e}.`,{verdict:"unknown"})}staleRefCause(){return"it predates a navigation, a reload or a tab switch"}promptFragment(){return"Grounding: observations are text lists of interactive elements with refs, for the CURRENT viewport only. Act by ref from the latest observation. When what you want is NOT in the list: if you can name it, w.find('<name>') searches EVERY control on the page and hands back a handle \u2014 act on it directly, the click scrolls it into view, so do not scroll first. Scroll only to discover what you cannot name. Observations may show only changes since the previous one; refs stay valid across observations (until navigation). Use w.text() to read full page text."}async listTargets(){await this.ensure();const{unloaded:e,browserSession:t}=!this.tab&&!this.attached&&!this.managedProfileDir?await E(this.browser):{unloaded:[],browserSession:null};this.noteBridgeSession(t);const s=new Set(await this.ownPages()),r=await this.visiblePages(),a=await Promise.all(r.map(async o=>({id:this.tabId(o),kind:"tab",title:await R(o)||o.url(),active:!this.unloadedSelection&&o===this.active,own:s.has(o)})));for(const o of e){const n=`unloaded:${o.tabId}:${o.browserSession}`;a.push({id:n,kind:"tab",title:`${o.title||o.url} [unloaded \u2014 use this handle to restore in background]`,active:this.unloadedSelection?.id===n,own:!1,unloaded:!0})}return a}noteBridgeSession(e){const t=super.noteBridgeSession(e);return t&&(this.unloadedSelection=null),t}async actionResources(e,t){if(e!=="close_tab")return[];const s=typeof t.id=="string"?t.id.replace(/^browser\//,""):null,r=t.all?await this.ownPages():s?(await this.visiblePages()).filter(a=>this.tabId(a)===s):[this.page()];return Promise.all(r.filter(a=>!a.isClosed()).map(a=>this.pageOwnership(a)))}async focusTarget(e){await this.ensure();const t=/^unloaded:(\d+):(.*)$/.exec(e);if(t&&!this.tab&&!this.attached&&!this.managedProfileDir&&this.browser.version()==="mirasim-bridge"){const r=Number(t[1]),a=t[2],{targetId:o}=await O(this.browser,"Mirasim.tabTarget",{tabId:r,browserSession:a});return this.unloadedSelection={id:e,tabId:r,targetId:o,browserSession:a},this.closedItsLastTab=!1,{ok:!0,note:"Selected unloaded tab; restoration follows target ownership."}}let s={ok:!1,note:`no target with id ${e}; call computer.surfaces() for current ids`};for(const r of await this.visiblePages())if(!(r.isClosed()||this.tabId(r)!==e)){this.unloadedSelection=null,this.active=r,this.closedItsLastTab=!1,s={ok:!0};break}return this.journal?.publishAction("focus",{target:e},null,s),s}async close(){this.unloadedSelection=null,await this.downloads.close(),await this.journal?.drain(P);for(const e of this.overridden)e.isClosed()||await S(e,()=>this.cdpFor(e).then(t=>t.send("Emulation.clearDeviceMetricsOverride"))).catch(()=>{});if(this.overridden.clear(),!this.managedProfileDir&&!this.tab&&this.browser)for(const e of await this.ownPages().catch(()=>[]))e.url()==="about:blank"&&await e.close().catch(()=>{});await this.browser?.close().catch(()=>{}),this.browser=null,this.resetObservationState(),this.resetPageState(),await this.disconnected()}journalVerdict(e){this.journal?.publishVerdict(e)}renderHeadLines(e,t,s=!1,r){const a=super.renderHeadLines(e,t,s,r);if(e.url==="about:blank"&&e.elements.length===0&&!e.text){const o=t.some(n=>n.title!=="about:blank");a.push(o?"NOTE: this tab is blank \u2014 your page may be in another tab; computer.surfaces() lists it \u2014 act through its handle.":"NOTE: this tab is blank and nothing has been opened in it \u2014 navigate (openUrl({url})) instead of observing again.")}return a}async blankSurfaceHint(){try{return this.page().url()!=="about:blank"?"":(await this.ownPages()).some(t=>t!==this.page()&&t.url()!=="about:blank")?"the active tab is a blank page \u2014 your page may be in another tab; computer.surfaces() lists it \u2014 act through its handle":""}catch{return""}}}export{G as BrowserDriver};

package/dist/platform/browser/focus-guard.d.ts

@@ -0,0 +1,2 @@
+export declare function isFrontmost(browserPid: number | null): Promise<boolean>;
+export declare function returnFocusIfTaken(browserPid: number | null): Promise<void>;

package/dist/platform/browser/focus-guard.js

@@ -0,0 +1 @@
+import{execFile as s}from"node:child_process";function r(n){return new Promise(i=>{s("/usr/bin/lsappinfo",n,{timeout:700},(t,e)=>{i(t?null:e)})})}async function o(n){const i=await r(["info","-only","pid",n]),t=Number(i?.match(/"pid"\s*=\s*(\d+)/)?.[1]);return Number.isFinite(t)?t:null}async function f(n){if(process.platform!=="darwin"||!n)return!1;const i=(await r(["front"]))?.trim().replace(/:$/,"");return!!i&&await o(i)===n}async function l(n){if(process.platform!=="darwin"||!n)return;const t=(await r(["visibleProcessList"]))?.match(/ASN:[^\s:"]*(?:-"[^"]*")?/g)?.map(e=>e.replace(/-"[^"]*"$/,""))??[];if(!(t.length<2)&&await o(t[0])===n)for(const e of t.slice(1)){if(await o(e)===n)continue;const a=(await r(["info","-only","bundleID",e]))?.match(/"CFBundleIdentifier"="([^"]+)"/)?.[1];if(!a)return;await new Promise(u=>{s("/usr/bin/open",["-b",a],{timeout:1500},()=>u())});return}}export{f as isFrontmost,l as returnFocusIfTaken};

package/dist/platform/browser/journal.d.ts

@@ -0,0 +1,21 @@
+import type { ActResult } from "../types.ts";
+import { type BrowserConfig } from "./config.ts";
+export declare class ActionJournal {
+    private readonly profileDir;
+    private readonly takeShot;
+    private readonly currentUrl;
+    private readonly cfg;
+    private chain;
+    private shotSeq;
+    constructor(profileDir: string, takeShot: () => Promise<Buffer | null>, currentUrl: () => string, cfg?: BrowserConfig);
+    publishAction(kind: string, a: Record<string, any>, point: {
+        x: number;
+        y: number;
+    } | null, res: ActResult): void;
+    publishVerdict(verdict: string): void;
+    drain(ms: number): Promise<void>;
+    private writeJournalLine;
+    private appendActionLine;
+    private nextShotSeq;
+    private pruneShots;
+}

package/dist/platform/browser/journal.js

@@ -0,0 +1,2 @@
+import{appendFile as u,mkdir as s,readdir as c,rm as l,stat as p,writeFile as a}from"node:fs/promises";import{dirname as m,join as h}from"node:path";import{actionsFileFor as g,shotsDirFor as y}from"./acquire.js";import{browserConfigFromEnv as w}from"./config.js";const S=256*1024,f=500;function x(){const n=process.env.COMPUTER_USE_SHOTS_KEEP?.trim();if(!n)return f;const i=Number.parseInt(n,10);return Number.isInteger(i)&&i>=0?i:f}class _{profileDir;takeShot;currentUrl;cfg;chain=Promise.resolve();shotSeq=null;constructor(i,t,r,e=w()){this.profileDir=i,this.takeShot=t,this.currentUrl=r,this.cfg=e}publishAction(i,t,r,e){const o={ts:Date.now(),kind:i,url:this.currentUrl()};typeof t.x=="number"&&typeof t.y=="number"?(o.x=t.x,o.y=t.y):r&&(o.x=r.x,o.y=r.y),typeof t.name=="string"&&t.name&&(o.name=t.name),i==="set_text"&&typeof t.text=="string"&&(o.text=t.text),i==="keys"&&typeof t.chord=="string"&&(o.chord=t.chord),i==="scroll"&&(typeof t.direction=="string"&&(o.direction=t.direction),typeof t.to=="string"&&(o.to=t.to),typeof t.into=="string"&&(o.into=t.into)),i==="focus"&&typeof t.target=="string"&&(o.target=t.target),i==="focus"&&t.auto===!0&&(o.auto=!0),e.journal&&Object.assign(o,e.journal),o.ok=e.ok,!e.ok&&e.note&&(o.note=e.note),this.chain=this.chain.then(()=>this.writeJournalLine(o)).catch(()=>{})}publishVerdict(i){const t={ts:Date.now(),kind:"verdict",verdict:i,url:this.currentUrl()};this.chain=this.chain.then(()=>this.appendActionLine(t)).catch(()=>{})}async drain(i){let t;try{await Promise.race([this.chain.catch(()=>{}),new Promise(r=>{t=setTimeout(r,i)})])}finally{t&&clearTimeout(t)}}async writeJournalLine(i){const t=x();if(t>0){const r=await this.takeShot();if(r){const e=y(this.profileDir,this.cfg);await s(e,{recursive:!0});const o=await this.nextShotSeq(e);await a(h(e,`${o}.jpg`),r).then(()=>!0,()=>!1)&&(i.shot=`shots/${o}.jpg`),await this.pruneShots(e,t)}}await this.appendActionLine(i)}async appendActionLine(i){const t=g(this.profileDir,this.cfg);await s(m(t),{recursive:!0}),await p(t).then(e=>e.size).catch(()=>0)>S&&await a(t,""),await u(t,`${JSON.stringify(i)}
+`)}async nextShotSeq(i){if(this.shotSeq===null){let t=0;for(const r of await c(i).catch(()=>[])){const e=/^(\d+)\.jpg$/.exec(r);e&&(t=Math.max(t,Number(e[1])))}this.shotSeq=t}return++this.shotSeq}async pruneShots(i,t){const r=[];for(const e of await c(i).catch(()=>[])){const o=/^(\d+)\.jpg$/.exec(e);o&&r.push(Number(o[1]))}r.sort((e,o)=>e-o);for(const e of r.slice(0,Math.max(0,r.length-t)))await l(h(i,`${e}.jpg`),{force:!0}).catch(()=>{})}}export{_ as ActionJournal};

package/dist/platform/browser/keep-in-tab.d.ts

@@ -0,0 +1 @@
+export declare const KEEP_IN_TAB_JS = "(() => {\n  if (window.__computerUseKeepInTab) return;\n  window.__computerUseKeepInTab = true;\n  // _self/_parent/_top all stay in this window; _blank and any NAME open another one.\n  const opensTab = (t) => !!t && !/^_(self|parent|top)$/i.test(t);\n  const keep = (e) => {\n    // composedPath() pierces shadow roots, where e.target is the host and closest() is blind.\n    const path = e.composedPath ? e.composedPath() : [e.target];\n    for (const n of path) {\n      if (!n || (n.tagName !== 'A' && n.tagName !== 'FORM')) continue;\n      if (opensTab(n.getAttribute('target'))) n.removeAttribute('target');\n      break;\n    }\n    const base = document.querySelector('base[target]');\n    if (base && opensTab(base.getAttribute('target'))) base.removeAttribute('target');\n  };\n  document.addEventListener('click', keep, true);\n  document.addEventListener('submit', keep, true);\n  const nativeOpen = window.open.bind(window);\n  const blank = (u) => !u || /^(about:blank|#)$/i.test(String(u).trim());\n  // A features string asking for a separate WINDOW (the popup token or any geometry) \u2014 the\n  // OAuth/captcha handshake idiom. A tab-shaped open has no features at all.\n  const popup = (f) => !!f && /(^|[\\s,])(popup|width|height|left|top|innerWidth|innerHeight|outerWidth|outerHeight|screenX|screenY)(\\s*=|$|[\\s,])/i.test(String(f));\n  window.open = function (url, name, features) {\n    if (blank(url)) return nativeOpen(url, name, features); // no destination: a window to write into\n    if (popup(features)) return nativeOpen(url, name, features); // a handshake popup needs a real opener\n\n    window.location.href = String(url);\n    return {\n      closed: false, focus() {}, blur() {}, close() {}, postMessage() {},\n      get location() { return window.location; },\n      set location(v) { window.location.href = String(v); },\n    };\n  };\n})()";

package/dist/platform/browser/keep-in-tab.js

@@ -0,0 +1 @@
+const e=("((()=>{if(window.__computerUseKeepInTab)return;window.__computerUseKeepInTab=!0;const i=t=>!!t&&!/^_(self|parent|top)$/i.test(t),r=t=>{const o=t.composedPath?t.composedPath():[t.target];for(const n of o)if(!(!n||n.tagName!==\"A\"&&n.tagName!==\"FORM\")){i(n.getAttribute(\"target\"))&&n.removeAttribute(\"target\");break}const e=document.querySelector(\"base[target]\");e&&i(e.getAttribute(\"target\"))&&e.removeAttribute(\"target\")};document.addEventListener(\"click\",r,!0),document.addEventListener(\"submit\",r,!0);const s=window.open.bind(window),c=t=>!t||/^(about:blank|#)$/i.test(String(t).trim()),a=t=>!!t&&/(^|[\\s,])(popup|width|height|left|top|innerWidth|innerHeight|outerWidth|outerHeight|screenX|screenY)(\\s*=|$|[\\s,])/i.test(String(t));window.open=function(t,o,e){return c(t)||a(e)?s(t,o,e):(window.location.href=String(t),{closed:!1,focus(){},blur(){},close(){},postMessage(){},get location(){return window.location},set location(n){window.location.href=String(n)}})}})())");export{e as KEEP_IN_TAB_JS};

package/dist/platform/browser/messages.d.ts

@@ -0,0 +1,25 @@
+export declare function msgChromeMissing(installHint: string): string;
+export declare function msgAttachedDeadEnd(profileDir: string, why: string): string;
+export declare const msgAttachedWhyNoPage: () => string;
+export declare const msgAttachedWhyHandshake: () => string;
+export declare const msgAttachedWhyNoPort: () => string;
+export declare const msgOwnWindowFailed: () => string;
+export declare function msgChromeBinaryUnrunnable(exe: string, code: string): string;
+export declare function msgChromeStartFailed(detail: string): string;
+export declare const msgChromeExitedImmediately: () => string;
+export declare const msgChromeNoPort: () => string;
+export declare const msgChromeRefusedAttach: () => string;
+export declare function msgBridgeExtensionGone(): string;
+export declare function msgBridgeExtensionElsewhere(owner: string): string;
+export declare function msgBridgeJustStarted(): string;
+export declare function isBridgeExtensionGone(e: unknown): boolean;
+export declare function msgEndpointUnavailable(cdpUrl: string, detail: string): string;
+export declare const REOPENED_NOTE: string;
+export declare const TAB_REOPENED_NOTE: string;
+export declare const TAB_DETACHED_NOTE: string;
+export declare function tabRefusedNote(reason: string): string;
+export declare const TAB_REOPENED_AFTER_SELF_CLOSE_NOTE: string;
+export declare const NO_TAB_OPEN_NOTE: string;
+export declare const NO_TAB_YET_NOTE: string;
+export declare const BROWSER_SWITCHED_NOTE: string;
+export declare const SURFACE_REIDENTIFIED_NOTE: string;

package/dist/platform/browser/messages.js

@@ -0,0 +1,8 @@
+function n(e){return`mirasim-cu: Google Chrome was not found, so no browser could be started.
+Fix one of:
+  - install Google Chrome (${e})
+  - point COMPUTER_USE_CHROME at a Chrome/Chromium binary
+  - point COMPUTER_USE_CDP_URL at an already-running browser's CDP endpoint`}function s(e,t){return`mirasim-cu: cannot take over this Chrome \u2014 ${t}.
+This profile belongs to the user (${e}), so it will not be force-closed.
+Quit Chrome (\u2318Q) and retry.`}const r=()=>"its debugging port answers, but no usable page can be opened",i=()=>"its debugging port answers, but the handshake timed out (the browser may be frozen)",a=()=>"it is already running, but without a debugging port",h=()=>"mirasim-cu: could not open the agent's own window in the user's Chrome.";function d(e,t){return`mirasim-cu: cannot run the Chrome binary at ${e} (${t}). Point COMPUTER_USE_CHROME at a working Chrome/Chromium.`}function c(e){return`mirasim-cu: Chrome could not be started (${e}).`}const g=()=>"mirasim-cu: Chrome exited immediately instead of publishing a debugging port \u2014 another browser may already own this profile directory.",m=()=>"mirasim-cu: Chrome never published a debugging port within 15s.",b=()=>"mirasim-cu: Chrome started but its debugger refused to attach.",o="https://chromewebstore.google.com/detail/mirasim/khflooofmndpmafhofjdcpjfgnlpikhg";function l(){return`The mirasim bridge extension is not connected, so this browser cannot be reached. Nothing you can do from here fixes it and retrying will not help: ask the user to install or enable the Mirasim extension from the Chrome Web Store (${o}) and remove any older copy loaded unpacked at chrome://extensions, which no longer connects; then continue.`}function u(e){return`The Mirasim extension is connected to another program's browser bridge (${e}), not to this one \u2014 it serves one bridge at a time and that one comes first. Retrying will not help: ask the user to turn browser control off in that program (${e}), then continue.`}function f(){return`The browser bridge started moments ago and the Mirasim extension has not connected yet. An installed extension checks again within a minute; wait about a minute and retry once. If it still does not connect, ask the user to install or enable the Mirasim extension from the Chrome Web Store (${o}).`}function p(e){return/Bridge extension not connected|bridge extension did not connect/i.test(e instanceof Error?e.message:String(e))}function w(e,t){return`mirasim-cu: explicit CDP endpoint ${e} is unavailable.
+(${t})`}const x="the browser had been closed (most likely by the user), so a fresh one was opened in the background and the page is blank \u2014 re-observe, and navigate again before acting on refs",E="this surface's tab had been closed (most likely by the user), so a fresh blank tab was claimed \u2014 re-observe, and navigate again before acting on refs",C="this surface's tab stopped answering \u2014 it was closed, or the browser took its debugger away, in which case it is still open in the user's window but out of reach from here. A fresh blank tab was claimed \u2014 re-observe, and navigate again before acting on refs. If the same page drops again right after it loads, it cannot be driven through this browser: a password manager's autofill (measured: iCloud Passwords, on any page with a password field) puts its own extension frame into the page, and Chrome then refuses this extension's debugger there. Do not reopen it; tell the user \u2014 turning that extension off for the site, or the managed browser (its own profile), drives it";function y(e){const t=`this surface's tab is out of reach: it is still open in the user's window, but Chrome refused this extension's debugger on it ("${e}"). A fresh blank tab was claimed. `;return/chrome-extension:\/\/ URL of different extension/.test(e)?t+"Another extension has put its own frame into that page \u2014 a password manager's autofill does this on any page with a password field (measured: iCloud Passwords) \u2014 and while it is there no retry from here gets in. Do not reopen the page; tell the user that turning that extension off for this site, or the managed browser (its own profile), lets it be driven":t+"Reopening it will most likely be refused the same way \u2014 tell the user rather than retrying"}const _="this session had closed its last tab, so opening one started a fresh blank tab \u2014 nothing went wrong and nobody took the browser back; navigate before acting on refs",T="this session has no tab open \u2014 it closed its last one and nothing was reopened, so the browser is left as the user had it. open_url or new_tab starts a fresh tab when you need one",k="this session holds no tab yet \u2014 none is opened until asked. Bind one of the listed tabs to act in it, or new_tab opens one of the session's own",O="the browser behind the extension changed \u2014 a different browser, or this one after a restart, is connected now, and the tabs listed are ITS tabs. Nothing was done in it and this session holds no tab there; handles and refs from before belonged to the previous browser and are gone. If this is not the browser the task is about, stop and tell the user; otherwise bind one of the listed tabs, or new_tab opens one of the session's own",N="the connection to this browser dropped and came back, so this surface was re-identified \u2014 the page below is the one it is on now, and refs from before are dead; re-observe before acting";export{O as BROWSER_SWITCHED_NOTE,T as NO_TAB_OPEN_NOTE,k as NO_TAB_YET_NOTE,x as REOPENED_NOTE,N as SURFACE_REIDENTIFIED_NOTE,C as TAB_DETACHED_NOTE,_ as TAB_REOPENED_AFTER_SELF_CLOSE_NOTE,E as TAB_REOPENED_NOTE,p as isBridgeExtensionGone,s as msgAttachedDeadEnd,i as msgAttachedWhyHandshake,r as msgAttachedWhyNoPage,a as msgAttachedWhyNoPort,u as msgBridgeExtensionElsewhere,l as msgBridgeExtensionGone,f as msgBridgeJustStarted,d as msgChromeBinaryUnrunnable,g as msgChromeExitedImmediately,n as msgChromeMissing,m as msgChromeNoPort,b as msgChromeRefusedAttach,c as msgChromeStartFailed,w as msgEndpointUnavailable,h as msgOwnWindowFailed,y as tabRefusedNote};

package/dist/platform/browser/navigate.d.ts

@@ -0,0 +1,4 @@
+import type { ActResult } from "../types.ts";
+export declare const NAV_TIMEOUT_MS = 15000;
+export declare function navVerdict(e: unknown): ActResult;
+export declare function landedNote(verb: "opened" | "reloaded", requested: string, final: string): string;