@tangle-network/browser-agent-driver 0.6.0

package/dist/multi-actor.js

@@ -0,0 +1,192 @@
+/**
+ * Multi-Actor Session — coordinated multi-user browser testing
+ *
+ * Each actor gets an isolated BrowserContext (separate cookies, localStorage,
+ * auth state) while sharing the same Browser instance. Consumers orchestrate
+ * with standard async/await for sequential flows and Promise.all() for parallel.
+ *
+ * ```typescript
+ * const session = await MultiActorSession.create(browser, {
+ *   actors: {
+ *     admin:   { storageState: '.auth/admin.json' },
+ *     partner: { storageState: '.auth/partner.json' },
+ *     user1:   {},
+ *   },
+ *   agentConfig: { model: 'gpt-4o', vision: true },
+ * });
+ *
+ * await session.actor('admin').run({ goal: 'Create quest', startUrl: '/admin' });
+ * await session.actor('partner').run({ goal: 'Approve quest' });
+ *
+ * await session.parallel(
+ *   ['user1', { goal: 'Start quest' }],
+ *   ['admin', { goal: 'Monitor dashboard' }],
+ * );
+ *
+ * await session.close();
+ * ```
+ */
+import { PlaywrightDriver } from './drivers/playwright.js';
+import { AgentRunner } from './runner.js';
+// ── Actor ──
+export class Actor {
+    name;
+    _context;
+    _page;
+    _driver;
+    _runner;
+    _results = [];
+    constructor(name, _context, _page, _driver, _runner) {
+        this.name = name;
+        this._context = _context;
+        this._page = _page;
+        this._driver = _driver;
+        this._runner = _runner;
+    }
+    /** Run a scenario with this actor's agent. Results accumulate across calls. */
+    async run(scenario) {
+        const result = await this._runner.run(scenario);
+        this._results.push(result);
+        return result;
+    }
+    /** Raw Playwright page for direct operations / assertions */
+    get page() {
+        return this._page;
+    }
+    /** BrowserContext for cookie/storage inspection */
+    get context() {
+        return this._context;
+    }
+    /** PlaywrightDriver for low-level driver access */
+    get driver() {
+        return this._driver;
+    }
+    /** All results from this actor's runs */
+    get results() {
+        return this._results;
+    }
+    /** Most recent result, or undefined if no runs yet */
+    get lastResult() {
+        return this._results[this._results.length - 1];
+    }
+}
+// ── MultiActorSession ──
+export class MultiActorSession {
+    _actors;
+    _closed = false;
+    constructor(actors) {
+        this._actors = actors;
+    }
+    /**
+     * Create a session with isolated browser contexts per actor.
+     *
+     * 1. Creates BrowserContext + Page + PlaywrightDriver + AgentRunner per actor
+     * 2. Calls setup() hooks if provided
+     * 3. Returns session ready for orchestration
+     */
+    static async create(browser, config) {
+        const actors = new Map();
+        const createdContexts = [];
+        try {
+            for (const [name, actorCfg] of Object.entries(config.actors)) {
+                // Merge shared + per-actor agent config
+                const mergedAgentConfig = {
+                    ...config.agentConfig,
+                    ...actorCfg.agentConfig,
+                };
+                // Build context options with storageState
+                const contextOptions = {
+                    ...actorCfg.contextOptions,
+                };
+                if (actorCfg.storageState) {
+                    contextOptions.storageState = actorCfg.storageState;
+                }
+                const context = await browser.newContext(contextOptions);
+                createdContexts.push(context);
+                const page = await context.newPage();
+                const driver = new PlaywrightDriver(page, actorCfg.driverOptions);
+                // Wire onTurn to prefix with actor name
+                const onTurn = config.onTurn
+                    ? (turn) => config.onTurn(name, turn)
+                    : undefined;
+                const runnerOpts = {
+                    driver,
+                    config: mergedAgentConfig,
+                    onTurn,
+                    projectStore: config.projectStore,
+                };
+                const runner = new AgentRunner(runnerOpts);
+                // Run actor setup hook (e.g., manual login flow)
+                if (actorCfg.setup) {
+                    await actorCfg.setup(page);
+                }
+                actors.set(name, new Actor(name, context, page, driver, runner));
+            }
+        }
+        catch (err) {
+            // Clean up already-created contexts on partial failure
+            for (const ctx of createdContexts) {
+                await ctx.close().catch(() => { });
+            }
+            throw err;
+        }
+        return new MultiActorSession(actors);
+    }
+    /** Get an actor by name. Throws with available names on miss. */
+    actor(name) {
+        const a = this._actors.get(name);
+        if (!a) {
+            const available = [...this._actors.keys()].join(', ');
+            throw new Error(`Actor "${name}" not found. Available actors: ${available}`);
+        }
+        return a;
+    }
+    /**
+     * Run multiple actors in parallel. Returns a Map of actor name → result.
+     *
+     * If any actor fails (throws), all results collected so far are still
+     * available via each actor's `.results` array.
+     */
+    async parallel(...tasks) {
+        const entries = await Promise.all(tasks.map(async ([name, scenario]) => {
+            const result = await this.actor(name).run(scenario);
+            return [name, result];
+        }));
+        return new Map(entries);
+    }
+    /** Close all browser contexts. Pages close with their contexts. */
+    async close() {
+        if (this._closed)
+            return;
+        this._closed = true;
+        const errors = [];
+        for (const actor of this._actors.values()) {
+            try {
+                await actor.context.close();
+            }
+            catch (err) {
+                errors.push(err instanceof Error ? err : new Error(String(err)));
+            }
+        }
+        if (errors.length > 0) {
+            throw new AggregateError(errors, 'Failed to close some actor contexts');
+        }
+    }
+    /** All results across all actors, keyed by actor name */
+    get results() {
+        const map = new Map();
+        for (const [name, actor] of this._actors) {
+            map.set(name, actor.results);
+        }
+        return map;
+    }
+    /** All actors for iteration */
+    get allActors() {
+        return [...this._actors.values()];
+    }
+    /** Actor names */
+    get actorNames() {
+        return [...this._actors.keys()];
+    }
+}
+//# sourceMappingURL=multi-actor.js.map

