captchaforge 0.2.34

Automatic CAPTCHA detection and multi-strategy solving for chromiumoxide-driven headless browsers (Cloudflare Turnstile, reCAPTCHA v2/v3, hCaptcha, image grids, audio, sliders).
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99

/// CAPTCHA solving pipeline — layered short-circuit + multi-strategy chain.
///
/// Pre-chain layers:
///   0. Token cache — per-(domain, captcha_type) solved-token cache
///      with TTL and cookie replay on hit. Skip the rest of the chain
///      when fresh.
///
/// Strategies in default order:
///   1. Behavioral — realistic mouse + timing for Turnstile / reCAPTCHA
///      v3 / TOML-rule vendors recommending BehavioralBypass.
///   2. VLM — screenshot → Ollama qwen3-vl:30b → solve grid / text /
///      click CAPTCHAs.
///   3. Audio — click audio challenge → speech-to-text → type answer.
///   4. ThirdParty — 2captcha-compatible service (2captcha / CapMonster /
///      CapSolver). Inert without an API key.
///   5. Human — unsolved + screenshot for human-in-the-loop fallback.
///
/// Pattern store (bounded-α EMA) re-orders eligible solvers per
/// domain so the historically-best method runs first; vendor migrations
/// register within ~10 fresh samples instead of being averaged out by
/// historical wins.
//
// Shared dependencies re-exported at crate-internal visibility so that child
// modules can pick them up via `use super::*;` without duplicating imports.
pub(crate) use anyhow::{anyhow, Result};
pub(crate) use async_trait::async_trait;
pub(crate) use chromiumoxide::Page;
pub(crate) use serde::{Deserialize, Serialize};
pub(crate) use std::time::{Duration, Instant};

pub(crate) use crate::captcha_detect::CaptchaInfo;

pub(crate) mod audio;
pub(crate) mod behavioral;
pub(crate) mod util;
pub(crate) mod vlm;

mod cache;
mod chain;
mod math_captcha;
mod multi_step;
mod ocr;
pub mod oracle;
mod pattern;
pub mod planner;
mod pow;
mod race;
mod slider;
pub mod speculation;
mod third_party;
pub mod token_oracle;
pub mod token_shapes;
mod types;
pub mod vendors;
mod wait_for_token;

// ─── Curated public API ──────────────────────────────────────────────────────

pub use self::types::{CaptchaSolveResult, CaptchaSolver, CaptchaType, SolveConfig, SolveMethod};

pub use self::audio::{normalize_transcript, AudioCaptchaSolver};
pub use self::behavioral::BehavioralCaptchaSolver;
pub use self::cache::{CacheStats, CachedToken, TokenCache};
pub use self::chain::{CaptchaSolverChain, ChainConfig};
// Vendor-dedicated solvers — re-exported flat at the crate root so
// existing `use captchaforge::solver::ArkoseSolver` etc. paths
// continue to work after the vendors/ collation.
pub use self::math_captcha::MathCaptchaSolver;
pub use self::multi_step::MultiStepCaptchaSolver;
pub use self::ocr::OcrCaptchaSolver;
pub use self::oracle::{classify, take_snapshot, OutcomeClassification, PageSnapshot};
pub use self::pattern::{CaptchaPattern, PatternStore};
pub use self::planner::{
    HopOutcome, MultiHopPlanner, PlannerConfig, PlannerOutcome, PlannerTerminal,
};
pub use self::pow::PowCaptchaSolver;
pub use self::race::RacingSolver;
pub use self::slider::{SliderCaptchaSolver, SliderSelectors};
pub use self::speculation::{PreflightError, PreflightHandle};
pub use self::third_party::{ThirdPartyCaptchaSolver, ThirdPartyService};
pub use self::token_oracle::{
    classify_response as classify_token_response, TokenEncoding, TokenValidator, ValidationVerdict,
    ValidatorMethod,
};
pub use self::vendors::{
    classify_abck, classify_datadome_cookie, classify_px_cookie, clean_transcript, is_rate_limited,
    is_valid_arkose_token, is_valid_aws_waf_token, is_valid_v3_triple, is_valid_v4_quad,
    looks_like_audio_url, AbckValidity, AkamaiInterstitialSolver, ArkoseSolver, AwsWafSolver,
    CloudflareInterstitialSolver, DataDomeCookie, DataDomeSolver, GeeTestProtocol, GeeTestSolver,
    PerimeterXSolver, PxCookie, RecaptchaAudioSolver, TurnstileInteractiveSolver,
    AUDIO_BUTTON_SELECTOR, AUDIO_ELEMENT_SELECTOR, CHECKBOX_OFFSET_X, CHECKBOX_OFFSET_Y,
    MAX_AUDIO_RETRIES, RATE_LIMIT_PHRASES, RECAPTCHA_BFRAME_SELECTOR, RESPONSE_INPUT_SELECTOR,
    TOKEN_INPUT_NAME, TURNSTILE_IFRAME_SELECTOR, VERIFY_BUTTON_SELECTOR,
};
pub use self::vlm::VlmCaptchaSolver;
pub use self::wait_for_token::WaitForTokenSolver;

// Internal re-export so submodules can access screenshot_b64 via `super::screenshot_b64`.
pub(crate) use self::util::screenshot_b64;