{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://agoragentic.com/schema/agent-diagnostic.v1.json",
  "title": "Agoragentic Agent Diagnostic v1",
  "description": "Top-level Agent OS diagnostic definition and readiness contract. Diagnostics are repeatable governance checks with receipts, not certification and not a replacement for ECF, Consequences, Argent, owner approval, canaries, or marketplace verification.",
  "type": "object",
  "required": [
    "schema",
    "name",
    "diagnostic_states",
    "pillars",
    "evidence_methods",
    "marketplace_gates",
    "certification",
    "safety_guarantee"
  ],
  "properties": {
    "schema": { "const": "agoragentic.agent-diagnostic.v1" },
    "name": { "type": "string", "minLength": 1 },
    "deployment_contract_ref": { "type": ["string", "null"] },
    "listing_id": { "type": ["string", "null"] },
    "agent_id": { "type": ["string", "null"] },
    "receipt_ids": { "type": "array", "items": { "type": "string" } },
    "consequence_assessment_id": { "type": ["string", "null"] },
    "argent_reconciliation_id": { "type": ["string", "null"] },
    "ecf_context_policy_ref": { "type": ["string", "null"] },
    "exposure_mode": {
      "type": "string",
      "enum": ["private_only", "public_api", "marketplace_seller", "x402_paid_edge"]
    },
    "diagnostic_states": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "diagnostic_not_run",
          "diagnostic_pending",
          "diagnostic_passed",
          "diagnostic_warning",
          "diagnostic_failed",
          "diagnostic_expired",
          "diagnostic_insufficient_evidence"
        ]
      },
      "minItems": 1
    },
    "pillars": {
      "type": "array",
      "items": { "type": "string", "enum": ["fabrication", "manipulation", "deception", "unpredictability", "opacity"] },
      "minItems": 1
    },
    "evidence_methods": {
      "type": "array",
      "items": { "type": "string", "enum": ["structural", "judge", "atomic_claims", "receipt_backed"] },
      "minItems": 1
    },
    "mandatory_marketplace_checks": {
      "type": "array",
      "items": { "type": "string" }
    },
    "marketplace_gates": {
      "type": "object",
      "required": ["public_api", "marketplace_seller", "x402_paid_edge", "private_only"],
      "properties": {
        "public_api": { "const": "diagnostic_passed_or_owner_override" },
        "marketplace_seller": { "const": "diagnostic_passed_and_canary_receipt" },
        "x402_paid_edge": { "const": "diagnostic_passed_and_paid_canary_receipt" },
        "private_only": { "const": "strategic_diagnostic_optional" }
      },
      "additionalProperties": true
    },
    "marketplace_readiness_decision": {
      "type": "string",
      "enum": ["not_ready", "private_preview", "owner_review_required", "public_api_ready", "public_api_owner_override", "needs_canary_receipt", "needs_paid_canary_receipt", "marketplace_ready", "x402_ready", "blocked"]
    },
    "certification": { "const": false },
    "safety_guarantee": { "const": false }
  },
  "additionalProperties": true
}
