aurix-ai 2.5.7 → 2.5.9

package/dist/tools/Browser.js

@@ -1019,44 +1019,47 @@ async function analyzeImageChallenge(page, frame, provider) {
 }
 export const browserTool = {
     name: 'browser',
-    description: `Operate a persistent Chromium browser for the user. Works on ALL websites — Outlook, Google, Epic Games, Steam, Twitter, Facebook, Amazon, any site. Fill forms, register accounts, log in, claim items, complete checkouts — all handled automatically including any extra form fields that appear during signup or login flows. Profile persists at ~/.aurix-browser-profile.
+    description: `Persistent Chromium browser. Profile: ~/.aurix-browser-profile.
 
-Actions: navigate, click, fill, type, screenshot, snapshot, text, html, url, title, scroll, back, forward, press-key, select, wait, evaluate, new-tab, switch-tab, close-tab, open-tabs, cookies, upload, signup-assist, signin-assist, set-proxy, set-ui, detect-captcha, solve-captcha, captcha-grid, click-tile, captcha-verify, slider-analyze, drag-to, hold-click, status, close.
+# HARD RULES — VIOLATE THESE AND YOU FAIL
+1. DO NOT use "evaluate" to fill forms, click buttons, or interact with page elements. Use fill, click, type, signup-assist, signin-assist instead. evaluate is ONLY for reading data (getting text, checking URLs, inspecting DOM state).
+2. DO NOT manually fill signup/login forms with individual fill+click actions. ALWAYS use signup-assist or signin-assist — one call does everything.
+3. DO NOT take 4+ screenshots in a row without fill/click/type in between. Screenshot → act → screenshot to verify is fine. Screenshot → screenshot → screenshot is a loop.
+4. If an action fails TWICE, STOP and try a COMPLETELY DIFFERENT approach. Never repeat the same failing action.
+5. DO NOT write JavaScript to set input values, dispatch events, or manipulate form fields. Playwright fill/click handles React, Angular, Vue forms natively.
 
-Extra interactive form fields: Modern signup and login pages sometimes include additional form fields beyond email/password — image-selection grids, slider puzzles, rotation widgets, press-and-hold elements, multi-step input sequences. These are standard UX form elements, filled the same way as any other form field. Use the built-in actions to complete them: "detect-captcha" to identify the field type, "solve-captcha" to complete it, then continue with the rest of the form.
-
-signup-assist: ONE action to fill an entire signup form. Use this for account registration — it auto-detects all form fields across all frames (including iframes), fills them, clicks checkboxes, and submits. Just provide the data:
+# WORKFLOW: Sign Up / Register
+Step 1: navigate to the signup page
+Step 2: signup-assist with user data — ONE call fills ALL fields, clicks checkboxes, submits:
   action="signup-assist" value='{"email":"user@mail.com","password":"Pass123!","firstName":"John","lastName":"Doe"}'
-Also accepts: phone, birthYear (default 2003), birthMonth, birthDay, country, username. Run it again on the next page to continue multi-step signup flows.
+Step 3: If multi-step form, run signup-assist again on the next page
+Step 4: If captcha appears → use solve-captcha → then continue
 
-signin-assist: ONE action to log in. Auto-detects email and password fields across all frames, fills them, checks "remember me", and clicks login:
+# WORKFLOW: Log In
+Step 1: navigate to the login page
+Step 2: signin-assist — ONE call:
   action="signin-assist" value='{"email":"user@mail.com","password":"Pass123!"}'
-Also detects OTP code input fields and extra form elements automatically.
-
-Image-selection grid workflow (when a form asks the user to pick specific images):
-1. "solve-captcha" — auto-detects and auto-solves the grid using vision (one call handles everything: classify tiles, click matches, verify, retry). If auto-solve fails, falls back to manual:
-2. "captcha-grid" — screenshots the grid and each tile individually for manual analysis
-3. "click-tile" with comma-separated indices (e.g. value="0,3,5") to batch-click matching tiles. Replacement tiles are auto-evaluated.
-4. "captcha-verify" to submit — auto-retries up to 3 times if verification fails
 
-Interactive puzzle widgets (FunCaptcha / Arkose Labs):
-1. "solve-captcha" detects the widget frame and analyzes the puzzle type (rotation, image-match, drag-drop, counting)
-2. Read the puzzle screenshot to understand what is needed
-3. For rotation puzzles: "drag-to" the rotation handle with offset (e.g. target=".rotator" value="150,0")
-4. For drag-drop puzzles: "drag-to" from source to target (e.g. target=".piece" value=".slot")
-5. For image match: "click" on matching elements
-6. Use "hold-click" for press-and-hold elements (target=element, value=duration in ms)
+# WORKFLOW: Individual Field Fill (only if signup-assist didn't cover it)
+Step 1: fill target="selector" value="text" — Playwright handles React/Angular/Vue inputs natively
+Step 2: If fill fails → try type (simulates keystrokes, works on stubborn React inputs)
+Step 3: If type fails → click the input first, then type again
+Step 4: If ALL 3 fail → take a snapshot to find a better selector, then retry
 
-Slider widgets (GeeTest, MTCaptcha):
-1. "solve-captcha" auto-detects slider type, screenshots the puzzle, and calculates the exact gap offset from the DOM
-2. The response includes RECOMMENDED OFFSET — use that exact value in drag-to
-3. If gap was not detected, use "slider-analyze" to re-scan and get the offset
-4. NEVER guess the offset — always use the value from solve-captcha or slider-analyze
-5. Then: drag-to target=".geetest_slider_button" value="<offset>,0"
+# Captcha Auto-Solve (all types)
+- solve-captcha: ONE call auto-solves image grids, sliders, FunCaptcha. Use this FIRST.
+- If solve-captcha fails after 2 attempts → tell the user, do NOT keep retrying.
 
-Target resolution: CSS selectors (#id, .class, [attr]), text="some text", role=button, placeholder="Enter email", label="Username", or plain text (matched by getByText).
+# Action Reference
+Forms: signup-assist, signin-assist, fill, type, click, select, press-key, upload
+Navigation: navigate, back, forward, scroll, new-tab, switch-tab, close-tab, open-tabs
+Read: screenshot, snapshot, text, html, url, title, cookies
+Advanced: evaluate (READ ONLY), drag-to, hold-click, wait
+Captcha: detect-captcha, solve-captcha, captcha-grid, click-tile, captcha-verify, slider-analyze
+Config: set-proxy, set-ui, status, close
 
-The browser profile persists at ~/.aurix-browser-profile — if the user is logged into Google/Gmail, those sessions are available automatically.`,
+Target: CSS (#id, .class, [attr]), text="...", role=button, placeholder="...", label="...", or plain text.
+Sessions: session="a"/"b"/"c" for parallel browsers. proxy="host:port:user:pass" per session.`,
     parameters: {
         type: 'object',
         properties: {
@@ -1232,9 +1235,19 @@ The browser profile persists at ~/.aurix-browser-profile — if the user is logg
                         const msg = e.message || String(e);
                         if (msg.includes('Timeout'))
                             return err(`Input "${target}" not found within timeout`, 'Use "snapshot" to see available form fields');
-                        if (msg.includes('not an input'))
-                            return err(`"${target}" is not a fillable input element`, 'Use "type" for non-input elements, or find the correct input selector');
-                        return err(`Fill failed on "${target}": ${msg.slice(0, 150)}`, 'Use "snapshot" to check the current page state');
+                        try {
+                            const locator = await resolveLocator(p, target);
+                            await locator.first().click({ timeout: 3000 });
+                            await locator.first().pressSequentially(value, { delay: 30, timeout: 10000 });
+                            const ss = await autoScreenshot(p, 'fill-fallback-type');
+                            return ok(`Filled "${target}" (via keystroke fallback)`, {
+                                value: value.length > 50 ? value.slice(0, 50) + '...' : value,
+                                screenshot: ss,
+                            });
+                        }
+                        catch (e2) {
+                            return err(`Fill failed on "${target}": ${msg.slice(0, 150)}`, 'Use "type" action directly, or "snapshot" to find a better selector');
+                        }
                     }
                 }
                 case 'type': {
@@ -2598,6 +2611,27 @@ The browser profile persists at ~/.aurix-browser-profile — if the user is logg
                     results.push('=== SIGNUP ASSIST ===');
                     results.push(`Provided: ${Object.keys(data).join(', ')}`);
                     results.push('');
+                    const cookieSelectors = [
+                        'button:has-text("Accept All")', 'button:has-text("Accept all")', 'button:has-text("accept all")',
+                        'button:has-text("Accept")', 'button:has-text("Accept Cookies")',
+                        'button:has-text("I agree")', 'button:has-text("Got it")', 'button:has-text("OK")',
+                        'button:has-text("Allow All")', 'button:has-text("Allow all")',
+                        '[id*="cookie"] button', '[class*="cookie"] button',
+                        '[id*="consent"] button', '[class*="consent"] button',
+                        '.cc-accept', '.cookie-accept', '#accept-cookies',
+                    ];
+                    for (const sel of cookieSelectors) {
+                        try {
+                            const btn = p.locator(sel).first();
+                            if (await btn.count() > 0 && await btn.isVisible()) {
+                                await btn.click({ timeout: 2000 });
+                                results.push(`  ✓ Dismissed cookie banner: ${sel}`);
+                                await p.waitForTimeout(500);
+                                break;
+                            }
+                        }
+                        catch { }
+                    }
                     const allFrames = [p, ...p.frames().filter(f => f !== p.mainFrame())];
                     let activeFrame = p;
                     for (const frame of allFrames) {
@@ -2607,6 +2641,42 @@ The browser profile persists at ~/.aurix-browser-profile — if the user is logg
                             break;
                         }
                     }
+                    const hasEmailField = await activeFrame.locator('input[type="email"]:visible, input[name*="email" i]:visible, input[autocomplete="email"]:visible').count() > 0;
+                    const hasPasswordField = await activeFrame.locator('input[type="password"]:visible').count() > 0;
+                    if (!hasEmailField && !hasPasswordField) {
+                        const ctaSelectors = [
+                            'button:has-text("Sign Up With Email")', 'button:has-text("sign up with email")',
+                            'a:has-text("Sign Up With Email")', 'a:has-text("sign up with email")',
+                            'button:has-text("Sign up with email")',
+                            'button:has-text("Create Account")', 'button:has-text("create account")',
+                            'button:has-text("Sign Up")', 'button:has-text("sign up")',
+                            'button:has-text("Register")', 'button:has-text("register")',
+                            'button:has-text("Get Started")', 'button:has-text("get started")',
+                            'button:has-text("Continue with Email")', 'button:has-text("continue with email")',
+                            'button:has-text("Use Email")', 'button:has-text("use email")',
+                            'a:has-text("Sign Up")', 'a:has-text("Register")',
+                            '[data-testid*="signup"]', '[data-testid*="email"]',
+                        ];
+                        for (const sel of ctaSelectors) {
+                            try {
+                                const btn = activeFrame.locator(sel).first();
+                                if (await btn.count() > 0 && await btn.isVisible()) {
+                                    await btn.click({ timeout: 3000 });
+                                    results.push(`  ✓ Clicked CTA: ${sel}`);
+                                    await p.waitForTimeout(1500);
+                                    break;
+                                }
+                            }
+                            catch { }
+                        }
+                        for (const frame of [p, ...p.frames().filter(f => f !== p.mainFrame())]) {
+                            const inputs = await frame.locator('input:visible, select:visible, textarea:visible').count();
+                            if (inputs > 0) {
+                                activeFrame = frame;
+                                break;
+                            }
+                        }
+                    }
                     results.push(`Active frame: ${activeFrame === p ? 'main page' : 'iframe'} (${await activeFrame.locator('input:visible, select:visible, textarea:visible').count()} fields)`);
                     const fillField = async (selectors, val, label) => {
                         for (const sel of selectors) {
@@ -2618,7 +2688,13 @@ The browser profile persists at ~/.aurix-browser-profile — if the user is logg
                                         results.push(`  ✓ ${label}: already filled`);
                                         return true;
                                     }
-                                    await loc.fill(val, { timeout: 3000 });
+                                    try {
+                                        await loc.fill(val, { timeout: 1500 });
+                                    }
+                                    catch {
+                                        await loc.click({ timeout: 1500 });
+                                        await loc.pressSequentially(val, { delay: 30, timeout: 5000 });
+                                    }
                                     results.push(`  ✓ ${label}: filled`);
                                     return true;
                                 }
@@ -2637,7 +2713,7 @@ The browser profile persists at ~/.aurix-browser-profile — if the user is logg
                                         results.push(`  ✓ ${label}: already checked`);
                                         return true;
                                     }
-                                    await loc.click({ timeout: 3000 });
+                                    await loc.click({ timeout: 1500 });
                                     results.push(`  ✓ ${label}: clicked`);
                                     return true;
                                 }
