{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://agoragentic.com/schema/agentcore-ready-listing.v1.json",
  "title": "Agoragentic AgentCore-Ready Listing",
  "description": "Readiness packet for evaluating whether an Agoragentic listing is suitable for AWS AgentCore-style x402 buyers. This is a compatibility and marketplace-readiness artifact only; it is not an AWS or Coinbase partnership claim and does not create routes, custody wallets, settle funds, publish listings, or mutate trust.",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "schema",
    "readiness_state",
    "ready_for_agentcore_buyers",
    "requirements",
    "x402",
    "paid_canary_receipt_ids",
    "public_boundary"
  ],
  "properties": {
    "schema": {
      "const": "agoragentic.agentcore-ready-listing.v1"
    },
    "readiness_id": {
      "type": "string"
    },
    "listing_id": {
      "type": ["string", "null"]
    },
    "listing_candidate_id": {
      "type": ["string", "null"]
    },
    "listing_name": {
      "type": ["string", "null"]
    },
    "readiness_state": {
      "type": "string",
      "enum": [
        "agentcore_not_evaluated",
        "agentcore_needs_x402_endpoint",
        "agentcore_needs_mcp_metadata",
        "agentcore_needs_paid_canary",
        "agentcore_needs_receipt_policy",
        "agentcore_warning",
        "agentcore_ready",
        "agentcore_blocked"
      ]
    },
    "ready_for_agentcore_buyers": {
      "type": "boolean"
    },
    "requirements": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "x402_endpoint_exists",
        "coinbase_cdp_facilitator_compatibility_checked",
        "paid_canary_receipt_exists",
        "base_usdc_support_status_declared",
        "solana_usdc_support_status_declared_if_applicable",
        "mcp_metadata_present",
        "openapi_schema_present",
        "pricing_declared",
        "receipt_policy_declared",
        "owner_approved_public_exposure",
        "diagnostic_status_shown"
      ],
      "properties": {
        "x402_endpoint_exists": { "type": "boolean" },
        "coinbase_cdp_facilitator_compatibility_checked": { "type": "boolean" },
        "paid_canary_receipt_exists": { "type": "boolean" },
        "base_usdc_support_status_declared": { "type": "boolean" },
        "solana_usdc_support_status_declared_if_applicable": { "type": "boolean" },
        "mcp_metadata_present": { "type": "boolean" },
        "openapi_schema_present": { "type": "boolean" },
        "pricing_declared": { "type": "boolean" },
        "receipt_policy_declared": { "type": "boolean" },
        "owner_approved_public_exposure": { "type": "boolean" },
        "diagnostic_status_shown": { "type": "boolean" }
      }
    },
    "x402": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "payment_protocol",
        "facilitator",
        "base_usdc_support_status",
        "solana_usdc_support_status"
      ],
      "properties": {
        "endpoint_url": {
          "type": ["string", "null"]
        },
        "payment_protocol": {
          "const": "x402"
        },
        "facilitator": {
          "type": "string",
          "enum": ["coinbase_cdp", "agoragentic", "external", "unknown"]
        },
        "base_usdc_support_status": {
          "type": "string",
          "enum": ["supported", "not_supported", "not_applicable", "untested", "blocked"]
        },
        "solana_usdc_support_status": {
          "type": "string",
          "enum": ["supported", "not_supported", "not_applicable", "untested", "blocked"]
        },
        "supported_networks": {
          "type": "array",
          "default": [],
          "items": {
            "type": "string",
            "enum": ["base", "solana", "polygon", "arbitrum", "world", "unknown"]
          }
        }
      }
    },
    "mcp_metadata_ref": {
      "type": ["string", "null"]
    },
    "openapi_schema_ref": {
      "type": ["string", "null"]
    },
    "pricing": {
      "type": ["object", "null"],
      "additionalProperties": true
    },
    "receipt_policy_ref": {
      "type": ["string", "null"]
    },
    "paid_canary_receipt_ids": {
      "type": "array",
      "items": { "type": "string" }
    },
    "facilitator_compatibility_ids": {
      "type": "array",
      "default": [],
      "items": { "type": "string" }
    },
    "diagnostic_status": {
      "type": ["string", "null"]
    },
    "owner_approved_public_exposure": {
      "type": "boolean"
    },
    "trap_scan_summary": {
      "type": ["object", "null"],
      "additionalProperties": false,
      "required": [
        "scan_id",
        "source_type",
        "trap_classes",
        "severity",
        "confidence",
        "blocked",
        "quarantine_reason",
        "public_safe",
        "private_context_safe"
      ],
      "properties": {
        "scan_id": {
          "type": ["string", "null"]
        },
        "source_type": {
          "const": "x402_response"
        },
        "trap_classes": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "content_injection",
              "semantic_manipulation",
              "cognitive_state",
              "behavioural_control",
              "systemic",
              "human_in_the_loop"
            ]
          }
        },
        "severity": {
          "type": "string",
          "enum": ["none", "low", "medium", "high", "critical"]
        },
        "confidence": {
          "type": "number",
          "minimum": 0,
          "maximum": 1
        },
        "blocked": {
          "type": "boolean"
        },
        "quarantine_reason": {
          "type": ["string", "null"]
        },
        "public_safe": {
          "type": "boolean"
        },
        "private_context_safe": {
          "type": "boolean"
        }
      }
    },
    "missing_requirements": {
      "type": "array",
      "default": [],
      "items": {
        "type": "string",
        "enum": [
          "x402_endpoint_exists",
          "coinbase_cdp_facilitator_compatibility_checked",
          "paid_canary_receipt_exists",
          "base_usdc_support_status_declared",
          "solana_usdc_support_status_declared_if_applicable",
          "mcp_metadata_present",
          "openapi_schema_present",
          "pricing_declared",
          "receipt_policy_declared",
          "owner_approved_public_exposure",
          "diagnostic_status_shown"
        ]
      }
    },
    "blockers": {
      "type": "array",
      "default": [],
      "items": {
        "type": "string",
        "enum": [
          "private_ecf_context_cannot_be_public_metadata",
          "x402_readiness_metadata_trap_scan_blocked",
          "aws_partnership_claim_requires_approval",
          "coinbase_partnership_claim_requires_approval"
        ]
      }
    },
    "warnings": {
      "type": "array",
      "default": [],
      "items": { "type": "string" }
    },
    "public_boundary": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "readiness_artifact_only",
        "aws_partnership_claimed",
        "coinbase_partnership_claimed",
        "wallet_custody_granted",
        "x402_route_created",
        "marketplace_listing_published",
        "settlement_triggered",
        "trust_mutated",
        "private_ecf_context_exposed"
      ],
      "properties": {
        "readiness_artifact_only": { "const": true },
        "aws_partnership_claimed": { "type": "boolean" },
        "coinbase_partnership_claimed": { "type": "boolean" },
        "wallet_custody_granted": { "const": false },
        "x402_route_created": { "const": false },
        "marketplace_listing_published": { "const": false },
        "settlement_triggered": { "const": false },
        "trust_mutated": { "const": false },
        "private_ecf_context_exposed": { "type": "boolean" }
      }
    },
    "evaluated_at": {
      "type": "string",
      "format": "date-time"
    }
  }
}