package/dist/multi-actor.js.map

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

package/dist/override-pipeline.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Override Pipeline — scored selection of post-decision action overrides.
+ *
+ * Replaces the 11 sequential if-checks in the runner loop with a single
+ * scored pipeline that collects all candidates and picks the highest-scoring one.
+ *
+ * Each OverrideProducer examines the current context and optionally returns
+ * an OverrideCandidate. The pipeline selects the candidate with the highest score.
+ */
+import type { Action, PageState } from './types.js';
+export interface OverrideCandidate {
+    name: string;
+    action: Action;
+    expectedEffect: string;
+    feedback: string;
+    score: number;
+    /** Override prefix tag for the reasoning annotation (e.g. 'POLICY OVERRIDE', 'SCOUT OVERRIDE') */
+    reasoningTag: string;
+}
+export interface OverrideContext {
+    state: PageState;
+    goal: string;
+    allowedDomains?: string[];
+    action: Action;
+    visibleLinkMatch?: {
+        ref: string;
+        text: string;
+        score: number;
+    };
+    scoutLinkRecommendation?: {
+        ref: string;
+        text: string;
+        confidence: number;
+        reasoning: string;
+    };
+    branchLinkRecommendation?: {
+        ref: string;
+        text: string;
+        confidence: number;
+        reasoning: string;
+    };
+    aiTanglePartnerCompletion?: {
+        result: string;
+        feedback: string;
+    };
+    aiTangleOutputCompletion?: {
+        result: string;
+        feedback: string;
+    };
+}
+/** Each override function returns a candidate or undefined */
+export type OverrideProducer = (ctx: OverrideContext) => OverrideCandidate | undefined;
+/**
+ * Collect all candidates from the registered producers and pick the highest-scoring one.
+ */
+export declare function runOverridePipeline(ctx: OverrideContext, producers: OverrideProducer[]): OverrideCandidate | undefined;
+//# sourceMappingURL=override-pipeline.d.ts.map