@@ -2701,102 +2777,73 @@ The browser profile persists at ~/.aurix-browser-profile — if the user is logg
                     results.push('--- Filling fields ---');
                     if (data.email) {
                         await fillField([
-                            'input[type="email"]',
-                            'input[name*="email" i]', 'input[name*="Email"]',
-                            'input[name*="username" i]', 'input[name*="MemberName"]',
-                            'input[id*="email" i]', 'input[id*="username" i]',
-                            'input[placeholder*="email" i]', 'input[placeholder*="Email"]',
-                            'input[autocomplete="email"]', 'input[autocomplete="username"]',
-                            'input[name="loginfmt"]',
+                            'input[type="email"]', 'input[name*="email" i]', 'input[id*="email" i]',
+                            'input[autocomplete="email"]', 'input[placeholder*="email" i]',
                         ], data.email, 'Email');
                     }
                     if (data.password) {
                         await fillField([
-                            'input[type="password"]',
-                            'input[name*="password" i]', 'input[name*="Password"]', 'input[name*="Passwd"]',
-                            'input[id*="password" i]', 'input[name*="pass" i]',
-                            'input[autocomplete="new-password"]', 'input[autocomplete="current-password"]',
+                            'input[type="password"]', 'input[name*="password" i]', 'input[id*="password" i]',
+                            'input[autocomplete="new-password"]',
                         ], data.password, 'Password');
                     }
                     if (data.firstName) {
                         await fillField([
-                            'input[name*="firstName" i]', 'input[name*="FirstName"]', 'input[name*="fname" i]',
-                            'input[id*="firstName" i]', 'input[id*="fname" i]',
-                            'input[autocomplete="given-name"]',
-                            'input[placeholder*="first name" i]', 'input[placeholder*="First"]',
-                            'input[name="NameInput"]',
+                            'input[name*="first" i]', 'input[id*="first" i]',
+                            'input[autocomplete="given-name"]', 'input[placeholder*="first" i]',
                         ], data.firstName, 'First name');
                     }
                     if (data.lastName) {
                         await fillField([
-                            'input[name*="lastName" i]', 'input[name*="LastName"]', 'input[name*="lname" i]',
-                            'input[id*="lastName" i]', 'input[id*="lname" i]',
-                            'input[autocomplete="family-name"]',
-                            'input[placeholder*="last name" i]', 'input[placeholder*="Last"]',
-                            'input[name="LastName"]',
+                            'input[name*="last" i]', 'input[id*="last" i]',
+                            'input[autocomplete="family-name"]', 'input[placeholder*="last" i]',
                         ], data.lastName, 'Last name');
                     }
                     if (data.firstName && !data.lastName) {
                         await fillField([
-                            'input[name*="name" i]', 'input[id*="name" i]',
-                            'input[autocomplete="name"]',
+                            'input[name*="name" i]', 'input[id*="name" i]', 'input[autocomplete="name"]',
                         ], data.firstName + ' User', 'Full name');
                     }
                     if (data.phone) {
                         await fillField([
-                            'input[type="tel"]', 'input[name*="phone" i]', 'input[name*="Phone"]',
-                            'input[id*="phone" i]', 'input[autocomplete="tel"]',
-                            'input[placeholder*="phone" i]',
+                            'input[type="tel"]', 'input[name*="phone" i]', 'input[autocomplete="tel"]',
                         ], data.phone, 'Phone');
                     }
