crawldex-report

JavaScript reporter SDK for CrawlDex preflight checks and redacted task outcome reports.

import { createReporter } from "crawldex-report";

const reporter = createReporter({
  reportUrl: "https://crawldex.com/api/v1/runs",
  agentKey: process.env.CRAWLDEX_AGENT_KEY
});

const verdict = await reporter.preflight("demo-shop.crawldex.com", "commerce.checkout");

const receipt = await reporter.reportOutcome({
  site: "demo-shop.crawldex.com",
  task: "commerce.checkout",
  outcome: "success_with_handoff",
  friction: ["login_required"],
  evidence: {
    artifact: {
      schema: "crawldex.evidence.redacted.v1",
      redaction_status: "redacted",
      signals: ["checkout_loaded", "login_required"]
    },
    artifactTypes: ["redacted_trace"],
    redactionStatus: "redacted"
  }
});

Network failures fail open: task code can continue and the returned value includes a warning instead of throwing. Validation errors still throw before any network call.