package/dist/override-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"override-pipeline.d.ts","sourceRoot":"","sources":["../src/override-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,kGAAkG;IAClG,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,uBAAuB,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/F,wBAAwB,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAChG,yBAAyB,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,wBAAwB,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CACjE;AAED,8DAA8D;AAC9D,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,eAAe,KAAK,iBAAiB,GAAG,SAAS,CAAC;AAEvF;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,eAAe,EACpB,SAAS,EAAE,gBAAgB,EAAE,GAC5B,iBAAiB,GAAG,SAAS,CAa/B"}

package/dist/override-pipeline.js

@@ -0,0 +1,26 @@
+/**
+ * Override Pipeline — scored selection of post-decision action overrides.
+ *
+ * Replaces the 11 sequential if-checks in the runner loop with a single
+ * scored pipeline that collects all candidates and picks the highest-scoring one.
+ *
+ * Each OverrideProducer examines the current context and optionally returns
+ * an OverrideCandidate. The pipeline selects the candidate with the highest score.
+ */
+/**
+ * Collect all candidates from the registered producers and pick the highest-scoring one.
+ */
+export function runOverridePipeline(ctx, producers) {
+    const candidates = [];
+    for (const producer of producers) {
+        const candidate = producer(ctx);
+        if (candidate)
+            candidates.push(candidate);
+    }
+    if (candidates.length === 0)
+        return undefined;
+    // Sort by score descending, return highest
+    candidates.sort((a, b) => b.score - a.score);
+    return candidates[0];
+}
+//# sourceMappingURL=override-pipeline.js.map

package/dist/override-pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"override-pipeline.js","sourceRoot":"","sources":["../src/override-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA6BH;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,GAAoB,EACpB,SAA6B;IAE7B,MAAM,UAAU,GAAwB,EAAE,CAAC;IAE3C,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,SAAS;YAAE,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAE9C,2CAA2C;IAC3C,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAC7C,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC"}

package/dist/personas.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Persona directive templates for richer, product-realistic user-flow goals.
+ * These directives are appended to the task goal before LLM planning.
+ */
+export declare const PERSONA_IDS: readonly ["alice-blueprint-builder", "auto"];
+export type PersonaId = (typeof PERSONA_IDS)[number];
+export interface PersonaDirectiveInput {
+    persona: PersonaId;
+    goal: string;
+    startUrl?: string;
+}
+export declare function getPersonaDirective(persona: PersonaId, context?: {
+    goal: string;
+    startUrl?: string;
+}): string;
+export declare function withPersonaDirective(input: PersonaDirectiveInput): string;
+export declare function isPersonaId(value: string): value is PersonaId;
+export declare function listPersonaIds(): readonly PersonaId[];
+//# sourceMappingURL=personas.d.ts.map

package/dist/personas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"personas.d.ts","sourceRoot":"","sources":["../src/personas.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,WAAW,8CAA+C,CAAC;AAExE,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAGrD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,SAAS,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAqED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAK7G;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAGzE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,SAAS,CAE7D;AAED,wBAAgB,cAAc,IAAI,SAAS,SAAS,EAAE,CAErD"}

package/dist/personas.js