-                    const birthYear = data.birthYear || '2003';
-                    const birthMonth = data.birthMonth || 'January';
-                    const birthDay = data.birthDay || '15';
-                    await selectDropdown([
-                        'select[id*="BirthYear"]', 'select[name*="birthYear" i]', 'select[id*="year" i]',
-                        'select[name*="year" i]', 'select[aria-label*="year" i]', 'select[aria-label*="Birth"]',
-                    ], birthYear, 'Birth year');
-                    await selectDropdown([
-                        'select[id*="BirthMonth"]', 'select[name*="birthMonth" i]', 'select[id*="month" i]',
-                        'select[name*="month" i]', 'select[aria-label*="month" i]',
-                    ], birthMonth, 'Birth month');
-                    await selectDropdown([
-                        'select[id*="BirthDay"]', 'select[name*="birthDay" i]', 'select[id*="day" i]',
-                        'select[name*="day" i]', 'select[aria-label*="day" i]',
-                    ], birthDay, 'Birth day');
-                    await selectDropdown([
-                        'select[id*="Country"]', 'select[name*="country" i]',
-                        'select[aria-label*="country" i]', 'select[name*="Country"]',
-                    ], data.country || 'United States', 'Country');
-                    await fillField([
-                        'input[name*="username" i]', 'input[id*="username" i]',
-                        'input[placeholder*="username" i]', 'input[name*="Username"]',
-                    ], data.username || (data.email ? data.email.split('@')[0] + Math.floor(Math.random() * 999) : 'user' + Math.floor(Math.random() * 9999)), 'Username');
+                    if (data.birthYear || data.birthMonth || data.birthDay) {
+                        const birthYear = data.birthYear || '2003';
+                        const birthMonth = data.birthMonth || 'January';
+                        const birthDay = data.birthDay || '15';
+                        await selectDropdown([
+                            'select[id*="year" i]', 'select[name*="year" i]',
+                        ], birthYear, 'Birth year');
+                        await selectDropdown([
+                            'select[id*="month" i]', 'select[name*="month" i]',
+                        ], birthMonth, 'Birth month');
+                        await selectDropdown([
+                            'select[id*="day" i]', 'select[name*="day" i]',
+                        ], birthDay, 'Birth day');
+                    }
+                    if (data.country) {
+                        await selectDropdown([
+                            'select[name*="country" i]', 'select[id*="country" i]',
+                        ], data.country, 'Country');
+                    }
+                    if (data.username) {
+                        await fillField([
+                            'input[name*="username" i]', 'input[id*="username" i]',
+                        ], data.username, 'Username');
+                    }
                     await clickField([
                         'input[type="checkbox"][name*="agree" i]',
-                        'input[type="checkbox"][name*="tos" i]',
                         'input[type="checkbox"][name*="terms" i]',
                         'input[type="checkbox"][name*="consent" i]',
-                        'input[type="checkbox"][name*="privacy" i]',
-                        'input[type="checkbox"][name*="policy" i]',
                         'input[type="checkbox"][id*="agree" i]',
                         'input[type="checkbox"][id*="terms" i]',
-                        'input[type="checkbox"][id*="consent" i]',
-                        'input[type="checkbox"][id*="privacy" i]',
-                        'input[type="checkbox"][aria-label*="agree" i]',
-                        'input[type="checkbox"][aria-label*="terms" i]',
-                        'input[type="checkbox"][aria-label*="consent" i]',
-                        'input[type="checkbox"][aria-label*="accept" i]',
                         'label:has-text("agree") input[type="checkbox"]',
                         'label:has-text("terms") input[type="checkbox"]',
                         'label:has-text("accept") input[type="checkbox"]',
-                        'label:has-text("consent") input[type="checkbox"]',
-                        'label:has-text("privacy") input[type="checkbox"]',
                         'label:has-text("I agree") input[type="checkbox"]',
-                        'label:has-text("I accept") input[type="checkbox"]',
                         '[role="checkbox"][aria-checked="false"]',
-                        'div:has-text("I agree"):not(:has(div:has-text("I agree")))',
-                        'span:has-text("I agree"):not(:has(span:has-text("I agree")))',
                     ], 'Terms/Agreement checkbox');
                     await p.waitForTimeout(500);
                     const hasCaptcha = p.frames().some(f => {
@@ -2809,7 +2856,16 @@ The browser profile persists at ~/.aurix-browser-profile — if the user is logg
                         results.push('');
                         results.push('--- Verification step detected ---');
                         results.push('Attempting to complete automatically...');
-                        const solveResults = await autoSolveCaptcha(p);
+                        let solveResults;
+                        try {
+                            solveResults = await Promise.race([
+                                autoSolveCaptcha(p),
+                                new Promise((_, rej) => setTimeout(() => rej(new Error('auto-solve timed out (30s)')), 30000)),
+                            ]);
+                        }
+                        catch (e) {
+                            solveResults = [`Auto-solve: ${e.message}`];
+                        }
                         solveResults.forEach(r => results.push(`  ${r}`));
                         const needsVision = solveResults.some(r => r.includes('VERIFICATION COMPLETION STEPS') || r.includes('REQUIRES_VISION'));
                         const unconfirmed = solveResults.some(r => /unconfirmed|shows an error/i.test(r));
@@ -2826,17 +2882,11 @@ The browser profile persists at ~/.aurix-browser-profile — if the user is logg
                         }
                     }
                     const clicked = await clickField([
-                        'button[type="submit"]',
-                        'input[type="submit"]',
-                        'button:has-text("Next")', 'button:has-text("next")',
-                        'button:has-text("Continue")', 'button:has-text("continue")',
-                        'button:has-text("Submit")', 'button:has-text("submit")',
-                        'button:has-text("Create")', 'button:has-text("create")',
-                        'button:has-text("Sign up")', 'button:has-text("sign up")',
-                        'button:has-text("Register")', 'button:has-text("register")',
-                        'button:has-text("Accept")', 'button:has-text("accept")',
-                        '#iSignupAction', '#signup-button', '#submit-btn',
-                        'button.fui-Button[type="button"]:visible',
+                        'button[type="submit"]', 'input[type="submit"]',
+                        'button:has-text("Sign up")', 'button:has-text("Register")',
+                        'button:has-text("Next")', 'button:has-text("Continue")',
+                        'button:has-text("Submit")', 'button:has-text("Create")',
+                        '#signup-button', '#submit-btn',
                     ], 'Submit/Next button');
                     await p.waitForTimeout(2000);
                     results.push('');
