Skip to content

Open-source AI browser agent for Chrome and Firefox (monorepo) 🧠

Align CAPTCHA tool documentation with mode availability

Emre Sokulluac0c7fc87589
diff --git a/docs/agent-tools.md b/docs/agent-tools.md
index 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.mjs
index 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`);