@@ -0,0 +1,86 @@
+/**
+ * Persona directive templates for richer, product-realistic user-flow goals.
+ * These directives are appended to the task goal before LLM planning.
+ */
+export const PERSONA_IDS = ['alice-blueprint-builder', 'auto'];
+const BUILTIN_PERSONA_DIRECTIVES = {
+    'alice-blueprint-builder': [
+        'Persona: Alice (technical product engineer) using the Tangle Blueprint Agent app to deliver real work.',
+        'Alice objective: create a meaningful project (not a toy prompt), with a Coinbase-oriented implementation path, then verify usable output.',
+        'Behavior policy: think proactively, adapt to blockers, and navigate like an experienced user.',
+        'Navigation heuristics:',
+        '- Find key product routes and controls (dashboard, new project, settings, model/provider configuration, run/preview).',
+        '- When needed, discover partner templates/routes, especially /partner/coinbase, /partner/succinct, /partner/tangle.',
+        '- If routes are not directly visible, inspect home cards, nav/sidebar links, profile menu, and settings pages.',
+        'Adaptive obstacle handling:',
+        '- If a project limit/quota blocks progress, open management, clean up stale projects, and continue.',
+        '- If auth, modal, or permission blockers appear, resolve them before resuming the primary goal.',
+        'Completion criteria:',
+        '- A substantive technical prompt is submitted to the target project flow.',
+        '- The project/run reaches a usable state (preview/build/chat response visible).',
+        '- Final state is verified with concrete evidence from the UI (URL, visible output, and key status).',
+    ].join('\n'),
+};
+function buildAutoDirective(goal, startUrl) {
+    const context = `${goal} ${startUrl ?? ''}`.toLowerCase();
+    const isTangleContext = context.includes('ai.tangle.tools') || context.includes('blueprint') || context.includes('/partner/');
+    const partnerRoutes = [];
+    if (context.includes('coinbase'))
+        partnerRoutes.push('/partner/coinbase');
+    if (context.includes('succinct'))
+        partnerRoutes.push('/partner/succinct');
+    if (context.includes('tangle'))
+        partnerRoutes.push('/partner/tangle');
+    if (partnerRoutes.length === 0 && startUrl?.includes('ai.tangle.tools')) {
+        partnerRoutes.push('/partner/coinbase', '/partner/succinct', '/partner/tangle');
+    }
+    if (isTangleContext) {
+        const routeHint = partnerRoutes.length > 0
+            ? `- Check partner/template routes likely relevant to this task: ${partnerRoutes.join(', ')}.`
+            : '- Discover available templates/routes via home cards, sidebar, and profile/settings menus.';
+        return [
+            'Persona: Adaptive product operator (senior technical IC + product mindset) focused on completing realistic end-to-end outcomes.',
+            `Primary objective: ${goal}`,
+            'Behavior policy: think proactively, adapt to blockers, and prefer high-signal actions over repetitive retries.',
+            'Navigation heuristics:',
+            '- Map the app quickly: dashboard/list views, create flow, settings, model/provider configuration, run/preview views.',
+            routeHint,
+            'Adaptive obstacle handling:',
+            '- If limits, auth prompts, or modals block progress, resolve the blocker first and then resume the main goal.',
+            '- If a route/control fails, try an adjacent route path or alternate entry point before repeating the same action.',
+            'Completion criteria:',
+            '- A substantive, user-valuable flow is completed (not toy chatter).',
+            '- The outcome is verified with concrete UI evidence (URL, visible state, run/preview artifact).',
+        ].join('\n');
+    }
+    return [
+        'Persona: Adaptive web operator focused on completing tasks reliably on arbitrary websites.',
+        `Primary objective: ${goal}`,
+        'Behavior policy: prefer direct progress and concise actions over broad exploration.',
+        'Navigation heuristics:',
+        '- Use the site’s own navigation and search first; follow high-signal links that match the requested outcome.',
+        '- Avoid app-specific assumptions about routes or settings unless explicitly visible in the current site.',
+        'Adaptive obstacle handling:',
+        '- If blocked by auth/paywall/captcha or unavailable content, capture concrete evidence and try one adjacent strategy.',
+        '- Do not loop on the same failing interaction; switch approach quickly.',
+        'Completion criteria:',
+        '- Return the requested data/result with concrete evidence (URL + visible text/state).',
+    ].join('\n');
+}
+export function getPersonaDirective(persona, context) {
+    if (persona === 'auto') {
+        return buildAutoDirective(context?.goal ?? 'Complete the requested user flow', context?.startUrl);
+    }
+    return BUILTIN_PERSONA_DIRECTIVES[persona];
+}
+export function withPersonaDirective(input) {
+    const directive = getPersonaDirective(input.persona, { goal: input.goal, startUrl: input.startUrl });
+    return `${input.goal}\n\n${directive}`;
+}
+export function isPersonaId(value) {
+    return PERSONA_IDS.includes(value);
+}
+export function listPersonaIds() {
+    return PERSONA_IDS;
+}
+//# sourceMappingURL=personas.js.map