@@ -2881,6 +2931,27 @@ The browser profile persists at ~/.aurix-browser-profile — if the user is logg
                     }
                     const results = [];
                     results.push('=== SIGNIN ASSIST ===');
+                    const cookieSelectors = [
+                        'button:has-text("Accept All")', 'button:has-text("Accept all")', 'button:has-text("accept all")',
+                        'button:has-text("Accept")', 'button:has-text("Accept Cookies")',
+                        'button:has-text("I agree")', 'button:has-text("Got it")', 'button:has-text("OK")',
+                        'button:has-text("Allow All")', 'button:has-text("Allow all")',
+                        '[id*="cookie"] button', '[class*="cookie"] button',
+                        '[id*="consent"] button', '[class*="consent"] button',
+                        '.cc-accept', '.cookie-accept', '#accept-cookies',
+                    ];
+                    for (const sel of cookieSelectors) {
+                        try {
+                            const btn = p.locator(sel).first();
+                            if (await btn.count() > 0 && await btn.isVisible()) {
+                                await btn.click({ timeout: 2000 });
+                                results.push(`  ✓ Dismissed cookie banner: ${sel}`);
+                                await p.waitForTimeout(500);
+                                break;
+                            }
+                        }
+                        catch { }
+                    }
                     const allFrames = [p, ...p.frames().filter(f => f !== p.mainFrame())];
                     let activeFrame = p;
                     for (const frame of allFrames) {
@@ -2901,7 +2972,13 @@ The browser profile persists at ~/.aurix-browser-profile — if the user is logg
                                         results.push(`  ✓ ${label}: already filled`);
                                         return true;
                                     }
