{
  "schema_version": "1.0.0",
  "service": "agent-decision-gate-api",
  "product_name": "Agent Decision Gate",
  "canonical_origin": "https://agentdecisiongate.com",
  "status": "x402_live_commercial_alpha",
  "description": "A paid x402 runtime checkpoint API for autonomous agents that need external continue, stop, prune, abstain, or escalate decisions with verifiable execution receipts.",
  "use_when": [
    "an agent needs an external continue, prune, stop, abstain, or escalate decision",
    "an operator wants a compute or payment guardrail before further execution",
    "another agent needs a portable receipt for a policy-pinned branch decision",
    "an AI research or coding agent needs a chain-of-evidence checkpoint before continuing an expensive branch",
    "a payment-capable agent needs to know whether a small paid check can prevent a larger execution loss"
  ],
  "agent_search_queries": [
    "agent runtime checkpoint",
    "agent branch evaluation API",
    "agent execution receipt API",
    "agent claim audit API",
    "agent payment guardrail",
    "agent budget guardrail",
    "chain of evidence API",
    "autonomous agent stop continue prune escalate API"
  ],
  "free_discovery_then_paid_execution": {
    "free": [
      "/",
      "/llms.txt",
      "/.well-known/agent.json",
      "/v1/service-index.json",
      "/v1/openapi.json",
      "/v1/capabilities",
      "/v1/pricing",
      "/v1/examples",
      "/v1/recurring-checkpoints",
      "/v1/trust.json",
      "/health",
      "/v1/receipts/verify"
    ],
    "paid": [
      {
        "endpoint": "/v1/branches/evaluate",
        "status": "x402_live_payment_required",
        "unit_price_usdc": "0.01",
        "purpose": "external runtime checkpoint and branch decision receipt"
      }
    ]
  },
  "trust_boundary": {
    "proves": [
      "the submitted payload produced the recorded deterministic decision",
      "the policy identity and canonical policy hash matched",
      "a persisted receipt payload and branch-chain link remain intact"
    ],
    "does_not_prove": [
      "that every submitted claim is real-world truth",
      "global agent identity or reputation",
      "that every settled payment implies the submitted claim is true"
    ]
  },
  "primary_endpoint": {
    "method": "POST",
    "url": "https://agentdecisiongate.com/v1/branches/evaluate",
    "persistence_query": "persist=true",
    "unit_price_usdc": "0.01",
    "payment_status": "x402_live_payment_required",
    "payment_network": "Base mainnet",
    "payment_network_caip2": "eip155:8453"
  },
  "discovery": {
    "homepage": "https://agentdecisiongate.com/",
    "openapi": "https://agentdecisiongate.com/v1/openapi.json",
    "capabilities": "https://agentdecisiongate.com/v1/capabilities",
    "pricing": "https://agentdecisiongate.com/v1/pricing",
    "trust": "https://agentdecisiongate.com/v1/trust.json",
    "examples": "https://agentdecisiongate.com/v1/examples",
    "recurring_checkpoints": "https://agentdecisiongate.com/v1/recurring-checkpoints",
    "llms_txt": "https://agentdecisiongate.com/llms.txt",
    "health": "https://agentdecisiongate.com/health"
  },
  "receipts": {
    "verify": "https://agentdecisiongate.com/v1/receipts/verify",
    "lookup_template": "https://agentdecisiongate.com/v1/receipts/{receipt_id}",
    "lookup_by_hash_template": "https://agentdecisiongate.com/v1/receipts/by-hash/{integrity_hash}",
    "persistence": "D1 index and content-addressed R2 objects when persist=true"
  },
  "quickstart": {
    "unpaid_probe": "curl -i -X POST https://agentdecisiongate.com/v1/branches/evaluate -H \"Content-Type: application/json\" -d \"{}\"",
    "expected_unpaid_status": 402,
    "expected_unpaid_header": "PAYMENT-REQUIRED",
    "integration_order": [
      "read /llms.txt",
      "read /.well-known/agent.json",
      "generate or inspect client from /v1/openapi.json",
      "probe /v1/branches/evaluate and handle the x402 challenge",
      "verify returned receipts through /v1/receipts/verify",
      "on follow-up calls, submit previous_receipt_hash to continue the same branch audit chain"
    ]
  },
  "retention_loop": {
    "name": "recurring checkpoint loop",
    "principle": "A returned receipt is not just a past result; it is the input handle for the next paid checkpoint.",
    "return_with": "previous_receipt_hash",
    "reason_to_return": "Use the previous receipt hash when the same run_id and branch_id need a later continue, stop, prune, abstain, or escalate decision.",
    "endpoint": "https://agentdecisiongate.com/v1/recurring-checkpoints"
  },
  "attribution": "Powered by DEO"
}