@dyyz1993/agent-browser 0.13.2 → 0.24.0

package/dist/flow/exporters/playwright.js

@@ -0,0 +1,175 @@
+export class PlaywrightExporter {
+    format = 'playwright';
+    extension = 'ts';
+    export(steps, options) {
+        const lines = [];
+        const headless = options?.headless !== false;
+        lines.push(`import { chromium } from 'playwright';`);
+        lines.push('');
+        lines.push('(async () => {');
+        lines.push(`  const browser = await chromium.launch({ headless: ${headless} });`);
+        if (options?.timeout) {
+            lines.push(`  const defaultTimeout = ${options.timeout};`);
+        }
+        lines.push('  const page = await browser.newPage();');
+        lines.push('');
+        for (let i = 0; i < steps.length; i++) {
+            const step = steps[i];
+            const stepNum = i + 1;
+            const comment = `// Step ${stepNum}: ${step.id} (${step.action})`;
+            lines.push(`  ${comment}`);
+            switch (step.action) {
+                case 'navigate':
+                    this.emitNavigate(lines, step, options);
+                    break;
+                case 'click':
+                    this.emitClick(lines, step);
+                    break;
+                case 'fill':
+                    this.emitFill(lines, step);
+                    break;
+                case 'press':
+                    this.emitPress(lines, step);
+                    break;
+                case 'scroll':
+                    this.emitScroll(lines, step);
+                    break;
+                case 'wait':
+                    this.emitWait(lines, step);
+                    break;
+                case 'extract':
+                    this.emitExtract(lines, step);
+                    break;
+                case 'eval':
+                    this.emitEval(lines, step);
+                    break;
+                case 'screenshot':
+                    this.emitScreenshot(lines, step);
+                    break;
+                case 'snapshot':
+                    lines.push(`  // snapshot step - informational only`);
+                    break;
+                default:
+                    lines.push(`  // TODO: unsupported action "${step.action}"`);
+            }
+            lines.push('');
+        }
+        lines.push('  await browser.close();');
+        lines.push('})();');
+        return lines.join('\n');
+    }
+    emitNavigate(lines, step, options) {
+        const url = step.url || '';
+        const resolvedUrl = this.resolveUrl(url, options?.baseUrl);
+        lines.push(`  await page.goto('${resolvedUrl}');`);
+        lines.push(`  await page.waitForLoadState('domcontentloaded');`);
+        if (step.waitAfter) {
+            lines.push(`  await page.waitForLoadState('${step.waitAfter}');`);
+        }
+    }
+    emitClick(lines, step) {
+        const selector = step.selector || '';
+        this.emitFallbackComment(lines, step);
+        lines.push(`  await page.locator('${selector}').click();`);
+        if (step.waitForNavigation) {
+            lines.push(`  await page.waitForLoadState('${step.waitForNavigation}');`);
+        }
+        else if (step.waitAfter) {
+            lines.push(`  await page.waitForLoadState('${step.waitAfter}');`);
+        }
+    }
+    emitFill(lines, step) {
+        const selector = step.selector || '';
+        const value = this.templateValue(step.value || '');
+        this.emitFallbackComment(lines, step);
+        lines.push(`  await page.locator('${selector}').fill(${value});`);
+    }
+    emitPress(lines, step) {
+        const key = step.value || 'Enter';
+        lines.push(`  await page.keyboard.press('${key}');`);
+    }
+    emitScroll(lines, step) {
+        const direction = step.scrollDirection || step.value || 'down';
+        const amount = step.scrollAmount || 300;
+        const sign = direction === 'up' ? '-' : '';
+        lines.push(`  await page.evaluate(() => window.scrollBy(0, ${sign}${amount}));`);
+    }
+    emitWait(lines, step) {
+        if (step.selector) {
+            lines.push(`  await page.locator('${step.selector}').waitFor({ state: 'visible'${step.timeout ? `, timeout: ${step.timeout}` : ''} });`);
+        }
+        else if (step.timeout) {
+            lines.push(`  await page.waitForTimeout(${step.timeout});`);
+        }
+        else if (step.waitCondition === 'url_change') {
+            const pattern = step.waitUrlPattern || '';
+            lines.push(`  await page.waitForURL('**${pattern}**');`);
+        }
+        else if (step.waitCondition === 'dom_stable') {
+            const ms = step.waitDomStableTimeout || 500;
+            lines.push(`  await page.waitForTimeout(${ms});`);
+        }
+    }
+    emitExtract(lines, step) {
+        const container = step.container || 'body';
+        const fields = step.fields || {};
+        const varName = step.outputVar || 'extracted';
+        const entries = Object.entries(fields).map(([name, def]) => {
+            if (typeof def === 'string') {
+                return `${name}: el.querySelector('${def}')?.textContent?.trim() || ''`;
+            }
+            const ef = def;
+            if (ef.attribute) {
+                return `${name}: el.querySelector('${ef.selector}')?.getAttribute('${ef.attribute}') || ''`;
+            }
+            return `${name}: el.querySelector('${ef.selector}')?.textContent?.trim() || ''`;
+        });
+        lines.push(`  const ${varName} = await page.$$eval('${container}', (els) =>`);
+        lines.push(`    els.map((el) => ({ ${entries.join(', ')} }))`);
+        lines.push(`  );`);
+    }
+    emitEval(lines, step) {
+        const script = step.value || '';
+        const varName = step.outputVar;
+        if (varName) {
+            lines.push(`  const ${varName} = await page.evaluate(() => {`);
+            lines.push(`    return ${script};`);
+            lines.push(`  });`);
+        }
+        else {
+            lines.push(`  await page.evaluate(() => {`);
+            lines.push(`    ${script};`);
+            lines.push(`  });`);
+        }
+    }
+    emitScreenshot(lines, step) {
+        if (step.selector) {
+            lines.push(`  await page.locator('${step.selector}').screenshot();`);
+        }
+        else {
+            lines.push(`  await page.screenshot({ fullPage: true });`);
+        }
+    }
+    emitFallbackComment(lines, step) {
+        if (step.fallbackSelectors && step.fallbackSelectors.length > 0) {
+            lines.push(`  // Fallback selectors: ${step.fallbackSelectors.join(', ')}`);
+        }
+    }
+    templateValue(value) {
+        const hasTemplate = /\$\{(\w+)\}/.test(value);
+        if (hasTemplate) {
+            return `'${value}'`;
+        }
+        return `'${value}'`;
+    }
+    resolveUrl(url, baseUrl) {
+        if (!url || url === 'back')
+            return url;
+        if (url.startsWith('http://') || url.startsWith('https://'))
+            return url;
+        if (baseUrl)
+            return `${baseUrl}${url.startsWith('/') ? '' : '/'}${url}`;
+        return url;
+    }
+}
+//# sourceMappingURL=playwright.js.map

