Open-source AI browser agent for Chrome and Firefox (monorepo) ðŸ§
JavaScript ai-agentai-agentsai-toolsbrowser-aibrowser-automationbrowser-extensionchrome-aichrome-devtoolschrome-extensionchrome-extensionsfirefox-addonfirefox-addonsfirefox-extensionfirefox-extensionsgemmagemma4minimaxoffline-aioffline-llmqwen
Align CAPTCHA tool documentation with mode availability
Emre Sokulluac0c7fc87589
diff --git a/docs/agent-tools.md b/docs/agent-tools.mdindex a7f8a86b4..ab41cf8ad 100644--- a/docs/agent-tools.md+++ b/docs/agent-tools.md@@ -85,9 +85,9 @@ Legend: **Yes** = available · **-** = not available · **C** = Chrome only ·| `progress_update` | No | Yes | Yes | Yes | - || `progress_read` | No | Yes | Yes | Yes | - || `download_social_media` | No | No | Yes | Yes | - |-| `get_captcha_capabilities` | Yes | No | Yes | Yes | Read-only provider/method discovery |-| `solve_captcha` | No | No | Yes | Yes | Automatic widgets or documented native methods |-| `apply_captcha_solution` | No | No | Yes | Yes | Apply the stored native answer without another paid solve |+| `get_captcha_capabilities` | No | No | Yes | Yes | Yes |+| `solve_captcha` | No | No | Yes | Yes | Yes |+| `apply_captcha_solution` | No | No | Yes | Yes | Yes || `go_back` | No | No | Yes | Yes | - || `go_forward` | No | No | Yes | Yes | - || `schedule_resume` | No | No | Yes | Yes | - |@@ -188,4 +188,4 @@ Compact-tier providers. Chrome's reversible editing tools return patch IDs:## CAPTCHA providers-See [CAPTCHA provider coverage](captcha-provider-coverage.md) for setup, weighted fallback, hCaptcha, browser identity requirements and answer application, and the [complete method reference](captcha-method-reference.md) for all seven providers’ native contracts. The agent reads `get_captcha_capabilities` before supplying `providerTasks` to `solve_captcha`; structured results remain available to `apply_captcha_solution`. A result must still be verified on the page.+See [CAPTCHA provider coverage](captcha-provider-coverage.md) for setup, weighted fallback, hCaptcha, browser identity requirements and answer application, and the [complete method reference](captcha-method-reference.md) for all seven providers’ native contracts. In Act/Dev Mid and Full, the agent reads `get_captcha_capabilities` before supplying `providerTasks` to `solve_captcha`; structured results remain available to `apply_captcha_solution`. Ask and Compact request manual completion. A result must still be verified on the page.diff --git a/test/captcha-runtime-policy.mjs b/test/captcha-runtime-policy.mjsindex e843b1eba..865b27001 100644--- a/test/captcha-runtime-policy.mjs+++ b/test/captcha-runtime-policy.mjs@@ -1,7 +1,16 @@import test from 'node:test';import assert from 'node:assert/strict';+import { readFile } from 'node:fs/promises';const captchaNames = ['get_captcha_capabilities', 'solve_captcha', 'apply_captcha_solution'];const solverInstructions = /get_captcha_capabilities|solve_captcha|apply_captcha_solution|\[CAPTCHA SOLVER/;+test('CAPTCHA tool matrix matches Ask, Compact, Mid, Full and Dev availability', async () => {+ const rows = (await readFile(new URL('../docs/agent-tools.md', import.meta.url), 'utf8')).split('\n');+ for (const name of captchaNames) {+ const row = rows.find(line => line.startsWith(`| \`${name}\` |`));+ assert.ok(row, name);+ assert.deepEqual(row.split('|').slice(2, -1).map(cell => cell.trim()), ['No', 'No', 'Yes', 'Yes', 'Yes'], name);+ }+});for (const build of ['chrome', 'firefox']) {const { Agent } = await import(`../src/${build}/src/agent/agent.js`);const { getToolsForMode } = await import(`../src/${build}/src/agent/tools.js`);