pay.edge-agents.ai

{
  "additionalProperties": true,
  "properties": {
    "analysis": {
      "description": "Service-specific findings and decision context.",
      "type": "object"
    },
    "dataStatus": {
      "description": "Whether the report has sufficient eligible evidence. Missing evidence is never silently fabricated.",
      "enum": [
        "live",
        "partial",
        "unavailable"
      ],
      "type": "string"
    },
    "deliveryId": {
      "description": "Unique delivery identifier when the report is purchased.",
      "type": "string"
    },
    "disclaimer": {
      "type": "string"
    },
    "evidence": {
      "description": "Observed evidence, source lineage and freshness used by the report.",
      "properties": {
        "markets": {
          "type": "object"
        },
        "sentiment": {
          "description": "Present only when a live sentiment provider was available.",
          "type": "object"
        },
        "sources": {
          "items": {
            "type": "object"
          },
          "type": "array"
        },
        "validation": {
          "description": "Present only when cross-source validation was available.",
          "type": "object"
        }
      },
      "required": [
        "markets",
        "sources"
      ],
      "type": "object"
    },
    "generatedAt": {
      "description": "RFC3339 date-time timestamp.",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})$",
      "type": "string"
    },
    "limitations": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "provenance": {
      "description": "Issuer, version and signature/verification information when available.",
      "properties": {
        "algorithm": {
          "enum": [
            "hmac-sha256",
            "none"
          ],
          "type": "string"
        },
        "issuer": {
          "type": "string"
        },
        "signature": {
          "description": "Present only when REPORT_SIGNING_SECRET is configured.",
          "type": "string"
        },
        "signed": {
          "type": "boolean"
        }
      },
      "required": [
        "issuer",
        "algorithm",
        "signed"
      ],
      "type": "object"
    },
    "quality": {
      "description": "Evidence-quality and confidence information, not probability of profit.",
      "properties": {
        "confidence": {
          "enum": [
            "high",
            "medium",
            "low"
          ],
          "type": "string"
        },
        "coverage": {
          "properties": {
            "assets": {
              "type": "number"
            },
            "expectedAssets": {
              "const": 6,
              "type": "number"
            },
            "expectedSources": {
              "const": 3,
              "type": "number"
            },
            "liveSources": {
              "type": "number"
            },
            "trendWindowsAvailable": {
              "type": "number"
            }
          },
          "required": [
            "assets",
            "expectedAssets",
            "liveSources",
            "expectedSources",
            "trendWindowsAvailable"
          ],
          "type": "object"
        },
        "decisionWindow": {
          "const": "multi-window-1h-24h-7d",
          "type": "string"
        },
        "limitations": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "methodology": {
          "type": "string"
        },
        "score": {
          "type": "number"
        },
        "status": {
          "enum": [
            "strong",
            "limited",
            "insufficient"
          ],
          "type": "string"
        }
      },
      "required": [
        "score",
        "status",
        "confidence",
        "coverage",
        "decisionWindow",
        "methodology",
        "limitations"
      ],
      "type": "object"
    },
    "reportId": {
      "description": "Unique report identifier when supplied by the product.",
      "type": "string"
    },
    "schemaVersion": {
      "description": "Machine-readable report contract version.",
      "type": "string"
    },
    "serviceId": {
      "const": "portfolio-risk-guard",
      "type": "string"
    }
  },
  "required": [
    "serviceId",
    "generatedAt",
    "dataStatus",
    "analysis"
  ],
  "type": "object"
}