pi-browser-use 0.6.1 → 0.7.0

package/dist/session-manager.js

@@ -0,0 +1,275 @@
+/**
+ * BrowserSessionManager: mode-specific behavior behind one stable API
+ * (spec sections 1, 8, 21, 24, 25).
+ *
+ * ```text
+ * Pi Skills / Agent → BrowserSessionManager → Fresh | Persistent | Existing
+ * ```
+ *
+ * - Fresh: temporary profile, headless, deleted afterwards (spec 12).
+ * - Persistent: Pi-owned profile with headless-first automation and a
+ *   headed-background fallback per origin (spec 2, 4, 7, 8, 24).
+ * - Existing: the user's own Chrome via autoConnect; Pi tabs are brokered by
+ *   the Pi extension into the collapsed `pi-browser-use` group (spec 13-20).
+ *
+ * This module holds the state machines, capability resolution, and fallback
+ * hierarchies. Process launching (chrome-launcher), locking (profile-lock),
+ * and durable metadata (persistent-store) are injected collaborators so the
+ * logic stays unit-testable without a real Chrome.
+ */
+import { PI_GROUP_TITLE } from './focus-policy.js';
+/** In-memory transport for tests and for wiring custom backends. */
+export function createMemoryTransport() {
+    const pages = [];
+    let counter = 0;
+    return {
+        pages,
+        async openPage(url) {
+            counter += 1;
+            const page = { id: `page-${counter}`, url };
+            pages.push(page);
+            return page;
+        },
+        async listPages() {
+            return [...pages];
+        },
+        async closePage(page) {
+            const index = pages.findIndex((p) => p.id === page.id);
+            if (index >= 0)
+                pages.splice(index, 1);
+        },
+    };
+}
+class BaseSession {
+    mode;
+    transport;
+    constructor(mode, transport) {
+        this.mode = mode;
+        this.transport = transport;
+    }
+    async ensureReady() { }
+    openPage(url) {
+        return this.transport.openPage(url);
+    }
+    listPages() {
+        return this.transport.listPages();
+    }
+    closePage(page) {
+        return this.transport.closePage(page);
+    }
+    async requestVisibleBrowser(reason) {
+        await this.transport.requestVisibleBrowser?.(reason);
+    }
+    async shutdown() { }
+}
+/** Fresh: anonymous, stateless, headless. Never inherits auth (spec 12). */
+export class FreshSession extends BaseSession {
+    constructor(transport) {
+        super('fresh', transport);
+    }
+    async getStatus() {
+        return {
+            mode: 'fresh',
+            state: 'Running privately in background',
+            profile: 'Ephemeral (nothing persists)',
+            execution: 'Headless',
+        };
+    }
+}
+const PERSISTENT_TRANSITIONS = {
+    UNINITIALIZED: { 'bootstrap-needed': 'SETUP_REQUIRED' },
+    SETUP_REQUIRED: { 'bootstrap-opened': 'SETUP_HEADFUL' },
+    SETUP_HEADFUL: { 'bootstrap-closed': 'READY' },
+    READY: { 'automation-started': 'AUTOMATING_HEADLESS' },
+    AUTOMATING_HEADLESS: {
+        'automation-succeeded': 'READY',
+        'auth-required': 'REAUTH_REQUIRED',
+        'headless-incompatible': 'AUTOMATING_HEADFUL',
+    },
+    AUTOMATING_HEADFUL: {
+        'automation-succeeded': 'READY',
+        'auth-required': 'REAUTH_REQUIRED',
+    },
+    REAUTH_REQUIRED: { 'reauth-opened': 'REAUTH_HEADFUL' },
+    REAUTH_HEADFUL: { 'reauth-completed': 'READY' },
+};
+/** Pure Persistent lifecycle transition. Returns the state unchanged for unknown events. */
+export function nextPersistentState(state, event) {
+    return PERSISTENT_TRANSITIONS[state][event] ?? state;
+}
+/** Normalize a URL or origin to a bare origin for preference lookup. */
+export function normalizeOrigin(urlOrOrigin) {
+    try {
+        return new URL(urlOrOrigin).origin;
+    }
+    catch {
+        return urlOrOrigin;
+    }
+}
+/** Resolve the execution mode for an origin or full URL (spec section 8). */
+export function resolveExecutionForOrigin(preferences, urlOrOrigin, fallback = 'headless') {
+    const origin = normalizeOrigin(urlOrOrigin);
+    const match = preferences.find((p) => normalizeOrigin(p.origin) === origin);
+    return match?.executionMode ?? fallback;
+}
+/** Remember/overwrite the per-origin preference; never downgrades globally. */
+export function rememberExecutionPreference(preferences, urlOrOrigin, executionMode) {
+    const origin = normalizeOrigin(urlOrOrigin);
+    const next = preferences.filter((p) => normalizeOrigin(p.origin) !== origin);
+    next.push({ origin, executionMode });
+    return next;
+}
+/**
+ * Persistent: Pi's browser identity. Headless first; per-origin
+ * headed-background fallback; reauth via headed browser (spec 2, 7, 8).
+ */
+export class PersistentSession extends BaseSession {
+    persistentState;
+    executionMode;
+    sitePreferences;
+    metadata;
+    constructor(options) {
+        super('persistent', options.transport);
+        this.metadata = options.metadata;
+        this.persistentState =
+            options.initialState ?? (options.metadata.initialized ? 'READY' : 'SETUP_REQUIRED');
+        this.executionMode = options.executionMode ?? 'headless';
+        this.sitePreferences = [...(options.sitePreferences ?? [])];
+    }
+    get persistentStatus() {
+        return this.persistentState;
+    }
+    get currentExecutionMode() {
+        return this.executionMode;
+    }
+    get preferences() {
+        return [...this.sitePreferences];
+    }
+    send(event) {
+        this.persistentState = nextPersistentState(this.persistentState, event);
+        return this.persistentState;
+    }
+    executionFor(urlOrOrigin) {
+        try {
+            const origin = new URL(urlOrOrigin).origin;
+            return resolveExecutionForOrigin(this.sitePreferences, origin, this.executionMode);
+        }
+        catch {
+            return this.executionMode;
+        }
+    }
+    /** A site failed headless while headed works: pin headed-background there. */
+    markHeadlessIncompatible(urlOrOrigin) {
+        try {
+            const origin = new URL(urlOrOrigin).origin;
+            this.sitePreferences = rememberExecutionPreference(this.sitePreferences, origin, 'headed-background');
+        }
+        catch {
+            // Non-URL input: fall back to the session default without pinning.
+            this.executionMode = 'headed-background';
+        }
+        this.send('headless-incompatible');
+    }
+    async getStatus() {
+        const bootstrapped = this.metadata.initialized;
+        return {
+            mode: 'persistent',
+            state: this.persistentState === 'READY' || this.persistentState.startsWith('AUTOMATING')
+                ? 'Running privately in background'
+                : this.persistentState === 'REAUTH_REQUIRED' || this.persistentState === 'REAUTH_HEADFUL'
+                    ? 'Authentication required'
+                    : bootstrapped
+                        ? 'Ready'
+                        : 'Browser setup required',
+            profile: bootstrapped ? 'Ready' : 'Setup required',
+            execution: this.executionMode === 'headless' ? 'Headless' : 'Visible fallback (background)',
+        };
+    }
+}
+/**
+ * Existing: the user's browser identity via autoConnect (spec 13).
+ * All Pi-created tabs must go through the extension broker into the
+ * collapsed `pi-browser-use` group — never raw foreground tabs.
+ */
+export class ExistingSession extends BaseSession {
+    constructor(transport) {
+        super('existing', transport);
+    }
+    async getStatus() {
+        return {
+            mode: 'existing',
+            state: 'Using your existing Chrome',
+            profile: 'Your browser',
+            execution: `Background tabs in “${PI_GROUP_TITLE}”`,
+        };
+    }
+}
+/**
+ * Resolve a capability request to a mode (spec section 21):
+ * persistence/auth → persistent; explicit existing opt-in → existing;
+ * otherwise fresh. Callers escalate along the fallback hierarchies
+ * (sections 24/25) when the resolved mode cannot serve.
+ */
+export function resolveModeForCapabilities(request, persistentInitialized) {
+    if (request.persistence === true || request.authentication) {
+        return 'persistent';
+    }
+    if (request.supportsExisting === true && !persistentInitialized) {
+        return 'existing';
+    }
+    return 'fresh';
+}
+/** Next step when persistent headless cannot proceed. */
+export function nextPersistentEscalation(reason) {
+    if (reason === 'works')
+        return 'headless';
+    if (reason === 'login-needed')
+        return 'headed-auth-then-headless';
+    return 'headed-background';
+}
+/** Existing-mode creation contract (spec section 25): fail loudly when the
+ * extension broker is unavailable rather than opening unmanaged tabs. */
+export function assertExistingBrokerAvailable(available) {
+    if (!available) {
+        throw new Error(`Existing-mode tab broker unavailable: refusing to open unmanaged tabs. ` +
+            `Install the Pi extension so tabs land in the collapsed “${PI_GROUP_TITLE}” group.`);
+    }
+}
+export class BrowserSessionManager {
+    sessions;
+    current = 'fresh';
+    constructor(sessions) {
+        this.sessions = sessions;
+    }
+    getMode() {
+        return this.current;
+    }
+    getSession(mode = this.current) {
+        return this.sessions[mode];
+    }
+    async switchTo(mode) {
+        if (mode !== this.current) {
+            await this.sessions[this.current].shutdown().catch(() => { });
+        }
+        this.current = mode;
+        const session = this.sessions[mode];
+        await session.ensureReady();
+        return session;
+    }
+    /** Capability-based selection (spec 21): skills ask, manager resolves. */
+    async require(request) {
+        const persistent = this.sessions.persistent;
+        let initialized = false;
+        if (persistent instanceof PersistentSession) {
+            initialized = persistent.persistentStatus !== 'SETUP_REQUIRED';
+        }
+        const mode = resolveModeForCapabilities(request, initialized);
+        return this.switchTo(mode);
+    }
+    async shutdownAll() {
+        for (const session of Object.values(this.sessions)) {
+            await session.shutdown().catch(() => { });
+        }
+    }
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/session-manager.js.map

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

package/dist/session.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Stable internal browser API shared by all Pi browser modes.
+ *
+ * Skills talk to {@link BrowserSession} only. They must never deal with
+ * Chrome process flags, profile directories, CDP endpoints, tab-group IDs,
+ * or focus behavior directly — that translation lives in
+ * `BrowserSessionManager` (see `session-manager.ts`).
+ *
+ * Spec sections: 1 (core architecture), 2 (persistent metadata),
+ * 6 (skill-owned auth detection), 8 (execution modes), 21 (capabilities),
+ * 23 (status UX).
+ */
+export type BrowserSessionMode = 'fresh' | 'persistent' | 'existing';
+/** Opaque handle to an open page/tab. Backends resolve it to MCP/CDP state. */
+export interface PageHandle {
+    /** Backend page identifier (MCP pageId, CDP target id, ...). */
+    id: string;
+    url?: string;
+    title?: string;
+}
+/** User-facing browser status. Never expose CDP/MCP terminology here. */
+export interface BrowserStatus {
+    mode: BrowserSessionMode;
+    /** Plain-language state, e.g. "Running privately in background". */
+    state: string;
+    /** e.g. "Ready", "Setup required", "Authentication required". */
+    profile: string;
+    /** e.g. "Headless", "Visible fallback", "Using your existing Chrome". */
+    execution: string;
+}
+export interface BrowserSession {
+    readonly mode: BrowserSessionMode;
+    ensureReady(): Promise<void>;
+    openPage(url: string): Promise<PageHandle>;
+    listPages(): Promise<PageHandle[]>;
+    closePage(page: PageHandle): Promise<void>;
+    /**
+     * Ask to make the browser visible (auth handoff, explicit "show me").
+     * Implementations may no-op when already visible or when the mode is
+     * headless-only.
+     */
+    requestVisibleBrowser(reason: string): Promise<void>;
+    getStatus(): Promise<BrowserStatus>;
+    shutdown(): Promise<void>;
+}
+/**
+ * Thrown by skill-level auth verifiers when a page needs a human
+ * (sign-in, 2FA, passkey, CAPTCHA, SSO). The browser subsystem catches this
+ * and moves the Persistent session into reauthentication; skills define the
+ * destination URL and the authenticated/challenge checks.
+ */
+export declare class BrowserAuthRequired extends Error {
+    readonly provider: string;
+    readonly url?: string;
+    constructor(options: {
+        provider: string;
+        url?: string;
+        message?: string;
+    });
+}
+/** Two automation execution modes inside Persistent (spec section 8). */
+export type PersistentExecutionMode = 'headless' | 'headed-background';
+/** Persistent lifecycle state machine (spec section 2). */
+export type PersistentState = 'UNINITIALIZED' | 'SETUP_REQUIRED' | 'SETUP_HEADFUL' | 'READY' | 'AUTOMATING_HEADLESS' | 'AUTOMATING_HEADFUL' | 'REAUTH_REQUIRED' | 'REAUTH_HEADFUL';
+/**
+ * Durable Persistent state. Passwords, cookies, tokens, and copied browser
+ * credentials must never be stored here — Chrome owns those inside its
+ * profile directory.
+ */
+export interface PersistentBrowserMetadata {
+    initialized: boolean;
+    profilePath: string;
+    lastSuccessfulMode?: 'headless' | 'headed';
+    lastBootstrapAt?: string;
+}
+/** Optional per-origin headed-background preference (spec section 8). */
+export interface SiteBrowserPreference {
+    origin: string;
+    executionMode: PersistentExecutionMode;
+}
+/** Capability intent from a skill (spec section 21). */
+export interface BrowserCapabilityRequest {
+    /** True when cookies/sessions must survive restarts. */
+    persistence?: boolean;
+    /** e.g. "gmail", "github" — informational, used for status/reauth UX. */
+    authentication?: string;
+    /** Default: prefer headless, fall back to headed-background per origin. */
+    visibility?: 'prefer-headless' | 'require-headless' | 'allow-visible';
+    /** Whether falling back to the user's own Chrome is acceptable. */
+    supportsExisting?: boolean;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,YAAY,GAAG,UAAU,CAAA;AAEpE,+EAA+E;AAC/E,MAAM,WAAW,UAAU;IACzB,gEAAgE;IAChE,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,yEAAyE;AACzE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,kBAAkB,CAAA;IACxB,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAA;IACb,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAA;IACf,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAA;IAEjC,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IAC1C,SAAS,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAAA;IAClC,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1C;;;;OAIG;IACH,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACpD,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC,CAAA;IACnC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1B;AAED;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;gBAET,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;CAM1E;AAED,yEAAyE;AACzE,MAAM,MAAM,uBAAuB,GAAG,UAAU,GAAG,mBAAmB,CAAA;AAEtE,2DAA2D;AAC3D,MAAM,MAAM,eAAe,GACvB,eAAe,GACf,gBAAgB,GAChB,eAAe,GACf,OAAO,GACP,qBAAqB,GACrB,oBAAoB,GACpB,iBAAiB,GACjB,gBAAgB,CAAA;AAEpB;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,OAAO,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,kBAAkB,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAA;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,yEAAyE;AACzE,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,uBAAuB,CAAA;CACvC;AAED,wDAAwD;AACxD,MAAM,WAAW,wBAAwB;IACvC,wDAAwD;IACxD,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,iBAAiB,GAAG,kBAAkB,GAAG,eAAe,CAAA;IACrE,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B"}

package/dist/session.js

@@ -0,0 +1,29 @@
+/**
+ * Stable internal browser API shared by all Pi browser modes.
+ *
+ * Skills talk to {@link BrowserSession} only. They must never deal with
+ * Chrome process flags, profile directories, CDP endpoints, tab-group IDs,
+ * or focus behavior directly — that translation lives in
+ * `BrowserSessionManager` (see `session-manager.ts`).
+ *
+ * Spec sections: 1 (core architecture), 2 (persistent metadata),
+ * 6 (skill-owned auth detection), 8 (execution modes), 21 (capabilities),
+ * 23 (status UX).
+ */
+/**
+ * Thrown by skill-level auth verifiers when a page needs a human
+ * (sign-in, 2FA, passkey, CAPTCHA, SSO). The browser subsystem catches this
+ * and moves the Persistent session into reauthentication; skills define the
+ * destination URL and the authenticated/challenge checks.
+ */
+export class BrowserAuthRequired extends Error {
+    provider;
+    url;
+    constructor(options) {
+        super(options.message ?? `Authentication required (provider: ${options.provider})`);
+        this.name = 'BrowserAuthRequired';
+        this.provider = options.provider;
+        this.url = options.url;
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAwCH;;;;;GAKG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACnC,QAAQ,CAAQ;IAChB,GAAG,CAAS;IAErB,YAAY,OAA6D;QACvE,KAAK,CAAC,OAAO,CAAC,OAAO,IAAI,sCAAsC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;QACnF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;QACjC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAA;QAChC,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAA;IACxB,CAAC;CACF"}

package/dist/setup-flow.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Persistent bootstrap and reauthentication flows (spec sections 3 and 7).
+ *
+ * Bootstrap (first run): launch a real headed Chrome on the Pi profile with
+ * no MCP/Puppeteer/CDP — an ordinary manually launched browser. The user
+ * signs into Chrome/Google and any sites, completes 2FA/passkeys/SSO, then
+ * closes the window. Close means SETUP_HEADFUL → READY; it initializes the
+ * *profile*, it does not prove every site is authenticated (auth stays
+ * site-specific, verified by skill-level verifiers).
+ *
+ * Reauthentication: when a skill raises BrowserAuthRequired, shut the
+ * headless backend down cleanly, then reauth in one of two variants:
+ * - Variant B (default): Pi-owned headed Chrome *with* CDP, so Pi can
+ *   navigate to the login page before handing control to the user.
+ * - Variant A (fallback): plain headed Chrome with no MCP/CDP, for login
+ *   providers that reject instrumented browsers.
+ * Afterwards the backend restarts headless and automation resumes.
+ *
+ * Launchers are injectable so the orchestration is unit-testable.
+ */
+import type { PersistentBackend } from './persistent-backend.js';
+export type ReauthVariant = 'instrumented' | 'plain';
+export interface SetupFlowEvents {
+    /** Human-facing instruction shown before the setup window opens. */
+    onSetupNeeded?: (message: string) => void;
+    /** Fired when the setup browser exits and the profile is marked ready. */
+    onSetupComplete?: (profileDir: string) => void;
+    onReauthNeeded?: (message: string) => void;
+    onReauthComplete?: (profileDir: string) => void;
+}
+export declare const SETUP_INSTRUCTIONS: string;
+export declare function reauthInstructions(url: string, variant: ReauthVariant): string;
+/**
+ * First-run bootstrap. Holds no locks itself — the caller (browser_setup
+ * tool) must ensure no backend is running on the profile. Resolves with the
+ * window exit code after marking the profile initialized.
+ */
+export declare function runBootstrap(options: {
+    profileDir?: string;
+    executablePath?: string;
+    chromeArgs?: string[];
+    launch?: (options: {
+        userDataDir: string;
+        profileDirectory?: string;
+        executablePath?: string;
+        chromeArgs?: string[];
+    }) => Promise<number | null>;
+}, events?: SetupFlowEvents): Promise<number | null>;
+export interface ReauthOptions {
+    backend: PersistentBackend;
+    /** Page that needs auth (used for messaging + Variant B navigation hint). */
+    url: string;
+    variant?: ReauthVariant;
+    /** Plain-variant launcher (no CDP). Defaults to launchSetupBrowser. */
+    launchPlain?: (options: {
+        userDataDir: string;
+        profileDirectory?: string;
+        executablePath?: string;
+        chromeArgs?: string[];
+    }) => Promise<number | null>;
+    /** Restart the backend headed/headless (Variant B + resume). */
+    restartBackend?: (headed: boolean) => Promise<unknown>;
+    events?: SetupFlowEvents;
+}
+/**
+ * Run reauthentication against a stopped backend: the caller must have
+ * already shut the headless backend down (or pass a backend whose
+ * restartBackend handles it). Variant B restarts headed with CDP and leaves
+ * the headed backend running for the handoff; Variant A opens a plain window
+ * and waits for close. Returns the user-facing instruction to relay.
+ */
+export declare function runReauth(options: ReauthOptions): Promise<string>;
+/**
+ * Resume headless automation after reauth: restart the backend headless.
+ * Returns true when the backend reports running afterwards.
+ */
+export declare function resumeHeadless(backend: PersistentBackend): Promise<boolean>;
+//# sourceMappingURL=setup-flow.d.ts.map

package/dist/setup-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-flow.d.ts","sourceRoot":"","sources":["../src/setup-flow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAIhE,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,OAAO,CAAA;AAEpD,MAAM,WAAW,eAAe;IAC9B,oEAAoE;IACpE,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IACzC,0EAA0E;IAC1E,eAAe,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9C,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAA;CAChD;AAED,eAAO,MAAM,kBAAkB,QAKnB,CAAA;AAEZ,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAU9E;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE;IACP,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE;QACjB,WAAW,EAAE,MAAM,CAAA;QACnB,gBAAgB,CAAC,EAAE,MAAM,CAAA;QACzB,cAAc,CAAC,EAAE,MAAM,CAAA;QACvB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;KACtB,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;CAC7B,EACD,MAAM,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAexB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,iBAAiB,CAAA;IAC1B,6EAA6E;IAC7E,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE,aAAa,CAAA;IACvB,uEAAuE;IACvE,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE;QACtB,WAAW,EAAE,MAAM,CAAA;QACnB,gBAAgB,CAAC,EAAE,MAAM,CAAA;QACzB,cAAc,CAAC,EAAE,MAAM,CAAA;QACvB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;KACtB,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IAC5B,gEAAgE;IAChE,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACtD,MAAM,CAAC,EAAE,eAAe,CAAA;CACzB;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBvE;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAGjF"}

package/dist/setup-flow.js

@@ -0,0 +1,97 @@
+/**
+ * Persistent bootstrap and reauthentication flows (spec sections 3 and 7).
+ *
+ * Bootstrap (first run): launch a real headed Chrome on the Pi profile with
+ * no MCP/Puppeteer/CDP — an ordinary manually launched browser. The user
+ * signs into Chrome/Google and any sites, completes 2FA/passkeys/SSO, then
+ * closes the window. Close means SETUP_HEADFUL → READY; it initializes the
+ * *profile*, it does not prove every site is authenticated (auth stays
+ * site-specific, verified by skill-level verifiers).
+ *
+ * Reauthentication: when a skill raises BrowserAuthRequired, shut the
+ * headless backend down cleanly, then reauth in one of two variants:
+ * - Variant B (default): Pi-owned headed Chrome *with* CDP, so Pi can
+ *   navigate to the login page before handing control to the user.
+ * - Variant A (fallback): plain headed Chrome with no MCP/CDP, for login
+ *   providers that reject instrumented browsers.
+ * Afterwards the backend restarts headless and automation resumes.
+ *
+ * Launchers are injectable so the orchestration is unit-testable.
+ */
+import { launchChrome, launchSetupBrowser } from './chrome-launcher.js';
+import { ensureNamedProfile, PI_PROFILE_NAME } from './named-profile.js';
+import { markBootstrapped } from './persistent-store.js';
+import { DEFAULT_PROFILE_DIR } from './config.js';
+export const SETUP_INSTRUCTIONS = [
+    'Set up Pi Browser',
+    '',
+    'Sign into Google and any websites you want Pi to use.',
+    "When you're finished, close the Pi Browser window.",
+].join('\n');
+export function reauthInstructions(url, variant) {
+    const base = variant === 'plain'
+        ? 'a plain browser window just opened (no automation attached)'
+        : 'a browser window just opened on the Pi profile';
+    return [
+        `Pi needs you to verify your account for ${url}: ${base}.`,
+        'Complete the sign-in / verification step in that window.',
+        'When you are done, close the window (plain variant) or tell the agent to continue.',
+    ].join('\n');
+}
+/**
+ * First-run bootstrap. Holds no locks itself — the caller (browser_setup
+ * tool) must ensure no backend is running on the profile. Resolves with the
+ * window exit code after marking the profile initialized.
+ */
+export async function runBootstrap(options, events) {
+    const profileDir = options.profileDir ?? DEFAULT_PROFILE_DIR;
+    events?.onSetupNeeded?.(SETUP_INSTRUCTIONS);
+    // Same named identity automation uses: sign in here, automate there.
+    ensureNamedProfile(profileDir);
+    const launch = options.launch ?? launchSetupBrowser;
+    const code = await launch({
+        userDataDir: profileDir,
+        profileDirectory: PI_PROFILE_NAME,
+        executablePath: options.executablePath,
+        chromeArgs: options.chromeArgs,
+    });
+    markBootstrapped(profileDir);
+    events?.onSetupComplete?.(profileDir);
+    return code;
+}
+/**
+ * Run reauthentication against a stopped backend: the caller must have
+ * already shut the headless backend down (or pass a backend whose
+ * restartBackend handles it). Variant B restarts headed with CDP and leaves
+ * the headed backend running for the handoff; Variant A opens a plain window
+ * and waits for close. Returns the user-facing instruction to relay.
+ */
+export async function runReauth(options) {
+    const variant = options.variant ?? 'instrumented';
+    const profileDir = options.backend.profileDir?.() ?? DEFAULT_PROFILE_DIR;
+    const message = reauthInstructions(options.url, variant);
+    options.events?.onReauthNeeded?.(message);
+    if (variant === 'plain') {
+        const launch = options.launchPlain ?? launchSetupBrowser;
+        await launch({ userDataDir: profileDir, profileDirectory: PI_PROFILE_NAME });
+    }
+    else {
+        if (options.restartBackend) {
+            await options.restartBackend(true);
+        }
+        else {
+            await options.backend.restart(true);
+        }
+    }
+    options.events?.onReauthComplete?.(profileDir);
+    return message;
+}
+/**
+ * Resume headless automation after reauth: restart the backend headless.
+ * Returns true when the backend reports running afterwards.
+ */
+export async function resumeHeadless(backend) {
+    await backend.restart(false);
+    return backend.running();
+}
+//# sourceMappingURL=setup-flow.js.map

package/dist/setup-flow.js.map

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