package/dist/personas.js.map

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

package/dist/preview.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Preview App Verification — navigate outside the sandbox iframe
+ * to verify the generated app actually works.
+ *
+ * The preview is rendered in an iframe (title="Preview") that has
+ * sandbox restrictions. This utility extracts the preview URL,
+ * navigates Playwright directly to it, captures the a11y tree + screenshot,
+ * and checks for errors.
+ */
+import type { Page } from 'playwright';
+import { AriaSnapshotHelper } from './drivers/snapshot.js';
+import type { PreviewVerification } from './types.js';
+/**
+ * Verify the preview app by navigating directly to the preview URL.
+ *
+ * Steps:
+ * 1. Extract preview URL from the iframe
+ * 2. Navigate Playwright to the preview URL (bypasses sandbox)
+ * 3. Capture a11y tree + screenshot + errors
+ * 4. Navigate back to the original page
+ *
+ * Returns null if no preview iframe is found.
+ */
+export declare function verifyPreview(page: Page, snapshot: AriaSnapshotHelper, options?: {
+    captureScreenshot?: boolean;
+    screenshotQuality?: number;
+    /** Explicit preview URL — skips iframe extraction */
+    previewUrl?: string;
+    /** Custom iframe selector (default: 'iframe[title="Preview"]') */
+    iframeSelector?: string;
+}): Promise<PreviewVerification | null>;
+//# sourceMappingURL=preview.d.ts.map

package/dist/preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../src/preview.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AA8BtD;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,CAAC,EAAE;IACR,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GACA,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAuGrC"}

package/dist/preview.js

