crawldex-report 0.1.0__tar.gz

crawldex_report-0.1.0/PKG-INFO

@@ -0,0 +1,57 @@
+Metadata-Version: 2.4
+Name: crawldex-report
+Version: 0.1.0
+Summary: Python reporter SDK for CrawlDex preflight and outcome reports.
+Home-page: https://crawldex.com
+Author: CrawlDex
+License: MIT
+Project-URL: Homepage, https://crawldex.com
+Keywords: crawldex,browser-agents,reporting,preflight
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# crawldex-report
+
+Python SDK for CrawlDex preflight checks and score-neutral outcome reporting.
+
+```py
+from crawldex_report import CrawlDexReporter
+
+reporter = CrawlDexReporter(
+    report_url="https://crawldex.com/api/v1/runs",
+    agent_key="aa_agent_...",
+    dry_run=True,
+)
+
+verdict = reporter.preflight("demo-shop.crawldex.com", "commerce.checkout")
+
+receipt = reporter.report({
+    "site": "demo-shop.crawldex.com",
+    "task": "commerce.checkout",
+    "outcome": "success_with_handoff",
+    "friction": ["login_required"],
+    "evidence": {
+        "artifact": {
+            "signals": ["checkout_loaded", "login_required"],
+            "removed_fields": ["screenshots", "cookies", "form_values"],
+        },
+        "artifact_types": ["action_summary"],
+        "redaction_status": "hash_only",
+    },
+})
+```
+
+Runtime code uses only the Python standard library. Build metadata is included
+for local wheel/sdist creation; do not publish without CrawlDex release
+credentials and review.
+

crawldex_report-0.1.0/README.md

@@ -0,0 +1,35 @@
+# crawldex-report
+
+Python SDK for CrawlDex preflight checks and score-neutral outcome reporting.
+
+```py
+from crawldex_report import CrawlDexReporter
+
+reporter = CrawlDexReporter(
+    report_url="https://crawldex.com/api/v1/runs",
+    agent_key="aa_agent_...",
+    dry_run=True,
+)
+
+verdict = reporter.preflight("demo-shop.crawldex.com", "commerce.checkout")
+
+receipt = reporter.report({
+    "site": "demo-shop.crawldex.com",
+    "task": "commerce.checkout",
+    "outcome": "success_with_handoff",
+    "friction": ["login_required"],
+    "evidence": {
+        "artifact": {
+            "signals": ["checkout_loaded", "login_required"],
+            "removed_fields": ["screenshots", "cookies", "form_values"],
+        },
+        "artifact_types": ["action_summary"],
+        "redaction_status": "hash_only",
+    },
+})
+```
+
+Runtime code uses only the Python standard library. Build metadata is included
+for local wheel/sdist creation; do not publish without CrawlDex release
+credentials and review.
+

crawldex_report-0.1.0/pyproject.toml

@@ -0,0 +1,34 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "crawldex-report"
+version = "0.1.0"
+description = "Python reporter SDK for CrawlDex preflight and outcome reports."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [
+  { name = "CrawlDex" }
+]
+keywords = ["crawldex", "browser-agents", "reporting", "preflight"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+]
+
+[project.urls]
+Homepage = "https://crawldex.com"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+

crawldex_report-0.1.0/setup.cfg

@@ -0,0 +1,36 @@
+[metadata]
+name = crawldex-report
+version = 0.1.0
+description = Python reporter SDK for CrawlDex preflight and outcome reports.
+long_description = file: README.md
+long_description_content_type = text/markdown
+author = CrawlDex
+license = MIT
+url = https://crawldex.com
+keywords = crawldex, browser-agents, reporting, preflight
+classifiers = 
+	Development Status :: 3 - Alpha
+	Intended Audience :: Developers
+	License :: OSI Approved :: MIT License
+	Programming Language :: Python :: 3
+	Programming Language :: Python :: 3 :: Only
+	Programming Language :: Python :: 3.9
+	Programming Language :: Python :: 3.10
+	Programming Language :: Python :: 3.11
+	Programming Language :: Python :: 3.12
+	Programming Language :: Python :: 3.13
+
+[options]
+package_dir = 
+	= src
+packages = find:
+python_requires = >=3.9
+include_package_data = True
+
+[options.packages.find]
+where = src
+
+[egg_info]
+tag_build = 
+tag_date = 0
+

crawldex_report-0.1.0/src/crawldex_report/__init__.py

@@ -0,0 +1,22 @@
+"""CrawlDex Python reporter SDK."""
+
+from .core import (
+    CrawlDexReporter,
+    PreflightVerdict,
+    SubmissionReceipt,
+    canonical_json,
+    hash_evidence_artifact,
+    map_to_run_report,
+    redact_evidence_artifact,
+)
+
+__all__ = [
+    "CrawlDexReporter",
+    "PreflightVerdict",
+    "SubmissionReceipt",
+    "canonical_json",
+    "hash_evidence_artifact",
+    "map_to_run_report",
+    "redact_evidence_artifact",
+]
+

crawldex_report-0.1.0/src/crawldex_report/browser_use.py

@@ -0,0 +1,65 @@
+"""browser-use adapter helpers for CrawlDex reporting."""
+
+from __future__ import annotations
+
+import asyncio
+import time
+from typing import Any, Mapping, Optional, Sequence
+
+from .core import CrawlDexReporter, SubmissionReceipt
+
+
+async def report_browser_use_result(
+    *,
+    reporter: CrawlDexReporter,
+    result: Any,
+    site: str,
+    task: str,
+    agent_profile: Optional[Mapping[str, Any]] = None,
+    outcome: str,
+    friction: Optional[Sequence[str]] = None,
+    evidence_signals: Optional[Sequence[str]] = None,
+    source_tier: Optional[str] = None,
+    occurred_at: Optional[str] = None,
+) -> SubmissionReceipt:
+    """Submit a redacted browser-use run summary.
+
+    `result` is accepted for adapter parity but is not introspected by default,
+    because browser-use histories can contain raw browser state or prompts.
+    """
+
+    started_at = time.monotonic()
+    signals = list(evidence_signals or [])
+    payload = {
+        "site": site,
+        "task": task,
+        "agent_profile": {"stack": "browser-use", **dict(agent_profile or {})},
+        "outcome": outcome,
+        "friction": list(friction or []),
+        "duration_sec": max(0, round(time.monotonic() - started_at)),
+        "evidence": {
+            "artifact": {
+                "schema": "crawldex.evidence.redacted.v1",
+                "redaction_status": "hash_only",
+                "signals": signals,
+                "removed_fields": [
+                    "screenshots",
+                    "cookies",
+                    "storage_state",
+                    "network_bodies",
+                    "form_values",
+                    "agent_history",
+                    "prompts",
+                ],
+            },
+            "artifact_types": ["action_summary"],
+            "redaction_status": "hash_only",
+        },
+    }
+    if source_tier is not None:
+        payload["source_tier"] = source_tier
+    if occurred_at is not None:
+        payload["occurred_at"] = occurred_at
+
+    return await asyncio.to_thread(reporter.report, payload)
+