pi-browser-use 0.10.1 → 0.11.1

package/dist/config.js

@@ -2,13 +2,6 @@ import { homedir } from 'node:os';
 import { join, resolve } from 'node:path';
 import { PI_PROFILE_NAME } from './named-profile.js';
 export const DEFAULT_PROFILE_DIR = join(homedir(), '.pi', 'browser-profile');
-/**
- * Persistent headless by default: Pi-owned profile, no window, never steals
- * focus, no consent popups (log in once via browser_setup, cookies persist).
- * Set sessionMode "isolated" (or mode "fresh") for an anonymous clean room,
- * or "existing" + autoConnect to drive your daily Chrome (intrusive:
- * consent popup every session, windows may pop and steal focus).
- */
 const DEFAULTS = {
     sessionMode: 'persistent',
     headless: true,
@@ -25,12 +18,6 @@ const DEFAULTS = {
     redactNetworkHeaders: true,
     acceptInsecureCerts: false,
 };
-/**
- * Build the config for a mode switch from the session base config.
- * fresh means an isolated clean room; persistent means the saved profile
- * (headless unless headed is requested, so logins work without popups).
- * Attach fields never carry across modes.
- */
 export function resolveModeTarget(base, mode, headed = false, defaultProfileDir = DEFAULT_PROFILE_DIR) {
     const { browserUrl: _browserUrl, wsEndpoint: _wsEndpoint, wsHeaders: _wsHeaders, autoConnect: _autoConnect, mode: _mode, headed: _headed, ...rest } = base;
     void _browserUrl;
@@ -45,15 +32,12 @@ export function resolveModeTarget(base, mode, headed = false, defaultProfileDir
         return { ...freshRest, sessionMode: 'isolated', headless: !headed, isolated: true };
     }
     if (mode === 'existing') {
-        // Attach to the user's running Chrome: drop launch-only fields so MCP
-        // auto-connects instead of trying to start or reconfigure its browser.
         const { userDataDir: _userDataDir, isolated: _isolated, executablePath: _executablePath, chromeArgs: _chromeArgs, viewport: _viewport, ...existingRest } = rest;
         void _userDataDir;
         void _isolated;
         void _executablePath;
         void _chromeArgs;
         void _viewport;
-        // Existing attaches to the user's visible Chrome: always headed.
         return { ...existingRest, sessionMode: 'existing', headless: false, autoConnect: true };
     }
     return {
@@ -64,11 +48,9 @@ export function resolveModeTarget(base, mode, headed = false, defaultProfileDir
         userDataDir: base.userDataDir ?? defaultProfileDir,
     };
 }
-/** Expand a leading ~/ in user-supplied paths (env interpolation covers ${} only). */
 export function expandHome(path) {
     return path === '~' ? homedir() : path.startsWith('~/') ? resolve(homedir(), path.slice(2)) : path;
 }
-/** Merge user config over fresh-headless defaults. */
 export function resolveConfig(config, defaultProfileDir = DEFAULT_PROFILE_DIR) {
     const { mode, headed, ...rest } = config ?? {};
     const resolved = { ...DEFAULTS, ...rest };
@@ -77,7 +59,6 @@ export function resolveConfig(config, defaultProfileDir = DEFAULT_PROFILE_DIR) {
     if (typeof resolved.executablePath === 'string')
         resolved.executablePath = expandHome(resolved.executablePath);
     if (mode !== undefined) {
-        // The simple facade wins over sessionMode/headless when present.
         if (mode === 'fresh') {
             resolved.sessionMode = 'isolated';
             resolved.headless = !(headed ?? false);
@@ -93,8 +74,6 @@ export function resolveConfig(config, defaultProfileDir = DEFAULT_PROFILE_DIR) {
     else if (headed !== undefined) {
         resolved.headless = !headed;
     }
-    // Existing attaches to the user's visible Chrome: always headed, so a
-    // stale headless default never leaks into flags or status output.
     if (resolved.sessionMode === 'existing') {
         resolved.headless = false;
     }
@@ -126,7 +105,6 @@ export function resolveConfig(config, defaultProfileDir = DEFAULT_PROFILE_DIR) {
     }
     return resolved;
 }
-/** Convert config into CLI flags for the chrome-devtools-mcp subprocess. */
 export function configToArgs(config) {
     const args = [];
     const resolved = resolveConfig(config);
@@ -189,7 +167,6 @@ export function configToArgs(config) {
         !resolved.browserUrl &&
         !resolved.wsEndpoint &&
         !resolved.autoConnect) {
-        // MCP-launched persistent Chrome must use the same named Pi profile.
         args.push(`--chrome-arg=--profile-directory=${PI_PROFILE_NAME}`);
     }
     if (resolved.extraArgs)

package/dist/doctor.d.ts

@@ -3,11 +3,8 @@ export interface DoctorReport {
     mode: string;
     headless: boolean;
     launchesChrome: boolean;
-    /** Who owns the Chrome process: Pi self-launch, shared peer, MCP launch, or user attach. */
     backend?: 'pi-owned' | 'shared' | 'mcp-launched' | 'attached-external';
-    /** Agent sessions currently holding claimed pages (including self). */
     peers?: number;
-    /** Tab-bridge base URL when the Existing broker bridge is running. */
     bridgeUrl?: string | null;
     profile: {
         dir: string | null;
@@ -18,11 +15,6 @@ export interface DoctorReport {
     upstreamTools: number;
     node: string;
 }
-/**
- * Self-diagnostics for the browser setup: effective mode, whether this
- * session launches its own Chrome or attaches elsewhere, profile health,
- * and upstream tool availability. No pages touched.
- */
 export declare function diagnose(config: BrowserUseConfig, listToolNames: () => Promise<string[]>, extra?: {
     backend?: DoctorReport['backend'];
     bridgeUrl?: string | null;

package/dist/doctor.js

@@ -15,11 +15,6 @@ function profileStatus(dir) {
         return { exists, writable: false };
     }
 }
-/**
- * Self-diagnostics for the browser setup: effective mode, whether this
- * session launches its own Chrome or attaches elsewhere, profile health,
- * and upstream tool availability. No pages touched.
- */
 export async function diagnose(config, listToolNames, extra) {
     const launchesChrome = !config.browserUrl && !config.wsEndpoint && !config.autoConnect;
     const dir = config.userDataDir ?? (config.sessionMode === 'persistent' ? DEFAULT_PROFILE_DIR : null);

package/dist/existing-flow.d.ts

@@ -1,29 +1,10 @@
-/**
- * Existing-mode page opening (spec sections 18-20).
- *
- * Pi-created tabs in the user's Chrome are brokered by the Pi extension
- * (see extension/background.js) through the loopback TabBridge, then
- * correlated with MCP's page list — never by "first tab whose URL matches".
- *
- * Flow:
- * 1. snapshot MCP's page ids (before),
- * 2. bridge.requestTab(url) → token,
- * 3. extension creates the inactive grouped tab, completes the token,
- * 4. bridge.waitForTab(token) → { tabId },
- * 5. diff MCP's page list (after) against before → exact new page.
- *
- * When the bridge/extension is unavailable, fail clearly instead of opening
- * unmanaged foreground tabs (spec 25).
- */
 import { TabBridge } from './tab-bridge.js';
 export interface McpPageEntry {
     pageId: number;
     url?: string;
     title?: string;
 }
-/** URLs Pi opened or navigated to in Existing mode: the only close targets. */
 export declare function normalizeTabUrl(url: string): string;
-/** Refuse to close Existing-mode tabs Pi did not open (spec 19). */
 export declare function checkExistingCloseAllowed(entries: McpPageEntry[], pageId: number, piOwnedUrls: ReadonlySet<string>): {
     ok: true;
 } | {
@@ -32,7 +13,6 @@ export declare function checkExistingCloseAllowed(entries: McpPageEntry[], pageI
 };
 export interface ExistingFlowDeps {
     bridge: TabBridge;
-    /** List MCP-visible pages (browser_list_pages equivalent). */
     listPages: () => Promise<McpPageEntry[]>;
     requestTab?: (url: string) => string;
     waitForTab?: (token: string, options?: {
@@ -44,22 +24,11 @@ export interface ExistingFlowDeps {
     }>;
 }
 export interface ExistingOpenResult {
-    /** Correlation token (also the bridge token). */
     token: string;
-    /** Chrome tab id reported by the extension. */
     tabId?: number;
-    /** MCP page id correlated by before/after diff, when unambiguous. */
     pageId?: number;
 }
-/**
- * Best-effort MCP page list → entries. Prefers structured content, then
- * parses the `N: title (url)` text lines list_pages emits. Never throws:
- * unparseable results yield an empty list (correlation then stays silent
- * instead of guessing).
- */
 export declare function parseMcpPageList(result: unknown): McpPageEntry[];
-/** Diff page lists by id; returns the single new id, or undefined when the
- * diff is empty or ambiguous (never guess). */
 export declare function correlateNewPage(before: McpPageEntry[], after: McpPageEntry[]): number | undefined;
 export declare function openExistingPage(url: string, deps: ExistingFlowDeps, options?: {
     timeoutMs?: number;

package/dist/existing-flow.js

@@ -1,26 +1,7 @@
-/**
- * Existing-mode page opening (spec sections 18-20).
- *
- * Pi-created tabs in the user's Chrome are brokered by the Pi extension
- * (see extension/background.js) through the loopback TabBridge, then
- * correlated with MCP's page list — never by "first tab whose URL matches".
- *
- * Flow:
- * 1. snapshot MCP's page ids (before),
- * 2. bridge.requestTab(url) → token,
- * 3. extension creates the inactive grouped tab, completes the token,
- * 4. bridge.waitForTab(token) → { tabId },
- * 5. diff MCP's page list (after) against before → exact new page.
- *
- * When the bridge/extension is unavailable, fail clearly instead of opening
- * unmanaged foreground tabs (spec 25).
- */
 import { TabBridge } from './tab-bridge.js';
-/** URLs Pi opened or navigated to in Existing mode: the only close targets. */
 export function normalizeTabUrl(url) {
     return url.endsWith('/') && url.length > 1 ? url.slice(0, -1) : url;
 }
-/** Refuse to close Existing-mode tabs Pi did not open (spec 19). */
 export function checkExistingCloseAllowed(entries, pageId, piOwnedUrls) {
     const target = entries.find((entry) => entry.pageId === pageId);
     if (!target) {
@@ -40,12 +21,6 @@ export function checkExistingCloseAllowed(entries, pageId, piOwnedUrls) {
             `Pass force:true only if the user explicitly asked for this exact tab.`,
     };
 }
-/**
- * Best-effort MCP page list → entries. Prefers structured content, then
- * parses the `N: title (url)` text lines list_pages emits. Never throws:
- * unparseable results yield an empty list (correlation then stays silent
- * instead of guessing).
- */
 export function parseMcpPageList(result) {
     const entries = [];
     if (typeof result !== 'object' || result === null)
@@ -78,8 +53,6 @@ export function parseMcpPageList(result) {
             const title = (match[2] ?? '').trim();
             if (title)
                 entry.title = title;
-            // chrome-devtools-mcp 1.8 emits `N: URL [selected]`; retain support
-            // for the older `N: title (URL)` form as well.
             const url = (match[3] ?? (/^(https?:|about:|file:|data:)/.test(title) ? title : '')).trim();
             if (url)
                 entry.url = url;
@@ -88,8 +61,6 @@ export function parseMcpPageList(result) {
     }
     return entries;
 }
-/** Diff page lists by id; returns the single new id, or undefined when the
- * diff is empty or ambiguous (never guess). */
 export function correlateNewPage(before, after) {
     const known = new Set(before.map((p) => p.pageId));
     const fresh = after.filter((p) => !known.has(p.pageId));

package/dist/focus-policy.d.ts

@@ -1,10 +1,3 @@
-/**
- * MCP navigation focus policy (spec section 9, layer 1 + section 20).
- *
- * Every Pi-created MCP page defaults to background; every page selection
- * defaults to no foreground activation. Foreground is reserved for explicit
- * user requests ("show me what Pi is doing") and authentication handoffs.
- */
 export declare const PI_GROUP_TITLE = "pi-browser-use";
 export interface NewPageParams {
     url?: string;
@@ -16,13 +9,7 @@ export interface SelectPageParams {
     bringToFront?: boolean;
     [key: string]: unknown;
 }
-/** Default `new_page` to background unless the caller explicitly opted out. */
 export declare function applyNewPageDefaults<T extends NewPageParams>(params: T): T;
-/** Default `select_page` to no foreground activation. */
 export declare function applySelectPageDefaults<T extends SelectPageParams>(params: T): T;
-/**
- * Foreground is allowed only when the user explicitly asked to view the page
- * or Pi is intentionally handing control over for authentication.
- */
 export declare function isForegroundAllowed(reason: unknown): boolean;
 //# sourceMappingURL=focus-policy.d.ts.map

package/dist/focus-policy.js

@@ -1,27 +1,14 @@
-/**
- * MCP navigation focus policy (spec section 9, layer 1 + section 20).
- *
- * Every Pi-created MCP page defaults to background; every page selection
- * defaults to no foreground activation. Foreground is reserved for explicit
- * user requests ("show me what Pi is doing") and authentication handoffs.
- */
 export const PI_GROUP_TITLE = 'pi-browser-use';
-/** Default `new_page` to background unless the caller explicitly opted out. */
 export function applyNewPageDefaults(params) {
     if (params.background === undefined)
         return { ...params, background: true };
     return params;
 }
-/** Default `select_page` to no foreground activation. */
 export function applySelectPageDefaults(params) {
     if (params.bringToFront === undefined)
         return { ...params, bringToFront: false };
     return params;
 }
-/**
- * Foreground is allowed only when the user explicitly asked to view the page
- * or Pi is intentionally handing control over for authentication.
- */
 export function isForegroundAllowed(reason) {
     return reason === 'user-requested-view' || reason === 'auth-handoff';
 }

package/dist/index.d.ts

@@ -15,6 +15,5 @@ interface Pi {
         cwd: string;
     } & Record<string, unknown>) => Promise<void>): void;
 }
-/** Native Pi owns settings/trust and model credentials, not browser behavior. */
 export default function browserUseExtension(pi: Pi): void;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -2,7 +2,6 @@ import { createBrowserRuntime } from './runtime.js';
 import { isProjectTrusted, loadConfig } from './settings.js';
 import { createRegistryVisionCaller } from './vision.js';
 export { configToArgs, resolveConfig } from './config.js';
-/** Native Pi owns settings/trust and model credentials, not browser behavior. */
 export default function browserUseExtension(pi) {
     let runtime;
     pi.on('session_start', async (_event, context) => {

package/dist/mcp-server.d.ts

@@ -1,8 +1,6 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { type BrowserRuntime, type BrowserRuntimeOptions } from './runtime.js';
-/** Only explicit host configuration is read; never .pi files or project settings. */
 export declare function loadPortableOptions(env?: NodeJS.ProcessEnv): BrowserRuntimeOptions;
-/** Low-level MCP adapter preserves the runtime's JSON schemas and curated tools. */
 export declare function createBrowserMcpServer(options?: {
     runtime?: BrowserRuntime;
     env?: NodeJS.ProcessEnv;

package/dist/mcp-server.js

@@ -50,7 +50,6 @@ const validateConfig = validator.getValidator({
         tabBridgePort: { type: 'integer', minimum: 0, maximum: 65535 },
     },
 });
-/** Only explicit host configuration is read; never .pi files or project settings. */
 export function loadPortableOptions(env = process.env) {
     const dataDir = env.PI_BROWSER_USE_DATA_DIR ??
         env.PLUGIN_DATA ??
@@ -74,7 +73,6 @@ export function loadPortableOptions(env = process.env) {
             parsed = JSON.parse(raw);
         }
         catch (error) {
-            // JSON parse errors may include fragments of wsHeaders. Never echo those.
             throw new Error('Browser plugin config.json is not valid JSON.', { cause: error });
         }
     }
@@ -96,8 +94,6 @@ export function loadPortableOptions(env = process.env) {
         defaultProfileDir: join(dataDir, 'browser-profile'),
         artifactDir: join(dataDir, 'artifacts'),
         lazyBrowser: true,
-        // Other hosts analyze returned screenshot images using their own model.
-        // No implicit Pi credentials, sampling calls, or extra model charges.
         visionEnabled: false,
     };
 }
@@ -107,7 +103,6 @@ function packageVersion() {
 function reportFailure(error) {
     console.error(`[pi-browser-use] MCP lifecycle failed (${error instanceof Error ? error.name : 'UnknownError'}).`);
 }
-/** Low-level MCP adapter preserves the runtime's JSON schemas and curated tools. */
 export function createBrowserMcpServer(options = {}) {
     const runtime = options.runtime ?? createBrowserRuntime(loadPortableOptions(options.env));
     const server = new Server({ name: 'pi-browser-use', version: packageVersion() }, { capabilities: { tools: {} } });
@@ -137,7 +132,6 @@ export function createBrowserMcpServer(options = {}) {
         }
         const checked = validate(request.params.arguments ?? {});
         if (!checked.valid) {
-            // Do not echo argument values (forms may contain sensitive content).
             throw new McpError(ErrorCode.InvalidParams, `Invalid arguments for ${tool.name}. Follow its inputSchema.`);
         }
         try {
@@ -173,12 +167,9 @@ export function createBrowserMcpServer(options = {}) {
         closePromise ??= shutdown();
         return closePromise;
     }
-    // MCP uses callback properties, not DOM EventTarget listeners.
-    // oxlint-disable-next-line unicorn/prefer-add-event-listener
     server.onclose = () => {
         void close().catch(reportFailure);
     };
-    // oxlint-disable-next-line unicorn/prefer-add-event-listener
     server.onerror = reportFailure;
     return { server, close };
 }
@@ -198,7 +189,6 @@ export async function runStdio() {
         throw error;
     }
 }
-// Canonical paths handle macOS /var vs /private/var aliases in packed installs.
 if (process.argv[1] &&
     realpathSync(process.argv[1]) === realpathSync(fileURLToPath(import.meta.url))) {
     if (process.argv.includes('--help')) {

package/dist/named-profile.d.ts

@@ -1,47 +1,11 @@
-/**
- * Named Pi Chrome profile (spec: Pi's browser identity).
- *
- * Pi's persistent data lives in a dedicated user-data-dir root
- * (~/.pi/browser-profile), but Chrome's human-visible profile inside it was
- * whatever Chrome picked ("Default", "Profile 1", ...). This module pins it
- * to a stable directory named exactly `pi-browser-use`, launched via
- * `--profile-directory`:
- *
- * ```text
- * ~/.pi/browser-profile/          <- user-data-dir root (locks, metadata)
- *   pi-browser-use/               <- the named profile (cookies, logins)
- *     Cookies, Preferences, ...
- * ```
- *
- * Legacy/singleton layouts ("Default", "Profile 1") are migrated once with a
- * plain directory rename while Chrome is stopped and the profile lock is
- * held — same files, same machine, so Keychain-bound secrets keep working.
- * Chrome is always launched with the explicit flag afterwards, so a stale
- * `last_used` pointer can never resurrect the old directory.
- */
 export declare const PI_PROFILE_NAME = "pi-browser-use";
-/** Human-visible name in Chrome's profile menu/picker. */
 export declare const PI_PROFILE_DISPLAY_NAME = "Pi Browser";
-/**
- * Stamp the display name on a profile directory's Preferences (best effort,
- * Chrome stopped only). Fresh directories get a minimal Preferences file
- * that Chrome backfills on launch; custom user-chosen names are preserved.
- */
 export declare function seedDisplayName(profileDir: string): boolean;
-/** True when an external Chrome currently holds this user-data-dir root. */
 export declare function isChromeRunningOn(root: string): boolean;
 export interface NamedProfile {
-    /** user-data-dir root (unchanged). */
     root: string;
-    /** Profile directory name to pass as --profile-directory. */
     name: string;
-    /** Legacy directory migrated, if any. */
     migratedFrom: string | null;
 }
-/**
- * Ensure `<root>/pi-browser-use` is the live profile. Migrates the current
- * legacy directory (last_used, else Default, else Profile 1) exactly once.
- * The caller must hold the profile lock and Chrome must be stopped.
- */
 export declare function ensureNamedProfile(root: string): NamedProfile;
 //# sourceMappingURL=named-profile.d.ts.map

package/dist/named-profile.js

@@ -1,41 +1,13 @@
-/**
- * Named Pi Chrome profile (spec: Pi's browser identity).
- *
- * Pi's persistent data lives in a dedicated user-data-dir root
- * (~/.pi/browser-profile), but Chrome's human-visible profile inside it was
- * whatever Chrome picked ("Default", "Profile 1", ...). This module pins it
- * to a stable directory named exactly `pi-browser-use`, launched via
- * `--profile-directory`:
- *
- * ```text
- * ~/.pi/browser-profile/          <- user-data-dir root (locks, metadata)
- *   pi-browser-use/               <- the named profile (cookies, logins)
- *     Cookies, Preferences, ...
- * ```
- *
- * Legacy/singleton layouts ("Default", "Profile 1") are migrated once with a
- * plain directory rename while Chrome is stopped and the profile lock is
- * held — same files, same machine, so Keychain-bound secrets keep working.
- * Chrome is always launched with the explicit flag afterwards, so a stale
- * `last_used` pointer can never resurrect the old directory.
- */
 import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 export const PI_PROFILE_NAME = 'pi-browser-use';
-/** Human-visible name in Chrome's profile menu/picker. */
 export const PI_PROFILE_DISPLAY_NAME = 'Pi Browser';
-/** Generic Chrome-assigned names worth replacing with ours. */
 const GENERIC_PROFILE_NAMES = [/^person \d+$/i, /^your chrome$/i, /^default$/i];
 function isGenericName(name) {
     if (typeof name !== 'string' || name.trim().length === 0)
         return true;
     return GENERIC_PROFILE_NAMES.some((pattern) => pattern.test(name.trim()));
 }
-/**
- * Stamp the display name on a profile directory's Preferences (best effort,
- * Chrome stopped only). Fresh directories get a minimal Preferences file
- * that Chrome backfills on launch; custom user-chosen names are preserved.
- */
 export function seedDisplayName(profileDir) {
     try {
         mkdirSync(profileDir, { recursive: true });
@@ -66,9 +38,7 @@ export function seedDisplayName(profileDir) {
         }
     }
 }
-/** Chrome singleton markers: present while any Chrome holds the root. */
 const SINGLETON_FILES = ['SingletonSocket', 'SingletonLock', 'SingletonCookie'];
-/** True when an external Chrome currently holds this user-data-dir root. */
 export function isChromeRunningOn(root) {
     return SINGLETON_FILES.some((file) => existsSync(join(root, file)));
 }
@@ -91,14 +61,8 @@ function writeLastUsed(root, name) {
         writeFileSync(path, JSON.stringify(state));
     }
     catch {
-        // Best effort: the explicit launch flag decides anyway.
     }
 }
-/**
- * Ensure `<root>/pi-browser-use` is the live profile. Migrates the current
- * legacy directory (last_used, else Default, else Profile 1) exactly once.
- * The caller must hold the profile lock and Chrome must be stopped.
- */
 export function ensureNamedProfile(root) {
     const target = join(root, PI_PROFILE_NAME);
     if (existsSync(target)) {
@@ -108,7 +72,6 @@ export function ensureNamedProfile(root) {
     const candidates = [readLastUsed(root), 'Default', 'Profile 1'].filter((name) => typeof name === 'string');
     const source = candidates.find((name) => existsSync(join(root, name)));
     if (!source) {
-        // Fresh root: seed the name now so Chrome is born Pi-branded.
         seedDisplayName(target);
         return { root, name: PI_PROFILE_NAME, migratedFrom: null };
     }

package/dist/persistent-backend.d.ts

@@ -1,27 +1,3 @@
-/**
- * Pi-owned Persistent Chrome backend (spec sections 2 and 4).
- *
- * Normal automation launches Chrome directly with the Pi profile and an
- * ephemeral loopback remote-debugging port, then MCP attaches via
- * `--browser-url` — instead of asking MCP/Puppeteer to create the browser:
- *
- * ```text
- * Google Chrome --user-data-dir="<pi-profile>"
- *   --remote-debugging-port=<ephemeral> [--headless]
- *        ↕
- * chrome-devtools-mcp --browser-url=http://127.0.0.1:<port>
- * ```
- *
- * Invariants:
- * - one Chrome process <-> one persistent profile (profile lock held for the
- *   whole backend lifetime, acquired on start, released on stop);
- * - dynamically allocated localhost port, never hardcoded 9222;
- * - clean shutdown (SIGTERM, then SIGKILL) before any relaunch, so headed and
- *   headless instances never overlap on the same user-data-dir.
- *
- * The launcher and MCP-client factory are injectable so the lifecycle is
- * unit-testable without a real Chrome.
- */
 import { type ChromeLaunchOptions, type ChromeProcess } from './chrome-launcher.js';
 import { type ProfileLockHandle } from './profile-lock.js';
 import { type BrowserUseConfig } from './config.js';
@@ -29,15 +5,11 @@ export interface AttachedClient {
     close(): Promise<void>;
 }
 export interface PersistentBackendOptions {
-    /** Resolved Pi config for the persistent profile. */
     config: BrowserUseConfig;
-    /** Headed (false = headless automation, true = visible fallback/auth). */
     headed?: boolean;
-    /** Agent-session identity for the shared registry. Generated when omitted. */
     sessionId?: string;
     launch?: (options: ChromeLaunchOptions) => Promise<ChromeProcess>;
     lock?: (profileDir: string) => ProfileLockHandle;
-    /** Build the MCP client already pointed at `browserUrl`. */
     attachClient?: (config: BrowserUseConfig) => AttachedClient;
 }
 export declare class PersistentBackend {
@@ -51,49 +23,23 @@ export declare class PersistentBackend {
     private readonly attachClient;
     readonly sessionId: string;
     constructor(options: PersistentBackendOptions);
-    /** True when this session owns the Chrome process (may restart it). */
     get owned(): boolean;
     profileDir(): string;
     browserUrl(): string | undefined;
     attached(): AttachedClient | undefined;
-    /** OS pid of the owned Chrome process, for explicit user-facing fronting. */
     pid(): number | undefined;
-    /**
-     * Kill leftover Pi-managed Chromes on this profile (crashed sessions).
-     * Only processes carrying our managed flags; skips our own pid and
-     * manually opened windows. Injectable runner for tests.
-     */
+    private onChromeExit;
+    private watchChrome;
     protected reapOrphans(profileDir: string, runner?: {
         ps(): string;
         kill(pid: number): void;
     }): number[];
-    /**
-     * Start Pi-owned Chrome and prepare the MCP attach config. When an
-     * `attachClient` factory was injected, the client is created here;
-     * otherwise the caller builds its DevToolsClient from `attachConfig()`.
-     */
     start(signal?: AbortSignal): Promise<BrowserUseConfig>;
-    /** Effective browser URL: owned Chrome or the shared peer's. */
     effectiveBrowserUrl(): string;
-    /**
-     * MCP attach config: same session options, but pointed at Pi-owned Chrome
-     * (or the shared peer's). `userDataDir`/`isolated` are stripped — MCP
-     * must attach, not launch.
-     */
     attachConfig(): BrowserUseConfig;
     running(): boolean;
-    /**
-     * Clean shutdown. Owned: close client, quit Chrome, release lock,
-     * withdraw advert. Shared: close only our own MCP client — never touch
-     * the peer's browser.
-     */
     stop(): Promise<void>;
-    /** Restart into the other visibility (headless <-> headed fallback). */
     restart(headed: boolean, signal?: AbortSignal): Promise<BrowserUseConfig>;
 }
-/**
- * Persistent mode self-launches Pi-owned Chrome (§4) unless the legacy
- * escape hatch is set (MCP launches Chrome itself, pre-Phase-2 behavior).
- */
 export declare function shouldSelfLaunch(config: BrowserUseConfig): boolean;
 //# sourceMappingURL=persistent-backend.d.ts.map