codymaster 4.8.0 → 7.0.0

package/dist/browse/adapter-factory.js

@@ -0,0 +1,69 @@
+"use strict";
+/**
+ * AdapterFactory — Auto-detect and select the best available browser adapter.
+ * Priority: agent-browser → Playwright (fallback).
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAdapter = createAdapter;
+exports.checkEngines = checkEngines;
+const agent_browser_adapter_1 = require("./adapters/agent-browser-adapter");
+const playwright_adapter_1 = require("./adapters/playwright-adapter");
+/**
+ * Create the best available adapter.
+ * @param preferred - 'auto' (default), 'agent-browser', or 'playwright'
+ */
+function createAdapter() {
+    return __awaiter(this, arguments, void 0, function* (preferred = 'auto') {
+        // Explicit choice
+        if (preferred === 'playwright') {
+            const pw = new playwright_adapter_1.PlaywrightAdapter();
+            if (!(yield pw.isAvailable())) {
+                throw new Error('Playwright is not available. Run: npx playwright install chromium');
+            }
+            return { adapter: pw, engine: 'playwright', fallback: false };
+        }
+        if (preferred === 'agent-browser') {
+            const ab = new agent_browser_adapter_1.AgentBrowserAdapter();
+            if (!(yield ab.isAvailable())) {
+                throw new Error('agent-browser is not available. Run: npm i -g agent-browser && agent-browser install');
+            }
+            return { adapter: ab, engine: 'agent-browser', fallback: false };
+        }
+        // Auto: try agent-browser first, fallback to playwright
+        const ab = new agent_browser_adapter_1.AgentBrowserAdapter();
+        if (yield ab.isAvailable()) {
+            return { adapter: ab, engine: 'agent-browser', fallback: false };
+        }
+        const pw = new playwright_adapter_1.PlaywrightAdapter();
+        if (yield pw.isAvailable()) {
+            console.log('[cm-browse] agent-browser not found, falling back to Playwright');
+            return { adapter: pw, engine: 'playwright', fallback: true };
+        }
+        throw new Error('No browser engine available. Install one:\n' +
+            '  npm i -g agent-browser && agent-browser install\n' +
+            '  npx playwright install chromium');
+    });
+}
+/**
+ * Check which engines are available without creating adapters.
+ */
+function checkEngines() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const ab = new agent_browser_adapter_1.AgentBrowserAdapter();
+        const pw = new playwright_adapter_1.PlaywrightAdapter();
+        const [abAvail, pwAvail] = yield Promise.all([ab.isAvailable(), pw.isAvailable()]);
+        return {
+            'agent-browser': abAvail,
+            playwright: pwAvail,
+        };
+    });
+}

package/dist/browse/adapters/agent-browser-adapter.js

