P6: passthrough fields for captcha detection

Author: SentienceDEV

sentience/models.py

@@ -290,12 +290,29 @@ class SnapshotDiagnosticsMetrics(BaseModel):
     raw_elements_count: int | None = None
 
 
+class CaptchaEvidence(BaseModel):
+    text_hits: list[str] = Field(default_factory=list)
+    selector_hits: list[str] = Field(default_factory=list)
+    iframe_src_hits: list[str] = Field(default_factory=list)
+    url_hits: list[str] = Field(default_factory=list)
+
+
+class CaptchaDiagnostics(BaseModel):
+    """Detection-only CAPTCHA signal (no solving/bypass)."""
+
+    detected: bool = False
+    provider_hint: str | None = None
+    confidence: float = 0.0
+    evidence: CaptchaEvidence = Field(default_factory=CaptchaEvidence)
+
+
 class SnapshotDiagnostics(BaseModel):
     """Runtime stability/debug information (reserved for diagnostics, not ML metadata)."""
 
     confidence: float | None = None
-    reasons: list[str] = []
+    reasons: list[str] = Field(default_factory=list)
     metrics: SnapshotDiagnosticsMetrics | None = None
+    captcha: CaptchaDiagnostics | None = None
 
     def get_grid_bounds(self, grid_id: int | None = None) -> list[GridInfo]:
         """

sentience/snapshot.py

@@ -103,10 +103,17 @@ def _build_snapshot_payload(
     """
     diagnostics = raw_result.get("diagnostics") or {}
     client_metrics = None
+    client_diagnostics = None
     try:
         client_metrics = diagnostics.get("metrics")
     except Exception:
         client_metrics = None
+    try:
+        captcha = diagnostics.get("captcha")
+        if captcha is not None:
+            client_diagnostics = {"captcha": captcha}
+    except Exception:
+        client_diagnostics = None
 
     return {
         "raw_elements": raw_result.get("raw_elements", []),
@@ -118,6 +125,7 @@ def _build_snapshot_payload(
             "filter": options.filter.model_dump() if options.filter else None,
         },
         "client_metrics": client_metrics,
+        "client_diagnostics": client_diagnostics,
     }