@@ -0,0 +1,138 @@
+/**
+ * Preview App Verification — navigate outside the sandbox iframe
+ * to verify the generated app actually works.
+ *
+ * The preview is rendered in an iframe (title="Preview") that has
+ * sandbox restrictions. This utility extracts the preview URL,
+ * navigates Playwright directly to it, captures the a11y tree + screenshot,
+ * and checks for errors.
+ */
+/**
+ * Extract the preview iframe URL from the current page.
+ * Returns null if no preview iframe is found.
+ */
+async function extractPreviewUrl(page, customSelector) {
+    const sel = customSelector;
+    return page.evaluate(([selector]) => {
+        // Try custom selector first, then default pattern
+        if (selector) {
+            const el = document.querySelector(selector);
+            if (el?.src)
+                return el.src;
+        }
+        // Look for iframe with title="Preview" (bolt/blueprint pattern)
+        const iframe = document.querySelector('iframe[title="Preview"]');
+        if (iframe?.src)
+            return iframe.src;
+        // Fallback: any iframe with a src URL (works for any embedded app)
+        const iframes = document.querySelectorAll('iframe[src]');
+        for (const f of iframes) {
+            const src = f.src;
+            if (src && !src.startsWith('about:') && !src.startsWith('javascript:'))
+                return src;
+        }
+        return null;
+    }, [sel]);
+}
+/**
+ * Verify the preview app by navigating directly to the preview URL.
+ *
+ * Steps:
+ * 1. Extract preview URL from the iframe
+ * 2. Navigate Playwright to the preview URL (bypasses sandbox)
+ * 3. Capture a11y tree + screenshot + errors
+ * 4. Navigate back to the original page
+ *
+ * Returns null if no preview iframe is found.
+ */
+export async function verifyPreview(page, snapshot, options) {
+    const previewUrl = options?.previewUrl ?? await extractPreviewUrl(page, options?.iframeSelector);
+    if (!previewUrl)
+        return null;
+    const originalUrl = page.url();
+    try {
+        // Navigate directly to the preview app
+        await page.goto(previewUrl, { timeout: 15_000, waitUntil: 'domcontentloaded' });
+        // Wait for page to fully load, then brief settle delay
+        await page.waitForFunction(() => document.readyState === 'complete', { timeout: 10_000 }).catch(() => { });
+        await page.waitForTimeout(500);
+        const title = await page.title();
+        // Capture a11y tree
+        snapshot.reset();
+        const snapshotText = await snapshot.buildSnapshot(page);
+        // Check for visible errors
+        const errors = await page.evaluate(() => {
+            const found = [];
+            /** Check if element is rendered (handles position:fixed where offsetParent is null) */
+            function isVisible(el) {
+                const rect = el.getBoundingClientRect();
+                return rect.width > 0 && rect.height > 0;
+            }
+            // Check for standard error indicators
+            const errorSelectors = ['[role="alert"]', 'pre.error'];
+            for (const sel of errorSelectors) {
+                const el = document.querySelector(sel);
+                if (el && el instanceof HTMLElement && isVisible(el)) {
+                    const text = (el.textContent || '').trim().slice(0, 200);
+                    if (text)
+                        found.push(text);
+                }
+            }
+            // Vite error overlay uses a custom element with Shadow DOM —
+            // textContent is empty, so just detect its presence
+            const viteOverlay = document.querySelector('vite-error-overlay');
+            if (viteOverlay) {
+                // Try to read from shadow root if open
+                const shadowText = viteOverlay.shadowRoot?.querySelector('.message')?.textContent?.trim();
+                found.push(shadowText?.slice(0, 200) || 'Vite error overlay detected');
+            }
+            // Check for blank page — exclude script-only pages (SPA shells before hydration)
+            const body = document.body;
+            if (body) {
+                const hasVisibleChildren = Array.from(body.children).some((child) => child.tagName !== 'SCRIPT' && child.tagName !== 'LINK' &&
+                    child instanceof HTMLElement && isVisible(child));
+                if (!hasVisibleChildren && body.innerText.trim().length === 0) {
+                    found.push('Page appears blank — no visible content rendered');
+                }
+            }
+            return found;
+        });
+        // Capture screenshot if requested
+        let screenshot;
+        if (options?.captureScreenshot !== false) {
+            const quality = options?.screenshotQuality ?? 50;
+            const buf = await page.screenshot({ type: 'jpeg', quality });
+            screenshot = buf.toString('base64');
+        }
+        const appLoaded = errors.length === 0 && snapshotText !== '(empty page)';
+        const result = {
+            previewUrl,
+            appLoaded,
+            title,
+            snapshot: snapshotText,
+            screenshot,
+            errors,
+        };
+        // Navigate back to the original page
+        try {
+            await page.goto(originalUrl, { timeout: 15_000, waitUntil: 'domcontentloaded' });
+            await page.waitForTimeout(1000);
+        }
+        catch {
+            // If nav-back fails, report it as an error so the agent knows
+            result.errors.push(`Failed to navigate back to ${originalUrl} — page may be on the preview URL`);
+        }
+        return result;
+    }
+    catch (err) {
+        // If preview navigation itself fails, return a failed result
+        return {
+            previewUrl,
+            appLoaded: false,
+            title: '',
+            snapshot: '(preview navigation failed)',
+            errors: [err instanceof Error ? err.message : String(err)],
+        };
+    }
+}
+//# sourceMappingURL=preview.js.map

package/dist/preview.js.map

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

package/dist/provider-defaults.d.ts

@@ -0,0 +1,6 @@
+export type SupportedProvider = 'openai' | 'anthropic' | 'google' | 'codex-cli' | 'claude-code' | 'sandbox-backend';
+export declare function resolveProviderModelName(provider: SupportedProvider, requestedModel?: string, options?: {
+    sandboxBackendType?: string;
+}): string;
+export declare function resolveProviderApiKey(provider: SupportedProvider, explicitApiKey?: string, env?: NodeJS.ProcessEnv): string | undefined;
+//# sourceMappingURL=provider-defaults.d.ts.map

