traces.ribdsp.com

{
  "type": "object",
  "properties": {
    "hypotheses": {
      "type": "array",
      "description": "Your ranked explanations, best first: 2 to 5 of them. The page rescales the confidences so they sum to 1.",
      "items": {
        "type": "object",
        "properties": {
          "text": {
            "type": "string",
            "description": "The explanation in one sentence, e.g. \"The province list is fetched after the form renders and the request fails, so the select stays empty.\" At most 240 characters."
          },
          "confidence": {
            "type": "number",
            "description": "How strongly you believe it, 0 to 1, e.g. 0.6. Rescaled with the others; shown as a bar, never as a percentage.",
            "minimum": 0,
            "maximum": 1
          },
          "evidence": {
            "type": "array",
            "description": "The moments that support it — at least one, at most 5. Clicking the card highlights all of them on the timeline, so a hypothesis with no evidence is rejected.",
            "items": {
              "type": "object",
              "properties": {
                "atMs": {
                  "type": "number",
                  "description": "When it happened, in milliseconds from the start of the recording, e.g. 28412. Must be inside the recording."
                },
                "note": {
                  "type": "string",
                  "description": "What that moment shows, in a few words, e.g. \"GET /provinces returned 500\". At most 120 characters."
                },
                "markerId": {
                  "type": "string",
                  "description": "Optional. The id annotate returned, if this evidence is a marker you already put on the timeline. Do not invent one."
                }
              },
              "required": [
                "atMs"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "text",
          "confidence",
          "evidence"
        ],
        "additionalProperties": false
      }
    },
    "ticket": {
      "type": "string",
      "description": "Only when retrying a call that previously returned status \"pending\". Do not invent one — pass back exactly the ticket you were given, e.g. \"ask-1a2b3c4d\"."
    }
  },
  "required": [
    "hypotheses"
  ],
  "additionalProperties": false
}