markdownforagents

Reliability Contract

Reliability Policy

Clear behavior for strict mode, default mode, and failure handling.

Strict Mode (Recommended for Production Ingestion)

Enable with x-strict-mode: 1 or strict_mode=1.

  • - Fail closed on blocked targets and unsafe URLs
  • - Fail on unsupported content type
  • - Fail on oversized responses
  • - Fail on empty/low-signal extraction output
  • - Return typed error with requestId and diagnostics

Default Mode (Coverage-Oriented)

Used when strict mode is not enabled.

  • - Use best-effort extraction for supported page classes
  • - Truncate oversized responses with diagnostics.truncated=true
  • - Return typed errors when extraction is unusable
  • - Never silently treat denied targets as successful extraction

Typed Failure Modes

Common failure codes returned by the API.

blocked_url
invalid_url
unsupported_content_type
too_large
timeout
empty_content

Release Quality Gates

Every release candidate is blocked unless benchmark, determinism, and deny-suite gates pass.

Supported Scope API Schema