package/dist/flow/exporters/playwright.js.map

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

package/dist/flow/exporters/python.d.ts

@@ -0,0 +1,20 @@
+import type { FlowStep } from '../types.js';
+import type { ScriptExporter, ExportOptions } from './types.js';
+export declare class PythonExporter implements ScriptExporter {
+    format: string;
+    extension: string;
+    export(steps: FlowStep[], options?: ExportOptions): string;
+    private emitNavigate;
+    private emitClick;
+    private emitFill;
+    private emitPress;
+    private emitScroll;
+    private emitWait;
+    private emitExtract;
+    private emitEval;
+    private emitScreenshot;
+    private emitFallbackComment;
+    private escapePy;
+    private resolveUrl;
+}
+//# sourceMappingURL=python.d.ts.map

package/dist/flow/exporters/python.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python.d.ts","sourceRoot":"","sources":["../../../src/flow/exporters/python.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAgB,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhE,qBAAa,cAAe,YAAW,cAAc;IACnD,MAAM,SAAY;IAClB,SAAS,SAAQ;IAEjB,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM;IA6D1D,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,QAAQ;IAkBhB,OAAO,CAAC,WAAW;IAqBnB,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,UAAU;CAMnB"}

package/dist/flow/exporters/python.js

@@ -0,0 +1,163 @@
+export class PythonExporter {
+    format = 'python';
+    extension = 'py';
+    export(steps, options) {
+        const lines = [];
+        const headless = options?.headless !== false;
+        lines.push('from playwright.sync_api import sync_playwright');
+        lines.push('');
+        lines.push('with sync_playwright() as p:');
+        lines.push(`    browser = p.chromium.launch(headless=${headless})`);
+        lines.push('    page = browser.new_page()');
+        lines.push('');
+        for (let i = 0; i < steps.length; i++) {
+            const step = steps[i];
+            const stepNum = i + 1;
+            const comment = `    # Step ${stepNum}: ${step.id} (${step.action})`;
+            lines.push(comment);
+            switch (step.action) {
+                case 'navigate':
+                    this.emitNavigate(lines, step, options);
+                    break;
+                case 'click':
+                    this.emitClick(lines, step);
+                    break;
+                case 'fill':
+                    this.emitFill(lines, step);
+                    break;
+                case 'press':
+                    this.emitPress(lines, step);
+                    break;
+                case 'scroll':
+                    this.emitScroll(lines, step);
+                    break;
+                case 'wait':
+                    this.emitWait(lines, step);
+                    break;
+                case 'extract':
+                    this.emitExtract(lines, step);
+                    break;
+                case 'eval':
+                    this.emitEval(lines, step);
+                    break;
+                case 'screenshot':
+                    this.emitScreenshot(lines, step);
+                    break;
+                case 'snapshot':
+                    lines.push('    # snapshot step - informational only');
+                    break;
+                default:
+                    lines.push(`    # TODO: unsupported action "${step.action}"`);
+            }
+            lines.push('');
+        }
+        lines.push('    browser.close()');
+        return lines.join('\n');
+    }
+    emitNavigate(lines, step, options) {
+        const url = step.url || '';
+        const resolvedUrl = this.resolveUrl(url, options?.baseUrl);
+        lines.push(`    page.goto('${resolvedUrl}')`);
+        lines.push(`    page.wait_for_load_state('domcontentloaded')`);
+        if (step.waitAfter) {
+            lines.push(`    page.wait_for_load_state('${step.waitAfter}')`);
+        }
+    }
+    emitClick(lines, step) {
+        const selector = step.selector || '';
+        this.emitFallbackComment(lines, step);
+        lines.push(`    page.locator('${selector}').click()`);
+        if (step.waitForNavigation) {
+            lines.push(`    page.wait_for_load_state('${step.waitForNavigation}')`);
+        }
+        else if (step.waitAfter) {
+            lines.push(`    page.wait_for_load_state('${step.waitAfter}')`);
+        }
+    }
+    emitFill(lines, step) {
+        const selector = step.selector || '';
+        const value = step.value || '';
+        this.emitFallbackComment(lines, step);
+        lines.push(`    page.locator('${selector}').fill('${value}')`);
+    }
+    emitPress(lines, step) {
+        const key = step.value || 'Enter';
+        lines.push(`    page.keyboard.press('${key}')`);
+    }
+    emitScroll(lines, step) {
+        const direction = step.scrollDirection || step.value || 'down';
+        const amount = step.scrollAmount || 300;
+        const sign = direction === 'up' ? '-' : '';
+        lines.push(`    page.evaluate('window.scrollBy(0, ${sign}${amount})')`);
+    }
+    emitWait(lines, step) {
+        if (step.selector) {
+            lines.push(`    page.locator('${step.selector}').wait_for(state='visible'${step.timeout ? `, timeout=${step.timeout}` : ''})`);
+        }
+        else if (step.timeout) {
+            lines.push(`    page.wait_for_timeout(${step.timeout})`);
+        }
+        else if (step.waitCondition === 'url_change') {
+            const pattern = step.waitUrlPattern || '';
+            lines.push(`    page.wait_for_url('**${pattern}**')`);
+        }
+        else if (step.waitCondition === 'dom_stable') {
+            const ms = step.waitDomStableTimeout || 500;
+            lines.push(`    page.wait_for_timeout(${ms})`);
+        }
+    }
+    emitExtract(lines, step) {
+        const container = step.container || 'body';
+        const fields = step.fields || {};
+        const varName = step.outputVar || 'extracted';
+        const entries = Object.entries(fields).map(([name, def]) => {
+            if (typeof def === 'string') {
+                return `'${name}': el.query_selector('${def}') and el.query_selector('${def}').text_content().strip() or ''`;
+            }
+            const ef = def;
+            if (ef.attribute) {
+                return `'${name}': el.query_selector('${ef.selector}') and el.query_selector('${ef.selector}').get_attribute('${ef.attribute}') or ''`;
+            }
+            return `'${name}': el.query_selector('${ef.selector}') and el.query_selector('${ef.selector}').text_content().strip() or ''`;
+        });
+        lines.push(`    ${varName} = []`);
+        lines.push(`    for el in page.query_selector_all('${container}'):`);
+        lines.push(`        ${varName}.append({ ${entries.join(', ')} })`);
+    }
+    emitEval(lines, step) {
+        const script = step.value || '';
+        const varName = step.outputVar;
+        if (varName) {
+            lines.push(`    ${varName} = page.evaluate('${this.escapePy(script)}')`);
+        }
+        else {
+            lines.push(`    page.evaluate('${this.escapePy(script)}')`);
+        }
+    }
+    emitScreenshot(lines, step) {
+        if (step.selector) {
+            lines.push(`    page.locator('${step.selector}').screenshot()`);
+        }
+        else {
+            lines.push(`    page.screenshot(full_page=True)`);
+        }
+    }
+    emitFallbackComment(lines, step) {
+        if (step.fallbackSelectors && step.fallbackSelectors.length > 0) {
+            lines.push(`    # Fallback selectors: ${step.fallbackSelectors.join(', ')}`);
+        }
+    }
+    escapePy(s) {
+        return s.replace(/\\/g, '\\\\').replace(/'/g, "\\'").replace(/\n/g, '\\n');
+    }
+    resolveUrl(url, baseUrl) {
+        if (!url || url === 'back')
+            return url;
+        if (url.startsWith('http://') || url.startsWith('https://'))
+            return url;
+        if (baseUrl)
+            return `${baseUrl}${url.startsWith('/') ? '' : '/'}${url}`;
+        return url;
+    }
+}
+//# sourceMappingURL=python.js.map

package/dist/flow/exporters/python.js.map

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

package/dist/flow/exporters/selenium.d.ts

@@ -0,0 +1,9 @@
+import type { FlowStep } from '../types.js';
+import type { ScriptExporter, ExportOptions } from './types.js';
+export declare class SeleniumExporter implements ScriptExporter {
+    format: string;
+    extension: string;
+    export(steps: FlowStep[], options?: ExportOptions): string;
+    private exportStep;
+}
+//# sourceMappingURL=selenium.d.ts.map

package/dist/flow/exporters/selenium.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selenium.d.ts","sourceRoot":"","sources":["../../../src/flow/exporters/selenium.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAgB,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhE,qBAAa,gBAAiB,YAAW,cAAc;IACrD,MAAM,SAAc;IACpB,SAAS,SAAS;IAElB,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM;IAyC1D,OAAO,CAAC,UAAU;CAuTnB"}