RunResult

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/hyperresearch-ai/json-schema/hyperresearch-ai-run-result-schema.json",
  "title": "RunResult",
  "x-generated": "2026-11-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/hyperresearch-ai-openapi.json#/components/schemas/RunResult",
  "type": "object",
  "properties": {
    "report_markdown": {
      "type": [
        "string",
        "null"
      ]
    },
    "report_url": {
      "type": [
        "string",
        "null"
      ]
    },
    "sources": {
      "type": "array",
      "items": {}
    },
    "skipped": {
      "type": "array",
      "items": {},
      "description": "Every page this run tried and did not keep: `{ url, domain, outcome, reason, detail, rung, at }`. `reason` is a closed enum and is always set — `unknown` with the raw text in `detail` when the ladder recorded nothing to classify (E2E8-12). `sources` is what the run kept; this is the other half, so a reloaded run still explains the gap between pages considered and sources kept (E2E8-02)."
    },
    "skipped_summary": {
      "type": [
        "string",
        "null"
      ],
      "description": "The skipped list in one sentence — “30 pages considered, 21 kept; 9 were skipped: …” — written at finish so it survives a reload. Null for a run that finished before the artifact existed."
    },
    "claims": {
      "type": "array",
      "items": {}
    },
    "verification": {},
    "escalations": {
      "type": "array",
      "items": {}
    },
    "artifacts": {
      "type": "object",
      "additionalProperties": {}
    },
    "telemetry": {},
    "seat_models": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "version": {
          "type": "number",
          "enum": [
            1
          ]
        },
        "writer": {
          "type": "string",
          "enum": [
            "phased",
            "phased-fell-back",
            "legacy",
            "light"
          ]
        },
        "policy": {
          "type": "string",
          "enum": [
            "base",
            "fail"
          ]
        },
        "summary": {
          "type": "string"
        },
        "seats": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "seat": {
                "type": "string"
              },
              "label": {
                "type": "string"
              },
              "premium_model": {
                "type": "string"
              },
              "premium_name": {
                "type": "string"
              },
              "premium_calls": {
                "type": "integer",
                "minimum": 0
              },
              "fallback_calls": {
                "type": "integer",
                "minimum": 0
              },
              "models": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "model": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "calls": {
                      "type": "integer",
                      "minimum": 0
                    },
                    "premium": {
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "model",
                    "name",
                    "calls",
                    "premium"
                  ]
                }
              }
            },
            "required": [
              "seat",
              "label",
              "premium_model",
              "premium_name",
              "premium_calls",
              "fallback_calls",
              "models"
            ]
          }
        },
        "credit": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "model": {
              "type": "string"
            },
            "role": {
              "type": "string",
              "enum": [
                "edit",
                "plan"
              ]
            },
            "label": {
              "type": "string"
            },
            "detail": {
              "type": "string"
            }
          },
          "required": [
            "model",
            "role",
            "label",
            "detail"
          ],
          "description": "The model credit the report may show (\"Powered by Claude Opus 5.5\"), set only when the accepted output of that seat really came from the model: the Light final edit that shipped, or the Deep plan that was used. Null on a fallback, a skipped or rejected edit, or a plan from the standard model. Absent on runs that finished before it existed."
        },
        "light_edit": {
          "type": "string",
          "enum": [
            "accepted",
            "rejected",
            "skipped"
          ],
          "description": "Light only: how the final edit ended. `rejected` and `skipped` ship the checked report unchanged."
        }
      },
      "required": [
        "version",
        "writer",
        "policy",
        "summary",
        "seats"
      ],
      "description": "Premium seats only: the model that really answered each promoted seat (planner, section writers, editor), with call counts and every fallback, and the receipt sentence (\"Report planned, written and edited by Claude Opus 5.5.\"). Null for a run without premium seats."
    },
    "report_language": {
      "type": [
        "string",
        "null"
      ],
      "description": "The language the report was written in, as a BCP-47 primary subtag (`zh`, `en`, `ja`, …): the run’s `report_language` lever when one was set, otherwise the language of the question — the same rule, over the same frozen inputs, the run itself used. Null when it cannot be known (a run admitted before launch packets were stored). Clients label the report (source-list headings, dates) in this language rather than guessing from its text."
    },
    "attention": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/AttentionItem"
      },
      "description": "Findings a reader should act on before relying on the report, in the order to show them. Empty when there are none. Every other finding stays in `verification` as information."
    },
    "flagged_statements": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "$ref": "#/$defs/FlaggedStatement"
      },
      "description": "The cited statements the checks flagged that ship as written, at most 200. Null when the run kept no per-sentence record of its checks."
    }
  },
  "required": [
    "report_markdown",
    "report_url",
    "sources",
    "skipped",
    "skipped_summary",
    "claims",
    "escalations",
    "artifacts",
    "report_language",
    "attention",
    "flagged_statements"
  ],
  "$defs": {
    "AttentionItem": {
      "type": "object",
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "unsupported-statements",
            "incomplete-chapters",
            "uncovered-question",
            "retracted-source",
            "unchecked-report"
          ]
        },
        "check": {
          "type": "string",
          "description": "The receipt check this finding came from, e.g. `citation-spot-check`."
        },
        "count": {
          "type": "integer",
          "minimum": 0,
          "description": "How many: cited statements shipped uncorrected, chapters, parts of the question, retracted citations."
        },
        "of": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 0,
          "description": "What `count` is out of (statements checked, parts of the question), or null when not stated."
        },
        "unit": {
          "type": "string",
          "enum": [
            "figures",
            "statements"
          ],
          "description": "For `unsupported-statements`: whether the check counted cited figures or cited statements."
        },
        "names": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Chapter titles, question parts or the title of the retracted source. Empty when the receipt does not name them."
        }
      },
      "required": [
        "kind",
        "check",
        "count",
        "of",
        "names"
      ]
    },
    "FlaggedStatement": {
      "type": "object",
      "properties": {
        "text": {
          "type": "string",
          "description": "The sentence as it ships in the report, at most 400 characters."
        },
        "verdict": {
          "type": "string",
          "enum": [
            "wrong",
            "unsupported",
            "partly",
            "minor"
          ],
          "description": "What the check found: the source says otherwise, does not state it, states part of it, or differs in a detail."
        },
        "source_ids": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "The ids of the sources the sentence cites."
        }
      },
      "required": [
        "text",
        "verdict",
        "source_ids"
      ]
    }
  }
}