@@ -0,0 +1,305 @@
+"use strict";
+/**
+ * AgentBrowserAdapter — BrowserAdapter implementation using agent-browser CLI.
+ * Calls the Rust CLI via child_process, parses structured output.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentBrowserAdapter = void 0;
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const error_collector_1 = require("../error-collector");
+const execFileAsync = (0, util_1.promisify)(child_process_1.execFile);
+class AgentBrowserAdapter {
+    constructor() {
+        this.name = 'agent-browser';
+        this.errorCollector = new error_collector_1.ErrorCollector();
+        this.consoleLog = [];
+        this.networkLog = [];
+        this.sessionActive = false;
+        this.currentUrl = '';
+    }
+    isAvailable() {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const { stdout } = yield execFileAsync('agent-browser', ['--version'], { timeout: 5000 });
+                return stdout.trim().length > 0;
+            }
+            catch (_a) {
+                return false;
+            }
+        });
+    }
+    startSession(opts) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const args = ['open'];
+            if ((opts === null || opts === void 0 ? void 0 : opts.headless) === false)
+                args.push('--headed');
+            yield this.exec(args);
+            this.sessionActive = true;
+        });
+    }
+    navigate(url) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.exec(['navigate', url]);
+            this.currentUrl = url;
+        });
+    }
+    click(ref) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const cleanRef = ref.startsWith('@') ? ref : `@${ref}`;
+            yield this.exec(['click', cleanRef]);
+        });
+    }
+    fill(ref, value) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const cleanRef = ref.startsWith('@') ? ref : `@${ref}`;
+            yield this.exec(['fill', cleanRef, value]);
+        });
+    }
+    type(ref, text, opts) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const cleanRef = ref.startsWith('@') ? ref : `@${ref}`;
+            const args = ['type', cleanRef, text];
+            if (opts === null || opts === void 0 ? void 0 : opts.delay)
+                args.push('--delay', String(opts.delay));
+            yield this.exec(args);
+        });
+    }
+    press(key) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.exec(['press', key]);
+        });
+    }
+    screenshot(opts) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const args = ['screenshot'];
+            if (opts === null || opts === void 0 ? void 0 : opts.fullPage)
+                args.push('--full-page');
+            const { stdout } = yield this.exec(args);
+            // agent-browser outputs base64 or file path
+            if (stdout.startsWith('/')) {
+                const fs = yield Promise.resolve().then(() => __importStar(require('fs')));
+                return fs.readFileSync(stdout.trim());
+            }
+            return Buffer.from(stdout.trim(), 'base64');
+        });
+    }
+    getSnapshot() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { stdout } = yield this.exec(['snapshot']);
+            return this.parseSnapshot(stdout);
+        });
+    }
+    getConsole() {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const { stdout } = yield this.exec(['console']);
+                const entries = JSON.parse(stdout);
+                this.consoleLog = entries.map((e) => {
+                    var _a, _b, _c, _d, _e;
+                    return ({
+                        type: (_b = (_a = e.level) !== null && _a !== void 0 ? _a : e.type) !== null && _b !== void 0 ? _b : 'log',
+                        text: (_d = (_c = e.text) !== null && _c !== void 0 ? _c : e.message) !== null && _d !== void 0 ? _d : '',
+                        timestamp: (_e = e.timestamp) !== null && _e !== void 0 ? _e : new Date().toISOString(),
+                    });
+                });
+            }
+            catch (_a) {
+                /* return cached */
+            }
+            return [...this.consoleLog];
+        });
+    }
+    getNetwork() {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const { stdout } = yield this.exec(['network']);
+                const entries = JSON.parse(stdout);
+                this.networkLog = entries.map((e) => {
+                    var _a, _b;
+                    return ({
+                        url: e.url,
+                        method: (_a = e.method) !== null && _a !== void 0 ? _a : 'GET',
+                        status: e.status,
+                        timestamp: (_b = e.timestamp) !== null && _b !== void 0 ? _b : new Date().toISOString(),
+                    });
+                });
+            }
+            catch (_a) {
+                /* return cached */
+            }
+            return [...this.networkLog];
+        });
+    }
+    getErrors() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.errorCollector.getAll();
+        });
+    }
+    startRecording() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.exec(['record', 'start']);
+        });
+    }
+    stopRecording() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { stdout } = yield this.exec(['record', 'stop']);
+            return stdout.trim();
+        });
+    }
+    getEngineInfo() {
+        return {
+            name: 'agent-browser',
+            version: 'latest',
+            capabilities: {
+                a11ySnapshot: true,
+                videoRecording: true,
+                networkCapture: true,
+                consoleCapture: true,
+            },
+        };
+    }
+    closeSession() {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                yield this.exec(['close']);
+            }
+            catch (_a) {
+                /* ignore */
+            }
+            this.sessionActive = false;
+            this.consoleLog = [];
+            this.networkLog = [];
+            this.errorCollector.clear();
+        });
+    }
+    // ── Private helpers ─────────────────────────────────────────────────────────
+    exec(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve, reject) => {
+                const proc = (0, child_process_1.spawn)('agent-browser', args, { timeout: 30000 });
+                let stdout = '';
+                let stderr = '';
+                proc.stdout.on('data', (data) => { stdout += data.toString(); });
+                proc.stderr.on('data', (data) => { stderr += data.toString(); });
+                proc.on('close', (code) => {
+                    if (code === 0) {
+                        resolve({ stdout, stderr });
+                    }
+                    else {
+                        const err = new Error(`agent-browser exited ${code}: ${stderr}`);
+                        this.errorCollector.add({
+                            type: 'js-error',
+                            source: 'agent-browser',
+                            message: stderr || `exit code ${code}`,
+                        });
+                        reject(err);
+                    }
+                });
+                proc.on('error', (err) => {
+                    this.errorCollector.add({
+                        type: 'js-error',
+                        source: 'agent-browser',
+                        message: err.message,
+                    });
+                    reject(err);
+                });
+            });
+        });
+    }
+    parseSnapshot(raw) {
+        var _a;
+        try {
+            // Try JSON format first
+            const parsed = JSON.parse(raw);
+            return {
+                root: this.normalizeA11yNode(parsed, 0),
+                refs: (_a = parsed.refs) !== null && _a !== void 0 ? _a : {},
+                timestamp: new Date().toISOString(),
+            };
+        }
+        catch (_b) {
+            // Fallback: parse text-based a11y tree
+            return this.parseTextSnapshot(raw);
+        }
+    }
+    normalizeA11yNode(node, depth) {
+        var _a, _b, _c;
+        if (!node)
+            return { role: 'unknown', name: '', ref: `@e${depth}` };
+        const result = {
+            role: (_a = node.role) !== null && _a !== void 0 ? _a : 'unknown',
+            name: (_b = node.name) !== null && _b !== void 0 ? _b : '',
+            ref: (_c = node.ref) !== null && _c !== void 0 ? _c : `@e${depth}`,
+        };
+        if (node.value)
+            result.value = String(node.value);
+        if (node.focused)
+            result.focused = true;
+        if (node.disabled)
+            result.disabled = true;
+        if (node.children && Array.isArray(node.children)) {
+            result.children = node.children.map((child, i) => this.normalizeA11yNode(child, depth * 10 + i + 1));
+        }
+        return result;
+    }
+    parseTextSnapshot(raw) {
+        const refs = {};
+        const lines = raw.split('\n').filter(l => l.trim());
+        // Parse lines like: "  [button] Submit (@e1)"
+        const root = { role: 'WebArea', name: this.currentUrl, ref: '@e0', children: [] };
+        for (const line of lines) {
+            const match = line.match(/\[(\w+)\]\s*(.+?)\s*\(@e(\d+)\)/);
+            if (match) {
+                const [, role, name, num] = match;
+                const ref = `@e${num}`;
+                refs[ref] = `${role}: ${name}`;
+                root.children.push({ role, name, ref });
+            }
+        }
+        return { root, refs, timestamp: new Date().toISOString() };
+    }
+}
+exports.AgentBrowserAdapter = AgentBrowserAdapter;

