cbrowser 8.8.0 → 8.9.1

package/dist/browser.js

@@ -1,17 +1,14 @@
-"use strict";
 /**
  * CBrowser - Main Browser Class
  *
  * AI-powered browser automation with constitutional safety.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FluentCBrowser = exports.CBrowser = void 0;
-const playwright_1 = require("playwright");
-const fs_1 = require("fs");
-const path_1 = require("path");
-const config_js_1 = require("./config.js");
-const personas_js_1 = require("./personas.js");
-const types_js_1 = require("./types.js");
+import { chromium, firefox, webkit } from "playwright";
+import { existsSync, readFileSync, writeFileSync, readdirSync, statSync, unlinkSync, mkdirSync } from "fs";
+import { join } from "path";
+import { mergeConfig, getPaths, ensureDirectories } from "./config.js";
+import { BUILTIN_PERSONAS, getPersona } from "./personas.js";
+import { DEVICE_PRESETS, LOCATION_PRESETS } from "./types.js";
 // Browser-specific fast launch args for performance optimization
 const BROWSER_LAUNCH_ARGS = {
     // Chromium args - reduces cold start time significantly
@@ -44,7 +41,7 @@ const BROWSER_LAUNCH_ARGS = {
 };
 // Legacy alias for backward compatibility
 const FAST_LAUNCH_ARGS = BROWSER_LAUNCH_ARGS.chromium;
-class CBrowser {
+export class CBrowser {
     config;
     paths;
     browser = null;
@@ -57,14 +54,14 @@ class CBrowser {
     isRecordingHar = false;
     skipSessionRestore = false;
     constructor(userConfig = {}) {
-        this.config = (0, config_js_1.mergeConfig)(userConfig);
-        this.paths = (0, config_js_1.ensureDirectories)((0, config_js_1.getPaths)(this.config.dataDir));
+        this.config = mergeConfig(userConfig);
+        this.paths = ensureDirectories(getPaths(this.config.dataDir));
     }
     // =========================================================================
     // Session State Persistence
     // =========================================================================
     get sessionStateFile() {
-        return (0, path_1.join)(this.paths.dataDir, "browser-state", "last-session.json");
+        return join(this.paths.dataDir, "browser-state", "last-session.json");
     }
     saveSessionState(url, viewport) {
         try {
@@ -76,11 +73,11 @@ class CBrowser {
                 timestamp: Date.now(),
                 viewport,
             };
-            const stateDir = (0, path_1.join)(this.paths.dataDir, "browser-state");
-            if (!(0, fs_1.existsSync)(stateDir)) {
-                (0, fs_1.mkdirSync)(stateDir, { recursive: true });
+            const stateDir = join(this.paths.dataDir, "browser-state");
+            if (!existsSync(stateDir)) {
+                mkdirSync(stateDir, { recursive: true });
             }
-            (0, fs_1.writeFileSync)(this.sessionStateFile, JSON.stringify(state, null, 2));
+            writeFileSync(this.sessionStateFile, JSON.stringify(state, null, 2));
         }
         catch (e) {
             // Silently fail - this is a best-effort feature
@@ -88,14 +85,14 @@ class CBrowser {
     }
     loadSessionState() {
         try {
-            if (!(0, fs_1.existsSync)(this.sessionStateFile))
+            if (!existsSync(this.sessionStateFile))
                 return null;
-            const content = (0, fs_1.readFileSync)(this.sessionStateFile, "utf-8");
+            const content = readFileSync(this.sessionStateFile, "utf-8");
             const state = JSON.parse(content);
             // Expire sessions older than 1 hour
             const oneHour = 60 * 60 * 1000;
             if (Date.now() - state.timestamp > oneHour) {
-                (0, fs_1.unlinkSync)(this.sessionStateFile);
+                unlinkSync(this.sessionStateFile);
                 return null;
             }
             return state;
@@ -106,8 +103,8 @@ class CBrowser {
     }
     clearSessionState() {
         try {
-            if ((0, fs_1.existsSync)(this.sessionStateFile)) {
-                (0, fs_1.unlinkSync)(this.sessionStateFile);
+            if (existsSync(this.sessionStateFile)) {
+                unlinkSync(this.sessionStateFile);
             }
         }
         catch (e) {
@@ -125,10 +122,10 @@ class CBrowser {
             return;
         // Select browser engine based on config
         const browserType = this.config.browser === "firefox"
-            ? playwright_1.firefox
+            ? firefox
             : this.config.browser === "webkit"
-                ? playwright_1.webkit
-                : playwright_1.chromium;
+                ? webkit
+                : chromium;
         // Build context options
         const contextOptions = {
             viewport: {
@@ -137,8 +134,8 @@ class CBrowser {
             },
         };
         // Apply device emulation if configured
-        if (this.config.device && types_js_1.DEVICE_PRESETS[this.config.device]) {
-            const device = types_js_1.DEVICE_PRESETS[this.config.device];
+        if (this.config.device && DEVICE_PRESETS[this.config.device]) {
+            const device = DEVICE_PRESETS[this.config.device];
             contextOptions.viewport = device.viewport;
             contextOptions.userAgent = device.userAgent;
             contextOptions.deviceScaleFactor = device.deviceScaleFactor;
@@ -180,9 +177,9 @@ class CBrowser {
         }
         // Enable video recording if configured
         if (this.config.recordVideo) {
-            const videoDir = this.config.videoDir || (0, path_1.join)(this.paths.dataDir, "videos");
-            if (!(0, fs_1.existsSync)(videoDir)) {
-                (0, fs_1.mkdirSync)(videoDir, { recursive: true });
+            const videoDir = this.config.videoDir || join(this.paths.dataDir, "videos");
+            if (!existsSync(videoDir)) {
+                mkdirSync(videoDir, { recursive: true });
             }
             contextOptions.recordVideo = {
                 dir: videoDir,
@@ -196,9 +193,9 @@ class CBrowser {
         // Use browser-specific launch args for optimal performance
         const launchArgs = BROWSER_LAUNCH_ARGS[this.config.browser];
         if (this.config.persistent) {
-            const browserStateDir = (0, path_1.join)(this.paths.dataDir, "browser-state");
-            if (!(0, fs_1.existsSync)(browserStateDir)) {
-                (0, fs_1.mkdirSync)(browserStateDir, { recursive: true });
+            const browserStateDir = join(this.paths.dataDir, "browser-state");
+            if (!existsSync(browserStateDir)) {
+                mkdirSync(browserStateDir, { recursive: true });
             }
             this.context = await browserType.launchPersistentContext(browserStateDir, {
                 headless: this.config.headless,
@@ -285,11 +282,11 @@ class CBrowser {
         // Clear session state first (to prevent close() from saving)
         this.clearSessionState();
         await this.close();
-        const browserStateDir = (0, path_1.join)(this.paths.dataDir, "browser-state");
-        if ((0, fs_1.existsSync)(browserStateDir)) {
+        const browserStateDir = join(this.paths.dataDir, "browser-state");
+        if (existsSync(browserStateDir)) {
             const { rmSync } = await import("fs");
             rmSync(browserStateDir, { recursive: true, force: true });
-            (0, fs_1.mkdirSync)(browserStateDir, { recursive: true });
+            mkdirSync(browserStateDir, { recursive: true });
         }
         if (this.config.verbose) {
             console.log("🔄 Browser state reset");
@@ -486,12 +483,12 @@ class CBrowser {
             entries: this.harEntries,
         };
         const har = { log: harLog };
-        const harDir = (0, path_1.join)(this.paths.dataDir, "har");
-        if (!(0, fs_1.existsSync)(harDir)) {
-            (0, fs_1.mkdirSync)(harDir, { recursive: true });
+        const harDir = join(this.paths.dataDir, "har");
+        if (!existsSync(harDir)) {
+            mkdirSync(harDir, { recursive: true });
         }
-        const filename = outputPath || (0, path_1.join)(harDir, `har-${Date.now()}.har`);
-        (0, fs_1.writeFileSync)(filename, JSON.stringify(har, null, 2));
+        const filename = outputPath || join(harDir, `har-${Date.now()}.har`);
+        writeFileSync(filename, JSON.stringify(har, null, 2));
         return filename;
     }
     /**
@@ -697,7 +694,7 @@ class CBrowser {
      * Set device emulation (requires browser restart).
      */
     setDevice(deviceName) {
-        if (types_js_1.DEVICE_PRESETS[deviceName]) {
+        if (DEVICE_PRESETS[deviceName]) {
             this.config.device = deviceName;
             return true;
         }
@@ -707,7 +704,7 @@ class CBrowser {
      * List available device presets.
      */
     static listDevices() {
-        return Object.keys(types_js_1.DEVICE_PRESETS);
+        return Object.keys(DEVICE_PRESETS);
     }
     // =========================================================================
     // Geolocation
@@ -717,8 +714,8 @@ class CBrowser {
      */
     setGeolocation(location) {
         if (typeof location === "string") {
-            if (types_js_1.LOCATION_PRESETS[location]) {
-                this.config.geolocation = types_js_1.LOCATION_PRESETS[location];
+            if (LOCATION_PRESETS[location]) {
+                this.config.geolocation = LOCATION_PRESETS[location];
                 return true;
             }
             return false;
@@ -734,9 +731,9 @@ class CBrowser {
             return false;
         let geo;
         if (typeof location === "string") {
-            if (!types_js_1.LOCATION_PRESETS[location])
+            if (!LOCATION_PRESETS[location])
                 return false;
-            geo = types_js_1.LOCATION_PRESETS[location];
+            geo = LOCATION_PRESETS[location];
         }
         else {
             geo = location;
@@ -749,7 +746,7 @@ class CBrowser {
      * List available location presets.
      */
     static listLocations() {
-        return Object.keys(types_js_1.LOCATION_PRESETS);
+        return Object.keys(LOCATION_PRESETS);
     }
     // =========================================================================
     // Navigation
@@ -1372,6 +1369,82 @@ class CBrowser {
         const result = await this.selectCustomDropdownOption(trigger, value, options);
         return result;
     }
+    /**
+     * Find the best click candidate from multiple matches.
+     * Prioritizes: exact text match > non-sticky elements > shorter text (closer match)
+     */
+    async findBestClickCandidate(locator, searchText) {
+        const page = await this.getPage();
+        const count = await locator.count();
+        if (count === 0)
+            return null;
+        if (count === 1)
+            return locator.first();
+        // Score each candidate
+        const candidates = [];
+        const searchLower = searchText.toLowerCase();
+        for (let i = 0; i < count; i++) {
+            const el = locator.nth(i);
+            let score = 0;
+            try {
+                const info = await el.evaluate((element, search) => {
+                    const text = element.textContent?.trim() || '';
+                    const style = getComputedStyle(element);
+                    // Check if element is in a sticky/fixed container
+                    let inStickyContainer = false;
+                    let parent = element;
+                    while (parent) {
+                        const parentStyle = getComputedStyle(parent);
+                        if (parentStyle.position === 'fixed' || parentStyle.position === 'sticky') {
+                            inStickyContainer = true;
+                            break;
+                        }
+                        parent = parent.parentElement;
+                    }
+                    // Check for exact text match vs partial
+                    const textLower = text.toLowerCase();
+                    const isExactMatch = textLower === search.toLowerCase();
+                    const isPartialMatch = textLower.includes(search.toLowerCase());
+                    // Get element role/type info
+                    const tagName = element.tagName.toLowerCase();
+                    const role = element.getAttribute('role');
+                    const isInteractive = ['button', 'a', 'input', 'select'].includes(tagName) ||
+                        ['button', 'link', 'option'].includes(role || '');
+                    return {
+                        text,
+                        textLength: text.length,
+                        inStickyContainer,
+                        isExactMatch,
+                        isPartialMatch,
+                        isInteractive,
+                    };
+                }, searchLower);
+                // Scoring:
+                // +100: exact text match
+                // +50: not in sticky container
+                // +20: is interactive element
+                // -1 per extra character (prefer shorter matches)
+                if (info.isExactMatch)
+                    score += 100;
+                if (!info.inStickyContainer)
+                    score += 50;
+                if (info.isInteractive)
+                    score += 20;
+                score -= Math.abs(info.textLength - searchText.length);
+                candidates.push({ index: i, score });
+            }
+            catch {
+                // If evaluation fails, give low score
+                candidates.push({ index: i, score: -1000 });
+            }
+        }
+        // Sort by score descending and return the best match
+        candidates.sort((a, b) => b.score - a.score);
+        if (candidates.length > 0 && candidates[0].score > -1000) {
+            return locator.nth(candidates[0].index);
+        }
+        return locator.first();
+    }
     /**
      * Hover then click - useful for dropdown menus that need hover to reveal items.
      * ALWAYS hovers the parent menu and keeps it hovered while clicking the submenu item.
@@ -1540,6 +1613,45 @@ class CBrowser {
                     }
                 }
             }
+            // Check if this is a select element - requires selectOption instead of fill
+            const tagName = await element.evaluate((el) => el.tagName.toLowerCase());
+            if (tagName === 'select') {
+                // For select elements, use selectOption
+                // Try to match by label text first, then by value
+                try {
+                    await element.selectOption({ label: value });
+                }
+                catch {
+                    // If label match fails, try value match
+                    try {
+                        await element.selectOption({ value: value });
+                    }
+                    catch {
+                        // Try partial/case-insensitive label match
+                        const options = await element.evaluate((el) => {
+                            const select = el;
+                            return Array.from(select.options).map(o => ({
+                                value: o.value,
+                                text: o.text,
+                            }));
+                        });
+                        const match = options.find(o => o.text.toLowerCase().includes(value.toLowerCase()) ||
+                            o.value.toLowerCase().includes(value.toLowerCase()));
+                        if (match) {
+                            await element.selectOption({ value: match.value });
+                        }
+                        else {
+                            throw new Error(`No option matching "${value}" in select. Available: ${options.map(o => o.text).join(', ')}`);
+                        }
+                    }
+                }
+                this.audit("fill", `${selector} (select)`, "yellow", "success");
+                return {
+                    success: true,
+                    screenshot: await this.screenshot(),
+                    message: `Selected: ${value} in ${selector}`,
+                };
+            }
             // Standard fill - works for visible inputs and textareas
             await element.fill(value);
             this.audit("fill", selector, "yellow", "success");
@@ -2115,7 +2227,7 @@ class CBrowser {
      * Get the selector cache file path.
      */
     getSelectorCachePath() {
-        return (0, path_1.join)(this.paths.dataDir, "selector-cache.json");
+        return join(this.paths.dataDir, "selector-cache.json");
     }
     /**
      * Load the selector cache from disk.
@@ -2124,9 +2236,9 @@ class CBrowser {
         if (this.selectorCache)
             return this.selectorCache;
         const cachePath = this.getSelectorCachePath();
-        if ((0, fs_1.existsSync)(cachePath)) {
+        if (existsSync(cachePath)) {
             try {
-                const data = (0, fs_1.readFileSync)(cachePath, "utf-8");
+                const data = readFileSync(cachePath, "utf-8");
                 this.selectorCache = JSON.parse(data);
                 return this.selectorCache;
             }
@@ -2144,7 +2256,7 @@ class CBrowser {
         if (!this.selectorCache)
             return;
         const cachePath = this.getSelectorCachePath();
-        (0, fs_1.writeFileSync)(cachePath, JSON.stringify(this.selectorCache, null, 2));
+        writeFileSync(cachePath, JSON.stringify(this.selectorCache, null, 2));
     }
     /**
      * Get cache key for a selector (includes domain for context).
@@ -2622,10 +2734,23 @@ class CBrowser {
     /**
      * Get all input fields on the page for verbose output.
      */
+    /**
+     * Get available form inputs on the page, including hidden ones with custom UI triggers.
+     * Public so cognitive journey can use it.
+     */
     async getAvailableInputs(page) {
+        const activePage = page || await this.getPage();
         try {
-            return await page.$$eval('input, textarea, select', els => els.slice(0, 15).map(el => {
+            return await activePage.$$eval('input, textarea, select', els => els.slice(0, 20).map(el => {
                 const input = el;
+                const htmlEl = el;
+                // Check if element is hidden (common with custom dropdowns)
+                const style = window.getComputedStyle(el);
+                const isHidden = style.display === 'none' ||
+                    style.visibility === 'hidden' ||
+                    parseFloat(style.opacity) === 0 ||
+                    htmlEl.offsetWidth === 0 ||
+                    htmlEl.offsetHeight === 0;
                 // Find associated label
                 let label = "";
                 if (input.id) {
@@ -2636,12 +2761,46 @@ class CBrowser {
                 if (!label && input.closest("label")) {
                     label = input.closest("label").innerText?.trim().substring(0, 50) || "";
                 }
+                // For hidden elements, try to find the visible trigger
+                let triggerText = "";
+                if (isHidden) {
+                    // Look for sibling or parent with visible text (custom dropdown trigger)
+                    const parent = el.parentElement;
+                    if (parent) {
+                        const siblings = Array.from(parent.children).filter(c => c !== el);
+                        for (const sib of siblings) {
+                            const sibStyle = window.getComputedStyle(sib);
+                            if (sibStyle.display !== 'none' && sib.innerText?.trim()) {
+                                triggerText = sib.innerText.trim().substring(0, 50);
+                                break;
+                            }
+                        }
+                    }
+                    // Also check for aria-labelledby or data attributes
+                    if (!triggerText) {
+                        const ariaLabel = el.getAttribute('aria-label') || el.getAttribute('aria-labelledby');
+                        if (ariaLabel)
+                            triggerText = ariaLabel.substring(0, 50);
+                    }
+                }
+                // For select elements, get available options
+                let options;
+                if (el.tagName.toLowerCase() === 'select') {
+                    const selectEl = el;
+                    options = Array.from(selectEl.options)
+                        .filter(opt => opt.value && opt.text.trim()) // Skip empty/placeholder options
+                        .slice(0, 10) // Limit to first 10 options
+                        .map(opt => opt.text.trim());
+                }
                 return {
                     selector: input.id ? `#${input.id}` : input.name ? `[name="${input.name}"]` : input.placeholder ? `[placeholder="${input.placeholder}"]` : `${el.tagName.toLowerCase()}`,
                     type: input.type || el.tagName.toLowerCase(),
                     name: input.name || "",
                     placeholder: input.placeholder || "",
                     label,
+                    isHidden,
+                    triggerText,
+                    options,
                 };
             }));
         }
@@ -2706,7 +2865,7 @@ class CBrowser {
             // Take screenshot
             const dir = options.debugDir || this.paths.screenshotsDir;
             const filename = `debug-${Date.now()}.png`;
-            const filepath = (0, path_1.join)(dir, filename);
+            const filepath = join(dir, filename);
             await page.screenshot({ path: filepath, fullPage: false });
             // Clean up highlights
             await page.evaluate(() => {
@@ -2891,10 +3050,30 @@ class CBrowser {
             const [role, name] = selector.slice(5).split("/");
             return page.getByRole(role, { name }).first();
         }
-        // Strategy 3: Text content
-        const byText = page.getByText(selector, { exact: false }).first();
-        if (await byText.count() > 0) {
-            return byText;
+        // Strategy 3: Text content - prefer exact matches over fuzzy, non-sticky over sticky
+        // First, try exact text match
+        const byTextExact = page.getByText(selector, { exact: true });
+        const exactCount = await byTextExact.count();
+        if (exactCount > 0) {
+            // If multiple exact matches, prefer non-sticky elements
+            if (exactCount > 1) {
+                const bestMatch = await this.findBestClickCandidate(byTextExact, selector);
+                if (bestMatch)
+                    return bestMatch;
+            }
+            return byTextExact.first();
+        }
+        // Then try partial/fuzzy text match (but with sticky deprioritization)
+        const byTextFuzzy = page.getByText(selector, { exact: false });
+        const fuzzyCount = await byTextFuzzy.count();
+        if (fuzzyCount > 0) {
+            // If multiple fuzzy matches, prefer non-sticky elements and shorter/exact matches
+            if (fuzzyCount > 1) {
+                const bestMatch = await this.findBestClickCandidate(byTextFuzzy, selector);
+                if (bestMatch)
+                    return bestMatch;
+            }
+            return byTextFuzzy.first();
         }
         // Strategy 4: Placeholder
         const byPlaceholder = page.getByPlaceholder(selector).first();
@@ -3074,7 +3253,7 @@ class CBrowser {
      */
     async screenshot(path) {
         const page = await this.getPage();
-        const filename = path || (0, path_1.join)(this.paths.screenshotsDir, `screenshot-${Date.now()}.png`);
+        const filename = path || join(this.paths.screenshotsDir, `screenshot-${Date.now()}.png`);
         await page.screenshot({ path: filename, fullPage: false });
         return filename;
     }
@@ -3134,18 +3313,18 @@ class CBrowser {
             localStorage,
             sessionStorage,
         };
-        const sessionPath = (0, path_1.join)(this.paths.sessionsDir, `${name}.json`);
-        (0, fs_1.writeFileSync)(sessionPath, JSON.stringify(session, null, 2));
+        const sessionPath = join(this.paths.sessionsDir, `${name}.json`);
+        writeFileSync(sessionPath, JSON.stringify(session, null, 2));
     }
     /**
      * Load a saved session.
      */
     async loadSession(name) {
-        const sessionPath = (0, path_1.join)(this.paths.sessionsDir, `${name}.json`);
-        if (!(0, fs_1.existsSync)(sessionPath)) {
+        const sessionPath = join(this.paths.sessionsDir, `${name}.json`);
+        if (!existsSync(sessionPath)) {
             return { success: false, name, cookiesRestored: 0, localStorageKeysRestored: 0, sessionStorageKeysRestored: 0 };
         }
-        const session = JSON.parse((0, fs_1.readFileSync)(sessionPath, "utf-8"));
+        const session = JSON.parse(readFileSync(sessionPath, "utf-8"));
         const page = await this.getPage();
         const context = this.context;
         const result = {
@@ -3190,29 +3369,29 @@ class CBrowser {
         await page.reload({ waitUntil: "networkidle" });
         // Update lastUsed
         session.lastUsed = new Date().toISOString();
-        (0, fs_1.writeFileSync)(sessionPath, JSON.stringify(session, null, 2));
+        writeFileSync(sessionPath, JSON.stringify(session, null, 2));
         return result;
     }
     /**
      * List all saved session names.
      */
     listSessions() {
-        const files = (0, fs_1.readdirSync)(this.paths.sessionsDir);
+        const files = readdirSync(this.paths.sessionsDir);
         return files.filter((f) => f.endsWith(".json") && f !== "last-session.json").map((f) => f.replace(".json", ""));
     }
     /**
      * List all saved sessions with rich metadata.
      */
     listSessionsDetailed() {
-        const files = (0, fs_1.readdirSync)(this.paths.sessionsDir);
+        const files = readdirSync(this.paths.sessionsDir);
         const sessions = [];
         for (const file of files) {
             if (!file.endsWith(".json") || file === "last-session.json")
                 continue;
-            const filePath = (0, path_1.join)(this.paths.sessionsDir, file);
+            const filePath = join(this.paths.sessionsDir, file);
             try {
-                const data = JSON.parse((0, fs_1.readFileSync)(filePath, "utf-8"));
-                const stats = (0, fs_1.statSync)(filePath);
+                const data = JSON.parse(readFileSync(filePath, "utf-8"));
+                const stats = statSync(filePath);
                 sessions.push({
                     name: data.name || file.replace(".json", ""),
                     created: data.created,
@@ -3235,11 +3414,11 @@ class CBrowser {
      * Get detailed info for a single session.
      */
     getSessionDetails(name) {
-        const sessionPath = (0, path_1.join)(this.paths.sessionsDir, `${name}.json`);
-        if (!(0, fs_1.existsSync)(sessionPath))
+        const sessionPath = join(this.paths.sessionsDir, `${name}.json`);
+        if (!existsSync(sessionPath))
             return null;
         try {
-            return JSON.parse((0, fs_1.readFileSync)(sessionPath, "utf-8"));
+            return JSON.parse(readFileSync(sessionPath, "utf-8"));
         }
         catch {
             return null;
@@ -3249,9 +3428,9 @@ class CBrowser {
      * Delete a saved session.
      */
     deleteSession(name) {
-        const sessionPath = (0, path_1.join)(this.paths.sessionsDir, `${name}.json`);
-        if ((0, fs_1.existsSync)(sessionPath)) {
-            (0, fs_1.unlinkSync)(sessionPath);
+        const sessionPath = join(this.paths.sessionsDir, `${name}.json`);
+        if (existsSync(sessionPath)) {
+            unlinkSync(sessionPath);
             return true;
         }
         return false;
@@ -3263,17 +3442,17 @@ class CBrowser {
         const cutoff = Date.now() - olderThanDays * 24 * 60 * 60 * 1000;
         const deleted = [];
         const kept = [];
-        const files = (0, fs_1.readdirSync)(this.paths.sessionsDir);
+        const files = readdirSync(this.paths.sessionsDir);
         for (const file of files) {
             if (!file.endsWith(".json") || file === "last-session.json")
                 continue;
-            const filePath = (0, path_1.join)(this.paths.sessionsDir, file);
+            const filePath = join(this.paths.sessionsDir, file);
             const name = file.replace(".json", "");
             try {
-                const data = JSON.parse((0, fs_1.readFileSync)(filePath, "utf-8"));
+                const data = JSON.parse(readFileSync(filePath, "utf-8"));
                 const lastUsed = new Date(data.lastUsed).getTime();
                 if (lastUsed < cutoff) {
-                    (0, fs_1.unlinkSync)(filePath);
+                    unlinkSync(filePath);
                     deleted.push(name);
                 }
                 else {
@@ -3290,24 +3469,24 @@ class CBrowser {
      * Export a session to a portable JSON file.
      */
     exportSession(name, outputPath) {
-        const sessionPath = (0, path_1.join)(this.paths.sessionsDir, `${name}.json`);
-        if (!(0, fs_1.existsSync)(sessionPath))
+        const sessionPath = join(this.paths.sessionsDir, `${name}.json`);
+        if (!existsSync(sessionPath))
             return false;
-        const data = (0, fs_1.readFileSync)(sessionPath, "utf-8");
-        (0, fs_1.writeFileSync)(outputPath, data);
+        const data = readFileSync(sessionPath, "utf-8");
+        writeFileSync(outputPath, data);
         return true;
     }
     /**
      * Import a session from a JSON file.
      */
     importSession(inputPath, name) {
-        if (!(0, fs_1.existsSync)(inputPath))
+        if (!existsSync(inputPath))
             return false;
         try {
-            const data = JSON.parse((0, fs_1.readFileSync)(inputPath, "utf-8"));
+            const data = JSON.parse(readFileSync(inputPath, "utf-8"));
             data.name = name;
-            const sessionPath = (0, path_1.join)(this.paths.sessionsDir, `${name}.json`);
-            (0, fs_1.writeFileSync)(sessionPath, JSON.stringify(data, null, 2));
+            const sessionPath = join(this.paths.sessionsDir, `${name}.json`);
+            writeFileSync(sessionPath, JSON.stringify(data, null, 2));
             return true;
         }
         catch {
@@ -3322,7 +3501,7 @@ class CBrowser {
      */
     async journey(options) {
         const { persona: personaName, startUrl, goal, maxSteps = 20 } = options;
-        const persona = (0, personas_js_1.getPersona)(personaName) || personas_js_1.BUILTIN_PERSONAS["first-timer"];
+        const persona = getPersona(personaName) || BUILTIN_PERSONAS["first-timer"];
         this.currentPersona = persona;
         // Set viewport based on persona
         if (persona.context?.viewport) {
@@ -3412,8 +3591,8 @@ class CBrowser {
             consoleLogs,
         };
         // Save journey results
-        const journeyFile = (0, path_1.join)(this.paths.dataDir, `journey-${Date.now()}.json`);
-        (0, fs_1.writeFileSync)(journeyFile, JSON.stringify(result, null, 2));
+        const journeyFile = join(this.paths.dataDir, `journey-${Date.now()}.json`);
+        writeFileSync(journeyFile, JSON.stringify(result, null, 2));
         return result;
     }
     /**
@@ -3470,13 +3649,13 @@ class CBrowser {
             result,
             persona: this.currentPersona?.name,
         };
-        const auditFile = (0, path_1.join)(this.paths.auditDir, `audit-${new Date().toISOString().split("T")[0]}.json`);
+        const auditFile = join(this.paths.auditDir, `audit-${new Date().toISOString().split("T")[0]}.json`);
         let entries = [];
-        if ((0, fs_1.existsSync)(auditFile)) {
-            entries = JSON.parse((0, fs_1.readFileSync)(auditFile, "utf-8"));
+        if (existsSync(auditFile)) {
+            entries = JSON.parse(readFileSync(auditFile, "utf-8"));
         }
         entries.push(entry);
-        (0, fs_1.writeFileSync)(auditFile, JSON.stringify(entries, null, 2));
+        writeFileSync(auditFile, JSON.stringify(entries, null, 2));
     }
     // =========================================================================
     // Cleanup
@@ -3497,22 +3676,22 @@ class CBrowser {
             },
         };
         const cleanDir = (dir, pattern, keep, category) => {
-            if (!(0, fs_1.existsSync)(dir))
+            if (!existsSync(dir))
                 return;
-            const files = (0, fs_1.readdirSync)(dir)
+            const files = readdirSync(dir)
                 .filter((f) => pattern.test(f))
                 .map((f) => ({
                 name: f,
-                path: (0, path_1.join)(dir, f),
-                mtime: (0, fs_1.statSync)((0, path_1.join)(dir, f)).mtime,
-                size: (0, fs_1.statSync)((0, path_1.join)(dir, f)).size,
+                path: join(dir, f),
+                mtime: statSync(join(dir, f)).mtime,
+                size: statSync(join(dir, f)).size,
             }))
                 .sort((a, b) => b.mtime.getTime() - a.mtime.getTime());
             const cutoff = Date.now() - olderThan * 24 * 60 * 60 * 1000;
             const toDelete = files.slice(keep).filter((f) => f.mtime.getTime() < cutoff);
             for (const file of toDelete) {
                 if (!dryRun) {
-                    (0, fs_1.unlinkSync)(file.path);
+                    unlinkSync(file.path);
                 }
                 result.deleted++;
                 result.freedBytes += file.size;
@@ -3532,12 +3711,12 @@ class CBrowser {
     getStorageStats() {
         const stats = {};
         const countDir = (dir, pattern) => {
-            if (!(0, fs_1.existsSync)(dir))
+            if (!existsSync(dir))
                 return { count: 0, size: 0 };
-            const files = (0, fs_1.readdirSync)(dir).filter((f) => pattern.test(f));
+            const files = readdirSync(dir).filter((f) => pattern.test(f));
             let size = 0;
             for (const file of files) {
-                size += (0, fs_1.statSync)((0, path_1.join)(dir, file)).size;
+                size += statSync(join(dir, file)).size;
             }
             return { count: files.length, size };
         };
@@ -3560,12 +3739,12 @@ class CBrowser {
      * Save a visual baseline screenshot.
      */
     async saveBaseline(name, url) {
-        const baselinesDir = (0, path_1.join)(this.paths.dataDir, "baselines");
-        if (!(0, fs_1.existsSync)(baselinesDir)) {
-            (0, fs_1.mkdirSync)(baselinesDir, { recursive: true });
+        const baselinesDir = join(this.paths.dataDir, "baselines");
+        if (!existsSync(baselinesDir)) {
+            mkdirSync(baselinesDir, { recursive: true });
         }
         const page = await this.getPage();
-        const screenshotPath = (0, path_1.join)(baselinesDir, `${name}.png`);
+        const screenshotPath = join(baselinesDir, `${name}.png`);
         await page.screenshot({ path: screenshotPath, fullPage: true });
         const baseline = {
             name,
@@ -3575,25 +3754,25 @@ class CBrowser {
             created: new Date().toISOString(),
             lastUsed: new Date().toISOString(),
         };
-        const metaPath = (0, path_1.join)(baselinesDir, `${name}.json`);
-        (0, fs_1.writeFileSync)(metaPath, JSON.stringify(baseline, null, 2));
+        const metaPath = join(baselinesDir, `${name}.json`);
+        writeFileSync(metaPath, JSON.stringify(baseline, null, 2));
         return screenshotPath;
     }
     /**
      * Compare current page to a baseline.
      */
     async compareBaseline(name, threshold = 0.1) {
-        const baselinesDir = (0, path_1.join)(this.paths.dataDir, "baselines");
-        const metaPath = (0, path_1.join)(baselinesDir, `${name}.json`);
-        if (!(0, fs_1.existsSync)(metaPath)) {
+        const baselinesDir = join(this.paths.dataDir, "baselines");
+        const metaPath = join(baselinesDir, `${name}.json`);
+        if (!existsSync(metaPath)) {
             throw new Error(`Baseline not found: ${name}`);
         }
-        const baseline = JSON.parse((0, fs_1.readFileSync)(metaPath, "utf-8"));
+        const baseline = JSON.parse(readFileSync(metaPath, "utf-8"));
         const page = await this.getPage();
-        const currentPath = (0, path_1.join)(baselinesDir, `${name}-current-${Date.now()}.png`);
+        const currentPath = join(baselinesDir, `${name}-current-${Date.now()}.png`);
         await page.screenshot({ path: currentPath, fullPage: true });
-        const baselineBuffer = (0, fs_1.readFileSync)(baseline.screenshotPath);
-        const currentBuffer = (0, fs_1.readFileSync)(currentPath);
+        const baselineBuffer = readFileSync(baseline.screenshotPath);
+        const currentBuffer = readFileSync(currentPath);
         const sizeDiff = Math.abs(baselineBuffer.length - currentBuffer.length);
         const maxSize = Math.max(baselineBuffer.length, currentBuffer.length);
         const diffPercentage = sizeDiff / maxSize;
@@ -3608,10 +3787,10 @@ class CBrowser {
      * List all visual baselines.
      */
     listBaselines() {
-        const baselinesDir = (0, path_1.join)(this.paths.dataDir, "baselines");
-        if (!(0, fs_1.existsSync)(baselinesDir))
+        const baselinesDir = join(this.paths.dataDir, "baselines");
+        if (!existsSync(baselinesDir))
             return [];
-        return (0, fs_1.readdirSync)(baselinesDir)
+        return readdirSync(baselinesDir)
             .filter(f => f.endsWith(".json"))
             .map(f => f.replace(".json", ""));
     }
@@ -3709,17 +3888,17 @@ class CBrowser {
      * Save recording to file.
      */
     saveRecording(name, actions) {
-        const recordingsDir = (0, path_1.join)(this.paths.dataDir, "recordings");
-        if (!(0, fs_1.existsSync)(recordingsDir)) {
-            (0, fs_1.mkdirSync)(recordingsDir, { recursive: true });
+        const recordingsDir = join(this.paths.dataDir, "recordings");
+        if (!existsSync(recordingsDir)) {
+            mkdirSync(recordingsDir, { recursive: true });
         }
         const recording = {
             name,
             actions: actions || this.recordingActions,
             created: new Date().toISOString(),
         };
-        const filePath = (0, path_1.join)(recordingsDir, `${name}.json`);
-        (0, fs_1.writeFileSync)(filePath, JSON.stringify(recording, null, 2));
+        const filePath = join(recordingsDir, `${name}.json`);
+        writeFileSync(filePath, JSON.stringify(recording, null, 2));
         return filePath;
     }
     /**
@@ -3755,7 +3934,7 @@ class CBrowser {
      * Export test results as JUnit XML.
      */
     exportJUnit(suite, outputPath) {
-        const filename = outputPath || (0, path_1.join)(this.paths.dataDir, `junit-${Date.now()}.xml`);
+        const filename = outputPath || join(this.paths.dataDir, `junit-${Date.now()}.xml`);
         let xml = `<?xml version="1.0" encoding="UTF-8"?>\n`;
         xml += `<testsuite name="${suite.name}" tests="${suite.tests.length}">\n`;
         for (const test of suite.tests) {
@@ -3766,21 +3945,21 @@ class CBrowser {
             xml += `  </testcase>\n`;
         }
         xml += `</testsuite>\n`;
-        (0, fs_1.writeFileSync)(filename, xml);
+        writeFileSync(filename, xml);
         return filename;
     }
     /**
      * Export test results as TAP format.
      */
     exportTAP(suite, outputPath) {
-        const filename = outputPath || (0, path_1.join)(this.paths.dataDir, `tap-${Date.now()}.tap`);
+        const filename = outputPath || join(this.paths.dataDir, `tap-${Date.now()}.tap`);
         let tap = `TAP version 13\n`;
         tap += `1..${suite.tests.length}\n`;
         suite.tests.forEach((test, i) => {
             const status = test.status === "passed" ? "ok" : "not ok";
             tap += `${status} ${i + 1} ${test.name}\n`;
         });
-        (0, fs_1.writeFileSync)(filename, tap);
+        writeFileSync(filename, tap);
         return filename;
     }
     // =========================================================================
@@ -3856,11 +4035,10 @@ class CBrowser {
         return new FluentCBrowser(this);
     }
 }
-exports.CBrowser = CBrowser;
 /**
  * Fluent wrapper for chainable API.
  */
-class FluentCBrowser {
+export class FluentCBrowser {
     browser;
     constructor(browser) {
         this.browser = browser;
@@ -3892,5 +4070,4 @@ class FluentCBrowser {
         return this.browser;
     }
 }
-exports.FluentCBrowser = FluentCBrowser;
 //# sourceMappingURL=browser.js.map