-                                    await loc.fill(val, { timeout: 3000 });
+                                    try {
+                                        await loc.fill(val, { timeout: 1500 });
+                                    }
+                                    catch {
+                                        await loc.click({ timeout: 1500 });
+                                        await loc.pressSequentially(val, { delay: 30, timeout: 5000 });
+                                    }
                                     results.push(`  ✓ ${label}: filled`);
                                     return true;
                                 }
@@ -2920,7 +2997,7 @@ The browser profile persists at ~/.aurix-browser-profile — if the user is logg
                                         results.push(`  ✓ ${label}: already checked`);
                                         return true;
                                     }
-                                    await loc.click({ timeout: 3000 });
+                                    await loc.click({ timeout: 1500 });
                                     results.push(`  ✓ ${label}: clicked`);
                                     return true;
                                 }
@@ -2969,7 +3046,16 @@ The browser profile persists at ~/.aurix-browser-profile — if the user is logg
                         results.push('');
                         results.push('--- Verification step detected ---');
                         results.push('Attempting to complete automatically...');
-                        const solveResults = await autoSolveCaptcha(p);
+                        let solveResults;
+                        try {
+                            solveResults = await Promise.race([
+                                autoSolveCaptcha(p),
+                                new Promise((_, rej) => setTimeout(() => rej(new Error('auto-solve timed out (30s)')), 30000)),
+                            ]);
+                        }
+                        catch (e) {
+                            solveResults = [`Auto-solve: ${e.message}`];
+                        }
                         solveResults.forEach(r => results.push(`  ${r}`));
                         const needsVision = solveResults.some(r => r.includes('VERIFICATION COMPLETION STEPS') || r.includes('REQUIRES_VISION'));
                         const unconfirmed = solveResults.some(r => /unconfirmed|shows an error/i.test(r));