SurfSense/plans/backend
DESKTOP-RTLN3BA\$punk bdacea8b6e feat(crawler): captcha solving + per-attempt billing (Phase 3d)
Wire captchatools as the StealthyFetcher-tier page_action to detect, harvest
(egressing from the crawl's own proxy IP), inject, and submit reCAPTCHA v2/v3
and hCaptcha tokens. Opt-in and off by default (zero attempts, zero cost).

Licensing split:
- Apache-2 app/utils/captcha/ holds the generic, vendor-agnostic config
  (CaptchaConfig + captcha_enabled() = flag AND key present).
- Proprietary app/proprietary/web_crawler/captcha.py holds the bypass logic
  (detect/harvest/inject) plus a process-wide solver latch that halts solving
  on unrecoverable errors (no balance / bad key).

Crawler: CrawlOutcome gains captcha_attempts/captcha_solved, surfaced via a
per-call captcha_state dict threaded crawl_url -> _crawl_with_stealthy(_sync)
and stamped onto every stealth terminal outcome. The stealth tier captures the
proxy once and reuses it for both the fetch and the solver (IP-coherence).

Billing: WebCrawlCreditService gains captcha_billing_enabled,
captcha_solves_to_micros, charge_captcha, and a generic check_balance, sharing
a single _apply_debit path. The indexer accumulates attempts (even on failed
crawls), runs a combined crawl+captcha pre-flight, and posts a per-attempt
owner charge as usage_type="web_crawl_captcha". The captcha worst-case is only
reserved when solving is actually enabled, so a solving-off deployment is never
blocked for captcha that can never run. Both chat scrape tools fold attempts
into the current turn before the success/fail branch.

Fully config-driven prices; no migration. New unit tests cover the config,
factory (detection/latch/timeout/cap), credit service, indexer wiring, and the
chat fold.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-29 22:58:21 -07:00
..
00-umbrella-plan.md feat(crawler): captcha solving + per-attempt billing (Phase 3d) 2026-06-29 22:58:21 -07:00
01-rename-db.md docs(plans): record as-built state + re-runnable verification for Phase 1 (DB rename) 2026-06-27 22:24:41 +02:00
02-rename-backend.md docs(plans): record as-built state + re-runnable verification for Phase 2 (backend rename) 2026-06-27 22:24:41 +02:00
03a-crawler-core.md chore: sync plans (03a@5c36cd3, 03b@6226012 implemented) 2026-06-29 21:04:17 -07:00
03b-proxy-expansion.md chore: sync plans (03a@5c36cd3, 03b@6226012 implemented) 2026-06-29 21:04:17 -07:00
03c-crawl-billing.md chore: sync plans (03c@17bdb0682 implemented) 2026-06-29 21:41:26 -07:00
03d-captcha-solving.md feat(crawler): captcha solving + per-attempt billing (Phase 3d) 2026-06-29 22:58:21 -07:00
03e-stealth-hardening.md feat(03a): implement Scrapling-only web crawler and remove Firecrawl integration 2026-06-29 20:37:56 -07:00
03f-undetectability-testing.md feat(03a): implement Scrapling-only web crawler and remove Firecrawl integration 2026-06-29 20:37:56 -07:00
04a-connector-category.md chore: synced plans 2026-06-29 18:26:29 -07:00
04b-source-discovery.md chore: synced plans 2026-06-29 18:26:29 -07:00
05-pipelines-model.md chore: synced plans 2026-06-29 18:26:29 -07:00
06-pipelines-exec.md chore: synced plans 2026-06-29 18:26:29 -07:00
07-upload-pipeline-kb.md chore: synced plans 2026-06-29 18:26:29 -07:00