package/dist/provider-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-defaults.d.ts","sourceRoot":"","sources":["../src/provider-defaults.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GACzB,QAAQ,GACR,WAAW,GACX,QAAQ,GACR,WAAW,GACX,aAAa,GACb,iBAAiB,CAAC;AAEtB,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,iBAAiB,EAC3B,cAAc,CAAC,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE;IACR,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,GACA,MAAM,CAwBR;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,iBAAiB,EAC3B,cAAc,CAAC,EAAE,MAAM,EACvB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,GAAG,SAAS,CAgBpB"}

package/dist/provider-defaults.js

@@ -0,0 +1,40 @@
+export function resolveProviderModelName(provider, requestedModel, options) {
+    const model = requestedModel?.trim();
+    if (provider === 'claude-code') {
+        if (!model || /^gpt-5(?:[.-]|$)/i.test(model)) {
+            return 'sonnet';
+        }
+    }
+    if (provider === 'sandbox-backend') {
+        const backendType = (options?.sandboxBackendType || process.env.SANDBOX_BACKEND_TYPE || '').trim().toLowerCase();
+        if (backendType === 'claude-code') {
+            if (!model || /^gpt-5(?:[.-]|$)/i.test(model)) {
+                return 'sonnet';
+            }
+        }
+        if (backendType === 'codex') {
+            if (!model) {
+                return 'gpt-5';
+            }
+        }
+    }
+    return model || 'gpt-5.4';
+}
+export function resolveProviderApiKey(provider, explicitApiKey, env = process.env) {
+    if (explicitApiKey)
+        return explicitApiKey;
+    switch (provider) {
+        case 'anthropic':
+        case 'claude-code':
+            return env.ANTHROPIC_API_KEY;
+        case 'sandbox-backend':
+            return undefined;
+        case 'google':
+            return env.GOOGLE_GENERATIVE_AI_API_KEY || env.GEMINI_API_KEY;
+        case 'codex-cli':
+        case 'openai':
+        default:
+            return env.OPENAI_API_KEY;
+    }
+}
+//# sourceMappingURL=provider-defaults.js.map

package/dist/provider-defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-defaults.js","sourceRoot":"","sources":["../src/provider-defaults.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,wBAAwB,CACtC,QAA2B,EAC3B,cAAuB,EACvB,OAEC;IAED,MAAM,KAAK,GAAG,cAAc,EAAE,IAAI,EAAE,CAAC;IAErC,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;QAC/B,IAAI,CAAC,KAAK,IAAI,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9C,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,KAAK,iBAAiB,EAAE,CAAC;QACnC,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,kBAAkB,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACjH,IAAI,WAAW,KAAK,aAAa,EAAE,CAAC;YAClC,IAAI,CAAC,KAAK,IAAI,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9C,OAAO,QAAQ,CAAC;YAClB,CAAC;QACH,CAAC;QACD,IAAI,WAAW,KAAK,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,OAAO,CAAC;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,IAAI,SAAS,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,QAA2B,EAC3B,cAAuB,EACvB,MAAyB,OAAO,CAAC,GAAG;IAEpC,IAAI,cAAc;QAAE,OAAO,cAAc,CAAC;IAE1C,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,WAAW,CAAC;QACjB,KAAK,aAAa;YAChB,OAAO,GAAG,CAAC,iBAAiB,CAAC;QAC/B,KAAK,iBAAiB;YACpB,OAAO,SAAS,CAAC;QACnB,KAAK,QAAQ;YACX,OAAO,GAAG,CAAC,4BAA4B,IAAI,GAAG,CAAC,cAAc,CAAC;QAChE,KAAK,WAAW,CAAC;QACjB,KAAK,QAAQ,CAAC;QACd;YACE,OAAO,GAAG,CAAC,cAAc,CAAC;IAC9B,CAAC;AACH,CAAC"}