package/dist/browse/adapters/playwright-adapter.js

@@ -0,0 +1,309 @@
+"use strict";
+/**
+ * PlaywrightAdapter — BrowserAdapter implementation using Playwright.
+ * Extracted from the original BrowseDaemon page operations.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlaywrightAdapter = void 0;
+const error_collector_1 = require("../error-collector");
+class PlaywrightAdapter {
+    constructor() {
+        this.name = 'playwright';
+        this.browser = null;
+        this.context = null;
+        this.page = null;
+        this.errorCollector = new error_collector_1.ErrorCollector();
+        this.consoleLog = [];
+        this.networkLog = [];
+        this.videoDir = null;
+        this.refMap = {};
+    }
+    isAvailable() {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const pw = yield Promise.resolve().then(() => __importStar(require('playwright')));
+                return !!pw.chromium;
+            }
+            catch (_a) {
+                return false;
+            }
+        });
+    }
+    startSession(opts) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            const pw = yield Promise.resolve().then(() => __importStar(require('playwright')));
+            const headless = (_a = opts === null || opts === void 0 ? void 0 : opts.headless) !== null && _a !== void 0 ? _a : true;
+            this.browser = yield pw.chromium.launch({ headless });
+            const contextOpts = {};
+            if (opts === null || opts === void 0 ? void 0 : opts.viewport)
+                contextOpts.viewport = opts.viewport;
+            if (opts === null || opts === void 0 ? void 0 : opts.userAgent)
+                contextOpts.userAgent = opts.userAgent;
+            if (opts === null || opts === void 0 ? void 0 : opts.recordVideo) {
+                this.videoDir = (_b = opts.videoDir) !== null && _b !== void 0 ? _b : '/tmp/cm-browse-videos';
+                contextOpts.recordVideo = { dir: this.videoDir };
+            }
+            this.context = yield this.browser.newContext(contextOpts);
+            this.page = yield this.context.newPage();
+            // Wire console events
+            this.page.on('console', (msg) => {
+                const entry = {
+                    type: msg.type(),
+                    text: msg.text(),
+                    timestamp: new Date().toISOString(),
+                };
+                this.consoleLog.push(entry);
+                // Feed error collector
+                if (msg.type() === 'error' || msg.type() === 'warning') {
+                    this.errorCollector.addConsole(msg.type(), msg.text());
+                }
+            });
+            // Wire page errors (uncaught exceptions)
+            this.page.on('pageerror', (err) => {
+                this.errorCollector.add({
+                    type: 'js-error',
+                    source: 'page',
+                    message: err.message,
+                    stack: err.stack,
+                });
+            });
+            // Wire network events
+            if (this.context) {
+                this.context.on('response', (response) => {
+                    try {
+                        const entry = {
+                            url: response.url(),
+                            method: response.request().method(),
+                            status: response.status(),
+                            statusText: response.statusText(),
+                            timestamp: new Date().toISOString(),
+                            resourceType: response.request().resourceType(),
+                        };
+                        this.networkLog.push(entry);
+                        // Capture failures
+                        if (response.status() >= 400) {
+                            this.errorCollector.addNetworkFailure(response.url(), response.request().method(), response.status());
+                        }
+                    }
+                    catch (_a) {
+                        /* ignore */
+                    }
+                });
+                this.context.on('requestfailed', (request) => {
+                    var _a;
+                    this.errorCollector.addNetworkFailure(request.url(), request.method(), undefined, (_a = request.failure()) === null || _a === void 0 ? void 0 : _a.errorText);
+                });
+            }
+        });
+    }
+    navigate(url) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.page)
+                throw new Error('No active session');
+            yield this.page.goto(url, { waitUntil: 'domcontentloaded', timeout: 60000 });
+        });
+    }
+    click(ref) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.page)
+                throw new Error('No active session');
+            const cleanRef = ref.replace(/^@/, '');
+            yield this.page.click(`[data-cm-ref="${cleanRef}"]`, { timeout: 15000 });
+        });
+    }
+    fill(ref, value) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.page)
+                throw new Error('No active session');
+            const cleanRef = ref.replace(/^@/, '');
+            yield this.page.fill(`[data-cm-ref="${cleanRef}"]`, value, { timeout: 15000 });
+        });
+    }
+    type(ref, text, opts) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.page)
+                throw new Error('No active session');
+            const cleanRef = ref.replace(/^@/, '');
+            yield this.page.fill(`[data-cm-ref="${cleanRef}"]`, text, { timeout: 15000 });
+        });
+    }
+    press(key) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.page)
+                throw new Error('No active session');
+            yield this.page.keyboard.press(key);
+        });
+    }
+    screenshot(opts) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.page)
+                throw new Error('No active session');
+            return this.page.screenshot({ type: 'png', fullPage: opts === null || opts === void 0 ? void 0 : opts.fullPage });
+        });
+    }
+    getSnapshot() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.page)
+                throw new Error('No active session');
+            // Use Playwright's accessibility snapshot
+            const pwSnapshot = yield this.page.accessibility.snapshot();
+            // Also tag interactive elements with data-cm-ref
+            const refMapping = yield this.page.evaluate(() => {
+                const sel = 'a[href],button,input,textarea,select,[role="button"],[onclick]';
+                const nodes = Array.from(document.querySelectorAll(sel));
+                const out = {};
+                nodes.forEach((el, i) => {
+                    const id = `e${i + 1}`;
+                    el.setAttribute('data-cm-ref', id);
+                    const tag = el.tagName.toLowerCase();
+                    const txt = (el.textContent || '').trim().slice(0, 80);
+                    out[id] = `${tag}${txt ? `: ${txt}` : ''}`;
+                });
+                return out;
+            });
+            this.refMap = refMapping;
+            // Convert Playwright a11y tree to our format
+            const root = this.convertA11yNode(pwSnapshot, 0);
+            return {
+                root,
+                refs: refMapping,
+                timestamp: new Date().toISOString(),
+            };
+        });
+    }
+    getConsole() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return [...this.consoleLog];
+        });
+    }
+    getNetwork() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return [...this.networkLog];
+        });
+    }
+    getErrors() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.errorCollector.getAll();
+        });
+    }
+    startRecording() {
+        return __awaiter(this, void 0, void 0, function* () {
+            // Video recording must be set at context creation time in Playwright
+            // This is a no-op if not started with recordVideo
+            if (!this.context)
+                throw new Error('No active session');
+        });
+    }
+    stopRecording() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.page)
+                throw new Error('No active session');
+            // Playwright saves video on page close
+            const video = this.page.video();
+            if (video) {
+                const path = yield video.path();
+                return path;
+            }
+            return '';
+        });
+    }
+    getEngineInfo() {
+        return {
+            name: 'playwright',
+            version: '1.x',
+            capabilities: {
+                a11ySnapshot: true,
+                videoRecording: true,
+                networkCapture: true,
+                consoleCapture: true,
+            },
+        };
+    }
+    closeSession() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.page)
+                yield this.page.close().catch(() => { });
+            if (this.context)
+                yield this.context.close().catch(() => { });
+            if (this.browser)
+                yield this.browser.close().catch(() => { });
+            this.page = null;
+            this.context = null;
+            this.browser = null;
+            this.consoleLog = [];
+            this.networkLog = [];
+            this.errorCollector.clear();
+            this.refMap = {};
+        });
+    }
+    // ── Private helpers ─────────────────────────────────────────────────────────
+    convertA11yNode(node, depth) {
+        var _a, _b;
+        if (!node)
+            return { role: 'unknown', name: '', ref: `@e${depth}` };
+        const ref = `@e${depth}`;
+        const result = {
+            role: (_a = node.role) !== null && _a !== void 0 ? _a : 'unknown',
+            name: (_b = node.name) !== null && _b !== void 0 ? _b : '',
+            ref,
+        };
+        if (node.value !== undefined)
+            result.value = String(node.value);
+        if (node.focused)
+            result.focused = true;
+        if (node.disabled)
+            result.disabled = true;
+        if (node.expanded !== undefined)
+            result.expanded = node.expanded;
+        if (node.selected !== undefined)
+            result.selected = node.selected;
+        if (node.children && Array.isArray(node.children)) {
+            result.children = node.children.map((child, i) => this.convertA11yNode(child, depth * 10 + i + 1));
+        }
+        return result;
+    }
+}
+exports.PlaywrightAdapter = PlaywrightAdapter;

package/dist/browse/adapters/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Browse Hybrid Bridge — Unified adapter interface and types.
+ * Both PlaywrightAdapter and AgentBrowserAdapter implement BrowserAdapter.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });